agents 0.28.0 → 0.29.0

package/dist/transport-CPh7YGiw.d.ts

@@ -0,0 +1,623 @@
+//#region src/models/core/catalog.d.ts
+/**
+ * Keys of the ambient `AiModels` interface (from `@cloudflare/workers-types`)
+ * whose model type extends `T`. Kept in step with the installed workers-types
+ * version rather than hand-maintained here.
+ */
+type WorkersAIModelIdsExtending<T> = {
+  [K in keyof AiModels]: AiModels[K] extends T ? K : never;
+}[keyof AiModels];
+/** The `inputs` shape a catalog entry declares. */
+type InputsOf<K extends keyof AiModels> = AiModels[K] extends {
+  inputs: infer I;
+}
+  ? I
+  : never;
+/** The `postProcessedOutputs` shape a catalog entry declares. */
+type OutputsOf<K extends keyof AiModels> = AiModels[K] extends {
+  postProcessedOutputs: infer O;
+}
+  ? O
+  : never;
+/**
+ * Catalog keys whose input takes a required `messages` array — every current
+ * chat model. Newer entries get their own generated class rather than
+ * extending `BaseAiTextGeneration`, so the base-class arm alone misses them.
+ */
+type ChatCatalogId = {
+  [K in keyof AiModels]: Extract<
+    InputsOf<K>,
+    {
+      messages: unknown;
+    }
+  > extends never
+    ? never
+    : K;
+}[keyof AiModels];
+/**
+ * Catalog keys that take text and answer with embedding vectors. Both halves
+ * matter: the input test alone also matches translation, classification and
+ * speech models, which take `text` but return something else entirely.
+ */
+type EmbeddingCatalogId = {
+  [K in keyof AiModels]: Extract<
+    InputsOf<K>,
+    {
+      text: unknown;
+    }
+  > extends never
+    ? never
+    : Extract<
+          OutputsOf<K>,
+          {
+            data?: number[][];
+          }
+        > extends never
+      ? never
+      : K;
+}[keyof AiModels];
+/**
+ * Catalog keys that take audio to transcribe. The `audio` key is required on
+ * every speech-recognition input and on no other input shape, so the test is
+ * exact rather than heuristic.
+ */
+type TranscriptionCatalogId = {
+  [K in keyof AiModels]: Extract<
+    InputsOf<K>,
+    {
+      audio: unknown;
+    }
+  > extends never
+    ? never
+    : K;
+}[keyof AiModels];
+/**
+ * Catalog keys that score a list of contexts against a query — rerankers.
+ * `contexts` is required on exactly those inputs.
+ */
+type RerankingCatalogId = {
+  [K in keyof AiModels]: Extract<
+    InputsOf<K>,
+    {
+      contexts: unknown;
+    }
+  > extends never
+    ? never
+    : K;
+}[keyof AiModels];
+/**
+ * A Workers AI model id.
+ *
+ * Workers AI is the one catalog this package keeps up with, so this is the
+ * only id shape it accepts: `@cf/<author>/<model>`. Autocomplete covers the
+ * text-generation catalog from the installed `@cloudflare/workers-types`; the
+ * template arm keeps every other `@cf/` slug assignable, because the catalog
+ * lives server-side and moves independently of these types.
+ *
+ * Third-party models are not ids here — they are model objects built by their
+ * own provider package and routed through AI Gateway.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type WorkersAIModelId =
+  | Extract<
+      | ChatCatalogId
+      | Exclude<
+          WorkersAIModelIdsExtending<BaseAiTextGeneration>,
+          WorkersAIModelIdsExtending<BaseAiTextToImage>
+        >,
+      `@cf/${string}`
+    >
+  | (`@cf/${string}` & {});
+/**
+ * An AI Gateway dynamic route, by name: `dynamic/<route>`.
+ *
+ * A dynamic route is configured on the gateway — which models it tries, in
+ * which order, with what rate limits or budgets — and called through the
+ * Workers AI run path like a model. It answers in the OpenAI chat-completions
+ * shape whatever model served it, so it is a language model only.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type DynamicRouteId = `dynamic/${string}`;
+/**
+ * A model from the AI Gateway catalog, by its catalog id:
+ * `<author>/<model>`, such as `openai/gpt-5.5`,
+ * `anthropic/claude-opus-4.8` or `cloudflare/auto`.
+ *
+ * The catalog id is the gateway's own spelling, which can differ from the
+ * vendor's (`claude-opus-4.8`, not `claude-opus-4-8`). It runs on
+ * `env.AI.run`, where AI Gateway's `/run` engine picks the provider, converts
+ * the request, and bills through Unified Billing or a key stored on the
+ * gateway.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CatalogModelId = `${string}/${string}`;
+/**
+ * A text-embedding model id accepted by `ai.embedding()`.
+ *
+ * The modality methods are Workers AI only — there is no vendor route for them
+ * — so, like {@link WorkersAIModelId}, they take `@cf/` ids and nothing else.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareEmbeddingModelId =
+  | Extract<
+      EmbeddingCatalogId | WorkersAIModelIdsExtending<BaseAiTextEmbeddings>,
+      `@cf/${string}`
+    >
+  | (`@cf/${string}` & {});
+/**
+ * Workers AI text-to-image ids that the generated `AiModels` entries do not
+ * classify as {@link BaseAiTextToImage} — the newer partner models get their
+ * own generated class instead. Curated for autocomplete only; the catalog
+ * lives server-side and any slug is accepted.
+ *
+ * The FLUX.2 family (`flux-2-dev`, `flux-2-klein-4b`, `flux-2-klein-9b`) is
+ * deliberately absent, for the reason {@link UnsupportedTranscriptionId}
+ * records for the Deepgram recognisers: its generated input takes a required
+ * `multipart` object body (`{ multipart: { body, contentType } }`) and no
+ * `prompt`, which the JSON run path cannot carry — live, the run path answers
+ * `400 Bad input: required properties at "/" are 'multipart'`. Suggesting an
+ * id that always 400s is worse than not suggesting it.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type KnownImageModelId =
+  | "@cf/black-forest-labs/flux-1-schnell"
+  | "@cf/leonardo/lucid-origin"
+  | "@cf/leonardo/phoenix-1.0";
+/**
+ * An image model id accepted by `ai.image()`.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareImageModelId =
+  | Extract<
+      WorkersAIModelIdsExtending<BaseAiTextToImage> | KnownImageModelId,
+      `@cf/${string}`
+    >
+  | (`@cf/${string}` & {});
+/**
+ * Workers AI text-to-speech ids without a {@link BaseAiTextToSpeech} entry.
+ * Curated for autocomplete only.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type KnownSpeechModelId =
+  | "@cf/deepgram/aura-1"
+  | "@cf/deepgram/aura-2-en"
+  | "@cf/deepgram/aura-2-es";
+/**
+ * A text-to-speech model id accepted by `ai.speech()`.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareSpeechModelId =
+  | Extract<
+      WorkersAIModelIdsExtending<BaseAiTextToSpeech> | KnownSpeechModelId,
+      `@cf/${string}`
+    >
+  | (`@cf/${string}` & {});
+/**
+ * Deepgram's Flux takes websocket connections only. It stays out of the
+ * suggested arm, and the transcription model answers a clear error for it.
+ */
+type UnsupportedTranscriptionId = "@cf/deepgram/flux";
+/**
+ * A speech-recognition model id accepted by `ai.transcription()`.
+ *
+ * Deepgram's Flux (`@cf/deepgram/flux`) is deliberately not suggested: it
+ * takes websocket connections only, so this provider answers a clear error
+ * for it rather than a 400.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareTranscriptionModelId =
+  | Extract<
+      | Exclude<TranscriptionCatalogId, UnsupportedTranscriptionId>
+      | Exclude<
+          WorkersAIModelIdsExtending<BaseAiAutomaticSpeechRecognition>,
+          UnsupportedTranscriptionId
+        >,
+      `@cf/${string}`
+    >
+  | (`@cf/${string}` & {});
+/**
+ * A reranking model id accepted by `ai.reranking()`.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareRerankingModelId =
+  | Extract<RerankingCatalogId, `@cf/${string}`>
+  | (`@cf/${string}` & {});
+//#endregion
+//#region src/models/core/settings.d.ts
+/**
+ * AI Gateway settings for a request. The gateway is an option, not a separate
+ * product: every call goes through one, and `id` defaults to `"default"`,
+ * which Cloudflare creates on first use.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface GatewayOptions {
+  /** Gateway id. Defaults to `"default"` (auto-created on first use). */
+  id?: string;
+  /** Bypass the cache for this request. */
+  skipCache?: boolean;
+  /** Cache lifetime in seconds. */
+  cacheTtl?: number;
+  /** Explicit cache key, instead of the request-derived one. */
+  cacheKey?: string;
+  /** Whether the gateway stores the request/response in its log. */
+  collectLog?: boolean;
+  /** Arbitrary key/values attached to the gateway log entry. */
+  metadata?: Record<string, string | number | boolean | null>;
+  /** Correlates several requests into one gateway event. */
+  eventId?: string;
+  /** Upstream request timeout in milliseconds. */
+  requestTimeoutMs?: number;
+  /** Server-side retry policy for the upstream provider call. */
+  retries?: {
+    maxAttempts?: 1 | 2 | 3 | 4 | 5;
+    retryDelayMs?: number;
+    backoff?: "constant" | "linear" | "exponential";
+  };
+  /**
+   * The stored BYOK key to use when the gateway holds more than one for a
+   * provider, by alias. Sent as `cf-aig-byok-alias`, for catalog models and
+   * for model objects reached through the provider-native path.
+   */
+  byokAlias?: string;
+  /**
+   * Zero Data Retention for this request, sent as `cf-aig-zdr`: `true` turns
+   * it on and `false` off, whatever the gateway's own setting. Unified
+   * billing only, and only for model objects reached through the
+   * provider-native path — `/run` does not read it.
+   */
+  zdr?: boolean;
+}
+/**
+ * How `createAI` reaches Cloudflare: the `AI` binding, or an account id and
+ * API token. Both take the same routes — a model id to the run path, a
+ * vendor's model object to the provider-native path — and the same gateway
+ * options.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type AISettings = (BindingAccess | AccountAccess) & ProviderGatewaySettings;
+/**
+ * Reach Cloudflare through the `AI` binding: no account id or token to hold,
+ * and the gateway is the Worker's own account's.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface BindingAccess {
+  /** The `AI` binding from a Worker's env. */
+  binding: Ai;
+  accountId?: never;
+  apiToken?: never;
+}
+/**
+ * Reach Cloudflare over HTTP with an account id and API token, for a gateway
+ * in another account or code that runs outside a Worker. A model id goes to
+ * the REST API (`api.cloudflare.com/client/v4/accounts/{accountId}/ai/...`),
+ * a model object to the provider-native path
+ * (`gateway.ai.cloudflare.com/v1/{accountId}/{gateway}/...`). The token is
+ * only ever sent to those two hosts.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface AccountAccess {
+  /** The account the gateway belongs to. */
+  accountId: string;
+  /**
+   * A Cloudflare API token for that account, with Workers AI Read (model ids,
+   * on the REST API) and AI Gateway Run (model objects, on the
+   * provider-native path).
+   */
+  apiToken: string;
+  binding?: never;
+}
+/**
+ * Provider-wide gateway defaults, in either spelling: nested under `gateway`,
+ * or flat (`{ id: "prod", cacheTtl: 60 }`). Both merge, the flat key winning.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface ProviderGatewaySettings extends GatewayOptions {
+  /** Gateway id or full gateway options. */
+  gateway?: string | GatewayOptions;
+}
+/**
+ * Per-model and per-call options. The flat gateway keys are sugar for
+ * `gateway: { ... }`; both forms merge, with the flat key winning.
+ *
+ * The same shape is accepted per call under
+ * `providerOptions.cloudflare`, where it takes precedence over the per-model
+ * options, which in turn take precedence over the `createAI` settings.
+ *
+ * `Leg` is what a framework module accepts as a fallback leg. Workers AI ids
+ * are the only kind this module can resolve on its own, so they are the
+ * default; a module whose legs may also be model objects says so
+ * (`ModelOptions<WorkersAIModelId | LanguageModelV4>`) rather than rebuilding
+ * the type.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface ModelOptions<Leg = WorkersAIModelId> extends ProviderGatewaySettings {
+  /**
+   * Models to try, in order, if the primary fails before any output is
+   * produced. A leg travels with the chain's gateway options — those win over
+   * a leg's own, and `metadata` merges — while everything a leg was built with
+   * itself stays its own. Client-side today; becomes server-side when the
+   * platform ships model-first routing.
+   */
+  fallback?: Leg[];
+  /** Extra request headers, merged last. */
+  headers?: Record<string, string>;
+  /**
+   * Workers AI only: route same-key requests to the same replica for
+   * prefix-cache hits. Sent as the `x-session-affinity` header.
+   */
+  sessionAffinity?: string;
+  /**
+   * Explicit reasoning effort. `null` disables reasoning on models that
+   * support toggling it. The unified AI SDK `reasoning` call option maps onto
+   * this when this is not set.
+   */
+  reasoningEffort?: "low" | "medium" | "high" | null;
+  /**
+   * Workers AI only: forwarded verbatim as `chat_template_kwargs`, e.g.
+   * `{ enable_thinking: false }`.
+   */
+  chatTemplateKwargs?: Record<string, unknown>;
+}
+/** A gateway config with the id filled in. */
+interface ResolvedGateway extends GatewayOptions {
+  id: string;
+}
+//#endregion
+//#region src/models/core/errors.d.ts
+/**
+ * Coarse classification of a failed Cloudflare AI call.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type CloudflareAIErrorCode =
+  | "auth"
+  | "rate-limit"
+  | "not-found"
+  | "bad-request"
+  | "provider-error"
+  | "gateway-error"
+  | "unknown";
+/**
+ * One leg of a {@link CloudflareAIError} fallback chain.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface CloudflareAIAttempt {
+  /** The model id that was tried. */
+  model: string;
+  /** The error that leg failed with. */
+  error: unknown;
+}
+/**
+ * Error thrown for every failed Cloudflare AI call, whether it came back as a
+ * non-2xx `Response` or as a thrown Workers AI binding error. Framework
+ * modules wrap it into their own error type at their boundary (the AI SDK
+ * module into an `APICallError`, so `ai`'s retry loop honours
+ * {@link CloudflareAIError.isRetryable}).
+ *
+ * @experimental This surface is experimental and may change.
+ */
+declare class CloudflareAIError extends Error {
+  /** HTTP status, when the failure carried one. */
+  readonly status: number | undefined;
+  /** Coarse classification used for routing and fallback decisions. */
+  readonly code: CloudflareAIErrorCode;
+  /** `cf-aig-log-id` of the failed request, when the response carried one. */
+  readonly logId: string | undefined;
+  /** The model id that produced this error. */
+  readonly model: string;
+  /** Which binding path the request went down, for error reporting. */
+  readonly url: string;
+  /** The request body that failed. */
+  readonly requestBodyValues: unknown;
+  /** Response headers, when there was a response. */
+  readonly responseHeaders: Record<string, string> | undefined;
+  /** Raw response body text, when there was a response. */
+  readonly responseBody: string | undefined;
+  /** Whether a retry is worth attempting. */
+  readonly isRetryable: boolean;
+  /** Parsed error envelope, or other structured detail. */
+  readonly data: unknown;
+  /** Every leg tried, when this error ends a fallback chain. */
+  readonly attempts: CloudflareAIAttempt[] | undefined;
+  readonly cause: unknown;
+  constructor(options: {
+    message: string;
+    model: string;
+    url: string;
+    requestBodyValues: unknown;
+    status?: number;
+    code: CloudflareAIErrorCode;
+    logId?: string;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    isRetryable?: boolean;
+    data?: unknown;
+    cause?: unknown;
+    attempts?: CloudflareAIAttempt[];
+  });
+}
+//#endregion
+//#region src/models/core/gateway-providers.d.ts
+/**
+ * The AI Gateway provider table: which gateway provider slug a vendor's own
+ * base URL belongs to, and what the provider-native `endpoint` is for a
+ * given upstream URL.
+ *
+ * This is platform knowledge, not vendor knowledge — the gateway publishes the
+ * list, and every entry here appears in `AIGatewayProviders` from
+ * `@cloudflare/workers-types`. Nothing about a vendor's wire format, model ids
+ * or capabilities lives here: the vendor's own provider package builds the
+ * request, and this table only says where it goes.
+ *
+ * Adapted from `@cloudflare/ai-gateway-provider`'s `providers.ts`.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+/**
+ * The gateway provider slugs this table maps onto. A subset of the ambient
+ * `AIGatewayProviders` union; {@link GatewayProviderNameCheck} keeps it one.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+declare const GATEWAY_PROVIDER_NAMES: readonly [
+  "workers-ai",
+  "anthropic",
+  "openai",
+  "azure-openai",
+  "google-ai-studio",
+  "google-vertex-ai",
+  "grok",
+  "mistral",
+  "perplexity-ai",
+  "replicate",
+  "groq",
+  "deepseek",
+  "openrouter",
+  "cerebras",
+  "cohere",
+  "huggingface",
+  "aws-bedrock",
+  "elevenlabs",
+  "cartesia"
+];
+/**
+ * A gateway provider slug.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type GatewayProviderName = (typeof GATEWAY_PROVIDER_NAMES)[number];
+//#endregion
+//#region src/models/core/transport.d.ts
+/**
+ * The shape of a run-path request body, and of its answer, for a model AI
+ * Gateway's `/run` serves. A request in a model's native format is not
+ * converted, streams included.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+type RunRequestFormat = "chat-completions" | "messages" | "responses";
+/** One request on the Cloudflare run path. */
+interface TransportRequest {
+  /**
+   * Model id — a Workers AI id, an AI Gateway catalog id
+   * (`<author>/<model>`), or a dynamic route (`dynamic/<route>`).
+   */
+  model: string;
+  /** The provider-shaped request body (`input` on the run path). */
+  input: Record<string, unknown>;
+  /**
+   * The format `input` is in, and that the answer comes back in, for a model
+   * AI Gateway's `/run` serves. Defaults to chat completions. A Workers AI
+   * model's input is its own, so this is ignored for one.
+   */
+  format?: RunRequestFormat;
+  /** Gateway options for this request. */
+  gateway: ResolvedGateway;
+  /** Extra request headers, merged last. */
+  headers: Record<string, string>;
+  /** Abort signal, forwarded to the binding or to `fetch`. */
+  signal?: AbortSignal;
+  /**
+   * Audio for a Workers AI model that takes it as a raw body
+   * (`audio: { body, contentType }`, as Deepgram's Nova-3 does). `input`
+   * carries the model's other fields. The request goes to Workers AI
+   * directly: AI Gateway does not accept the body.
+   */
+  audio?: RawAudio;
+}
+/** Audio bytes and their media type, sent as a request body of their own. */
+interface RawAudio {
+  bytes: Uint8Array;
+  contentType: string;
+}
+/**
+ * A vendor's own request, sent to AI Gateway's provider-native path:
+ * `{gateway}/{provider}/{endpoint}`. Nothing is converted on the way — the
+ * method, headers and body are the vendor's — so the answer is the vendor's
+ * own response, streams included.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface NativeRequest {
+  /** The gateway provider slug, e.g. `anthropic`. */
+  provider: GatewayProviderName | string;
+  /** The vendor path after the provider slug, query string included. */
+  endpoint: string;
+  /** The HTTP method the vendor used. */
+  method: string;
+  /** The vendor's own request headers. */
+  headers: Record<string, string>;
+  /** The vendor's request body, untouched: JSON, multipart, or none. */
+  body: BodyInit | null | undefined;
+  /** Gateway options, sent as `cf-aig-*` headers. */
+  gateway: ResolvedGateway;
+  /** Abort signal, forwarded to the binding. */
+  signal?: AbortSignal;
+}
+/**
+ * The single code path both backends, the binding and HTTP, implement. Always
+ * resolves to a raw `Response`, so streaming and non-streaming calls share one
+ * path and nothing is buffered on the caller's behalf.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface Transport {
+  /** A stable identifier for the endpoint, used in error reporting. */
+  readonly url: string;
+  run(request: TransportRequest): Promise<Response>;
+  /**
+   * Sends a vendor's own request to AI Gateway's provider-native path. It
+   * resolves to the vendor's raw `Response`, error responses included: only
+   * the gateway's own failures (a missing gateway, an unpaid account) are
+   * lifted, by the caller, because the vendor's own code knows how to read
+   * its errors and we do not.
+   */
+  native(request: NativeRequest): Promise<Response>;
+  /**
+   * A log id read off the backend itself when the response carried none. The
+   * Workers AI binding exposes the last gateway log id as a mutable property,
+   * so it is captured per response rather than read late.
+   */
+  logIdFallback(response: Response): string | undefined;
+}
+//#endregion
+export {
+  DynamicRouteId as _,
+  CloudflareAIError as a,
+  WorkersAIModelId as b,
+  GatewayOptions as c,
+  CatalogModelId as d,
+  CloudflareEmbeddingModelId as f,
+  CloudflareTranscriptionModelId as g,
+  CloudflareSpeechModelId as h,
+  CloudflareAIAttempt as i,
+  ModelOptions as l,
+  CloudflareRerankingModelId as m,
+  GATEWAY_PROVIDER_NAMES as n,
+  CloudflareAIErrorCode as o,
+  CloudflareImageModelId as p,
+  GatewayProviderName as r,
+  AISettings as s,
+  Transport as t,
+  ProviderGatewaySettings as u,
+  KnownImageModelId as v,
+  KnownSpeechModelId as y
+};
+//# sourceMappingURL=transport-CPh7YGiw.d.ts.map

package/dist/voice/index.d.ts

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

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

@@ -53,7 +53,7 @@ function webFetchTool(options) {
 		async execute(input, _api, context) {
 			const run = await core.run(input, { signal: context.abortSignal });
 			if (run.ok) return {
-				content: [{
+				output: [{
 					type: "text",
 					text: run.text
 				}],
@@ -72,7 +72,7 @@ function webFetchTool(options) {
 			if (run.error.url !== void 0) details.url = run.error.url;
 			if (run.error.contentType !== void 0) details.contentType = run.error.contentType;
 			return {
-				content: [{
+				output: [{
 					type: "text",
 					text: run.text
 				}],

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

@@ -1 +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"}
+{"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          output: [{ 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        output: [{ 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,QAAQ,CAAC;KAAE,MAAM;KAAQ,MAAM,IAAI;IAAK,CAAC;IACzC,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,QAAQ,CAAC;KAAE,MAAM;KAAQ,MAAM,IAAI;IAAK,CAAC;IACzC,SAAS;IACT;GACF;EACF;CACF;AACF"}

package/dist/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-cQRkwSZZ.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-DkT_DJBm.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/web/search/tools/ai-sdk.js

@@ -1,5 +1,5 @@
-import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../../tool-cQRkwSZZ.js";
-import { t as webSearchInputSchema } from "../../../input-schema-D2QAtHZH.js";
+import { i as WebSearchError, n as createWebSearchToolCore, r as toolFailure } from "../../../tool-DkT_DJBm.js";
+import { t as webSearchInputSchema } from "../../../input-schema-B0Etuo-o.js";
 //#region src/web/search/tools/ai-sdk.ts
 /**
 * Create an AI SDK tool that searches the web through Cloudflare's Web