StreamEvent

org.llm4s.agent.graph.StreamEvent

What a subscriber receives. A payload - of a StreamEvent.Live or a RunEvent.Custom - is a snapshot taken when the node emitted it, and one value may be shared by every subscriber: a listener must not mutate it, and copies it (ujson.copy) to change it.

Attributes

Source
RunEvent.scala
Graph
Supertypes
trait Enum
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Members list

Type members

Enum entries

final case class Disconnected(lastSeq: Long, reason: DisconnectReason)

The subscription has ended; always the last event. lastSeq is the last durable seq the listener returned from: resubscribe with afterSeq = lastSeq to continue without a gap.

The subscription has ended; always the last event. lastSeq is the last durable seq the listener returned from: resubscribe with afterSeq = lastSeq to continue without a gap.

Attributes

Source
RunEvent.scala
final case class Durable(record: EventRecord)

A committed durable event, in ascending seq order.

A committed durable event, in ascending seq order.

Attributes

Source
RunEvent.scala
final case class Live(threadId: String, runId: String, token: FencingToken, taskId: String, nodeId: String, name: String, version: Int, payload: Value)

Live-only progress from RunContext.progress: never persisted, never replayed, no seq. name and version identify the payload, as for RunEvent.Custom. token is the FencingToken of the claim the sending run held, as on its EventRecords: a node of a run that lost its claim and ignores the interrupt may still send progress after a later run of the same RunId has claimed the thread, and only the token tells the two apart.

Live-only progress from RunContext.progress: never persisted, never replayed, no seq. name and version identify the payload, as for RunEvent.Custom. token is the FencingToken of the claim the sending run held, as on its EventRecords: a node of a run that lost its claim and ignores the interrupt may still send progress after a later run of the same RunId has claimed the thread, and only the token tells the two apart.

Attributes

Source
RunEvent.scala
final case class LiveGap(dropped: Int)

dropped live events were discarded at this point because the subscriber's queue was full. Inside a Nested, 0 means a delegated child's live events were sent where this subscription could not receive them - by another runtime holding the child, or before a crash, for a child already settled (design 4.47) - so how many is unknown; its durable events are kept, and Agent.subscribeChild replays them.

dropped live events were discarded at this point because the subscriber's queue was full. Inside a Nested, 0 means a delegated child's live events were sent where this subscription could not receive them - by another runtime holding the child, or before a crash, for a child already settled (design 4.47) - so how many is unknown; its durable events are kept, and Agent.subscribeChild replays them.

Attributes

Source
RunEvent.scala
final case class Nested(child: ChildRef, event: StreamEvent)

An event of the delegated child run child (design 4.47): live-only, never persisted in the parent's log, and delivered only to a parent subscription made with nested = true (Agent.stream, AgentRun.subscribe, GraphRuntime.subscribe). It follows the parent's live SubagentEvents.TaskStarted for the child, and carries every event of the child's run - durable, live, a LiveGap - up to its terminal event; a grandchild's events arrive nested twice. It takes a live slot of the parent's subscription, so an overflow is a LiveGap there (rule 12). Disconnected is never nested: the child's forwarding ends without one.

An event of the delegated child run child (design 4.47): live-only, never persisted in the parent's log, and delivered only to a parent subscription made with nested = true (Agent.stream, AgentRun.subscribe, GraphRuntime.subscribe). It follows the parent's live SubagentEvents.TaskStarted for the child, and carries every event of the child's run - durable, live, a LiveGap - up to its terminal event; a grandchild's events arrive nested twice. It takes a live slot of the parent's subscription, so an overflow is a LiveGap there (rule 12). Disconnected is never nested: the child's forwarding ends without one.

Attributes

Source
RunEvent.scala