agents 0.10.1 → 0.11.0

package/dist/browser/ai.d.ts

@@ -0,0 +1,31 @@
+import { t as BrowserToolsOptions } from "../shared-BUHZFGTk.js";
+import { ToolSet } from "ai";
+
+//#region src/browser/ai.d.ts
+/**
+ * Create AI SDK tools for browser automation via CDP code mode.
+ *
+ * Returns a `ToolSet` with `search` (query the CDP spec) and
+ * `execute` (run CDP commands against a live browser).
+ *
+ * @example
+ * ```ts
+ * import { createBrowserTools } from "agents/browser/ai";
+ * import { generateText } from "ai";
+ *
+ * const browserTools = createBrowserTools({
+ *   browser: env.BROWSER,
+ *   loader: env.LOADER,
+ * });
+ *
+ * const result = await generateText({
+ *   model,
+ *   tools: { ...browserTools, ...otherTools },
+ *   messages,
+ * });
+ * ```
+ */
+declare function createBrowserTools(options: BrowserToolsOptions): ToolSet;
+//#endregion
+export { type BrowserToolsOptions, createBrowserTools };
+//# sourceMappingURL=ai.d.ts.map

package/dist/browser/ai.js

@@ -0,0 +1,54 @@
+import { n as SEARCH_DESCRIPTION, r as createBrowserToolHandlers, t as EXECUTE_DESCRIPTION } from "../shared-BtPEbm_U.js";
+import { z } from "zod";
+import { tool } from "ai";
+//#region src/browser/ai.ts
+/**
+* Create AI SDK tools for browser automation via CDP code mode.
+*
+* Returns a `ToolSet` with `search` (query the CDP spec) and
+* `execute` (run CDP commands against a live browser).
+*
+* @example
+* ```ts
+* import { createBrowserTools } from "agents/browser/ai";
+* import { generateText } from "ai";
+*
+* const browserTools = createBrowserTools({
+*   browser: env.BROWSER,
+*   loader: env.LOADER,
+* });
+*
+* const result = await generateText({
+*   model,
+*   tools: { ...browserTools, ...otherTools },
+*   messages,
+* });
+* ```
+*/
+function createBrowserTools(options) {
+	const handlers = createBrowserToolHandlers(options);
+	return {
+		browser_search: tool({
+			description: SEARCH_DESCRIPTION,
+			inputSchema: z.object({ code: z.string().describe("JavaScript async arrow function that queries the CDP spec") }),
+			execute: async ({ code }) => {
+				const result = await handlers.search(code);
+				if (result.isError) throw new Error(result.text);
+				return result.text;
+			}
+		}),
+		browser_execute: tool({
+			description: EXECUTE_DESCRIPTION,
+			inputSchema: z.object({ code: z.string().describe("JavaScript async arrow function that uses the cdp helper") }),
+			execute: async ({ code }) => {
+				const result = await handlers.execute(code);
+				if (result.isError) throw new Error(result.text);
+				return result.text;
+			}
+		})
+	};
+}
+//#endregion
+export { createBrowserTools };
+
+//# sourceMappingURL=ai.js.map

package/dist/browser/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","names":[],"sources":["../../src/browser/ai.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport type { ToolSet } from \"ai\";\nimport { z } from \"zod\";\nimport {\n  createBrowserToolHandlers,\n  SEARCH_DESCRIPTION,\n  EXECUTE_DESCRIPTION,\n  type BrowserToolsOptions\n} from \"./shared\";\n\nexport type { BrowserToolsOptions } from \"./shared\";\n\n/**\n * Create AI SDK tools for browser automation via CDP code mode.\n *\n * Returns a `ToolSet` with `search` (query the CDP spec) and\n * `execute` (run CDP commands against a live browser).\n *\n * @example\n * ```ts\n * import { createBrowserTools } from \"agents/browser/ai\";\n * import { generateText } from \"ai\";\n *\n * const browserTools = createBrowserTools({\n *   browser: env.BROWSER,\n *   loader: env.LOADER,\n * });\n *\n * const result = await generateText({\n *   model,\n *   tools: { ...browserTools, ...otherTools },\n *   messages,\n * });\n * ```\n */\nexport function createBrowserTools(options: BrowserToolsOptions): ToolSet {\n  const handlers = createBrowserToolHandlers(options);\n\n  return {\n    browser_search: tool({\n      description: SEARCH_DESCRIPTION,\n      inputSchema: z.object({\n        code: z\n          .string()\n          .describe(\"JavaScript async arrow function that queries the CDP spec\")\n      }),\n      execute: async ({ code }) => {\n        const result = await handlers.search(code);\n        if (result.isError) {\n          throw new Error(result.text);\n        }\n        return result.text;\n      }\n    }),\n\n    browser_execute: tool({\n      description: EXECUTE_DESCRIPTION,\n      inputSchema: z.object({\n        code: z\n          .string()\n          .describe(\"JavaScript async arrow function that uses the cdp helper\")\n      }),\n      execute: async ({ code }) => {\n        const result = await handlers.execute(code);\n        if (result.isError) {\n          throw new Error(result.text);\n        }\n        return result.text;\n      }\n    })\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,mBAAmB,SAAuC;CACxE,MAAM,WAAW,0BAA0B,QAAQ;AAEnD,QAAO;EACL,gBAAgB,KAAK;GACnB,aAAa;GACb,aAAa,EAAE,OAAO,EACpB,MAAM,EACH,QAAQ,CACR,SAAS,4DAA4D,EACzE,CAAC;GACF,SAAS,OAAO,EAAE,WAAW;IAC3B,MAAM,SAAS,MAAM,SAAS,OAAO,KAAK;AAC1C,QAAI,OAAO,QACT,OAAM,IAAI,MAAM,OAAO,KAAK;AAE9B,WAAO,OAAO;;GAEjB,CAAC;EAEF,iBAAiB,KAAK;GACpB,aAAa;GACb,aAAa,EAAE,OAAO,EACpB,MAAM,EACH,QAAQ,CACR,SAAS,2DAA2D,EACxE,CAAC;GACF,SAAS,OAAO,EAAE,WAAW;IAC3B,MAAM,SAAS,MAAM,SAAS,QAAQ,KAAK;AAC3C,QAAI,OAAO,QACT,OAAM,IAAI,MAAM,OAAO,KAAK;AAE9B,WAAO,OAAO;;GAEjB,CAAC;EACH"}

package/dist/browser/index.d.ts

@@ -0,0 +1,51 @@
+import { a as createBrowserToolHandlers, i as ToolResult, n as EXECUTE_DESCRIPTION, r as SEARCH_DESCRIPTION, t as BrowserToolsOptions } from "../shared-BUHZFGTk.js";
+
+//#region src/browser/cdp-session.d.ts
+interface DebugEntry {
+  at: string;
+  type: string;
+  [key: string]: unknown;
+}
+interface CdpSendOptions {
+  timeoutMs?: number;
+  sessionId?: string;
+}
+interface CdpAttachOptions {
+  timeoutMs?: number;
+}
+/**
+ * A CDP session over an open WebSocket. Manages command correlation,
+ * timeouts, target sessions, and a debug event ring buffer.
+ *
+ * Used host-side (not in the sandbox) — the sandbox calls into this
+ * via DynamicWorkerExecutor's ToolDispatcher RPC.
+ */
+declare class CdpSession {
+  #private;
+  constructor(socket: WebSocket, defaultTimeoutMs?: number, dispose?: () => void);
+  send(method: string, params?: unknown, options?: CdpSendOptions): Promise<unknown>;
+  attachToTarget(targetId: string, options?: CdpAttachOptions): Promise<string>;
+  getDebugLog(limit?: number): DebugEntry[];
+  clearDebugLog(): void;
+  close(): void;
+}
+/**
+ * Connect to a browser via the Browser Rendering binding (Fetcher).
+ * Establishes a CDP WebSocket through the binding's fetch interface.
+ */
+declare function connectBrowser(browser: Fetcher, timeoutMs?: number): Promise<CdpSession>;
+/**
+ * Connect to a browser via a CDP base URL (e.g. http://localhost:9222).
+ * Discovers the WebSocket debugger URL via /json/version,
+ * rewrites localhost URLs to the base URL host, and opens the WebSocket.
+ *
+ * Useful for local development with `chrome --remote-debugging-port=9222`
+ * or when connecting through a tunnel.
+ */
+declare function connectUrl(baseUrl: string, options?: {
+  timeoutMs?: number;
+  headers?: Record<string, string>;
+}): Promise<CdpSession>;
+//#endregion
+export { type BrowserToolsOptions, type CdpAttachOptions, type CdpSendOptions, CdpSession, EXECUTE_DESCRIPTION, SEARCH_DESCRIPTION, type ToolResult, connectBrowser, connectUrl, createBrowserToolHandlers };
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+import { a as connectBrowser, i as CdpSession, n as SEARCH_DESCRIPTION, o as connectUrl, r as createBrowserToolHandlers, t as EXECUTE_DESCRIPTION } from "../shared-BtPEbm_U.js";
+export { CdpSession, EXECUTE_DESCRIPTION, SEARCH_DESCRIPTION, connectBrowser, connectUrl, createBrowserToolHandlers };

package/dist/browser/tanstack-ai.d.ts

@@ -0,0 +1,31 @@
+import { t as BrowserToolsOptions } from "../shared-BUHZFGTk.js";
+import { ServerTool } from "@tanstack/ai";
+
+//#region src/browser/tanstack-ai.d.ts
+/**
+ * Create TanStack AI tools for browser automation via CDP code mode.
+ *
+ * Returns an array of `ServerTool`s: `browser_search` (query the CDP spec)
+ * and `browser_execute` (run CDP commands against a live browser).
+ *
+ * @example
+ * ```ts
+ * import { createBrowserTools } from "agents/browser/tanstack-ai";
+ * import { chat } from "@tanstack/ai";
+ *
+ * const browserTools = createBrowserTools({
+ *   browser: env.BROWSER,
+ *   loader: env.LOADER,
+ * });
+ *
+ * const stream = chat({
+ *   adapter: openaiText("gpt-4o"),
+ *   tools: [...browserTools, ...otherTools],
+ *   messages,
+ * });
+ * ```
+ */
+declare function createBrowserTools(options: BrowserToolsOptions): ServerTool[];
+//#endregion
+export { type BrowserToolsOptions, createBrowserTools };
+//# sourceMappingURL=tanstack-ai.d.ts.map

package/dist/browser/tanstack-ai.js

@@ -0,0 +1,51 @@
+import { n as SEARCH_DESCRIPTION, r as createBrowserToolHandlers, t as EXECUTE_DESCRIPTION } from "../shared-BtPEbm_U.js";
+import { z } from "zod";
+import { toolDefinition } from "@tanstack/ai";
+//#region src/browser/tanstack-ai.ts
+/**
+* Create TanStack AI tools for browser automation via CDP code mode.
+*
+* Returns an array of `ServerTool`s: `browser_search` (query the CDP spec)
+* and `browser_execute` (run CDP commands against a live browser).
+*
+* @example
+* ```ts
+* import { createBrowserTools } from "agents/browser/tanstack-ai";
+* import { chat } from "@tanstack/ai";
+*
+* const browserTools = createBrowserTools({
+*   browser: env.BROWSER,
+*   loader: env.LOADER,
+* });
+*
+* const stream = chat({
+*   adapter: openaiText("gpt-4o"),
+*   tools: [...browserTools, ...otherTools],
+*   messages,
+* });
+* ```
+*/
+function createBrowserTools(options) {
+	const handlers = createBrowserToolHandlers(options);
+	return [toolDefinition({
+		name: "browser_search",
+		description: SEARCH_DESCRIPTION,
+		inputSchema: z.object({ code: z.string().meta({ description: "JavaScript async arrow function that queries the CDP spec" }) })
+	}).server(async ({ code }) => {
+		const result = await handlers.search(code);
+		if (result.isError) throw new Error(result.text);
+		return { text: result.text };
+	}), toolDefinition({
+		name: "browser_execute",
+		description: EXECUTE_DESCRIPTION,
+		inputSchema: z.object({ code: z.string().meta({ description: "JavaScript async arrow function that uses the cdp helper" }) })
+	}).server(async ({ code }) => {
+		const result = await handlers.execute(code);
+		if (result.isError) throw new Error(result.text);
+		return { text: result.text };
+	})];
+}
+//#endregion
+export { createBrowserTools };
+
+//# sourceMappingURL=tanstack-ai.js.map

package/dist/browser/tanstack-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-ai.js","names":[],"sources":["../../src/browser/tanstack-ai.ts"],"sourcesContent":["import { toolDefinition } from \"@tanstack/ai\";\nimport type { ServerTool } from \"@tanstack/ai\";\nimport { z } from \"zod\";\nimport {\n  createBrowserToolHandlers,\n  SEARCH_DESCRIPTION,\n  EXECUTE_DESCRIPTION,\n  type BrowserToolsOptions\n} from \"./shared\";\n\nexport type { BrowserToolsOptions } from \"./shared\";\n\n/**\n * Create TanStack AI tools for browser automation via CDP code mode.\n *\n * Returns an array of `ServerTool`s: `browser_search` (query the CDP spec)\n * and `browser_execute` (run CDP commands against a live browser).\n *\n * @example\n * ```ts\n * import { createBrowserTools } from \"agents/browser/tanstack-ai\";\n * import { chat } from \"@tanstack/ai\";\n *\n * const browserTools = createBrowserTools({\n *   browser: env.BROWSER,\n *   loader: env.LOADER,\n * });\n *\n * const stream = chat({\n *   adapter: openaiText(\"gpt-4o\"),\n *   tools: [...browserTools, ...otherTools],\n *   messages,\n * });\n * ```\n */\nexport function createBrowserTools(options: BrowserToolsOptions): ServerTool[] {\n  const handlers = createBrowserToolHandlers(options);\n\n  const search = toolDefinition({\n    name: \"browser_search\" as const,\n    description: SEARCH_DESCRIPTION,\n    inputSchema: z.object({\n      code: z.string().meta({\n        description: \"JavaScript async arrow function that queries the CDP spec\"\n      })\n    })\n  }).server(async ({ code }) => {\n    const result = await handlers.search(code);\n    if (result.isError) {\n      throw new Error(result.text);\n    }\n    return { text: result.text };\n  });\n\n  const execute = toolDefinition({\n    name: \"browser_execute\" as const,\n    description: EXECUTE_DESCRIPTION,\n    inputSchema: z.object({\n      code: z.string().meta({\n        description: \"JavaScript async arrow function that uses the cdp helper\"\n      })\n    })\n  }).server(async ({ code }) => {\n    const result = await handlers.execute(code);\n    if (result.isError) {\n      throw new Error(result.text);\n    }\n    return { text: result.text };\n  });\n\n  return [search, execute];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,mBAAmB,SAA4C;CAC7E,MAAM,WAAW,0BAA0B,QAAQ;AAkCnD,QAAO,CAhCQ,eAAe;EAC5B,MAAM;EACN,aAAa;EACb,aAAa,EAAE,OAAO,EACpB,MAAM,EAAE,QAAQ,CAAC,KAAK,EACpB,aAAa,6DACd,CAAC,EACH,CAAC;EACH,CAAC,CAAC,OAAO,OAAO,EAAE,WAAW;EAC5B,MAAM,SAAS,MAAM,SAAS,OAAO,KAAK;AAC1C,MAAI,OAAO,QACT,OAAM,IAAI,MAAM,OAAO,KAAK;AAE9B,SAAO,EAAE,MAAM,OAAO,MAAM;GAC5B,EAEc,eAAe;EAC7B,MAAM;EACN,aAAa;EACb,aAAa,EAAE,OAAO,EACpB,MAAM,EAAE,QAAQ,CAAC,KAAK,EACpB,aAAa,4DACd,CAAC,EACH,CAAC;EACH,CAAC,CAAC,OAAO,OAAO,EAAE,WAAW;EAC5B,MAAM,SAAS,MAAM,SAAS,QAAQ,KAAK;AAC3C,MAAI,OAAO,QACT,OAAM,IAAI,MAAM,OAAO,KAAK;AAE9B,SAAO,EAAE,MAAM,OAAO,MAAM;GAC5B,CAEsB"}

package/dist/chat/index.js

@@ -53,17 +53,23 @@ function applyChunkToParts(parts, chunk) {
 			return true;
 		case "reasoning-delta": {
 			const lastReasoningPart = findLastPartByType(parts, "reasoning");
-			if (lastReasoningPart && lastReasoningPart.type === "reasoning") lastReasoningPart.text += chunk.delta ?? "";
-			else parts.push({
+			if (lastReasoningPart && lastReasoningPart.type === "reasoning") {
+				lastReasoningPart.text += chunk.delta ?? "";
+				mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);
+			} else parts.push({
 				type: "reasoning",
 				text: chunk.delta ?? "",
-				state: "streaming"
+				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";
+			if (lastReasoningPart && "state" in lastReasoningPart) {
+				lastReasoningPart.state = "done";
+				mergeProviderMetadata(lastReasoningPart, chunk.providerMetadata);
+			}
 			return true;
 		}
 		case "file":
@@ -230,6 +236,20 @@ function findToolPartByCallId(parts, toolCallId) {
 	}
 }
 /**
+* 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.