LemonGateway.Event.Delta (lemon_gateway v0.1.0)

View Source

Streaming delta event for incremental text output.

Emitted during run execution to provide real-time text updates.

Fields

  • :run_id - The run this delta belongs to
  • :ts_ms - Timestamp in milliseconds
  • :seq - Monotonic sequence number (starts at 1, per run)
  • :text - The delta text content
  • :meta - Optional metadata

Ordering Contract

  • seq is monotonic per run (starts at 1)
  • Router/coalescer can reorder/drop duplicates safely using seq

Summary

Types

t()

@type t() :: %LemonGateway.Event.Delta{
  meta: map() | nil,
  run_id: String.t(),
  seq: pos_integer(),
  text: String.t(),
  ts_ms: non_neg_integer()
}

Functions

new(run_id, seq, text, meta \\ nil)

@spec new(
  run_id :: String.t(),
  seq :: pos_integer(),
  text :: String.t(),
  meta :: map() | nil
) :: t()

Create a new delta event.