> 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.responses.stream_projection

Typed Responses SSE shapes; protocol ordering belongs to stream hooks.

## Module Contents

### Classes

| Name                                                                                                                                                                    | Description                                                                        |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [`ResponsesCompletedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesCompletedEventProjection)               | Successful native completion carries a final verified snapshot.                    |
| [`ResponsesContentPartAddedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesContentPartAddedEventProjection) | A reviewed text part snapshot, including its initial empty state.                  |
| [`ResponsesContentPartDoneEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesContentPartDoneEventProjection)   | The final snapshot of the single text part.                                        |
| [`ResponsesCreatedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesCreatedEventProjection)                   | Creation is a nonterminal snapshot.                                                |
| [`ResponsesErrorEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesErrorEventProjection)                       | A provider error is terminal diagnostic data, not assistant output.                |
| [`ResponsesEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesEventProjection)                                 | Validate sequence numbers when supplied, without requiring unrelated metadata.     |
| [`ResponsesFailedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesFailedEventProjection)                     | Failure may still contain text and therefore remains a checked snapshot.           |
| [`ResponsesInProgressEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesInProgressEventProjection)             | Progress is a nonterminal snapshot.                                                |
| [`ResponsesIncompleteEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIncompleteEventProjection)             | An incomplete response is terminal, but its partial text is not opaque.            |
| [`ResponsesIndexedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)                   | Track an output position without assuming reasoning always precedes text.          |
| [`ResponsesLifecycleEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)               | Share the response snapshot field, not its concrete event identity.                |
| [`ResponsesLifecycleResponseProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleResponseProjection)         | Describe a full response snapshot without demanding a message before generation.   |
| [`ResponsesMessageAddedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesMessageAddedEventProjection)         | The assistant item is a snapshot, not opaque output.                               |
| [`ResponsesMessageDoneEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesMessageDoneEventProjection)           | The completed assistant item must agree with previously observed deltas.           |
| [`ResponsesQueuedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesQueuedEventProjection)                     | Queue metadata does not make background execution an accepted request mode.        |
| [`ResponsesReasoningAddedEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesReasoningAddedEventProjection)     | Allow only the reviewed, non-plaintext reasoning item.                             |
| [`ResponsesReasoningDoneEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesReasoningDoneEventProjection)       | Preserve completed reasoning metadata without inspecting encrypted values.         |
| [`ResponsesSnapshotMessageProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesSnapshotMessageProjection)             | Allow an initially empty message, but never a second guarded text part.            |
| [`ResponsesSnapshotTextProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesSnapshotTextProjection)                   | An empty initial text snapshot is valid; annotations and logprobs stay restricted. |
| [`ResponsesTextDeltaEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextDeltaEventProjection)               | Only this event introduces new guarded assistant text.                             |
| [`ResponsesTextDoneEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextDoneEventProjection)                 | Repeat the accumulated text rather than introducing a second text source.          |
| [`ResponsesTextEventProjection`](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextEventProjection)                         | Restrict content to the single text part and validate any supplied identity.       |

### API

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesCompletedEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

Successful native completion carries a final verified snapshot.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseCompletedEvent')`

---

**`type`** `Annotated[Literal['response.completed'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesContentPartAddedEventProjection()
```

**Bases:** [ResponsesTextEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextEventProjection)

A reviewed text part snapshot, including its initial empty state.

**`part`** `Annotated[ResponsesSnapshotTextProjection, guarded()]`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['response.content_part.added'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesContentPartDoneEventProjection()
```

**Bases:** [ResponsesTextEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextEventProjection)

The final snapshot of the single text part.

**`part`** `Annotated[ResponsesSnapshotTextProjection, guarded()]`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['response.content_part.done'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesCreatedEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

Creation is a nonterminal snapshot.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseCreatedEvent')`

---

**`type`** `Annotated[Literal['response.created'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesErrorEventProjection()
```

**Bases:** [ResponsesEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesEventProjection)

A provider error is terminal diagnostic data, not assistant output.

**`message`** `Annotated[str, constrained()]`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['error'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesEventProjection()
```

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

Validate sequence numbers when supplied, without requiring unrelated metadata.

**`sequence_number`** `Annotated[int | None, constrained(strict=True, ge=0)] = None`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesFailedEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

Failure may still contain text and therefore remains a checked snapshot.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseFailedEvent')`

---

**`type`** `Annotated[Literal['response.failed'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesInProgressEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

Progress is a nonterminal snapshot.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseInProgressEvent')`

---

**`type`** `Annotated[Literal['response.in_progress'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesIncompleteEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

An incomplete response is terminal, but its partial text is not opaque.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseIncompleteEvent')`

---

**`type`** `Annotated[Literal['response.incomplete'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesIndexedEventProjection()
```

**Bases:** [ResponsesEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesEventProjection)

Track an output position without assuming reasoning always precedes text.

**`output_index`** `Annotated[int | None, constrained(strict=True, ge=0)] = None`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesLifecycleEventProjection()
```

**Bases:** [ResponsesEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesEventProjection)

Share the response snapshot field, not its concrete event identity.

**`response`** `Annotated[ResponsesLifecycleResponseProjection, guarded()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesLifecycleResponseProjection()
```

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

Describe a full response snapshot without demanding a message before generation.

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

---

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

---

**`output`** `Annotated[list[ResponsesReasoningItemProjection | ResponsesSnapshotMessageProjection], guarded()]`

---

**`output_text`** `Annotated[None, disabled(provider_integrity.duplicate_text)] = None`

---

**`policy`** `ObjectPolicy`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesMessageAddedEventProjection()
```

**Bases:** [ResponsesIndexedEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)

The assistant item is a snapshot, not opaque output.

**`item`** `Annotated[ResponsesSnapshotMessageProjection, guarded()]`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['response.output_item.added'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesMessageDoneEventProjection()
```

**Bases:** [ResponsesIndexedEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)

The completed assistant item must agree with previously observed deltas.

**`item`** `Annotated[ResponsesSnapshotMessageProjection, guarded()]`

---

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseOutputItemDoneEvent')`

---

**`type`** `Annotated[Literal['response.output_item.done'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesQueuedEventProjection()
```

**Bases:** [ResponsesLifecycleEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesLifecycleEventProjection)

Queue metadata does not make background execution an accepted request mode.

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseQueuedEvent')`

---

**`type`** `Annotated[Literal['response.queued'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesReasoningAddedEventProjection()
```

**Bases:** [ResponsesIndexedEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)

Allow only the reviewed, non-plaintext reasoning item.

**`item`** `Annotated[ResponsesReasoningItemProjection, constrained()]`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['response.output_item.added'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesReasoningDoneEventProjection()
```

**Bases:** [ResponsesIndexedEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)

Preserve completed reasoning metadata without inspecting encrypted values.

**`item`** `Annotated[ResponsesReasoningItemProjection, constrained()]`

---

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseOutputItemDoneEvent')`

---

**`type`** `Annotated[Literal['response.output_item.done'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesSnapshotMessageProjection()
```

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

Allow an initially empty message, but never a second guarded text part.

**`content`** `Annotated[list[ResponsesSnapshotTextProjection], guarded(max_length=1)]`

---

**`id`** `Annotated[str | None, constrained()] = None`

---

**`policy`** `ObjectPolicy`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesSnapshotTextProjection()
```

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

An empty initial text snapshot is valid; annotations and logprobs stay restricted.

**`text`** `Annotated[str, guarded(assistant, replaceable=False)]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesTextDeltaEventProjection()
```

**Bases:** [ResponsesTextEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextEventProjection)

Only this event introduces new guarded assistant text.

**`delta`** `Annotated[str, guarded(assistant, replaceable=False)]`

---

**`logprobs`** `Annotated[list[Any] | None, constrained(reason=(provider_integrity.token_logprobs), max_length=0)] = None`

---

**`policy`** `ObjectPolicy`

---

**`type`** `Annotated[Literal['response.output_text.delta'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesTextDoneEventProjection()
```

**Bases:** [ResponsesTextEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesTextEventProjection)

Repeat the accumulated text rather than introducing a second text source.

**`logprobs`** `Annotated[list[Any] | None, constrained(reason=(provider_integrity.token_logprobs), max_length=0)] = None`

---

**`policy`** `ObjectPolicy = ObjectPolicy(source='ResponseTextDoneEvent')`

---

**`text`** `Annotated[str, guarded(assistant, replaceable=False)]`

---

**`type`** `Annotated[Literal['response.output_text.done'], constrained()]`

---

```python
class nemoguardrails.server.experimental.providers.openai.responses.stream_projection.ResponsesTextEventProjection()
```

**Bases:** [ResponsesIndexedEventProjection](#nemoguardrails-server-experimental-providers-openai-responses-stream_projection-ResponsesIndexedEventProjection)

Restrict content to the single text part and validate any supplied identity.

**`content_index`** `Annotated[int | None, constrained(strict=True, ge=0, le=0)] = None`

---

**`item_id`** `Annotated[str | None, constrained()] = None`

---