# `MingaClaudeBridge.Wire.StreamEvent`
[🔗](https://github.com/jsmestad/minga-claude-bridge/blob/main/lib/minga_claude_bridge/wire/stream_event.ex#L1)

A `stream_event` frame: one Anthropic streaming event, emitted when Claude Code runs with `--include-partial-messages`.

`event` is a tagged sum over the Messages API stream events:

  * `{:message_start, %{id, model, usage}}`
  * `{:content_block_start, index, block}` where `block` is a `MingaClaudeBridge.Wire.Block.t()`
  * `{:content_block_delta, index, delta}` where `delta` is one of `{:text_delta, text}`, `{:thinking_delta, thinking}`, `{:input_json_delta, partial_json}`, `{:signature_delta, signature}`, `{:citations_delta, citation}`, or `{:unknown_delta, type}`
  * `{:content_block_stop, index}`
  * `{:message_delta, %{stop_reason, stop_sequence, usage}}`
  * `:message_stop`
  * `:ping`
  * `{:stream_error, %{type, message}}` for an API `error` event
  * `{:unknown_event, type}` for any other event type

`parent_tool_use_id` is `nil` for the main conversation. A non-nil value marks a subagent stream.

# `delta`

```elixir
@type delta() ::
  {:text_delta, String.t()}
  | {:thinking_delta, String.t()}
  | {:input_json_delta, String.t()}
  | {:signature_delta, String.t()}
  | {:citations_delta, MingaClaudeBridge.Wire.Field.json_map()}
  | {:unknown_delta, String.t()}
```

# `event`

```elixir
@type event() ::
  {:message_start, message_start()}
  | {:content_block_start, index :: non_neg_integer(),
     MingaClaudeBridge.Wire.Block.t()}
  | {:content_block_delta, index :: non_neg_integer(), delta()}
  | {:content_block_stop, index :: non_neg_integer()}
  | {:message_delta, message_delta()}
  | :message_stop
  | :ping
  | {:stream_error, %{type: String.t() | nil, message: String.t() | nil}}
  | {:unknown_event, String.t()}
```

# `message_delta`

```elixir
@type message_delta() :: %{
  stop_reason: MingaClaudeBridge.Wire.StopReason.t() | nil,
  stop_sequence: String.t() | nil,
  usage: MingaClaudeBridge.Wire.Usage.t() | nil
}
```

# `message_start`

```elixir
@type message_start() :: %{
  id: String.t() | nil,
  model: String.t() | nil,
  usage: MingaClaudeBridge.Wire.Usage.t() | nil
}
```

# `t`

```elixir
@type t() :: %MingaClaudeBridge.Wire.StreamEvent{
  event: event(),
  parent_tool_use_id: String.t() | nil,
  session_id: String.t() | nil,
  uuid: String.t() | nil
}
```

# `from_wire`

```elixir
@spec from_wire(MingaClaudeBridge.Wire.Field.json_map()) :: {:ok, t()} | :error
```

Decodes a `stream_event` frame.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
