agents 0.27.0 → 0.28.1

package/dist/{settings-C45hDliX.js → settings-BjAiPd6Z.js}

@@ -35,7 +35,8 @@ function layerGateway(options) {
 			metadata: options.metadata,
 			requestTimeoutMs: options.requestTimeoutMs,
 			retries: options.retries,
-			skipCache: options.skipCache
+			skipCache: options.skipCache,
+			zdr: options.zdr
 		})
 	};
 }
@@ -50,7 +51,8 @@ const FLAT_GATEWAY_KEYS = [
 	"metadata",
 	"requestTimeoutMs",
 	"retries",
-	"skipCache"
+	"skipCache",
+	"zdr"
 ];
 /**
 * One layer's gateway options as a single object, both spellings folded in.
@@ -218,7 +220,8 @@ function parseGatewayFields(raw) {
 		metadata: asMetadata(raw.metadata),
 		requestTimeoutMs: asNumber(raw.requestTimeoutMs),
 		retries: asRetries(raw.retries),
-		skipCache: asBoolean(raw.skipCache)
+		skipCache: asBoolean(raw.skipCache),
+		zdr: asBoolean(raw.zdr)
 	});
 }
 /**
@@ -250,4 +253,4 @@ function parseModelOptions(value) {
 //#endregion
 export { parseModelOptions as a, mergeModelOptions as i, PROVIDER_OPTIONS_KEY as n, resolveOptions as o, gatewayLayerOf as r, DEFAULT_GATEWAY_ID as t };
 
-//# sourceMappingURL=settings-C45hDliX.js.map
+//# sourceMappingURL=settings-BjAiPd6Z.js.map

package/dist/settings-BjAiPd6Z.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-BjAiPd6Z.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   * Zero Data Retention for this request, sent as `cf-aig-zdr`. `true` turns\n   * it on and `false` turns it off, whatever the gateway's own setting. It\n   * applies to vendor models routed through the gateway on unified billing.\n   */\n  zdr?: boolean;\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      zdr: options.zdr\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  \"zdr\"\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    zdr: asBoolean(raw.zdr)\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/{settings-NgGwF7Qt.d.ts → settings-DnD__xuE.d.ts}

@@ -109,6 +109,17 @@ type WorkersAIModelId =
       `@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 text-embedding model id accepted by `ai.embedding()`.
  *
@@ -242,6 +253,12 @@ interface GatewayOptions {
     retryDelayMs?: number;
     backoff?: "constant" | "linear" | "exponential";
   };
+  /**
+   * Zero Data Retention for this request, sent as `cf-aig-zdr`. `true` turns
+   * it on and `false` turns it off, whatever the gateway's own setting. It
+   * applies to vendor models routed through the gateway on unified billing.
+   */
+  zdr?: boolean;
 }
 /**
  * How `createAI` reaches Cloudflare: the Workers AI binding, and nothing else.
@@ -316,16 +333,17 @@ interface ResolvedGateway extends GatewayOptions {
 export {
   ResolvedGateway as a,
   CloudflareRerankingModelId as c,
-  KnownImageModelId as d,
-  KnownSpeechModelId as f,
+  DynamicRouteId as d,
+  KnownImageModelId as f,
   ProviderGatewaySettings as i,
   CloudflareSpeechModelId as l,
+  WorkersAIModelId as m,
   GatewayOptions as n,
   CloudflareEmbeddingModelId as o,
-  WorkersAIModelId as p,
+  KnownSpeechModelId as p,
   ModelOptions as r,
   CloudflareImageModelId as s,
   AISettings as t,
   CloudflareTranscriptionModelId as u
 };
-//# sourceMappingURL=settings-NgGwF7Qt.d.ts.map
+//# sourceMappingURL=settings-DnD__xuE.d.ts.map

package/dist/{src-DgCbZtIR.js → src-CQxJFv4l.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-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 { 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-C3zy8YR0.js";
+import { t as LifecycleCapability } from "./capability-DBAKc6UZ.js";
+import { a as abortWithoutAlarmRetry, i as setLifecycleRouteTransport, n as setLifecycleEventSink, r as setLifecycleHostInvoker, t as Lifecycle } from "./lifecycle-DGorpAmA.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-1tEQ1Oqz.js";
+import { a as ensureMcpServerTable, d as DisposableStore, i as normalizeServerId, l as RPC_DO_PREFIX, o as MCPConnectionState, t as MCPClientManager } from "./client-BnYbNT3z.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-CkTZNaV1.js";
+import { n as setSchedulerCallbackResolver, t as Scheduler } from "./scheduler-FIHv2-kJ.js";
+import { n as setQueueCallbackResolver, t as Queue } from "./queue-CcIjVYTE.js";
+import { n as setTaskDefinitionResolver, r as setTaskRoutedMemoryLimitHandler, t as Tasks } from "./tasks-BN_5AWqI.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-DgCbZtIR.js.map
+//# sourceMappingURL=src-CQxJFv4l.js.map