> This page is for version v0.25.0.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo/guardrails/latest/llms.txt
> - v0.25.0: https://docs.nvidia.com/nemo/guardrails/v0.25.0/llms.txt
> - v0.24.1: https://docs.nvidia.com/nemo/guardrails/v0.24.1/llms.txt
> - v0.24.0: https://docs.nvidia.com/nemo/guardrails/v0.24.0/llms.txt
> - v0.23.0: https://docs.nvidia.com/nemo/guardrails/v0.23.0/llms.txt
> - v0.22.0: https://docs.nvidia.com/nemo/guardrails/v0.22.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.

# nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream

Declare LiteLLM stream fields while retaining OpenAI event semantics.

LiteLLM's root and delta extension bags are optional, nullable, and closed.
Terminal root extensions preserve reviewed response metadata. Source-declared content
arrays remain empty-only except typed reasoning items with no plaintext content.
The classifier derives coverage and text paths from these rebound models;
the endpoint uses the existing per-stream OpenAI lifecycle hooks.

## Module Contents

### Classes

| Name                                                                                                                                            | Description                                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| [`LiteLLMReasoningItemProjection`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMReasoningItemProjection) | Preserve encrypted metadata while keeping plaintext and unknown fields closed. |
| [`LiteLLMStreamChoiceProjection`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMStreamChoiceProjection)   | Keep single-choice constraints and bind the LiteLLM delta model.               |
| [`LiteLLMStreamDeltaProjection`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMStreamDeltaProjection)     | Accept reviewed encrypted reasoning and empty-only content extensions.         |
| [`LiteLLMStreamFields`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMStreamFields)                       | Recognize an empty extension bag without authorizing arbitrary contents.       |
| [`LiteLLMStreamPayloadProjection`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMStreamPayloadProjection) | Recognize LiteLLM's root extension bag, including on usage-only events.        |
| [`LiteLLMTerminalMetadata`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-LiteLLMTerminalMetadata)               | Declare the terminal root extension separately from delta extensions.          |

### Data

[`STREAM_CLASSIFIER`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-STREAM_CLASSIFIER)

[`STREAM_CONTRACT`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-STREAM_CONTRACT)

[`STREAM_RULES`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-stream-STREAM_RULES)

### API

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMReasoningItemProjection()
```

**Bases:** [ResponsesReasoningItemProjection](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/response_projection#nemoguardrails-server-experimental-providers-openai-responses-response_projection-ResponsesReasoningItemProjection)

Preserve encrypted metadata while keeping plaintext and unknown fields closed.

**`policy`** `ObjectPolicy`

---

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMStreamChoiceProjection()
```

**Bases:** [ChatCompletionsStreamChoiceProjection](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/chat_completions/stream_projection#nemoguardrails-server-experimental-providers-openai-chat_completions-stream_projection-ChatCompletionsStreamChoiceProjection)

Keep single-choice constraints and bind the LiteLLM delta model.

**`delta`** `Annotated[LiteLLMStreamDeltaProjection, guarded()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMStreamDeltaProjection()
```

**Bases:** [ChatCompletionsStreamDeltaProjection](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/chat_completions/stream_projection#nemoguardrails-server-experimental-providers-openai-chat_completions-stream_projection-ChatCompletionsStreamDeltaProjection)

Accept reviewed encrypted reasoning and empty-only content extensions.

**`annotations`** `Annotated[list[Any] | None, constrained(reason=(core_capability.citation_content), max_length=0)] = None`

---

**`images`** `Annotated[list[Any] | None, constrained(reason=(core_capability.multimodal_content), max_length=0)] = None`

---

**`policy`** `ObjectPolicy`

---

**`provider_specific_fields`** `Annotated[LiteLLMStreamFields | None, constrained()] = None`

---

**`reasoning_items`** `Annotated[list[LiteLLMReasoningItemProjection] | None, constrained()] = None`

---

**`thinking_blocks`** `Annotated[list[Any] | None, constrained(reason=(core_capability.reasoning_content), max_length=0)] = None`

---

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMStreamFields()
```

**Bases:** [PolicyModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/projection_policy#nemoguardrails-server-experimental-provider-projection_policy-PolicyModel)

Recognize an empty extension bag without authorizing arbitrary contents.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMStreamPayloadProjection()
```

**Bases:** [ChatCompletionsStreamPayloadProjection](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/chat_completions/stream_projection#nemoguardrails-server-experimental-providers-openai-chat_completions-stream_projection-ChatCompletionsStreamPayloadProjection)

Recognize LiteLLM's root extension bag, including on usage-only events.

**`access_programs`** `Annotated[Any, opaque()] = None`

---

**`billing`** `Annotated[Any, opaque()] = None`

---

**`choices`** `Annotated[list[LiteLLMStreamChoiceProjection], guarded(max_length=1)]`

---

**`frequency_penalty`** `Annotated[Any, opaque()] = None`

---

**`image`** `Annotated[ResponseImageProjection | None, constrained()] = None`

---

**`input_transformations`** `InputTransformations = None`

---

**`policy`** `ObjectPolicy`

---

**`presence_penalty`** `Annotated[Any, opaque()] = None`

---

**`provider_specific_fields`** `Annotated[LiteLLMTerminalMetadata | None, constrained()] = None`

---

**`tool_usage`** `Annotated[Any, opaque()] = None`

---

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.LiteLLMTerminalMetadata()
```

**Bases:** [PolicyModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/projection_policy#nemoguardrails-server-experimental-provider-projection_policy-PolicyModel)

Declare the terminal root extension separately from delta extensions.

**`access_programs`** `Annotated[Any, opaque()] = None`

---

**`billing`** `Annotated[Any, opaque()] = None`

---

**`frequency_penalty`** `Annotated[Any, opaque()] = None`

---

**`image`** `Annotated[ResponseImageProjection | None, constrained()] = None`

---

**`input_transformations`** `InputTransformations = None`

---

**`presence_penalty`** `Annotated[Any, opaque()] = None`

---

**`service_tier`** `Annotated[Any, opaque()] = None`

---

**`tool_usage`** `Annotated[Any, opaque()] = None`

---

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.STREAM_CLASSIFIER = build_policy_stream_classifier(StreamClassifierDefinition(subject=(STREAM_CONTRA...
```

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.STREAM_CONTRACT = replace(OPENAI_STREAM_CONTRACT, projection_id='openai.litellm.chat_completions.s...
```

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.stream.STREAM_RULES = tuple((replace(rule, model=LiteLLMStreamPayloadProjection, text_path=(stream_tex...
```