AgentConnection

One connection’s ordered Agent Session event stream.

Capacity is bounded per connection:

At most 32 utterances are pending, including the one being planned or awaiting acknowledgement. A further utterance receives an error event with code queue_full and is not remembered, so it can be sent again.
At most 4,096 input IDs are remembered, with no eviction, so a repeated input is always ignored. After that, a new utterance receives an error event with code session_capacity. The host must open a new connection to continue.
Each UI change waits for acknowledgement for at most OpenConnectionOptions.acknowledgementTimeoutMs, 30 seconds by default. A timeout fails the run and cancels queued work.

Methods

close(): void

Aborts pending work and releases listeners. Idempotent; no later events are emitted.

void

send(input): Promise<void>

Accepts untrusted input. Resolves after handling it, without waiting for a later UI acknowledgement.

unknown

Promise<void>

subscribe(listener): () => void

Observes future events in emission order. Returns an unsubscribe function; there is no replay.

(event) => void

() => void