MingaClaudeBridge.Wire.StreamEvent (minga_claude_bridge v0.1.0)

Copy Markdown View Source

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.

Summary

Functions

Decodes a stream_event frame.

Types

delta()

@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()

@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()

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

message_start()

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

t()

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

Functions

from_wire(map)

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

Decodes a stream_event frame.