> This page is for version Latest (default).
> 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.responses

Bind reviewed LiteLLM Responses metadata without relaxing text boundaries.

The event model annotation extends the native surface. Requests, buffered
responses, lifecycle response objects, and output-item policy remain OpenAI's.
See responses.md for source, recording provenance and explicit selection.

## Module Contents

### Classes

| Name                                                                                                                                             | Description                                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| [`LiteLLMCompletedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMCompletedEvent)                 | Check the native terminal snapshot against accumulated deltas.           |
| [`LiteLLMCreatedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMCreatedEvent)                     | Check the creation snapshot with the reviewed response metadata.         |
| [`LiteLLMErrorEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMErrorEvent)                         | Accept model metadata on the inherited flat diagnostic error shape.      |
| [`LiteLLMFailedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMFailedEvent)                       | Keep any output in failed responses subject to snapshot checks.          |
| [`LiteLLMInProgressEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMInProgressEvent)               | Check the progress snapshot without introducing a separate text target.  |
| [`LiteLLMIncompleteEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMIncompleteEvent)               | Keep partial output guarded even when generation is incomplete.          |
| [`LiteLLMMessageAddedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMMessageAddedEvent)           | Preserve message identity and single-part cardinality.                   |
| [`LiteLLMMessageDoneEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMMessageDoneEvent)             | Preserve message completion checks and the original item identity.       |
| [`LiteLLMPartAddedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMPartAddedEvent)                 | Retain the initial text part and its inherited content restrictions.     |
| [`LiteLLMPartDoneEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMPartDoneEvent)                   | Retain the completed text part as a checked snapshot.                    |
| [`LiteLLMQueuedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMQueuedEvent)                       | Recognize queued metadata without enabling background requests.          |
| [`LiteLLMReasoningAddedEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMReasoningAddedEvent)       | Permit reviewed reasoning metadata, never new plaintext reasoning.       |
| [`LiteLLMReasoningDoneEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMReasoningDoneEvent)         | Keep reasoning summaries and content constrained to empty values.        |
| [`LiteLLMResponsesEventMetadata`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata) | Accept the gateway's model annotation without using it to select events. |
| [`LiteLLMTextDeltaEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMTextDeltaEvent)                 | Keep the delta as the only newly generated text subject.                 |
| [`LiteLLMTextDoneEvent`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMTextDoneEvent)                   | Keep completed text subject to snapshot consistency checks.              |

### Data

[`LITELLM_RESPONSES_ENDPOINT`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LITELLM_RESPONSES_ENDPOINT)

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

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

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

[`_EVENT_MODELS`](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-_EVENT_MODELS)

### API

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMCompletedEvent()
```

**Bases:** [ResponsesCompletedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesCompletedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Check the native terminal snapshot against accumulated deltas.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMCreatedEvent()
```

**Bases:** [ResponsesCreatedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesCreatedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Check the creation snapshot with the reviewed response metadata.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMErrorEvent()
```

**Bases:** [ResponsesErrorEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesErrorEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Accept model metadata on the inherited flat diagnostic error shape.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMFailedEvent()
```

**Bases:** [ResponsesFailedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesFailedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Keep any output in failed responses subject to snapshot checks.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMInProgressEvent()
```

**Bases:** [ResponsesInProgressEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesInProgressEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Check the progress snapshot without introducing a separate text target.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMIncompleteEvent()
```

**Bases:** [ResponsesIncompleteEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIncompleteEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Keep partial output guarded even when generation is incomplete.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMMessageAddedEvent()
```

**Bases:** [ResponsesMessageAddedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesMessageAddedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Preserve message identity and single-part cardinality.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMMessageDoneEvent()
```

**Bases:** [ResponsesMessageDoneEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesMessageDoneEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Preserve message completion checks and the original item identity.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMPartAddedEvent()
```

**Bases:** [ResponsesContentPartAddedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesContentPartAddedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Retain the initial text part and its inherited content restrictions.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMPartDoneEvent()
```

**Bases:** [ResponsesContentPartDoneEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesContentPartDoneEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Retain the completed text part as a checked snapshot.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMQueuedEvent()
```

**Bases:** [ResponsesQueuedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesQueuedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Recognize queued metadata without enabling background requests.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMReasoningAddedEvent()
```

**Bases:** [ResponsesReasoningAddedEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesReasoningAddedEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Permit reviewed reasoning metadata, never new plaintext reasoning.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMReasoningDoneEvent()
```

**Bases:** [ResponsesReasoningDoneEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesReasoningDoneEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Keep reasoning summaries and content constrained to empty values.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMResponsesEventMetadata()
```

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

Accept the gateway's model annotation without using it to select events.

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

---

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMTextDeltaEvent()
```

**Bases:** [ResponsesTextDeltaEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextDeltaEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Keep the delta as the only newly generated text subject.

```python
class nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LiteLLMTextDoneEvent()
```

**Bases:** [ResponsesTextDoneEventProjection](/nemo/guardrails/guardrails-python-sdk/nemoguardrails/server/experimental/providers/openai/responses/stream_projection#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextDoneEventProjection), [LiteLLMResponsesEventMetadata](#nemoguardrails-server-experimental-providers-openai-dialects-litellm-responses-LiteLLMResponsesEventMetadata)

Keep completed text subject to snapshot consistency checks.

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.LITELLM_RESPONSES_ENDPOINT = replace(RESPONSES_ENDPOINT, contract_name='litellm_responses', operation='LiteLL...
```

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

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

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses.STREAM_RULES = tuple((replace(rule, model=(_EVENT_MODELS[rule.model]), text_path=(stream_text_p...
```

```python
nemoguardrails.server.experimental.providers.openai.dialects.litellm.responses._EVENT_MODELS: dict[type[BaseModel], type[PolicyModel]] = {models.ResponsesTextDeltaEventProjection: LiteLLMTextDeltaEvent, models.Respons...
```