agents 0.11.8 → 0.12.0

package/dist/agent-tool-types.d.ts

@@ -0,0 +1,34 @@
+import {
+  a as AgentToolEventState,
+  c as AgentToolRunInspection,
+  d as AgentToolStoredChunk,
+  f as AgentToolTerminalStatus,
+  h as RunAgentToolResult,
+  i as AgentToolEventMessage,
+  l as AgentToolRunState,
+  m as RunAgentToolOptions,
+  n as AgentToolDisplayMetadata,
+  o as AgentToolLifecycleResult,
+  p as ChatCapableAgentClass,
+  r as AgentToolEvent,
+  s as AgentToolRunInfo,
+  t as AgentToolChildAdapter,
+  u as AgentToolRunStatus
+} from "./agent-tool-types-tBGRsPm0.js";
+export {
+  AgentToolChildAdapter,
+  AgentToolDisplayMetadata,
+  AgentToolEvent,
+  AgentToolEventMessage,
+  AgentToolEventState,
+  AgentToolLifecycleResult,
+  AgentToolRunInfo,
+  AgentToolRunInspection,
+  AgentToolRunState,
+  AgentToolRunStatus,
+  AgentToolStoredChunk,
+  AgentToolTerminalStatus,
+  ChatCapableAgentClass,
+  RunAgentToolOptions,
+  RunAgentToolResult
+};

package/dist/agent-tool-types.js

@@ -0,0 +1 @@
+export {};

package/dist/agent-tools-BAdX1vdI.js

@@ -0,0 +1,425 @@
+//#region src/chat/message-builder.ts
+/**
+* Applies a stream chunk to a mutable parts array, building up the message
+* incrementally. Returns true if the chunk was handled, false if it was
+* an unrecognized type (caller may handle it with additional logic).
+*
+* Handles all common chunk types that both server and client need:
+* - text-start / text-delta / text-end
+* - reasoning-start / reasoning-delta / reasoning-end
+* - file
+* - source-url / source-document
+* - tool-input-start / tool-input-delta / tool-input-available / tool-input-error
+* - tool-output-available / tool-output-error
+* - step-start (aliased from start-step)
+* - data-* (developer-defined typed JSON blobs)
+*
+* @param parts - The mutable parts array to update
+* @param chunk - The parsed stream chunk data
+* @returns true if handled, false if the chunk type is not recognized
+*/
+function applyChunkToParts(parts, chunk) {
+	switch (chunk.type) {
+		case "text-start":
+			parts.push({
+				type: "text",
+				text: "",
+				state: "streaming"
+			});
+			return true;
+		case "text-delta": {
+			const lastTextPart = findLastPartByType(parts, "text");
+			if (lastTextPart && lastTextPart.type === "text") lastTextPart.text += chunk.delta ?? "";
+			else parts.push({
+				type: "text",
+				text: chunk.delta ?? "",
+				state: "streaming"
+			});
+			return true;
+		}
+		case "text-end": {
+			const lastTextPart = findLastPartByType(parts, "text");
+			if (lastTextPart && "state" in lastTextPart) lastTextPart.state = "done";
+			return true;
+		}
+		case "reasoning-start":
+			parts.push({
+				type: "reasoning",
+				text: "",
+				state: "streaming"
+			});
+			return true;
+		case "reasoning-delta": {
+			const lastReasoningPart = findLastPartByType(parts, "reasoning");
+			if (lastReasoningPart && lastReasoningPart.type === "reasoning") {
+				lastReasoningPart.text += chunk.delta ?? "";
+				mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);
+			} else parts.push({
+				type: "reasoning",
+				text: chunk.delta ?? "",
+				state: "streaming",
+				...chunk.providerMetadata != null ? { providerMetadata: chunk.providerMetadata } : {}
+			});
+			return true;
+		}
+		case "reasoning-end": {
+			const lastReasoningPart = findLastPartByType(parts, "reasoning");
+			if (lastReasoningPart && "state" in lastReasoningPart) {
+				lastReasoningPart.state = "done";
+				mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);
+			}
+			return true;
+		}
+		case "file":
+			parts.push({
+				type: "file",
+				mediaType: chunk.mediaType,
+				url: chunk.url
+			});
+			return true;
+		case "source-url":
+			parts.push({
+				type: "source-url",
+				sourceId: chunk.sourceId,
+				url: chunk.url,
+				title: chunk.title,
+				providerMetadata: chunk.providerMetadata
+			});
+			return true;
+		case "source-document":
+			parts.push({
+				type: "source-document",
+				sourceId: chunk.sourceId,
+				mediaType: chunk.mediaType,
+				title: chunk.title,
+				filename: chunk.filename,
+				providerMetadata: chunk.providerMetadata
+			});
+			return true;
+		case "tool-input-start":
+			if (findToolPartByCallId(parts, chunk.toolCallId)) return true;
+			parts.push({
+				type: `tool-${chunk.toolName}`,
+				toolCallId: chunk.toolCallId,
+				toolName: chunk.toolName,
+				state: "input-streaming",
+				input: void 0,
+				...chunk.providerExecuted != null ? { providerExecuted: chunk.providerExecuted } : {},
+				...chunk.providerMetadata != null ? { callProviderMetadata: chunk.providerMetadata } : {},
+				...chunk.title != null ? { title: chunk.title } : {}
+			});
+			return true;
+		case "tool-input-delta": {
+			const toolPart = findToolPartByCallId(parts, chunk.toolCallId);
+			if (toolPart && toolPart.state === "input-streaming") toolPart.input = chunk.input;
+			return true;
+		}
+		case "tool-input-available": {
+			const existing = findToolPartByCallId(parts, chunk.toolCallId);
+			if (existing) {
+				const p = existing;
+				if (p.state === "input-streaming") {
+					p.state = "input-available";
+					p.input = chunk.input;
+					if (chunk.providerExecuted != null) p.providerExecuted = chunk.providerExecuted;
+					if (chunk.providerMetadata != null) p.callProviderMetadata = chunk.providerMetadata;
+					if (chunk.title != null) p.title = chunk.title;
+				}
+				return true;
+			}
+			parts.push({
+				type: `tool-${chunk.toolName}`,
+				toolCallId: chunk.toolCallId,
+				toolName: chunk.toolName,
+				state: "input-available",
+				input: chunk.input,
+				...chunk.providerExecuted != null ? { providerExecuted: chunk.providerExecuted } : {},
+				...chunk.providerMetadata != null ? { callProviderMetadata: chunk.providerMetadata } : {},
+				...chunk.title != null ? { title: chunk.title } : {}
+			});
+			return true;
+		}
+		case "tool-input-error": {
+			const existing = findToolPartByCallId(parts, chunk.toolCallId);
+			if (existing) {
+				const p = existing;
+				if (p.state === "output-available" || p.state === "output-error" || p.state === "output-denied") return true;
+				p.state = "output-error";
+				p.errorText = chunk.errorText;
+				p.input = chunk.input;
+				if (chunk.providerExecuted != null) p.providerExecuted = chunk.providerExecuted;
+				if (chunk.providerMetadata != null) p.callProviderMetadata = chunk.providerMetadata;
+			} else parts.push({
+				type: `tool-${chunk.toolName}`,
+				toolCallId: chunk.toolCallId,
+				toolName: chunk.toolName,
+				state: "output-error",
+				input: chunk.input,
+				errorText: chunk.errorText,
+				...chunk.providerExecuted != null ? { providerExecuted: chunk.providerExecuted } : {},
+				...chunk.providerMetadata != null ? { callProviderMetadata: chunk.providerMetadata } : {}
+			});
+			return true;
+		}
+		case "tool-approval-request": {
+			const toolPart = findToolPartByCallId(parts, chunk.toolCallId);
+			if (toolPart) {
+				const p = toolPart;
+				p.state = "approval-requested";
+				p.approval = { id: chunk.approvalId };
+			}
+			return true;
+		}
+		case "tool-output-denied": {
+			const toolPart = findToolPartByCallId(parts, chunk.toolCallId);
+			if (toolPart) {
+				const p = toolPart;
+				p.state = "output-denied";
+			}
+			return true;
+		}
+		case "tool-output-available": {
+			const toolPart = findToolPartByCallId(parts, chunk.toolCallId);
+			if (toolPart) {
+				const p = toolPart;
+				p.state = "output-available";
+				p.output = chunk.output;
+				if (chunk.preliminary !== void 0) p.preliminary = chunk.preliminary;
+			}
+			return true;
+		}
+		case "tool-output-error": {
+			const toolPart = findToolPartByCallId(parts, chunk.toolCallId);
+			if (toolPart) {
+				const p = toolPart;
+				p.state = "output-error";
+				p.errorText = chunk.errorText;
+			}
+			return true;
+		}
+		case "step-start":
+		case "start-step":
+			parts.push({ type: "step-start" });
+			return true;
+		default:
+			if (chunk.type.startsWith("data-")) {
+				if (chunk.transient) return true;
+				if (chunk.id != null) {
+					const existing = findDataPartByTypeAndId(parts, chunk.type, chunk.id);
+					if (existing) {
+						existing.data = chunk.data;
+						return true;
+					}
+				}
+				parts.push({
+					type: chunk.type,
+					...chunk.id != null && { id: chunk.id },
+					data: chunk.data
+				});
+				return true;
+			}
+			return false;
+	}
+}
+/**
+* Returns true if `chunk` would be a no-op replay against the already-known
+* `parts` — i.e. some upstream is re-emitting events for a tool call that
+* the message has already advanced past.
+*
+* Used by stream broadcasters to suppress re-broadcasting these chunks to
+* connected clients. AI SDK v6's `updateToolPart` mutates an existing tool
+* part in place when a chunk arrives with a matching `toolCallId`, so a
+* replayed `tool-input-start` would clobber an `output-available` part back
+* to `input-streaming` on the client (issue #1404).
+*
+* Only returns true when re-broadcasting would *visibly regress* state on
+* a v6 client. Safe-by-construction chunk types (e.g. `tool-output-available`
+* carrying the same output the part already has) return false.
+*
+* Conditions:
+* - `tool-input-start` for a `toolCallId` that already exists in `parts`.
+* - `tool-input-delta` for a `toolCallId` whose existing part is no longer
+*   `input-streaming`.
+* - `tool-input-available` for a `toolCallId` whose existing part is no
+*   longer `input-streaming` (i.e. has already advanced to `input-available`
+*   or any terminal state).
+*/
+function isReplayChunk(parts, chunk) {
+	if (chunk.type !== "tool-input-start" && chunk.type !== "tool-input-delta" && chunk.type !== "tool-input-available") return false;
+	if (!chunk.toolCallId) return false;
+	const existing = findToolPartByCallId(parts, chunk.toolCallId);
+	if (!existing) return false;
+	if (chunk.type === "tool-input-start") return true;
+	return existing.state !== "input-streaming";
+}
+/**
+* Finds the last part in the array matching the given type.
+* Searches from the end for efficiency (the part we want is usually recent).
+*/
+function findLastPartByType(parts, type) {
+	for (let i = parts.length - 1; i >= 0; i--) if (parts[i].type === type) return parts[i];
+}
+/**
+* Finds a tool part by its toolCallId.
+* Searches from the end since the tool part is usually recent.
+*/
+function findToolPartByCallId(parts, toolCallId) {
+	if (!toolCallId) return void 0;
+	for (let i = parts.length - 1; i >= 0; i--) {
+		const p = parts[i];
+		if ("toolCallId" in p && p.toolCallId === toolCallId) return p;
+	}
+}
+/**
+* Shallow-merges providerMetadata from a chunk onto an existing part.
+* Preserves any metadata already on the part (e.g. from earlier deltas)
+* while adding new keys from the chunk. This is critical for providers
+* like Anthropic that emit the thinking block signature on reasoning-end.
+*/
+function mergeProviderMetadata(part, metadata) {
+	if (metadata == null) return;
+	const p = part;
+	p.providerMetadata = {
+		...p.providerMetadata,
+		...metadata
+	};
+}
+/**
+* Finds a data part by its type and id for reconciliation.
+* Data parts use type+id as a composite key so when the same combination
+* is seen again, the existing part's data is updated in-place.
+*/
+function findDataPartByTypeAndId(parts, type, id) {
+	for (let i = parts.length - 1; i >= 0; i--) {
+		const p = parts[i];
+		if (p.type === type && "id" in p && p.id === id) return p;
+	}
+}
+//#endregion
+//#region src/chat/agent-tools.ts
+function sortRuns(runs) {
+	return [...runs].sort((a, b) => {
+		if (a.order !== b.order) return a.order - b.order;
+		return a.runId.localeCompare(b.runId);
+	});
+}
+function rebuildIndexes(runsById) {
+	const grouped = {};
+	const unboundRuns = [];
+	for (const run of Object.values(runsById)) if (run.parentToolCallId) {
+		grouped[run.parentToolCallId] = grouped[run.parentToolCallId] ?? [];
+		grouped[run.parentToolCallId].push(run);
+	} else unboundRuns.push(run);
+	for (const [toolCallId, runs] of Object.entries(grouped)) grouped[toolCallId] = sortRuns(runs);
+	return {
+		runsByToolCallId: grouped,
+		unboundRuns: sortRuns(unboundRuns)
+	};
+}
+function emptyRun(message) {
+	const { event } = message;
+	if (event.kind === "started") return {
+		runId: event.runId,
+		agentType: event.agentType,
+		parentToolCallId: message.parentToolCallId,
+		inputPreview: event.inputPreview,
+		order: event.order,
+		display: event.display,
+		status: "running",
+		parts: [],
+		subAgent: {
+			agent: event.agentType,
+			name: event.runId
+		}
+	};
+}
+function applyToRun(prev, message) {
+	const seeded = prev ?? emptyRun(message);
+	const { event } = message;
+	switch (event.kind) {
+		case "started":
+			if (seeded?.status === "completed" || seeded?.status === "error" || seeded?.status === "aborted" || seeded?.status === "interrupted") return seeded;
+			return {
+				...seeded,
+				runId: event.runId,
+				agentType: event.agentType,
+				parentToolCallId: message.parentToolCallId,
+				inputPreview: event.inputPreview,
+				order: event.order,
+				display: event.display,
+				status: "running",
+				parts: seeded?.parts ?? [],
+				subAgent: {
+					agent: event.agentType,
+					name: event.runId
+				}
+			};
+		case "chunk": {
+			if (!seeded) return void 0;
+			const parts = [...seeded.parts];
+			try {
+				applyChunkToParts(parts, JSON.parse(event.body));
+			} catch {
+				return seeded;
+			}
+			return {
+				...seeded,
+				parts
+			};
+		}
+		case "finished":
+			if (!seeded) return void 0;
+			return {
+				...seeded,
+				status: "completed",
+				summary: event.summary,
+				error: void 0
+			};
+		case "error":
+			if (!seeded) return void 0;
+			return {
+				...seeded,
+				status: "error",
+				error: event.error
+			};
+		case "aborted":
+			if (!seeded) return void 0;
+			return {
+				...seeded,
+				status: "aborted",
+				error: event.reason
+			};
+		case "interrupted":
+			if (!seeded) return void 0;
+			return {
+				...seeded,
+				status: "interrupted",
+				error: event.error
+			};
+	}
+}
+function createAgentToolEventState() {
+	return {
+		runsById: {},
+		runsByToolCallId: {},
+		unboundRuns: []
+	};
+}
+function applyAgentToolEvent(state, message) {
+	if (message.type !== "agent-tool-event") return state;
+	const runId = message.event.runId;
+	const nextRun = applyToRun(state.runsById[runId], message);
+	if (!nextRun) return state;
+	const runsById = {
+		...state.runsById,
+		[runId]: nextRun
+	};
+	return {
+		runsById,
+		...rebuildIndexes(runsById)
+	};
+}
+//#endregion
+export { isReplayChunk as i, createAgentToolEventState as n, applyChunkToParts as r, applyAgentToolEvent as t };
+
+//# sourceMappingURL=agent-tools-BAdX1vdI.js.map

package/dist/agent-tools-BAdX1vdI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools-BAdX1vdI.js","names":[],"sources":["../src/chat/message-builder.ts","../src/chat/agent-tools.ts"],"sourcesContent":["/**\n * Shared message builder for reconstructing UIMessage parts from stream chunks.\n *\n * Used by both @cloudflare/ai-chat (server + client) and @cloudflare/think\n * to avoid duplicating the chunk-type switch/case logic.\n *\n * Operates on a mutable parts array for performance (avoids allocating new arrays\n * on every chunk during streaming).\n */\n\nimport type { UIMessage } from \"ai\";\n\n/** The parts array type from UIMessage */\nexport type MessageParts = UIMessage[\"parts\"];\n\n/** A single part from the UIMessage parts array */\nexport type MessagePart = MessageParts[number];\n\n/**\n * Parsed chunk data from an AI SDK stream event.\n * This is the JSON-parsed body of a CF_AGENT_USE_CHAT_RESPONSE message,\n * or the `data:` payload of an SSE line.\n */\nexport type StreamChunkData = {\n  type: string;\n  id?: string;\n  delta?: string;\n  text?: string;\n  mediaType?: string;\n  url?: string;\n  sourceId?: string;\n  title?: string;\n  filename?: string;\n  toolCallId?: string;\n  toolName?: string;\n  input?: unknown;\n  inputTextDelta?: string;\n  output?: unknown;\n  state?: string;\n  errorText?: string;\n  /** When true, the output is preliminary (may be updated by a later chunk) */\n  preliminary?: boolean;\n  /** Approval ID for tools with needsApproval */\n  approvalId?: string;\n  providerMetadata?: Record<string, unknown>;\n  /** Whether the tool was executed by the provider (e.g. Gemini code execution) */\n  providerExecuted?: boolean;\n  /** Payload for data-* parts (developer-defined typed JSON) */\n  data?: unknown;\n  /** When true, data parts are ephemeral and not persisted to message.parts */\n  transient?: boolean;\n  /** Message ID assigned by the server at stream start */\n  messageId?: string;\n  /** Per-message metadata attached by start/finish/message-metadata chunks */\n  messageMetadata?: unknown;\n  [key: string]: unknown;\n};\n\n/**\n * Applies a stream chunk to a mutable parts array, building up the message\n * incrementally. Returns true if the chunk was handled, false if it was\n * an unrecognized type (caller may handle it with additional logic).\n *\n * Handles all common chunk types that both server and client need:\n * - text-start / text-delta / text-end\n * - reasoning-start / reasoning-delta / reasoning-end\n * - file\n * - source-url / source-document\n * - tool-input-start / tool-input-delta / tool-input-available / tool-input-error\n * - tool-output-available / tool-output-error\n * - step-start (aliased from start-step)\n * - data-* (developer-defined typed JSON blobs)\n *\n * @param parts - The mutable parts array to update\n * @param chunk - The parsed stream chunk data\n * @returns true if handled, false if the chunk type is not recognized\n */\nexport function applyChunkToParts(\n  parts: MessagePart[],\n  chunk: StreamChunkData\n): boolean {\n  switch (chunk.type) {\n    case \"text-start\": {\n      parts.push({\n        type: \"text\",\n        text: \"\",\n        state: \"streaming\"\n      } as MessagePart);\n      return true;\n    }\n\n    case \"text-delta\": {\n      const lastTextPart = findLastPartByType(parts, \"text\");\n      if (lastTextPart && lastTextPart.type === \"text\") {\n        (lastTextPart as { text: string }).text += chunk.delta ?? \"\";\n      } else {\n        // No text-start received — create a new text part (stream resumption fallback)\n        parts.push({\n          type: \"text\",\n          text: chunk.delta ?? \"\",\n          state: \"streaming\"\n        } as MessagePart);\n      }\n      return true;\n    }\n\n    case \"text-end\": {\n      const lastTextPart = findLastPartByType(parts, \"text\");\n      if (lastTextPart && \"state\" in lastTextPart) {\n        (lastTextPart as { state: string }).state = \"done\";\n      }\n      return true;\n    }\n\n    case \"reasoning-start\": {\n      parts.push({\n        type: \"reasoning\",\n        text: \"\",\n        state: \"streaming\"\n      } as MessagePart);\n      return true;\n    }\n\n    case \"reasoning-delta\": {\n      const lastReasoningPart = findLastPartByType(parts, \"reasoning\");\n      if (lastReasoningPart && lastReasoningPart.type === \"reasoning\") {\n        (lastReasoningPart as { text: string }).text += chunk.delta ?? \"\";\n        mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);\n      } else {\n        // No reasoning-start received — create a new reasoning part (stream resumption fallback)\n        parts.push({\n          type: \"reasoning\",\n          text: chunk.delta ?? \"\",\n          state: \"streaming\",\n          ...(chunk.providerMetadata != null\n            ? { providerMetadata: chunk.providerMetadata }\n            : {})\n        } as MessagePart);\n      }\n      return true;\n    }\n\n    case \"reasoning-end\": {\n      const lastReasoningPart = findLastPartByType(parts, \"reasoning\");\n      if (lastReasoningPart && \"state\" in lastReasoningPart) {\n        (lastReasoningPart as { state: string }).state = \"done\";\n        mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);\n      }\n      return true;\n    }\n\n    case \"file\": {\n      parts.push({\n        type: \"file\",\n        mediaType: chunk.mediaType,\n        url: chunk.url\n      } as MessagePart);\n      return true;\n    }\n\n    case \"source-url\": {\n      parts.push({\n        type: \"source-url\",\n        sourceId: chunk.sourceId,\n        url: chunk.url,\n        title: chunk.title,\n        providerMetadata: chunk.providerMetadata\n      } as MessagePart);\n      return true;\n    }\n\n    case \"source-document\": {\n      parts.push({\n        type: \"source-document\",\n        sourceId: chunk.sourceId,\n        mediaType: chunk.mediaType,\n        title: chunk.title,\n        filename: chunk.filename,\n        providerMetadata: chunk.providerMetadata\n      } as MessagePart);\n      return true;\n    }\n\n    case \"tool-input-start\": {\n      // Idempotent against an existing tool part with the same toolCallId.\n      // Some providers (notably the OpenAI Responses API) replay prior\n      // tool calls in continuation streams as a fresh `tool-input-start`\n      // → `tool-input-delta` → `tool-input-available` →\n      // `tool-output-available` sequence carrying the original toolCallId\n      // and original output. Without this guard a replay would push a\n      // duplicate part into the streaming message *and* clobber the\n      // original part's state when the AI SDK's mutate-in-place\n      // `updateToolPart` processes the replay on the client (issue #1404).\n      // A model that genuinely wants a fresh tool call always emits a\n      // new toolCallId, so an existing match is never a legitimate\n      // \"start over\".\n      const existing = findToolPartByCallId(parts, chunk.toolCallId);\n      if (existing) {\n        return true;\n      }\n      parts.push({\n        type: `tool-${chunk.toolName}`,\n        toolCallId: chunk.toolCallId,\n        toolName: chunk.toolName,\n        state: \"input-streaming\",\n        input: undefined,\n        ...(chunk.providerExecuted != null\n          ? { providerExecuted: chunk.providerExecuted }\n          : {}),\n        ...(chunk.providerMetadata != null\n          ? { callProviderMetadata: chunk.providerMetadata }\n          : {}),\n        ...(chunk.title != null ? { title: chunk.title } : {})\n      } as MessagePart);\n      return true;\n    }\n\n    case \"tool-input-delta\": {\n      // Only mutate input while the tool is still actively input-streaming.\n      // Deltas arriving after the tool has already advanced (input-available\n      // or any terminal state) are provider replay and must not regress\n      // a fully-formed input back to a partial one.\n      const toolPart = findToolPartByCallId(parts, chunk.toolCallId);\n      if (\n        toolPart &&\n        (toolPart as Record<string, unknown>).state === \"input-streaming\"\n      ) {\n        (toolPart as Record<string, unknown>).input = chunk.input;\n      }\n      return true;\n    }\n\n    case \"tool-input-available\": {\n      const existing = findToolPartByCallId(parts, chunk.toolCallId);\n      if (existing) {\n        const p = existing as Record<string, unknown>;\n        // Only advance from the streaming-input phase. Once the tool is\n        // already at input-available or any terminal state\n        // (output-available, output-error, output-denied,\n        // approval-requested, approval-responded), this chunk is a\n        // provider replay and must not regress state or overwrite a\n        // resolved input/output. See the comment on tool-input-start.\n        if (p.state === \"input-streaming\") {\n          p.state = \"input-available\";\n          p.input = chunk.input;\n          if (chunk.providerExecuted != null) {\n            p.providerExecuted = chunk.providerExecuted;\n          }\n          if (chunk.providerMetadata != null) {\n            p.callProviderMetadata = chunk.providerMetadata;\n          }\n          if (chunk.title != null) {\n            p.title = chunk.title;\n          }\n        }\n        return true;\n      }\n      parts.push({\n        type: `tool-${chunk.toolName}`,\n        toolCallId: chunk.toolCallId,\n        toolName: chunk.toolName,\n        state: \"input-available\",\n        input: chunk.input,\n        ...(chunk.providerExecuted != null\n          ? { providerExecuted: chunk.providerExecuted }\n          : {}),\n        ...(chunk.providerMetadata != null\n          ? { callProviderMetadata: chunk.providerMetadata }\n          : {}),\n        ...(chunk.title != null ? { title: chunk.title } : {})\n      } as MessagePart);\n      return true;\n    }\n\n    case \"tool-input-error\": {\n      const existing = findToolPartByCallId(parts, chunk.toolCallId);\n      if (existing) {\n        const p = existing as Record<string, unknown>;\n        // First-write-wins: a tool that's already terminal must not be\n        // regressed (or re-decided as an error) by a later chunk. A\n        // tool-input-error here is either provider replay or a confused\n        // upstream — preserve the existing terminal state.\n        if (\n          p.state === \"output-available\" ||\n          p.state === \"output-error\" ||\n          p.state === \"output-denied\"\n        ) {\n          return true;\n        }\n        p.state = \"output-error\";\n        p.errorText = chunk.errorText;\n        p.input = chunk.input;\n        if (chunk.providerExecuted != null) {\n          p.providerExecuted = chunk.providerExecuted;\n        }\n        if (chunk.providerMetadata != null) {\n          p.callProviderMetadata = chunk.providerMetadata;\n        }\n      } else {\n        parts.push({\n          type: `tool-${chunk.toolName}`,\n          toolCallId: chunk.toolCallId,\n          toolName: chunk.toolName,\n          state: \"output-error\",\n          input: chunk.input,\n          errorText: chunk.errorText,\n          ...(chunk.providerExecuted != null\n            ? { providerExecuted: chunk.providerExecuted }\n            : {}),\n          ...(chunk.providerMetadata != null\n            ? { callProviderMetadata: chunk.providerMetadata }\n            : {})\n        } as MessagePart);\n      }\n      return true;\n    }\n\n    case \"tool-approval-request\": {\n      const toolPart = findToolPartByCallId(parts, chunk.toolCallId);\n      if (toolPart) {\n        const p = toolPart as Record<string, unknown>;\n        p.state = \"approval-requested\";\n        p.approval = { id: chunk.approvalId };\n      }\n      return true;\n    }\n\n    case \"tool-output-denied\": {\n      const toolPart = findToolPartByCallId(parts, chunk.toolCallId);\n      if (toolPart) {\n        const p = toolPart as Record<string, unknown>;\n        p.state = \"output-denied\";\n      }\n      return true;\n    }\n\n    case \"tool-output-available\": {\n      const toolPart = findToolPartByCallId(parts, chunk.toolCallId);\n      if (toolPart) {\n        const p = toolPart as Record<string, unknown>;\n        p.state = \"output-available\";\n        p.output = chunk.output;\n        if (chunk.preliminary !== undefined) {\n          p.preliminary = chunk.preliminary;\n        }\n      }\n      return true;\n    }\n\n    case \"tool-output-error\": {\n      const toolPart = findToolPartByCallId(parts, chunk.toolCallId);\n      if (toolPart) {\n        const p = toolPart as Record<string, unknown>;\n        p.state = \"output-error\";\n        p.errorText = chunk.errorText;\n      }\n      return true;\n    }\n\n    // Both \"step-start\" (client convention) and \"start-step\" (server convention)\n    case \"step-start\":\n    case \"start-step\": {\n      parts.push({ type: \"step-start\" } as MessagePart);\n      return true;\n    }\n\n    default: {\n      // https://ai-sdk.dev/docs/ai-sdk-ui/streaming-data\n      if (chunk.type.startsWith(\"data-\")) {\n        // Transient parts are ephemeral — the AI SDK client fires an onData\n        // callback instead of adding them to message.parts. On the server we\n        // still broadcast them (so connected clients see them in real time)\n        // but skip persisting them into the stored message parts.\n        if (chunk.transient) {\n          return true;\n        }\n\n        // Reconciliation: if a part with the same type AND id already exists,\n        // update its data in-place instead of appending a duplicate.\n        if (chunk.id != null) {\n          const existing = findDataPartByTypeAndId(parts, chunk.type, chunk.id);\n          if (existing) {\n            (existing as Record<string, unknown>).data = chunk.data;\n            return true;\n          }\n        }\n\n        // Append new data parts to the array directly.\n        // Note: `chunk.data` should always be provided — if omitted, the\n        // persisted part will have `data: undefined` which JSON.stringify\n        // drops, so the part will have no `data` field on reload.\n        // The cast is needed because UIMessage[\"parts\"] doesn't include\n        // data-* types in its union because they're an open extension point.\n        parts.push({\n          type: chunk.type,\n          ...(chunk.id != null && { id: chunk.id }),\n          data: chunk.data\n        } as MessagePart);\n        return true;\n      }\n\n      return false;\n    }\n  }\n}\n\n/**\n * Returns true if `chunk` would be a no-op replay against the already-known\n * `parts` — i.e. some upstream is re-emitting events for a tool call that\n * the message has already advanced past.\n *\n * Used by stream broadcasters to suppress re-broadcasting these chunks to\n * connected clients. AI SDK v6's `updateToolPart` mutates an existing tool\n * part in place when a chunk arrives with a matching `toolCallId`, so a\n * replayed `tool-input-start` would clobber an `output-available` part back\n * to `input-streaming` on the client (issue #1404).\n *\n * Only returns true when re-broadcasting would *visibly regress* state on\n * a v6 client. Safe-by-construction chunk types (e.g. `tool-output-available`\n * carrying the same output the part already has) return false.\n *\n * Conditions:\n * - `tool-input-start` for a `toolCallId` that already exists in `parts`.\n * - `tool-input-delta` for a `toolCallId` whose existing part is no longer\n *   `input-streaming`.\n * - `tool-input-available` for a `toolCallId` whose existing part is no\n *   longer `input-streaming` (i.e. has already advanced to `input-available`\n *   or any terminal state).\n */\nexport function isReplayChunk(\n  parts: MessagePart[],\n  chunk: StreamChunkData\n): boolean {\n  if (\n    chunk.type !== \"tool-input-start\" &&\n    chunk.type !== \"tool-input-delta\" &&\n    chunk.type !== \"tool-input-available\"\n  ) {\n    return false;\n  }\n  if (!chunk.toolCallId) return false;\n  const existing = findToolPartByCallId(parts, chunk.toolCallId);\n  if (!existing) return false;\n  if (chunk.type === \"tool-input-start\") return true;\n  const state = (existing as Record<string, unknown>).state;\n  return state !== \"input-streaming\";\n}\n\n/**\n * Finds the last part in the array matching the given type.\n * Searches from the end for efficiency (the part we want is usually recent).\n */\nfunction findLastPartByType(\n  parts: MessagePart[],\n  type: string\n): MessagePart | undefined {\n  for (let i = parts.length - 1; i >= 0; i--) {\n    if (parts[i].type === type) {\n      return parts[i];\n    }\n  }\n  return undefined;\n}\n\n/**\n * Finds a tool part by its toolCallId.\n * Searches from the end since the tool part is usually recent.\n */\nfunction findToolPartByCallId(\n  parts: MessagePart[],\n  toolCallId: string | undefined\n): MessagePart | undefined {\n  if (!toolCallId) return undefined;\n  for (let i = parts.length - 1; i >= 0; i--) {\n    const p = parts[i];\n    if (\"toolCallId\" in p && p.toolCallId === toolCallId) {\n      return p;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Shallow-merges providerMetadata from a chunk onto an existing part.\n * Preserves any metadata already on the part (e.g. from earlier deltas)\n * while adding new keys from the chunk. This is critical for providers\n * like Anthropic that emit the thinking block signature on reasoning-end.\n */\nfunction mergeProviderMetadata(\n  part: MessagePart,\n  metadata: Record<string, unknown> | undefined\n): void {\n  if (metadata == null) return;\n  const p = part as Record<string, unknown>;\n  p.providerMetadata = {\n    ...(p.providerMetadata as Record<string, unknown> | undefined),\n    ...metadata\n  };\n}\n\n/**\n * Finds a data part by its type and id for reconciliation.\n * Data parts use type+id as a composite key so when the same combination\n * is seen again, the existing part's data is updated in-place.\n */\nfunction findDataPartByTypeAndId(\n  parts: MessagePart[],\n  type: string,\n  id: string\n): MessagePart | undefined {\n  for (let i = parts.length - 1; i >= 0; i--) {\n    const p = parts[i];\n    if (p.type === type && \"id\" in p && (p as { id: string }).id === id) {\n      return p;\n    }\n  }\n  return undefined;\n}\n","import { applyChunkToParts } from \"./message-builder\";\nimport type {\n  AgentToolEventMessage,\n  AgentToolEventState,\n  AgentToolRunState\n} from \"../agent-tool-types\";\n\nfunction sortRuns(runs: AgentToolRunState[]): AgentToolRunState[] {\n  return [...runs].sort((a, b) => {\n    if (a.order !== b.order) return a.order - b.order;\n    return a.runId.localeCompare(b.runId);\n  });\n}\n\nfunction rebuildIndexes(\n  runsById: Record<string, AgentToolRunState>\n): Pick<AgentToolEventState, \"runsByToolCallId\" | \"unboundRuns\"> {\n  const grouped: Record<string, AgentToolRunState[]> = {};\n  const unboundRuns: AgentToolRunState[] = [];\n  for (const run of Object.values(runsById)) {\n    if (run.parentToolCallId) {\n      grouped[run.parentToolCallId] = grouped[run.parentToolCallId] ?? [];\n      grouped[run.parentToolCallId].push(run);\n    } else {\n      unboundRuns.push(run);\n    }\n  }\n  for (const [toolCallId, runs] of Object.entries(grouped)) {\n    grouped[toolCallId] = sortRuns(runs);\n  }\n  return { runsByToolCallId: grouped, unboundRuns: sortRuns(unboundRuns) };\n}\n\nfunction emptyRun(\n  message: AgentToolEventMessage\n): AgentToolRunState | undefined {\n  const { event } = message;\n  if (event.kind === \"started\") {\n    return {\n      runId: event.runId,\n      agentType: event.agentType,\n      parentToolCallId: message.parentToolCallId,\n      inputPreview: event.inputPreview,\n      order: event.order,\n      display: event.display,\n      status: \"running\",\n      parts: [],\n      subAgent: { agent: event.agentType, name: event.runId }\n    };\n  }\n  return undefined;\n}\n\nfunction applyToRun(\n  prev: AgentToolRunState | undefined,\n  message: AgentToolEventMessage\n): AgentToolRunState | undefined {\n  const seeded = prev ?? emptyRun(message);\n  const { event } = message;\n\n  switch (event.kind) {\n    case \"started\":\n      if (\n        seeded?.status === \"completed\" ||\n        seeded?.status === \"error\" ||\n        seeded?.status === \"aborted\" ||\n        seeded?.status === \"interrupted\"\n      ) {\n        return seeded;\n      }\n      return {\n        ...seeded,\n        runId: event.runId,\n        agentType: event.agentType,\n        parentToolCallId: message.parentToolCallId,\n        inputPreview: event.inputPreview,\n        order: event.order,\n        display: event.display,\n        status: \"running\",\n        parts: seeded?.parts ?? [],\n        subAgent: { agent: event.agentType, name: event.runId }\n      };\n    case \"chunk\": {\n      if (!seeded) return undefined;\n      const parts = [...seeded.parts];\n      try {\n        applyChunkToParts(parts, JSON.parse(event.body));\n      } catch {\n        return seeded;\n      }\n      return { ...seeded, parts };\n    }\n    case \"finished\":\n      if (!seeded) return undefined;\n      return {\n        ...seeded,\n        status: \"completed\",\n        summary: event.summary,\n        error: undefined\n      };\n    case \"error\":\n      if (!seeded) return undefined;\n      return { ...seeded, status: \"error\", error: event.error };\n    case \"aborted\":\n      if (!seeded) return undefined;\n      return { ...seeded, status: \"aborted\", error: event.reason };\n    case \"interrupted\":\n      if (!seeded) return undefined;\n      return { ...seeded, status: \"interrupted\", error: event.error };\n  }\n}\n\nexport function createAgentToolEventState(): AgentToolEventState {\n  return {\n    runsById: {},\n    runsByToolCallId: {},\n    unboundRuns: []\n  };\n}\n\nexport function applyAgentToolEvent(\n  state: AgentToolEventState,\n  message: AgentToolEventMessage\n): AgentToolEventState {\n  if (message.type !== \"agent-tool-event\") return state;\n  const runId = message.event.runId;\n  const nextRun = applyToRun(state.runsById[runId], message);\n  if (!nextRun) return state;\n\n  const runsById = { ...state.runsById, [runId]: nextRun };\n  return { runsById, ...rebuildIndexes(runsById) };\n}\n\nexport type {\n  AgentToolEvent,\n  AgentToolEventMessage,\n  AgentToolEventState,\n  AgentToolRunState\n} from \"../agent-tool-types\";\n"],"mappings":"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"}

package/dist/agent-tools-CIO14miM.d.ts

@@ -0,0 +1,14 @@
+import {
+  a as AgentToolEventState,
+  i as AgentToolEventMessage
+} from "./agent-tool-types-tBGRsPm0.js";
+
+//#region src/chat/agent-tools.d.ts
+declare function createAgentToolEventState(): AgentToolEventState;
+declare function applyAgentToolEvent(
+  state: AgentToolEventState,
+  message: AgentToolEventMessage
+): AgentToolEventState;
+//#endregion
+export { createAgentToolEventState as n, applyAgentToolEvent as t };
+//# sourceMappingURL=agent-tools-CIO14miM.d.ts.map

package/dist/agent-tools.d.ts

@@ -0,0 +1,68 @@
+import {
+  a as AgentToolEventState,
+  c as AgentToolRunInspection,
+  d as AgentToolStoredChunk,
+  f as AgentToolTerminalStatus,
+  h as RunAgentToolResult,
+  i as AgentToolEventMessage,
+  l as AgentToolRunState,
+  m as RunAgentToolOptions,
+  n as AgentToolDisplayMetadata,
+  o as AgentToolLifecycleResult,
+  p as ChatCapableAgentClass,
+  r as AgentToolEvent,
+  s as AgentToolRunInfo,
+  t as AgentToolChildAdapter,
+  u as AgentToolRunStatus
+} from "./agent-tool-types-tBGRsPm0.js";
+import { Tool } from "ai";
+
+//#region src/agent-tools.d.ts
+type SchemaLike<T = unknown> = {
+  parse(value: unknown): T;
+};
+type AgentToolFactoryOptions<Output = unknown> = {
+  description: string;
+  inputSchema: unknown;
+  outputSchema?: SchemaLike<Output>;
+  displayName?: string;
+  icon?: string;
+  display?: AgentToolDisplayMetadata;
+};
+/**
+ * Create an AI SDK tool that dispatches a chat-capable sub-agent through
+ * `Agent.runAgentTool`.
+ */
+declare function agentTool<Input = unknown, Output = unknown>(
+  cls: ChatCapableAgentClass,
+  options: AgentToolFactoryOptions<Output>
+): Tool<
+  Input,
+  | string
+  | Output
+  | {
+      ok: false;
+      error: string;
+    }
+>;
+//#endregion
+export {
+  type AgentToolChildAdapter,
+  type AgentToolDisplayMetadata,
+  type AgentToolEvent,
+  type AgentToolEventMessage,
+  type AgentToolEventState,
+  type AgentToolFactoryOptions,
+  type AgentToolLifecycleResult,
+  type AgentToolRunInfo,
+  type AgentToolRunInspection,
+  type AgentToolRunState,
+  type AgentToolRunStatus,
+  type AgentToolStoredChunk,
+  type AgentToolTerminalStatus,
+  type ChatCapableAgentClass,
+  type RunAgentToolOptions,
+  type RunAgentToolResult,
+  agentTool
+};
+//# sourceMappingURL=agent-tools.d.ts.map

package/dist/agent-tools.js

@@ -0,0 +1,51 @@
+import { __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context.js";
+import { tool } from "ai";
+//#region src/agent-tools.ts
+function currentAgentToolRunner() {
+	const agent = __DO_NOT_USE_WILL_BREAK__agentContext.getStore()?.agent;
+	if (agent === null || typeof agent !== "object" || typeof agent.runAgentTool !== "function") throw new Error("agentTool() can only run inside an Agent turn. Use it from getTools() on an Agent subclass.");
+	return agent;
+}
+function failure(error) {
+	return {
+		ok: false,
+		error
+	};
+}
+/**
+* Create an AI SDK tool that dispatches a chat-capable sub-agent through
+* `Agent.runAgentTool`.
+*/
+function agentTool(cls, options) {
+	return tool({
+		description: options.description,
+		inputSchema: options.inputSchema,
+		execute: async (input, executeOptions) => {
+			const display = options.displayName || options.icon || options.display ? {
+				...options.display,
+				...options.displayName ? { name: options.displayName } : {},
+				...options.icon ? { icon: options.icon } : {}
+			} : void 0;
+			const result = await currentAgentToolRunner().runAgentTool(cls, {
+				input,
+				parentToolCallId: executeOptions?.toolCallId,
+				signal: executeOptions?.abortSignal,
+				display
+			});
+			if (result.status === "completed") {
+				if (options.outputSchema) {
+					if (result.output === void 0) return failure("agent tool completed without structured output required by outputSchema");
+					return options.outputSchema.parse(result.output);
+				}
+				return result.summary ?? "";
+			}
+			if (result.status === "aborted") return failure("agent tool run was cancelled");
+			if (result.status === "interrupted") return failure("agent tool run was interrupted; no recoverable output");
+			return failure(result.error ?? "agent tool run failed");
+		}
+	});
+}
+//#endregion
+export { agentTool };
+
+//# sourceMappingURL=agent-tools.js.map

package/dist/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","names":["agentContext","createTool"],"sources":["../src/agent-tools.ts"],"sourcesContent":["import { tool, type Tool } from \"ai\";\nimport { __DO_NOT_USE_WILL_BREAK__agentContext as agentContext } from \"./internal_context\";\nimport type {\n  ChatCapableAgentClass,\n  RunAgentToolOptions,\n  RunAgentToolResult,\n  AgentToolDisplayMetadata\n} from \"./agent-tool-types\";\n\ntype SchemaLike<T = unknown> = {\n  parse(value: unknown): T;\n};\n\ntype AgentToolFactoryOptions<Output = unknown> = {\n  description: string;\n  inputSchema: unknown;\n  outputSchema?: SchemaLike<Output>;\n  displayName?: string;\n  icon?: string;\n  display?: AgentToolDisplayMetadata;\n};\n\ntype ToolExecutionOptions = {\n  toolCallId?: string;\n  abortSignal?: AbortSignal;\n};\n\ntype AgentToolRunner = {\n  runAgentTool<Input, Output>(\n    cls: ChatCapableAgentClass,\n    options: RunAgentToolOptions<Input>\n  ): Promise<RunAgentToolResult<Output>>;\n};\n\nfunction currentAgentToolRunner(): AgentToolRunner {\n  const agent = agentContext.getStore()?.agent;\n  if (\n    agent === null ||\n    typeof agent !== \"object\" ||\n    typeof (agent as { runAgentTool?: unknown }).runAgentTool !== \"function\"\n  ) {\n    throw new Error(\n      \"agentTool() can only run inside an Agent turn. Use it from getTools() on an Agent subclass.\"\n    );\n  }\n  return agent as AgentToolRunner;\n}\n\nfunction failure(error: string): { ok: false; error: string } {\n  return { ok: false, error };\n}\n\n/**\n * Create an AI SDK tool that dispatches a chat-capable sub-agent through\n * `Agent.runAgentTool`.\n */\nexport function agentTool<Input = unknown, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: AgentToolFactoryOptions<Output>\n): Tool<Input, string | Output | { ok: false; error: string }> {\n  const createTool = tool as unknown as <I, O>(config: {\n    description: string;\n    inputSchema: unknown;\n    execute: (input: I, options?: ToolExecutionOptions) => Promise<O>;\n  }) => Tool<I, O>;\n\n  return createTool<Input, string | Output | { ok: false; error: string }>({\n    description: options.description,\n    inputSchema: options.inputSchema,\n    execute: async (input: Input, executeOptions?: ToolExecutionOptions) => {\n      const display: AgentToolDisplayMetadata | undefined =\n        options.displayName || options.icon || options.display\n          ? {\n              ...options.display,\n              ...(options.displayName ? { name: options.displayName } : {}),\n              ...(options.icon ? { icon: options.icon } : {})\n            }\n          : undefined;\n\n      const result = await currentAgentToolRunner().runAgentTool<Input, Output>(\n        cls,\n        {\n          input,\n          parentToolCallId: executeOptions?.toolCallId,\n          signal: executeOptions?.abortSignal,\n          display\n        }\n      );\n\n      if (result.status === \"completed\") {\n        if (options.outputSchema) {\n          if (result.output === undefined) {\n            return failure(\n              \"agent tool completed without structured output required by outputSchema\"\n            );\n          }\n          return options.outputSchema.parse(result.output);\n        }\n        return result.summary ?? \"\";\n      }\n\n      if (result.status === \"aborted\") {\n        return failure(\"agent tool run was cancelled\");\n      }\n      if (result.status === \"interrupted\") {\n        return failure(\"agent tool run was interrupted; no recoverable output\");\n      }\n      return failure(result.error ?? \"agent tool run failed\");\n    }\n  });\n}\n\nexport type { AgentToolFactoryOptions };\nexport type {\n  AgentToolChildAdapter,\n  AgentToolDisplayMetadata,\n  AgentToolEvent,\n  AgentToolEventMessage,\n  AgentToolEventState,\n  AgentToolLifecycleResult,\n  AgentToolRunInfo,\n  AgentToolRunInspection,\n  AgentToolRunState,\n  AgentToolRunStatus,\n  AgentToolStoredChunk,\n  AgentToolTerminalStatus,\n  ChatCapableAgentClass,\n  RunAgentToolOptions,\n  RunAgentToolResult\n} from \"./agent-tool-types\";\n"],"mappings":";;;AAkCA,SAAS,yBAA0C;CACjD,MAAM,QAAQA,sCAAa,UAAU,EAAE;AACvC,KACE,UAAU,QACV,OAAO,UAAU,YACjB,OAAQ,MAAqC,iBAAiB,WAE9D,OAAM,IAAI,MACR,8FACD;AAEH,QAAO;;AAGT,SAAS,QAAQ,OAA6C;AAC5D,QAAO;EAAE,IAAI;EAAO;EAAO;;;;;;AAO7B,SAAgB,UACd,KACA,SAC6D;AAO7D,QAAOC,KAAkE;EACvE,aAAa,QAAQ;EACrB,aAAa,QAAQ;EACrB,SAAS,OAAO,OAAc,mBAA0C;GACtE,MAAM,UACJ,QAAQ,eAAe,QAAQ,QAAQ,QAAQ,UAC3C;IACE,GAAG,QAAQ;IACX,GAAI,QAAQ,cAAc,EAAE,MAAM,QAAQ,aAAa,GAAG,EAAE;IAC5D,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;IAC/C,GACD,KAAA;GAEN,MAAM,SAAS,MAAM,wBAAwB,CAAC,aAC5C,KACA;IACE;IACA,kBAAkB,gBAAgB;IAClC,QAAQ,gBAAgB;IACxB;IACD,CACF;AAED,OAAI,OAAO,WAAW,aAAa;AACjC,QAAI,QAAQ,cAAc;AACxB,SAAI,OAAO,WAAW,KAAA,EACpB,QAAO,QACL,0EACD;AAEH,YAAO,QAAQ,aAAa,MAAM,OAAO,OAAO;;AAElD,WAAO,OAAO,WAAW;;AAG3B,OAAI,OAAO,WAAW,UACpB,QAAO,QAAQ,+BAA+B;AAEhD,OAAI,OAAO,WAAW,cACpB,QAAO,QAAQ,wDAAwD;AAEzE,UAAO,QAAQ,OAAO,SAAS,wBAAwB;;EAE1D,CAAC"}