agents 0.27.0 → 0.28.1

package/dist/tool-VF0qiO7q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-VF0qiO7q.js","names":[],"sources":["../src/web/search/contract.ts","../src/web/search/source.ts","../src/web/search/tool.ts"],"sourcesContent":["/**\n * The `web_search` tool contract: its name, what it tells the model, what the\n * model passes in, what comes back, and how results are rendered for the\n * model. Shared by every executor of the tool — the harness-executed\n * adapters in `agents/websearch/*` today, and a gateway-executed variant in\n * `agents/models/*` once AI Gateway server tools ship — so a `web_search` call\n * looks the same in a transcript whoever ran it.\n */\n\n/**\n * The tool's name, as the model calls it and as it appears in transcripts.\n * `web_search` is the name models know from Anthropic's and OpenAI's built-in\n * search tools.\n */\nexport const WEB_SEARCH_TOOL_NAME = \"web_search\";\n\n/** The default number of results when the model doesn't ask for a count. */\nexport const DEFAULT_WEB_SEARCH_LIMIT = 5;\n\n/** The most results one search can return; the API rejects more. */\nexport const MAX_WEB_SEARCH_LIMIT = 10;\n\n/** The longest query the API accepts, in characters. */\nexport const MAX_WEB_SEARCH_QUERY_LENGTH = 1024;\n\n/**\n * Per-result description length in the model's view, in characters. Provider\n * descriptions run to ~8,000 characters (Ceramic returns page text), which at\n * ten results is 80 KB of context per search. The full text stays in the\n * host-side output.\n */\nexport const DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS = 600;\n\n/*\n * These are type aliases, not interfaces: pi stores tool details as strict\n * JSON, and only aliases satisfy its `JsonValue` index signature.\n */\n\n/** What the model says when it wants a search. */\nexport type WebSearchToolInput = {\n  /** The search query. */\n  query: string;\n  /** How many results to return, 1–10. Defaults to the host's `limit`. */\n  limit?: number;\n};\n\n/**\n * One search result. `url` and `title` are always present; the rest only\n * when the provider returns them (Exa adds `imageUrl` and\n * `lastModifiedDate`, Linkup adds `faviconUrl`, Ceramic adds neither).\n */\nexport type WebSearchResult = {\n  url: string;\n  title: string;\n  /** A snippet or extract of the page. Length and style vary by provider. */\n  description?: string;\n  /** ISO 8601 timestamp of the page's last modification. */\n  lastModifiedDate?: string;\n  imageUrl?: string;\n  faviconUrl?: string;\n};\n\n/** The Web Search API's response: results plus request metadata. */\nexport type WebSearchResponse = {\n  items: WebSearchResult[];\n  metadata: {\n    /** The query as the provider saw it. */\n    query: string;\n    /** AI Gateway request id, for the gateway log. */\n    requestId: string;\n    /** Provider latency in milliseconds. */\n    latencyMs: number;\n  };\n};\n\n/**\n * What one `web_search` run produces for the host: the full API response and\n * which provider served it. The model sees {@link renderWebSearchResults}\n * of this.\n */\nexport type WebSearchToolOutput = WebSearchResponse & {\n  /** The provider that ran the search, when the source knows. */\n  provider?: string;\n};\n\nexport const WEB_SEARCH_TOOL_DESCRIPTION = [\n  \"Search the public web. Returns up to `limit` results, each with a URL, a title, and a short description of the page.\",\n  \"Use it for current events, facts you're unsure of, documentation, and anything that may have changed since your training.\",\n  \"There is no next page: for more or different results, search again with a rephrased query.\",\n  \"Results are discovery only: to read a page, fetch its URL with `web_fetch` if it is available.\"\n].join(\" \");\n\nexport interface RenderWebSearchResultsOptions {\n  /**\n   * Trim each description to this many characters in the model's view.\n   * Defaults to {@link DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS}; `Infinity`\n   * disables trimming.\n   */\n  maxDescriptionChars?: number;\n}\n\n/**\n * Render search results as the text the model reads: one numbered block per\n * result, descriptions trimmed and whitespace collapsed.\n */\nexport function renderWebSearchResults(\n  response: WebSearchResponse,\n  options: RenderWebSearchResultsOptions = {}\n): string {\n  const maxChars =\n    options.maxDescriptionChars ?? DEFAULT_WEB_SEARCH_DESCRIPTION_CHARS;\n  if (response.items.length === 0) {\n    return `No results for \"${response.metadata.query}\". Try a broader or rephrased query.`;\n  }\n  const blocks = response.items.map((item, index) => {\n    const lines = [`${index + 1}. ${item.title.trim() || item.url}`, item.url];\n    const description = compactDescription(item.description, maxChars);\n    if (description) lines.push(description);\n    if (item.lastModifiedDate) lines.push(`Modified: ${item.lastModifiedDate}`);\n    return lines.join(\"\\n\");\n  });\n  return [\n    `${response.items.length} result${response.items.length === 1 ? \"\" : \"s\"} for \"${response.metadata.query}\":`,\n    \"\",\n    blocks.join(\"\\n\\n\")\n  ].join(\"\\n\");\n}\n\nfunction compactDescription(\n  description: string | undefined,\n  maxChars: number\n): string | undefined {\n  if (!description) return undefined;\n  const compact = description.replace(/\\s+/g, \" \").trim();\n  if (!compact) return undefined;\n  if (compact.length <= maxChars) return compact;\n  const cut = compact.slice(0, Math.max(0, maxChars - 1));\n  // Back off to the last word boundary, unless that loses too much.\n  const space = cut.lastIndexOf(\" \");\n  const end = space >= cut.length - WORD_BOUNDARY_BACKOFF ? space : cut.length;\n  return `${cut.slice(0, end).trimEnd()}…`;\n}\n\n/** How far truncation backs off to end on a whole word. */\nconst WORD_BOUNDARY_BACKOFF = 20;\n","/**\n * Where searches run. A {@link WebSearchSource} turns a query into a\n * {@link WebSearchResponse}; the tool core is written against it, so the\n * same tool works over the Workers AI binding, the HTTP API, or a fake in\n * tests.\n */\nimport { DEFAULT_GATEWAY_ID } from \"../../models/core/settings\";\nimport { abortable } from \"../abortable\";\nimport {\n  DEFAULT_WEB_SEARCH_LIMIT,\n  MAX_WEB_SEARCH_LIMIT,\n  MAX_WEB_SEARCH_QUERY_LENGTH,\n  type WebSearchResponse,\n  type WebSearchResult\n} from \"./contract\";\n\n/**\n * Search providers behind the Cloudflare Web Search API. `ceramic` is the\n * platform default and the cheapest; `exa` and `linkup` cost more and, in our\n * testing, ranked announcement-style queries noticeably better. Pricing and\n * data-retention terms are in the Web Search docs.\n */\nexport type WebSearchProvider = \"ceramic\" | \"exa\" | \"linkup\";\n\n/** One search request as a source receives it. */\nexport interface WebSearchRequest {\n  /** 1–1024 characters. */\n  query: string;\n  /** 1–10. Defaults to 5. */\n  limit?: number;\n}\n\n/** Per-call options a source receives alongside the request. */\nexport interface WebSearchCallOptions {\n  /** Abort the search. A source should reject with the signal's reason. */\n  signal?: AbortSignal;\n}\n\n/**\n * Runs searches. The tool core calls `search` and renders what comes back.\n * An object rather than a bare function so a wrapper (caching, logging)\n * keeps `provider` by spreading the source it wraps.\n */\nexport interface WebSearchSource {\n  search(\n    request: WebSearchRequest,\n    options?: WebSearchCallOptions\n  ): Promise<WebSearchResponse>;\n  /**\n   * The provider this source searches with, when known. Informational:\n   * recorded on the tool's host output.\n   */\n  readonly provider?: WebSearchProvider;\n}\n\n/** Options shared by the AI-binding and HTTP sources. */\nexport interface WebSearchGatewayOptions {\n  /** AI Gateway id. Defaults to `\"default\"`, which Cloudflare creates on first use. */\n  gateway?: string;\n  /**\n   * Which provider runs the search. Host-chosen; the model never picks.\n   * Defaults to the platform default (`ceramic`).\n   */\n  provider?: WebSearchProvider;\n  /**\n   * The BYOK key alias on the gateway to bill the provider with. When set\n   * and no such key exists the request fails rather than falling back to\n   * AI Gateway credits. When omitted, a key under the `default` alias is\n   * used if one exists, otherwise credits.\n   */\n  byokAlias?: string;\n}\n\n/** A search over the Workers AI binding (`env.AI.websearch`). */\nexport interface AIWebSearchOptions extends WebSearchGatewayOptions {\n  /** The Workers AI binding. Requires `\"ai\": { \"binding\": \"AI\" }` in wrangler.jsonc. */\n  binding: Ai;\n}\n\n/**\n * `Ai.websearch` as `@cloudflare/workers-types` ≥ 5.20260812.1 declares it.\n * This repo can't take that version yet — it breaks `@types/node`'s\n * `Buffer` (cloudflare/workerd#7026) — so the method is spelled out here\n * and the binding is viewed through it. Drop once the repo bumps.\n */\ninterface AiWebSearchBinding {\n  websearch(request: {\n    gatewayId: string;\n    query: string;\n    limit?: number;\n    provider?: string;\n    byokAlias?: string;\n  }): Promise<Response>;\n}\n\n/**\n * Search through the Workers AI binding. The Worker's own account and the\n * named gateway are billed.\n */\nexport function createAIWebSearch(\n  options: AIWebSearchOptions\n): WebSearchSource {\n  validateGatewayOptions(options);\n  const binding = options.binding as unknown as AiWebSearchBinding;\n  const search: WebSearchSource[\"search\"] = async (input, call = {}) => {\n    const request = validateRequest(input);\n    if (typeof binding.websearch !== \"function\") {\n      throw new WebSearchError(\n        \"This Workers runtime has no env.AI.websearch(). Web search needs workerd 1.20260924.1 or later; see https://github.com/cloudflare/agents/blob/main/docs/agents/search-the-web.md.\",\n        {\n          status: 501,\n          code: \"web_search_unsupported_runtime\",\n          retryable: false\n        }\n      );\n    }\n    // Do not start a billed search for a call that is already cancelled.\n    call.signal?.throwIfAborted();\n    // The binding takes no signal, so an abort stops waiting for it.\n    const response = await abortable(\n      binding.websearch({\n        gatewayId: options.gateway ?? DEFAULT_GATEWAY_ID,\n        query: request.query,\n        limit: request.limit,\n        provider: options.provider,\n        byokAlias: options.byokAlias\n      }),\n      call.signal\n    );\n    return readResponse(response, request.query);\n  };\n  return { search, provider: options.provider };\n}\n\n/** A search over the HTTP API, from any runtime with `fetch`. */\nexport interface HTTPWebSearchOptions extends WebSearchGatewayOptions {\n  /** The Cloudflare account the gateway belongs to. */\n  accountId: string;\n  /** An API token with `Workers AI: Read` and `AI Gateway: Read` on that account. */\n  apiToken: string;\n  /** Override for tests. Defaults to the global `fetch`. */\n  fetch?: typeof fetch;\n  /** API origin. Defaults to `https://api.cloudflare.com`. */\n  baseUrl?: string;\n}\n\n/**\n * Search through `POST /accounts/{account_id}/ai/websearch`. Use this\n * outside Workers, or to search through a gateway in another account.\n */\nexport function createHTTPWebSearch(\n  options: HTTPWebSearchOptions\n): WebSearchSource {\n  validateGatewayOptions(options);\n  const doFetch = options.fetch ?? fetch;\n  const baseUrl = (options.baseUrl ?? \"https://api.cloudflare.com\").replace(\n    /\\/+$/,\n    \"\"\n  );\n  const url = `${baseUrl}/client/v4/accounts/${encodeURIComponent(options.accountId)}/ai/websearch/`;\n  const search: WebSearchSource[\"search\"] = async (input, call = {}) => {\n    const request = validateRequest(input);\n    const response = await doFetch(url, {\n      method: \"POST\",\n      signal: call.signal,\n      headers: {\n        Authorization: `Bearer ${options.apiToken}`,\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify({\n        query: request.query,\n        limit: request.limit,\n        provider: options.provider,\n        byokAlias: options.byokAlias,\n        options: { gateway: { id: options.gateway ?? DEFAULT_GATEWAY_ID } }\n      })\n    });\n    return readResponse(response, request.query);\n  };\n  return { search, provider: options.provider };\n}\n\n/** The API's pattern for `byokAlias`. */\nconst BYOK_ALIAS_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;\n\n/** Host configuration errors are programming errors: throw when building. */\nfunction validateGatewayOptions(options: WebSearchGatewayOptions): void {\n  if (\n    options.byokAlias !== undefined &&\n    !BYOK_ALIAS_PATTERN.test(options.byokAlias)\n  ) {\n    throw new RangeError(\n      `byokAlias must be 1–64 letters, digits, \"_\" or \"-\"; got ${JSON.stringify(options.byokAlias)}.`\n    );\n  }\n}\n\n/**\n * Error codes a {@link WebSearchError} carries. The `web_search_*` codes the\n * API returns pass through as-is; failures without one get a code from the\n * HTTP status, so every error has a code to branch on.\n */\nexport type WebSearchErrorCode =\n  /** No AI Gateway credits and no provider key for the search. */\n  | \"web_search_payment_required\"\n  /** `byokAlias` names a key the gateway does not have. */\n  | \"web_search_byok_not_configured\"\n  /** The query, limit, or provider was rejected. */\n  | \"invalid_web_search_input\"\n  /** The gateway does not exist or is not set up. */\n  | \"web_search_gateway_not_configured\"\n  /** The API token or binding is not allowed to search. */\n  | \"web_search_unauthorized\"\n  /** Too many searches; retry later. */\n  | \"web_search_rate_limited\"\n  /** The search took longer than the tool's `timeoutMs`. */\n  | \"web_search_timeout\"\n  /** The API or the provider failed. */\n  | \"web_search_unavailable\"\n  /** The Workers runtime has no `env.AI.websearch()`. */\n  | \"web_search_unsupported_runtime\"\n  /** A code the API added after this release. */\n  | (string & {});\n\n/** Why a search failed, with what the API said. */\nexport class WebSearchError extends Error {\n  override readonly name = \"WebSearchError\";\n  readonly status: number;\n  readonly code: WebSearchErrorCode;\n  /** Whether retrying the same search might succeed. */\n  readonly retryable: boolean;\n  /** AI Gateway's id for the failed request, for the gateway log. */\n  readonly requestId?: string;\n  /** The Cloudflare API's numeric error code, when it gave one. */\n  readonly apiCode?: number;\n\n  constructor(\n    message: string,\n    details: {\n      status: number;\n      code: WebSearchErrorCode;\n      retryable?: boolean;\n      requestId?: string;\n      apiCode?: number;\n      cause?: unknown;\n    }\n  ) {\n    super(message, { cause: details.cause });\n    this.status = details.status;\n    this.code = details.code;\n    this.retryable = details.retryable ?? isRetryableStatus(details.status);\n    this.requestId = details.requestId;\n    this.apiCode = details.apiCode;\n  }\n}\n\n/** Check a request against the API's limits and fill in the default limit. */\nfunction validateRequest(\n  request: WebSearchRequest\n): Required<WebSearchRequest> {\n  const query = request.query.trim();\n  const limit = request.limit ?? DEFAULT_WEB_SEARCH_LIMIT;\n  if (query.length === 0) {\n    throw new WebSearchError(\"Query must not be empty.\", {\n      status: 400,\n      code: \"invalid_web_search_input\"\n    });\n  }\n  if (query.length > MAX_WEB_SEARCH_QUERY_LENGTH) {\n    throw new WebSearchError(\n      `Query must be at most ${MAX_WEB_SEARCH_QUERY_LENGTH} characters.`,\n      { status: 400, code: \"invalid_web_search_input\" }\n    );\n  }\n  if (!Number.isInteger(limit) || limit < 1 || limit > MAX_WEB_SEARCH_LIMIT) {\n    throw new WebSearchError(\n      `Limit must be an integer from 1 to ${MAX_WEB_SEARCH_LIMIT}.`,\n      { status: 400, code: \"invalid_web_search_input\" }\n    );\n  }\n  return { query, limit };\n}\n\nasync function readResponse(\n  response: Response,\n  query: string\n): Promise<WebSearchResponse> {\n  const text = await response.text();\n  let body: unknown;\n  try {\n    body = JSON.parse(text);\n  } catch {\n    body = undefined;\n  }\n  if (!response.ok) throw toWebSearchError(response.status, body, text);\n  const result = toWebSearchResponse(body, query);\n  if (!result) {\n    // A success status with a body that is not a search response is an\n    // upstream fault, likely transient, not a reason to stop searching.\n    throw new WebSearchError(\n      `Web search returned HTTP ${response.status} without search results${text ? `: ${text.slice(0, 200)}` : \"\"}.`,\n      {\n        status: response.status,\n        code: \"web_search_unavailable\",\n        retryable: true\n      }\n    );\n  }\n  return result;\n}\n\n/**\n * Read a 200 body into a {@link WebSearchResponse}, tolerating what a beta\n * API and three providers might send: items without a URL are dropped, a\n * missing title falls back to the URL, unknown or mistyped fields are left\n * out, and missing metadata gets defaults. Only a body with no `items`\n * array is rejected.\n */\nfunction toWebSearchResponse(\n  body: unknown,\n  query: string\n): WebSearchResponse | undefined {\n  if (!isRecord(body) || !Array.isArray(body.items)) return undefined;\n  const items: WebSearchResult[] = [];\n  for (const item of body.items as unknown[]) {\n    if (!isRecord(item)) continue;\n    const url = asString(item.url)?.trim();\n    if (!url) continue;\n    const result: WebSearchResult = {\n      url,\n      title: asString(item.title)?.trim() || url\n    };\n    for (const key of OPTIONAL_RESULT_FIELDS) {\n      const value = asString(item[key]);\n      if (value !== undefined) result[key] = value;\n    }\n    items.push(result);\n  }\n  const metadata = isRecord(body.metadata) ? body.metadata : {};\n  return {\n    items,\n    metadata: {\n      query: asString(metadata.query) ?? query,\n      requestId: asString(metadata.requestId) ?? \"\",\n      latencyMs: typeof metadata.latencyMs === \"number\" ? metadata.latencyMs : 0\n    }\n  };\n}\n\nconst OPTIONAL_RESULT_FIELDS = [\n  \"description\",\n  \"lastModifiedDate\",\n  \"imageUrl\",\n  \"faviconUrl\"\n] as const satisfies readonly (keyof WebSearchResult)[];\n\n/**\n * The API fails in three shapes. Gateway-native:\n * `{ ok: false, error: { category, code, status, retryable, gatewayRequestId } }`.\n * Request validation, the Cloudflare envelope with issue details:\n * `{ success: false, errors: [{ code: 7000, message }], messages: [{ message, path }] }`.\n * Gateway configuration (`AiGatewayError`):\n * `{ success: false, error: [{ code: 2001, message }], message, description }`.\n */\nfunction toWebSearchError(\n  status: number,\n  body: unknown,\n  text: string\n): WebSearchError {\n  if (isRecord(body)) {\n    const error = body.error;\n    if (isRecord(error) && typeof error.code === \"string\") {\n      const errorStatus =\n        typeof error.status === \"number\" ? error.status : status;\n      return new WebSearchError(describeCode(error.code, errorStatus), {\n        status: errorStatus,\n        code: error.code,\n        retryable:\n          typeof error.retryable === \"boolean\" ? error.retryable : undefined,\n        requestId: asString(error.gatewayRequestId)\n      });\n    }\n    const envelope: unknown[] = Array.isArray(body.errors)\n      ? body.errors\n      : Array.isArray(error)\n        ? error\n        : [];\n    const entries = envelope.filter(isRecord);\n    const issues: unknown[] = Array.isArray(body.messages) ? body.messages : [];\n    const message =\n      [\n        ...entries.map((entry) => asString(entry.message)),\n        ...issues.map(describeIssue)\n      ]\n        .filter((m): m is string => Boolean(m))\n        .join(\"; \") || asString(body.message);\n    if (message) {\n      const apiCode = entries\n        .map((entry) => entry.code)\n        .find((code): code is number => typeof code === \"number\");\n      return new WebSearchError(message, {\n        status,\n        code: codeForApiError(apiCode, status),\n        apiCode\n      });\n    }\n  }\n  return new WebSearchError(\n    `Web search failed with HTTP ${status}${text ? `: ${text.slice(0, 200)}` : \"\"}.`,\n    { status, code: codeForStatus(status) }\n  );\n}\n\nfunction codeForApiError(\n  apiCode: number | undefined,\n  status: number\n): WebSearchErrorCode {\n  switch (apiCode) {\n    case 7000:\n      return \"invalid_web_search_input\";\n    case 2001:\n      return \"web_search_gateway_not_configured\";\n    default:\n      return codeForStatus(status);\n  }\n}\n\nfunction codeForStatus(status: number): WebSearchErrorCode {\n  if (status === 400) return \"invalid_web_search_input\";\n  if (status === 401 || status === 403) return \"web_search_unauthorized\";\n  if (status === 402) return \"web_search_payment_required\";\n  if (status === 429) return \"web_search_rate_limited\";\n  return \"web_search_unavailable\";\n}\n\nfunction isRetryableStatus(status: number): boolean {\n  return status === 429 || status >= 500;\n}\n\nfunction describeCode(code: string, status: number): string {\n  switch (code) {\n    case \"web_search_payment_required\":\n      return \"Web search is unavailable: the AI Gateway has no credits and no provider key for this search. Top up AI Gateway credits or store a BYOK key for the provider.\";\n    case \"web_search_byok_not_configured\":\n      return \"Web search is unavailable: the requested BYOK key alias is not configured on the gateway.\";\n    case \"invalid_web_search_input\":\n      return \"The API rejected the request: check the query (1–1024 characters), limit (1–10), and provider (ceramic, exa, or linkup).\";\n    default:\n      return `Web search failed (${code}, HTTP ${status}).`;\n  }\n}\n\nfunction describeIssue(issue: unknown): string | undefined {\n  if (!isRecord(issue)) return undefined;\n  const message = asString(issue.message);\n  if (!message) return undefined;\n  const path = Array.isArray(issue.path) ? issue.path.join(\".\") : \"\";\n  return path ? `${path}: ${message}` : message;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction asString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n","/**\n * The harness-neutral core of the `web_search` tool, shared by the pi\n * (`agents/websearch/pi`), AI SDK (`agents/websearch/ai-sdk`), and TanStack\n * AI (`agents/websearch/tanstack-ai`) adapters. Internal — not an entry point.\n */\nimport {\n  DEFAULT_WEB_SEARCH_LIMIT,\n  MAX_WEB_SEARCH_LIMIT,\n  WEB_SEARCH_TOOL_DESCRIPTION,\n  WEB_SEARCH_TOOL_NAME,\n  renderWebSearchResults,\n  type WebSearchResponse,\n  type WebSearchToolInput,\n  type WebSearchToolOutput\n} from \"./contract\";\nimport { abortable } from \"../abortable\";\nimport {\n  WebSearchError,\n  createAIWebSearch,\n  type AIWebSearchOptions,\n  type WebSearchSource\n} from \"./source\";\n\n/** Search through the Workers AI binding; the tool builds the source. */\nexport type WebSearchToolBindingOptions = AIWebSearchOptions & {\n  source?: never;\n};\n\n/**\n * Search through a source you built. Gateway, provider, and billing belong\n * to the source, so the binding options are not accepted here.\n */\nexport type WebSearchToolSourceOptions = {\n  /** Where searches run, instead of the Workers AI binding. */\n  source: WebSearchSource;\n  binding?: never;\n  gateway?: never;\n  provider?: never;\n  byokAlias?: never;\n};\n\n/**\n * Options every `web_search` tool adapter accepts. Invalid values throw a\n * `RangeError` when the tool is created.\n */\nexport type WebSearchToolOptions = (\n  | WebSearchToolBindingOptions\n  | WebSearchToolSourceOptions\n) & {\n  /**\n   * Results per search when the model doesn't ask for a count, and the most\n   * it gets when it asks for more. An integer from 1 to 10; defaults to 5.\n   */\n  limit?: number;\n  /** Replaces the default tool description. */\n  description?: string;\n  /**\n   * Per-result description length in the model's view. A positive integer;\n   * defaults to 600 characters. `Infinity` passes descriptions through whole.\n   */\n  maxDescriptionChars?: number;\n  /**\n   * Give up on a search after this many milliseconds, as a retryable\n   * `web_search_timeout` failure. A positive integer; defaults to 30 seconds.\n   */\n  timeoutMs?: number;\n};\n\n/** The default for {@link WebSearchToolOptions.timeoutMs}. */\nexport const DEFAULT_WEB_SEARCH_TIMEOUT_MS = 30_000;\n\n/**\n * What one run returns to the adapter: the host output, and the model's\n * text. On failure, `error` is the source's error, with the API's detail for\n * the host, and `text` is what the model should read instead.\n */\nexport type WebSearchToolRun =\n  | { ok: true; output: WebSearchToolOutput; text: string }\n  | { ok: false; error: WebSearchError; text: string };\n\nexport interface WebSearchToolCore {\n  name: typeof WEB_SEARCH_TOOL_NAME;\n  description: string;\n  /** The host's `limit`: the default and the cap for the model's `limit`. */\n  limit: number;\n  /** Render a search's output as the text the model reads. */\n  render(output: WebSearchResponse): string;\n  /**\n   * Run one search. Aborting `signal` rejects with its reason rather than\n   * producing a failed run, so the harness sees a cancelled call.\n   */\n  run(\n    input: WebSearchToolInput,\n    options?: { signal?: AbortSignal }\n  ): Promise<WebSearchToolRun>;\n}\n\nexport function createWebSearchToolCore(\n  options: WebSearchToolOptions\n): WebSearchToolCore {\n  const limit = options.limit ?? DEFAULT_WEB_SEARCH_LIMIT;\n  const timeoutMs = options.timeoutMs ?? DEFAULT_WEB_SEARCH_TIMEOUT_MS;\n  const { maxDescriptionChars } = options;\n  if (!Number.isInteger(limit) || limit < 1 || limit > MAX_WEB_SEARCH_LIMIT) {\n    throw new RangeError(\n      `limit must be an integer from 1 to ${MAX_WEB_SEARCH_LIMIT}; got ${limit}.`\n    );\n  }\n  if (\n    maxDescriptionChars !== undefined &&\n    maxDescriptionChars !== Infinity &&\n    !(Number.isInteger(maxDescriptionChars) && maxDescriptionChars > 0)\n  ) {\n    throw new RangeError(\n      `maxDescriptionChars must be a positive integer or Infinity; got ${maxDescriptionChars}.`\n    );\n  }\n  if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {\n    throw new RangeError(\n      `timeoutMs must be a positive integer; got ${timeoutMs}.`\n    );\n  }\n  const source =\n    options.source === undefined ? createAIWebSearch(options) : options.source;\n  const provider = source.provider;\n  const render = (output: WebSearchResponse) =>\n    renderWebSearchResults(output, { maxDescriptionChars });\n\n  return {\n    name: WEB_SEARCH_TOOL_NAME,\n    description: options.description ?? WEB_SEARCH_TOOL_DESCRIPTION,\n    limit,\n    render,\n    async run(input, { signal } = {}) {\n      signal?.throwIfAborted();\n      const request = {\n        query: input.query,\n        limit: Math.min(clampLimit(input.limit ?? limit), limit)\n      };\n      const timeout = AbortSignal.timeout(timeoutMs);\n      const searchSignal = signal\n        ? AbortSignal.any([signal, timeout])\n        : timeout;\n      try {\n        // Race the source too: a custom source may ignore the signal, and\n        // the deadline must still end the call.\n        const response = await abortable(\n          source.search(request, { signal: searchSignal }),\n          searchSignal\n        );\n        const output: WebSearchToolOutput = provider\n          ? { ...response, provider }\n          : response;\n        return {\n          ok: true,\n          output,\n          text: render(response)\n        };\n      } catch (cause) {\n        if (signal?.aborted) throw signal.reason;\n        const error = toToolError(cause, timeout.aborted, timeoutMs);\n        return { ok: false, error, text: describeFailureForModel(error) };\n      }\n    }\n  };\n}\n\n/**\n * The error a throwing adapter (AI SDK, TanStack AI) raises for a failed\n * run. Those frameworks show the model the error's `message`, so it carries\n * the model's text; the source's error, with the API's detail, is `cause`.\n */\nexport function toolFailure(\n  run: Extract<WebSearchToolRun, { ok: false }>\n): WebSearchError {\n  const { error } = run;\n  return new WebSearchError(run.text, {\n    status: error.status,\n    code: error.code,\n    retryable: error.retryable,\n    requestId: error.requestId,\n    apiCode: error.apiCode,\n    cause: error\n  });\n}\n\nfunction toToolError(\n  cause: unknown,\n  timedOut: boolean,\n  timeoutMs: number\n): WebSearchError {\n  if (timedOut) {\n    return new WebSearchError(`Web search timed out after ${timeoutMs} ms.`, {\n      status: 504,\n      code: \"web_search_timeout\",\n      retryable: true,\n      cause\n    });\n  }\n  if (cause instanceof WebSearchError) return cause;\n  return new WebSearchError(\n    cause instanceof Error ? cause.message : String(cause),\n    { status: 500, code: \"web_search_unavailable\", retryable: true, cause }\n  );\n}\n\n/**\n * What the model reads when a search fails: whether to retry, change the\n * query, or carry on without search. The operator's detail (credits, keys,\n * gateway setup) stays on the error for the host.\n */\nfunction describeFailureForModel(error: WebSearchError): string {\n  if (error.code === \"invalid_web_search_input\") {\n    return `Web search rejected the query (${error.message.replace(/\\.$/, \"\")}). Fix the query and try again.`;\n  }\n  if (error.retryable) {\n    return `Web search failed temporarily (${error.code}). You may retry once.`;\n  }\n  return `Web search is unavailable here (${error.code}). Do not retry; answer without it and say that web search was unavailable.`;\n}\n\n/** The model's `limit`, made an integer from 1 to 10. */\nfunction clampLimit(value: number): number {\n  if (!Number.isFinite(value)) return DEFAULT_WEB_SEARCH_LIMIT;\n  return Math.min(MAX_WEB_SEARCH_LIMIT, Math.max(1, Math.trunc(value)));\n}\n"],"mappings":"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"}

package/dist/tool-helpers-O5BDVEAY.js

@@ -0,0 +1,58 @@
+import { t as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-DhoDkSnH.js";
+import "./internal_context.js";
+import { t as redactBase64Payloads } from "./base64-redaction-C1Uu29t5.js";
+import { truncateResult } from "@cloudflare/codemode";
+//#region src/browser/tool-helpers.ts
+function browserScreenshotOutput(value) {
+	const outer = typeof value === "object" && value !== null ? value : null;
+	const result = outer && typeof outer.result === "object" && outer.result !== null ? outer.result : outer;
+	if (result?.type !== "browser_screenshot" || typeof result.mediaType !== "string" || typeof result.data !== "string") return null;
+	return result;
+}
+function transformBrowserResult(value) {
+	return browserScreenshotOutput(value) ? value : truncateResult(redactBase64Payloads(value));
+}
+/**
+* @param notes Sentences appended when a screenshot collapses the output to
+* text, so notices on the output aren't lost with it.
+*/
+function browserExecuteModelOutput(output, notes = []) {
+	const screenshot = browserScreenshotOutput(output);
+	if (screenshot) {
+		const approximateBytes = Math.floor(screenshot.data.length * 3 / 4);
+		return {
+			type: "text",
+			value: [`Screenshot captured successfully (${screenshot.mediaType}, approximately ${approximateBytes.toLocaleString()} bytes); the image is kept for the UI and omitted here.`, ...notes].join(" ")
+		};
+	}
+	const redacted = redactBase64Payloads(typeof output === "object" && output !== null && !Array.isArray(output) ? (({ calls: _calls, ...rest }) => ({
+		...rest,
+		...Array.isArray(rest.logs) ? { logs: truncateResult(rest.logs) } : {}
+	}))(output) : output);
+	try {
+		const serialized = JSON.stringify(redacted);
+		return {
+			type: "json",
+			value: serialized === void 0 ? null : JSON.parse(serialized)
+		};
+	} catch {
+		return {
+			type: "text",
+			value: "Browser execution completed, but its result could not be serialized for model context."
+		};
+	}
+}
+/**
+* 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;
+}
+//#endregion
+export { transformBrowserResult as i, browserScreenshotOutput as n, resolveCtx as r, browserExecuteModelOutput as t };
+
+//# sourceMappingURL=tool-helpers-O5BDVEAY.js.map

package/dist/tool-helpers-O5BDVEAY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers-O5BDVEAY.js","names":["agentContext"],"sources":["../src/browser/tool-helpers.ts"],"sourcesContent":["/**\n * Helpers shared by the browser tools: `createBrowserTools` in `ai.ts`, and\n * the `browserTool` adapters in `tools/`. Internal — not an entry point.\n */\nimport type { JSONValue } from \"ai\";\nimport { truncateResult } from \"@cloudflare/codemode\";\nimport { redactBase64Payloads } from \"../core/base64-redaction\";\nimport { __DO_NOT_USE_WILL_BREAK__agentContext as agentContext } from \"../internal_context\";\n\ninterface BrowserScreenshotOutput {\n  type: \"browser_screenshot\";\n  mediaType: string;\n  data: string;\n}\n\nexport function browserScreenshotOutput(\n  value: unknown\n): BrowserScreenshotOutput | null {\n  const outer =\n    typeof value === \"object\" && value !== null\n      ? (value as Record<string, unknown>)\n      : null;\n  const result =\n    outer && typeof outer.result === \"object\" && outer.result !== null\n      ? (outer.result as Record<string, unknown>)\n      : outer;\n  if (\n    result?.type !== \"browser_screenshot\" ||\n    typeof result.mediaType !== \"string\" ||\n    typeof result.data !== \"string\"\n  ) {\n    return null;\n  }\n  return result as unknown as BrowserScreenshotOutput;\n}\n\nexport function transformBrowserResult(value: unknown): unknown {\n  // Keep canonical screenshot output intact for UIMessage persistence and the\n  // chat renderer. Other results are redacted before truncation so a nested\n  // binary payload cannot become a large serialized preview.\n  return browserScreenshotOutput(value)\n    ? value\n    : truncateResult(redactBase64Payloads(value));\n}\n\n/** What the model sees in place of a browser tool's output. */\nexport type BrowserModelOutput =\n  | { type: \"text\"; value: string }\n  | { type: \"json\"; value: JSONValue };\n\n/**\n * @param notes Sentences appended when a screenshot collapses the output to\n * text, so notices on the output aren't lost with it.\n */\nexport function browserExecuteModelOutput(\n  output: unknown,\n  notes: string[] = []\n): BrowserModelOutput {\n  const screenshot = browserScreenshotOutput(output);\n  if (screenshot) {\n    const approximateBytes = Math.floor((screenshot.data.length * 3) / 4);\n    return {\n      type: \"text\",\n      value: [\n        `Screenshot captured successfully (${screenshot.mediaType}, approximately ${approximateBytes.toLocaleString()} bytes); the image is kept for the UI and omitted here.`,\n        ...notes\n      ].join(\" \")\n    };\n  }\n\n  // `calls` is the durable audit log; like the codemode tool's own projection,\n  // it stays on the persisted part and never enters the model's context, and\n  // the sandbox `logs` are bounded like a result.\n  const modelFacing =\n    typeof output === \"object\" && output !== null && !Array.isArray(output)\n      ? (({ calls: _calls, ...rest }: { calls?: unknown; logs?: unknown }) => ({\n          ...rest,\n          ...(Array.isArray(rest.logs)\n            ? { logs: truncateResult(rest.logs) }\n            : {})\n        }))(output)\n      : output;\n  const redacted = redactBase64Payloads(modelFacing);\n  try {\n    const serialized = JSON.stringify(redacted);\n    return {\n      type: \"json\",\n      value:\n        serialized === undefined ? null : (JSON.parse(serialized) as JSONValue)\n    };\n  } catch {\n    return {\n      type: \"text\",\n      value:\n        \"Browser execution completed, but its result could not be serialized for model context.\"\n    };\n  }\n}\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 */\nexport function resolveCtx(options: {\n  ctx?: DurableObjectState;\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"],"mappings":";;;;;AAeA,SAAgB,wBACd,OACgC;CAChC,MAAM,QACJ,OAAO,UAAU,YAAY,UAAU,OAClC,QACD;CACN,MAAM,SACJ,SAAS,OAAO,MAAM,WAAW,YAAY,MAAM,WAAW,OACzD,MAAM,SACP;CACN,IACE,QAAQ,SAAS,wBACjB,OAAO,OAAO,cAAc,YAC5B,OAAO,OAAO,SAAS,UAEvB,OAAO;CAET,OAAO;AACT;AAEA,SAAgB,uBAAuB,OAAyB;CAI9D,OAAO,wBAAwB,KAAK,IAChC,QACA,eAAe,qBAAqB,KAAK,CAAC;AAChD;;;;;AAWA,SAAgB,0BACd,QACA,QAAkB,CAAC,GACC;CACpB,MAAM,aAAa,wBAAwB,MAAM;CACjD,IAAI,YAAY;EACd,MAAM,mBAAmB,KAAK,MAAO,WAAW,KAAK,SAAS,IAAK,CAAC;EACpE,OAAO;GACL,MAAM;GACN,OAAO,CACL,qCAAqC,WAAW,UAAU,kBAAkB,iBAAiB,eAAe,EAAE,0DAC9G,GAAG,KACL,CAAC,CAAC,KAAK,GAAG;EACZ;CACF;CAcA,MAAM,WAAW,qBARf,OAAO,WAAW,YAAY,WAAW,QAAQ,CAAC,MAAM,QAAQ,MAAM,MAChE,EAAE,OAAO,QAAQ,GAAG,YAAiD;EACrE,GAAG;EACH,GAAI,MAAM,QAAQ,KAAK,IAAI,IACvB,EAAE,MAAM,eAAe,KAAK,IAAI,EAAE,IAClC,CAAC;CACP,GAAA,CAAI,MAAM,IACV,MAC2C;CACjD,IAAI;EACF,MAAM,aAAa,KAAK,UAAU,QAAQ;EAC1C,OAAO;GACL,MAAM;GACN,OACE,eAAe,KAAA,IAAY,OAAQ,KAAK,MAAM,UAAU;EAC5D;CACF,QAAQ;EACN,OAAO;GACL,MAAM;GACN,OACE;EACJ;CACF;AACF;;;;;;;AAQA,SAAgB,WAAW,SAEQ;CACjC,IAAI,QAAQ,KAAK,OAAO,QAAQ;CAIhC,QAHcA,sCAAa,SAAS,CAAC,EAAE,MAAA,EAGzB;AAChB"}

package/dist/{transport-k2mFrtL8.d.ts → transport-DCyarnwm.d.ts}

@@ -1,4 +1,4 @@
-import { a as ResolvedGateway } from "./settings-NgGwF7Qt.js";
+import { a as ResolvedGateway } from "./settings-DnD__xuE.js";
 
 //#region src/models/core/errors.d.ts
 /**
@@ -197,4 +197,4 @@ export {
   GatewayProviderName as r,
   Transport as t
 };
-//# sourceMappingURL=transport-k2mFrtL8.d.ts.map
+//# sourceMappingURL=transport-DCyarnwm.d.ts.map

package/dist/voice/index.d.ts

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

package/dist/web/fetch/index.d.ts

@@ -0,0 +1,89 @@
+import {
+  C as WindowWebFetchPageOptions,
+  S as WebFetchVia,
+  T as windowWebFetchPage,
+  _ as WEB_FETCH_TOOL_NAME,
+  a as WebFetchCallOptions,
+  b as WebFetchToolInput,
+  c as WebFetchRequest,
+  d as DEFAULT_WEB_FETCH_MAX_BYTES,
+  f as DEFAULT_WEB_FETCH_MAX_REDIRECTS,
+  g as WEB_FETCH_TOOL_DESCRIPTION,
+  h as MAX_WEB_FETCH_URL_LENGTH,
+  i as DirectWebFetchOptions,
+  l as WebFetchSource,
+  m as DEFAULT_WEB_FETCH_TIMEOUT_MS,
+  n as WebFetchToolOptions,
+  o as WebFetchError,
+  p as DEFAULT_WEB_FETCH_PAGE_CHARS,
+  r as WebFetchToolSourceOptions,
+  s as WebFetchErrorCode,
+  t as WebFetchToolDirectOptions,
+  u as createDirectWebFetch,
+  v as WebFetchFormat,
+  w as renderWebFetchPage,
+  x as WebFetchToolOutput,
+  y as WebFetchPage
+} from "../../tool-DoVberpN.js";
+
+//#region src/web/url-policy.d.ts
+/**
+ * Whether a host, as `URL.hostname` gives it, is in one of the ranges below
+ * (IPv4, or IPv6 including IPv4-mapped, NAT64 and 6to4 forms), or is
+ * `localhost` or ends in `.localhost` or `.internal`.
+ */
+declare function isPrivateOrLocalHost(hostname: string): boolean;
+//#endregion
+//#region src/web/fetch/index.d.ts
+/** Options for {@link fetchWeb}: the direct source's, plus a deadline. */
+interface FetchWebOptions extends DirectWebFetchOptions {
+  /**
+   * Give up after this many milliseconds with a `web_fetch_timeout` error.
+   * A positive integer; defaults to 30 seconds.
+   */
+  timeoutMs?: number;
+  /** Abort the fetch; rejects with the signal's reason. */
+  signal?: AbortSignal;
+}
+/**
+ * Fetch one URL directly, without a tool: {@link createDirectWebFetch} plus
+ * a deadline. Returns the whole page; to show it to a model a window at a
+ * time, as the tool does, pass it to {@link windowWebFetchPage} and
+ * {@link renderWebFetchPage}.
+ */
+declare function fetchWeb(
+  request: WebFetchRequest,
+  options: FetchWebOptions
+): Promise<WebFetchPage>;
+//#endregion
+export {
+  DEFAULT_WEB_FETCH_MAX_BYTES,
+  DEFAULT_WEB_FETCH_MAX_REDIRECTS,
+  DEFAULT_WEB_FETCH_PAGE_CHARS,
+  DEFAULT_WEB_FETCH_TIMEOUT_MS,
+  type DirectWebFetchOptions,
+  FetchWebOptions,
+  MAX_WEB_FETCH_URL_LENGTH,
+  WEB_FETCH_TOOL_DESCRIPTION,
+  WEB_FETCH_TOOL_NAME,
+  type WebFetchCallOptions,
+  WebFetchError,
+  type WebFetchErrorCode,
+  type WebFetchFormat,
+  type WebFetchPage,
+  type WebFetchRequest,
+  type WebFetchSource,
+  type WebFetchToolDirectOptions,
+  type WebFetchToolInput,
+  type WebFetchToolOptions,
+  type WebFetchToolOutput,
+  type WebFetchToolSourceOptions,
+  type WebFetchVia,
+  type WindowWebFetchPageOptions,
+  createDirectWebFetch,
+  fetchWeb,
+  isPrivateOrLocalHost,
+  renderWebFetchPage,
+  windowWebFetchPage
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/web/fetch/index.js

@@ -0,0 +1,20 @@
+import { a as WebFetchError, c as DEFAULT_WEB_FETCH_MAX_REDIRECTS, d as MAX_WEB_FETCH_URL_LENGTH, f as WEB_FETCH_TOOL_DESCRIPTION, g as isPrivateOrLocalHost, h as windowWebFetchPage, i as validateTimeout, l as DEFAULT_WEB_FETCH_PAGE_CHARS, m as renderWebFetchPage, n as fetchWithDeadline, o as createDirectWebFetch, p as WEB_FETCH_TOOL_NAME, s as DEFAULT_WEB_FETCH_MAX_BYTES, u as DEFAULT_WEB_FETCH_TIMEOUT_MS } from "../../tool-CxKsvxjm.js";
+//#region src/web/fetch/index.ts
+/**
+* Fetch one URL directly, without a tool: {@link createDirectWebFetch} plus
+* a deadline. Returns the whole page; to show it to a model a window at a
+* time, as the tool does, pass it to {@link windowWebFetchPage} and
+* {@link renderWebFetchPage}.
+*/
+async function fetchWeb(request, options) {
+	const { timeoutMs, signal, ...sourceOptions } = options;
+	const deadline = validateTimeout(timeoutMs);
+	return fetchWithDeadline(createDirectWebFetch(sourceOptions), request, {
+		timeoutMs: deadline,
+		signal
+	});
+}
+//#endregion
+export { DEFAULT_WEB_FETCH_MAX_BYTES, DEFAULT_WEB_FETCH_MAX_REDIRECTS, DEFAULT_WEB_FETCH_PAGE_CHARS, DEFAULT_WEB_FETCH_TIMEOUT_MS, MAX_WEB_FETCH_URL_LENGTH, WEB_FETCH_TOOL_DESCRIPTION, WEB_FETCH_TOOL_NAME, WebFetchError, createDirectWebFetch, fetchWeb, isPrivateOrLocalHost, renderWebFetchPage, windowWebFetchPage };
+
+//# sourceMappingURL=index.js.map

package/dist/web/fetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/web/fetch/index.ts"],"sourcesContent":["/**\n * `agents/webfetch` — read a URL as Markdown, JSON, or text, with\n * host-controlled URL policy and size limits, from a Worker.\n *\n * The tool adapters live beside this entry: `agents/webfetch/pi`,\n * `agents/webfetch/ai-sdk`, and `agents/webfetch/tanstack-ai`. Import from\n * here to fetch without a model in the loop, or to build a source for the\n * tools.\n *\n * @beta\n */\nimport type { WebFetchPage } from \"./contract\";\nimport {\n  createDirectWebFetch,\n  type DirectWebFetchOptions,\n  type WebFetchRequest\n} from \"./source\";\nimport { fetchWithDeadline, validateTimeout } from \"./tool\";\n\nexport {\n  DEFAULT_WEB_FETCH_MAX_BYTES,\n  DEFAULT_WEB_FETCH_MAX_REDIRECTS,\n  DEFAULT_WEB_FETCH_PAGE_CHARS,\n  DEFAULT_WEB_FETCH_TIMEOUT_MS,\n  MAX_WEB_FETCH_URL_LENGTH,\n  WEB_FETCH_TOOL_DESCRIPTION,\n  WEB_FETCH_TOOL_NAME,\n  renderWebFetchPage,\n  windowWebFetchPage,\n  type WebFetchFormat,\n  type WebFetchPage,\n  type WebFetchToolInput,\n  type WebFetchToolOutput,\n  type WebFetchVia,\n  type WindowWebFetchPageOptions\n} from \"./contract\";\nexport {\n  WebFetchError,\n  createDirectWebFetch,\n  type DirectWebFetchOptions,\n  type WebFetchCallOptions,\n  type WebFetchErrorCode,\n  type WebFetchRequest,\n  type WebFetchSource\n} from \"./source\";\nexport { isPrivateOrLocalHost } from \"../url-policy\";\nexport {\n  type WebFetchToolDirectOptions,\n  type WebFetchToolOptions,\n  type WebFetchToolSourceOptions\n} from \"./tool\";\n\n/** Options for {@link fetchWeb}: the direct source's, plus a deadline. */\nexport interface FetchWebOptions extends DirectWebFetchOptions {\n  /**\n   * Give up after this many milliseconds with a `web_fetch_timeout` error.\n   * A positive integer; defaults to 30 seconds.\n   */\n  timeoutMs?: number;\n  /** Abort the fetch; rejects with the signal's reason. */\n  signal?: AbortSignal;\n}\n\n/**\n * Fetch one URL directly, without a tool: {@link createDirectWebFetch} plus\n * a deadline. Returns the whole page; to show it to a model a window at a\n * time, as the tool does, pass it to {@link windowWebFetchPage} and\n * {@link renderWebFetchPage}.\n */\nexport async function fetchWeb(\n  request: WebFetchRequest,\n  options: FetchWebOptions\n): Promise<WebFetchPage> {\n  const { timeoutMs, signal, ...sourceOptions } = options;\n  const deadline = validateTimeout(timeoutMs);\n  const source = createDirectWebFetch(sourceOptions);\n  return fetchWithDeadline(source, request, { timeoutMs: deadline, signal });\n}\n"],"mappings":";;;;;;;;AAqEA,eAAsB,SACpB,SACA,SACuB;CACvB,MAAM,EAAE,WAAW,QAAQ,GAAG,kBAAkB;CAChD,MAAM,WAAW,gBAAgB,SAAS;CAE1C,OAAO,kBADQ,qBAAqB,aACN,GAAG,SAAS;EAAE,WAAW;EAAU;CAAO,CAAC;AAC3E"}

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

@@ -0,0 +1,80 @@
+import {
+  S as WebFetchVia,
+  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";
+import { FlexibleSchema } from "ai";
+
+//#region src/web/fetch/tools/ai-sdk.d.ts
+/**
+ * The part of the AI SDK's tool execution options the tool reads. Spelled
+ * out rather than imported so it fits every supported `ai` major.
+ */
+interface WebFetchToolExecuteOptions {
+  abortSignal?: AbortSignal;
+}
+/**
+ * The AI SDK tool {@link webFetchTool} returns. Assignable to the AI SDK's
+ * `Tool`; `execute` and `toModelOutput` are always present.
+ */
+interface WebFetchTool {
+  description: string;
+  inputSchema: FlexibleSchema<WebFetchToolInput>;
+  execute(
+    input: WebFetchToolInput,
+    options: WebFetchToolExecuteOptions
+  ): Promise<WebFetchToolOutput>;
+  toModelOutput(options: { output: WebFetchToolOutput }): {
+    type: "text";
+    value: string;
+  };
+}
+/**
+ * Create an AI SDK tool that reads a URL as Markdown, JSON, or text. The
+ * tool's output is the window the model read plus the page's metadata
+ * (status, headers, redirects, total length), so it stays small in stored
+ * messages; `toModelOutput` renders it for the model. A failed fetch throws a `WebFetchError`, which
+ * the AI SDK reports to the model as a tool error: its `message` is written
+ * for the model, and its `cause` is the source's error with the detail.
+ *
+ * `toModelOutput` only applies to earlier turns when the tools are passed to
+ * `convertToModelMessages(messages, { tools })`; otherwise the AI SDK sends
+ * the output back to the model as JSON, without the header or the
+ * untrusted-content wrapper. `AiSdkHarness` passes them.
+ *
+ * @example
+ * ```ts
+ * import { webFetchTool } from "agents/webfetch/ai-sdk";
+ *
+ * const result = streamText({
+ *   model,
+ *   tools: { web_fetch: webFetchTool({ binding: env.AI }) },
+ *   messages
+ * });
+ * ```
+ */
+declare function webFetchTool(options: WebFetchToolOptions): WebFetchTool;
+//#endregion
+export {
+  WebFetchError,
+  type WebFetchErrorCode,
+  type WebFetchFormat,
+  type WebFetchPage,
+  type WebFetchRequest,
+  type WebFetchSource,
+  WebFetchTool,
+  WebFetchToolExecuteOptions,
+  type WebFetchToolInput,
+  type WebFetchToolOptions,
+  type WebFetchToolOutput,
+  type WebFetchVia,
+  webFetchTool
+};
+//# sourceMappingURL=ai-sdk.d.ts.map

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

@@ -0,0 +1,47 @@
+import { a as WebFetchError, r as toolFailure, t as createWebFetchToolCore } from "../../../tool-CxKsvxjm.js";
+import { t as webFetchInputSchema } from "../../../input-schema-BQykTEp_.js";
+//#region src/web/fetch/tools/ai-sdk.ts
+/**
+* Create an AI SDK tool that reads a URL as Markdown, JSON, or text. The
+* tool's output is the window the model read plus the page's metadata
+* (status, headers, redirects, total length), so it stays small in stored
+* messages; `toModelOutput` renders it for the model. A failed fetch throws a `WebFetchError`, which
+* the AI SDK reports to the model as a tool error: its `message` is written
+* for the model, and its `cause` is the source's error with the detail.
+*
+* `toModelOutput` only applies to earlier turns when the tools are passed to
+* `convertToModelMessages(messages, { tools })`; otherwise the AI SDK sends
+* the output back to the model as JSON, without the header or the
+* untrusted-content wrapper. `AiSdkHarness` passes them.
+*
+* @example
+* ```ts
+* import { webFetchTool } from "agents/webfetch/ai-sdk";
+*
+* const result = streamText({
+*   model,
+*   tools: { web_fetch: webFetchTool({ binding: env.AI }) },
+*   messages
+* });
+* ```
+*/
+function webFetchTool(options) {
+	const core = createWebFetchToolCore(options);
+	return {
+		description: core.description,
+		inputSchema: webFetchInputSchema(),
+		async execute(input, { abortSignal }) {
+			const run = await core.run(input, { signal: abortSignal });
+			if (!run.ok) throw toolFailure(run);
+			return run.output;
+		},
+		toModelOutput: ({ output }) => ({
+			type: "text",
+			value: core.render(output)
+		})
+	};
+}
+//#endregion
+export { WebFetchError, webFetchTool };
+
+//# sourceMappingURL=ai-sdk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","names":[],"sources":["../../../../src/web/fetch/tools/ai-sdk.ts"],"sourcesContent":["/**\n * `agents/webfetch/ai-sdk` — the `web_fetch` tool for the AI SDK.\n *\n * @beta\n */\nimport type { FlexibleSchema } from \"ai\";\nimport type { WebFetchToolInput, WebFetchToolOutput } 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\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 WebFetchToolExecuteOptions {\n  abortSignal?: AbortSignal;\n}\n\n/**\n * The AI SDK tool {@link webFetchTool} returns. Assignable to the AI SDK's\n * `Tool`; `execute` and `toModelOutput` are always present.\n */\nexport interface WebFetchTool {\n  description: string;\n  inputSchema: FlexibleSchema<WebFetchToolInput>;\n  execute(\n    input: WebFetchToolInput,\n    options: WebFetchToolExecuteOptions\n  ): Promise<WebFetchToolOutput>;\n  toModelOutput(options: { output: WebFetchToolOutput }): {\n    type: \"text\";\n    value: string;\n  };\n}\n\n/**\n * Create an AI SDK tool that reads a URL as Markdown, JSON, or text. The\n * tool's output is the window the model read plus the page's metadata\n * (status, headers, redirects, total length), so it stays small in stored\n * messages; `toModelOutput` renders it for the model. A failed fetch throws a `WebFetchError`, which\n * the AI SDK reports to the model as a tool error: its `message` is written\n * for the model, and its `cause` is the source's error with the 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 output back to the model as JSON, without the header or the\n * untrusted-content wrapper. `AiSdkHarness` passes them.\n *\n * @example\n * ```ts\n * import { webFetchTool } from \"agents/webfetch/ai-sdk\";\n *\n * const result = streamText({\n *   model,\n *   tools: { web_fetch: webFetchTool({ binding: env.AI }) },\n *   messages\n * });\n * ```\n */\nexport function webFetchTool(options: WebFetchToolOptions): WebFetchTool {\n  const core = createWebFetchToolCore(options);\n  return {\n    description: core.description,\n    inputSchema: webFetchInputSchema(),\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8EA,SAAgB,aAAa,SAA4C;CACvE,MAAM,OAAO,uBAAuB,OAAO;CAC3C,OAAO;EACL,aAAa,KAAK;EAClB,aAAa,oBAAoB;EACjC,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/web/fetch/tools/pi.d.ts

@@ -0,0 +1,84 @@
+import {
+  S as WebFetchVia,
+  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";
+import { Type } from "@earendil-works/pi-ai";
+import { ToolRegistration } from "@earendil-works/pi-durable";
+
+//#region src/web/fetch/tools/pi.d.ts
+/** The model's input schema. pi already coerces `"20000"` to `20000`. */
+declare function webFetchParameters(): Type.TObject<{
+  url: Type.TString;
+  offset: Type.TOptional<Type.TInteger>;
+  format: Type.TOptional<
+    Type.TUnion<[Type.TLiteral<"auto">, Type.TLiteral<"raw">]>
+  >;
+}>;
+type WebFetchParameters = ReturnType<typeof webFetchParameters>;
+/**
+ * Host-side details pi stores with each `web_fetch` result: the output (the
+ * window the model read, with the page's metadata) or the failure.
+ */
+type WebFetchToolDetails =
+  | {
+      ok: true;
+      output: WebFetchToolOutput;
+    }
+  | {
+      ok: false /** The source's error message, with the detail for the host. */;
+      message: string;
+      status: number;
+      code: WebFetchErrorCode;
+      retryable: boolean;
+      url?: string /** The response's media type, when a response was read. */;
+      contentType?: string;
+    };
+/**
+ * Create a pi tool that reads a URL as Markdown, JSON, or text. Install it
+ * on a registry like any other pi tool.
+ *
+ * The model chooses the URL, the window (`offset`), and the format; the
+ * host chooses the URL policy, size limits, and window size. The tool is
+ * `replay: "safe"`: a fetch interrupted mid-call (say, by an eviction) runs
+ * again when the session recovers. Completed results are stored and not
+ * fetched again.
+ *
+ * @example
+ * ```ts
+ * import { createRegistry } from "@earendil-works/pi-durable";
+ * import { webFetchTool } from "agents/webfetch/pi";
+ *
+ * const registry = createRegistry();
+ * registry.install({
+ *   name: "tools",
+ *   tools: [webFetchTool({ binding: env.AI })]
+ * });
+ * ```
+ */
+declare function webFetchTool(
+  options: WebFetchToolOptions
+): ToolRegistration<WebFetchParameters, WebFetchToolDetails>;
+//#endregion
+export {
+  WebFetchError,
+  type WebFetchErrorCode,
+  type WebFetchFormat,
+  type WebFetchPage,
+  type WebFetchRequest,
+  type WebFetchSource,
+  WebFetchToolDetails,
+  type WebFetchToolInput,
+  type WebFetchToolOptions,
+  type WebFetchToolOutput,
+  type WebFetchVia,
+  webFetchTool
+};
+//# sourceMappingURL=pi.d.ts.map

package/dist/web/fetch/tools/pi.js

@@ -0,0 +1,88 @@
+import { a as WebFetchError, d as MAX_WEB_FETCH_URL_LENGTH, t as createWebFetchToolCore } from "../../../tool-CxKsvxjm.js";
+import { Type } from "@earendil-works/pi-ai";
+//#region src/web/fetch/tools/pi.ts
+/**
+* `agents/webfetch/pi` — the `web_fetch` tool for the pi harness.
+*
+* @beta
+*/
+/** The model's input schema. pi already coerces `"20000"` to `20000`. */
+function webFetchParameters() {
+	return Type.Object({
+		url: Type.String({
+			minLength: 1,
+			maxLength: MAX_WEB_FETCH_URL_LENGTH,
+			description: "The http(s) URL to read."
+		}),
+		offset: Type.Optional(Type.Integer({
+			minimum: 0,
+			description: "Character offset into the content, to continue a long page from the previous result's offset. Default 0."
+		})),
+		format: Type.Optional(Type.Union([Type.Literal("auto"), Type.Literal("raw")], { description: "\"auto\" (default) converts to the most readable form; \"raw\" returns the body as served." }))
+	});
+}
+/**
+* Create a pi tool that reads a URL as Markdown, JSON, or text. Install it
+* on a registry like any other pi tool.
+*
+* The model chooses the URL, the window (`offset`), and the format; the
+* host chooses the URL policy, size limits, and window size. The tool is
+* `replay: "safe"`: a fetch interrupted mid-call (say, by an eviction) runs
+* again when the session recovers. Completed results are stored and not
+* fetched again.
+*
+* @example
+* ```ts
+* import { createRegistry } from "@earendil-works/pi-durable";
+* import { webFetchTool } from "agents/webfetch/pi";
+*
+* const registry = createRegistry();
+* registry.install({
+*   name: "tools",
+*   tools: [webFetchTool({ binding: env.AI })]
+* });
+* ```
+*/
+function webFetchTool(options) {
+	const core = createWebFetchToolCore(options);
+	return {
+		name: core.name,
+		description: core.description,
+		parameters: webFetchParameters(),
+		replay: "safe",
+		async execute(input, _api, context) {
+			const run = await core.run(input, { signal: context.abortSignal });
+			if (run.ok) return {
+				content: [{
+					type: "text",
+					text: run.text
+				}],
+				details: {
+					ok: true,
+					output: run.output
+				}
+			};
+			const details = {
+				ok: false,
+				message: run.error.message,
+				status: run.error.status,
+				code: run.error.code,
+				retryable: run.error.retryable
+			};
+			if (run.error.url !== void 0) details.url = run.error.url;
+			if (run.error.contentType !== void 0) details.contentType = run.error.contentType;
+			return {
+				content: [{
+					type: "text",
+					text: run.text
+				}],
+				isError: true,
+				details
+			};
+		}
+	};
+}
+//#endregion
+export { WebFetchError, webFetchTool };
+
+//# sourceMappingURL=pi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","names":[],"sources":["../../../../src/web/fetch/tools/pi.ts"],"sourcesContent":["/**\n * `agents/webfetch/pi` — the `web_fetch` 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 { MAX_WEB_FETCH_URL_LENGTH, type WebFetchToolOutput } from \"../contract\";\nimport type { WebFetchErrorCode } from \"../source\";\nimport { createWebFetchToolCore, type WebFetchToolOptions } from \"../tool\";\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\n/** The model's input schema. pi already coerces `\"20000\"` to `20000`. */\nfunction webFetchParameters() {\n  return Type.Object({\n    url: Type.String({\n      minLength: 1,\n      maxLength: MAX_WEB_FETCH_URL_LENGTH,\n      description: \"The http(s) URL to read.\"\n    }),\n    offset: Type.Optional(\n      Type.Integer({\n        minimum: 0,\n        description:\n          \"Character offset into the content, to continue a long page from the previous result's offset. Default 0.\"\n      })\n    ),\n    format: Type.Optional(\n      Type.Union([Type.Literal(\"auto\"), Type.Literal(\"raw\")], {\n        description:\n          '\"auto\" (default) converts to the most readable form; \"raw\" returns the body as served.'\n      })\n    )\n  });\n}\n\ntype WebFetchParameters = ReturnType<typeof webFetchParameters>;\n\n/**\n * Host-side details pi stores with each `web_fetch` result: the output (the\n * window the model read, with the page's metadata) or the failure.\n */\nexport type WebFetchToolDetails =\n  | { ok: true; output: WebFetchToolOutput }\n  | {\n      ok: false;\n      /** The source's error message, with the detail for the host. */\n      message: string;\n      status: number;\n      code: WebFetchErrorCode;\n      retryable: boolean;\n      url?: string;\n      /** The response's media type, when a response was read. */\n      contentType?: string;\n    };\n\n/**\n * Create a pi tool that reads a URL as Markdown, JSON, or text. Install it\n * on a registry like any other pi tool.\n *\n * The model chooses the URL, the window (`offset`), and the format; the\n * host chooses the URL policy, size limits, and window size. The tool is\n * `replay: \"safe\"`: a fetch interrupted mid-call (say, by an eviction) runs\n * again when the session recovers. Completed results are stored and not\n * fetched again.\n *\n * @example\n * ```ts\n * import { createRegistry } from \"@earendil-works/pi-durable\";\n * import { webFetchTool } from \"agents/webfetch/pi\";\n *\n * const registry = createRegistry();\n * registry.install({\n *   name: \"tools\",\n *   tools: [webFetchTool({ binding: env.AI })]\n * });\n * ```\n */\nexport function webFetchTool(\n  options: WebFetchToolOptions\n): ToolRegistration<WebFetchParameters, WebFetchToolDetails> {\n  const core = createWebFetchToolCore(options);\n  return {\n    name: core.name,\n    description: core.description,\n    parameters: webFetchParameters(),\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      const details: WebFetchToolDetails = {\n        ok: false,\n        message: run.error.message,\n        status: run.error.status,\n        code: run.error.code,\n        retryable: run.error.retryable\n      };\n      if (run.error.url !== undefined) details.url = run.error.url;\n      if (run.error.contentType !== undefined) {\n        details.contentType = run.error.contentType;\n      }\n      return {\n        content: [{ type: \"text\", text: run.text }],\n        isError: true,\n        details\n      };\n    }\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAS,qBAAqB;CAC5B,OAAO,KAAK,OAAO;EACjB,KAAK,KAAK,OAAO;GACf,WAAW;GACX,WAAW;GACX,aAAa;EACf,CAAC;EACD,QAAQ,KAAK,SACX,KAAK,QAAQ;GACX,SAAS;GACT,aACE;EACJ,CAAC,CACH;EACA,QAAQ,KAAK,SACX,KAAK,MAAM,CAAC,KAAK,QAAQ,MAAM,GAAG,KAAK,QAAQ,KAAK,CAAC,GAAG,EACtD,aACE,6FACJ,CAAC,CACH;CACF,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,aACd,SAC2D;CAC3D,MAAM,OAAO,uBAAuB,OAAO;CAC3C,OAAO;EACL,MAAM,KAAK;EACX,aAAa,KAAK;EAClB,YAAY,mBAAmB;EAC/B,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,MAAM,UAA+B;IACnC,IAAI;IACJ,SAAS,IAAI,MAAM;IACnB,QAAQ,IAAI,MAAM;IAClB,MAAM,IAAI,MAAM;IAChB,WAAW,IAAI,MAAM;GACvB;GACA,IAAI,IAAI,MAAM,QAAQ,KAAA,GAAW,QAAQ,MAAM,IAAI,MAAM;GACzD,IAAI,IAAI,MAAM,gBAAgB,KAAA,GAC5B,QAAQ,cAAc,IAAI,MAAM;GAElC,OAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,IAAI;IAAK,CAAC;IAC1C,SAAS;IACT;GACF;EACF;CACF;AACF"}