agents 0.25.0 → 0.27.0

package/dist/settings-C45hDliX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-C45hDliX.js","names":[],"sources":["../src/models/core/settings.ts"],"sourcesContent":["import type { WorkersAIModelId } from \"./catalog\";\n\n/** The gateway id Cloudflare auto-creates on first use. */\nexport const DEFAULT_GATEWAY_ID = \"default\";\n\n/** Key that per-call options live under in a framework's per-call options bag. */\nexport const PROVIDER_OPTIONS_KEY = \"cloudflare\";\n\n/**\n * AI Gateway settings for a request. The gateway is an option, not a separate\n * product: every call goes through one, and `id` defaults to `\"default\"`,\n * which Cloudflare creates on first use.\n *\n * @experimental This surface is experimental and may change.\n */\nexport interface GatewayOptions {\n  /** Gateway id. Defaults to `\"default\"` (auto-created on first use). */\n  id?: string;\n  /** Bypass the cache for this request. */\n  skipCache?: boolean;\n  /** Cache lifetime in seconds. */\n  cacheTtl?: number;\n  /** Explicit cache key, instead of the request-derived one. */\n  cacheKey?: string;\n  /** Whether the gateway stores the request/response in its log. */\n  collectLog?: boolean;\n  /** Arbitrary key/values attached to the gateway log entry. */\n  metadata?: Record<string, string | number | boolean | null>;\n  /** Correlates several requests into one gateway event. */\n  eventId?: string;\n  /** Upstream request timeout in milliseconds. */\n  requestTimeoutMs?: number;\n  /** Server-side retry policy for the upstream provider call. */\n  retries?: {\n    maxAttempts?: 1 | 2 | 3 | 4 | 5;\n    retryDelayMs?: number;\n    backoff?: \"constant\" | \"linear\" | \"exponential\";\n  };\n}\n\n/**\n * How `createAI` reaches Cloudflare: the Workers AI binding, and nothing else.\n * Workers AI models go through `env.AI.run`, vendor models through\n * `env.AI.gateway(id).run` — both are the binding, so there is no HTTP\n * transport, no account id and no API token to hold.\n *\n * @experimental This surface is experimental and may change.\n */\nexport type AISettings = {\n  /** The `AI` binding from a Worker's env. */\n  binding: Ai;\n} & ProviderGatewaySettings;\n\n/**\n * Provider-wide gateway defaults, in either spelling: nested under `gateway`,\n * or flat (`{ id: \"prod\", cacheTtl: 60 }`). Both merge, the flat key winning.\n *\n * @experimental This surface is experimental and may change.\n */\nexport interface ProviderGatewaySettings extends GatewayOptions {\n  /** Gateway id or full gateway options. */\n  gateway?: string | GatewayOptions;\n}\n\n/**\n * Per-model and per-call options. The flat gateway keys are sugar for\n * `gateway: { ... }`; both forms merge, with the flat key winning.\n *\n * The same shape is accepted per call under\n * `providerOptions.cloudflare`, where it takes precedence over the per-model\n * options, which in turn take precedence over the `createAI` settings.\n *\n * `Leg` is what a framework module accepts as a fallback leg. Workers AI ids\n * are the only kind this module can resolve on its own, so they are the\n * default; a module whose legs may also be model objects says so\n * (`ModelOptions<WorkersAIModelId | LanguageModelV4>`) rather than rebuilding\n * the type.\n *\n * @experimental This surface is experimental and may change.\n */\nexport interface ModelOptions<\n  Leg = WorkersAIModelId\n> extends ProviderGatewaySettings {\n  /**\n   * Models to try, in order, if the primary fails before any output is\n   * produced. A leg travels with the chain's gateway options — those win over\n   * a leg's own, and `metadata` merges — while everything a leg was built with\n   * itself stays its own. Client-side today; becomes server-side when the\n   * platform ships model-first routing.\n   */\n  fallback?: Leg[];\n  /** Extra request headers, merged last. */\n  headers?: Record<string, string>;\n  /**\n   * Workers AI only: route same-key requests to the same replica for\n   * prefix-cache hits. Sent as the `x-session-affinity` header.\n   */\n  sessionAffinity?: string;\n  /**\n   * Explicit reasoning effort. `null` disables reasoning on models that\n   * support toggling it. The unified AI SDK `reasoning` call option maps onto\n   * this when this is not set.\n   */\n  reasoningEffort?: \"low\" | \"medium\" | \"high\" | null;\n  /**\n   * Workers AI only: forwarded verbatim as `chat_template_kwargs`, e.g.\n   * `{ enable_thinking: false }`.\n   */\n  chatTemplateKwargs?: Record<string, unknown>;\n}\n\n/** A gateway config with the id filled in. */\nexport interface ResolvedGateway extends GatewayOptions {\n  id: string;\n}\n\n/** Everything one request needs, after merging all three option layers. */\nexport interface ResolvedOptions {\n  gateway: ResolvedGateway;\n  headers: Record<string, string>;\n  sessionAffinity: string | undefined;\n  reasoningEffort: \"low\" | \"medium\" | \"high\" | null | undefined;\n  chatTemplateKwargs: Record<string, unknown> | undefined;\n  /**\n   * The fallback legs given as ids. A module whose legs may also be model\n   * objects keeps its own ordered list; this one is what the id-only callers\n   * (embeddings, the other modalities) need.\n   */\n  fallback: string[];\n}\n\n/** The id legs of a fallback list; model objects are their module's business. */\nfunction idLegs(fallback: unknown[] | undefined): string[] {\n  return (fallback ?? []).filter(\n    (leg): leg is string => typeof leg === \"string\"\n  );\n}\n\n/** Strips `undefined` values so a later layer never blanks an earlier one. */\nfunction defined<T extends object>(value: T): T {\n  const result: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    if (entry !== undefined) result[key] = entry;\n  }\n  return result as T;\n}\n\nfunction normalizeGateway(\n  gateway: string | GatewayOptions | undefined\n): GatewayOptions {\n  if (gateway === undefined) return {};\n  // An explicit `undefined` inside a gateway object means \"not set\", exactly\n  // as the flat sugar does; it must not blank out a lower layer's value.\n  return typeof gateway === \"string\" ? { id: gateway } : defined(gateway);\n}\n\n/**\n * Folds one layer's flat gateway sugar into its `gateway` object. The flat key\n * wins over the nested one, and an explicit `undefined` on either never blanks\n * a lower layer.\n */\nfunction layerGateway(\n  options: ProviderGatewaySettings | undefined\n): GatewayOptions {\n  if (options === undefined) return {};\n  return {\n    ...normalizeGateway(options.gateway),\n    ...defined({\n      cacheKey: options.cacheKey,\n      cacheTtl: options.cacheTtl,\n      collectLog: options.collectLog,\n      eventId: options.eventId,\n      id: options.id,\n      metadata: options.metadata,\n      requestTimeoutMs: options.requestTimeoutMs,\n      retries: options.retries,\n      skipCache: options.skipCache\n    })\n  };\n}\n\n/** The flat gateway sugar {@link layerGateway} folds into `gateway`. */\nconst FLAT_GATEWAY_KEYS = [\n  \"cacheKey\",\n  \"cacheTtl\",\n  \"collectLog\",\n  \"eventId\",\n  \"gateway\",\n  \"id\",\n  \"metadata\",\n  \"requestTimeoutMs\",\n  \"retries\",\n  \"skipCache\"\n] as const;\n\n/**\n * One layer's gateway options as a single object, both spellings folded in.\n * Exported so a module that collapses two option layers into one bag (a\n * fallback leg inheriting a chain's gateway) can merge them field by field\n * rather than replacing one object with the other.\n *\n * @experimental This surface is experimental and may change.\n */\nexport function gatewayLayerOf(\n  options: ProviderGatewaySettings | undefined\n): GatewayOptions {\n  return layerGateway(options);\n}\n\n/** An option bag without the gateway keys, whichever spelling they used. */\nfunction withoutGatewayKeys<Leg>(\n  options: ModelOptions<Leg>\n): ModelOptions<Leg> {\n  const rest: Record<string, unknown> = { ...options };\n  for (const key of FLAT_GATEWAY_KEYS) delete rest[key];\n  return defined(rest as ModelOptions<Leg>);\n}\n\n/**\n * Collapses two option layers into one bag, `override` winning field by field.\n *\n * The gateway keys of both are folded into a single `gateway` object, so\n * neither layer's flat sugar can out-rank the other's nested spelling when the\n * bag is resolved later, and `metadata` merges rather than replaces — the same\n * rules {@link resolveOptions} applies across its three layers.\n *\n * @experimental This surface is experimental and may change.\n */\nexport function mergeModelOptions<Leg>(\n  base: ModelOptions<Leg> | undefined,\n  override: ModelOptions<Leg> | undefined\n): ModelOptions<Leg> | undefined {\n  if (base === undefined) return override;\n  if (override === undefined) return base;\n  const layers = [layerGateway(base), layerGateway(override)];\n  const gateway: GatewayOptions = Object.assign({}, ...layers);\n  const metadata = Object.assign({}, ...layers.map((layer) => layer.metadata));\n  const retries = mergeRetries(layers);\n  // Headers merge field by field, as they do across `resolveOptions`' three\n  // layers: replacing the object wholesale would drop a header the lower layer\n  // was configured with. The spread comes after the override's own keys so it\n  // wins over the `headers` that spread carried.\n  const headers = { ...base.headers, ...override.headers };\n  return {\n    ...withoutGatewayKeys(base),\n    ...withoutGatewayKeys(override),\n    ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    gateway: {\n      ...gateway,\n      ...(Object.keys(metadata).length > 0 ? { metadata } : {}),\n      ...(retries === undefined ? {} : { retries })\n    }\n  };\n}\n\n/**\n * Merges the retry policies field by field, so a provider-wide `backoff` still\n * applies when a call only sets `maxAttempts`. `undefined` on any layer means\n * \"not set\" and never blanks a lower one.\n */\nfunction mergeRetries(\n  layers: GatewayOptions[]\n): GatewayOptions[\"retries\"] | undefined {\n  const merged = layers.reduce<NonNullable<GatewayOptions[\"retries\"]>>(\n    (result, layer) => ({\n      ...result,\n      ...(layer.retries === undefined ? {} : defined(layer.retries))\n    }),\n    {}\n  );\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * Merges the option layers. Precedence is per-call\n * (`providerOptions.cloudflare`) > per-model (`ai(id, options)`) >\n * provider (`createAI({ ... })`).\n *\n * The provider layer takes the whole settings object as well as a bare\n * `gateway` value, so `createAI({ binding, id: \"prod\", cacheTtl: 60 })` reads\n * the same as `createAI({ binding, gateway: { id: \"prod\", cacheTtl: 60 } })`.\n *\n * @experimental This surface is experimental and may change.\n */\nexport function resolveOptions(\n  provider: string | ProviderGatewaySettings | undefined,\n  model: ModelOptions<unknown> | undefined,\n  call: ModelOptions<unknown> | undefined\n): ResolvedOptions {\n  const layers =\n    typeof provider === \"string\"\n      ? [normalizeGateway(provider), layerGateway(model), layerGateway(call)]\n      : [layerGateway(provider), layerGateway(model), layerGateway(call)];\n  const gateway: GatewayOptions = Object.assign({}, ...layers);\n  const metadata = Object.assign({}, ...layers.map((layer) => layer.metadata));\n  const retries = mergeRetries(layers);\n  return {\n    chatTemplateKwargs: call?.chatTemplateKwargs ?? model?.chatTemplateKwargs,\n    fallback: idLegs(call?.fallback ?? model?.fallback),\n    gateway: {\n      ...gateway,\n      id: gateway.id ?? DEFAULT_GATEWAY_ID,\n      ...(Object.keys(metadata).length > 0 ? { metadata } : {}),\n      ...(retries === undefined ? {} : { retries })\n    },\n    headers: { ...model?.headers, ...call?.headers },\n    // `null` is a meaningful value here (it disables reasoning), so the call\n    // layer wins on any value it actually set, not just on a truthy one.\n    reasoningEffort:\n      call?.reasoningEffort !== undefined\n        ? call.reasoningEffort\n        : model?.reasoningEffort,\n    sessionAffinity: call?.sessionAffinity ?? model?.sessionAffinity\n  };\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction asStringRecord(value: unknown): Record<string, string> | undefined {\n  const record = asRecord(value);\n  if (record === undefined) return undefined;\n  const result: Record<string, string> = {};\n  for (const [key, entry] of Object.entries(record)) {\n    if (typeof entry === \"string\") result[key] = entry;\n  }\n  return result;\n}\n\nfunction asString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction asNumber(value: unknown): number | undefined {\n  return typeof value === \"number\" ? value : undefined;\n}\n\nfunction asBoolean(value: unknown): boolean | undefined {\n  return typeof value === \"boolean\" ? value : undefined;\n}\n\nfunction asReasoningEffort(\n  value: unknown\n): \"low\" | \"medium\" | \"high\" | null | undefined {\n  if (value === null) return null;\n  if (value === \"low\" || value === \"medium\" || value === \"high\") return value;\n  return undefined;\n}\n\n/**\n * Metadata values the gateway accepts are scalars only; a nested object or\n * array would be rejected by the binding, so drop those rather than forward\n * them.\n */\nfunction asMetadata(value: unknown): GatewayOptions[\"metadata\"] {\n  const record = asRecord(value);\n  if (record === undefined) return undefined;\n  const result: NonNullable<GatewayOptions[\"metadata\"]> = {};\n  for (const [key, entry] of Object.entries(record)) {\n    if (\n      entry === null ||\n      typeof entry === \"string\" ||\n      typeof entry === \"number\" ||\n      typeof entry === \"boolean\"\n    ) {\n      result[key] = entry;\n    }\n  }\n  return result;\n}\n\nconst BACKOFFS = [\"constant\", \"linear\", \"exponential\"] as const;\n\n/** Reads the retry policy field by field; the binding validates it strictly. */\nfunction asRetries(value: unknown): GatewayOptions[\"retries\"] {\n  const record = asRecord(value);\n  if (record === undefined) return undefined;\n  const maxAttempts = asNumber(record.maxAttempts);\n  const backoff = asString(record.backoff);\n  const retries = defined({\n    backoff: BACKOFFS.find((entry) => entry === backoff),\n    maxAttempts:\n      maxAttempts !== undefined &&\n      Number.isInteger(maxAttempts) &&\n      maxAttempts >= 1 &&\n      maxAttempts <= 5\n        ? (maxAttempts as 1 | 2 | 3 | 4 | 5)\n        : undefined,\n    retryDelayMs: asNumber(record.retryDelayMs)\n  });\n  // An empty policy is not a policy: returning `{}` would out-rank a lower\n  // layer's real one when the layers merge.\n  return Object.keys(retries).length > 0 ? retries : undefined;\n}\n\n/** Reads the shared gateway keys out of a loosely-typed record. */\nfunction parseGatewayFields(raw: Record<string, unknown>): GatewayOptions {\n  return defined({\n    cacheKey: asString(raw.cacheKey),\n    cacheTtl: asNumber(raw.cacheTtl),\n    collectLog: asBoolean(raw.collectLog),\n    eventId: asString(raw.eventId),\n    id: asString(raw.id),\n    metadata: asMetadata(raw.metadata),\n    requestTimeoutMs: asNumber(raw.requestTimeoutMs),\n    retries: asRetries(raw.retries),\n    skipCache: asBoolean(raw.skipCache)\n  });\n}\n\n/**\n * Reads per-call options out of a loosely-typed options bag (the value a\n * framework keeps under {@link PROVIDER_OPTIONS_KEY}).\n *\n * The bag is plain JSON, so every field is read defensively: anything of an\n * unexpected type is dropped rather than thrown, because a malformed\n * observability hint should never fail a generation.\n *\n * @experimental This surface is experimental and may change.\n */\nexport function parseModelOptions(value: unknown): ModelOptions | undefined {\n  const raw = asRecord(value);\n  if (raw === undefined) return undefined;\n\n  const nested = asRecord(raw.gateway);\n  const gateway: string | GatewayOptions | undefined =\n    typeof raw.gateway === \"string\"\n      ? raw.gateway\n      : nested !== undefined\n        ? parseGatewayFields(nested)\n        : undefined;\n\n  const fallback = Array.isArray(raw.fallback)\n    ? raw.fallback.filter(\n        (entry): entry is WorkersAIModelId => typeof entry === \"string\"\n      )\n    : undefined;\n\n  return defined({\n    ...parseGatewayFields(raw),\n    chatTemplateKwargs: asRecord(raw.chatTemplateKwargs),\n    fallback,\n    gateway,\n    headers: asStringRecord(raw.headers),\n    reasoningEffort: asReasoningEffort(raw.reasoningEffort),\n    sessionAffinity: asString(raw.sessionAffinity)\n  });\n}\n"],"mappings":"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"}

package/dist/{transport-PfFnt-Ld.d.ts → settings-NgGwF7Qt.d.ts}

@@ -313,213 +313,19 @@ 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 universal request's `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
-/** One request on the Cloudflare run path. */
-interface TransportRequest {
-  /** Model id — Workers AI slug or catalog `<author>/<model>`. */
-  model: string;
-  /** The provider-shaped request body (`input` on the run path). */
-  input: Record<string, unknown>;
-  /** 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;
-}
-/**
- * One request on the universal AI Gateway path: a vendor's own request, routed
- * by the gateway to that vendor. The body is the vendor's, untouched — nothing
- * here knows the vendor's wire format.
- *
- * @experimental This surface is experimental and may change.
- */
-interface UniversalRequest {
-  /** The gateway provider slug the request is routed to. */
-  provider: GatewayProviderName | string;
-  /** The vendor path the gateway appends to that provider's base URL. */
-  endpoint: string;
-  /** The vendor's own request headers, minus its credential header. */
-  headers: Record<string, string>;
-  /** The vendor's request body, verbatim. */
-  query: unknown;
-  /** Gateway options for this request. */
-  gateway: ResolvedGateway;
-  /** Extra headers merged last, outside the vendor's own set. */
-  extraHeaders?: Record<string, string>;
-  /** Abort signal, forwarded to the binding or to `fetch`. */
-  signal?: AbortSignal;
-}
-/**
- * The single code path both backends 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 through the gateway's universal endpoint.
-   * Always resolves to the vendor's raw `Response`, error responses included:
-   * only the gateway's own failures (a missing gateway, an unpaid account) are
-   * lifted into a {@link CloudflareAIError}, because the vendor's provider
-   * knows how to read its own errors and we do not.
-   */
-  universal(request: UniversalRequest): 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 {
-  KnownSpeechModelId as _,
-  CloudflareAIError as a,
-  GatewayOptions as c,
-  CloudflareEmbeddingModelId as d,
-  CloudflareImageModelId as f,
-  KnownImageModelId as g,
-  CloudflareTranscriptionModelId as h,
-  CloudflareAIAttempt as i,
-  ModelOptions as l,
-  CloudflareSpeechModelId as m,
-  GATEWAY_PROVIDER_NAMES as n,
-  CloudflareAIErrorCode as o,
-  CloudflareRerankingModelId as p,
-  GatewayProviderName as r,
-  AISettings as s,
-  Transport as t,
-  ProviderGatewaySettings as u,
-  WorkersAIModelId as v
+  ResolvedGateway as a,
+  CloudflareRerankingModelId as c,
+  KnownImageModelId as d,
+  KnownSpeechModelId as f,
+  ProviderGatewaySettings as i,
+  CloudflareSpeechModelId as l,
+  GatewayOptions as n,
+  CloudflareEmbeddingModelId as o,
+  WorkersAIModelId as p,
+  ModelOptions as r,
+  CloudflareImageModelId as s,
+  AISettings as t,
+  CloudflareTranscriptionModelId as u
 };
-//# sourceMappingURL=transport-PfFnt-Ld.d.ts.map
+//# sourceMappingURL=settings-NgGwF7Qt.d.ts.map

package/dist/{src-BZeu-SCD.js → src-DgCbZtIR.js}

@@ -11,17 +11,17 @@ import { signAgentHeaders } from "./email.js";
 import { sendAgentEmail } from "./email-send.js";
 import { n as withInvocationScope, r as writeSpanAttributes, t as tracer } from "./cloudflare-Dzvc7V2N.js";
 import { parseSubAgentPath } from "./sub-routing.js";
-import { a as getConnectionFlag, c as isConnectionReadonly, d as setConnectionProtocolEnabled, f as setConnectionReadonly, i as ensureConnectionWrapped, l as registerInternalConnectionKeys, o as getConnectionRawState, s as isConnectionProtocolEnabled, t as WebSockets, u as setConnectionFlag } from "./websockets-Ci-LZFHH.js";
+import { a as getConnectionFlag, c as isConnectionReadonly, d as setConnectionProtocolEnabled, f as setConnectionReadonly, i as ensureConnectionWrapped, l as registerInternalConnectionKeys, o as getConnectionRawState, s as isConnectionProtocolEnabled, t as WebSockets, u as setConnectionFlag } from "./websockets-CmENGb-Z.js";
 import { t as LifecycleCapability } from "./capability-B4WbF81e.js";
 import { a as abortWithoutAlarmRetry, i as setLifecycleRouteTransport, n as setLifecycleEventSink, r as setLifecycleHostInvoker, t as Lifecycle } from "./lifecycle-CFu6OV03.js";
 import { isErrorRetryable, tryN, validateRetryOptions } from "./retries.js";
 import { SqlError } from "./sql-error.js";
-import { a as ensureMcpServerTable, d as DisposableStore, i as normalizeServerId, l as RPC_DO_PREFIX, o as MCPConnectionState, t as MCPClientManager } from "./client-fyQrLGkD.js";
+import { a as ensureMcpServerTable, d as DisposableStore, i as normalizeServerId, l as RPC_DO_PREFIX, o as MCPConnectionState, t as MCPClientManager } from "./client-1tEQ1Oqz.js";
 import { DurableObjectOAuthClientProvider } from "./mcp/client/do-oauth-client-provider.js";
 import { genericObservability } from "./observability/index.js";
 import { n as setSchedulerCallbackResolver, t as Scheduler } from "./scheduler-DZ3xQfeK.js";
 import { n as setQueueCallbackResolver, t as Queue } from "./queue-BB-zfIYF.js";
-import { n as setTaskDefinitionResolver, r as setTaskRoutedMemoryLimitHandler, t as Tasks } from "./tasks-68DESxf0.js";
+import { n as setTaskDefinitionResolver, r as setTaskRoutedMemoryLimitHandler, t as Tasks } from "./tasks-CkTZNaV1.js";
 import { State } from "./state/index.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { DurableObject, RpcTarget, exports } from "cloudflare:workers";
@@ -7001,4 +7001,4 @@ var StreamingResponse = class {
 //#endregion
 export { routeAgentEmail as a, getCurrentAgent as i, DEFAULT_AGENT_STATIC_OPTIONS as n, StreamingResponse as r, Agent as t };
 
-//# sourceMappingURL=src-BZeu-SCD.js.map
+//# sourceMappingURL=src-DgCbZtIR.js.map