agents 0.30.1 → 0.32.0

package/dist/agent-routing.d.ts

@@ -4,7 +4,7 @@ import {
   n as AgentOptions,
   r as RoutingRetryOptions,
   t as AgentGetOptions
-} from "./agent-routing-CDbpVjYq.js";
+} from "./agent-routing-vVMA7m8Y.js";
 export {
   AgentGetOptions,
   AgentOptions,

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

@@ -27,7 +27,7 @@ import {
   rt as RunAgentToolResult,
   tt as DetachedRunAgentToolResult,
   z as AgentToolEventState
-} from "./agent-routing-CDbpVjYq.js";
+} from "./agent-routing-vVMA7m8Y.js";
 export {
   AGENT_TOOL_MILESTONE_PART,
   AGENT_TOOL_PROGRESS_PART,

package/dist/{agent-tools-C8DH8Yii.d.ts → agent-tools-gGXXkf1z.d.ts}

@@ -4,7 +4,7 @@ import {
   W as AgentToolProgress,
   Z as AgentToolStoredChunk,
   z as AgentToolEventState
-} from "./agent-routing-CDbpVjYq.js";
+} from "./agent-routing-vVMA7m8Y.js";
 
 //#region src/chat/agent-tools.d.ts
 type AgentToolProgressEmitResult = "emitted" | "coalesced" | "inactive";
@@ -144,4 +144,4 @@ export {
   interceptAgentToolBroadcast as s,
   AgentToolBroadcastHooks as t
 };
-//# sourceMappingURL=agent-tools-C8DH8Yii.d.ts.map
+//# sourceMappingURL=agent-tools-gGXXkf1z.d.ts.map

package/dist/agent-tools.d.ts

@@ -20,7 +20,7 @@ import {
   rt as RunAgentToolResult,
   tt as DetachedRunAgentToolResult,
   z as AgentToolEventState
-} from "./agent-routing-CDbpVjYq.js";
+} from "./agent-routing-vVMA7m8Y.js";
 import { FlexibleSchema, InferSchema, Tool } from "ai";
 
 //#region src/agent-tools.d.ts

package/dist/agent-tools.js

@@ -1,5 +1,4 @@
 import { t as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-DhoDkSnH.js";
-import "./internal_context.js";
 import { asSchema, tool } from "ai";
 //#region src/agent-tools.ts
 /**

package/dist/agent-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tools.js","names":["agentContext","createTool"],"sources":["../src/agent-tools.ts"],"sourcesContent":["import {\n  asSchema,\n  tool,\n  type FlexibleSchema,\n  type InferSchema,\n  type Tool\n} 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  AgentToolFailure\n} from \"./agent-tool-types\";\n\ntype ParseSchema<Output = unknown> = {\n  parse(value: unknown): Output;\n};\n\ntype AgentToolOutputSchema<Output> =\n  | FlexibleSchema<Output>\n  | ParseSchema<Output>;\n\ntype AgentToolFactoryOptions<Output = unknown, Input = unknown> = {\n  description: string;\n  inputSchema: FlexibleSchema<Input>;\n  outputSchema?: AgentToolOutputSchema<Output>;\n  displayName?: string;\n  icon?: string;\n  display?: AgentToolDisplayMetadata;\n};\n\n// Capture the concrete schema type so the overload below can derive its input\n// with InferSchema. AgentToolFactoryOptions remains available for callers that\n// explicitly supply agentTool<Input, Output>() type arguments.\ntype InferredAgentToolFactoryOptions<\n  InputSchema extends FlexibleSchema,\n  Output\n> = Omit<AgentToolFactoryOptions<Output>, \"inputSchema\"> & {\n  inputSchema: InputSchema;\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\n/**\n * Preserve the existing Zod-style `.parse()` output-schema contract while\n * extending validation to the other formats supported by AI SDK FlexibleSchema.\n */\nasync function validateOutput<Output>(\n  schema: AgentToolOutputSchema<Output>,\n  value: unknown\n): Promise<Output> {\n  if (\n    typeof schema === \"object\" &&\n    schema !== null &&\n    \"parse\" in schema &&\n    typeof schema.parse === \"function\"\n  ) {\n    return schema.parse(value);\n  }\n\n  const validate = asSchema(schema as FlexibleSchema<Output>).validate;\n  if (!validate) {\n    throw new Error(\"agentTool outputSchema must provide runtime validation\");\n  }\n\n  const result = await validate(value);\n  if (!result.success) throw result.error;\n  return result.value;\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(\n  status: AgentToolFailure[\"status\"],\n  error: string,\n  retryable: boolean,\n  extra?: Pick<AgentToolFailure, \"reason\" | \"childStillRunning\">\n): AgentToolFailure {\n  return {\n    ok: false,\n    status,\n    error,\n    retryable,\n    ...(extra?.reason !== undefined ? { reason: extra.reason } : {}),\n    ...(extra?.childStillRunning !== undefined\n      ? { childStillRunning: extra.childStillRunning }\n      : {})\n  };\n}\n\n/**\n * Create an AI SDK tool that dispatches a chat-capable sub-agent through\n * `Agent.runAgentTool`.\n */\nexport function agentTool<InputSchema extends FlexibleSchema, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: InferredAgentToolFactoryOptions<InputSchema, Output>\n): Tool<InferSchema<InputSchema>, string | Output | AgentToolFailure>;\n// Preserve existing callers that explicitly provide agentTool<Input, Output>().\nexport function agentTool<Input = unknown, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: AgentToolFactoryOptions<Output, Input>\n): Tool<Input, string | Output | AgentToolFailure>;\nexport function agentTool<Input = unknown, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: AgentToolFactoryOptions<Output, Input>\n): Tool<Input, string | Output | AgentToolFailure> {\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 | AgentToolFailure>({\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      // Derive a STABLE runId from the tool call id (#1630). A tool call's id is\n      // preserved in the transcript, so when a parent turn is re-run by chat\n      // recovery after a deploy / eviction, the same `agentTool()` call resolves\n      // to the same runId — turning the re-issue into a duplicate that\n      // `runAgentTool` re-attaches to the still-running child, instead of a\n      // fresh `nanoid` that spawns a brand-new child and re-runs already-\n      // completed work (\"the agent went all the way back\"). Falls back to a\n      // fresh id only when there is no tool call id (rare; preserves prior\n      // behavior).\n      const runId = executeOptions?.toolCallId\n        ? `agent-tool:${executeOptions.toolCallId}`\n        : undefined;\n\n      const result = await currentAgentToolRunner().runAgentTool<Input, Output>(\n        cls,\n        {\n          input,\n          runId,\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              \"error\",\n              \"agent tool completed without structured output required by outputSchema\",\n              false\n            );\n          }\n          return validateOutput(options.outputSchema, result.output);\n        }\n        return result.summary ?? \"\";\n      }\n\n      if (result.status === \"aborted\") {\n        // Intentional cancellation (parent/user stopped the run) — not retryable.\n        return failure(\n          \"aborted\",\n          result.error ?? \"agent tool run was cancelled\",\n          false\n        );\n      }\n      if (result.status === \"interrupted\") {\n        // The child was reset/superseded by a deploy or parent recovery before\n        // it reached a logical outcome. Re-dispatching the run can succeed, so\n        // surface it as retryable rather than a terminal failure the parent\n        // would report to the user as final. `retryable` is intentionally COARSE\n        // (always true for `interrupted`); callers that want to distinguish a\n        // self-healing child from an exhausted one branch on `reason` /\n        // `childStillRunning` instead.\n        return failure(\n          \"interrupted\",\n          result.error ??\n            \"agent tool run was interrupted before it finished; it can be retried\",\n          true,\n          { reason: result.reason, childStillRunning: result.childStillRunning }\n        );\n      }\n      return failure(\"error\", result.error ?? \"agent tool run failed\", false);\n    }\n  });\n}\n\nexport type { AgentToolFactoryOptions };\nexport type {\n  AgentToolChildAdapter,\n  AgentToolDisplayMetadata,\n  AgentToolEvent,\n  AgentToolEventDelivery,\n  AgentToolEventMessage,\n  AgentToolEventState,\n  AgentToolFailure,\n  AgentToolInterruptedReason,\n  AgentToolLifecycleResult,\n  AgentToolRunInfo,\n  AgentToolRunInspection,\n  AgentToolRunPart,\n  AgentToolRunState,\n  AgentToolRunStatus,\n  AgentToolStoredChunk,\n  AgentToolTerminalStatus,\n  ChatCapableAgentClass,\n  DetachedAgentToolConfig,\n  DetachedRunAgentToolResult,\n  RunAgentToolOptions,\n  RunAgentToolResult\n} from \"./agent-tool-types\";\n"],"mappings":";;;;;;;;AA2DA,eAAe,eACb,QACA,OACiB;CACjB,IACE,OAAO,WAAW,YAClB,WAAW,QACX,WAAW,UACX,OAAO,OAAO,UAAU,YAExB,OAAO,OAAO,MAAM,KAAK;CAG3B,MAAM,WAAW,SAAS,MAAgC,CAAC,CAAC;CAC5D,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,wDAAwD;CAG1E,MAAM,SAAS,MAAM,SAAS,KAAK;CACnC,IAAI,CAAC,OAAO,SAAS,MAAM,OAAO;CAClC,OAAO,OAAO;AAChB;AAEA,SAAS,yBAA0C;CACjD,MAAM,QAAQA,sCAAa,SAAS,CAAC,EAAE;CACvC,IACE,UAAU,QACV,OAAO,UAAU,YACjB,OAAQ,MAAqC,iBAAiB,YAE9D,MAAM,IAAI,MACR,6FACF;CAEF,OAAO;AACT;AAEA,SAAS,QACP,QACA,OACA,WACA,OACkB;CAClB,OAAO;EACL,IAAI;EACJ;EACA;EACA;EACA,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;EAC9D,GAAI,OAAO,sBAAsB,KAAA,IAC7B,EAAE,mBAAmB,MAAM,kBAAkB,IAC7C,CAAC;CACP;AACF;AAeA,SAAgB,UACd,KACA,SACiD;CAOjD,OAAOC,KAAsD;EAC3D,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,YAAY,IAAI,CAAC;IAC3D,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAK,IAAI,CAAC;GAC/C,IACA,KAAA;GAWN,MAAM,QAAQ,gBAAgB,aAC1B,cAAc,eAAe,eAC7B,KAAA;GAEJ,MAAM,SAAS,MAAM,uBAAuB,CAAC,CAAC,aAC5C,KACA;IACE;IACA;IACA,kBAAkB,gBAAgB;IAClC,QAAQ,gBAAgB;IACxB;GACF,CACF;GAEA,IAAI,OAAO,WAAW,aAAa;IACjC,IAAI,QAAQ,cAAc;KACxB,IAAI,OAAO,WAAW,KAAA,GACpB,OAAO,QACL,SACA,2EACA,KACF;KAEF,OAAO,eAAe,QAAQ,cAAc,OAAO,MAAM;IAC3D;IACA,OAAO,OAAO,WAAW;GAC3B;GAEA,IAAI,OAAO,WAAW,WAEpB,OAAO,QACL,WACA,OAAO,SAAS,gCAChB,KACF;GAEF,IAAI,OAAO,WAAW,eAQpB,OAAO,QACL,eACA,OAAO,SACL,wEACF,MACA;IAAE,QAAQ,OAAO;IAAQ,mBAAmB,OAAO;GAAkB,CACvE;GAEF,OAAO,QAAQ,SAAS,OAAO,SAAS,yBAAyB,KAAK;EACxE;CACF,CAAC;AACH"}
+{"version":3,"file":"agent-tools.js","names":["agentContext","createTool"],"sources":["../src/agent-tools.ts"],"sourcesContent":["import {\n  asSchema,\n  tool,\n  type FlexibleSchema,\n  type InferSchema,\n  type Tool\n} 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  AgentToolFailure\n} from \"./agent-tool-types\";\n\ntype ParseSchema<Output = unknown> = {\n  parse(value: unknown): Output;\n};\n\ntype AgentToolOutputSchema<Output> =\n  | FlexibleSchema<Output>\n  | ParseSchema<Output>;\n\ntype AgentToolFactoryOptions<Output = unknown, Input = unknown> = {\n  description: string;\n  inputSchema: FlexibleSchema<Input>;\n  outputSchema?: AgentToolOutputSchema<Output>;\n  displayName?: string;\n  icon?: string;\n  display?: AgentToolDisplayMetadata;\n};\n\n// Capture the concrete schema type so the overload below can derive its input\n// with InferSchema. AgentToolFactoryOptions remains available for callers that\n// explicitly supply agentTool<Input, Output>() type arguments.\ntype InferredAgentToolFactoryOptions<\n  InputSchema extends FlexibleSchema,\n  Output\n> = Omit<AgentToolFactoryOptions<Output>, \"inputSchema\"> & {\n  inputSchema: InputSchema;\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\n/**\n * Preserve the existing Zod-style `.parse()` output-schema contract while\n * extending validation to the other formats supported by AI SDK FlexibleSchema.\n */\nasync function validateOutput<Output>(\n  schema: AgentToolOutputSchema<Output>,\n  value: unknown\n): Promise<Output> {\n  if (\n    typeof schema === \"object\" &&\n    schema !== null &&\n    \"parse\" in schema &&\n    typeof schema.parse === \"function\"\n  ) {\n    return schema.parse(value);\n  }\n\n  const validate = asSchema(schema as FlexibleSchema<Output>).validate;\n  if (!validate) {\n    throw new Error(\"agentTool outputSchema must provide runtime validation\");\n  }\n\n  const result = await validate(value);\n  if (!result.success) throw result.error;\n  return result.value;\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(\n  status: AgentToolFailure[\"status\"],\n  error: string,\n  retryable: boolean,\n  extra?: Pick<AgentToolFailure, \"reason\" | \"childStillRunning\">\n): AgentToolFailure {\n  return {\n    ok: false,\n    status,\n    error,\n    retryable,\n    ...(extra?.reason !== undefined ? { reason: extra.reason } : {}),\n    ...(extra?.childStillRunning !== undefined\n      ? { childStillRunning: extra.childStillRunning }\n      : {})\n  };\n}\n\n/**\n * Create an AI SDK tool that dispatches a chat-capable sub-agent through\n * `Agent.runAgentTool`.\n */\nexport function agentTool<InputSchema extends FlexibleSchema, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: InferredAgentToolFactoryOptions<InputSchema, Output>\n): Tool<InferSchema<InputSchema>, string | Output | AgentToolFailure>;\n// Preserve existing callers that explicitly provide agentTool<Input, Output>().\nexport function agentTool<Input = unknown, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: AgentToolFactoryOptions<Output, Input>\n): Tool<Input, string | Output | AgentToolFailure>;\nexport function agentTool<Input = unknown, Output = unknown>(\n  cls: ChatCapableAgentClass,\n  options: AgentToolFactoryOptions<Output, Input>\n): Tool<Input, string | Output | AgentToolFailure> {\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 | AgentToolFailure>({\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      // Derive a STABLE runId from the tool call id (#1630). A tool call's id is\n      // preserved in the transcript, so when a parent turn is re-run by chat\n      // recovery after a deploy / eviction, the same `agentTool()` call resolves\n      // to the same runId — turning the re-issue into a duplicate that\n      // `runAgentTool` re-attaches to the still-running child, instead of a\n      // fresh `nanoid` that spawns a brand-new child and re-runs already-\n      // completed work (\"the agent went all the way back\"). Falls back to a\n      // fresh id only when there is no tool call id (rare; preserves prior\n      // behavior).\n      const runId = executeOptions?.toolCallId\n        ? `agent-tool:${executeOptions.toolCallId}`\n        : undefined;\n\n      const result = await currentAgentToolRunner().runAgentTool<Input, Output>(\n        cls,\n        {\n          input,\n          runId,\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              \"error\",\n              \"agent tool completed without structured output required by outputSchema\",\n              false\n            );\n          }\n          return validateOutput(options.outputSchema, result.output);\n        }\n        return result.summary ?? \"\";\n      }\n\n      if (result.status === \"aborted\") {\n        // Intentional cancellation (parent/user stopped the run) — not retryable.\n        return failure(\n          \"aborted\",\n          result.error ?? \"agent tool run was cancelled\",\n          false\n        );\n      }\n      if (result.status === \"interrupted\") {\n        // The child was reset/superseded by a deploy or parent recovery before\n        // it reached a logical outcome. Re-dispatching the run can succeed, so\n        // surface it as retryable rather than a terminal failure the parent\n        // would report to the user as final. `retryable` is intentionally COARSE\n        // (always true for `interrupted`); callers that want to distinguish a\n        // self-healing child from an exhausted one branch on `reason` /\n        // `childStillRunning` instead.\n        return failure(\n          \"interrupted\",\n          result.error ??\n            \"agent tool run was interrupted before it finished; it can be retried\",\n          true,\n          { reason: result.reason, childStillRunning: result.childStillRunning }\n        );\n      }\n      return failure(\"error\", result.error ?? \"agent tool run failed\", false);\n    }\n  });\n}\n\nexport type { AgentToolFactoryOptions };\nexport type {\n  AgentToolChildAdapter,\n  AgentToolDisplayMetadata,\n  AgentToolEvent,\n  AgentToolEventDelivery,\n  AgentToolEventMessage,\n  AgentToolEventState,\n  AgentToolFailure,\n  AgentToolInterruptedReason,\n  AgentToolLifecycleResult,\n  AgentToolRunInfo,\n  AgentToolRunInspection,\n  AgentToolRunPart,\n  AgentToolRunState,\n  AgentToolRunStatus,\n  AgentToolStoredChunk,\n  AgentToolTerminalStatus,\n  ChatCapableAgentClass,\n  DetachedAgentToolConfig,\n  DetachedRunAgentToolResult,\n  RunAgentToolOptions,\n  RunAgentToolResult\n} from \"./agent-tool-types\";\n"],"mappings":";;;;;;;AA2DA,eAAe,eACb,QACA,OACiB;CACjB,IACE,OAAO,WAAW,YAClB,WAAW,QACX,WAAW,UACX,OAAO,OAAO,UAAU,YAExB,OAAO,OAAO,MAAM,KAAK;CAG3B,MAAM,WAAW,SAAS,MAAgC,CAAC,CAAC;CAC5D,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,wDAAwD;CAG1E,MAAM,SAAS,MAAM,SAAS,KAAK;CACnC,IAAI,CAAC,OAAO,SAAS,MAAM,OAAO;CAClC,OAAO,OAAO;AAChB;AAEA,SAAS,yBAA0C;CACjD,MAAM,QAAQA,sCAAa,SAAS,CAAC,EAAE;CACvC,IACE,UAAU,QACV,OAAO,UAAU,YACjB,OAAQ,MAAqC,iBAAiB,YAE9D,MAAM,IAAI,MACR,6FACF;CAEF,OAAO;AACT;AAEA,SAAS,QACP,QACA,OACA,WACA,OACkB;CAClB,OAAO;EACL,IAAI;EACJ;EACA;EACA;EACA,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;EAC9D,GAAI,OAAO,sBAAsB,KAAA,IAC7B,EAAE,mBAAmB,MAAM,kBAAkB,IAC7C,CAAC;CACP;AACF;AAeA,SAAgB,UACd,KACA,SACiD;CAOjD,OAAOC,KAAsD;EAC3D,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,YAAY,IAAI,CAAC;IAC3D,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAK,IAAI,CAAC;GAC/C,IACA,KAAA;GAWN,MAAM,QAAQ,gBAAgB,aAC1B,cAAc,eAAe,eAC7B,KAAA;GAEJ,MAAM,SAAS,MAAM,uBAAuB,CAAC,CAAC,aAC5C,KACA;IACE;IACA;IACA,kBAAkB,gBAAgB;IAClC,QAAQ,gBAAgB;IACxB;GACF,CACF;GAEA,IAAI,OAAO,WAAW,aAAa;IACjC,IAAI,QAAQ,cAAc;KACxB,IAAI,OAAO,WAAW,KAAA,GACpB,OAAO,QACL,SACA,2EACA,KACF;KAEF,OAAO,eAAe,QAAQ,cAAc,OAAO,MAAM;IAC3D;IACA,OAAO,OAAO,WAAW;GAC3B;GAEA,IAAI,OAAO,WAAW,WAEpB,OAAO,QACL,WACA,OAAO,SAAS,gCAChB,KACF;GAEF,IAAI,OAAO,WAAW,eAQpB,OAAO,QACL,eACA,OAAO,SACL,wEACF,MACA;IAAE,QAAQ,OAAO;IAAQ,mBAAmB,OAAO;GAAkB,CACvE;GAEF,OAAO,QAAQ,SAAS,OAAO,SAAS,yBAAyB,KAAK;EACxE;CACF,CAAC;AACH"}

package/dist/{ai-iXw0uOGj.d.ts → ai-CDn3Abax.d.ts}

@@ -1,13 +1,13 @@
 import {
   d as BrowserBinding,
   n as BrowserSessionStore
-} from "./session-store-_IK6dV-w.js";
+} from "./session-store-B7Ca-u1t.js";
 import {
   l as QuickActionBinding,
   r as BrowserConnectorSessionOptions,
   t as BrowserConnector,
   u as QuickActionCommonOptions
-} from "./connector-20DJ6p4k.js";
+} from "./connector-DZ71EjE-.js";
 import { ToolSet } from "ai";
 import { CodemodeRuntimeHandle } from "@cloudflare/codemode";
 
@@ -136,6 +136,10 @@ interface BrowserRuntime {
  *   }
  * }
  * ```
+ *
+ * @deprecated Use `browserTool` from `agents/browser/ai-sdk`,
+ * `agents/browser/tanstack-ai` or `agents/browser/pi`. See
+ * https://github.com/cloudflare/agents/blob/main/docs/agents/browse-the-web.md#persistent-browser
  */
 declare function createBrowserRuntime(
   options: CreateBrowserToolsOptions
@@ -166,17 +170,34 @@ declare function createBrowserRuntime(
  *   messages,
  * });
  * ```
+ *
+ * @deprecated Use `browserTool` from `agents/browser/ai-sdk`,
+ * `agents/browser/tanstack-ai` or `agents/browser/pi`. See
+ * https://github.com/cloudflare/agents/blob/main/docs/agents/browse-the-web.md#persistent-browser
  */
 declare function createBrowserTools(
   options: CreateBrowserToolsOptions
 ): ToolSet;
-/** A Quick Action exposed as an AI SDK tool. */
+/**
+ * A Quick Action exposed as an AI SDK tool.
+ *
+ * @deprecated Quick Actions are deprecated and won't change. Use
+ * `browserTool` to drive a browser, the `web_fetch` tool from
+ * `agents/webfetch` to read a page, or call the binding's
+ * `quickAction()` directly.
+ */
 type QuickActionToolName =
   | "markdown"
   | "extract"
   | "links"
   | "scrape"
   | "content";
+/**
+ * @deprecated Quick Actions are deprecated and won't change. Use
+ * `browserTool` to drive a browser, the `web_fetch` tool from
+ * `agents/webfetch` to read a page, or call the binding's
+ * `quickAction()` directly.
+ */
 interface CreateQuickActionToolsOptions {
   /**
    * Browser Run binding with Quick Actions support (`env.BROWSER`). Requires a
@@ -222,6 +243,11 @@ interface CreateQuickActionToolsOptions {
  * const tools = createQuickActionTools({ browser: this.env.BROWSER });
  * const result = await generateText({ model, tools, messages });
  * ```
+ *
+ * @deprecated Quick Actions are deprecated and won't change. Use
+ * `browserTool` to drive a browser, the `web_fetch` tool from
+ * `agents/webfetch` to read a page, or call the binding's
+ * `quickAction()` directly.
  */
 declare function createQuickActionTools(
   options: CreateQuickActionToolsOptions
@@ -236,4 +262,4 @@ export {
   createQuickActionTools as s,
   BrowserRuntime as t
 };
-//# sourceMappingURL=ai-iXw0uOGj.d.ts.map
+//# sourceMappingURL=ai-CDn3Abax.d.ts.map

package/dist/{ai-sdk-DRPh2rRa.js → ai-sdk-Kon40i0q.js}

@@ -1,6 +1,6 @@
 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 { C as isCatalogModelId, S as isRetryableStatus, T as isRunPathLanguageModelId, _ as isGatewayErrorEnvelope, a as normalizeChatCompletion, b as classifyStatus, f as createTransport$1, g as headersToObject, h as errorFromResponse$1, i as normalizeChatCompletionsStream, m as errorFromGatewayEnvelope$1, n as imageMediaTypeOf, o as prepareChatCompletionsRequest, p as definedHeaders, r as sseDataStream, t as buildImageInput, u as requireGatewayProvider, v as unwrapEnvelope$1, w as isDynamicRouteId, x as isAbortError, y as CloudflareAIError$1 } from "./images-xaDv2Fqe.js";
+import { C as isCatalogModelId, S as isRetryableStatus, T as isRunPathLanguageModelId, _ as isGatewayErrorEnvelope, a as normalizeChatCompletion, b as classifyStatus, f as createTransport$1, g as headersToObject, h as errorFromResponse$1, i as normalizeChatCompletionsStream, m as errorFromGatewayEnvelope$1, n as imageMediaTypeOf, o as prepareChatCompletionsRequest, p as definedHeaders, r as sseDataStream, t as buildImageInput, u as requireGatewayProvider, v as unwrapEnvelope$1, w as isDynamicRouteId, x as isAbortError, y as CloudflareAIError$1 } from "./images-CfuRCjwq.js";
 import { a as parseModelOptions, i as mergeModelOptions, n as PROVIDER_OPTIONS_KEY, o as resolveOptions, r as gatewayLayerOf } from "./settings-Dk2il2Hf.js";
 import { APICallError, TooManyEmbeddingValuesForCallError } from "@ai-sdk/provider";
 //#region src/models/ai-sdk/errors.ts
@@ -43,8 +43,6 @@ function requireLanguageModelId(modelId) {
 *
 * Extends the AI SDK's `APICallError` so `ai`'s built-in retry loop honours
 * {@link CloudflareAIError.isRetryable} without any extra wiring.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareAIError = class CloudflareAIError extends APICallError {
 	constructor(options) {
@@ -111,8 +109,6 @@ function fallbackLegs(model, call) {
 * wrote there: `parseModelOptions` is framework-neutral and drops rather than
 * throws, and no type ever sees that JSON. A vendor id in a leg would
 * otherwise reach `env.AI.run` — the path a vendor model must never take.
-*
-* @experimental This surface is experimental and may change.
 */
 function parseCallOptions(providerOptions) {
 	const options = parseModelOptions(providerOptions?.[PROVIDER_OPTIONS_KEY]);
@@ -124,8 +120,6 @@ function parseCallOptions(providerOptions) {
 * transcription, reranking. The same bag as {@link parseCallOptions}, but a
 * fallback leg must be a Workers AI id: a dynamic route answers in the
 * chat-completions shape, which none of those models can read.
-*
-* @experimental This surface is experimental and may change.
 */
 function parseModalityCallOptions(providerOptions) {
 	const options = parseModelOptions(providerOptions?.[PROVIDER_OPTIONS_KEY]);
@@ -198,8 +192,6 @@ async function errorFromResponse(response, context) {
 /**
 * Builds the transport for a set of provider settings, with every failure
 * lifted into the AI SDK error type.
-*
-* @experimental This surface is experimental and may change.
 */
 function createTransport(settings) {
 	const inner = createTransport$1(settings);
@@ -475,8 +467,6 @@ var _options$3 = /* @__PURE__ */ new WeakMap();
 * An `EmbeddingModelV4` over the Workers AI text-embedding catalog. The run
 * path takes `{ text: string[] }` and answers `{ data, shape, usage }`,
 * sometimes inside the Cloudflare envelope.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareEmbeddingModel = class {
 	constructor(modelId, options, config) {
@@ -768,8 +758,6 @@ function reasoningEffortField(options, context) {
 /**
 * Builds a strict OpenAI chat-completions body from AI SDK call options and
 * runs it through the compat layer for the target model.
-*
-* @experimental This surface is experimental and may change.
 */
 function buildOpenAIRequest(options, context) {
 	const warnings = [];
@@ -878,8 +866,6 @@ function toolCallsFrom(raw, messageExtra) {
 /**
 * Parses a non-streaming response. The body is normalized to the strict
 * `chat.completion` shape first, so only `choices[0].message` is read.
-*
-* @experimental This surface is experimental and may change.
 */
 function parseOpenAIGeneration(json, modelId) {
 	const body = normalizeChatCompletion(json, modelId);
@@ -914,8 +900,6 @@ function parseOpenAIGeneration(json, modelId) {
 * parts. Tool calls arrive either as incremental `arguments` fragments closed
 * by a null-finalization chunk, or as one delta with the complete arguments
 * string; both are handled. Usage is read from whichever chunk carries it.
-*
-* @experimental This surface is experimental and may change.
 */
 function openAIStreamParser() {
 	const toolCalls = /* @__PURE__ */ new Map();
@@ -1286,8 +1270,6 @@ var _CloudflareLanguageModel_brand = /* @__PURE__ */ new WeakSet();
 /**
 * A `LanguageModelV4` backed by the Cloudflare run path. The model id decides
 * the wire format; nothing about transport or wire format reaches user land.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareLanguageModel = class {
 	constructor(modelId, options, config) {
@@ -1650,8 +1632,6 @@ var _GatewayLanguageModel_brand = /* @__PURE__ */ new WeakSet();
 * A `LanguageModelV4` that is the user's own vendor model, routed through AI
 * Gateway. Generation, parsing, tool handling and error shapes stay the
 * vendor's; only the transport is Cloudflare's.
-*
-* @experimental This surface is experimental and may change.
 */
 var GatewayLanguageModel = class {
 	constructor(model, options, config) {
@@ -1774,8 +1754,6 @@ function _workersAI(modelId) {
 * `fetch` is swapped; every `do…` method stays the vendor's, and its result
 * gains `providerMetadata.cloudflare` when the result is an object that can
 * carry one.
-*
-* @experimental This surface is experimental and may change.
 */
 function routed(model, options, config) {
 	requireConfig(model);
@@ -1834,8 +1812,6 @@ var _CloudflareModalityModel_brand = /* @__PURE__ */ new WeakSet();
 * A model over the Cloudflare run path that is not a language model. Holds
 * the one call path all four modalities share; each subclass only builds a
 * body and reads an answer.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareModalityModel = class {
 	constructor(modelId, options, config) {
@@ -2058,8 +2034,6 @@ function imageUsage(json) {
 * The run path generates one image per call, so `maxImagesPerCall` is 1 and
 * `generateImage` fans a larger `n` out itself; a direct `doGenerate` with
 * `n > 1` is fanned out here instead.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareImageModel = class extends CloudflareModalityModel {
 	constructor(modelId, options, config) {
@@ -2123,8 +2097,6 @@ function buildRerankingRequest(options) {
 }
 /**
 * A `RerankingModelV4` over the Workers AI reranker catalog.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareRerankingModel = class extends CloudflareModalityModel {
 	constructor(modelId, options, config) {
@@ -2231,8 +2203,6 @@ function readAudio(answer) {
 }
 /**
 * A `SpeechModelV4` over the Workers AI text-to-speech catalog.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareSpeechModel = class extends CloudflareModalityModel {
 	constructor(modelId, options, config) {
@@ -2395,8 +2365,6 @@ function readSegments(body) {
 }
 /**
 * A `TranscriptionModelV4` over the Workers AI speech-recognition catalog.
-*
-* @experimental This surface is experimental and may change.
 */
 var CloudflareTranscriptionModel = class extends CloudflareModalityModel {
 	constructor(modelId, options, config) {
@@ -2463,8 +2431,6 @@ function isModel(value) {
 * ai("anthropic/claude-opus-4.8", { fallback: ["openai/gpt-5.5"] });
 * ai.embedding("@cf/baai/bge-base-en-v1.5");
 * ```
-*
-* @experimental This surface is experimental and may change.
 */
 function createAI(settings) {
 	const config = {
@@ -2527,4 +2493,4 @@ function createAI(settings) {
 //#endregion
 export { GatewayLanguageModel as n, CloudflareAIError as r, createAI as t };
 
-//# sourceMappingURL=ai-sdk-DRPh2rRa.js.map
+//# sourceMappingURL=ai-sdk-Kon40i0q.js.map