agents 0.26.0 → 0.27.0

package/dist/{protocol-kHsr-f0X.js → protocol-eXeJxhgu.js}

@@ -138,71 +138,6 @@ var StreamAccumulator = class {
 	}
 };
 //#endregion
-//#region src/chat/broadcast-state.ts
-function textOf(parts) {
-	let text = "";
-	for (const part of parts) if (part.type === "text") text += part.text;
-	return text;
-}
-/**
-* Whether `messages` already holds a copy of the observed message whose text
-* the accumulator does not extend. A healthy live accumulator is always the
-* stored copy plus more; one that diverges holds interleaved or duplicated
-* chunks (#2166), so the stored copy must win or the corruption never heals.
-*/
-function observedDivergesFrom(accumulator, messages) {
-	const existing = messages.find((m) => m.id === accumulator.messageId);
-	if (!existing) return false;
-	return !textOf(accumulator.parts).startsWith(textOf(existing.parts));
-}
-function transition(state, event) {
-	switch (event.type) {
-		case "clear": return {
-			state: { status: "idle" },
-			isStreaming: false
-		};
-		case "resume-fallback": {
-			const accumulator = new StreamAccumulator({ messageId: event.messageId });
-			return {
-				state: {
-					status: "observing",
-					streamId: event.streamId,
-					accumulator
-				},
-				isStreaming: true
-			};
-		}
-		case "response": {
-			let accumulator;
-			const isReplayedStart = event.replay === true && event.chunkData?.type === "start";
-			if (state.status === "idle" || state.streamId !== event.streamId || isReplayedStart) accumulator = new StreamAccumulator({
-				messageId: event.messageId,
-				continuation: event.continuation
-			});
-			else accumulator = state.accumulator;
-			if (event.chunkData) accumulator.applyChunk(event.chunkData);
-			let messagesUpdate;
-			const mergeUnlessDiverged = (prev) => observedDivergesFrom(accumulator, prev) ? prev : accumulator.mergeInto(prev);
-			if (event.done) return {
-				state: { status: "idle" },
-				messagesUpdate: mergeUnlessDiverged,
-				isStreaming: false
-			};
-			if (event.chunkData && !event.replay) messagesUpdate = mergeUnlessDiverged;
-			else if (event.replayComplete) messagesUpdate = (prev) => accumulator.mergeInto(prev);
-			return {
-				state: {
-					status: "observing",
-					streamId: event.streamId,
-					accumulator
-				},
-				messagesUpdate,
-				isStreaming: true
-			};
-		}
-	}
-}
-//#endregion
 //#region src/chat/protocol.ts
 /**
 * Wire protocol message type constants for the cf_agent_chat_* protocol.
@@ -234,6 +169,6 @@ const CHAT_MESSAGE_TYPES = {
 	CHAT_RECOVERING: "cf_agent_chat_recovering"
 };
 //#endregion
-export { StreamAccumulator as a, transition as i, STREAM_RESUME_NONE_REASONS as n, observedDivergesFrom as r, CHAT_MESSAGE_TYPES as t };
+export { STREAM_RESUME_NONE_REASONS as n, StreamAccumulator as r, CHAT_MESSAGE_TYPES as t };
 
-//# sourceMappingURL=protocol-kHsr-f0X.js.map
+//# sourceMappingURL=protocol-eXeJxhgu.js.map

package/dist/protocol-eXeJxhgu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-eXeJxhgu.js","names":[],"sources":["../src/chat/stream-accumulator.ts","../src/chat/protocol.ts"],"sourcesContent":["/**\n * StreamAccumulator — unified chunk-to-message builder.\n *\n * Used by @cloudflare/ai-chat (server + client) and @cloudflare/think\n * to incrementally build a UIMessage from stream chunks. Wraps\n * applyChunkToParts and handles the metadata chunk types (start, finish,\n * message-metadata, error) that applyChunkToParts does not cover.\n *\n * The accumulator signals domain-specific concerns (early persistence,\n * cross-message tool updates) via ChunkAction returns — callers handle\n * these according to their context.\n */\n\nimport type { UIMessage } from \"ai\";\nimport { applyChunkToParts, type StreamChunkData } from \"./message-builder\";\n\nfunction asMetadata(value: unknown): Record<string, unknown> | undefined {\n  if (value != null && typeof value === \"object\" && !Array.isArray(value)) {\n    return value as Record<string, unknown>;\n  }\n  return undefined;\n}\n\nexport interface StreamAccumulatorOptions {\n  messageId: string;\n  /** Whether chunks continue the current assistant message when merged. */\n  continuation?: boolean;\n  /** Eager seed; omitted continuations seed from the messages passed to `mergeInto`. */\n  existingParts?: UIMessage[\"parts\"];\n  existingMetadata?: Record<string, unknown>;\n}\n\nexport type ChunkAction =\n  | {\n      type: \"start\";\n      messageId?: string;\n      metadata?: Record<string, unknown>;\n    }\n  | {\n      type: \"finish\";\n      finishReason?: string;\n      metadata?: Record<string, unknown>;\n    }\n  | { type: \"message-metadata\"; metadata: Record<string, unknown> }\n  | { type: \"tool-approval-request\"; toolCallId: string }\n  | {\n      type: \"cross-message-tool-update\";\n      updateType: \"output-available\" | \"output-error\";\n      toolCallId: string;\n      output?: unknown;\n      errorText?: string;\n      preliminary?: boolean;\n    }\n  | { type: \"error\"; error: string };\n\nexport interface ChunkResult {\n  handled: boolean;\n  action?: ChunkAction;\n}\n\nexport class StreamAccumulator {\n  messageId: string;\n  readonly parts: UIMessage[\"parts\"];\n  metadata?: Record<string, unknown>;\n  private _isContinuation: boolean;\n  // Continuation chunks wait here until mergeInto can seed from current state.\n  private _pendingContinuationChunks: StreamChunkData[] | null;\n\n  constructor(options: StreamAccumulatorOptions) {\n    this.messageId = options.messageId;\n    this._isContinuation = options.continuation ?? false;\n    this.parts = options.existingParts ? [...options.existingParts] : [];\n    this.metadata = options.existingMetadata\n      ? { ...options.existingMetadata }\n      : undefined;\n    this._pendingContinuationChunks =\n      this._isContinuation &&\n      options.existingParts === undefined &&\n      options.existingMetadata === undefined\n        ? []\n        : null;\n  }\n\n  applyChunk(chunk: StreamChunkData): ChunkResult {\n    this._pendingContinuationChunks?.push(chunk);\n    const handled = applyChunkToParts(this.parts, chunk);\n\n    // Detect tool-approval-request for early persistence signaling\n    if (chunk.type === \"tool-approval-request\" && chunk.toolCallId) {\n      return {\n        handled,\n        action: { type: \"tool-approval-request\", toolCallId: chunk.toolCallId }\n      };\n    }\n\n    // Detect cross-message tool output/error: applyChunkToParts returns true\n    // for recognized types but silently does nothing when the toolCallId\n    // doesn't exist in the current parts array.\n    if (\n      (chunk.type === \"tool-output-available\" ||\n        chunk.type === \"tool-output-error\") &&\n      chunk.toolCallId\n    ) {\n      const foundInParts = this.parts.some(\n        (p) => \"toolCallId\" in p && p.toolCallId === chunk.toolCallId\n      );\n      if (!foundInParts) {\n        return {\n          handled,\n          action: {\n            type: \"cross-message-tool-update\",\n            updateType:\n              chunk.type === \"tool-output-available\"\n                ? \"output-available\"\n                : \"output-error\",\n            toolCallId: chunk.toolCallId,\n            output: chunk.output,\n            errorText: chunk.errorText,\n            preliminary: chunk.preliminary\n          }\n        };\n      }\n    }\n\n    if (!handled) {\n      switch (chunk.type) {\n        case \"start\": {\n          if (chunk.messageId != null && !this._isContinuation) {\n            this.messageId = chunk.messageId;\n          }\n          const startMeta = asMetadata(chunk.messageMetadata);\n          if (startMeta) {\n            this.metadata = this.metadata\n              ? { ...this.metadata, ...startMeta }\n              : { ...startMeta };\n          }\n          return {\n            handled: true,\n            action: {\n              type: \"start\",\n              messageId: chunk.messageId,\n              metadata: startMeta\n            }\n          };\n        }\n        case \"finish\": {\n          const finishMeta = asMetadata(chunk.messageMetadata);\n          if (finishMeta) {\n            this.metadata = this.metadata\n              ? { ...this.metadata, ...finishMeta }\n              : { ...finishMeta };\n          }\n          const finishReason =\n            \"finishReason\" in chunk\n              ? (chunk.finishReason as string)\n              : undefined;\n          return {\n            handled: true,\n            action: {\n              type: \"finish\",\n              finishReason,\n              metadata: finishMeta\n            }\n          };\n        }\n        case \"message-metadata\": {\n          const msgMeta = asMetadata(chunk.messageMetadata);\n          if (msgMeta) {\n            this.metadata = this.metadata\n              ? { ...this.metadata, ...msgMeta }\n              : { ...msgMeta };\n          }\n          return {\n            handled: true,\n            action: {\n              type: \"message-metadata\",\n              metadata: msgMeta ?? {}\n            }\n          };\n        }\n        case \"finish-step\": {\n          return { handled: true };\n        }\n        case \"error\": {\n          return {\n            handled: true,\n            action: {\n              type: \"error\",\n              error: chunk.errorText ?? JSON.stringify(chunk)\n            }\n          };\n        }\n      }\n    }\n\n    return { handled };\n  }\n\n  /** Snapshot the current state as a UIMessage. */\n  toMessage(): UIMessage {\n    return {\n      id: this.messageId,\n      role: \"assistant\",\n      parts: [...this.parts],\n      ...(this.metadata != null && { metadata: this.metadata })\n    } as UIMessage;\n  }\n\n  /**\n   * Merge this accumulator's message into an existing message array.\n   * Handles continuation (walk backward for last assistant), replacement\n   * (update existing by messageId), or append (new message). An unseeded\n   * continuation adopts current parts here before applying its queued chunks.\n   */\n  mergeInto(messages: UIMessage[]): UIMessage[] {\n    let existingIdx = messages.findIndex((m) => m.id === this.messageId);\n\n    if (existingIdx < 0 && this._isContinuation) {\n      for (let i = messages.length - 1; i >= 0; i--) {\n        if (messages[i].role === \"assistant\") {\n          existingIdx = i;\n          break;\n        }\n      }\n    }\n\n    if (this._pendingContinuationChunks !== null) {\n      const pendingChunks = this._pendingContinuationChunks;\n      this._pendingContinuationChunks = null;\n      this.parts.splice(\n        0,\n        this.parts.length,\n        ...(existingIdx >= 0 ? messages[existingIdx].parts : [])\n      );\n      const currentMetadata =\n        existingIdx >= 0\n          ? asMetadata(messages[existingIdx].metadata)\n          : undefined;\n      this.metadata = currentMetadata ? { ...currentMetadata } : undefined;\n      if (existingIdx >= 0) {\n        this.messageId = messages[existingIdx].id;\n      }\n      for (const chunk of pendingChunks) {\n        this.applyChunk(chunk);\n      }\n    }\n\n    const messageId =\n      existingIdx >= 0 ? messages[existingIdx].id : this.messageId;\n\n    const partialMessage: UIMessage = {\n      id: messageId,\n      role: \"assistant\",\n      parts: [...this.parts],\n      ...(this.metadata != null && { metadata: this.metadata })\n    } as UIMessage;\n\n    if (existingIdx >= 0) {\n      const updated = [...messages];\n      updated[existingIdx] = partialMessage;\n      return updated;\n    }\n    return [...messages, partialMessage];\n  }\n}\n","/**\n * Wire protocol message type constants for the cf_agent_chat_* protocol.\n *\n * These are the string values used on the wire between agent servers and\n * clients. Both @cloudflare/ai-chat (via its MessageType enum) and\n * @cloudflare/think use these values.\n */\nexport const STREAM_RESUME_NONE_REASONS = {\n  /** No active, pending, or terminal stream exists for this agent. */\n  IDLE: \"idle\",\n  /** An active tool continuation is owned by another live connection. */\n  CONTINUATION_OWNED: \"continuation-owned\"\n} as const;\n\nexport type StreamResumeNoneReason =\n  (typeof STREAM_RESUME_NONE_REASONS)[keyof typeof STREAM_RESUME_NONE_REASONS];\n\nexport const CHAT_MESSAGE_TYPES = {\n  CHAT_MESSAGES: \"cf_agent_chat_messages\",\n  USE_CHAT_REQUEST: \"cf_agent_use_chat_request\",\n  USE_CHAT_RESPONSE: \"cf_agent_use_chat_response\",\n  CHAT_CLEAR: \"cf_agent_chat_clear\",\n  CHAT_REQUEST_CANCEL: \"cf_agent_chat_request_cancel\",\n  STREAM_RESUMING: \"cf_agent_stream_resuming\",\n  STREAM_RESUME_ACK: \"cf_agent_stream_resume_ack\",\n  STREAM_RESUME_REQUEST: \"cf_agent_stream_resume_request\",\n  STREAM_RESUME_NONE: \"cf_agent_stream_resume_none\",\n  // Server→client: a turn has been accepted but its resumable stream has not\n  // started yet (queued, debouncing, waiting on MCP setup, or running async\n  // work in `onChatMessage`). Sent in response to a resume request (or on\n  // connect) so a reconnecting/re-mounting client keeps its expectation instead\n  // of resolving its resume probe to \"no stream\" and then false-timing-out the\n  // turn. Resolved by a later `STREAM_RESUMING` (stream started) or\n  // `STREAM_RESUME_NONE` (turn settled without streaming). Backward-compatible —\n  // clients that don't understand it ignore it. See issue #1784.\n  STREAM_PENDING: \"cf_agent_stream_pending\",\n  TOOL_RESULT: \"cf_agent_tool_result\",\n  TOOL_APPROVAL: \"cf_agent_tool_approval\",\n  MESSAGE_UPDATED: \"cf_agent_message_updated\",\n  // Server→client: a durable chat turn is being recovered (interrupted by a\n  // deploy/eviction or a stream-stall watchdog abort and now resuming). Sent\n  // when a recovery continuation is scheduled and cleared on every terminal\n  // outcome; `@cloudflare/think` also replays it on connect so a client that\n  // joins mid-recovery learns it. Purely a progress hint — backward-compatible\n  // (clients that don't understand it ignore it). See issue #1620.\n  CHAT_RECOVERING: \"cf_agent_chat_recovering\"\n} as const;\n"],"mappings":"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"}

package/dist/protocol-y2sSY584.js

@@ -0,0 +1,148 @@
+//#region src/experimental/channels/web/protocol.ts
+/**
+* The header carrying a connection's WebIdentity from the gateway to the
+* agent. The gateway always sets it, so a client cannot supply its own; an
+* agent must not take WebSocket upgrades from any other route.
+*/
+const WEB_IDENTITY_HEADER = "x-channels-identity";
+/**
+* Parse a text frame. Returns undefined for anything that is not a Channels
+* frame, so the socket's other protocols keep working.
+*/
+function parseClientFrame(text) {
+	let frame;
+	try {
+		frame = JSON.parse(text);
+	} catch {
+		return;
+	}
+	if (!isObject(frame) || typeof frame.type !== "string") return void 0;
+	if (frame.type === "channels:subscribe") {
+		const { responseId, from } = frame;
+		if (typeof responseId !== "string") return { invalid: "responseId" };
+		if (from !== void 0 && !Number.isInteger(from)) return { invalid: "from" };
+		return {
+			type: "channels:subscribe",
+			responseId,
+			...typeof from === "number" && { from }
+		};
+	}
+	if (frame.type === "channels:list-conversations") return isId(frame.requestId) ? {
+		type: "channels:list-conversations",
+		requestId: frame.requestId
+	} : { invalid: "requestId" };
+	if (frame.type !== "channels:event") return void 0;
+	const event = frame.event;
+	const eventId = isObject(event) ? event.eventId : void 0;
+	if (!isObject(event) || !isId(eventId)) return { invalid: "eventId" };
+	const parsed = parseEvent(event, eventId);
+	return typeof parsed === "string" ? {
+		invalid: parsed,
+		eventId
+	} : {
+		type: "channels:event",
+		event: parsed
+	};
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isId(value) {
+	return typeof value === "string" && value.length > 0;
+}
+/** The event, or the name of the first invalid field. */
+function parseEvent(event, eventId) {
+	switch (event.type) {
+		case "message": {
+			const message = event.message;
+			if (!isObject(message) || !isId(message.id)) return "message.id";
+			if (message.role !== "user") return "message.role";
+			const parts = message.parts;
+			if (!Array.isArray(parts) || !parts.every(isPart)) return "message.parts";
+			return {
+				type: "message",
+				eventId,
+				message: {
+					id: message.id,
+					role: "user",
+					parts,
+					...isObject(message.metadata) && { metadata: message.metadata }
+				},
+				...clientTools(event.clientTools)
+			};
+		}
+		case "tool-result": {
+			const { turnId, toolCallId, result } = event;
+			if (!isId(turnId)) return "turnId";
+			if (!isId(toolCallId)) return "toolCallId";
+			if (!isObject(result) || typeof result.ok !== "boolean") return "result";
+			return {
+				type: "tool-result",
+				eventId,
+				turnId,
+				toolCallId,
+				result: result.ok ? {
+					ok: true,
+					output: result.output ?? null
+				} : {
+					ok: false,
+					...typeof result.errorText === "string" && { errorText: result.errorText }
+				},
+				...clientTools(event.clientTools)
+			};
+		}
+		case "approval-response": {
+			const { turnId, approvalId, approved, reason } = event;
+			if (!isId(turnId)) return "turnId";
+			if (!isId(approvalId)) return "approvalId";
+			if (typeof approved !== "boolean") return "approved";
+			return {
+				type: "approval-response",
+				eventId,
+				turnId,
+				approvalId,
+				approved,
+				...typeof reason === "string" && { reason }
+			};
+		}
+		case "cancel": return isId(event.turnId) ? {
+			type: "cancel",
+			eventId,
+			turnId: event.turnId
+		} : "turnId";
+		case "conversation-create":
+		case "conversation-fork": return {
+			type: event.type,
+			eventId
+		};
+		case "conversation-reset":
+			if (event.handoff !== void 0 && typeof event.handoff !== "string") return "handoff";
+			return {
+				type: "conversation-reset",
+				eventId,
+				...event.handoff && { handoff: event.handoff }
+			};
+		default: return "type";
+	}
+}
+function isPart(part) {
+	return isObject(part) && typeof part.type === "string";
+}
+/** Keeps tools with a name, dropping a schema that is not an object. */
+function clientTools(value) {
+	if (!Array.isArray(value)) return {};
+	const tools = [];
+	for (const tool of value) {
+		if (!isObject(tool) || !isId(tool.name)) continue;
+		tools.push({
+			name: tool.name,
+			...typeof tool.description === "string" && { description: tool.description },
+			...isObject(tool.inputSchema) && { inputSchema: tool.inputSchema }
+		});
+	}
+	return { clientTools: tools };
+}
+//#endregion
+export { parseClientFrame as n, WEB_IDENTITY_HEADER as t };
+
+//# sourceMappingURL=protocol-y2sSY584.js.map

package/dist/protocol-y2sSY584.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-y2sSY584.js","names":[],"sources":["../src/experimental/channels/web/protocol.ts"],"sourcesContent":["import type {\n  ClientTool,\n  ConversationInfo,\n  ConversationOperation,\n  ConversationSnapshot,\n  InboundEvent,\n  Json,\n  JsonObject,\n  Participant,\n  ResponseChunk,\n  TranscriptMessage,\n  TurnStatus\n} from \"../protocol\";\n\n/** Who a connection is: set by the gateway, read by the Web Channel. */\nexport type WebIdentity = {\n  /** The route that picked the agent. */\n  route: string;\n  /** The conversation to follow. Default: the agent's default for the route. */\n  conversationId?: string;\n  participant: Participant;\n};\n\n/**\n * The header carrying a connection's WebIdentity from the gateway to the\n * agent. The gateway always sets it, so a client cannot supply its own; an\n * agent must not take WebSocket upgrades from any other route.\n */\nexport const WEB_IDENTITY_HEADER = \"x-channels-identity\";\n\n// Frames between Channels and a connected client. Each connection follows\n// one conversation at a time, and every server frame names it, so a client\n// can drop frames for a conversation it no longer follows. Payloads are the\n// shared protocol types, unchanged.\n\nexport type ClientFrame =\n  | { type: \"channels:event\"; event: InboundEvent }\n  | { type: \"channels:subscribe\"; responseId: string; from?: number }\n  /** Ask for the agent's conversations; answered by `channels:conversations`. */\n  | { type: \"channels:list-conversations\"; requestId: string };\n\nexport type ServerFrame = { conversationId: string } &\n  /**\n   * On connect, after a reset (empty), and when the connection follows\n   * another conversation. `you` is this connection's participant;\n   * `operations` are the conversation operations it may send.\n   */\n  (\n    | ({\n        type: \"channels:snapshot\";\n        you: Participant;\n        operations: ConversationOperation[];\n      } & ConversationSnapshot)\n    | { type: \"channels:turn\"; turn: TurnStatus }\n    /** Upserts by id; an unknown id appends. */\n    | { type: \"channels:messages\"; messages: TranscriptMessage[] }\n    | {\n        type: \"channels:chunks\";\n        responseId: string;\n        /** Seq of the first chunk. */\n        from: number;\n        chunks: ResponseChunk[];\n      }\n    /** Everything before this was replay; what follows is live. */\n    | { type: \"channels:caught-up\"; responseId: string; cursor: number }\n    | {\n        type: \"channels:end\";\n        responseId: string;\n        state: \"ended\" | \"interrupted\" | \"not-found\";\n      }\n    /**\n     * The agent's conversations: the answer to a list request, carrying its\n     * `requestId`, or pushed when one is created or forked.\n     */\n    | {\n        type: \"channels:conversations\";\n        requestId?: string;\n        conversations?: ConversationInfo[];\n        error?: string;\n      }\n    /** `conversationId` is the one a create or fork started, when it did. */\n    | { type: \"channels:ack\"; eventId: string; error?: string }\n  );\n\n/** A frame that names a Channels type but is malformed. */\nexport type InvalidClientFrame = { invalid: string; eventId?: string };\n\n/**\n * Parse a text frame. Returns undefined for anything that is not a Channels\n * frame, so the socket's other protocols keep working.\n */\nexport function parseClientFrame(\n  text: string\n): ClientFrame | InvalidClientFrame | undefined {\n  let frame: unknown;\n  try {\n    frame = JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n  if (!isObject(frame) || typeof frame.type !== \"string\") return undefined;\n  if (frame.type === \"channels:subscribe\") {\n    const { responseId, from } = frame;\n    if (typeof responseId !== \"string\") return { invalid: \"responseId\" };\n    if (from !== undefined && !Number.isInteger(from)) {\n      return { invalid: \"from\" };\n    }\n    return {\n      type: \"channels:subscribe\",\n      responseId,\n      ...(typeof from === \"number\" && { from })\n    };\n  }\n  if (frame.type === \"channels:list-conversations\") {\n    return isId(frame.requestId)\n      ? { type: \"channels:list-conversations\", requestId: frame.requestId }\n      : { invalid: \"requestId\" };\n  }\n  if (frame.type !== \"channels:event\") return undefined;\n  const event = frame.event;\n  const eventId = isObject(event) ? event.eventId : undefined;\n  if (!isObject(event) || !isId(eventId)) return { invalid: \"eventId\" };\n  const parsed = parseEvent(event, eventId);\n  return typeof parsed === \"string\"\n    ? { invalid: parsed, eventId }\n    : { type: \"channels:event\", event: parsed };\n}\n\ntype JsonRecord = { readonly [key: string]: Json | undefined };\n\n// Parsed JSON is JSON, so narrowing to an object is enough to read it.\nfunction isObject(value: unknown): value is JsonRecord {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isId(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\n/** The event, or the name of the first invalid field. */\nfunction parseEvent(event: JsonRecord, eventId: string): InboundEvent | string {\n  switch (event.type) {\n    case \"message\": {\n      const message = event.message;\n      if (!isObject(message) || !isId(message.id)) return \"message.id\";\n      if (message.role !== \"user\") return \"message.role\";\n      const parts = message.parts;\n      if (!Array.isArray(parts) || !parts.every(isPart)) return \"message.parts\";\n      return {\n        type: \"message\",\n        eventId,\n        message: {\n          id: message.id,\n          role: \"user\",\n          // SAFETY: each part is an object with a string type; the agent\n          // decides which part types it accepts.\n          parts: parts as unknown as TranscriptMessage[\"parts\"],\n          ...(isObject(message.metadata) && {\n            metadata: message.metadata as JsonObject\n          })\n        },\n        ...clientTools(event.clientTools)\n      };\n    }\n    case \"tool-result\": {\n      const { turnId, toolCallId, result } = event;\n      if (!isId(turnId)) return \"turnId\";\n      if (!isId(toolCallId)) return \"toolCallId\";\n      if (!isObject(result) || typeof result.ok !== \"boolean\") return \"result\";\n      return {\n        type: \"tool-result\",\n        eventId,\n        turnId,\n        toolCallId,\n        result: result.ok\n          ? { ok: true, output: result.output ?? null }\n          : {\n              ok: false,\n              ...(typeof result.errorText === \"string\" && {\n                errorText: result.errorText\n              })\n            },\n        ...clientTools(event.clientTools)\n      };\n    }\n    case \"approval-response\": {\n      const { turnId, approvalId, approved, reason } = event;\n      if (!isId(turnId)) return \"turnId\";\n      if (!isId(approvalId)) return \"approvalId\";\n      if (typeof approved !== \"boolean\") return \"approved\";\n      return {\n        type: \"approval-response\",\n        eventId,\n        turnId,\n        approvalId,\n        approved,\n        ...(typeof reason === \"string\" && { reason })\n      };\n    }\n    case \"cancel\":\n      return isId(event.turnId)\n        ? { type: \"cancel\", eventId, turnId: event.turnId }\n        : \"turnId\";\n    case \"conversation-create\":\n    case \"conversation-fork\":\n      return { type: event.type, eventId };\n    case \"conversation-reset\":\n      if (event.handoff !== undefined && typeof event.handoff !== \"string\") {\n        return \"handoff\";\n      }\n      return {\n        type: \"conversation-reset\",\n        eventId,\n        ...(event.handoff && { handoff: event.handoff })\n      };\n    default:\n      return \"type\";\n  }\n}\n\nfunction isPart(part: Json): boolean {\n  return isObject(part) && typeof part.type === \"string\";\n}\n\n/** Keeps tools with a name, dropping a schema that is not an object. */\nfunction clientTools(value: Json | undefined): { clientTools?: ClientTool[] } {\n  if (!Array.isArray(value)) return {};\n  const tools: ClientTool[] = [];\n  for (const tool of value) {\n    if (!isObject(tool) || !isId(tool.name)) continue;\n    tools.push({\n      name: tool.name,\n      ...(typeof tool.description === \"string\" && {\n        description: tool.description\n      }),\n      ...(isObject(tool.inputSchema) && {\n        inputSchema: tool.inputSchema as JsonObject\n      })\n    });\n  }\n  return { clientTools: tools };\n}\n"],"mappings":"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"}

package/dist/queue/index.d.ts

@@ -3,7 +3,7 @@ import {
   d as LifecycleRouteContext,
   s as LifecycleCapability,
   v as LifecycleJobOutcome
-} from "../capability-runner-DBAnGr6L.js";
+} from "../capability-runner-O5VbQzqg.js";
 import { t as RetryOptions } from "../retries-CV6AkXmQ.js";
 import {
   a as QueuePayload,

package/dist/react.d.ts

@@ -2,7 +2,7 @@ import {
   C as MCPServersState,
   J as AgentToolRunPart,
   Y as AgentToolRunState
-} from "./agent-routing-0DR0Tk2v.js";
+} from "./agent-routing-Bhdbvf7s.js";
 import { ClientParameters } from "./serializable.js";
 import { t as AgentTransport } from "./transport-protocol-ZTew5Wso.js";
 import {
@@ -15,7 +15,7 @@ import {
   p as RequiredAgentMethods,
   s as AgentStub,
   v as createStubProxy
-} from "./client-je3koD9Z.js";
+} from "./client-DS3Dz9l0.js";
 import { PartySocket } from "partysocket";
 import { usePartySocket } from "partysocket/react";
 

package/dist/routing/index.d.ts

@@ -2,7 +2,7 @@ import {
   r as CapabilityWebSocketUpgradeContext,
   s as LifecycleCapability,
   t as CapabilityRequestContext
-} from "../capability-runner-DBAnGr6L.js";
+} from "../capability-runner-O5VbQzqg.js";
 import {
   a as routeAgentRequest,
   c as Agent,
@@ -10,7 +10,7 @@ import {
   n as AgentOptions,
   r as RoutingRetryOptions,
   t as AgentGetOptions
-} from "../agent-routing-0DR0Tk2v.js";
+} from "../agent-routing-Bhdbvf7s.js";
 
 //#region src/routing/routed-agents.d.ts
 /** A public entry in an {@link RoutedAgents}. */

package/dist/{scheduler-RdACNXDP.d.ts → scheduler-CrFCnv_J.d.ts}

@@ -3,7 +3,7 @@ import {
   d as LifecycleRouteContext,
   s as LifecycleCapability,
   v as LifecycleJobOutcome
-} from "./capability-runner-DBAnGr6L.js";
+} from "./capability-runner-O5VbQzqg.js";
 import { t as RetryOptions } from "./retries-CV6AkXmQ.js";
 
 //#region src/schedules/types.d.ts
@@ -220,4 +220,4 @@ export {
   SchedulerCallbacks as s,
   Scheduler as t
 };
-//# sourceMappingURL=scheduler-RdACNXDP.d.ts.map
+//# sourceMappingURL=scheduler-CrFCnv_J.d.ts.map

package/dist/schedules/index.d.ts

@@ -8,7 +8,7 @@ import {
   r as SchedulerOptions,
   s as SchedulerCallbacks,
   t as Scheduler
-} from "../scheduler-RdACNXDP.js";
+} from "../scheduler-CrFCnv_J.js";
 export {
   type Schedule,
   type ScheduleCriteria,

package/dist/serializable.d.ts

@@ -1,4 +1,4 @@
-import { k as StreamingResponse } from "./agent-routing-0DR0Tk2v.js";
+import { k as StreamingResponse } from "./agent-routing-Bhdbvf7s.js";
 
 //#region src/serializable.d.ts
 type SerializablePrimitive = undefined | null | string | number | boolean;