agents 0.26.0 → 0.27.0

package/dist/turns-DCV3ycDl.js

@@ -0,0 +1,317 @@
+//#region src/harness/ai-sdk/turns.ts
+function ownerOf(toolName, { tools, owner }) {
+	const tool = tools && Object.hasOwn(tools, toolName) ? tools[toolName] : void 0;
+	return tool && !tool.execute ? owner : void 0;
+}
+const json = (value) => value ?? null;
+const object = (value) => typeof value === "object" && value !== null ? value : void 0;
+function withMetadata(value, metadata) {
+	const providerMetadata = object(metadata);
+	return providerMetadata ? {
+		...value,
+		providerMetadata
+	} : value;
+}
+let warned = false;
+function warnSkipped(type) {
+	if (warned) return;
+	warned = true;
+	console.warn(`Channels skipped an AI SDK part it cannot carry: "${type}"`);
+}
+/**
+* Convert an AI SDK UI message stream into response chunks.
+*
+* An `error` or `abort` chunk makes the iteration throw once the stream
+* ends, so a failed or aborted generation never reads as a finished one, while the stream still
+* runs to its end and its `onEnd` sees the partial message.
+*/
+async function* toResponseChunks(stream, options = {}) {
+	let error;
+	for await (const chunk of stream) {
+		if (chunk.type === "error") error ??= new Error(chunk.errorText);
+		if (chunk.type === "abort") error ??= /* @__PURE__ */ new Error("The generation was aborted");
+		const converted = toResponseChunk(chunk, options);
+		if (converted) yield converted;
+	}
+	if (error) throw error;
+}
+/** Convert one AI SDK UI message chunk into a response chunk, if it has one. */
+function toResponseChunk(chunk, options) {
+	switch (chunk.type) {
+		case "text-start":
+		case "text-end":
+		case "reasoning-start":
+		case "reasoning-end": return withMetadata({
+			type: chunk.type,
+			id: chunk.id
+		}, chunk.providerMetadata);
+		case "text-delta":
+		case "reasoning-delta": return {
+			type: chunk.type,
+			id: chunk.id,
+			delta: chunk.delta
+		};
+		case "tool-input-start": return tool(chunk, options, { type: "tool-input-start" });
+		case "tool-input-delta": return {
+			type: "tool-input-delta",
+			toolCallId: chunk.toolCallId,
+			delta: chunk.inputTextDelta
+		};
+		case "tool-input-available": return withMetadata(tool(chunk, options, {
+			type: "tool-input-available",
+			input: json(chunk.input)
+		}), chunk.providerMetadata);
+		case "tool-input-error": {
+			const { owner: _owner, ...call } = tool(chunk, {}, {});
+			return {
+				...call,
+				type: "tool-input-error",
+				input: json(chunk.input),
+				errorText: chunk.errorText
+			};
+		}
+		case "tool-approval-request": return {
+			type: "tool-approval-request",
+			toolCallId: chunk.toolCallId,
+			approvalId: chunk.approvalId
+		};
+		case "tool-output-available": return {
+			type: "tool-output-available",
+			toolCallId: chunk.toolCallId,
+			output: json(chunk.output),
+			...chunk.preliminary && { preliminary: true },
+			...chunk.providerExecuted && { providerExecuted: true }
+		};
+		case "tool-output-error": return {
+			type: "tool-output-error",
+			toolCallId: chunk.toolCallId,
+			errorText: chunk.errorText,
+			...chunk.providerExecuted && { providerExecuted: true }
+		};
+		case "tool-output-denied": return {
+			type: "tool-output-denied",
+			toolCallId: chunk.toolCallId
+		};
+		case "source-url":
+		case "source-document":
+		case "file": {
+			const { providerMetadata, ...part } = chunk;
+			return withMetadata(part, providerMetadata);
+		}
+		case "start":
+		case "finish": return chunk.messageMetadata === void 0 ? void 0 : metadata(chunk.messageMetadata);
+		case "message-metadata": return metadata(chunk.messageMetadata);
+		case "start-step":
+		case "finish-step":
+		case "tool-approval-response":
+		case "error":
+		case "abort": return;
+		default:
+			if (chunk.type.startsWith("data-") && "data" in chunk) return {
+				type: "data",
+				name: chunk.type.slice(5),
+				...chunk.id !== void 0 && { id: chunk.id },
+				data: json(chunk.data),
+				...chunk.transient && { transient: true }
+			};
+			warnSkipped(chunk.type);
+			return;
+	}
+}
+function tool(chunk, options, rest) {
+	const owner = ownerOf(chunk.toolName, options);
+	return {
+		toolCallId: chunk.toolCallId,
+		toolName: chunk.toolName,
+		...owner !== void 0 && { owner },
+		...chunk.providerExecuted && { providerExecuted: true },
+		...chunk.dynamic && { dynamic: true },
+		...chunk.title !== void 0 && { title: chunk.title },
+		...rest
+	};
+}
+function metadata(value) {
+	const converted = object(value);
+	return converted ? {
+		type: "metadata",
+		metadata: converted
+	} : void 0;
+}
+/**
+* Convert a response chunk into an AI SDK UI message chunk. Fields that only
+* Channels has, such as a tool call's `owner`, are dropped.
+*/
+function toUIMessageChunk(chunk) {
+	switch (chunk.type) {
+		case "tool-input-start":
+		case "tool-input-available": {
+			const { owner: _owner, ...rest } = chunk;
+			return rest;
+		}
+		case "tool-input-delta": return {
+			type: "tool-input-delta",
+			toolCallId: chunk.toolCallId,
+			inputTextDelta: chunk.delta
+		};
+		case "data": {
+			const { name, ...rest } = chunk;
+			return {
+				...rest,
+				type: `data-${name}`
+			};
+		}
+		case "metadata": return {
+			type: "message-metadata",
+			messageMetadata: chunk.metadata
+		};
+		default: return chunk;
+	}
+}
+/** Convert a saved AI SDK UI message into a transcript message. */
+function toTranscriptMessage(message, options = {}) {
+	const metadata = object(message.metadata);
+	return {
+		id: message.id,
+		role: message.role,
+		parts: message.parts.flatMap((part) => {
+			const converted = toMessagePart(part, options);
+			return converted ? [converted] : [];
+		}),
+		...metadata && { metadata }
+	};
+}
+function toMessagePart(part, options) {
+	switch (part.type) {
+		case "text":
+		case "reasoning": return withMetadata({
+			type: part.type,
+			text: part.text
+		}, part.providerMetadata);
+		case "file":
+		case "source-url":
+		case "source-document": {
+			const { providerMetadata, ...rest } = part;
+			if ("providerReference" in rest) delete rest.providerReference;
+			return withMetadata(rest, providerMetadata);
+		}
+		case "step-start": return;
+		case "dynamic-tool": return toToolPart(part, part.toolName, true, options);
+		default:
+			if (part.type.startsWith("tool-") && "toolCallId" in part) return toToolPart(part, part.type.slice(5), false, options);
+			if (part.type.startsWith("data-") && "data" in part) return {
+				type: "data",
+				name: part.type.slice(5),
+				...part.id !== void 0 && { id: part.id },
+				data: json(part.data)
+			};
+			warnSkipped(part.type);
+			return;
+	}
+}
+function toToolPart(part, toolName, dynamic, options) {
+	const owner = ownerOf(toolName, options);
+	return withMetadata({
+		type: "tool",
+		toolCallId: part.toolCallId,
+		toolName,
+		state: part.state,
+		...part.input !== void 0 && { input: json(part.input) },
+		...part.state === "output-available" && {
+			output: json(part.output),
+			...part.preliminary && { preliminary: true }
+		},
+		...part.state === "output-error" && { errorText: part.errorText },
+		...part.approval && { approval: {
+			id: part.approval.id,
+			...part.approval.approved !== void 0 && { approved: part.approval.approved },
+			...part.approval.reason !== void 0 && { reason: part.approval.reason }
+		} },
+		...owner !== void 0 && { owner },
+		...part.providerExecuted && { providerExecuted: true },
+		...dynamic && { dynamic: true },
+		...part.title !== void 0 && { title: part.title }
+	}, part.callProviderMetadata);
+}
+/** Convert a transcript message into an AI SDK UI message. */
+function toUIMessage(message) {
+	return {
+		id: message.id,
+		role: message.role,
+		parts: message.parts.map(toUIPart),
+		...message.metadata && { metadata: message.metadata }
+	};
+}
+function toUIPart(part) {
+	switch (part.type) {
+		case "data": {
+			const { name, ...rest } = part;
+			return {
+				...rest,
+				type: `data-${name}`
+			};
+		}
+		case "tool": {
+			const { type: _type, toolName, dynamic, owner: _owner, providerMetadata, ...rest } = part;
+			const call = {
+				...rest,
+				...providerMetadata && { callProviderMetadata: providerMetadata }
+			};
+			return dynamic ? {
+				...call,
+				type: "dynamic-tool",
+				toolName
+			} : {
+				...call,
+				type: `tool-${toolName}`
+			};
+		}
+		default: return part;
+	}
+}
+/** Whether the message has a tool call waiting for a result or an approval. */
+function awaitsInput(message) {
+	return message.parts.some((part) => "toolCallId" in part && (part.state === "input-available" || part.state === "approval-requested"));
+}
+/**
+* Record a tool result or approval response on the tool call it answers.
+* Returns the updated message, or undefined when no call is waiting for it,
+* so the first answer wins.
+*/
+function answerToolCall(messages, event) {
+	for (const message of messages) {
+		const index = message.parts.findIndex((part) => answers(part, event));
+		if (index === -1) continue;
+		const parts = [...message.parts];
+		const part = parts[index];
+		parts[index] = event.type === "approval-response" ? {
+			...part,
+			state: event.approved ? "approval-responded" : "output-denied",
+			approval: {
+				id: event.approvalId,
+				approved: event.approved,
+				...event.reason !== void 0 && { reason: event.reason }
+			}
+		} : event.type === "tool-result" && event.result.ok ? {
+			...part,
+			state: "output-available",
+			output: event.result.output
+		} : {
+			...part,
+			state: "output-error",
+			errorText: event.type === "tool-result" && !event.result.ok ? event.result.errorText ?? "" : ""
+		};
+		return {
+			...message,
+			parts
+		};
+	}
+}
+function answers(part, event) {
+	if (!("toolCallId" in part)) return false;
+	if (event.type === "tool-result") return part.toolCallId === event.toolCallId && (part.state === "input-available" || part.state === "approval-responded");
+	return event.type === "approval-response" && part.state === "approval-requested" && part.approval.id === event.approvalId;
+}
+//#endregion
+export { toTranscriptMessage as a, toResponseChunks as i, awaitsInput as n, toUIMessage as o, toResponseChunk as r, toUIMessageChunk as s, answerToolCall as t };
+
+//# sourceMappingURL=turns-DCV3ycDl.js.map

package/dist/turns-DCV3ycDl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turns-DCV3ycDl.js","names":[],"sources":["../src/harness/ai-sdk/turns.ts"],"sourcesContent":["import type { ToolSet, UIMessage, UIMessageChunk } from \"ai\";\nimport type {\n  InboundEvent,\n  Json,\n  JsonObject,\n  MessagePart,\n  ResponseChunk,\n  ToolPart,\n  TranscriptMessage\n} from \"../../experimental/channels/protocol\";\n\nexport type AiSdkConversionOptions = {\n  /** The agent's tools. Those without `execute` run on a client. */\n  tools?: ToolSet;\n  /** Id of the participant whose client runs this message's client tools. */\n  owner?: string;\n};\n\nfunction ownerOf(\n  toolName: string,\n  { tools, owner }: AiSdkConversionOptions\n): string | undefined {\n  const tool =\n    tools && Object.hasOwn(tools, toolName) ? tools[toolName] : undefined;\n  return tool && !tool.execute ? owner : undefined;\n}\n\ntype UIPart = UIMessage[\"parts\"][number];\n\n// SAFETY: AI SDK values that reach these casts are JSON: tool inputs are\n// parsed JSON, and outputs, metadata and data are JSON-serializable by the\n// AI SDK's own contract for UI messages.\nconst json = (value: unknown): Json => (value ?? null) as Json;\nconst object = (value: unknown): JsonObject | undefined =>\n  typeof value === \"object\" && value !== null\n    ? (value as JsonObject)\n    : undefined;\n\nfunction withMetadata<T extends object>(\n  value: T,\n  metadata: unknown\n): T & { providerMetadata?: JsonObject } {\n  const providerMetadata = object(metadata);\n  return providerMetadata ? { ...value, providerMetadata } : value;\n}\n\nlet warned = false;\nfunction warnSkipped(type: string): void {\n  if (warned) return;\n  warned = true;\n  console.warn(`Channels skipped an AI SDK part it cannot carry: \"${type}\"`);\n}\n\n/**\n * Convert an AI SDK UI message stream into response chunks.\n *\n * An `error` or `abort` chunk makes the iteration throw once the stream\n * ends, so a failed or aborted generation never reads as a finished one, while the stream still\n * runs to its end and its `onEnd` sees the partial message.\n */\nexport async function* toResponseChunks(\n  stream: AsyncIterable<UIMessageChunk>,\n  options: AiSdkConversionOptions = {}\n): AsyncGenerator<ResponseChunk> {\n  let error: Error | undefined;\n  for await (const chunk of stream) {\n    if (chunk.type === \"error\") error ??= new Error(chunk.errorText);\n    if (chunk.type === \"abort\")\n      error ??= new Error(\"The generation was aborted\");\n    const converted = toResponseChunk(chunk, options);\n    if (converted) yield converted;\n  }\n  if (error) throw error;\n}\n\n/** Convert one AI SDK UI message chunk into a response chunk, if it has one. */\nexport function toResponseChunk(\n  chunk: UIMessageChunk,\n  options: AiSdkConversionOptions\n): ResponseChunk | undefined {\n  switch (chunk.type) {\n    case \"text-start\":\n    case \"text-end\":\n    case \"reasoning-start\":\n    case \"reasoning-end\":\n      return withMetadata(\n        { type: chunk.type, id: chunk.id },\n        chunk.providerMetadata\n      );\n    case \"text-delta\":\n    case \"reasoning-delta\":\n      return { type: chunk.type, id: chunk.id, delta: chunk.delta };\n    case \"tool-input-start\":\n      return tool(chunk, options, { type: \"tool-input-start\" as const });\n    case \"tool-input-delta\":\n      return {\n        type: \"tool-input-delta\",\n        toolCallId: chunk.toolCallId,\n        delta: chunk.inputTextDelta\n      };\n    case \"tool-input-available\":\n      return withMetadata(\n        tool(chunk, options, {\n          type: \"tool-input-available\" as const,\n          input: json(chunk.input)\n        }),\n        chunk.providerMetadata\n      );\n    case \"tool-input-error\": {\n      const { owner: _owner, ...call } = tool(chunk, {}, {});\n      return {\n        ...call,\n        type: \"tool-input-error\",\n        input: json(chunk.input),\n        errorText: chunk.errorText\n      };\n    }\n    case \"tool-approval-request\":\n      return {\n        type: \"tool-approval-request\",\n        toolCallId: chunk.toolCallId,\n        approvalId: chunk.approvalId\n      };\n    case \"tool-output-available\":\n      return {\n        type: \"tool-output-available\",\n        toolCallId: chunk.toolCallId,\n        output: json(chunk.output),\n        ...(chunk.preliminary && { preliminary: true }),\n        ...(chunk.providerExecuted && { providerExecuted: true })\n      };\n    case \"tool-output-error\":\n      return {\n        type: \"tool-output-error\",\n        toolCallId: chunk.toolCallId,\n        errorText: chunk.errorText,\n        ...(chunk.providerExecuted && { providerExecuted: true })\n      };\n    case \"tool-output-denied\":\n      return { type: \"tool-output-denied\", toolCallId: chunk.toolCallId };\n    case \"source-url\":\n    case \"source-document\":\n    case \"file\": {\n      const { providerMetadata, ...part } = chunk;\n      // SAFETY: these chunk shapes match the Channels parts field for field.\n      return withMetadata(part, providerMetadata) as ResponseChunk;\n    }\n    case \"start\":\n    case \"finish\":\n      return chunk.messageMetadata === undefined\n        ? undefined\n        : metadata(chunk.messageMetadata);\n    case \"message-metadata\":\n      return metadata(chunk.messageMetadata);\n    case \"start-step\":\n    case \"finish-step\":\n    case \"tool-approval-response\":\n    case \"error\":\n    case \"abort\":\n      return undefined;\n    default:\n      if (chunk.type.startsWith(\"data-\") && \"data\" in chunk) {\n        return {\n          type: \"data\",\n          name: chunk.type.slice(\"data-\".length),\n          ...(chunk.id !== undefined && { id: chunk.id }),\n          data: json(chunk.data),\n          ...(chunk.transient && { transient: true })\n        };\n      }\n      warnSkipped(chunk.type);\n      return undefined;\n  }\n}\n\nfunction tool<T extends object>(\n  chunk: {\n    toolCallId: string;\n    toolName: string;\n    providerExecuted?: boolean;\n    dynamic?: boolean;\n    title?: string;\n  },\n  options: AiSdkConversionOptions,\n  rest: T\n) {\n  const owner = ownerOf(chunk.toolName, options);\n  return {\n    toolCallId: chunk.toolCallId,\n    toolName: chunk.toolName,\n    ...(owner !== undefined && { owner }),\n    ...(chunk.providerExecuted && { providerExecuted: true }),\n    ...(chunk.dynamic && { dynamic: true }),\n    ...(chunk.title !== undefined && { title: chunk.title }),\n    ...rest\n  };\n}\n\nfunction metadata(value: unknown): ResponseChunk | undefined {\n  const converted = object(value);\n  return converted ? { type: \"metadata\", metadata: converted } : undefined;\n}\n\n/**\n * Convert a response chunk into an AI SDK UI message chunk. Fields that only\n * Channels has, such as a tool call's `owner`, are dropped.\n */\nexport function toUIMessageChunk(chunk: ResponseChunk): UIMessageChunk {\n  switch (chunk.type) {\n    case \"tool-input-start\":\n    case \"tool-input-available\": {\n      const { owner: _owner, ...rest } = chunk;\n      // SAFETY: as below, once the Channels-only owner is gone.\n      return rest as UIMessageChunk;\n    }\n    case \"tool-input-delta\":\n      return {\n        type: \"tool-input-delta\",\n        toolCallId: chunk.toolCallId,\n        inputTextDelta: chunk.delta\n      };\n    case \"data\": {\n      const { name, ...rest } = chunk;\n      return { ...rest, type: `data-${name}` };\n    }\n    case \"metadata\":\n      return { type: \"message-metadata\", messageMetadata: chunk.metadata };\n    default:\n      // SAFETY: the remaining chunks match their AI SDK shapes field for\n      // field.\n      return chunk as UIMessageChunk;\n  }\n}\n\n/** Convert a saved AI SDK UI message into a transcript message. */\nexport function toTranscriptMessage(\n  message: UIMessage,\n  options: AiSdkConversionOptions = {}\n): TranscriptMessage {\n  const metadata = object(message.metadata);\n  return {\n    id: message.id,\n    role: message.role,\n    parts: message.parts.flatMap((part) => {\n      const converted = toMessagePart(part, options);\n      return converted ? [converted] : [];\n    }),\n    ...(metadata && { metadata })\n  };\n}\n\nfunction toMessagePart(\n  part: UIPart,\n  options: AiSdkConversionOptions\n): MessagePart | undefined {\n  switch (part.type) {\n    case \"text\":\n    case \"reasoning\":\n      return withMetadata(\n        { type: part.type, text: part.text },\n        part.providerMetadata\n      );\n    case \"file\":\n    case \"source-url\":\n    case \"source-document\": {\n      const { providerMetadata, ...rest } = part;\n      if (\"providerReference\" in rest) delete rest.providerReference;\n      // SAFETY: these part shapes match the Channels parts field for field.\n      return withMetadata(rest, providerMetadata) as MessagePart;\n    }\n    case \"step-start\":\n      return undefined;\n    case \"dynamic-tool\":\n      return toToolPart(part, part.toolName, true, options);\n    default:\n      if (part.type.startsWith(\"tool-\") && \"toolCallId\" in part) {\n        return toToolPart(\n          part,\n          part.type.slice(\"tool-\".length),\n          false,\n          options\n        );\n      }\n      if (part.type.startsWith(\"data-\") && \"data\" in part) {\n        return {\n          type: \"data\",\n          name: part.type.slice(\"data-\".length),\n          ...(part.id !== undefined && { id: part.id }),\n          data: json(part.data)\n        };\n      }\n      warnSkipped(part.type);\n      return undefined;\n  }\n}\n\ntype UIToolPart = Extract<UIPart, { toolCallId: string }>;\n\nfunction toToolPart(\n  part: UIToolPart,\n  toolName: string,\n  dynamic: boolean,\n  options: AiSdkConversionOptions\n): ToolPart {\n  const owner = ownerOf(toolName, options);\n  return withMetadata(\n    {\n      type: \"tool\",\n      toolCallId: part.toolCallId,\n      toolName,\n      state: part.state,\n      ...(part.input !== undefined && { input: json(part.input) }),\n      ...(part.state === \"output-available\" && {\n        output: json(part.output),\n        ...(part.preliminary && { preliminary: true })\n      }),\n      ...(part.state === \"output-error\" && { errorText: part.errorText }),\n      ...(part.approval && {\n        approval: {\n          id: part.approval.id,\n          ...(part.approval.approved !== undefined && {\n            approved: part.approval.approved\n          }),\n          ...(part.approval.reason !== undefined && {\n            reason: part.approval.reason\n          })\n        }\n      }),\n      ...(owner !== undefined && { owner }),\n      ...(part.providerExecuted && { providerExecuted: true }),\n      ...(dynamic && { dynamic: true }),\n      ...(part.title !== undefined && { title: part.title })\n    } satisfies ToolPart,\n    part.callProviderMetadata\n  );\n}\n\n/** Convert a transcript message into an AI SDK UI message. */\nexport function toUIMessage(message: TranscriptMessage): UIMessage {\n  return {\n    id: message.id,\n    role: message.role,\n    parts: message.parts.map(toUIPart),\n    ...(message.metadata && { metadata: message.metadata })\n  };\n}\n\nfunction toUIPart(part: MessagePart): UIPart {\n  switch (part.type) {\n    case \"data\": {\n      const { name, ...rest } = part;\n      return { ...rest, type: `data-${name}` };\n    }\n    case \"tool\": {\n      const {\n        type: _type,\n        toolName,\n        dynamic,\n        owner: _owner,\n        providerMetadata,\n        ...rest\n      } = part;\n      const call = {\n        ...rest,\n        ...(providerMetadata && { callProviderMetadata: providerMetadata })\n      };\n      // SAFETY: the state and its fields were produced together by\n      // toToolPart, or by an agent following the same ToolState rules.\n      return (\n        dynamic\n          ? { ...call, type: \"dynamic-tool\", toolName }\n          : { ...call, type: `tool-${toolName}` }\n      ) as UIPart;\n    }\n    default:\n      // SAFETY: the remaining parts match their AI SDK shapes field for field.\n      return part as UIPart;\n  }\n}\n\n/** Whether the message has a tool call waiting for a result or an approval. */\nexport function awaitsInput(message: UIMessage): boolean {\n  return message.parts.some(\n    (part) =>\n      \"toolCallId\" in part &&\n      (part.state === \"input-available\" || part.state === \"approval-requested\")\n  );\n}\n\n/** A tool result or approval response, as an inbound event carries it. */\nexport type ToolCallAnswer =\n  | Pick<\n      Extract<InboundEvent, { type: \"tool-result\" }>,\n      \"type\" | \"toolCallId\" | \"result\"\n    >\n  | Pick<\n      Extract<InboundEvent, { type: \"approval-response\" }>,\n      \"type\" | \"approvalId\" | \"approved\" | \"reason\"\n    >;\n\n/**\n * Record a tool result or approval response on the tool call it answers.\n * Returns the updated message, or undefined when no call is waiting for it,\n * so the first answer wins.\n */\nexport function answerToolCall(\n  messages: readonly UIMessage[],\n  event: ToolCallAnswer\n): UIMessage | undefined {\n  for (const message of messages) {\n    const index = message.parts.findIndex((part) => answers(part, event));\n    if (index === -1) continue;\n    const parts = [...message.parts];\n    const part = parts[index] as UIToolPart;\n    // SAFETY: the new state is set with exactly the fields it requires.\n    parts[index] = (\n      event.type === \"approval-response\"\n        ? {\n            ...part,\n            // As the AI SDK records them: a rejection ends the call.\n            state: event.approved ? \"approval-responded\" : \"output-denied\",\n            approval: {\n              id: event.approvalId,\n              approved: event.approved,\n              ...(event.reason !== undefined && { reason: event.reason })\n            }\n          }\n        : event.type === \"tool-result\" && event.result.ok\n          ? { ...part, state: \"output-available\", output: event.result.output }\n          : {\n              ...part,\n              state: \"output-error\",\n              errorText:\n                event.type === \"tool-result\" && !event.result.ok\n                  ? (event.result.errorText ?? \"\")\n                  : \"\"\n            }\n    ) as UIPart;\n    return { ...message, parts };\n  }\n  return undefined;\n}\n\nfunction answers(part: UIPart, event: ToolCallAnswer): boolean {\n  if (!(\"toolCallId\" in part)) return false;\n  if (event.type === \"tool-result\") {\n    return (\n      part.toolCallId === event.toolCallId &&\n      // An approved client tool is answered after its approval.\n      (part.state === \"input-available\" || part.state === \"approval-responded\")\n    );\n  }\n  return (\n    event.type === \"approval-response\" &&\n    part.state === \"approval-requested\" &&\n    part.approval.id === event.approvalId\n  );\n}\n"],"mappings":"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"}

package/dist/voice/client.js

@@ -1,8 +1,8 @@
 import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../classPrivateFieldGet2-DZBYAB34.js";
 import { t as _classPrivateMethodInitSpec } from "../classPrivateMethodInitSpec-qMjJ6sHQ.js";
-import { VOICE_PROTOCOL_VERSION } from "./types.js";
 import { toVoiceError } from "./errors.js";
 import { t as ClientDiagnostics } from "../diagnostics-C4jcz3VK.js";
+import { VOICE_PROTOCOL_VERSION } from "./types.js";
 import { PartySocket } from "partysocket";
 //#region src/voice/client.ts
 function camelCaseToKebabCase(str) {

package/dist/voice/index.d.ts

@@ -1,5 +1,5 @@
-import { x as Connection } from "../capability-runner-DBAnGr6L.js";
-import { c as Agent } from "../agent-routing-0DR0Tk2v.js";
+import { x as Connection } from "../capability-runner-O5VbQzqg.js";
+import { c as Agent } from "../agent-routing-Bhdbvf7s.js";
 import {
   C as VoiceTransport,
   D as VoiceTurnSource,

package/dist/voice/index.js

@@ -1,8 +1,8 @@
 import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../classPrivateFieldGet2-DZBYAB34.js";
 import { t as _classPrivateMethodInitSpec } from "../classPrivateMethodInitSpec-qMjJ6sHQ.js";
-import { VOICE_PROTOCOL_VERSION } from "./types.js";
 import { logVoiceError, toVoiceError, voiceErrorMessage } from "./errors.js";
 import { n as ServerDiagnostics } from "../diagnostics-C4jcz3VK.js";
+import { VOICE_PROTOCOL_VERSION } from "./types.js";
 import { n as iterateTextEvents, r as SentenceChunker, t as iterateText } from "../text-stream-CpdiKrJB.js";
 import { addSFUTracks, createSFUSession, createSFUWebSocketAdapter, decodeVarint, downsample48kStereoTo16kMono, encodePayloadToProtobuf, encodeVarint, extractPayloadFromProtobuf, renegotiateSFUSession, sfuFetch, upsample16kMonoTo48kStereo } from "./sfu.js";
 import { WorkersAIFluxSTT, WorkersAINova3STT, WorkersAITTS } from "./workers-ai.js";

package/dist/websearch/index.d.ts

@@ -0,0 +1,58 @@
+import {
+  C as WebSearchResponse,
+  D as renderWebSearchResults,
+  E as WebSearchToolOutput,
+  S as WEB_SEARCH_TOOL_NAME,
+  T as WebSearchToolInput,
+  _ as DEFAULT_WEB_SEARCH_LIMIT,
+  a as AIWebSearchOptions,
+  b as RenderWebSearchResultsOptions,
+  c as WebSearchError,
+  d as WebSearchProvider,
+  f as WebSearchRequest,
+  g as DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS,
+  h as createHTTPWebSearch,
+  i as WebSearchToolSourceOptions,
+  l as WebSearchErrorCode,
+  m as createAIWebSearch,
+  n as WebSearchToolBindingOptions,
+  o as HTTPWebSearchOptions,
+  p as WebSearchSource,
+  r as WebSearchToolOptions,
+  s as WebSearchCallOptions,
+  t as DEFAULT_WEB_SEARCH_TIMEOUT_MS,
+  u as WebSearchGatewayOptions,
+  v as MAX_WEB_SEARCH_LIMIT,
+  w as WebSearchResult,
+  x as WEB_SEARCH_TOOL_DESCRIPTION,
+  y as MAX_WEB_SEARCH_QUERY_LENGTH
+} from "../tool-BPJEbwaX.js";
+export {
+  type AIWebSearchOptions,
+  DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS,
+  DEFAULT_WEB_SEARCH_LIMIT,
+  DEFAULT_WEB_SEARCH_TIMEOUT_MS,
+  type HTTPWebSearchOptions,
+  MAX_WEB_SEARCH_LIMIT,
+  MAX_WEB_SEARCH_QUERY_LENGTH,
+  type RenderWebSearchResultsOptions,
+  WEB_SEARCH_TOOL_DESCRIPTION,
+  WEB_SEARCH_TOOL_NAME,
+  type WebSearchCallOptions,
+  WebSearchError,
+  type WebSearchErrorCode,
+  type WebSearchGatewayOptions,
+  type WebSearchProvider,
+  type WebSearchRequest,
+  type WebSearchResponse,
+  type WebSearchResult,
+  type WebSearchSource,
+  type WebSearchToolBindingOptions,
+  type WebSearchToolInput,
+  type WebSearchToolOptions,
+  type WebSearchToolOutput,
+  type WebSearchToolSourceOptions,
+  createAIWebSearch,
+  createHTTPWebSearch,
+  renderWebSearchResults
+};

package/dist/websearch/index.js

@@ -0,0 +1,2 @@
+import { a as createAIWebSearch, c as DEFAULT_WEB_SEARCH_LIMIT, d as WEB_SEARCH_TOOL_DESCRIPTION, f as WEB_SEARCH_TOOL_NAME, i as WebSearchError, l as MAX_WEB_SEARCH_LIMIT, o as createHTTPWebSearch, p as renderWebSearchResults, s as DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS, t as DEFAULT_WEB_SEARCH_TIMEOUT_MS, u as MAX_WEB_SEARCH_QUERY_LENGTH } from "../tool-3PA8xjB_.js";
+export { DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS, DEFAULT_WEB_SEARCH_LIMIT, DEFAULT_WEB_SEARCH_TIMEOUT_MS, MAX_WEB_SEARCH_LIMIT, MAX_WEB_SEARCH_QUERY_LENGTH, WEB_SEARCH_TOOL_DESCRIPTION, WEB_SEARCH_TOOL_NAME, WebSearchError, createAIWebSearch, createHTTPWebSearch, renderWebSearchResults };

package/dist/websearch/tools/ai-sdk.d.ts

@@ -0,0 +1,77 @@
+import {
+  C as WebSearchResponse,
+  E as WebSearchToolOutput,
+  T as WebSearchToolInput,
+  c as WebSearchError,
+  d as WebSearchProvider,
+  l as WebSearchErrorCode,
+  p as WebSearchSource,
+  r as WebSearchToolOptions,
+  w as WebSearchResult
+} from "../../tool-BPJEbwaX.js";
+import { FlexibleSchema } from "ai";
+
+//#region src/websearch/tools/ai-sdk.d.ts
+/**
+ * The part of the AI SDK's tool execution options the tool reads. Spelled
+ * out rather than imported so it fits every supported `ai` major.
+ */
+interface WebSearchToolExecuteOptions {
+  abortSignal?: AbortSignal;
+}
+/**
+ * The AI SDK tool {@link webSearchTool} returns. Assignable to the AI SDK's
+ * `Tool`; `execute` and `toModelOutput` are always present.
+ */
+interface WebSearchTool {
+  description: string;
+  inputSchema: FlexibleSchema<WebSearchToolInput>;
+  execute(
+    input: WebSearchToolInput,
+    options: WebSearchToolExecuteOptions
+  ): Promise<WebSearchToolOutput>;
+  toModelOutput(options: { output: WebSearchToolOutput }): {
+    type: "text";
+    value: string;
+  };
+}
+/**
+ * Create an AI SDK tool that searches the web through Cloudflare's Web
+ * Search API. The host gets the full response as the tool's output (whole
+ * descriptions, provider metadata); the model gets a trimmed text rendering
+ * via `toModelOutput`. A failed search throws a `WebSearchError`, which the
+ * AI SDK reports to the model as a tool error: its `message` is written for
+ * the model, and its `cause` is the source's error with the API's detail.
+ *
+ * `toModelOutput` only applies to earlier turns when the tools are passed to
+ * `convertToModelMessages(messages, { tools })`; otherwise the AI SDK sends
+ * the full response back to the model as JSON. `AiSdkHarness` passes them.
+ *
+ * @example
+ * ```ts
+ * import { webSearchTool } from "agents/websearch/ai-sdk";
+ *
+ * const result = streamText({
+ *   model,
+ *   tools: { web_search: webSearchTool({ binding: env.AI }) },
+ *   messages
+ * });
+ * ```
+ */
+declare function webSearchTool(options: WebSearchToolOptions): WebSearchTool;
+//#endregion
+export {
+  WebSearchError,
+  type WebSearchErrorCode,
+  type WebSearchProvider,
+  type WebSearchResponse,
+  type WebSearchResult,
+  type WebSearchSource,
+  WebSearchTool,
+  WebSearchToolExecuteOptions,
+  type WebSearchToolInput,
+  type WebSearchToolOptions,
+  type WebSearchToolOutput,
+  webSearchTool
+};
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/websearch/tools/ai-sdk.js

@@ -0,0 +1,46 @@
+import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../tool-3PA8xjB_.js";
+import { t as webSearchInputSchema } from "../../input-schema-DNrpTu49.js";
+//#region src/websearch/tools/ai-sdk.ts
+/**
+* Create an AI SDK tool that searches the web through Cloudflare's Web
+* Search API. The host gets the full response as the tool's output (whole
+* descriptions, provider metadata); the model gets a trimmed text rendering
+* via `toModelOutput`. A failed search throws a `WebSearchError`, which the
+* AI SDK reports to the model as a tool error: its `message` is written for
+* the model, and its `cause` is the source's error with the API's detail.
+*
+* `toModelOutput` only applies to earlier turns when the tools are passed to
+* `convertToModelMessages(messages, { tools })`; otherwise the AI SDK sends
+* the full response back to the model as JSON. `AiSdkHarness` passes them.
+*
+* @example
+* ```ts
+* import { webSearchTool } from "agents/websearch/ai-sdk";
+*
+* const result = streamText({
+*   model,
+*   tools: { web_search: webSearchTool({ binding: env.AI }) },
+*   messages
+* });
+* ```
+*/
+function webSearchTool(options) {
+	const core = createWebSearchToolCore(options);
+	return {
+		description: core.description,
+		inputSchema: webSearchInputSchema(core.limit),
+		async execute(input, { abortSignal }) {
+			const run = await core.run(input, { signal: abortSignal });
+			if (!run.ok) throw toolFailure(run);
+			return run.output;
+		},
+		toModelOutput: ({ output }) => ({
+			type: "text",
+			value: core.render(output)
+		})
+	};
+}
+//#endregion
+export { WebSearchError, webSearchTool };
+
+//# sourceMappingURL=ai-sdk.js.map

package/dist/websearch/tools/ai-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","names":[],"sources":["../../../src/websearch/tools/ai-sdk.ts"],"sourcesContent":["/**\n * `agents/websearch/ai-sdk` — the `web_search` tool for the AI SDK.\n *\n * @beta\n */\nimport type { FlexibleSchema } from \"ai\";\nimport type { WebSearchToolInput, WebSearchToolOutput } from \"../contract\";\nimport {\n  createWebSearchToolCore,\n  toolFailure,\n  type WebSearchToolOptions\n} from \"../tool\";\nimport { webSearchInputSchema } from \"./input-schema\";\n\nexport type {\n  WebSearchResponse,\n  WebSearchResult,\n  WebSearchToolInput,\n  WebSearchToolOutput\n} from \"../contract\";\nexport {\n  WebSearchError,\n  type WebSearchErrorCode,\n  type WebSearchProvider,\n  type WebSearchSource\n} from \"../source\";\nexport type { WebSearchToolOptions } from \"../tool\";\n\n/**\n * The part of the AI SDK's tool execution options the tool reads. Spelled\n * out rather than imported so it fits every supported `ai` major.\n */\nexport interface WebSearchToolExecuteOptions {\n  abortSignal?: AbortSignal;\n}\n\n/**\n * The AI SDK tool {@link webSearchTool} returns. Assignable to the AI SDK's\n * `Tool`; `execute` and `toModelOutput` are always present.\n */\nexport interface WebSearchTool {\n  description: string;\n  inputSchema: FlexibleSchema<WebSearchToolInput>;\n  execute(\n    input: WebSearchToolInput,\n    options: WebSearchToolExecuteOptions\n  ): Promise<WebSearchToolOutput>;\n  toModelOutput(options: { output: WebSearchToolOutput }): {\n    type: \"text\";\n    value: string;\n  };\n}\n\n/**\n * Create an AI SDK tool that searches the web through Cloudflare's Web\n * Search API. The host gets the full response as the tool's output (whole\n * descriptions, provider metadata); the model gets a trimmed text rendering\n * via `toModelOutput`. A failed search throws a `WebSearchError`, which the\n * AI SDK reports to the model as a tool error: its `message` is written for\n * the model, and its `cause` is the source's error with the API's detail.\n *\n * `toModelOutput` only applies to earlier turns when the tools are passed to\n * `convertToModelMessages(messages, { tools })`; otherwise the AI SDK sends\n * the full response back to the model as JSON. `AiSdkHarness` passes them.\n *\n * @example\n * ```ts\n * import { webSearchTool } from \"agents/websearch/ai-sdk\";\n *\n * const result = streamText({\n *   model,\n *   tools: { web_search: webSearchTool({ binding: env.AI }) },\n *   messages\n * });\n * ```\n */\nexport function webSearchTool(options: WebSearchToolOptions): WebSearchTool {\n  const core = createWebSearchToolCore(options);\n  return {\n    description: core.description,\n    inputSchema: webSearchInputSchema(core.limit),\n    async execute(input, { abortSignal }) {\n      const run = await core.run(input, { signal: abortSignal });\n      if (!run.ok) throw toolFailure(run);\n      return run.output;\n    },\n    toModelOutput: ({ output }) => ({\n      type: \"text\",\n      value: core.render(output)\n    })\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,SAAgB,cAAc,SAA8C;CAC1E,MAAM,OAAO,wBAAwB,OAAO;CAC5C,OAAO;EACL,aAAa,KAAK;EAClB,aAAa,qBAAqB,KAAK,KAAK;EAC5C,MAAM,QAAQ,OAAO,EAAE,eAAe;GACpC,MAAM,MAAM,MAAM,KAAK,IAAI,OAAO,EAAE,QAAQ,YAAY,CAAC;GACzD,IAAI,CAAC,IAAI,IAAI,MAAM,YAAY,GAAG;GAClC,OAAO,IAAI;EACb;EACA,gBAAgB,EAAE,cAAc;GAC9B,MAAM;GACN,OAAO,KAAK,OAAO,MAAM;EAC3B;CACF;AACF"}

package/dist/websearch/tools/pi.d.ts

@@ -0,0 +1,82 @@
+import {
+  C as WebSearchResponse,
+  E as WebSearchToolOutput,
+  T as WebSearchToolInput,
+  c as WebSearchError,
+  d as WebSearchProvider,
+  l as WebSearchErrorCode,
+  p as WebSearchSource,
+  r as WebSearchToolOptions,
+  w as WebSearchResult
+} from "../../tool-BPJEbwaX.js";
+import { ToolRegistration } from "@earendil-works/pi-durable";
+import { Type } from "@earendil-works/pi-ai";
+
+//#region src/websearch/tools/pi.d.ts
+/**
+ * The model's input schema. The description tells the model the host's
+ * `limit`; a larger value is not rejected (which would cost a validation
+ * round trip) but capped by the core. pi already coerces `"5"` to `5`.
+ */
+declare function webSearchParameters(maxLimit: number): Type.TObject<{
+  query: Type.TString;
+  limit: Type.TOptional<Type.TInteger>;
+}>;
+type WebSearchParameters = ReturnType<typeof webSearchParameters>;
+/**
+ * Host-side details pi stores with each `web_search` result: the full API
+ * response (untrimmed descriptions, provider metadata) or the failure.
+ */
+type WebSearchToolDetails =
+  | {
+      ok: true;
+      output: WebSearchToolOutput;
+    }
+  | {
+      ok: false /** The source's error message, with the API's detail. */;
+      message: string;
+      status: number;
+      code: WebSearchErrorCode;
+      retryable: boolean;
+      requestId?: string;
+    };
+/**
+ * Create a pi tool that searches the web through Cloudflare's Web Search
+ * API. Install it on a registry like any other pi tool.
+ *
+ * The model chooses the query and (within the host's `limit`) how many
+ * results; the host chooses the gateway, provider, and billing. The tool is
+ * `replay: "safe"`: a search interrupted mid-call (say, by an eviction) runs
+ * again when the session recovers, which is a second billed search.
+ * Completed results are stored and not searched again.
+ *
+ * @example
+ * ```ts
+ * import { createRegistry } from "@earendil-works/pi-durable";
+ * import { webSearchTool } from "agents/websearch/pi";
+ *
+ * const registry = createRegistry();
+ * registry.install({
+ *   name: "tools",
+ *   tools: [webSearchTool({ binding: env.AI, provider: "exa" })]
+ * });
+ * ```
+ */
+declare function webSearchTool(
+  options: WebSearchToolOptions
+): ToolRegistration<WebSearchParameters, WebSearchToolDetails>;
+//#endregion
+export {
+  WebSearchError,
+  type WebSearchErrorCode,
+  type WebSearchProvider,
+  type WebSearchResponse,
+  type WebSearchResult,
+  type WebSearchSource,
+  WebSearchToolDetails,
+  type WebSearchToolInput,
+  type WebSearchToolOptions,
+  type WebSearchToolOutput,
+  webSearchTool
+};
+//# sourceMappingURL=pi.d.ts.map