agents 0.26.0 → 0.28.0

package/dist/protocol-CukuI73M.d.ts

@@ -0,0 +1,386 @@
+//#region src/experimental/channels/surface.d.ts
+/**
+ * A JSON value safe to persist across Worker and Durable Object boundaries.
+ *
+ * The recursive arms are interfaces rather than inline type literals so that
+ * TypeScript defers resolving them. Workers RPC checks a return type with
+ * `R extends Rpc.Serializable<R>`, which eagerly expands a self-referential
+ * type alias and fails with "Type instantiation is excessively deep". Deferred
+ * arms let a surface be returned from a Durable Object method.
+ */
+type ChannelSurfaceValue =
+  | null
+  | boolean
+  | number
+  | string
+  | ChannelSurfaceArray
+  | ChannelSurfaceObject;
+interface ChannelSurfaceArray extends ReadonlyArray<ChannelSurfaceValue> {}
+interface ChannelSurfaceObject {
+  readonly [key: string]: ChannelSurfaceValue;
+}
+/** A durable configured destination for one outbound message attempt. */
+type ChannelMessageSurface<
+  TChannelKey extends string = string,
+  TAddress extends ChannelSurfaceValue = ChannelSurfaceValue
+> = Readonly<{
+  channelKey: TChannelKey;
+  version: 1;
+  address: TAddress /** Human-readable destination text captured when the surface is created. */;
+  label: string;
+}>;
+/** A Channel-produced destination before its Host stamps the configured key. */
+type ChannelMessageSurfaceInput<
+  TAddress extends ChannelSurfaceValue = ChannelSurfaceValue
+> = Readonly<{
+  version: 1;
+  address: TAddress;
+  label: string;
+}>;
+/** Validate the common envelope before provider-specific address parsing. */
+declare function isChannelMessageSurface(
+  value: unknown
+): value is ChannelMessageSurface;
+//#endregion
+//#region src/experimental/channels/protocol.d.ts
+type Json = null | boolean | number | string | JsonArray | JsonObject;
+interface JsonArray extends ReadonlyArray<Json> {}
+interface JsonObject {
+  readonly [key: string]: Json;
+}
+type Participant = Readonly<{
+  /** Stable within the conversation. What the agent compares for ownership. */ id: string;
+  name?: string;
+}>;
+type TranscriptMessage = {
+  id: string;
+  role: "system" | "user" | "assistant";
+  parts: MessagePart[];
+  metadata?: JsonObject;
+};
+type MessagePart =
+  | {
+      type: "text";
+      text: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "reasoning";
+      text: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "file";
+      mediaType: string;
+      url: string;
+      filename?: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "source-url";
+      sourceId: string;
+      url: string;
+      title?: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "source-document";
+      sourceId: string;
+      mediaType: string;
+      title: string;
+      filename?: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "data";
+      name: string;
+      id?: string;
+      data: Json;
+    }
+  | ToolPart;
+type ToolState =
+  | "input-streaming"
+  | "input-available"
+  | "approval-requested"
+  | "approval-responded"
+  | "output-available"
+  | "output-error"
+  | "output-denied";
+type ToolPart = {
+  type: "tool";
+  toolCallId: string;
+  toolName: string;
+  state: ToolState;
+  input?: Json;
+  output?: Json;
+  errorText?: string /** Output so far; a later output replaces it. */;
+  preliminary?: boolean;
+  approval?: {
+    id: string;
+    approved?: boolean;
+    reason?: string;
+  } /** Id of the participant who may run this client tool call. Absent for server tools. */;
+  owner?: string;
+  providerExecuted?: boolean;
+  dynamic?: boolean;
+  title?: string;
+  providerMetadata?: JsonObject;
+};
+type ResponseChunk =
+  | {
+      type: "text-start";
+      id: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "text-delta";
+      id: string;
+      delta: string;
+    }
+  | {
+      type: "text-end";
+      id: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "reasoning-start";
+      id: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "reasoning-delta";
+      id: string;
+      delta: string;
+    }
+  | {
+      type: "reasoning-end";
+      id: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "tool-input-start";
+      toolCallId: string;
+      toolName: string;
+      owner?: string;
+      providerExecuted?: boolean;
+      dynamic?: boolean;
+      title?: string;
+    }
+  | {
+      type: "tool-input-delta";
+      toolCallId: string;
+      delta: string;
+    }
+  | {
+      type: "tool-input-available";
+      toolCallId: string;
+      toolName: string;
+      input: Json;
+      owner?: string;
+      providerExecuted?: boolean;
+      dynamic?: boolean;
+      title?: string;
+      providerMetadata?: JsonObject;
+    }
+  | {
+      type: "tool-input-error";
+      toolCallId: string;
+      toolName: string;
+      input: Json;
+      errorText: string;
+      providerExecuted?: boolean;
+      dynamic?: boolean;
+      title?: string;
+    }
+  | {
+      type: "tool-approval-request";
+      toolCallId: string;
+      approvalId: string;
+    }
+  | {
+      type: "tool-output-available";
+      toolCallId: string;
+      output: Json;
+      preliminary?: boolean;
+      providerExecuted?: boolean;
+    }
+  | {
+      type: "tool-output-error";
+      toolCallId: string;
+      errorText: string;
+      providerExecuted?: boolean;
+    }
+  | {
+      type: "tool-output-denied";
+      toolCallId: string;
+    }
+  | Extract<
+      MessagePart,
+      {
+        type: "file" | "source-url" | "source-document";
+      }
+    >
+  | {
+      type: "data";
+      name: string;
+      id?: string;
+      data: Json;
+      transient?: boolean;
+    } /** Merged into the metadata of the message this response builds. */
+  | {
+      type: "metadata";
+      metadata: JsonObject;
+    };
+type TurnOutcome = "completed" | "failed" | "aborted" | "awaiting-input";
+type TurnStatusBase = {
+  turnId: string /** Event id of the inbound message that started the turn. */;
+  startedBy: string;
+};
+type TurnStatus = TurnStatusBase &
+  (
+    | {
+        status: "queued";
+      }
+    | {
+        status: "running";
+        responseId: string /** Saved assistant message the response continues. */;
+        extends?: string;
+      }
+    | {
+        status: "settled";
+        outcome: Exclude<TurnOutcome, "failed">;
+        messageIds: string[];
+      }
+    | {
+        status: "settled";
+        outcome: "failed";
+        messageIds: string[] /** Shown to participants. Channels sends a generic message when absent. */;
+        error?: string;
+      }
+  );
+type ConversationSnapshot = {
+  messages: TranscriptMessage[] /** Every turn that is queued, running or awaiting input. */;
+  turns: TurnStatus[];
+};
+/** Tool a participant's client can run, advertised with an inbound event. */
+type ClientTool = {
+  name: string;
+  description?: string;
+  inputSchema?: JsonObject;
+};
+/** What an interface sends. */
+type InboundEvent = {
+  /** Stable across redelivery of the same event. */ eventId: string;
+} & (
+  | {
+      type: "message" /** Save it under this id. */;
+      message: TranscriptMessage & {
+        role: "user";
+      };
+      clientTools?: ClientTool[];
+    }
+  | {
+      type: "tool-result";
+      turnId: string;
+      toolCallId: string;
+      result:
+        | {
+            ok: true;
+            output: Json;
+          }
+        | {
+            ok: false;
+            errorText?: string;
+          };
+      clientTools?: ClientTool[];
+    }
+  | {
+      type: "approval-response";
+      turnId: string;
+      approvalId: string;
+      approved: boolean;
+      reason?: string;
+    }
+  | {
+      type: "cancel";
+      turnId: string;
+    } /** Start a new, empty conversation. The sending surface follows it. */
+  | {
+      type: "conversation-create";
+    }
+  /**
+   * Start a new conversation with this one's transcript so far. The sending
+   * surface follows it; other surfaces stay.
+   */
+  | {
+      type: "conversation-fork";
+    }
+  /**
+   * Start this conversation over, keeping its id. The agent may carry a
+   * handoff note into the new context.
+   */
+  | {
+      type: "conversation-reset";
+      handoff?: string;
+    }
+);
+/** Inbound events that act on a conversation rather than in it. */
+type ConversationOperation = Extract<
+  InboundEvent["type"],
+  "conversation-create" | "conversation-fork" | "conversation-reset"
+>;
+/** One of an agent's conversations, as a client lists them. */
+type ConversationInfo = {
+  id: string /** The conversation this one was forked from. */;
+  parent?: string /** True while a turn is running or queued. */;
+  busy: boolean;
+};
+/** What an accepted inbound event produced, for the surface that sent it. */
+type DispatchResult = {
+  /** The conversation a create or fork started; the sender follows it. */ conversationId?: string;
+};
+/** Where an inbound event came from, stamped by Channels, never by the client. */
+type EventOrigin = {
+  conversationId: string;
+  participant: Participant;
+  surface: ChannelMessageSurface;
+};
+/**
+ * Where an inbound event came from, as the gateway knows it: the route that
+ * picked the agent, and the conversation when the route named one. Channels
+ * resolves an unnamed conversation to the agent's default: the route itself,
+ * or a harness's default session.
+ */
+type GatewayOrigin = Omit<EventOrigin, "conversationId"> & {
+  route: string;
+  conversationId?: string;
+};
+//#endregion
+export {
+  ChannelSurfaceObject as C,
+  ChannelSurfaceArray as S,
+  isChannelMessageSurface as T,
+  TranscriptMessage as _,
+  DispatchResult as a,
+  ChannelMessageSurface as b,
+  InboundEvent as c,
+  JsonObject as d,
+  MessagePart as f,
+  ToolState as g,
+  ToolPart as h,
+  ConversationSnapshot as i,
+  Json as l,
+  ResponseChunk as m,
+  ConversationInfo as n,
+  EventOrigin as o,
+  Participant as p,
+  ConversationOperation as r,
+  GatewayOrigin as s,
+  ClientTool as t,
+  JsonArray as u,
+  TurnOutcome as v,
+  ChannelSurfaceValue as w,
+  ChannelMessageSurfaceInput as x,
+  TurnStatus as y
+};
+//# sourceMappingURL=protocol-CukuI73M.d.ts.map

package/dist/protocol-cOklVBBD.js

@@ -0,0 +1,227 @@
+//#region src/harness/container/protocol.ts
+/**
+* The wire between `ContainerHarness` (in a Durable Object) and the harness
+* daemon (in the container). Isomorphic and dependency-free: the daemon
+* imports it in Node, the harness in Workers.
+*
+* One WebSocket per session, dialled by the object through
+* `ctx.container.getTcpPort(port)` at `/sessions/<id>`. The daemon speaks
+* first with `hello`; the object answers with `open` (when the daemon does
+* not hold the session yet) and `replay`, then delivers `prompt`s.
+*
+* Everything the daemon produces for a session is a numbered `frame`. The
+* numbers start at 1 for each session in each container, so a frame is
+* addressed by `(runtimeId, seq)`. The daemon keeps frames until they are
+* acknowledged, so an object that lost its socket (evicted, redeployed)
+* replays what it missed from its cursor. A different `runtimeId` in
+* `hello` means a different container: its numbering starts again, and
+* whatever the old container was doing is gone.
+*
+* @experimental The wire may change before it stabilizes. The object and the image are
+* a matched pair; a version mismatch is reported in `hello`.
+*/
+/** Bumped on any incompatible change. */
+const CONTAINER_PROTOCOL_VERSION = 1;
+/** The daemon answers `200` here once it accepts connections. */
+const CONTAINER_HEALTH_PATH = "/healthz";
+/** The session socket: `/sessions/<encoded session id>`. */
+const CONTAINER_SESSION_PATH = "/sessions/";
+/** The shared secret the object passes on every request. */
+const CONTAINER_TOKEN_HEADER = "x-cf-harness-token";
+/** The environment variables the object starts the container with. */
+const CONTAINER_ENV = {
+	/** Shared secret for `CONTAINER_TOKEN_HEADER`. */
+	token: "CF_HARNESS_TOKEN",
+	/** This container's id. Echoed in `hello`. */
+	runtimeId: "CF_HARNESS_RUNTIME_ID",
+	/** The port the daemon listens on. */
+	port: "CF_HARNESS_PORT"
+};
+/** WebSocket close code: a newer connection for the session replaced this one. */
+const CLOSE_REPLACED = 4001;
+/** WebSocket close code: the request was not authorized. */
+const CLOSE_UNAUTHORIZED = 4003;
+/**
+* Most JSON characters the object puts in one `restore` message, and the
+* daemon in one `persist` frame (a single larger entry travels alone).
+* Keeps every message well inside WebSocket message limits.
+*/
+const MAX_CHUNK_CHARS = 256 * 1024;
+function isFields(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+	return typeof value === "string";
+}
+function isCount(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isJson(value) {
+	if (value === null) return true;
+	switch (typeof value) {
+		case "string":
+		case "boolean": return true;
+		case "number": return Number.isFinite(value);
+		case "object":
+			if (Array.isArray(value)) return value.every(isJson);
+			return Object.values(value).every(isJson);
+		default: return false;
+	}
+}
+function isOutcome(value) {
+	if (!isFields(value)) return false;
+	if (value.status === "done") return isString(value.text);
+	return value.status === "unanswered" && isString(value.reason);
+}
+function isEvent(value) {
+	if (!isFields(value) || !isString(value.type) || !isJson(value)) return false;
+	switch (value.type) {
+		case "text-delta":
+		case "reasoning-delta": return isString(value.messageId) && isString(value.delta);
+		case "message": return isFields(value.message) && isString(value.message.id) && (value.message.role === "user" || value.message.role === "assistant") && Array.isArray(value.message.parts);
+		case "usage": return true;
+		case "log": return isString(value.message);
+		case "raw": return "value" in value;
+		default: return false;
+	}
+}
+function isFrame(value) {
+	if (!isFields(value)) return false;
+	switch (value.kind) {
+		case "start": return isString(value.operationId);
+		case "event": return (value.operationId === null || isString(value.operationId)) && isEvent(value.event);
+		case "persist": return Array.isArray(value.entries) && value.entries.every(isJson);
+		case "settle": return isString(value.operationId) && isOutcome(value.outcome);
+		default: return false;
+	}
+}
+function isDaemonOperation(value) {
+	if (!isFields(value) || !isString(value.operationId)) return false;
+	if (value.status === "queued" || value.status === "running") return true;
+	return value.status === "settled" && isOutcome(value.outcome);
+}
+function isInput(value) {
+	if (isString(value)) return true;
+	return Array.isArray(value) && value.every((part) => isFields(part) && (part.type === "text" && isString(part.text) || part.type === "image" && isString(part.mediaType) && isString(part.data)));
+}
+function isSettings(value) {
+	return isFields(value) && (value.model === void 0 || isString(value.model)) && (value.options === void 0 || isJson(value.options));
+}
+function decode(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return;
+	}
+}
+/**
+* Parse one message from the daemon.
+*
+* @param text - The raw WebSocket message.
+* @returns The message, or `undefined` when it is not one.
+*/
+function parseDaemonMessage(text) {
+	const value = decode(text);
+	if (!isFields(value)) return void 0;
+	switch (value.type) {
+		case "hello":
+			if (isCount(value.protocol) && isString(value.runtimeId) && isString(value.session) && isFields(value.adapter) && isString(value.adapter.id) && isString(value.adapter.version) && Array.isArray(value.adapter.capabilities) && value.adapter.capabilities.every(isString) && (value.open === null || isCount(value.open)) && isCount(value.lastSeq) && Array.isArray(value.operations) && value.operations.every(isDaemonOperation)) return value;
+			return;
+		case "frame": return isCount(value.seq) && isFrame(value.frame) ? value : void 0;
+		case "caught-up": return isCount(value.lastSeq) ? {
+			type: "caught-up",
+			lastSeq: value.lastSeq
+		} : void 0;
+		case "error": return isString(value.message) ? {
+			type: "error",
+			message: value.message
+		} : void 0;
+		default: return;
+	}
+}
+/**
+* Parse one message from the object.
+*
+* @param text - The raw WebSocket message.
+* @returns The message, or `undefined` when it is not one.
+*/
+function parseHostMessage(text) {
+	const value = decode(text);
+	if (!isFields(value)) return void 0;
+	switch (value.type) {
+		case "restore": return isCount(value.generation) && Array.isArray(value.entries) && value.entries.every(isJson) ? {
+			type: "restore",
+			generation: value.generation,
+			entries: value.entries
+		} : void 0;
+		case "open": return isCount(value.generation) && isSettings(value.settings) && Array.isArray(value.restore) && value.restore.every(isJson) ? {
+			type: "open",
+			generation: value.generation,
+			settings: value.settings,
+			restore: value.restore
+		} : void 0;
+		case "replay": return isCount(value.after) ? {
+			type: "replay",
+			after: value.after
+		} : void 0;
+		case "prompt": return isString(value.operationId) && isInput(value.input) && (value.whenBusy === "followUp" || value.whenBusy === "steer") ? {
+			type: "prompt",
+			operationId: value.operationId,
+			input: value.input,
+			whenBusy: value.whenBusy
+		} : void 0;
+		case "abort":
+			if (value.operationId === void 0) return { type: "abort" };
+			return isString(value.operationId) ? {
+				type: "abort",
+				operationId: value.operationId
+			} : void 0;
+		case "configure": return isSettings(value.settings) ? {
+			type: "configure",
+			settings: value.settings
+		} : void 0;
+		case "ack": return isCount(value.seq) ? {
+			type: "ack",
+			seq: value.seq
+		} : void 0;
+		default: return;
+	}
+}
+/**
+* The text of an input, with image parts left out.
+*
+* @param input - A prompt's input.
+* @returns Its text.
+*/
+function inputText(input) {
+	if (typeof input === "string") return input;
+	return input.map((part) => part.type === "text" ? part.text : "").join("\n");
+}
+/**
+* Split entries into groups whose JSON stays under `MAX_CHUNK_CHARS`. An
+* entry larger than that is a group of its own.
+*
+* @param entries - The entries, in order.
+* @returns The groups, in order. Empty for no entries.
+*/
+function chunkEntries(entries) {
+	const groups = [];
+	let group = [];
+	let size = 0;
+	for (const entry of entries) {
+		const length = JSON.stringify(entry).length;
+		if (group.length > 0 && size + length > 262144) {
+			groups.push(group);
+			group = [];
+			size = 0;
+		}
+		group.push(entry);
+		size += length;
+	}
+	if (group.length > 0) groups.push(group);
+	return groups;
+}
+//#endregion
+export { CONTAINER_PROTOCOL_VERSION as a, MAX_CHUNK_CHARS as c, parseDaemonMessage as d, parseHostMessage as f, CONTAINER_HEALTH_PATH as i, chunkEntries as l, CLOSE_UNAUTHORIZED as n, CONTAINER_SESSION_PATH as o, CONTAINER_ENV as r, CONTAINER_TOKEN_HEADER as s, CLOSE_REPLACED as t, inputText as u };
+
+//# sourceMappingURL=protocol-cOklVBBD.js.map

package/dist/protocol-cOklVBBD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-cOklVBBD.js","names":[],"sources":["../src/harness/container/protocol.ts"],"sourcesContent":["/**\n * The wire between `ContainerHarness` (in a Durable Object) and the harness\n * daemon (in the container). Isomorphic and dependency-free: the daemon\n * imports it in Node, the harness in Workers.\n *\n * One WebSocket per session, dialled by the object through\n * `ctx.container.getTcpPort(port)` at `/sessions/<id>`. The daemon speaks\n * first with `hello`; the object answers with `open` (when the daemon does\n * not hold the session yet) and `replay`, then delivers `prompt`s.\n *\n * Everything the daemon produces for a session is a numbered `frame`. The\n * numbers start at 1 for each session in each container, so a frame is\n * addressed by `(runtimeId, seq)`. The daemon keeps frames until they are\n * acknowledged, so an object that lost its socket (evicted, redeployed)\n * replays what it missed from its cursor. A different `runtimeId` in\n * `hello` means a different container: its numbering starts again, and\n * whatever the old container was doing is gone.\n *\n * @experimental The wire may change before it stabilizes. The object and the image are\n * a matched pair; a version mismatch is reported in `hello`.\n */\n\n/** Bumped on any incompatible change. */\nexport const CONTAINER_PROTOCOL_VERSION = 1;\n\n/** The daemon answers `200` here once it accepts connections. */\nexport const CONTAINER_HEALTH_PATH = \"/healthz\";\n\n/** The session socket: `/sessions/<encoded session id>`. */\nexport const CONTAINER_SESSION_PATH = \"/sessions/\";\n\n/** The shared secret the object passes on every request. */\nexport const CONTAINER_TOKEN_HEADER = \"x-cf-harness-token\";\n\n/** The environment variables the object starts the container with. */\nexport const CONTAINER_ENV = {\n  /** Shared secret for `CONTAINER_TOKEN_HEADER`. */\n  token: \"CF_HARNESS_TOKEN\",\n  /** This container's id. Echoed in `hello`. */\n  runtimeId: \"CF_HARNESS_RUNTIME_ID\",\n  /** The port the daemon listens on. */\n  port: \"CF_HARNESS_PORT\"\n} as const;\n\n/** WebSocket close code: a newer connection for the session replaced this one. */\nexport const CLOSE_REPLACED = 4001;\n\n/** WebSocket close code: the request was not authorized. */\nexport const CLOSE_UNAUTHORIZED = 4003;\n\n/** A JSON value on the wire. */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly JsonValue[]\n  | { readonly [key: string]: JsonValue };\n\n/** One part of a prompt. */\nexport type ContainerInputPart =\n  | { readonly type: \"text\"; readonly text: string }\n  | {\n      readonly type: \"image\";\n      /** IANA media type, such as `image/png`. */\n      readonly mediaType: string;\n      /** Base64 bytes. */\n      readonly data: string;\n    };\n\n/** What a prompt carries: plain text, or parts. */\nexport type ContainerInput = string | readonly ContainerInputPart[];\n\n/** What a submission does when the session is already running. */\nexport type ContainerWhenBusy = \"followUp\" | \"steer\";\n\n/**\n * Per-session settings the object sends the adapter. `model` is the\n * adapter's own model name; `options` is opaque to everything but the\n * adapter.\n */\nexport type ContainerSettings = {\n  readonly model?: string;\n  readonly options?: JsonValue;\n};\n\n/** One part of a transcript message. */\nexport type ContainerPart =\n  | { readonly type: \"text\"; readonly text: string }\n  | { readonly type: \"reasoning\"; readonly text: string }\n  | {\n      readonly type: \"image\";\n      readonly mediaType: string;\n      readonly data: string;\n    }\n  | {\n      readonly type: \"tool\";\n      readonly toolCallId: string;\n      readonly toolName: string;\n      readonly input: JsonValue;\n      readonly state: \"running\" | \"done\" | \"error\";\n      readonly output?: JsonValue;\n    };\n\n/**\n * A transcript message, in the one format every container adapter\n * produces. An adapter emits a message again, under the same id, to update\n * it (a tool result arriving, for example).\n */\nexport type ContainerMessage = {\n  readonly id: string;\n  readonly role: \"user\" | \"assistant\";\n  readonly parts: readonly ContainerPart[];\n  /** The operation the message belongs to. */\n  readonly operationId?: string;\n  readonly createdAt: number;\n};\n\n/** What an adapter reports while it runs. */\nexport type ContainerEvent =\n  /** Live text for an assistant message that is still being written. */\n  | {\n      readonly type: \"text-delta\";\n      readonly messageId: string;\n      readonly delta: string;\n    }\n  /** Live reasoning for an assistant message that is still being written. */\n  | {\n      readonly type: \"reasoning-delta\";\n      readonly messageId: string;\n      readonly delta: string;\n    }\n  /** A finished or updated transcript message. Stored. */\n  | { readonly type: \"message\"; readonly message: ContainerMessage }\n  /** Token and cost figures the adapter reports, as the adapter counts them. */\n  | {\n      readonly type: \"usage\";\n      readonly inputTokens?: number;\n      readonly outputTokens?: number;\n      readonly costUsd?: number;\n    }\n  /** A diagnostic line. */\n  | {\n      readonly type: \"log\";\n      readonly level: \"info\" | \"warn\" | \"error\";\n      readonly message: string;\n    }\n  /** Anything adapter-specific, passed through untouched. */\n  | { readonly type: \"raw\"; readonly value: JsonValue };\n\n/** How an operation ended, as the daemon reports it. */\nexport type ContainerOutcome =\n  | { readonly status: \"done\"; readonly text: string }\n  | { readonly status: \"unanswered\"; readonly reason: string };\n\n/** What the daemon knows about one operation it was given. */\nexport type DaemonOperation =\n  | {\n      readonly operationId: string;\n      readonly status: \"queued\" | \"running\";\n    }\n  | {\n      readonly operationId: string;\n      readonly status: \"settled\";\n      readonly outcome: ContainerOutcome;\n    };\n\n/** One numbered thing the daemon produced for a session. */\nexport type DaemonFrame =\n  | { readonly kind: \"start\"; readonly operationId: string }\n  | {\n      readonly kind: \"event\";\n      readonly operationId: string | null;\n      readonly event: ContainerEvent;\n    }\n  /**\n   * Adapter resume state to keep. The object stores these entries in order\n   * and hands all of them back in `open` on a new container.\n   */\n  | { readonly kind: \"persist\"; readonly entries: readonly JsonValue[] }\n  | {\n      readonly kind: \"settle\";\n      readonly operationId: string;\n      readonly outcome: ContainerOutcome;\n    };\n\n/** The adapter running in the container. */\nexport type AdapterInfo = {\n  readonly id: string;\n  readonly version: string;\n  readonly capabilities: readonly string[];\n};\n\n/** Daemon → object. */\nexport type DaemonMessage =\n  | {\n      readonly type: \"hello\";\n      readonly protocol: number;\n      readonly runtimeId: string;\n      readonly session: string;\n      readonly adapter: AdapterInfo;\n      /** The generation of the open adapter session, or null if none is open. */\n      readonly open: number | null;\n      /** The newest frame number for this session in this container. */\n      readonly lastSeq: number;\n      /** Every operation this container was given for the session. */\n      readonly operations: readonly DaemonOperation[];\n    }\n  | {\n      readonly type: \"frame\";\n      readonly seq: number;\n      readonly frame: DaemonFrame;\n    }\n  /** Every kept frame after the `replay` cursor has been sent. */\n  | { readonly type: \"caught-up\"; readonly lastSeq: number }\n  | { readonly type: \"error\"; readonly message: string };\n\n/**\n * Most JSON characters the object puts in one `restore` message, and the\n * daemon in one `persist` frame (a single larger entry travels alone).\n * Keeps every message well inside WebSocket message limits.\n */\nexport const MAX_CHUNK_CHARS = 256 * 1024;\n\n/** Object → daemon. */\nexport type HostMessage =\n  /**\n   * Part of the resume state for the next `open` of `generation`. Sent\n   * before that `open`, in order, so no single message grows with the\n   * session's history.\n   */\n  | {\n      readonly type: \"restore\";\n      readonly generation: number;\n      readonly entries: readonly JsonValue[];\n    }\n  /**\n   * Open the adapter session. Ignored when the same generation is already\n   * open; a different generation closes the open one first.\n   */\n  | {\n      readonly type: \"open\";\n      readonly generation: number;\n      readonly settings: ContainerSettings;\n      /**\n       * The last of the entries the adapter persisted for this session,\n       * after any sent in `restore` messages for this generation.\n       */\n      readonly restore: readonly JsonValue[];\n    }\n  /** Send every kept frame after `after`, then live frames. */\n  | { readonly type: \"replay\"; readonly after: number }\n  /** Queue an operation. Idempotent on `operationId`. */\n  | {\n      readonly type: \"prompt\";\n      readonly operationId: string;\n      readonly input: ContainerInput;\n      readonly whenBusy: ContainerWhenBusy;\n    }\n  /** Stop one operation, or every operation of the session. */\n  | { readonly type: \"abort\"; readonly operationId?: string }\n  | { readonly type: \"configure\"; readonly settings: ContainerSettings }\n  /** Frames up to `seq` are stored; the daemon may forget them. */\n  | { readonly type: \"ack\"; readonly seq: number };\n\n// ── Parsing ─────────────────────────────────────────────────────────────────\n//\n// Frames cross a process boundary, so each side parses what it receives.\n// The parsers check the envelope and the fields the receiver acts on;\n// payloads that are opaque to the receiver (events, persisted entries) are\n// passed through as JSON.\n\ntype Fields = { readonly [key: string]: unknown };\n\nfunction isFields(value: unknown): value is Fields {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\nfunction isCount(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isJson(value: unknown): value is JsonValue {\n  if (value === null) return true;\n  switch (typeof value) {\n    case \"string\":\n    case \"boolean\":\n      return true;\n    case \"number\":\n      return Number.isFinite(value);\n    case \"object\":\n      if (Array.isArray(value)) return value.every(isJson);\n      return Object.values(value).every(isJson);\n    default:\n      return false;\n  }\n}\n\nfunction isOutcome(value: unknown): value is ContainerOutcome {\n  if (!isFields(value)) return false;\n  if (value.status === \"done\") return isString(value.text);\n  return value.status === \"unanswered\" && isString(value.reason);\n}\n\nfunction isEvent(value: unknown): value is ContainerEvent {\n  if (!isFields(value) || !isString(value.type) || !isJson(value)) return false;\n  switch (value.type) {\n    case \"text-delta\":\n    case \"reasoning-delta\":\n      return isString(value.messageId) && isString(value.delta);\n    case \"message\":\n      return (\n        isFields(value.message) &&\n        isString(value.message.id) &&\n        (value.message.role === \"user\" || value.message.role === \"assistant\") &&\n        Array.isArray(value.message.parts)\n      );\n    case \"usage\":\n      return true;\n    case \"log\":\n      return isString(value.message);\n    case \"raw\":\n      return \"value\" in value;\n    default:\n      return false;\n  }\n}\n\nfunction isFrame(value: unknown): value is DaemonFrame {\n  if (!isFields(value)) return false;\n  switch (value.kind) {\n    case \"start\":\n      return isString(value.operationId);\n    case \"event\":\n      return (\n        (value.operationId === null || isString(value.operationId)) &&\n        isEvent(value.event)\n      );\n    case \"persist\":\n      return Array.isArray(value.entries) && value.entries.every(isJson);\n    case \"settle\":\n      return isString(value.operationId) && isOutcome(value.outcome);\n    default:\n      return false;\n  }\n}\n\nfunction isDaemonOperation(value: unknown): value is DaemonOperation {\n  if (!isFields(value) || !isString(value.operationId)) return false;\n  if (value.status === \"queued\" || value.status === \"running\") return true;\n  return value.status === \"settled\" && isOutcome(value.outcome);\n}\n\nfunction isInput(value: unknown): value is ContainerInput {\n  if (isString(value)) return true;\n  return (\n    Array.isArray(value) &&\n    value.every(\n      (part) =>\n        isFields(part) &&\n        ((part.type === \"text\" && isString(part.text)) ||\n          (part.type === \"image\" &&\n            isString(part.mediaType) &&\n            isString(part.data)))\n    )\n  );\n}\n\nfunction isSettings(value: unknown): value is ContainerSettings {\n  return (\n    isFields(value) &&\n    (value.model === undefined || isString(value.model)) &&\n    (value.options === undefined || isJson(value.options))\n  );\n}\n\nfunction decode(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Parse one message from the daemon.\n *\n * @param text - The raw WebSocket message.\n * @returns The message, or `undefined` when it is not one.\n */\nexport function parseDaemonMessage(text: string): DaemonMessage | undefined {\n  const value = decode(text);\n  if (!isFields(value)) return undefined;\n  switch (value.type) {\n    case \"hello\":\n      if (\n        isCount(value.protocol) &&\n        isString(value.runtimeId) &&\n        isString(value.session) &&\n        isFields(value.adapter) &&\n        isString(value.adapter.id) &&\n        isString(value.adapter.version) &&\n        Array.isArray(value.adapter.capabilities) &&\n        value.adapter.capabilities.every(isString) &&\n        (value.open === null || isCount(value.open)) &&\n        isCount(value.lastSeq) &&\n        Array.isArray(value.operations) &&\n        value.operations.every(isDaemonOperation)\n      ) {\n        // SAFETY: every field the type names was checked above.\n        return value as DaemonMessage;\n      }\n      return undefined;\n    case \"frame\":\n      // SAFETY: seq and frame were checked; the type is exactly these fields.\n      return isCount(value.seq) && isFrame(value.frame)\n        ? (value as DaemonMessage)\n        : undefined;\n    case \"caught-up\":\n      return isCount(value.lastSeq)\n        ? { type: \"caught-up\", lastSeq: value.lastSeq }\n        : undefined;\n    case \"error\":\n      return isString(value.message)\n        ? { type: \"error\", message: value.message }\n        : undefined;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Parse one message from the object.\n *\n * @param text - The raw WebSocket message.\n * @returns The message, or `undefined` when it is not one.\n */\nexport function parseHostMessage(text: string): HostMessage | undefined {\n  const value = decode(text);\n  if (!isFields(value)) return undefined;\n  switch (value.type) {\n    case \"restore\":\n      return isCount(value.generation) &&\n        Array.isArray(value.entries) &&\n        value.entries.every(isJson)\n        ? {\n            type: \"restore\",\n            generation: value.generation,\n            entries: value.entries\n          }\n        : undefined;\n    case \"open\":\n      return isCount(value.generation) &&\n        isSettings(value.settings) &&\n        Array.isArray(value.restore) &&\n        value.restore.every(isJson)\n        ? {\n            type: \"open\",\n            generation: value.generation,\n            settings: value.settings,\n            restore: value.restore\n          }\n        : undefined;\n    case \"replay\":\n      return isCount(value.after)\n        ? { type: \"replay\", after: value.after }\n        : undefined;\n    case \"prompt\":\n      return isString(value.operationId) &&\n        isInput(value.input) &&\n        (value.whenBusy === \"followUp\" || value.whenBusy === \"steer\")\n        ? {\n            type: \"prompt\",\n            operationId: value.operationId,\n            input: value.input,\n            whenBusy: value.whenBusy\n          }\n        : undefined;\n    case \"abort\":\n      if (value.operationId === undefined) return { type: \"abort\" };\n      return isString(value.operationId)\n        ? { type: \"abort\", operationId: value.operationId }\n        : undefined;\n    case \"configure\":\n      return isSettings(value.settings)\n        ? { type: \"configure\", settings: value.settings }\n        : undefined;\n    case \"ack\":\n      return isCount(value.seq) ? { type: \"ack\", seq: value.seq } : undefined;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * The text of an input, with image parts left out.\n *\n * @param input - A prompt's input.\n * @returns Its text.\n */\nexport function inputText(input: ContainerInput): string {\n  if (typeof input === \"string\") return input;\n  return input\n    .map((part) => (part.type === \"text\" ? part.text : \"\"))\n    .join(\"\\n\");\n}\n\n/**\n * Split entries into groups whose JSON stays under `MAX_CHUNK_CHARS`. An\n * entry larger than that is a group of its own.\n *\n * @param entries - The entries, in order.\n * @returns The groups, in order. Empty for no entries.\n */\nexport function chunkEntries(entries: readonly JsonValue[]): JsonValue[][] {\n  const groups: JsonValue[][] = [];\n  let group: JsonValue[] = [];\n  let size = 0;\n  for (const entry of entries) {\n    const length = JSON.stringify(entry).length;\n    if (group.length > 0 && size + length > MAX_CHUNK_CHARS) {\n      groups.push(group);\n      group = [];\n      size = 0;\n    }\n    group.push(entry);\n    size += length;\n  }\n  if (group.length > 0) groups.push(group);\n  return groups;\n}\n"],"mappings":"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"}