@effect-uai/ui 0.0.0-stage → 0.17.0

package/dist/RunEvent.d.mts

@@ -0,0 +1,1225 @@
+import { Schema } from "effect";
+import * as Img from "@effect-uai/core/Image";
+declare namespace RunEvent_d_exports {
+  export { Citation, Data, Envelope, EnvelopeJson, Image, InputAccepted, InputId, Interrupt, Json, Live, NamedPayload, ObjectDelta, ObjectDone, ObjectFailed, ObjectStarted, Outcome, PROTOCOL_VERSION, Payloads, ReasoningDelta, ReasoningStarted, RefusalDelta, RunCompleted, RunEvent, RunFailed, RunId, RunInterrupted, RunStarted, RunStopped, StepFinished, StepReset, StepStarted, StreamId, Terminal, TextDelta, ToolApprovalRequested, ToolCallArgsDelta, ToolCallReady, ToolCallStarted, ToolPartial, ToolPayload, ToolResult, Untyped, Usage, envelopeFields, isTerminal, outcome, payloadEvents, plainEvents };
+}
+declare const PROTOCOL_VERSION = 2;
+declare const StreamId: Schema.brand<Schema.String, "StreamId">;
+type StreamId = typeof StreamId.Type;
+declare const RunId: Schema.brand<Schema.String, "RunId">;
+type RunId = typeof RunId.Type;
+/** Client-generated id of one input. */
+declare const InputId: Schema.brand<Schema.String, "InputId">;
+type InputId = typeof InputId.Type;
+declare const RunStarted: Schema.Struct<{
+  readonly type: Schema.Literal<"run-started">;
+} & {
+  readonly runId: Schema.brand<Schema.String, "RunId">;
+  /** Role of the run when a stream carries several, e.g. "assistant", "reviewer". */
+  readonly name: Schema.optional<Schema.String>;
+  /** Client input ids this run consumed, for optimistic-UI reconciliation. */
+  readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+  readonly protocol: Schema.Literal<2>;
+}>;
+/** A pause point the client must answer (today: a tool call awaiting approval). */
+declare const Interrupt: Schema.Struct<{
+  readonly callId: Schema.String;
+  readonly reason: Schema.Literal<"approval">;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+declare const RunCompleted: Schema.Struct<{
+  readonly type: Schema.Literal<"run-completed">;
+} & {
+  readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>;
+declare const RunInterrupted: Schema.Struct<{
+  readonly type: Schema.Literal<"run-interrupted">;
+} & {
+  readonly interrupts: Schema.$Array<Schema.Struct<{
+    readonly callId: Schema.String;
+    readonly reason: Schema.Literal<"approval">;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>>;
+}>;
+/** `reason` is a short code (an error's `_tag`); whether to offer a retry is the client's call. */
+declare const RunFailed: Schema.Struct<{
+  readonly type: Schema.Literal<"run-failed">;
+} & {
+  readonly reason: Schema.String;
+  readonly message: Schema.optional<Schema.String>;
+}>;
+declare const RunStopped: Schema.Struct<{
+  readonly type: Schema.Literal<"run-stopped">;
+}>;
+declare const StepStarted: Schema.Struct<{
+  readonly type: Schema.Literal<"step-started">;
+}>;
+declare const StepFinished: Schema.Struct<{
+  readonly type: Schema.Literal<"step-finished">;
+} & {
+  readonly usage: Schema.optional<Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>>;
+}>;
+/** Discard the current step's partial output (mid-stream fallback or retry). */
+declare const StepReset: Schema.Struct<{
+  readonly type: Schema.Literal<"step-reset">;
+}>;
+declare const TextDelta: Schema.Struct<{
+  readonly type: Schema.Literal<"text-delta">;
+} & {
+  readonly text: Schema.String;
+}>;
+/** The model declined to answer; distinct from text (core's `refusal` block). */
+declare const RefusalDelta: Schema.Struct<{
+  readonly type: Schema.Literal<"refusal-delta">;
+} & {
+  readonly text: Schema.String;
+}>;
+declare const ReasoningStarted: Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-started">;
+}>;
+declare const ReasoningDelta: Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-delta">;
+} & {
+  readonly text: Schema.String;
+  readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+}>;
+declare const Citation: Schema.Struct<{
+  readonly type: Schema.Literal<"citation">;
+} & {
+  readonly annotation: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"url_citation">;
+    readonly url: Schema.String;
+    readonly title: Schema.String;
+    readonly start_index: Schema.optional<Schema.Number>;
+    readonly end_index: Schema.optional<Schema.Number>;
+    readonly cited_text: Schema.optional<Schema.String>;
+    readonly marker: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_citation">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"container_file_citation">;
+    readonly container_id: Schema.String;
+    readonly file_id: Schema.String;
+    readonly start_index: Schema.Number;
+    readonly end_index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_path">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>]>;
+}>;
+declare const Image: Schema.Struct<{
+  readonly type: Schema.Literal<"image">;
+} & {
+  readonly image: Schema.Codec<Img.ImageSource, Img.ImageSource, never, never>;
+  /** Set only on a preview frame; absent means final. */
+  readonly partialIndex: Schema.optional<Schema.Number>;
+}>;
+declare const ObjectStarted: Schema.Struct<{
+  readonly type: Schema.Literal<"object-started">;
+} & {
+  readonly id: Schema.String;
+  /** Which schema or list the object belongs to. */
+  readonly name: Schema.optional<Schema.String>;
+}>;
+/** Either a JSON Patch against the previous partial value, or a snapshot `value`. */
+declare const ObjectDelta: Schema.Struct<{
+  readonly type: Schema.Literal<"object-delta">;
+} & {
+  readonly id: Schema.String;
+  readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly op: Schema.Literal<"add">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"remove">;
+    readonly path: Schema.String;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"replace">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>>>;
+  readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>;
+declare const ObjectDone: Schema.Struct<{
+  readonly type: Schema.Literal<"object-done">;
+} & {
+  readonly id: Schema.String;
+  /** The object's name again, so a client can decode `value` without state. */
+  readonly name: Schema.optional<Schema.String>;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+declare const ObjectFailed: Schema.Struct<{
+  readonly type: Schema.Literal<"object-failed">;
+} & {
+  readonly id: Schema.String;
+  readonly issues: Schema.$Array<Schema.Struct<{
+    readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+    readonly message: Schema.String;
+  }>>;
+}>;
+declare const ToolCallStarted: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-started">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+}>;
+declare const ToolCallArgsDelta: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-args-delta">;
+} & {
+  readonly callId: Schema.String;
+  readonly delta: Schema.String;
+}>;
+declare const ToolCallReady: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-ready">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+/** The run is waiting in-process for a decision on this call (it keeps running). */
+declare const ToolApprovalRequested: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-approval-requested">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+/** An intermediate value of a streaming tool, encoded like its output. */
+declare const ToolPartial: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-partial">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+/** How a call ended: its output, or an error (the tool's, core's, or the app's). */
+declare const outcome: <V extends Schema.Top, E extends Schema.Top>(value: V, error: E) => Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+  readonly value: V;
+}>, Schema.TaggedStruct<"Failure", {
+  readonly error: E;
+}>]>;
+/** An outcome as sent: value and error are JSON. */
+declare const Outcome: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.TaggedStruct<"Failure", {
+  readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>]>;
+type Outcome<V = Json, E = Json> = {
+  readonly _tag: "Success";
+  readonly value: V;
+} | {
+  readonly _tag: "Failure";
+  readonly error: E;
+};
+/**
+ * Every call ends with one `tool-result`: calls that ran, and calls the app
+ * closed itself (denied, cancelled, answered by the user).
+ */
+declare const ToolResult: Schema.Struct<{
+  readonly type: Schema.Literal<"tool-result">;
+} & {
+  readonly callId: Schema.String;
+  /** The tool's name, so a client can decode `result` without state. */
+  readonly name: Schema.String;
+  readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.TaggedStruct<"Failure", {
+    readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>;
+declare const Usage: Schema.Struct<{
+  readonly type: Schema.Literal<"usage">;
+} & {
+  readonly usage: Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>;
+}>;
+/** Persisted app payload; a repeated `id` replaces the earlier one in place. */
+declare const Data: Schema.Struct<{
+  readonly type: Schema.Literal<"data">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly id: Schema.optional<Schema.String>;
+}>;
+/** Transient app payload (metrics, status); latest value wins, never stored in a message. */
+declare const Live: Schema.Struct<{
+  readonly type: Schema.Literal<"live">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+/**
+ * Stream-scoped: the server accepted an input (queued or about to run). Lets a
+ * reloaded client show inputs that wait for their run. `input` is the app's
+ * encoded input (e.g. `Input.InputJson`); its run's `run-started` lists its id.
+ */
+declare const InputAccepted: Schema.Struct<{
+  readonly type: Schema.Literal<"input-accepted">;
+} & {
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>;
+/** Events whose payloads a contract types (see `UiContract`). */
+declare const payloadEvents: readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"run-completed">;
+} & {
+  readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-interrupted">;
+} & {
+  readonly interrupts: Schema.$Array<Schema.Struct<{
+    readonly callId: Schema.String;
+    readonly reason: Schema.Literal<"approval">;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-done">;
+} & {
+  readonly id: Schema.String;
+  /** The object's name again, so a client can decode `value` without state. */
+  readonly name: Schema.optional<Schema.String>;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-ready">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-approval-requested">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-partial">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-result">;
+} & {
+  readonly callId: Schema.String;
+  /** The tool's name, so a client can decode `result` without state. */
+  readonly name: Schema.String;
+  readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.TaggedStruct<"Failure", {
+    readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"data">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly id: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"live">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>];
+/** Events a contract leaves as they are. */
+declare const plainEvents: readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"run-started">;
+} & {
+  readonly runId: Schema.brand<Schema.String, "RunId">;
+  /** Role of the run when a stream carries several, e.g. "assistant", "reviewer". */
+  readonly name: Schema.optional<Schema.String>;
+  /** Client input ids this run consumed, for optimistic-UI reconciliation. */
+  readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+  readonly protocol: Schema.Literal<2>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-failed">;
+} & {
+  readonly reason: Schema.String;
+  readonly message: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-stopped">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-started">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-finished">;
+} & {
+  readonly usage: Schema.optional<Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-reset">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"text-delta">;
+} & {
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"refusal-delta">;
+} & {
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-started">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-delta">;
+} & {
+  readonly text: Schema.String;
+  readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"citation">;
+} & {
+  readonly annotation: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"url_citation">;
+    readonly url: Schema.String;
+    readonly title: Schema.String;
+    readonly start_index: Schema.optional<Schema.Number>;
+    readonly end_index: Schema.optional<Schema.Number>;
+    readonly cited_text: Schema.optional<Schema.String>;
+    readonly marker: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_citation">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"container_file_citation">;
+    readonly container_id: Schema.String;
+    readonly file_id: Schema.String;
+    readonly start_index: Schema.Number;
+    readonly end_index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_path">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"image">;
+} & {
+  readonly image: Schema.Codec<Img.ImageSource, Img.ImageSource, never, never>;
+  /** Set only on a preview frame; absent means final. */
+  readonly partialIndex: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-started">;
+} & {
+  readonly id: Schema.String;
+  /** Which schema or list the object belongs to. */
+  readonly name: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-delta">;
+} & {
+  readonly id: Schema.String;
+  readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly op: Schema.Literal<"add">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"remove">;
+    readonly path: Schema.String;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"replace">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>>>;
+  readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-failed">;
+} & {
+  readonly id: Schema.String;
+  readonly issues: Schema.$Array<Schema.Struct<{
+    readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+    readonly message: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-started">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-args-delta">;
+} & {
+  readonly callId: Schema.String;
+  readonly delta: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"usage">;
+} & {
+  readonly usage: Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"input-accepted">;
+} & {
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>];
+/** The protocol as sent: payloads are JSON. A contract decodes them (`UiContract`). */
+declare const RunEvent: Schema.Union<readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"run-started">;
+} & {
+  readonly runId: Schema.brand<Schema.String, "RunId">;
+  /** Role of the run when a stream carries several, e.g. "assistant", "reviewer". */
+  readonly name: Schema.optional<Schema.String>;
+  /** Client input ids this run consumed, for optimistic-UI reconciliation. */
+  readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+  readonly protocol: Schema.Literal<2>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-failed">;
+} & {
+  readonly reason: Schema.String;
+  readonly message: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-stopped">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-started">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-finished">;
+} & {
+  readonly usage: Schema.optional<Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"step-reset">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"text-delta">;
+} & {
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"refusal-delta">;
+} & {
+  readonly text: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-started">;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"reasoning-delta">;
+} & {
+  readonly text: Schema.String;
+  readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"citation">;
+} & {
+  readonly annotation: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"url_citation">;
+    readonly url: Schema.String;
+    readonly title: Schema.String;
+    readonly start_index: Schema.optional<Schema.Number>;
+    readonly end_index: Schema.optional<Schema.Number>;
+    readonly cited_text: Schema.optional<Schema.String>;
+    readonly marker: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_citation">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"container_file_citation">;
+    readonly container_id: Schema.String;
+    readonly file_id: Schema.String;
+    readonly start_index: Schema.Number;
+    readonly end_index: Schema.Number;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"file_path">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }>]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"image">;
+} & {
+  readonly image: Schema.Codec<Img.ImageSource, Img.ImageSource, never, never>;
+  /** Set only on a preview frame; absent means final. */
+  readonly partialIndex: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-started">;
+} & {
+  readonly id: Schema.String;
+  /** Which schema or list the object belongs to. */
+  readonly name: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-delta">;
+} & {
+  readonly id: Schema.String;
+  readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly op: Schema.Literal<"add">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"remove">;
+    readonly path: Schema.String;
+  }>, Schema.Struct<{
+    readonly op: Schema.Literal<"replace">;
+    readonly path: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>>>;
+  readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-failed">;
+} & {
+  readonly id: Schema.String;
+  readonly issues: Schema.$Array<Schema.Struct<{
+    readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+    readonly message: Schema.String;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-started">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-args-delta">;
+} & {
+  readonly callId: Schema.String;
+  readonly delta: Schema.String;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"usage">;
+} & {
+  readonly usage: Schema.Struct<{
+    readonly input_tokens: Schema.optional<Schema.Number>;
+    readonly output_tokens: Schema.optional<Schema.Number>;
+    readonly total_tokens: Schema.optional<Schema.Number>;
+    readonly input_tokens_details: Schema.optional<Schema.Struct<{
+      readonly cached_tokens: Schema.optional<Schema.Number>;
+      readonly cache_write_tokens: Schema.optional<Schema.Number>;
+    }>>;
+    readonly output_tokens_details: Schema.optional<Schema.Struct<{
+      readonly reasoning_tokens: Schema.optional<Schema.Number>;
+    }>>;
+  }>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"input-accepted">;
+} & {
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-completed">;
+} & {
+  readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"run-interrupted">;
+} & {
+  readonly interrupts: Schema.$Array<Schema.Struct<{
+    readonly callId: Schema.String;
+    readonly reason: Schema.Literal<"approval">;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"object-done">;
+} & {
+  readonly id: Schema.String;
+  /** The object's name again, so a client can decode `value` without state. */
+  readonly name: Schema.optional<Schema.String>;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-call-ready">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-approval-requested">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-partial">;
+} & {
+  readonly callId: Schema.String;
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"tool-result">;
+} & {
+  readonly callId: Schema.String;
+  /** The tool's name, so a client can decode `result` without state. */
+  readonly name: Schema.String;
+  readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.TaggedStruct<"Failure", {
+    readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"data">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly id: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"live">;
+} & {
+  readonly name: Schema.String;
+  readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+}>]>;
+declare const envelopeFields: {
+  streamId: Schema.brand<Schema.String, "StreamId">;
+  seq: Schema.Int;
+  /** Set on run-scoped events; absent on stream-scoped ones. */
+  runId: Schema.optional<Schema.brand<Schema.String, "RunId">>;
+};
+declare const Envelope: Schema.Struct<{
+  readonly streamId: Schema.brand<Schema.String, "StreamId">;
+  readonly seq: Schema.Int;
+  readonly runId: Schema.optional<Schema.brand<Schema.String, "RunId">>;
+  readonly event: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"run-started">;
+  } & {
+    readonly runId: Schema.brand<Schema.String, "RunId">;
+    /** Role of the run when a stream carries several, e.g. "assistant", "reviewer". */
+    readonly name: Schema.optional<Schema.String>;
+    /** Client input ids this run consumed, for optimistic-UI reconciliation. */
+    readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+    readonly protocol: Schema.Literal<2>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-failed">;
+  } & {
+    readonly reason: Schema.String;
+    readonly message: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-stopped">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-finished">;
+  } & {
+    readonly usage: Schema.optional<Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-reset">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"text-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"refusal-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-delta">;
+  } & {
+    readonly text: Schema.String;
+    readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"citation">;
+  } & {
+    readonly annotation: Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"url_citation">;
+      readonly url: Schema.String;
+      readonly title: Schema.String;
+      readonly start_index: Schema.optional<Schema.Number>;
+      readonly end_index: Schema.optional<Schema.Number>;
+      readonly cited_text: Schema.optional<Schema.String>;
+      readonly marker: Schema.optional<Schema.Number>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_citation">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"container_file_citation">;
+      readonly container_id: Schema.String;
+      readonly file_id: Schema.String;
+      readonly start_index: Schema.Number;
+      readonly end_index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_path">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"image">;
+  } & {
+    readonly image: Schema.Codec<Img.ImageSource, Img.ImageSource, never, never>;
+    /** Set only on a preview frame; absent means final. */
+    readonly partialIndex: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-started">;
+  } & {
+    readonly id: Schema.String;
+    /** Which schema or list the object belongs to. */
+    readonly name: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-delta">;
+  } & {
+    readonly id: Schema.String;
+    readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly op: Schema.Literal<"add">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"remove">;
+      readonly path: Schema.String;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"replace">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>>>;
+    readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-failed">;
+  } & {
+    readonly id: Schema.String;
+    readonly issues: Schema.$Array<Schema.Struct<{
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+      readonly message: Schema.String;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-started">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-args-delta">;
+  } & {
+    readonly callId: Schema.String;
+    readonly delta: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"usage">;
+  } & {
+    readonly usage: Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"input-accepted">;
+  } & {
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-completed">;
+  } & {
+    readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-interrupted">;
+  } & {
+    readonly interrupts: Schema.$Array<Schema.Struct<{
+      readonly callId: Schema.String;
+      readonly reason: Schema.Literal<"approval">;
+      readonly name: Schema.String;
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-done">;
+  } & {
+    readonly id: Schema.String;
+    /** The object's name again, so a client can decode `value` without state. */
+    readonly name: Schema.optional<Schema.String>;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-ready">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-approval-requested">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-partial">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-result">;
+  } & {
+    readonly callId: Schema.String;
+    /** The tool's name, so a client can decode `result` without state. */
+    readonly name: Schema.String;
+    readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.TaggedStruct<"Failure", {
+      readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"data">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"live">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>;
+/** JSON codec for the wire: `Uint8Array` image bytes and other non-JSON values encode safely. */
+declare const EnvelopeJson: Schema.toCodecJson<Schema.Struct<{
+  readonly streamId: Schema.brand<Schema.String, "StreamId">;
+  readonly seq: Schema.Int;
+  readonly runId: Schema.optional<Schema.brand<Schema.String, "RunId">>;
+  readonly event: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"run-started">;
+  } & {
+    readonly runId: Schema.brand<Schema.String, "RunId">;
+    /** Role of the run when a stream carries several, e.g. "assistant", "reviewer". */
+    readonly name: Schema.optional<Schema.String>;
+    /** Client input ids this run consumed, for optimistic-UI reconciliation. */
+    readonly inputs: Schema.$Array<Schema.brand<Schema.String, "InputId">>;
+    readonly protocol: Schema.Literal<2>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-failed">;
+  } & {
+    readonly reason: Schema.String;
+    readonly message: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-stopped">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-finished">;
+  } & {
+    readonly usage: Schema.optional<Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"step-reset">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"text-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"refusal-delta">;
+  } & {
+    readonly text: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-started">;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"reasoning-delta">;
+  } & {
+    readonly text: Schema.String;
+    readonly kind: Schema.Literals<readonly ["trace", "summary"]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"citation">;
+  } & {
+    readonly annotation: Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"url_citation">;
+      readonly url: Schema.String;
+      readonly title: Schema.String;
+      readonly start_index: Schema.optional<Schema.Number>;
+      readonly end_index: Schema.optional<Schema.Number>;
+      readonly cited_text: Schema.optional<Schema.String>;
+      readonly marker: Schema.optional<Schema.Number>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_citation">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"container_file_citation">;
+      readonly container_id: Schema.String;
+      readonly file_id: Schema.String;
+      readonly start_index: Schema.Number;
+      readonly end_index: Schema.Number;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"file_path">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"image">;
+  } & {
+    readonly image: Schema.Codec<Img.ImageSource, Img.ImageSource, never, never>;
+    /** Set only on a preview frame; absent means final. */
+    readonly partialIndex: Schema.optional<Schema.Number>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-started">;
+  } & {
+    readonly id: Schema.String;
+    /** Which schema or list the object belongs to. */
+    readonly name: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-delta">;
+  } & {
+    readonly id: Schema.String;
+    readonly patch: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly op: Schema.Literal<"add">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"remove">;
+      readonly path: Schema.String;
+    }>, Schema.Struct<{
+      readonly op: Schema.Literal<"replace">;
+      readonly path: Schema.String;
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>>>;
+    readonly value: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-failed">;
+  } & {
+    readonly id: Schema.String;
+    readonly issues: Schema.$Array<Schema.Struct<{
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Number]>>;
+      readonly message: Schema.String;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-started">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-args-delta">;
+  } & {
+    readonly callId: Schema.String;
+    readonly delta: Schema.String;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"usage">;
+  } & {
+    readonly usage: Schema.Struct<{
+      readonly input_tokens: Schema.optional<Schema.Number>;
+      readonly output_tokens: Schema.optional<Schema.Number>;
+      readonly total_tokens: Schema.optional<Schema.Number>;
+      readonly input_tokens_details: Schema.optional<Schema.Struct<{
+        readonly cached_tokens: Schema.optional<Schema.Number>;
+        readonly cache_write_tokens: Schema.optional<Schema.Number>;
+      }>>;
+      readonly output_tokens_details: Schema.optional<Schema.Struct<{
+        readonly reasoning_tokens: Schema.optional<Schema.Number>;
+      }>>;
+    }>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"input-accepted">;
+  } & {
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-completed">;
+  } & {
+    readonly metadata: Schema.optional<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"run-interrupted">;
+  } & {
+    readonly interrupts: Schema.$Array<Schema.Struct<{
+      readonly callId: Schema.String;
+      readonly reason: Schema.Literal<"approval">;
+      readonly name: Schema.String;
+      readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"object-done">;
+  } & {
+    readonly id: Schema.String;
+    /** The object's name again, so a client can decode `value` without state. */
+    readonly name: Schema.optional<Schema.String>;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-call-ready">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-approval-requested">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-partial">;
+  } & {
+    readonly callId: Schema.String;
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"tool-result">;
+  } & {
+    readonly callId: Schema.String;
+    /** The tool's name, so a client can decode `result` without state. */
+    readonly name: Schema.String;
+    readonly result: Schema.Union<readonly [Schema.TaggedStruct<"Success", {
+      readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>, Schema.TaggedStruct<"Failure", {
+      readonly error: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    }>]>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"data">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly id: Schema.optional<Schema.String>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"live">;
+  } & {
+    readonly name: Schema.String;
+    readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  }>]>;
+}>>;
+type Json = Schema.Json;
+type ToolPayload = {
+  readonly name: string;
+  readonly input: unknown;
+  readonly output: unknown;
+  /** Every error a call of this tool can end with. */
+  readonly failure: unknown;
+};
+type NamedPayload = {
+  readonly name: string;
+  readonly value: unknown;
+};
+/** Typed payloads: each field is a union with one member per name. */
+type Payloads = {
+  readonly tool: ToolPayload;
+  readonly object: NamedPayload;
+  readonly data: NamedPayload;
+  readonly live: NamedPayload;
+  readonly metadata: unknown;
+};
+/** No contract: any name, payloads as sent. */
+type Untyped = {
+  readonly tool: {
+    readonly name: string;
+    readonly input: Json;
+    readonly output: Json;
+    readonly failure: Json;
+  };
+  readonly object: {
+    readonly name: string;
+    readonly value: Json;
+  };
+  readonly data: {
+    readonly name: string;
+    readonly value: Json;
+  };
+  readonly live: {
+    readonly name: string;
+    readonly value: Json;
+  };
+  readonly metadata: Json;
+};
+type Plain = (typeof plainEvents)[number]["Type"];
+type ToolEvents<T> = T extends ToolPayload ? {
+  readonly type: "tool-partial";
+  readonly callId: string;
+  readonly name: T["name"];
+  readonly value: T["output"];
+} | {
+  readonly type: "tool-result";
+  readonly callId: string;
+  readonly name: T["name"];
+  readonly result: Outcome<T["output"], T["failure"]>;
+} : never;
+type Interrupt<P extends Payloads = Untyped> = {
+  readonly callId: string;
+  readonly reason: "approval";
+  readonly name: P["tool"]["name"];
+  readonly input: P["tool"]["input"];
+};
+type Typed<P extends Payloads> = {
+  readonly type: "run-completed";
+  readonly metadata?: P["metadata"] | undefined;
+} | {
+  readonly type: "run-interrupted";
+  readonly interrupts: ReadonlyArray<Interrupt<P>>;
+} | {
+  readonly type: "object-done";
+  readonly id: string;
+  readonly name?: P["object"]["name"] | undefined;
+  readonly value: P["object"]["value"];
+} | {
+  readonly type: "tool-call-ready";
+  readonly callId: string;
+  readonly name: P["tool"]["name"];
+  readonly input: P["tool"]["input"];
+} | {
+  readonly type: "tool-approval-requested";
+  readonly callId: string;
+  readonly name: P["tool"]["name"];
+  readonly input: P["tool"]["input"];
+} | ToolEvents<P["tool"]> | {
+  readonly type: "data";
+  readonly name: P["data"]["name"];
+  readonly value: P["data"]["value"];
+  readonly id?: string | undefined;
+} | {
+  readonly type: "live";
+  readonly name: P["live"]["name"];
+  readonly value: P["live"]["value"];
+};
+/** One event; with a contract's `P`, its payloads are decoded. */
+type RunEvent<P extends Payloads = Untyped> = Plain | Typed<P>;
+type Envelope<P extends Payloads = Untyped> = {
+  readonly streamId: StreamId;
+  readonly seq: number;
+  readonly runId?: RunId | undefined;
+  readonly event: RunEvent<P>;
+};
+type Terminal<P extends Payloads = Untyped> = Extract<RunEvent<P>, {
+  readonly type: "run-completed" | "run-interrupted" | "run-failed" | "run-stopped";
+}>;
+declare const isTerminal: <P extends Payloads = Untyped>(event: RunEvent<P>) => event is Terminal<P>;
+//#endregion
+export { Citation, Data, Envelope, EnvelopeJson, Image, InputAccepted, InputId, Interrupt, Json, Live, NamedPayload, ObjectDelta, ObjectDone, ObjectFailed, ObjectStarted, Outcome, PROTOCOL_VERSION, Payloads, ReasoningDelta, ReasoningStarted, RefusalDelta, RunCompleted, RunEvent, RunFailed, RunId, RunInterrupted, RunStarted, RunStopped, StepFinished, StepReset, StepStarted, StreamId, Terminal, TextDelta, ToolApprovalRequested, ToolCallArgsDelta, ToolCallReady, ToolCallStarted, ToolPartial, ToolPayload, ToolResult, Untyped, Usage, envelopeFields, isTerminal, outcome, payloadEvents, plainEvents, RunEvent_d_exports as t };
+//# sourceMappingURL=RunEvent.d.mts.map