agents 0.27.0 → 0.28.0

package/dist/web/fetch/tools/tanstack-ai.d.ts

@@ -0,0 +1,78 @@
+import {
+  S as WebFetchVia,
+  _ as WEB_FETCH_TOOL_NAME,
+  b as WebFetchToolInput,
+  c as WebFetchRequest,
+  l as WebFetchSource,
+  n as WebFetchToolOptions,
+  o as WebFetchError,
+  s as WebFetchErrorCode,
+  v as WebFetchFormat,
+  x as WebFetchToolOutput,
+  y as WebFetchPage
+} from "../../../tool-DoVberpN.js";
+
+//#region src/web/fetch/tools/tanstack-ai.d.ts
+type TanStackWebFetchToolOptions<
+  TName extends string = typeof WEB_FETCH_TOOL_NAME
+> = WebFetchToolOptions & {
+  /** The tool's name. TanStack AI tools carry it in the definition. */ name?: TName;
+};
+/**
+ * Create a TanStack AI tool that reads a URL as Markdown, JSON, or text.
+ * TanStack AI has one return channel, so the model and the host both get
+ * the rendered window. A failed fetch throws a `WebFetchError`, which
+ * TanStack AI reports as an error result: its `message` is written for the
+ * model, and its `cause` is the source's error with the detail. The tool is
+ * named `web_fetch` unless you pass `name`.
+ *
+ * @example
+ * ```ts
+ * import { webFetchTool } from "agents/webfetch/tanstack-ai";
+ * import { chat } from "@tanstack/ai";
+ *
+ * const stream = chat({
+ *   adapter,
+ *   tools: [webFetchTool({ binding: env.AI })],
+ *   messages
+ * });
+ * ```
+ */
+declare function webFetchTool<
+  TName extends string = typeof WEB_FETCH_TOOL_NAME
+>(
+  options: TanStackWebFetchToolOptions<TName>
+): import("@tanstack/ai").ServerTool<
+  import("zod").ZodObject<
+    {
+      url: import("zod").ZodString;
+      offset: import("zod").ZodOptional<import("zod").ZodNumber>;
+      format: import("zod").ZodOptional<
+        import("zod").ZodEnum<{
+          auto: "auto";
+          raw: "raw";
+        }>
+      >;
+    },
+    import("zod/v4/core").$strip
+  >,
+  import("@tanstack/ai").SchemaInput,
+  TName,
+  unknown
+>;
+//#endregion
+export {
+  TanStackWebFetchToolOptions,
+  WebFetchError,
+  type WebFetchErrorCode,
+  type WebFetchFormat,
+  type WebFetchPage,
+  type WebFetchRequest,
+  type WebFetchSource,
+  type WebFetchToolInput,
+  type WebFetchToolOptions,
+  type WebFetchToolOutput,
+  type WebFetchVia,
+  webFetchTool
+};
+//# sourceMappingURL=tanstack-ai.d.ts.map

package/dist/web/fetch/tools/tanstack-ai.js

@@ -0,0 +1,45 @@
+import { a as WebFetchError, r as toolFailure, t as createWebFetchToolCore } from "../../../tool-CxKsvxjm.js";
+import { t as webFetchInputSchema } from "../../../input-schema-BQykTEp_.js";
+import { toolDefinition } from "@tanstack/ai";
+//#region src/web/fetch/tools/tanstack-ai.ts
+/**
+* `agents/webfetch/tanstack-ai` — the `web_fetch` tool for TanStack AI.
+*
+* @beta
+*/
+/**
+* Create a TanStack AI tool that reads a URL as Markdown, JSON, or text.
+* TanStack AI has one return channel, so the model and the host both get
+* the rendered window. A failed fetch throws a `WebFetchError`, which
+* TanStack AI reports as an error result: its `message` is written for the
+* model, and its `cause` is the source's error with the detail. The tool is
+* named `web_fetch` unless you pass `name`.
+*
+* @example
+* ```ts
+* import { webFetchTool } from "agents/webfetch/tanstack-ai";
+* import { chat } from "@tanstack/ai";
+*
+* const stream = chat({
+*   adapter,
+*   tools: [webFetchTool({ binding: env.AI })],
+*   messages
+* });
+* ```
+*/
+function webFetchTool(options) {
+	const core = createWebFetchToolCore(options);
+	return toolDefinition({
+		name: options.name ?? core.name,
+		description: core.description,
+		inputSchema: webFetchInputSchema()
+	}).server(async (input, context) => {
+		const run = await core.run(input, { signal: context?.abortSignal });
+		if (!run.ok) throw toolFailure(run);
+		return run.text;
+	});
+}
+//#endregion
+export { WebFetchError, webFetchTool };
+
+//# sourceMappingURL=tanstack-ai.js.map

package/dist/web/fetch/tools/tanstack-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-ai.js","names":[],"sources":["../../../../src/web/fetch/tools/tanstack-ai.ts"],"sourcesContent":["/**\n * `agents/webfetch/tanstack-ai` — the `web_fetch` tool for TanStack AI.\n *\n * @beta\n */\nimport { toolDefinition } from \"@tanstack/ai\";\nimport type { WEB_FETCH_TOOL_NAME } from \"../contract\";\nimport {\n  createWebFetchToolCore,\n  toolFailure,\n  type WebFetchToolOptions\n} from \"../tool\";\nimport { webFetchInputSchema } from \"./input-schema\";\n\nexport type {\n  WebFetchFormat,\n  WebFetchPage,\n  WebFetchToolInput,\n  WebFetchToolOutput,\n  WebFetchVia\n} from \"../contract\";\nexport {\n  WebFetchError,\n  type WebFetchErrorCode,\n  type WebFetchRequest,\n  type WebFetchSource\n} from \"../source\";\nexport type { WebFetchToolOptions } from \"../tool\";\n\nexport type TanStackWebFetchToolOptions<\n  TName extends string = typeof WEB_FETCH_TOOL_NAME\n> = WebFetchToolOptions & {\n  /** The tool's name. TanStack AI tools carry it in the definition. */\n  name?: TName;\n};\n\n/**\n * Create a TanStack AI tool that reads a URL as Markdown, JSON, or text.\n * TanStack AI has one return channel, so the model and the host both get\n * the rendered window. A failed fetch throws a `WebFetchError`, which\n * TanStack AI reports as an error result: its `message` is written for the\n * model, and its `cause` is the source's error with the detail. The tool is\n * named `web_fetch` unless you pass `name`.\n *\n * @example\n * ```ts\n * import { webFetchTool } from \"agents/webfetch/tanstack-ai\";\n * import { chat } from \"@tanstack/ai\";\n *\n * const stream = chat({\n *   adapter,\n *   tools: [webFetchTool({ binding: env.AI })],\n *   messages\n * });\n * ```\n */\nexport function webFetchTool<TName extends string = typeof WEB_FETCH_TOOL_NAME>(\n  options: TanStackWebFetchToolOptions<TName>\n) {\n  const core = createWebFetchToolCore(options);\n  return toolDefinition({\n    name: options.name ?? (core.name as TName),\n    description: core.description,\n    inputSchema: webFetchInputSchema()\n  }).server(async (input, context) => {\n    const run = await core.run(input, { signal: context?.abortSignal });\n    if (!run.ok) throw toolFailure(run);\n    return run.text;\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,aACd,SACA;CACA,MAAM,OAAO,uBAAuB,OAAO;CAC3C,OAAO,eAAe;EACpB,MAAM,QAAQ,QAAS,KAAK;EAC5B,aAAa,KAAK;EAClB,aAAa,oBAAoB;CACnC,CAAC,CAAC,CAAC,OAAO,OAAO,OAAO,YAAY;EAClC,MAAM,MAAM,MAAM,KAAK,IAAI,OAAO,EAAE,QAAQ,SAAS,YAAY,CAAC;EAClE,IAAI,CAAC,IAAI,IAAI,MAAM,YAAY,GAAG;EAClC,OAAO,IAAI;CACb,CAAC;AACH"}

package/dist/{websearch → web/search}/index.d.ts

@@ -26,7 +26,7 @@ import {
   w as WebSearchResult,
   x as WEB_SEARCH_TOOL_DESCRIPTION,
   y as MAX_WEB_SEARCH_QUERY_LENGTH
-} from "../tool-BPJEbwaX.js";
+} from "../../tool-CTp72Jb_.js";
 export {
   type AIWebSearchOptions,
   DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS,

package/dist/{websearch → web/search}/index.js

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

package/dist/{websearch → web/search}/tools/ai-sdk.d.ts

@@ -8,10 +8,10 @@ import {
   p as WebSearchSource,
   r as WebSearchToolOptions,
   w as WebSearchResult
-} from "../../tool-BPJEbwaX.js";
+} from "../../../tool-CTp72Jb_.js";
 import { FlexibleSchema } from "ai";
 
-//#region src/websearch/tools/ai-sdk.d.ts
+//#region src/web/search/tools/ai-sdk.d.ts
 /**
  * The part of the AI SDK's tool execution options the tool reads. Spelled
  * out rather than imported so it fits every supported `ai` major.

package/dist/{websearch → web/search}/tools/ai-sdk.js

@@ -1,6 +1,6 @@
-import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../tool-3PA8xjB_.js";
-import { t as webSearchInputSchema } from "../../input-schema-DNrpTu49.js";
-//#region src/websearch/tools/ai-sdk.ts
+import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../../tool-cQRkwSZZ.js";
+import { t as webSearchInputSchema } from "../../../input-schema-D2QAtHZH.js";
+//#region src/web/search/tools/ai-sdk.ts
 /**
 * Create an AI SDK tool that searches the web through Cloudflare's Web
 * Search API. The host gets the full response as the tool's output (whole

package/dist/web/search/tools/ai-sdk.js.map

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

package/dist/{websearch → web/search}/tools/pi.d.ts

@@ -8,11 +8,11 @@ import {
   p as WebSearchSource,
   r as WebSearchToolOptions,
   w as WebSearchResult
-} from "../../tool-BPJEbwaX.js";
-import { ToolRegistration } from "@earendil-works/pi-durable";
+} from "../../../tool-CTp72Jb_.js";
 import { Type } from "@earendil-works/pi-ai";
+import { ToolRegistration } from "@earendil-works/pi-durable";
 
-//#region src/websearch/tools/pi.d.ts
+//#region src/web/search/tools/pi.d.ts
 /**
  * The model's input schema. The description tells the model the host's
  * `limit`; a larger value is not rejected (which would cost a validation

package/dist/{websearch → web/search}/tools/pi.js

@@ -1,6 +1,6 @@
-import { i as WebSearchError, n as createWebSearchToolCore, u as MAX_WEB_SEARCH_QUERY_LENGTH } from "../../tool-3PA8xjB_.js";
+import { i as WebSearchError, n as createWebSearchToolCore, u as MAX_WEB_SEARCH_QUERY_LENGTH } from "../../../tool-cQRkwSZZ.js";
 import { Type } from "@earendil-works/pi-ai";
-//#region src/websearch/tools/pi.ts
+//#region src/web/search/tools/pi.ts
 /**
 * `agents/websearch/pi` — the `web_search` tool for the pi harness.
 *

package/dist/web/search/tools/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","names":[],"sources":["../../../../src/web/search/tools/pi.ts"],"sourcesContent":["/**\n * `agents/websearch/pi` — the `web_search` tool for the pi harness.\n *\n * @beta\n */\nimport { Type } from \"@earendil-works/pi-ai\";\nimport type { ToolRegistration } from \"@earendil-works/pi-durable\";\nimport {\n  MAX_WEB_SEARCH_QUERY_LENGTH,\n  type WebSearchToolOutput\n} from \"../contract\";\nimport type { WebSearchErrorCode } from \"../source\";\nimport { createWebSearchToolCore, type WebSearchToolOptions } from \"../tool\";\n\nexport type {\n  WebSearchResponse,\n  WebSearchResult,\n  WebSearchToolInput,\n  WebSearchToolOutput\n} from \"../contract\";\nexport {\n  WebSearchError,\n  type WebSearchErrorCode,\n  type WebSearchProvider,\n  type WebSearchSource\n} from \"../source\";\nexport type { WebSearchToolOptions } from \"../tool\";\n\n/**\n * The model's input schema. The description tells the model the host's\n * `limit`; a larger value is not rejected (which would cost a validation\n * round trip) but capped by the core. pi already coerces `\"5\"` to `5`.\n */\nfunction webSearchParameters(maxLimit: number) {\n  return Type.Object({\n    query: Type.String({\n      minLength: 1,\n      maxLength: MAX_WEB_SEARCH_QUERY_LENGTH,\n      description: \"What to search for.\"\n    }),\n    limit: Type.Optional(\n      Type.Integer({\n        minimum: 1,\n        description: `How many results to return (at most ${maxLimit}).`\n      })\n    )\n  });\n}\n\ntype WebSearchParameters = ReturnType<typeof webSearchParameters>;\n\n/**\n * Host-side details pi stores with each `web_search` result: the full API\n * response (untrimmed descriptions, provider metadata) or the failure.\n */\nexport type WebSearchToolDetails =\n  | { ok: true; output: WebSearchToolOutput }\n  | {\n      ok: false;\n      /** The source's error message, with the API's detail. */\n      message: string;\n      status: number;\n      code: WebSearchErrorCode;\n      retryable: boolean;\n      requestId?: string;\n    };\n\n/**\n * Create a pi tool that searches the web through Cloudflare's Web Search\n * API. Install it on a registry like any other pi tool.\n *\n * The model chooses the query and (within the host's `limit`) how many\n * results; the host chooses the gateway, provider, and billing. The tool is\n * `replay: \"safe\"`: a search interrupted mid-call (say, by an eviction) runs\n * again when the session recovers, which is a second billed search.\n * Completed results are stored and not searched again.\n *\n * @example\n * ```ts\n * import { createRegistry } from \"@earendil-works/pi-durable\";\n * import { webSearchTool } from \"agents/websearch/pi\";\n *\n * const registry = createRegistry();\n * registry.install({\n *   name: \"tools\",\n *   tools: [webSearchTool({ binding: env.AI, provider: \"exa\" })]\n * });\n * ```\n */\nexport function webSearchTool(\n  options: WebSearchToolOptions\n): ToolRegistration<WebSearchParameters, WebSearchToolDetails> {\n  const core = createWebSearchToolCore(options);\n  return {\n    name: core.name,\n    description: core.description,\n    parameters: webSearchParameters(core.limit),\n    replay: \"safe\",\n    async execute(input, _api, context) {\n      const run = await core.run(input, { signal: context.abortSignal });\n      if (run.ok) {\n        return {\n          content: [{ type: \"text\", text: run.text }],\n          details: { ok: true, output: run.output }\n        };\n      }\n      return {\n        content: [{ type: \"text\", text: run.text }],\n        isError: true,\n        details: {\n          ok: false,\n          message: run.error.message,\n          status: run.error.status,\n          code: run.error.code,\n          retryable: run.error.retryable,\n          requestId: run.error.requestId\n        }\n      };\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAiCA,SAAS,oBAAoB,UAAkB;CAC7C,OAAO,KAAK,OAAO;EACjB,OAAO,KAAK,OAAO;GACjB,WAAW;GACX,WAAW;GACX,aAAa;EACf,CAAC;EACD,OAAO,KAAK,SACV,KAAK,QAAQ;GACX,SAAS;GACT,aAAa,uCAAuC,SAAS;EAC/D,CAAC,CACH;CACF,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,cACd,SAC6D;CAC7D,MAAM,OAAO,wBAAwB,OAAO;CAC5C,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,YAAY,oBAAoB,KAAK,KAAK;EAC1C,QAAQ;EACR,MAAM,QAAQ,OAAO,MAAM,SAAS;GAClC,MAAM,MAAM,MAAM,KAAK,IAAI,OAAO,EAAE,QAAQ,QAAQ,YAAY,CAAC;GACjE,IAAI,IAAI,IACN,OAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,IAAI;IAAK,CAAC;IAC1C,SAAS;KAAE,IAAI;KAAM,QAAQ,IAAI;IAAO;GAC1C;GAEF,OAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,IAAI;IAAK,CAAC;IAC1C,SAAS;IACT,SAAS;KACP,IAAI;KACJ,SAAS,IAAI,MAAM;KACnB,QAAQ,IAAI,MAAM;KAClB,MAAM,IAAI,MAAM;KAChB,WAAW,IAAI,MAAM;KACrB,WAAW,IAAI,MAAM;IACvB;GACF;EACF;CACF;AACF"}

package/dist/{websearch → web/search}/tools/tanstack-ai.d.ts

@@ -9,9 +9,9 @@ import {
   p as WebSearchSource,
   r as WebSearchToolOptions,
   w as WebSearchResult
-} from "../../tool-BPJEbwaX.js";
+} from "../../../tool-CTp72Jb_.js";
 
-//#region src/websearch/tools/tanstack-ai.d.ts
+//#region src/web/search/tools/tanstack-ai.d.ts
 type TanStackWebSearchToolOptions<
   TName extends string = typeof WEB_SEARCH_TOOL_NAME
 > = WebSearchToolOptions & {

package/dist/{websearch → web/search}/tools/tanstack-ai.js

@@ -1,7 +1,7 @@
-import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../tool-3PA8xjB_.js";
-import { t as webSearchInputSchema } from "../../input-schema-DNrpTu49.js";
+import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../../tool-cQRkwSZZ.js";
+import { t as webSearchInputSchema } from "../../../input-schema-D2QAtHZH.js";
 import { toolDefinition } from "@tanstack/ai";
-//#region src/websearch/tools/tanstack-ai.ts
+//#region src/web/search/tools/tanstack-ai.ts
 /**
 * `agents/websearch/tanstack-ai` — the `web_search` tool for TanStack AI.
 *

package/dist/web/search/tools/tanstack-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-ai.js","names":[],"sources":["../../../../src/web/search/tools/tanstack-ai.ts"],"sourcesContent":["/**\n * `agents/websearch/tanstack-ai` — the `web_search` tool for TanStack AI.\n *\n * @beta\n */\nimport { toolDefinition } from \"@tanstack/ai\";\nimport type { WEB_SEARCH_TOOL_NAME } from \"../contract\";\nimport {\n  createWebSearchToolCore,\n  toolFailure,\n  type WebSearchToolOptions\n} from \"../tool\";\nimport { webSearchInputSchema } from \"./input-schema\";\n\nexport type {\n  WebSearchResponse,\n  WebSearchResult,\n  WebSearchToolInput,\n  WebSearchToolOutput\n} from \"../contract\";\nexport {\n  WebSearchError,\n  type WebSearchErrorCode,\n  type WebSearchProvider,\n  type WebSearchSource\n} from \"../source\";\nexport type { WebSearchToolOptions } from \"../tool\";\n\nexport type TanStackWebSearchToolOptions<\n  TName extends string = typeof WEB_SEARCH_TOOL_NAME\n> = WebSearchToolOptions & {\n  /** The tool's name. TanStack AI tools carry it in the definition. */\n  name?: TName;\n};\n\n/**\n * Create a TanStack AI tool that searches the web through Cloudflare's Web\n * Search API. TanStack AI has one return channel, so the model and the host\n * both get the trimmed text rendering. A failed search throws a\n * `WebSearchError`, which TanStack AI reports as an error result: its\n * `message` is written for the model, and its `cause` is the source's error\n * with the API's detail. The tool is named `web_search` unless you pass\n * `name`.\n *\n * @example\n * ```ts\n * import { webSearchTool } from \"agents/websearch/tanstack-ai\";\n * import { chat } from \"@tanstack/ai\";\n *\n * const stream = chat({\n *   adapter,\n *   tools: [webSearchTool({ binding: env.AI })],\n *   messages\n * });\n * ```\n */\nexport function webSearchTool<\n  TName extends string = typeof WEB_SEARCH_TOOL_NAME\n>(options: TanStackWebSearchToolOptions<TName>) {\n  const core = createWebSearchToolCore(options);\n  return toolDefinition({\n    name: options.name ?? (core.name as TName),\n    description: core.description,\n    inputSchema: webSearchInputSchema(core.limit)\n  }).server(async (input, context) => {\n    const run = await core.run(input, { signal: context?.abortSignal });\n    if (!run.ok) throw toolFailure(run);\n    return run.text;\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,cAEd,SAA8C;CAC9C,MAAM,OAAO,wBAAwB,OAAO;CAC5C,OAAO,eAAe;EACpB,MAAM,QAAQ,QAAS,KAAK;EAC5B,aAAa,KAAK;EAClB,aAAa,qBAAqB,KAAK,KAAK;CAC9C,CAAC,CAAC,CAAC,OAAO,OAAO,OAAO,YAAY;EAClC,MAAM,MAAM,MAAM,KAAK,IAAI,OAAO,EAAE,QAAQ,SAAS,YAAY,CAAC;EAClE,IAAI,CAAC,IAAI,IAAI,MAAM,YAAY,GAAG;EAClC,OAAO,IAAI;CACb,CAAC;AACH"}

package/dist/websockets/index.d.ts

@@ -10,13 +10,13 @@ import {
   n as WebSocketHandlers,
   r as WebSocketMessage,
   t as SyncedState
-} from "../options-pwTNq9z6.js";
+} from "../options-CiIsJHXR.js";
 import {
   i as WebSockets,
   n as CF_READONLY_KEY,
   r as registerInternalConnectionKeys,
   t as CF_NO_PROTOCOL_KEY
-} from "../index-Ib_4dwOo.js";
+} from "../index-CBt8oRJt.js";
 export {
   type AgentTransport,
   CAPNWEB_TRANSPORT_QUERY,

package/dist/websockets/index.js

@@ -1,3 +1,3 @@
 import { a as isCapnWebTransportUpgrade, i as capnWebTransportUrl, r as CAPNWEB_TRANSPORT_VALUE, t as CAPNWEB_TRANSPORT_QUERY } from "../transport-protocol-BxyngQ_R.js";
-import { l as registerInternalConnectionKeys, n as CF_NO_PROTOCOL_KEY, r as CF_READONLY_KEY, t as WebSockets } from "../websockets-CmENGb-Z.js";
+import { l as registerInternalConnectionKeys, n as CF_NO_PROTOCOL_KEY, r as CF_READONLY_KEY, t as WebSockets } from "../websockets-C3zy8YR0.js";
 export { CAPNWEB_TRANSPORT_QUERY, CAPNWEB_TRANSPORT_VALUE, CF_NO_PROTOCOL_KEY, CF_READONLY_KEY, WebSockets, capnWebTransportUrl, isCapnWebTransportUpgrade, registerInternalConnectionKeys };

package/dist/{websockets-CmENGb-Z.js → websockets-C3zy8YR0.js}

@@ -3,8 +3,8 @@ import "./types.js";
 import { a as isCapnWebTransportUpgrade, n as CAPNWEB_TRANSPORT_SEND } from "./transport-protocol-BxyngQ_R.js";
 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 { t as LifecycleCapability } from "./capability-B4WbF81e.js";
-import "./lifecycle-CFu6OV03.js";
+import { t as LifecycleCapability } from "./capability-DBAKc6UZ.js";
+import "./lifecycle-DGorpAmA.js";
 import { newWebSocketRpcSession } from "capnweb";
 import { RpcTarget as RpcTarget$1 } from "cloudflare:workers";
 import { nanoid } from "nanoid";
@@ -624,8 +624,6 @@ var _WebSockets_brand = /* @__PURE__ */ new WeakSet();
 * and client updates are validated and applied; the state owner
 * broadcasts changes with `broadcastState()`. Per-connection readonly
 * and no-protocol flags live here as well, for every host.
-*
-* @experimental The API surface may change before stabilizing.
 */
 var WebSockets = class extends LifecycleCapability {
 	constructor(options = {}) {
@@ -1041,4 +1039,4 @@ async function _dispatchCallable(name, invoke, connection) {
 //#endregion
 export { getConnectionFlag as a, isConnectionReadonly as c, setConnectionProtocolEnabled as d, setConnectionReadonly as f, ensureConnectionWrapped as i, registerInternalConnectionKeys as l, CF_NO_PROTOCOL_KEY as n, getConnectionRawState as o, CF_READONLY_KEY as r, isConnectionProtocolEnabled as s, WebSockets as t, setConnectionFlag as u };
 
-//# sourceMappingURL=websockets-CmENGb-Z.js.map
+//# sourceMappingURL=websockets-C3zy8YR0.js.map

package/dist/websockets-C3zy8YR0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websockets-C3zy8YR0.js","names":["RpcTarget","RpcTarget"],"sources":["../src/websockets/connection-flags.ts","../src/websockets/connection.ts","../src/websockets/callables-target.ts","../src/websockets/transport.ts","../src/websockets/websockets.ts"],"sourcesContent":["import type { Connection } from \"../lifecycle\";\n\n/**\n * Internal per-connection flags, stored inside the connection's own state\n * under `_cf_`-prefixed keys so they ride the hibernation attachment (or a\n * bridged connection's synced state) and survive a wake. The state wrapper\n * installed by {@link ensureConnectionWrapped} hides them from\n * `connection.state` and preserves them across user `setState` calls.\n *\n * Owned by the WebSockets capability; `Agent` and framework mixins reach it\n * through the capability or, for their own keys, through\n * {@link registerInternalConnectionKeys}.\n */\n\n/** A readonly connection may not update host state. */\nexport const CF_READONLY_KEY = \"_cf_readonly\";\n\n/**\n * A no-protocol connection receives no protocol text frames (identity,\n * state sync, MCP servers) — neither on connect nor via broadcasts.\n */\nexport const CF_NO_PROTOCOL_KEY = \"_cf_no_protocol\";\n\nconst internalKeys = new Set<string>([CF_READONLY_KEY, CF_NO_PROTOCOL_KEY]);\n\n/**\n * Register additional `_cf_`-prefixed keys a host or mixin stores in\n * connection state, so they are hidden from `connection.state` and kept\n * across user `setState` calls like the capability's own flags.\n */\nexport function registerInternalConnectionKeys(...keys: string[]): void {\n  for (const key of keys) internalKeys.add(key);\n}\n\nfunction rawHasInternalKeys(raw: Record<string, unknown>): boolean {\n  for (const key of Object.keys(raw)) {\n    if (internalKeys.has(key)) return true;\n  }\n  return false;\n}\n\n/** A copy of `raw` without internal keys, or null when no user keys remain. */\nfunction stripInternalKeys(\n  raw: Record<string, unknown>\n): Record<string, unknown> | null {\n  const result: Record<string, unknown> = {};\n  let hasUserKeys = false;\n  for (const key of Object.keys(raw)) {\n    if (!internalKeys.has(key)) {\n      result[key] = raw[key];\n      hasUserKeys = true;\n    }\n  }\n  return hasUserKeys ? result : null;\n}\n\n/** A copy containing only the internal keys present in `raw`. */\nfunction extractInternalFlags(\n  raw: Record<string, unknown>\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(raw)) {\n    if (internalKeys.has(key)) result[key] = raw[key];\n  }\n  return result;\n}\n\ntype RawAccessors = {\n  getRaw: () => Record<string, unknown> | null;\n  setRaw: (state: unknown) => unknown;\n};\n\n/**\n * Per-connection raw accessors, keyed by the live connection object. The\n * map is in-memory: after hibernation it is empty, and every entry point\n * re-wraps the connection on first use.\n */\nconst rawStateAccessors = new WeakMap<Connection, RawAccessors>();\n\n/**\n * Wrap `connection.state` / `connection.setState` so internal flags are\n * hidden from user code and preserved when user code sets state.\n * Idempotent, and safe to call after hibernation.\n */\nexport function ensureConnectionWrapped(connection: Connection): void {\n  if (rawStateAccessors.has(connection)) return;\n\n  // Hibernating connections expose attachment-backed state as a\n  // configurable accessor. Virtual (bridged) connections use a data\n  // property, so both projections are retained below.\n  const descriptor = Object.getOwnPropertyDescriptor(connection, \"state\");\n\n  let getRaw: RawAccessors[\"getRaw\"];\n  let setRaw: RawAccessors[\"setRaw\"];\n\n  if (descriptor?.get) {\n    // Accessor property: bind the original getter. It reads the serialized\n    // attachment, so it always returns the latest value after setState.\n    getRaw = descriptor.get.bind(connection) as RawAccessors[\"getRaw\"];\n    setRaw = connection.setState.bind(connection);\n  } else {\n    // Data property: track the raw value in a closure. Reading\n    // `connection.state` after the override would hit the filtered getter.\n    let rawState = (connection.state ?? null) as Record<string, unknown> | null;\n    getRaw = () => rawState;\n    setRaw = (state: unknown) => {\n      rawState = state as Record<string, unknown> | null;\n      return rawState;\n    };\n  }\n\n  rawStateAccessors.set(connection, { getRaw, setRaw });\n\n  Object.defineProperty(connection, \"state\", {\n    configurable: true,\n    enumerable: true,\n    get() {\n      const raw = getRaw();\n      if (raw != null && typeof raw === \"object\" && rawHasInternalKeys(raw)) {\n        return stripInternalKeys(raw);\n      }\n      return raw;\n    }\n  });\n\n  Object.defineProperty(connection, \"setState\", {\n    configurable: true,\n    writable: true,\n    value(stateOrFn: unknown | ((prev: unknown) => unknown)) {\n      const raw = getRaw();\n      const flags =\n        raw != null && typeof raw === \"object\"\n          ? extractInternalFlags(raw as Record<string, unknown>)\n          : {};\n      const hasFlags = Object.keys(flags).length > 0;\n\n      let newUserState: unknown;\n      if (typeof stateOrFn === \"function\") {\n        // The callback sees only user-visible state.\n        const userVisible = hasFlags\n          ? stripInternalKeys(raw as Record<string, unknown>)\n          : raw;\n        newUserState = (stateOrFn as (prev: unknown) => unknown)(userVisible);\n      } else {\n        newUserState = stateOrFn;\n      }\n\n      if (hasFlags) {\n        if (newUserState != null && typeof newUserState === \"object\") {\n          return setRaw({\n            ...(newUserState as Record<string, unknown>),\n            ...flags\n          });\n        }\n        // User set null: keep just the flags.\n        return setRaw(flags);\n      }\n      return setRaw(newUserState);\n    }\n  });\n}\n\n/** The raw connection state, internal flags included. */\nexport function getConnectionRawState(\n  connection: Connection\n): Record<string, unknown> | null {\n  ensureConnectionWrapped(connection);\n  return rawStateAccessors.get(connection)!.getRaw();\n}\n\n/** Read an internal flag from the raw connection state. */\nexport function getConnectionFlag(\n  connection: Connection,\n  key: string\n): unknown {\n  ensureConnectionWrapped(connection);\n  return rawStateAccessors.get(connection)!.getRaw()?.[key];\n}\n\n/**\n * Write an internal flag to the raw connection state. `undefined` removes\n * the key rather than storing a dead value; the last key removed leaves\n * `null`.\n */\nexport function setConnectionFlag(\n  connection: Connection,\n  key: string,\n  value: unknown\n): void {\n  ensureConnectionWrapped(connection);\n  const accessors = rawStateAccessors.get(connection)!;\n  const raw = accessors.getRaw() ?? {};\n  if (value === undefined) {\n    const { [key]: _, ...rest } = raw;\n    accessors.setRaw(Object.keys(rest).length > 0 ? rest : null);\n  } else {\n    accessors.setRaw({ ...raw, [key]: value });\n  }\n}\n\nexport function isConnectionReadonly(connection: Connection): boolean {\n  return !!getConnectionFlag(connection, CF_READONLY_KEY);\n}\n\nexport function setConnectionReadonly(\n  connection: Connection,\n  readonly: boolean\n): void {\n  setConnectionFlag(connection, CF_READONLY_KEY, readonly ? true : undefined);\n}\n\nexport function isConnectionProtocolEnabled(connection: Connection): boolean {\n  return !getConnectionFlag(connection, CF_NO_PROTOCOL_KEY);\n}\n\nexport function setConnectionProtocolEnabled(\n  connection: Connection,\n  enabled: boolean\n): void {\n  setConnectionFlag(connection, CF_NO_PROTOCOL_KEY, enabled ? undefined : true);\n}\n","// Polyfill WebSocket status code constants for environments that don't have them\n// in order to support libraries that expect standards-compatible WebSocket\n// implementations (e.g. PartySocket)\n\nimport type {\n  Connection,\n  ConnectionSetStateFn,\n  ConnectionState,\n  LifecycleSockets\n} from \"../lifecycle\";\n\nif (!(\"OPEN\" in WebSocket)) {\n  const WebSocketStatus = {\n    // @ts-expect-error\n    CONNECTING: WebSocket.READY_STATE_CONNECTING,\n    // @ts-expect-error\n    OPEN: WebSocket.READY_STATE_OPEN,\n    // @ts-expect-error\n    CLOSING: WebSocket.READY_STATE_CLOSING,\n    // @ts-expect-error\n    CLOSED: WebSocket.READY_STATE_CLOSED\n  };\n\n  Object.assign(WebSocket, WebSocketStatus);\n  // @ts-expect-error\n  Object.assign(WebSocket.prototype, WebSocketStatus);\n}\n\n/**\n * Store both platform attachments and user attachments in different namespaces\n */\ntype ConnectionAttachments = {\n  __pk: {\n    id: string;\n    tags: string[];\n    uri?: string;\n  };\n  __user?: unknown;\n};\n\nfunction tryGetManagedWebSocketMeta(\n  ws: WebSocket\n): ConnectionAttachments[\"__pk\"] | null {\n  try {\n    // Avoid AttachmentCache.get() here: externally accepted sockets\n    // can have an attachment without the managed __pk namespace.\n    const attachment = WebSocket.prototype.deserializeAttachment.call(\n      ws\n    ) as unknown;\n    if (!attachment || typeof attachment !== \"object\") {\n      return null;\n    }\n    if (!(\"__pk\" in attachment)) {\n      return null;\n    }\n    const pk = (attachment as ConnectionAttachments).__pk as unknown;\n    if (!pk || typeof pk !== \"object\") {\n      return null;\n    }\n    const { id, tags } = pk as {\n      id?: unknown;\n      tags?: unknown;\n    };\n    if (typeof id !== \"string\") {\n      return null;\n    }\n    const { uri } = pk as { uri?: unknown };\n    return {\n      id,\n      tags: Array.isArray(tags) ? tags : [],\n      uri: typeof uri === \"string\" ? uri : undefined\n    } satisfies ConnectionAttachments[\"__pk\"];\n  } catch {\n    return null;\n  }\n}\n\nexport function isManagedWebSocket(ws: WebSocket): boolean {\n  return tryGetManagedWebSocketMeta(ws) !== null;\n}\n\n/**\n * Cache websocket attachments to avoid having to rehydrate them on every property access.\n */\nclass AttachmentCache {\n  #cache = new WeakMap<WebSocket, ConnectionAttachments>();\n\n  get(ws: WebSocket): ConnectionAttachments {\n    let attachment = this.#cache.get(ws);\n    if (!attachment) {\n      attachment = WebSocket.prototype.deserializeAttachment.call(\n        ws\n      ) as ConnectionAttachments;\n      if (attachment !== undefined) {\n        this.#cache.set(ws, attachment);\n      } else {\n        throw new Error(\"Missing managed WebSocket lifecycle attachment\");\n      }\n    }\n\n    return attachment;\n  }\n\n  set(ws: WebSocket, attachment: ConnectionAttachments) {\n    this.#cache.set(ws, attachment);\n    WebSocket.prototype.serializeAttachment.call(ws, attachment);\n  }\n}\n\nconst attachments = new AttachmentCache();\nconst connections = new WeakSet<Connection>();\nconst isWrapped = (ws: WebSocket): ws is Connection => {\n  return connections.has(ws as Connection);\n};\n\n/**\n * Wraps a WebSocket with Connection fields that rehydrate the\n * socket attachments lazily only when requested.\n */\nexport const createConnection = (ws: WebSocket | Connection): Connection => {\n  if (isWrapped(ws)) {\n    return ws;\n  }\n\n  // if state was set on the socket before initializing the connection,\n  // capture it here so we can persist it again\n  let initialState;\n  if (\"state\" in ws) {\n    initialState = ws.state;\n    delete ws.state;\n  }\n\n  const connection = Object.defineProperties(ws, {\n    id: {\n      configurable: true,\n      get() {\n        return attachments.get(ws).__pk.id;\n      }\n    },\n    uri: {\n      configurable: true,\n      get() {\n        return attachments.get(ws).__pk.uri ?? null;\n      }\n    },\n    tags: {\n      configurable: true,\n      get() {\n        // Default to [] for connections accepted before tags were stored\n        return attachments.get(ws).__pk.tags ?? [];\n      }\n    },\n    state: {\n      configurable: true,\n      get() {\n        const attachment = attachments.get(ws);\n        return (attachment.__user ?? null) as ConnectionState<unknown>;\n      }\n    },\n    setState: {\n      configurable: true,\n      value: function setState<T>(setState: T | ConnectionSetStateFn<T>) {\n        const state =\n          setState instanceof Function\n            ? setState((this as Connection<T>).state)\n            : setState;\n        attachments.set(ws, {\n          ...attachments.get(ws),\n          __user: state ?? null\n        });\n        return state as ConnectionState<T>;\n      }\n    }\n  }) as Connection;\n\n  if (initialState) {\n    connection.setState(initialState);\n  }\n\n  connections.add(connection);\n  return connection;\n};\n\nclass ConnectionIterator<T> implements IterableIterator<Connection<T>> {\n  private index = 0;\n  #sockets: WebSocket[] | undefined;\n  constructor(\n    private sockets: LifecycleSockets,\n    private tag?: string\n  ) {}\n\n  [Symbol.iterator](): IterableIterator<Connection<T>> {\n    return this;\n  }\n\n  next(): IteratorResult<Connection<T>, number | undefined> {\n    const sockets =\n      this.#sockets ?? (this.#sockets = this.sockets.get(this.tag));\n\n    let socket: WebSocket;\n    while ((socket = sockets[this.index++])) {\n      // Only yield open sockets.\n      if (socket.readyState === WebSocket.OPEN) {\n        // Durable Objects hibernation APIs allow storing arbitrary sockets via\n        // `state.acceptWebSocket()`. Ignore sockets without our attachment.\n        if (!isManagedWebSocket(socket)) {\n          continue;\n        }\n        const value = createConnection(socket) as Connection<T>;\n        return { done: false, value };\n      }\n    }\n\n    // reached the end of the iteratee\n    return { done: true, value: undefined };\n  }\n}\n\n/**\n * Deduplicate and validate connection tags.\n * Returns the final tag array (always includes the connection id as the first tag).\n */\nexport function prepareTags(\n  connectionId: string,\n  userTags: string[]\n): string[] {\n  const tags = [connectionId, ...userTags.filter((t) => t !== connectionId)];\n\n  // validate tags against documented restrictions\n  // https://developers.cloudflare.com/durable-objects/api/hibernatable-websockets-api/#state-methods-for-websockets\n  if (tags.length > 10) {\n    throw new Error(\n      \"A connection can only have 10 tags, including the default id tag.\"\n    );\n  }\n\n  for (const tag of tags) {\n    if (typeof tag !== \"string\") {\n      throw new Error(`A connection tag must be a string. Received: ${tag}`);\n    }\n    if (tag === \"\") {\n      throw new Error(\"A connection tag must not be an empty string.\");\n    }\n    if (tag.length > 256) {\n      throw new Error(\"A connection tag must not exceed 256 characters\");\n    }\n  }\n\n  return tags;\n}\n\n/** The platform-backed manager for hibernating WebSockets. */\nexport class ConnectionManager<TState = unknown> {\n  constructor(private controller: LifecycleSockets) {}\n\n  getConnection<T = TState>(id: string) {\n    // TODO: Should we cache the connections?\n    const sockets = this.controller.get(id);\n    const matching = sockets.filter((ws) => {\n      return tryGetManagedWebSocketMeta(ws)?.id === id;\n    });\n\n    if (matching.length === 0) return undefined;\n    if (matching.length === 1)\n      return createConnection(matching[0]) as Connection<T>;\n\n    throw new Error(\n      `More than one connection found for id ${id}. Did you mean to use getConnections(tag) instead?`\n    );\n  }\n\n  getConnections<T = TState>(tag?: string | undefined) {\n    return new ConnectionIterator<T>(this.controller, tag);\n  }\n\n  accept(connection: Connection, options: { tags: string[] }) {\n    const tags = prepareTags(connection.id, options.tags);\n\n    this.controller.accept(connection, tags);\n    attachments.set(connection, {\n      __pk: {\n        id: connection.id,\n        tags,\n        uri: connection.uri ?? undefined\n      },\n      __user: null\n    });\n\n    return createConnection(connection);\n  }\n}\n","import { RpcTarget } from \"cloudflare:workers\";\nimport { CAPNWEB_TRANSPORT_SEND } from \"./transport-protocol\";\n\n/** A named remote method ready to be exposed on a callables root. */\nexport type CallableInvoker = (...args: unknown[]) => unknown;\n\n/**\n * The single exposure policy for callable names. `Object.prototype` and\n * `RpcTarget.prototype` members are unreachable over Cap'n Web anyway\n * and are silently excluded; `then` is rejected loudly because exposing\n * it would make the remote stub thenable.\n */\nfunction assertExposable(name: string): boolean {\n  if (name === \"then\") {\n    throw new Error(\n      'A callables target cannot expose a method named \"then\" — it would make the remote stub thenable'\n    );\n  }\n  if (name === CAPNWEB_TRANSPORT_SEND) {\n    throw new Error(\n      `A callables target cannot expose \"${CAPNWEB_TRANSPORT_SEND}\"; it is the transport's frame pipe`\n    );\n  }\n  return !(\n    name === \"constructor\" ||\n    name in Object.prototype ||\n    name in RpcTarget.prototype\n  );\n}\n\n/**\n * The exposable prototype methods of a callables target, each bound to\n * invoke on the real instance (so private fields and `this` behave).\n *\n * Cap'n Web resolves methods on the prototype chain and rejects own\n * instance properties, so only prototype methods participate. The\n * nearest declaration wins for overridden names.\n *\n * @param target - The callables target to enumerate.\n * @returns Method names mapped to invokers on the target.\n */\nexport function exposableMethods(\n  target: RpcTarget\n): ReadonlyMap<string, CallableInvoker> {\n  const methods = new Map<string, CallableInvoker>();\n  const seen = new Set<string>();\n  let prototype: object | null = Object.getPrototypeOf(target);\n  while (\n    prototype &&\n    prototype !== RpcTarget.prototype &&\n    prototype !== Object.prototype\n  ) {\n    for (const name of Object.getOwnPropertyNames(prototype)) {\n      if (seen.has(name)) continue;\n      seen.add(name);\n      if (!assertExposable(name)) continue;\n      const descriptor = Object.getOwnPropertyDescriptor(prototype, name);\n      if (!descriptor || typeof descriptor.value !== \"function\") continue;\n      // SAFETY: `typeof descriptor.value === \"function\"` was checked\n      // above; TypeScript cannot narrow a descriptor's `value` field.\n      const method = descriptor.value as CallableInvoker;\n      methods.set(name, (...args) => Reflect.apply(method, target, args));\n    }\n    prototype = Object.getPrototypeOf(prototype);\n  }\n  return methods;\n}\n\n/**\n * Build a Cap'n Web session root exposing exactly the given methods.\n *\n * Cap'n Web resolves methods on the prototype chain, rejects own\n * instance properties, and breaks on Proxy-wrapped roots — so the root\n * is a private `RpcTarget` subclass whose prototype carries the methods\n * and nothing else.\n */\nexport function buildRoot(\n  methods: ReadonlyMap<string, CallableInvoker>\n): RpcTarget {\n  class Root extends RpcTarget {}\n  for (const [name, invoke] of methods) {\n    Object.defineProperty(Root.prototype, name, {\n      value: invoke,\n      writable: true,\n      configurable: true,\n      enumerable: false\n    });\n  }\n  return new Root();\n}\n","import { newWebSocketRpcSession, type RpcStub } from \"capnweb\";\nimport type {\n  Connection,\n  ConnectionContext,\n  ConnectionSetStateFn,\n  ConnectionState\n} from \"../lifecycle\";\nimport { buildRoot, type CallableInvoker } from \"./callables-target\";\nimport { prepareTags } from \"./connection\";\nimport {\n  CAPNWEB_TRANSPORT_SEND,\n  type TransportClientEvents,\n  type TransportMessage\n} from \"./transport-protocol\";\n\n/**\n * A non-hibernating connection with the public `Connection` contract,\n * backed by a Cap'n Web session instead of a hibernating socket. It lives\n * only in memory and disappears with the isolate.\n */\nclass CapnWebConnection extends EventTarget {\n  readonly CONNECTING = WebSocket.CONNECTING;\n  readonly OPEN = WebSocket.OPEN;\n  readonly CLOSING = WebSocket.CLOSING;\n  readonly CLOSED = WebSocket.CLOSED;\n  readyState: number = WebSocket.OPEN;\n  state: ConnectionState<unknown> = null;\n  tags: readonly string[] = [];\n\n  constructor(\n    readonly id: string,\n    readonly uri: string,\n    private readonly pipe: {\n      send(message: TransportMessage): void;\n      close(code?: number, reason?: string): void;\n    }\n  ) {\n    super();\n  }\n\n  send(message: TransportMessage): void {\n    if (this.readyState !== WebSocket.OPEN) {\n      throw new TypeError(\"WebSocket send() after close\");\n    }\n    this.pipe.send(message);\n  }\n\n  close(code?: number, reason?: string): void {\n    if (this.readyState >= WebSocket.CLOSING) return;\n    this.pipe.close(code, reason);\n    this.readyState = WebSocket.CLOSING;\n  }\n\n  setState<T = unknown>(\n    next: T | ConnectionSetStateFn<T> | null\n  ): ConnectionState<T> {\n    const state =\n      typeof next === \"function\"\n        ? (next as ConnectionSetStateFn<T>)(this.state as ConnectionState<T>)\n        : next;\n    this.state = state as ConnectionState<unknown>;\n    return state as ConnectionState<T>;\n  }\n}\n\n/** One live transport session. */\nexport type CapnWebSession = {\n  readonly connection: Connection;\n  /** Tear the session down; runs the close handler once. */\n  dispose(): void;\n};\n\n/** What the capability supplies to run one session. */\nexport type CapnWebSessionOptions = {\n  readonly request: Request;\n  readonly connectionId: string;\n  readonly tags: (\n    connection: Connection,\n    ctx: ConnectionContext\n  ) => string[] | Promise<string[]>;\n  readonly onConnect: (\n    connection: Connection,\n    ctx: ConnectionContext\n  ) => Promise<void>;\n  readonly onMessage: (\n    connection: Connection,\n    message: TransportMessage\n  ) => Promise<void>;\n  readonly onClose: (\n    connection: Connection,\n    code: number,\n    reason: string,\n    wasClean: boolean\n  ) => Promise<void>;\n  readonly onError: (connection: Connection, error: unknown) => Promise<void>;\n  /**\n   * Native methods served on the session root beside the frame pipe. Each\n   * invoker already runs inside the host boundary for this connection.\n   * Results pass by Cap'n Web semantics: an `RpcTarget` becomes a live\n   * stub, a `ReadableStream` streams, and calls pipeline.\n   */\n  readonly callables: (\n    connection: Connection\n  ) => ReadonlyMap<string, CallableInvoker>;\n  /**\n   * Called once the connection exists, before `onConnect`, so it is already\n   * visible in `getConnections()` while the connect handler runs — the same\n   * ordering as a hibernating socket, which is accepted before `onConnect`.\n   */\n  readonly onOpen: (session: CapnWebSession) => void;\n  /** Called exactly once when the session ends, before `onClose`. */\n  readonly onDispose: (session: CapnWebSession) => void;\n};\n\n/**\n * Accept a Cap'n Web transport upgrade.\n *\n * The session root carries the frame pipe plus the host's native\n * callables. The client's protocol frames arrive through the pipe and are\n * handed to `onMessage`; the host's frames go out through the client's\n * `message` callback; `useAgent().stub` calls hit the callables directly.\n * The socket is a plain in-memory `WebSocketPair`, so it pins the Durable\n * Object and does not survive hibernation.\n */\nexport async function openCapnWebSession(\n  options: CapnWebSessionOptions\n): Promise<{ response: Response; session: CapnWebSession }> {\n  const { request, connectionId } = options;\n  const pair = new WebSocketPair();\n  const server = pair[0];\n  server.accept();\n\n  let client: RpcStub<TransportClientEvents> | undefined;\n  let closed = false;\n  let close = { code: 1000, reason: \"\", wasClean: true };\n\n  const connection = new CapnWebConnection(connectionId, request.url, {\n    send: (message) => {\n      void client?.message(message).catch((error: unknown) => {\n        if (!closed) console.error(\"Cap'n Web frame delivery failed:\", error);\n      });\n    },\n    close: (code = 1000, reason = \"\") => {\n      // Same contract as WebSocket.close(): a reserved code or an oversize\n      // reason throws before anything changes, and the socket stays open\n      // and tracked. Only a started handshake finishes the session.\n      server.close(code, reason);\n      close = { code, reason, wasClean: true };\n      void finish();\n    }\n  }) as unknown as Connection & CapnWebConnection;\n\n  const session: CapnWebSession = {\n    connection,\n    dispose: () => connection.close(1001, \"Session replaced\")\n  };\n\n  const finish = async () => {\n    if (closed) return;\n    closed = true;\n    connection.readyState = WebSocket.CLOSED;\n    try {\n      client?.[Symbol.dispose]();\n    } catch {\n      // The session already ended with the socket.\n    }\n    options.onDispose(session);\n    await options.onClose(connection, close.code, close.reason, close.wasClean);\n  };\n\n  const rootMethods = new Map<string, CallableInvoker>(\n    options.callables(connection)\n  );\n  rootMethods.set(CAPNWEB_TRANSPORT_SEND, (message) =>\n    options.onMessage(connection, message as TransportMessage)\n  );\n  client = newWebSocketRpcSession<TransportClientEvents>(\n    server,\n    buildRoot(rootMethods)\n  );\n\n  server.addEventListener(\n    \"close\",\n    (event) => {\n      close = {\n        code: event.code,\n        reason: event.reason,\n        wasClean: event.wasClean\n      };\n      void finish();\n    },\n    { once: true }\n  );\n  server.addEventListener(\n    \"error\",\n    (event) => {\n      if (closed) return;\n      close = { ...close, wasClean: false };\n      const error =\n        event instanceof ErrorEvent\n          ? (event.error ?? new Error(event.message))\n          : new Error(\"Cap'n Web transport socket error\");\n      void options\n        .onError(connection, error)\n        .catch((handlerError: unknown) => {\n          console.error(\"Cap'n Web onError handler failed:\", handlerError);\n        })\n        .finally(finish);\n    },\n    { once: true }\n  );\n\n  const ctx = { request };\n  // Same limits as the hibernating wire (count, emptiness, length), so a\n  // handler sees one tag policy whichever transport the client chose.\n  connection.tags = prepareTags(\n    connectionId,\n    await options.tags(connection, ctx)\n  );\n  options.onOpen(session);\n  try {\n    await options.onConnect(connection, ctx);\n  } catch (error) {\n    connection.close(1011, \"onConnect failed\");\n    throw error;\n  }\n\n  return {\n    response: new Response(null, { status: 101, webSocket: pair[1] }),\n    session\n  };\n}\n","import { RpcTarget } from \"cloudflare:workers\";\nimport { nanoid } from \"nanoid\";\nimport {\n  LifecycleCapability,\n  type CapabilityWebSocketUpgradeContext,\n  type Connection,\n  type ConnectionContext,\n  type ConnectionSetStateFn,\n  type ConnectionState\n} from \"../lifecycle\";\nimport { MessageType } from \"../types\";\nimport { camelCaseToKebabCase } from \"../utils\";\nimport {\n  ConnectionManager,\n  createConnection,\n  isManagedWebSocket\n} from \"./connection\";\nimport {\n  ensureConnectionWrapped,\n  isConnectionProtocolEnabled,\n  isConnectionReadonly,\n  setConnectionProtocolEnabled,\n  setConnectionReadonly\n} from \"./connection-flags\";\nimport { exposableMethods, type CallableInvoker } from \"./callables-target\";\nimport type {\n  SyncedState,\n  WebSocketHandlers,\n  WebSocketMessage,\n  WebSocketsOptions\n} from \"./options\";\nimport { openCapnWebSession, type CapnWebSession } from \"./transport\";\nimport { isCapnWebTransportUpgrade } from \"./transport-protocol\";\n\n/**\n * Reserved close codes the runtime synthesizes when there was no real\n * Close frame from the peer (1005 NoStatusReceived, 1006 AbnormalClosure,\n * 1015 TLSHandshake). They cannot appear in an outgoing Close frame, and\n * there is no peer left to receive a reciprocation.\n */\nfunction isReservedCloseCode(code: number): boolean {\n  return code === 1005 || code === 1006 || code === 1015;\n}\n\n/**\n * Reciprocate a peer-initiated Close frame to complete the handshake, as\n * the Hibernation API contract requires. Best-effort: swallows errors\n * from already-closed sockets or invalid codes/reasons, and skips\n * reciprocation entirely for reserved codes (dead transport).\n */\nfunction reciprocateClose(ws: WebSocket, code: number, reason: string): void {\n  if (isReservedCloseCode(code)) return;\n  try {\n    ws.close(code, reason);\n  } catch {\n    // Already closed, oversize reason, or another unrecoverable\n    // invariant — the handshake is either done or out of our control.\n  }\n}\n\n/** The `rpc` request frame `useAgent().call` and `AgentClient.call` send. */\ntype RpcRequest = {\n  readonly type: \"rpc\";\n  readonly id: string;\n  readonly method: string;\n  readonly args: unknown[];\n};\n\ntype RpcResponse =\n  | { type: \"rpc\"; id: string; success: true; done: boolean; result: unknown }\n  | { type: \"rpc\"; id: string; success: false; error: string };\n\n/** The `cf_agent_state` frame a client sends to update host state. */\ntype StateFrame = { readonly type: \"cf_agent_state\"; readonly state: unknown };\n\nfunction isStateFrame(value: unknown): value is StateFrame {\n  if (typeof value !== \"object\" || value === null) return false;\n  const frame = value as Record<string, unknown>;\n  return frame.type === MessageType.CF_AGENT_STATE && \"state\" in frame;\n}\n\n/** Parse a text frame; anything that is not JSON is `undefined`. */\nfunction parseJson(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isRpcRequest(value: unknown): value is RpcRequest {\n  if (typeof value !== \"object\" || value === null) return false;\n  const frame = value as Record<string, unknown>;\n  return (\n    frame.type === MessageType.RPC &&\n    typeof frame.id === \"string\" &&\n    typeof frame.method === \"string\" &&\n    Array.isArray(frame.args)\n  );\n}\n\n/**\n * Opt-in WebSocket support for Lifecycle Objects.\n *\n * Lifecycle itself does not model WebSockets — hosts that want them\n * install this capability, which owns the connection subsystem end to\n * end: it claims upgrades, dispatches `onConnect`/`onMessage`/`onClose`\n * inside the host invocation boundary, reciprocates close handshakes,\n * and answers `getConnections()`/`getConnection()`.\n *\n * ```ts\n * class Room extends DurableObject<Env> {\n *   readonly webSockets = new WebSockets({\n *     handlers: {\n *       onConnect: (connection) => connection.send(\"welcome\"),\n *       onMessage: (connection, message) => { ... }\n *     },\n *     callables: new RoomCallables()\n *   });\n *   readonly lifecycle = Lifecycle.install(this).use(this.webSockets);\n * }\n * ```\n *\n * Connections arrive on one of two wires, chosen by the client:\n *\n * - **cf-websocket** (default): accepted with the Hibernation API. Idle\n *   clients stay connected while the Durable Object leaves memory.\n * - **capnweb** (`?__agents_transport=capnweb`): protocol frames through\n *   one pipe method on a Cap'n Web session whose root also carries the\n *   host's callables natively. Non-hibernating — the object stays pinned\n *   while the connection is open.\n *\n * Both wires dispatch the same handlers and appear in `getConnections()`.\n * On both, the capability speaks the Agent protocol a plain host needs\n * for `useAgent` and `AgentClient`: it sends the identity frame on\n * connect, and it serves `callables` — as `rpc` JSON frames on the\n * WebSocket wire, and natively on the Cap'n Web session root, where an\n * `RpcTarget` result becomes a live stub and calls pipeline. `call()`\n * and `stub` work against a plain Durable Object exactly as against an\n * `Agent`. Pass a `State` capability as `state` and the hook's\n * `state`/`setState` work too: the current value is pushed on connect\n * and client updates are validated and applied; the state owner\n * broadcasts changes with `broadcastState()`. Per-connection readonly\n * and no-protocol flags live here as well, for every host.\n */\nexport class WebSockets extends LifecycleCapability {\n  /** Claims every upgrade, so Lifecycle dispatches it after all others. */\n  override readonly claims = \"catch-all\";\n\n  readonly #handlers: WebSocketHandlers | undefined;\n  /** Handlers added with `use`, run before the configured ones. */\n  readonly #added: WebSocketHandlers[] = [];\n  readonly #getConnectionTags: WebSocketsOptions[\"getConnectionTags\"];\n  readonly #protocol: WebSocketsOptions[\"protocol\"];\n  readonly #readonly: WebSocketsOptions[\"readonly\"];\n  readonly #state: SyncedState | undefined;\n  /**\n   * Connections inside their connect sequence, before the state push.\n   * `broadcastState()` skips them: reading state for the push can seed the\n   * initial value, whose change broadcast would otherwise reach a\n   * connection that is about to receive the same value directly.\n   */\n  readonly #connecting = new Set<Connection>();\n  readonly #callables: ReadonlyMap<string, CallableInvoker>;\n  readonly #sessions = new Map<string, CapnWebSession>();\n  #manager: ConnectionManager | undefined;\n\n  constructor(options: WebSocketsOptions = {}) {\n    super(\"websockets\");\n    this.#handlers = options.handlers;\n    this.#getConnectionTags = options.getConnectionTags;\n    this.#protocol = options.protocol ?? true;\n    this.#readonly = options.readonly;\n    this.#state = options.state;\n    this.#callables = options.callables\n      ? exposableMethods(options.callables)\n      : new Map();\n  }\n\n  // ── Lifecycle capability hooks ─────────────────────────────────────────\n\n  /**\n   * Claim every upgrade, never declining: a Cap'n Web transport upgrade\n   * becomes a session, everything else a tracked hibernating connection,\n   * whether or not handlers or callables are configured. Handlers only add\n   * behavior on connect, message, close, and error.\n   */\n  onWebSocketUpgrade({\n    request\n  }: CapabilityWebSocketUpgradeContext): Promise<Response> {\n    return isCapnWebTransportUpgrade(request)\n      ? this.#acceptCapnWebSession(request)\n      : this.#acceptConnection(request);\n  }\n\n  /** Dispatch a platform message wake for a capability-owned socket. */\n  async onWebSocketMessage(\n    ws: WebSocket,\n    message: WebSocketMessage\n  ): Promise<boolean> {\n    if (!isManagedWebSocket(ws)) return false;\n    await this.#message(createConnection(ws), message);\n    return true;\n  }\n\n  /** Dispatch and reciprocate a close wake for an owned socket. */\n  async onWebSocketClose(\n    ws: WebSocket,\n    code: number,\n    reason: string,\n    wasClean: boolean\n  ): Promise<boolean> {\n    if (!isManagedWebSocket(ws)) return false;\n    try {\n      await this.#close(createConnection(ws), code, reason, wasClean);\n    } finally {\n      reciprocateClose(ws, code, reason);\n    }\n    return true;\n  }\n\n  /** Dispatch an error wake for an owned socket. */\n  async onWebSocketError(ws: WebSocket, error: unknown): Promise<boolean> {\n    if (!isManagedWebSocket(ws)) return false;\n    await this.#error(createConnection(ws), error);\n    return true;\n  }\n\n  /**\n   * Close every owned connection during explicit host destruction. The\n   * capability owns its sockets' lifetimes, so it also owns tearing\n   * them down.\n   */\n  dispose(): void {\n    for (const connection of this.getConnections()) {\n      try {\n        connection.close(1001, \"Durable Object destroyed\");\n      } catch {\n        // Already closed or mid-handshake — nothing left to tear down.\n      }\n    }\n  }\n\n  /**\n   * Add handlers for another component sharing these connections, such as\n   * a protocol of its own. They run before the configured handlers, and\n   * their `onMessage` can claim a message by returning true.\n   */\n  use(handlers: WebSocketHandlers): void {\n    this.#added.push(handlers);\n  }\n\n  // ── Connections ────────────────────────────────────────────────────────\n\n  /** Open connections on either wire, optionally by tag. */\n  *getConnections<TState = unknown>(\n    tag?: string\n  ): IterableIterator<Connection<TState>> {\n    for (const { connection } of this.#sessions.values()) {\n      if (connection.readyState !== WebSocket.OPEN) continue;\n      if (!tag || connection.tags.includes(tag)) {\n        yield connection as Connection<TState>;\n      }\n    }\n    yield* this.#connectionManager.getConnections<TState>(tag);\n  }\n\n  /** One connection on either wire, by id. */\n  getConnection<TState = unknown>(id: string): Connection<TState> | undefined {\n    const session = this.#sessions.get(id)?.connection;\n    if (session && session.readyState === WebSocket.OPEN) {\n      return session as Connection<TState>;\n    }\n    return this.#connectionManager.getConnection<TState>(id);\n  }\n\n  get #connectionManager(): ConnectionManager {\n    this.#manager ??= new ConnectionManager(this.lifecycle.sockets);\n    return this.#manager;\n  }\n\n  // ── Wire-independent protocol ──────────────────────────────────────────\n\n  async #connect(\n    connection: Connection,\n    ctx: ConnectionContext\n  ): Promise<void> {\n    ensureConnectionWrapped(connection);\n    // Flags first, so they are set before the client can respond.\n    if (this.#readonly?.(connection, ctx)) {\n      setConnectionReadonly(connection, true);\n    }\n    if (this.#protocol !== false) {\n      const enabled =\n        typeof this.#protocol === \"function\"\n          ? this.#protocol(connection, ctx)\n          : true;\n      if (enabled) {\n        this.sendConnectFrames(connection);\n      } else {\n        setConnectionProtocolEnabled(connection, false);\n      }\n    }\n    for (const handlers of [...this.#added, this.#handlers]) {\n      await this.lifecycle.runInHostContext(\n        () => handlers?.onConnect?.(connection, ctx),\n        { connection, request: ctx.request }\n      );\n    }\n  }\n\n  async #message(\n    connection: Connection,\n    message: WebSocketMessage\n  ): Promise<void> {\n    if (\n      this.#state &&\n      this.#protocol !== false &&\n      typeof message === \"string\"\n    ) {\n      const frame = parseJson(message);\n      if (isStateFrame(frame)) {\n        // Inside the host boundary, so the host's validator and change\n        // hook see the sending connection through the ambient context.\n        await this.lifecycle.runInHostContext(\n          () => this.applyStateFrame(connection, frame),\n          { connection }\n        );\n        return;\n      }\n    }\n    if (\n      this.#callables.size > 0 &&\n      (await this.#answerRpc(connection, message))\n    ) {\n      return;\n    }\n    for (const handlers of this.#added) {\n      const claimed = await this.lifecycle.runInHostContext(\n        () => handlers.onMessage?.(connection, message),\n        { connection }\n      );\n      if (claimed === true) return;\n    }\n    await this.lifecycle.runInHostContext(\n      () => this.#handlers?.onMessage?.(connection, message),\n      { connection }\n    );\n  }\n\n  #close(\n    connection: Connection,\n    code: number,\n    reason: string,\n    wasClean: boolean\n  ): Promise<unknown> {\n    return this.#each((handlers) =>\n      this.lifecycle.runInHostContext(\n        () => handlers?.onClose?.(connection, code, reason, wasClean),\n        { connection }\n      )\n    );\n  }\n\n  #error(connection: Connection, error: unknown): Promise<unknown> {\n    return this.#each((handlers) =>\n      this.lifecycle.runInHostContext(\n        () => handlers?.onError?.(connection, error),\n        { connection }\n      )\n    );\n  }\n\n  async #each(\n    run: (handlers: WebSocketHandlers | undefined) => Promise<unknown>\n  ): Promise<void> {\n    for (const handlers of [...this.#added, this.#handlers])\n      await run(handlers);\n  }\n\n  // ── Hibernating wire ───────────────────────────────────────────────────\n\n  async #acceptConnection(request: Request): Promise<Response> {\n    const { 0: clientWebSocket, 1: serverWebSocket } = new WebSocketPair();\n    const url = new URL(request.url);\n    // `||`, not `??`: an empty `?_pk=` value must fall back to a\n    // generated id — an empty connection id would later throw in tag\n    // validation and reject the upgrade.\n    const connectionId = url.searchParams.get(\"_pk\") || nanoid();\n\n    let connection: Connection = Object.assign(serverWebSocket, {\n      id: connectionId,\n      uri: request.url,\n      tags: [] as string[],\n      state: null as unknown as ConnectionState<unknown>,\n      setState<T = unknown>(setState: T | ConnectionSetStateFn<T>) {\n        // Pre-accept shim: hold state on the socket until accept()\n        // persists it into the hibernation attachment.\n        const state =\n          setState instanceof Function\n            ? setState(this.state as ConnectionState<T>)\n            : setState;\n        this.state = state as ConnectionState<T>;\n        return this.state as ConnectionState<T>;\n      }\n    });\n\n    const ctx = { request };\n    const tags = this.#getConnectionTags\n      ? await this.#getConnectionTags(connection, ctx)\n      : [];\n\n    // Hibernating WebSockets remain connected while the object is evicted.\n    connection = this.#connectionManager.accept(connection, { tags });\n    await this.#connect(connection, ctx);\n\n    return new Response(null, { status: 101, webSocket: clientWebSocket });\n  }\n\n  // ── Cap'n Web wire ─────────────────────────────────────────────────────\n\n  async #acceptCapnWebSession(request: Request): Promise<Response> {\n    const connectionId =\n      new URL(request.url).searchParams.get(\"_pk\") || nanoid();\n    // A reconnect reusing the id replaces the previous session.\n    this.#sessions.get(connectionId)?.dispose();\n\n    const { response } = await openCapnWebSession({\n      request,\n      connectionId,\n      tags: (connection, ctx) =>\n        this.#getConnectionTags?.(connection, ctx) ?? [],\n      onConnect: (connection, ctx) => this.#connect(connection, ctx),\n      onMessage: (connection, message) => this.#message(connection, message),\n      onClose: (connection, code, reason, wasClean) =>\n        this.#close(connection, code, reason, wasClean).then(() => undefined),\n      onError: (connection, error) =>\n        this.#error(connection, error).then(() => undefined),\n      callables: (connection) => this.#nativeCallables(connection),\n      onOpen: (session) => this.#sessions.set(connectionId, session),\n      onDispose: (ended) => {\n        if (this.#sessions.get(connectionId) === ended) {\n          this.#sessions.delete(connectionId);\n        }\n      }\n    });\n    return response;\n  }\n\n  // ── Protocol frames ────────────────────────────────────────────────────\n  //\n  // The Agent protocol a client (`useAgent`, `AgentClient`) speaks, owned\n  // here for every host. With `protocol: true` the capability drives the\n  // connect sequence and consumes state frames itself; with\n  // `protocol: false` the host calls these at the moments it chooses.\n\n  /**\n   * Send the connect sequence: the identity frame, then the current state\n   * when one is stored. The identity carries `stateFollows` in that case,\n   * so clients resolve `ready` only once the state has landed. Nothing is\n   * sent to a no-protocol connection. Identity defaults as for\n   * `sendIdentity()`.\n   */\n  sendConnectFrames(\n    connection: Connection,\n    identity: { name: string; agent: string } = this.#defaultIdentity()\n  ): void {\n    if (!isConnectionProtocolEnabled(connection)) return;\n    this.#connecting.add(connection);\n    try {\n      const current = this.#state?.get();\n      // Serialized first: a flagged identity must never go out without\n      // the state frame the client will wait for.\n      const stateFrame =\n        current === undefined\n          ? undefined\n          : JSON.stringify({\n              type: MessageType.CF_AGENT_STATE,\n              state: current\n            });\n      this.#sendFrame(connection, {\n        type: MessageType.CF_AGENT_IDENTITY,\n        name: identity.name,\n        agent: identity.agent,\n        ...(stateFrame !== undefined && { stateFollows: true })\n      });\n      if (stateFrame !== undefined) this.#send(connection, stateFrame);\n    } finally {\n      this.#connecting.delete(connection);\n    }\n  }\n\n  /**\n   * Send the identity frame alone, unless the connection is no-protocol.\n   * Clients resolve `ready` on it, so a host that also pushes state on\n   * connect should use `sendConnectFrames()`. The defaults are the Durable\n   * Object's routed name and host class; a host whose public identity\n   * differs — an `Agent` facet, whose routed name is an internal encoding\n   * of its logical name — passes its own.\n   */\n  sendIdentity(\n    connection: Connection,\n    identity: { name: string; agent: string } = this.#defaultIdentity()\n  ): void {\n    if (!isConnectionProtocolEnabled(connection)) return;\n    this.#sendFrame(connection, {\n      type: MessageType.CF_AGENT_IDENTITY,\n      name: identity.name,\n      agent: identity.agent\n    });\n  }\n\n  #defaultIdentity(): { name: string; agent: string } {\n    return {\n      name: this.lifecycle.name,\n      agent: camelCaseToKebabCase(this.lifecycle.className)\n    };\n  }\n\n  /**\n   * Send the current state to one connection, unless nothing is stored\n   * or the connection is no-protocol. Reading the state may seed the\n   * initial value; see `#connecting`.\n   */\n  sendState(connection: Connection): void {\n    if (!this.#state || !isConnectionProtocolEnabled(connection)) return;\n    const current = this.#state.get();\n    if (current === undefined) return;\n    this.#sendFrame(connection, {\n      type: MessageType.CF_AGENT_STATE,\n      state: current\n    });\n  }\n\n  /**\n   * Apply a parsed `cf_agent_state` frame from a client. A readonly\n   * connection is refused; a change the host's validator rejects is\n   * logged in full server-side and answered with a generic\n   * `cf_agent_state_error`. Broadcasting the accepted change is the state\n   * owner's call, through its `onChanged` hook. Callers that drive the\n   * protocol themselves call this inside their own invocation context;\n   * the capability's automatic path does so via `runInHostContext`.\n   *\n   * @returns Whether the frame was a state frame (handled either way).\n   */\n  applyStateFrame(connection: Connection, frame: unknown): boolean {\n    if (!this.#state || !isStateFrame(frame)) return false;\n    if (isConnectionReadonly(connection)) {\n      this.#sendFrame(connection, {\n        type: MessageType.CF_AGENT_STATE_ERROR,\n        error: \"Connection is readonly\"\n      });\n      return true;\n    }\n    try {\n      // `never` on the port keeps any `State<T>` assignable; the value\n      // came off the wire, so the host's validator is what checks it.\n      this.#state.set(frame.state as never, connection);\n    } catch (error) {\n      console.error(\"[WebSockets] State update rejected:\", error);\n      this.#sendFrame(connection, {\n        type: MessageType.CF_AGENT_STATE_ERROR,\n        error: \"State update rejected\"\n      });\n    }\n    return true;\n  }\n\n  /**\n   * Push the current state to every protocol-enabled connection except\n   * the one a change came from, which already has the value it sent.\n   * Wire a `State`'s `onChanged` to this.\n   */\n  broadcastState(except?: Connection | \"server\"): void {\n    if (!this.#state) return;\n    const current = this.#state.get();\n    if (current === undefined) return;\n    const frame = { type: MessageType.CF_AGENT_STATE, state: current };\n    for (const connection of this.getConnections()) {\n      // Object identity, not id: `_pk` is client-supplied, so two live\n      // sockets can share an id, and excluding by id would starve the\n      // other one. `createConnection` returns one wrapper per socket.\n      if (connection === except) continue;\n      if (this.#connecting.has(connection)) continue;\n      if (!isConnectionProtocolEnabled(connection)) continue;\n      this.#sendFrame(connection, frame);\n    }\n  }\n\n  // ── Connection flags ───────────────────────────────────────────────────\n\n  /** Whether the connection may update host state over the wire. */\n  isReadonly(connection: Connection): boolean {\n    return isConnectionReadonly(connection);\n  }\n\n  /** Mark a connection readonly, or writable again. */\n  setReadonly(connection: Connection, readonly = true): void {\n    setConnectionReadonly(connection, readonly);\n  }\n\n  /** Whether protocol text frames reach the connection. */\n  isProtocolEnabled(connection: Connection): boolean {\n    return isConnectionProtocolEnabled(connection);\n  }\n\n  /** Enable or suppress protocol text frames for a connection. */\n  setProtocolEnabled(connection: Connection, enabled: boolean): void {\n    setConnectionProtocolEnabled(connection, enabled);\n  }\n\n  /**\n   * Send one protocol frame. Serialization is the caller's contract — every\n   * frame built here is plain JSON — while a send failure is tolerated: the\n   * peer may have disconnected between the wake and the send.\n   */\n  #sendFrame(connection: Connection, frame: Record<string, unknown>): void {\n    this.#send(connection, JSON.stringify(frame));\n  }\n\n  /** Write one already-serialized frame, tolerating a closed peer. */\n  #send(connection: Connection, text: string): void {\n    try {\n      connection.send(text);\n    } catch {\n      // The socket closed between the wake and the send.\n    }\n  }\n\n  // ── Callables ──────────────────────────────────────────────────────────\n\n  /**\n   * The `callables` target as native Cap'n Web methods for one session:\n   * every method dispatches through the host boundary with this\n   * connection in scope and emits `rpc`/`rpc:error` events. Return values\n   * keep Cap'n Web semantics — an `RpcTarget` comes back as a live stub.\n   */\n  #nativeCallables(\n    connection: Connection\n  ): ReadonlyMap<string, CallableInvoker> {\n    const methods = new Map<string, CallableInvoker>();\n    for (const [name, invoke] of this.#callables) {\n      methods.set(name, (...args) =>\n        this.#dispatchCallable(name, () => invoke(...args), connection)\n      );\n    }\n    return methods;\n  }\n\n  /**\n   * Answer one `rpc` frame against `callables`. A `ReadableStream`\n   * result streams as `done: false` chunks followed by a final\n   * `done: true` frame, matching the client's stream callbacks.\n   *\n   * @returns Whether the message was an `rpc` frame (answered or not).\n   */\n  async #answerRpc(\n    connection: Connection,\n    raw: WebSocketMessage\n  ): Promise<boolean> {\n    if (typeof raw !== \"string\") return false;\n    let frame: unknown;\n    try {\n      frame = JSON.parse(raw);\n    } catch {\n      return false;\n    }\n    if (!isRpcRequest(frame)) return false;\n    const { id, method, args } = frame;\n\n    const invoke = this.#callables.get(method);\n    if (!invoke) {\n      this.#reply(connection, {\n        type: \"rpc\",\n        id,\n        success: false,\n        error: `Method ${method} does not exist`\n      });\n      return true;\n    }\n\n    try {\n      const result = await this.#dispatchCallable(\n        method,\n        () => invoke(...args),\n        connection\n      );\n      if (result instanceof RpcTarget) {\n        // By-reference results only exist on the Cap'n Web wire; a JSON\n        // frame would silently flatten the target to `{}`.\n        throw new Error(\n          `Method ${method} returns an RpcTarget, which only the capnweb transport can carry`\n        );\n      }\n      if (result instanceof ReadableStream) {\n        for await (const chunk of result) {\n          this.#reply(connection, {\n            type: \"rpc\",\n            id,\n            success: true,\n            done: false,\n            result: chunk\n          });\n        }\n        this.#reply(connection, {\n          type: \"rpc\",\n          id,\n          success: true,\n          done: true,\n          result: undefined\n        });\n      } else {\n        this.#reply(connection, {\n          type: \"rpc\",\n          id,\n          success: true,\n          done: true,\n          result\n        });\n      }\n    } catch (error) {\n      this.#reply(connection, {\n        type: \"rpc\",\n        id,\n        success: false,\n        error: error instanceof Error ? error.message : String(error)\n      });\n    }\n    return true;\n  }\n\n  #reply(connection: Connection, response: RpcResponse): void {\n    let text: string;\n    try {\n      text = JSON.stringify(response);\n    } catch (error) {\n      // A result that JSON cannot carry (a BigInt, a cycle) must still\n      // settle the caller: answer with an error instead of silence.\n      text = JSON.stringify({\n        type: \"rpc\",\n        id: response.id,\n        success: false,\n        error: `Result is not JSON-serializable: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      } satisfies RpcResponse);\n    }\n    this.#send(connection, text);\n  }\n\n  async #dispatchCallable(\n    name: string,\n    invoke: () => unknown,\n    connection: Connection\n  ): Promise<unknown> {\n    // Throws with installation guidance when the capability was never\n    // installed with Lifecycle.use().\n    const services = this.lifecycle;\n    try {\n      const result = await services.runInHostContext(invoke, { connection });\n      services.events.emit(\"rpc\", {\n        method: name,\n        streaming: result instanceof ReadableStream\n      });\n      return result;\n    } catch (error) {\n      services.events.emit(\"rpc:error\", {\n        method: name,\n        error: error instanceof Error ? error.message : String(error)\n      });\n      throw error;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/workflow-types.d.ts

@@ -23,7 +23,7 @@ import {
   wt as WorkflowPage,
   xt as WorkflowEventCallback,
   yt as WorkflowCompleteCallback
-} from "./agent-routing-Bhdbvf7s.js";
+} from "./agent-routing-QDcchcQP.js";
 export {
   AgentWorkflowEvent,
   AgentWorkflowInternalParams,

package/dist/workflows.d.ts

@@ -20,7 +20,7 @@ import {
   wt as WorkflowPage,
   xt as WorkflowEventCallback,
   yt as WorkflowCompleteCallback
-} from "./agent-routing-Bhdbvf7s.js";
+} from "./agent-routing-QDcchcQP.js";
 import { WorkflowEntrypoint, WorkflowEvent } from "cloudflare:workers";
 
 //#region src/workflows.d.ts

package/dist/workflows.js

@@ -1,6 +1,6 @@
 import { isInternalJsStubProp } from "./utils.js";
 import { getAgentByName } from "./agent-routing.js";
-import "./src-DgCbZtIR.js";
+import "./src-CQxJFv4l.js";
 import { WorkflowRejectedError } from "./workflow-types.js";
 import { WorkflowEntrypoint } from "cloudflare:workers";
 //#region src/workflows.ts

package/docs/browse-the-web.md

@@ -18,7 +18,7 @@ Browser tools are useful when your agent needs to:
 - **Capture screenshots or PDFs** — visual snapshots of web content
 - **Profile performance** — Core Web Vitals, JavaScript profiling, memory analysis
 
-For simple page fetches where you do not need a full browser, `fetch()` is simpler.
+For simple page fetches where you do not need a full browser, `fetch()` is simpler. To let a model read pages as Markdown without a browser, use the [`web_fetch` tool](./fetch-the-web.md) from `agents/webfetch`.
 
 ## Installation
 
@@ -235,6 +235,8 @@ export class MyAgent extends Think<Env> {
 ```
 
 - The model writes CDP code as with `createBrowserTools`. `sessionId: "active"` points at the tab it's working in, and that tab is remembered across turns.
+- If several chats or users share one `Browser` (for example, many threads on one agent), pass each one's id as `scope`: `browserTool({ browser, loader, scope: threadId })`. Each scope keeps its own active tab, so one chat never drives another's page, while cookies and logins stay shared. Tools that leave `scope` out share one tab. Runs in the same scope wait for each other; runs in different scopes run in parallel.
+- When another chat closes the model's tab, or works in it too, the result's `notice` says so.
 - Tabs the page opens itself come back as `newTabs` in the result.
 - If the browser was lost (idle past `keepAliveMs`, closed, or crashed), the code still runs in a new browser and the result includes `restarted: true`.
 - Call `this.browser.liveView()` to give a person a Live View link into the same browser, and `this.browser.close()` to shut it down.
@@ -259,6 +261,29 @@ const stream = chat({
 
 The TanStack AI tool doesn't support screenshots yet. TanStack AI gives the host and the model the same output, so if the model returns a screenshot, the tool replaces it with a note saying it was left out, and the tool's instructions tell the model to read the page with `Runtime.evaluate` instead.
 
+For [pi-durable](./harnesses/pi.md), import `browserTool` from `agents/browser/pi` and install it in an extension. It takes the same options plus an optional `name` (default `"browser"`). Outside an `Agent`, pass `ctx`:
+
+```ts
+import { browserTool } from "agents/browser/pi";
+
+this.registry.install({
+  name: "browser",
+  tools: [
+    browserTool({
+      ctx: this.ctx,
+      browser: this.browser,
+      loader: this.env.LOADER
+    })
+  ]
+});
+```
+
+- A returned screenshot comes back as an image in the tool result, so the model can see the page and a UI can show it from the transcript. pi-ai only sends the image to models that accept images; other models get the text alone.
+- Each pi conversation gets its own active tab: `scope` defaults to the calling conversation, so sessions, forks, and subagents on one object don't drive each other's page. Cookies and logins are shared. Pass `scope` as a string to share one tab, or as a function of the call (`(api) => string`) to choose.
+- A conversation's calls run one at a time, since they share its tab.
+- pi doesn't rerun a browser call cut off by an eviction, because the code may have clicked or submitted something. The model gets an interrupted result and can try again; the browser itself is still there.
+- Stopping a conversation doesn't stop a browser call already running. It finishes or times out (`timeoutMs`, default 60 seconds).
+
 ## Quick Actions (stateless browsing)
 
 `browser_execute` drives a full, stateful CDP session — the right tool for interactive, multi-step automation. But a lot of agent browsing is really one-shot: _read this page as Markdown_, _extract these fields_, _list the links_. For those, [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/) are simpler, faster, and cheaper. They need only the `browser` binding — no Durable Object, Worker Loader, or sandbox — so they work from any Worker.