agents 0.16.0 → 0.16.2

package/dist/{agent-tool-types-NofdbL9X.d.ts → agent-tool-types-CTw3UJUP.d.ts}

@@ -821,6 +821,14 @@ declare class MCPClientConnection {
   instructions?: string;
   tools: Tool$1[];
   private _transport?;
+  /**
+   * Transport that received the 401 during the initial connect attempt.
+   * Kept so finishAuth() runs on the transport that captured the resource
+   * metadata URL from the WWW-Authenticate header — a fresh transport would
+   * rediscover from defaults and exchange the code at the wrong token
+   * endpoint when the authorization server is not at the default location.
+   */
+  private _pendingAuthTransport?;
   prompts: Prompt[];
   resources: Resource[];
   resourceTemplates: ResourceTemplate[];
@@ -4847,4 +4855,4 @@ export {
   MCPServer as z,
   WorkerTransport as zt
 };
-//# sourceMappingURL=agent-tool-types-NofdbL9X.d.ts.map
+//# sourceMappingURL=agent-tool-types-CTw3UJUP.d.ts.map

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

@@ -16,7 +16,7 @@ import {
   s as AgentToolInterruptedReason,
   t as AgentToolChildAdapter,
   u as AgentToolRunInspection
-} from "./agent-tool-types-NofdbL9X.js";
+} from "./agent-tool-types-CTw3UJUP.js";
 export {
   AgentToolChildAdapter,
   AgentToolDisplayMetadata,

package/dist/{agent-tools-DLquv-dp.d.ts → agent-tools-DZhI5F6Q.d.ts}

@@ -1,7 +1,7 @@
 import {
   a as AgentToolEventState,
   i as AgentToolEventMessage
-} from "./agent-tool-types-NofdbL9X.js";
+} from "./agent-tool-types-CTw3UJUP.js";
 
 //#region src/chat/agent-tools.d.ts
 declare function createAgentToolEventState(): AgentToolEventState;
@@ -11,4 +11,4 @@ declare function applyAgentToolEvent(
 ): AgentToolEventState;
 //#endregion
 export { createAgentToolEventState as n, applyAgentToolEvent as t };
-//# sourceMappingURL=agent-tools-DLquv-dp.d.ts.map
+//# sourceMappingURL=agent-tools-DZhI5F6Q.d.ts.map

package/dist/agent-tools.d.ts

@@ -16,7 +16,7 @@ import {
   s as AgentToolInterruptedReason,
   t as AgentToolChildAdapter,
   u as AgentToolRunInspection
-} from "./agent-tool-types-NofdbL9X.js";
+} from "./agent-tool-types-CTw3UJUP.js";
 import { Tool } from "ai";
 
 //#region src/agent-tools.d.ts

package/dist/browser/ai.d.ts

@@ -1,9 +1,11 @@
 import {
-  c as BrowserSessionStore,
-  f as BrowserBinding,
+  I as BrowserBinding,
+  f as BrowserSessionStore,
   r as BrowserConnectorSessionOptions,
-  t as BrowserConnector
-} from "../connector-DXursxV5.js";
+  t as BrowserConnector,
+  v as QuickActionBinding,
+  y as QuickActionCommonOptions
+} from "../connector-v2M1zlZp.js";
 import { ToolSet } from "ai";
 import { CodemodeRuntimeHandle } from "@cloudflare/codemode";
 
@@ -15,11 +17,15 @@ interface CreateBrowserToolsOptions {
    * storage — so the tool must be created from inside a Durable Object
    * (e.g. an Agent).
    *
+   * Optional: when omitted, it is resolved from the current Agent via
+   * `getCurrentAgent()`, so inside an Agent method you can just pass `browser`
+   * and `loader`. Pass it explicitly outside an Agent context.
+   *
    * The worker must export the `CodemodeRuntime` class (the
    * `@cloudflare/codemode/vite` plugin does this automatically, or add
    * `export { CodemodeRuntime } from "@cloudflare/codemode"` to your entry).
    */
-  ctx: DurableObjectState;
+  ctx?: DurableObjectState;
   /**
    * WorkerLoader binding for sandboxed code execution.
    *
@@ -68,6 +74,26 @@ interface CreateBrowserToolsOptions {
    * and snippets. Defaults to `"browser"`.
    */
   name?: string;
+  /**
+   * Also expose stateless {@link createQuickActionTools | Quick Action} tools
+   * (`browser_markdown`, `browser_extract`, …) alongside the durable
+   * `browser_execute` tool.
+   *
+   * Enabled by default whenever a Browser Run `browser` binding is available
+   * (they share it). Pass an object to configure them, or `false` to disable.
+   * The Quick Action binding defaults to `browser`; override it via
+   * `quickActions.browser`. When only `cdpUrl` is set (no binding), the
+   * defaults are skipped silently — pass `quickActions: { browser }` to force
+   * them.
+   */
+  quickActions?:
+    | boolean
+    | {
+        browser?: QuickActionBinding;
+        actions?: QuickActionToolName[];
+        maxChars?: number;
+        options?: QuickActionCommonOptions;
+      };
 }
 /**
  * The browser tool's moving parts, for hosts that need more than the tools:
@@ -140,11 +166,70 @@ declare function createBrowserRuntime(
 declare function createBrowserTools(
   options: CreateBrowserToolsOptions
 ): ToolSet;
+/** A Quick Action exposed as an AI SDK tool. */
+type QuickActionToolName =
+  | "markdown"
+  | "extract"
+  | "links"
+  | "scrape"
+  | "content";
+interface CreateQuickActionToolsOptions {
+  /**
+   * Browser Run binding with Quick Actions support (`env.BROWSER`). Requires a
+   * Worker `compatibility_date` of `2026-03-24`+ and `remote: true` for local
+   * `wrangler dev`.
+   */
+  browser: QuickActionBinding;
+  /**
+   * Which tools to expose. Defaults to the text-returning, model-friendly set
+   * (`markdown`, `extract`, `links`, `scrape`). `content` (raw HTML) is opt-in
+   * since it is large and rarely what a model wants.
+   */
+  actions?: QuickActionToolName[];
+  /**
+   * Bound every result to roughly this many characters before returning it to
+   * the model, to protect the context window, preserving each result's shape:
+   * text (markdown/content) is truncated to a string, oversized arrays
+   * (links/scrape) are trimmed but stay arrays, and only an opaque oversized
+   * object degrades to a truncated-preview summary. Set to `0` to disable.
+   * Defaults to 50000.
+   */
+  maxChars?: number;
+  /**
+   * Common Browser Run options merged into every request — e.g. `cookies`,
+   * `authenticate`, or `setExtraHTTPHeaders` for authenticated pages, and
+   * `gotoOptions` / `viewport` for JavaScript-heavy pages. The model only ever
+   * supplies the page (`url`/`html`) and action-specific fields; these
+   * host-supplied options are never exposed to it.
+   */
+  options?: QuickActionCommonOptions;
+}
+/**
+ * Create AI SDK tools for Browser Run [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/):
+ * stateless one-shot browsing (read a page as Markdown, extract structured
+ * data with AI, list links, scrape elements). Unlike `createBrowserTools`,
+ * these need only the `browser` binding — no Durable Object, loader, or
+ * sandbox — so they work from any Worker.
+ *
+ * @example
+ * ```ts
+ * import { createQuickActionTools } from "agents/browser/ai";
+ *
+ * const tools = createQuickActionTools({ browser: this.env.BROWSER });
+ * const result = await generateText({ model, tools, messages });
+ * ```
+ */
+declare function createQuickActionTools(
+  options: CreateQuickActionToolsOptions
+): ToolSet;
 //#endregion
 export {
   BrowserRuntime,
   CreateBrowserToolsOptions,
+  CreateQuickActionToolsOptions,
+  QuickActionToolName,
   createBrowserRuntime,
-  createBrowserTools
+  createBrowserTools,
+  createQuickActionTools
 };
 //# sourceMappingURL=ai.d.ts.map

package/dist/browser/ai.js

@@ -1,8 +1,22 @@
-import { i as DurableBrowserSessionStore, t as BrowserConnector } from "../connector-D6yYzYHg.js";
+import { __DO_NOT_USE_WILL_BREAK__agentContext } from "../internal_context.js";
+import { c as browserLinks, d as browserScrape, i as DurableBrowserSessionStore, l as browserMarkdown, o as browserContent, s as browserExtract, t as BrowserConnector } from "../connector-CrKhowfD.js";
+import { tool } from "ai";
+import { z } from "zod";
 import { DynamicWorkerExecutor, createCodemodeRuntime, truncateResult } from "@cloudflare/codemode";
 //#region src/browser/ai.ts
 let didWarnExperimental = false;
-function connectorOptions(options) {
+let didDebugQuickActionSkip = false;
+/**
+* The Durable Object state to build the runtime in: the explicit `ctx` if
+* given, otherwise the current Agent's `ctx` (via `getCurrentAgent()`), so
+* `createBrowserRuntime` can be called from an Agent method without threading
+* `this.ctx` through.
+*/
+function resolveCtx(options) {
+	if (options.ctx) return options.ctx;
+	return (__DO_NOT_USE_WILL_BREAK__agentContext.getStore()?.agent)?.ctx;
+}
+function connectorOptions(options, ctx) {
 	if (options.cdpUrl) return {
 		cdpUrl: options.cdpUrl,
 		cdpHeaders: options.cdpHeaders,
@@ -11,7 +25,7 @@ function connectorOptions(options) {
 	if (!options.browser) throw new Error("Either 'browser' (Fetcher binding) or 'cdpUrl' must be provided");
 	return {
 		browser: options.browser,
-		store: options.store ?? new DurableBrowserSessionStore(options.ctx.storage),
+		store: options.store ?? new DurableBrowserSessionStore(ctx.storage),
 		session: options.session,
 		timeout: options.timeout
 	};
@@ -45,9 +59,11 @@ function createBrowserRuntime(options) {
 		didWarnExperimental = true;
 		console.warn("[agents/browser] Browser tools are experimental and may change in a future release.");
 	}
-	const connector = new BrowserConnector(options.ctx, connectorOptions(options));
+	const ctx = resolveCtx(options);
+	if (!ctx) throw new Error("createBrowserRuntime requires a Durable Object 'ctx' — pass it explicitly, or call from within an Agent so it can be resolved via getCurrentAgent()");
+	const connector = new BrowserConnector(ctx, connectorOptions(options, ctx));
 	const runtime = createCodemodeRuntime({
-		ctx: options.ctx,
+		ctx,
 		executor: new DynamicWorkerExecutor({
 			loader: options.loader,
 			timeout: options.timeout
@@ -56,10 +72,26 @@ function createBrowserRuntime(options) {
 		name: options.name ?? "browser",
 		transformResult: truncateResult
 	});
+	const tools = { browser_execute: runtime.tool() };
+	if (options.quickActions !== false) {
+		const qa = options.quickActions == null || options.quickActions === true ? {} : options.quickActions;
+		const quickActionBrowser = qa.browser ?? options.browser;
+		if (quickActionBrowser) Object.assign(tools, createQuickActionTools({
+			browser: quickActionBrowser,
+			actions: qa.actions,
+			maxChars: qa.maxChars,
+			options: qa.options
+		}));
+		else if (options.quickActions) throw new Error("quickActions requires a Browser Run binding — set 'browser' (env.BROWSER) or 'quickActions.browser'");
+		else if (!didDebugQuickActionSkip) {
+			didDebugQuickActionSkip = true;
+			console.debug("[agents/browser] Quick Action tools skipped — no Browser Run binding (only 'cdpUrl' is set). Pass 'browser' or 'quickActions.browser' to enable them.");
+		}
+	}
 	return {
 		runtime,
 		connector,
-		tools: { browser_execute: runtime.tool() }
+		tools
 	};
 }
 /**
@@ -92,7 +124,142 @@ function createBrowserRuntime(options) {
 function createBrowserTools(options) {
 	return createBrowserRuntime(options).tools;
 }
+const DEFAULT_QUICK_ACTION_TOOLS = [
+	"markdown",
+	"extract",
+	"links",
+	"scrape"
+];
+const DEFAULT_QUICK_ACTION_MAX_CHARS = 5e4;
+const pageInputSchema = z.object({
+	url: z.string().url().optional().describe("URL of the page to load"),
+	html: z.string().optional().describe("Raw HTML to render instead of loading a URL")
+}).refine((value) => Boolean(value.url) || Boolean(value.html), { message: "Provide either 'url' or 'html'" });
+function toPage(input, options) {
+	const page = input.url ? { url: input.url } : { html: input.html };
+	return {
+		...options,
+		...page
+	};
+}
+function truncate(text, maxChars) {
+	if (maxChars <= 0 || text.length <= maxChars) return text;
+	return `${text.slice(0, maxChars)}\n\n[truncated ${text.length - maxChars} characters]`;
+}
+/**
+* Keep a tool result within a rough character budget so a single browse cannot
+* blow the model's context window — while preserving the result's shape so the
+* model sees a consistent type across calls:
+*
+* - strings (markdown/content) are truncated to a string;
+* - arrays (links/scrape) are trimmed from the end but stay arrays;
+* - only an opaque oversized object (e.g. a sprawling `extract`) degrades to a
+*   `{ truncated, note, preview }` summary, since it cannot be trimmed safely.
+*/
+function boundResult(value, maxChars) {
+	if (maxChars <= 0) return value;
+	if (typeof value === "string") return truncate(value, maxChars);
+	let json;
+	try {
+		json = JSON.stringify(value);
+	} catch {
+		return value;
+	}
+	if (json.length <= maxChars) return value;
+	if (Array.isArray(value)) {
+		const trimmed = boundArray(value, maxChars);
+		if (trimmed.length > 0) return trimmed;
+	}
+	return {
+		truncated: true,
+		note: `Result is too large (${json.length} characters); narrow the request.`,
+		preview: `${json.slice(0, maxChars)}…`
+	};
+}
+/**
+* Take as many leading items as fit within `maxChars` (measured against their
+* JSON length), returning a trimmed array of the same element type. Silent by
+* design: the model gets fewer, valid items rather than a reshaped result.
+*/
+function boundArray(value, maxChars) {
+	const out = [];
+	let size = 2;
+	for (const item of value) {
+		const itemSize = JSON.stringify(item).length + 1;
+		if (size + itemSize > maxChars) break;
+		out.push(item);
+		size += itemSize;
+	}
+	return out;
+}
+/**
+* Create AI SDK tools for Browser Run [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/):
+* stateless one-shot browsing (read a page as Markdown, extract structured
+* data with AI, list links, scrape elements). Unlike `createBrowserTools`,
+* these need only the `browser` binding — no Durable Object, loader, or
+* sandbox — so they work from any Worker.
+*
+* @example
+* ```ts
+* import { createQuickActionTools } from "agents/browser/ai";
+*
+* const tools = createQuickActionTools({ browser: this.env.BROWSER });
+* const result = await generateText({ model, tools, messages });
+* ```
+*/
+function createQuickActionTools(options) {
+	const { browser } = options;
+	const requestOptions = options.options;
+	const enabled = new Set(options.actions ?? DEFAULT_QUICK_ACTION_TOOLS);
+	const maxChars = options.maxChars ?? DEFAULT_QUICK_ACTION_MAX_CHARS;
+	const tools = {};
+	if (enabled.has("markdown")) tools.browser_markdown = tool({
+		description: "Load a web page (or render raw HTML) and return its content as Markdown. Best for reading articles, docs, or any page as text.",
+		inputSchema: pageInputSchema,
+		execute: async (input) => boundResult(await browserMarkdown(browser, toPage(input, requestOptions)), maxChars)
+	});
+	if (enabled.has("extract")) tools.browser_extract = tool({
+		description: "Extract structured data from a web page using AI. Describe what you want in 'prompt'. Passing a JSON Schema in 'schema' is strongly recommended — without one the extractor often fails to produce JSON.",
+		inputSchema: z.object({
+			url: z.string().url().optional().describe("URL of the page to load"),
+			html: z.string().optional().describe("Raw HTML to render instead of loading a URL"),
+			prompt: z.string().optional().describe("What to extract, in natural language"),
+			schema: z.unknown().optional().describe("Optional JSON Schema describing the desired output")
+		}).refine((value) => Boolean(value.url) || Boolean(value.html), { message: "Provide either 'url' or 'html'" }).refine((value) => Boolean(value.prompt) || Boolean(value.schema), { message: "Provide either 'prompt' or 'schema'" }),
+		execute: async (input) => boundResult(await browserExtract(browser, {
+			...toPage(input, requestOptions),
+			prompt: input.prompt,
+			response_format: input.schema ? {
+				type: "json_schema",
+				schema: input.schema
+			} : void 0
+		}), maxChars)
+	});
+	if (enabled.has("links")) tools.browser_links = tool({
+		description: "Return every link found on a web page (including ones not visible). Useful for discovering pages to follow.",
+		inputSchema: pageInputSchema,
+		execute: async (input) => boundResult(await browserLinks(browser, toPage(input, requestOptions)), maxChars)
+	});
+	if (enabled.has("scrape")) tools.browser_scrape = tool({
+		description: "Scrape specific elements from a web page by CSS selector. Returns the matched elements' text, HTML, and attributes.",
+		inputSchema: z.object({
+			url: z.string().url().optional().describe("URL of the page to load"),
+			html: z.string().optional().describe("Raw HTML to render instead of loading a URL"),
+			selectors: z.array(z.string()).min(1).describe("CSS selectors to extract")
+		}).refine((value) => Boolean(value.url) || Boolean(value.html), { message: "Provide either 'url' or 'html'" }),
+		execute: async (input) => boundResult(await browserScrape(browser, {
+			...toPage(input, requestOptions),
+			elements: input.selectors.map((selector) => ({ selector }))
+		}), maxChars)
+	});
+	if (enabled.has("content")) tools.browser_content = tool({
+		description: "Load a web page and return its fully rendered HTML (after JavaScript runs). Prefer 'browser_markdown' unless you need the raw HTML.",
+		inputSchema: pageInputSchema,
+		execute: async (input) => boundResult(await browserContent(browser, toPage(input, requestOptions)), maxChars)
+	});
+	return tools;
+}
 //#endregion
-export { createBrowserRuntime, createBrowserTools };
+export { createBrowserRuntime, createBrowserTools, createQuickActionTools };
 
 //# sourceMappingURL=ai.js.map

package/dist/browser/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","names":[],"sources":["../../src/browser/ai.ts"],"sourcesContent":["import type { ToolSet } from \"ai\";\nimport {\n  createCodemodeRuntime,\n  DynamicWorkerExecutor,\n  truncateResult,\n  type CodemodeRuntimeHandle\n} from \"@cloudflare/codemode\";\nimport type { BrowserBinding } from \"./browser-run\";\nimport {\n  BrowserConnector,\n  type BrowserConnectorOptions,\n  type BrowserConnectorSessionOptions\n} from \"./connector\";\nimport {\n  DurableBrowserSessionStore,\n  type BrowserSessionStore\n} from \"./session-manager\";\n\nexport interface CreateBrowserToolsOptions {\n  /**\n   * Durable Object state. The codemode runtime that backs the browser tool\n   * lives in a facet of this DO, and browser session ids are stored in its\n   * storage — so the tool must be created from inside a Durable Object\n   * (e.g. an Agent).\n   *\n   * The worker must export the `CodemodeRuntime` class (the\n   * `@cloudflare/codemode/vite` plugin does this automatically, or add\n   * `export { CodemodeRuntime } from \"@cloudflare/codemode\"` to your entry).\n   */\n  ctx: DurableObjectState;\n\n  /**\n   * WorkerLoader binding for sandboxed code execution.\n   *\n   * Requires `\"worker_loaders\": [{ \"binding\": \"LOADER\" }]` in wrangler.jsonc.\n   */\n  loader: WorkerLoader;\n\n  /**\n   * Browser Rendering binding (Fetcher).\n   *\n   * This is the primary way to connect — works both locally in\n   * `wrangler dev` and when deployed to Cloudflare Workers.\n   *\n   * Requires `\"browser\": { \"binding\": \"BROWSER\" }` in wrangler.jsonc.\n   */\n  browser?: BrowserBinding;\n\n  /**\n   * Optional CDP base URL override (e.g. `http://localhost:9222`).\n   *\n   * Use when connecting to a manually managed Chrome instance or\n   * a remote CDP endpoint behind a tunnel.\n   */\n  cdpUrl?: string;\n\n  /**\n   * Headers to send with CDP URL discovery requests.\n   * Useful when the CDP endpoint requires authentication\n   * (e.g. Cloudflare Access headers).\n   */\n  cdpHeaders?: Record<string, string>;\n\n  /**\n   * Browser session lifecycle (binding-backed only). Defaults to one fresh\n   * session per codemode execution (`one-shot`).\n   */\n  session?: BrowserConnectorSessionOptions;\n\n  /**\n   * Durable store for Browser Run session ids. Defaults to a\n   * {@link DurableBrowserSessionStore} over `ctx.storage`.\n   */\n  store?: BrowserSessionStore;\n\n  /**\n   * Sandbox execution timeout in milliseconds. Defaults to 30000 (30s).\n   * Also used as the per-CDP-command timeout.\n   */\n  timeout?: number;\n\n  /**\n   * Codemode runtime name — the durable identity of the tool's executions\n   * and snippets. Defaults to `\"browser\"`.\n   */\n  name?: string;\n}\n\n/**\n * The browser tool's moving parts, for hosts that need more than the tools:\n *\n * - `runtime` — the codemode runtime handle (approve/reject paused runs,\n *   `expirePaused`, audit via `executions()`, snippets).\n * - `connector` — host-side session helpers: `sessionInfo()`,\n *   `closeSession()`, and `sweep()` for a recurring cleanup task.\n * - `tools` — what `createBrowserTools` returns.\n */\nexport interface BrowserRuntime {\n  runtime: CodemodeRuntimeHandle;\n  connector: BrowserConnector;\n  tools: ToolSet;\n}\n\nlet didWarnExperimental = false;\n\nfunction connectorOptions(\n  options: CreateBrowserToolsOptions\n): BrowserConnectorOptions {\n  if (options.cdpUrl) {\n    return {\n      cdpUrl: options.cdpUrl,\n      cdpHeaders: options.cdpHeaders,\n      timeout: options.timeout\n    };\n  }\n  if (!options.browser) {\n    throw new Error(\n      \"Either 'browser' (Fetcher binding) or 'cdpUrl' must be provided\"\n    );\n  }\n  return {\n    browser: options.browser,\n    store: options.store ?? new DurableBrowserSessionStore(options.ctx.storage),\n    session: options.session,\n    timeout: options.timeout\n  };\n}\n\n/**\n * Create the browser codemode runtime: the `browser_execute` tool plus the\n * runtime handle and connector for host-side wiring (approvals, session info,\n * sweeps).\n *\n * @example\n * ```ts\n * export class MyAgent extends Agent<Env> {\n *   get browser() {\n *     return createBrowserRuntime({\n *       ctx: this.ctx,\n *       browser: this.env.BROWSER,\n *       loader: this.env.LOADER,\n *       session: { mode: \"dynamic\" }\n *     });\n *   }\n *\n *   @callable()\n *   async closeBrowserSession() {\n *     await this.browser.connector.closeSession();\n *   }\n * }\n * ```\n */\nexport function createBrowserRuntime(\n  options: CreateBrowserToolsOptions\n): BrowserRuntime {\n  if (!didWarnExperimental) {\n    didWarnExperimental = true;\n    console.warn(\n      \"[agents/browser] Browser tools are experimental and may change in a future release.\"\n    );\n  }\n\n  const connector = new BrowserConnector(\n    options.ctx,\n    connectorOptions(options)\n  );\n  const runtime = createCodemodeRuntime({\n    ctx: options.ctx,\n    executor: new DynamicWorkerExecutor({\n      loader: options.loader,\n      timeout: options.timeout\n    }),\n    connectors: [connector],\n    name: options.name ?? \"browser\",\n    transformResult: truncateResult\n  });\n\n  return {\n    runtime,\n    connector,\n    tools: { browser_execute: runtime.tool() }\n  };\n}\n\n/**\n * Create AI SDK tools for browser automation via CDP code mode.\n *\n * Returns a `ToolSet` with a single durable `browser_execute` tool backed by\n * a codemode runtime: the model writes TypeScript against the `cdp` connector\n * (`cdp.send`, `cdp.attachToTarget`, `cdp.spec`, …), executions are recorded\n * for abort-and-replay, and browser sessions survive pauses.\n *\n * @example\n * ```ts\n * import { createBrowserTools } from \"agents/browser/ai\";\n * import { generateText } from \"ai\";\n *\n * // inside a Durable Object / Agent:\n * const browserTools = createBrowserTools({\n *   ctx: this.ctx,\n *   browser: this.env.BROWSER,\n *   loader: this.env.LOADER,\n * });\n *\n * const result = await generateText({\n *   model,\n *   tools: { ...browserTools, ...otherTools },\n *   messages,\n * });\n * ```\n */\nexport function createBrowserTools(\n  options: CreateBrowserToolsOptions\n): ToolSet {\n  return createBrowserRuntime(options).tools;\n}\n"],"mappings":";;;AAuGA,IAAI,sBAAsB;AAE1B,SAAS,iBACP,SACyB;CACzB,IAAI,QAAQ,QACV,OAAO;EACL,QAAQ,QAAQ;EAChB,YAAY,QAAQ;EACpB,SAAS,QAAQ;CACnB;CAEF,IAAI,CAAC,QAAQ,SACX,MAAM,IAAI,MACR,iEACF;CAEF,OAAO;EACL,SAAS,QAAQ;EACjB,OAAO,QAAQ,SAAS,IAAI,2BAA2B,QAAQ,IAAI,OAAO;EAC1E,SAAS,QAAQ;EACjB,SAAS,QAAQ;CACnB;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,qBACd,SACgB;CAChB,IAAI,CAAC,qBAAqB;EACxB,sBAAsB;EACtB,QAAQ,KACN,qFACF;CACF;CAEA,MAAM,YAAY,IAAI,iBACpB,QAAQ,KACR,iBAAiB,OAAO,CAC1B;CACA,MAAM,UAAU,sBAAsB;EACpC,KAAK,QAAQ;EACb,UAAU,IAAI,sBAAsB;GAClC,QAAQ,QAAQ;GAChB,SAAS,QAAQ;EACnB,CAAC;EACD,YAAY,CAAC,SAAS;EACtB,MAAM,QAAQ,QAAQ;EACtB,iBAAiB;CACnB,CAAC;CAED,OAAO;EACL;EACA;EACA,OAAO,EAAE,iBAAiB,QAAQ,KAAK,EAAE;CAC3C;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,mBACd,SACS;CACT,OAAO,qBAAqB,OAAO,CAAC,CAAC;AACvC"}
+{"version":3,"file":"ai.js","names":["agentContext"],"sources":["../../src/browser/ai.ts"],"sourcesContent":["import { tool, type ToolSet } from \"ai\";\nimport { z } from \"zod\";\nimport {\n  createCodemodeRuntime,\n  DynamicWorkerExecutor,\n  truncateResult,\n  type CodemodeRuntimeHandle\n} from \"@cloudflare/codemode\";\nimport { __DO_NOT_USE_WILL_BREAK__agentContext as agentContext } from \"../internal_context\";\nimport type { BrowserBinding } from \"./browser-run\";\nimport {\n  browserContent,\n  browserExtract,\n  browserLinks,\n  browserMarkdown,\n  browserScrape,\n  type QuickActionBinding,\n  type QuickActionCommonOptions,\n  type QuickActionPage\n} from \"./quick-actions\";\nimport {\n  BrowserConnector,\n  type BrowserConnectorOptions,\n  type BrowserConnectorSessionOptions\n} from \"./connector\";\nimport {\n  DurableBrowserSessionStore,\n  type BrowserSessionStore\n} from \"./session-manager\";\n\nexport interface CreateBrowserToolsOptions {\n  /**\n   * Durable Object state. The codemode runtime that backs the browser tool\n   * lives in a facet of this DO, and browser session ids are stored in its\n   * storage — so the tool must be created from inside a Durable Object\n   * (e.g. an Agent).\n   *\n   * Optional: when omitted, it is resolved from the current Agent via\n   * `getCurrentAgent()`, so inside an Agent method you can just pass `browser`\n   * and `loader`. Pass it explicitly outside an Agent context.\n   *\n   * The worker must export the `CodemodeRuntime` class (the\n   * `@cloudflare/codemode/vite` plugin does this automatically, or add\n   * `export { CodemodeRuntime } from \"@cloudflare/codemode\"` to your entry).\n   */\n  ctx?: DurableObjectState;\n\n  /**\n   * WorkerLoader binding for sandboxed code execution.\n   *\n   * Requires `\"worker_loaders\": [{ \"binding\": \"LOADER\" }]` in wrangler.jsonc.\n   */\n  loader: WorkerLoader;\n\n  /**\n   * Browser Rendering binding (Fetcher).\n   *\n   * This is the primary way to connect — works both locally in\n   * `wrangler dev` and when deployed to Cloudflare Workers.\n   *\n   * Requires `\"browser\": { \"binding\": \"BROWSER\" }` in wrangler.jsonc.\n   */\n  browser?: BrowserBinding;\n\n  /**\n   * Optional CDP base URL override (e.g. `http://localhost:9222`).\n   *\n   * Use when connecting to a manually managed Chrome instance or\n   * a remote CDP endpoint behind a tunnel.\n   */\n  cdpUrl?: string;\n\n  /**\n   * Headers to send with CDP URL discovery requests.\n   * Useful when the CDP endpoint requires authentication\n   * (e.g. Cloudflare Access headers).\n   */\n  cdpHeaders?: Record<string, string>;\n\n  /**\n   * Browser session lifecycle (binding-backed only). Defaults to one fresh\n   * session per codemode execution (`one-shot`).\n   */\n  session?: BrowserConnectorSessionOptions;\n\n  /**\n   * Durable store for Browser Run session ids. Defaults to a\n   * {@link DurableBrowserSessionStore} over `ctx.storage`.\n   */\n  store?: BrowserSessionStore;\n\n  /**\n   * Sandbox execution timeout in milliseconds. Defaults to 30000 (30s).\n   * Also used as the per-CDP-command timeout.\n   */\n  timeout?: number;\n\n  /**\n   * Codemode runtime name — the durable identity of the tool's executions\n   * and snippets. Defaults to `\"browser\"`.\n   */\n  name?: string;\n\n  /**\n   * Also expose stateless {@link createQuickActionTools | Quick Action} tools\n   * (`browser_markdown`, `browser_extract`, …) alongside the durable\n   * `browser_execute` tool.\n   *\n   * Enabled by default whenever a Browser Run `browser` binding is available\n   * (they share it). Pass an object to configure them, or `false` to disable.\n   * The Quick Action binding defaults to `browser`; override it via\n   * `quickActions.browser`. When only `cdpUrl` is set (no binding), the\n   * defaults are skipped silently — pass `quickActions: { browser }` to force\n   * them.\n   */\n  quickActions?:\n    | boolean\n    | {\n        browser?: QuickActionBinding;\n        actions?: QuickActionToolName[];\n        maxChars?: number;\n        options?: QuickActionCommonOptions;\n      };\n}\n\n/**\n * The browser tool's moving parts, for hosts that need more than the tools:\n *\n * - `runtime` — the codemode runtime handle (approve/reject paused runs,\n *   `expirePaused`, audit via `executions()`, snippets).\n * - `connector` — host-side session helpers: `sessionInfo()`,\n *   `closeSession()`, and `sweep()` for a recurring cleanup task.\n * - `tools` — what `createBrowserTools` returns.\n */\nexport interface BrowserRuntime {\n  runtime: CodemodeRuntimeHandle;\n  connector: BrowserConnector;\n  tools: ToolSet;\n}\n\nlet didWarnExperimental = false;\nlet didDebugQuickActionSkip = false;\n\n/**\n * The Durable Object state to build the runtime in: the explicit `ctx` if\n * given, otherwise the current Agent's `ctx` (via `getCurrentAgent()`), so\n * `createBrowserRuntime` can be called from an Agent method without threading\n * `this.ctx` through.\n */\nfunction resolveCtx(\n  options: CreateBrowserToolsOptions\n): DurableObjectState | undefined {\n  if (options.ctx) return options.ctx;\n  const agent = agentContext.getStore()?.agent as\n    | { ctx?: DurableObjectState }\n    | undefined;\n  return agent?.ctx;\n}\n\nfunction connectorOptions(\n  options: CreateBrowserToolsOptions,\n  ctx: DurableObjectState\n): BrowserConnectorOptions {\n  if (options.cdpUrl) {\n    return {\n      cdpUrl: options.cdpUrl,\n      cdpHeaders: options.cdpHeaders,\n      timeout: options.timeout\n    };\n  }\n  if (!options.browser) {\n    throw new Error(\n      \"Either 'browser' (Fetcher binding) or 'cdpUrl' must be provided\"\n    );\n  }\n  return {\n    browser: options.browser,\n    store: options.store ?? new DurableBrowserSessionStore(ctx.storage),\n    session: options.session,\n    timeout: options.timeout\n  };\n}\n\n/**\n * Create the browser codemode runtime: the `browser_execute` tool plus the\n * runtime handle and connector for host-side wiring (approvals, session info,\n * sweeps).\n *\n * @example\n * ```ts\n * export class MyAgent extends Agent<Env> {\n *   get browser() {\n *     return createBrowserRuntime({\n *       ctx: this.ctx,\n *       browser: this.env.BROWSER,\n *       loader: this.env.LOADER,\n *       session: { mode: \"dynamic\" }\n *     });\n *   }\n *\n *   @callable()\n *   async closeBrowserSession() {\n *     await this.browser.connector.closeSession();\n *   }\n * }\n * ```\n */\nexport function createBrowserRuntime(\n  options: CreateBrowserToolsOptions\n): BrowserRuntime {\n  if (!didWarnExperimental) {\n    didWarnExperimental = true;\n    console.warn(\n      \"[agents/browser] Browser tools are experimental and may change in a future release.\"\n    );\n  }\n\n  const ctx = resolveCtx(options);\n  if (!ctx) {\n    throw new Error(\n      \"createBrowserRuntime requires a Durable Object 'ctx' — pass it explicitly, or call from within an Agent so it can be resolved via getCurrentAgent()\"\n    );\n  }\n\n  const connector = new BrowserConnector(ctx, connectorOptions(options, ctx));\n  const runtime = createCodemodeRuntime({\n    ctx,\n    executor: new DynamicWorkerExecutor({\n      loader: options.loader,\n      timeout: options.timeout\n    }),\n    connectors: [connector],\n    name: options.name ?? \"browser\",\n    transformResult: truncateResult\n  });\n\n  const tools: ToolSet = { browser_execute: runtime.tool() };\n\n  // Quick Actions ride the same `browser` binding, so they are on by default.\n  // `env.BROWSER` satisfies both the CDP `BrowserBinding` (fetch) and the\n  // `QuickActionBinding` (quickAction) surfaces; our narrower option type only\n  // sees the former, so reuse it here unless an explicit binding wins.\n  if (options.quickActions !== false) {\n    const qa =\n      options.quickActions == null || options.quickActions === true\n        ? {}\n        : options.quickActions;\n    const quickActionBrowser =\n      qa.browser ??\n      (options.browser as unknown as QuickActionBinding | undefined);\n    if (quickActionBrowser) {\n      Object.assign(\n        tools,\n        createQuickActionTools({\n          browser: quickActionBrowser,\n          actions: qa.actions,\n          maxChars: qa.maxChars,\n          options: qa.options\n        })\n      );\n    } else if (options.quickActions) {\n      // Explicitly requested but no binding to back them.\n      throw new Error(\n        \"quickActions requires a Browser Run binding — set 'browser' (env.BROWSER) or 'quickActions.browser'\"\n      );\n    } else if (!didDebugQuickActionSkip) {\n      // Defaulted on, but only `cdpUrl` is set: there is no binding to call\n      // Quick Actions through, so they are skipped. Surface it once so a user\n      // expecting `browser_markdown` et al. isn't left wondering.\n      didDebugQuickActionSkip = true;\n      console.debug(\n        \"[agents/browser] Quick Action tools skipped — no Browser Run binding (only 'cdpUrl' is set). Pass 'browser' or 'quickActions.browser' to enable them.\"\n      );\n    }\n  }\n\n  return { runtime, connector, tools };\n}\n\n/**\n * Create AI SDK tools for browser automation via CDP code mode.\n *\n * Returns a `ToolSet` with a single durable `browser_execute` tool backed by\n * a codemode runtime: the model writes TypeScript against the `cdp` connector\n * (`cdp.send`, `cdp.attachToTarget`, `cdp.spec`, …), executions are recorded\n * for abort-and-replay, and browser sessions survive pauses.\n *\n * @example\n * ```ts\n * import { createBrowserTools } from \"agents/browser/ai\";\n * import { generateText } from \"ai\";\n *\n * // inside a Durable Object / Agent:\n * const browserTools = createBrowserTools({\n *   ctx: this.ctx,\n *   browser: this.env.BROWSER,\n *   loader: this.env.LOADER,\n * });\n *\n * const result = await generateText({\n *   model,\n *   tools: { ...browserTools, ...otherTools },\n *   messages,\n * });\n * ```\n */\nexport function createBrowserTools(\n  options: CreateBrowserToolsOptions\n): ToolSet {\n  return createBrowserRuntime(options).tools;\n}\n\n/** A Quick Action exposed as an AI SDK tool. */\nexport type QuickActionToolName =\n  | \"markdown\"\n  | \"extract\"\n  | \"links\"\n  | \"scrape\"\n  | \"content\";\n\nexport interface CreateQuickActionToolsOptions {\n  /**\n   * Browser Run binding with Quick Actions support (`env.BROWSER`). Requires a\n   * Worker `compatibility_date` of `2026-03-24`+ and `remote: true` for local\n   * `wrangler dev`.\n   */\n  browser: QuickActionBinding;\n\n  /**\n   * Which tools to expose. Defaults to the text-returning, model-friendly set\n   * (`markdown`, `extract`, `links`, `scrape`). `content` (raw HTML) is opt-in\n   * since it is large and rarely what a model wants.\n   */\n  actions?: QuickActionToolName[];\n\n  /**\n   * Bound every result to roughly this many characters before returning it to\n   * the model, to protect the context window, preserving each result's shape:\n   * text (markdown/content) is truncated to a string, oversized arrays\n   * (links/scrape) are trimmed but stay arrays, and only an opaque oversized\n   * object degrades to a truncated-preview summary. Set to `0` to disable.\n   * Defaults to 50000.\n   */\n  maxChars?: number;\n\n  /**\n   * Common Browser Run options merged into every request — e.g. `cookies`,\n   * `authenticate`, or `setExtraHTTPHeaders` for authenticated pages, and\n   * `gotoOptions` / `viewport` for JavaScript-heavy pages. The model only ever\n   * supplies the page (`url`/`html`) and action-specific fields; these\n   * host-supplied options are never exposed to it.\n   */\n  options?: QuickActionCommonOptions;\n}\n\nconst DEFAULT_QUICK_ACTION_TOOLS: QuickActionToolName[] = [\n  \"markdown\",\n  \"extract\",\n  \"links\",\n  \"scrape\"\n];\n\nconst DEFAULT_QUICK_ACTION_MAX_CHARS = 50_000;\n\nconst pageInputSchema = z\n  .object({\n    url: z.string().url().optional().describe(\"URL of the page to load\"),\n    html: z\n      .string()\n      .optional()\n      .describe(\"Raw HTML to render instead of loading a URL\")\n  })\n  .refine((value) => Boolean(value.url) || Boolean(value.html), {\n    message: \"Provide either 'url' or 'html'\"\n  });\n\nfunction toPage(\n  input: { url?: string; html?: string },\n  options?: QuickActionCommonOptions\n): QuickActionPage {\n  const page = input.url ? { url: input.url } : { html: input.html as string };\n  return { ...options, ...page } as QuickActionPage;\n}\n\nfunction truncate(text: string, maxChars: number): string {\n  if (maxChars <= 0 || text.length <= maxChars) return text;\n  return `${text.slice(0, maxChars)}\\n\\n[truncated ${text.length - maxChars} characters]`;\n}\n\n/**\n * Keep a tool result within a rough character budget so a single browse cannot\n * blow the model's context window — while preserving the result's shape so the\n * model sees a consistent type across calls:\n *\n * - strings (markdown/content) are truncated to a string;\n * - arrays (links/scrape) are trimmed from the end but stay arrays;\n * - only an opaque oversized object (e.g. a sprawling `extract`) degrades to a\n *   `{ truncated, note, preview }` summary, since it cannot be trimmed safely.\n */\nfunction boundResult(value: unknown, maxChars: number): unknown {\n  if (maxChars <= 0) return value;\n  if (typeof value === \"string\") return truncate(value, maxChars);\n  let json: string;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    return value;\n  }\n  if (json.length <= maxChars) return value;\n  if (Array.isArray(value)) {\n    const trimmed = boundArray(value, maxChars);\n    // If even the first element overflows the budget, `trimmed` is empty —\n    // returning `[]` would read as \"no results\" rather than \"too large\", so\n    // fall through to the explicit truncated-preview summary instead.\n    if (trimmed.length > 0) return trimmed;\n  }\n  return {\n    truncated: true,\n    note: `Result is too large (${json.length} characters); narrow the request.`,\n    preview: `${json.slice(0, maxChars)}…`\n  };\n}\n\n/**\n * Take as many leading items as fit within `maxChars` (measured against their\n * JSON length), returning a trimmed array of the same element type. Silent by\n * design: the model gets fewer, valid items rather than a reshaped result.\n */\nfunction boundArray(value: unknown[], maxChars: number): unknown[] {\n  const out: unknown[] = [];\n  let size = 2; // the enclosing \"[]\"\n  for (const item of value) {\n    const itemSize = JSON.stringify(item).length + 1; // + a separating comma\n    if (size + itemSize > maxChars) break;\n    out.push(item);\n    size += itemSize;\n  }\n  return out;\n}\n\n/**\n * Create AI SDK tools for Browser Run [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/):\n * stateless one-shot browsing (read a page as Markdown, extract structured\n * data with AI, list links, scrape elements). Unlike `createBrowserTools`,\n * these need only the `browser` binding — no Durable Object, loader, or\n * sandbox — so they work from any Worker.\n *\n * @example\n * ```ts\n * import { createQuickActionTools } from \"agents/browser/ai\";\n *\n * const tools = createQuickActionTools({ browser: this.env.BROWSER });\n * const result = await generateText({ model, tools, messages });\n * ```\n */\nexport function createQuickActionTools(\n  options: CreateQuickActionToolsOptions\n): ToolSet {\n  const { browser } = options;\n  const requestOptions = options.options;\n  const enabled = new Set(options.actions ?? DEFAULT_QUICK_ACTION_TOOLS);\n  const maxChars = options.maxChars ?? DEFAULT_QUICK_ACTION_MAX_CHARS;\n  const tools: ToolSet = {};\n\n  if (enabled.has(\"markdown\")) {\n    tools.browser_markdown = tool({\n      description:\n        \"Load a web page (or render raw HTML) and return its content as Markdown. Best for reading articles, docs, or any page as text.\",\n      inputSchema: pageInputSchema,\n      execute: async (input) =>\n        boundResult(\n          await browserMarkdown(browser, toPage(input, requestOptions)),\n          maxChars\n        )\n    });\n  }\n\n  if (enabled.has(\"extract\")) {\n    tools.browser_extract = tool({\n      description:\n        \"Extract structured data from a web page using AI. Describe what you want in 'prompt'. Passing a JSON Schema in 'schema' is strongly recommended — without one the extractor often fails to produce JSON.\",\n      inputSchema: z\n        .object({\n          url: z.string().url().optional().describe(\"URL of the page to load\"),\n          html: z\n            .string()\n            .optional()\n            .describe(\"Raw HTML to render instead of loading a URL\"),\n          prompt: z\n            .string()\n            .optional()\n            .describe(\"What to extract, in natural language\"),\n          schema: z\n            .unknown()\n            .optional()\n            .describe(\"Optional JSON Schema describing the desired output\")\n        })\n        .refine((value) => Boolean(value.url) || Boolean(value.html), {\n          message: \"Provide either 'url' or 'html'\"\n        })\n        .refine((value) => Boolean(value.prompt) || Boolean(value.schema), {\n          message: \"Provide either 'prompt' or 'schema'\"\n        }),\n      execute: async (input) =>\n        boundResult(\n          await browserExtract(browser, {\n            ...toPage(input, requestOptions),\n            prompt: input.prompt,\n            response_format: input.schema\n              ? { type: \"json_schema\", schema: input.schema }\n              : undefined\n          }),\n          maxChars\n        )\n    });\n  }\n\n  if (enabled.has(\"links\")) {\n    tools.browser_links = tool({\n      description:\n        \"Return every link found on a web page (including ones not visible). Useful for discovering pages to follow.\",\n      inputSchema: pageInputSchema,\n      execute: async (input) =>\n        boundResult(\n          await browserLinks(browser, toPage(input, requestOptions)),\n          maxChars\n        )\n    });\n  }\n\n  if (enabled.has(\"scrape\")) {\n    tools.browser_scrape = tool({\n      description:\n        \"Scrape specific elements from a web page by CSS selector. Returns the matched elements' text, HTML, and attributes.\",\n      inputSchema: z\n        .object({\n          url: z.string().url().optional().describe(\"URL of the page to load\"),\n          html: z\n            .string()\n            .optional()\n            .describe(\"Raw HTML to render instead of loading a URL\"),\n          selectors: z\n            .array(z.string())\n            .min(1)\n            .describe(\"CSS selectors to extract\")\n        })\n        .refine((value) => Boolean(value.url) || Boolean(value.html), {\n          message: \"Provide either 'url' or 'html'\"\n        }),\n      execute: async (input) =>\n        boundResult(\n          await browserScrape(browser, {\n            ...toPage(input, requestOptions),\n            elements: input.selectors.map((selector) => ({ selector }))\n          }),\n          maxChars\n        )\n    });\n  }\n\n  if (enabled.has(\"content\")) {\n    tools.browser_content = tool({\n      description:\n        \"Load a web page and return its fully rendered HTML (after JavaScript runs). Prefer 'browser_markdown' unless you need the raw HTML.\",\n      inputSchema: pageInputSchema,\n      execute: async (input) =>\n        boundResult(\n          await browserContent(browser, toPage(input, requestOptions)),\n          maxChars\n        )\n    });\n  }\n\n  return tools;\n}\n"],"mappings":"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"}

package/dist/browser/index.d.ts

@@ -1,30 +1,56 @@
 import {
-  C as CdpSendOptions,
-  S as CdpAttachOptions,
-  T as connectUrl,
-  _ as connectBrowser,
+  A as browserMarkdown,
+  B as BrowserTargetInfo,
+  C as QuickActionScrapeInput,
+  D as browserContent,
+  E as QuickActionSnapshot,
+  F as runQuickAction,
+  G as deleteBrowserSession,
+  H as connectBrowser,
+  I as BrowserBinding,
+  J as CdpAttachOptions,
+  K as getBrowserRecording,
+  L as BrowserRecording,
+  M as browserScrape,
+  N as browserScreenshot,
+  O as browserExtract,
+  P as browserSnapshot,
+  R as BrowserRenderingError,
+  S as QuickActionPage,
+  T as QuickActionScreenshotInput,
+  U as connectBrowserSession,
+  V as ConnectBrowserOptions,
+  W as createBrowserSession,
+  X as CdpSession,
+  Y as CdpSendOptions,
+  Z as connectUrl,
+  _ as QuickActionBinary,
   a as BrowserConnectorSweepResult,
-  b as deleteBrowserSession,
-  c as BrowserSessionStore,
-  d as StoredBrowserSession,
-  f as BrowserBinding,
-  g as ConnectBrowserOptions,
-  h as BrowserTargetInfo,
+  b as QuickActionExtractInput,
+  c as BrowserLiveViewUrl,
+  d as BrowserSessionLock,
+  f as BrowserSessionStore,
+  g as QuickAction,
+  h as StoredBrowserSession,
   i as BrowserConnectorSweepOptions,
-  l as DEFAULT_SWEEP_IDLE_MS,
-  m as BrowserSessionInfo,
+  j as browserPdf,
+  k as browserLinks,
+  l as DEFAULT_EXEC_SWEEP_IDLE_MS,
+  m as DurableBrowserSessionStore,
   n as BrowserConnectorOptions,
-  o as DEFAULT_EXEC_SWEEP_IDLE_MS,
-  p as BrowserRenderingError,
+  o as BrowserLiveView,
+  p as DEFAULT_SWEEP_IDLE_MS,
+  q as listBrowserTargets,
   r as BrowserConnectorSessionOptions,
-  s as BrowserSessionLock,
+  s as BrowserLiveViewTarget,
   t as BrowserConnector,
-  u as DurableBrowserSessionStore,
-  v as connectBrowserSession,
-  w as CdpSession,
-  x as listBrowserTargets,
-  y as createBrowserSession
-} from "../connector-DXursxV5.js";
+  u as LiveViewMode,
+  v as QuickActionBinding,
+  w as QuickActionScrapeResult,
+  x as QuickActionInput,
+  y as QuickActionCommonOptions,
+  z as BrowserSessionInfo
+} from "../connector-v2M1zlZp.js";
 import { CodemodeRuntime } from "@cloudflare/codemode";
 
 //#region src/browser/spec.d.ts
@@ -67,6 +93,10 @@ export {
   type BrowserConnectorSessionOptions,
   type BrowserConnectorSweepOptions,
   type BrowserConnectorSweepResult,
+  type BrowserLiveView,
+  type BrowserLiveViewTarget,
+  type BrowserLiveViewUrl,
+  type BrowserRecording,
   BrowserRenderingError,
   type BrowserSessionInfo,
   type BrowserSessionLock,
@@ -81,14 +111,36 @@ export {
   DEFAULT_EXEC_SWEEP_IDLE_MS,
   DEFAULT_SWEEP_IDLE_MS,
   DurableBrowserSessionStore,
+  type LiveViewMode,
+  type QuickAction,
+  type QuickActionBinary,
+  type QuickActionBinding,
+  type QuickActionCommonOptions,
+  type QuickActionExtractInput,
+  type QuickActionInput,
+  type QuickActionPage,
+  type QuickActionScrapeInput,
+  type QuickActionScrapeResult,
+  type QuickActionScreenshotInput,
+  type QuickActionSnapshot,
   type SearchableCdpSpec,
   type StoredBrowserSession,
+  browserContent,
+  browserExtract,
+  browserLinks,
+  browserMarkdown,
+  browserPdf,
+  browserScrape,
+  browserScreenshot,
+  browserSnapshot,
   connectBrowser,
   connectBrowserSession,
   connectUrl,
   createBrowserSession,
   deleteBrowserSession,
+  getBrowserRecording,
   listBrowserTargets,
-  loadCdpSpec
+  loadCdpSpec,
+  runQuickAction
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/browser/index.js

@@ -1,3 +1,3 @@
-import { a as loadCdpSpec, c as connectBrowserSession, d as listBrowserTargets, f as CdpSession, i as DurableBrowserSessionStore, l as createBrowserSession, n as DEFAULT_EXEC_SWEEP_IDLE_MS, o as BrowserRenderingError, p as connectUrl, r as DEFAULT_SWEEP_IDLE_MS, s as connectBrowser, t as BrowserConnector, u as deleteBrowserSession } from "../connector-D6yYzYHg.js";
+import { C as connectUrl, S as CdpSession, _ as connectBrowserSession, a as loadCdpSpec, b as getBrowserRecording, c as browserLinks, d as browserScrape, f as browserScreenshot, g as connectBrowser, h as BrowserRenderingError, i as DurableBrowserSessionStore, l as browserMarkdown, m as runQuickAction, n as DEFAULT_EXEC_SWEEP_IDLE_MS, o as browserContent, p as browserSnapshot, r as DEFAULT_SWEEP_IDLE_MS, s as browserExtract, t as BrowserConnector, u as browserPdf, v as createBrowserSession, x as listBrowserTargets, y as deleteBrowserSession } from "../connector-CrKhowfD.js";
 import { CodemodeRuntime } from "@cloudflare/codemode";
-export { BrowserConnector, BrowserRenderingError, CdpSession, CodemodeRuntime, DEFAULT_EXEC_SWEEP_IDLE_MS, DEFAULT_SWEEP_IDLE_MS, DurableBrowserSessionStore, connectBrowser, connectBrowserSession, connectUrl, createBrowserSession, deleteBrowserSession, listBrowserTargets, loadCdpSpec };
+export { BrowserConnector, BrowserRenderingError, CdpSession, CodemodeRuntime, DEFAULT_EXEC_SWEEP_IDLE_MS, DEFAULT_SWEEP_IDLE_MS, DurableBrowserSessionStore, browserContent, browserExtract, browserLinks, browserMarkdown, browserPdf, browserScrape, browserScreenshot, browserSnapshot, connectBrowser, connectBrowserSession, connectUrl, createBrowserSession, deleteBrowserSession, getBrowserRecording, listBrowserTargets, loadCdpSpec, runQuickAction };

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

@@ -10,6 +10,10 @@ import { ServerTool } from "@tanstack/ai";
  * writes TypeScript against the `cdp` connector and browser sessions
  * survive pauses.
  *
+ * The stateless Quick Action tools are not surfaced through this TanStack
+ * wrapper (it exposes only `browser_execute`); use `createQuickActionTools`
+ * from `agents/browser/ai` if you want them.
+ *
  * @example
  * ```ts
  * import { createBrowserTools } from "agents/browser/tanstack-ai";

package/dist/browser/tanstack-ai.js

@@ -10,6 +10,10 @@ import { toolDefinition } from "@tanstack/ai";
 * writes TypeScript against the `cdp` connector and browser sessions
 * survive pauses.
 *
+* The stateless Quick Action tools are not surfaced through this TanStack
+* wrapper (it exposes only `browser_execute`); use `createQuickActionTools`
+* from `agents/browser/ai` if you want them.
+*
 * @example
 * ```ts
 * import { createBrowserTools } from "agents/browser/tanstack-ai";
@@ -30,7 +34,10 @@ import { toolDefinition } from "@tanstack/ai";
 * ```
 */
 function createBrowserTools(options) {
-	const { tools } = createBrowserRuntime(options);
+	const { tools } = createBrowserRuntime({
+		...options,
+		quickActions: false
+	});
 	const executeTool = tools.browser_execute;
 	return [toolDefinition({
 		name: "browser_execute",