agents 0.27.0 → 0.28.1

package/dist/mcp/server/index.js

@@ -1,2 +1,2 @@
-import { n as getMcpAuthContext, t as createStatelessMcpHandler } from "../../handler-stateless-VvrWSAVA.js";
+import { n as getMcpAuthContext, t as createStatelessMcpHandler } from "../../handler-stateless-Bly_nSH3.js";
 export { createStatelessMcpHandler as createMcpHandler, getMcpAuthContext };

package/dist/models/ai-sdk/index.d.ts

@@ -1,23 +1,24 @@
 import {
   c as CloudflareRerankingModelId,
-  d as KnownImageModelId,
-  f as KnownSpeechModelId,
+  d as DynamicRouteId,
+  f as KnownImageModelId,
   i as ProviderGatewaySettings,
   l as CloudflareSpeechModelId,
+  m as WorkersAIModelId,
   n as GatewayOptions,
   o as CloudflareEmbeddingModelId,
-  p as WorkersAIModelId,
+  p as KnownSpeechModelId,
   r as ModelOptions$1,
   s as CloudflareImageModelId,
   t as AISettings,
   u as CloudflareTranscriptionModelId
-} from "../../settings-NgGwF7Qt.js";
+} from "../../settings-DnD__xuE.js";
 import {
   a as CloudflareAIError$1,
   i as CloudflareAIAttempt,
   o as CloudflareAIErrorCode,
   t as Transport
-} from "../../transport-k2mFrtL8.js";
+} from "../../transport-DCyarnwm.js";
 import {
   APICallError,
   EmbeddingModelV4,
@@ -33,12 +34,13 @@ import {
 
 //#region src/models/ai-sdk/settings.d.ts
 /**
- * One leg of a fallback chain: a Workers AI id, or any AI SDK language model
- * — including one this provider has already wrapped for the gateway.
+ * One leg of a fallback chain: a Workers AI id, an AI Gateway dynamic route,
+ * or any AI SDK language model — including one this provider has already
+ * wrapped for the gateway.
  *
  * @experimental This surface is experimental and may change.
  */
-type FallbackLeg = WorkersAIModelId | LanguageModelV4;
+type FallbackLeg = WorkersAIModelId | DynamicRouteId | LanguageModelV4;
 /**
  * Per-model and per-call options.
  *
@@ -50,17 +52,34 @@ type FallbackLeg = WorkersAIModelId | LanguageModelV4;
  * @experimental This surface is experimental and may change.
  */
 type ModelOptions = ModelOptions$1<FallbackLeg>;
+/**
+ * Which key authenticates a vendor model routed through AI Gateway.
+ *
+ * @experimental This surface is experimental and may change.
+ */
+interface VendorKeyOptions {
+  /**
+   * `"gateway"` (the default) strips the key the vendor's provider put on the
+   * request, so the gateway supplies one: unified billing, or a BYOK key
+   * stored on the gateway. `"request"` forwards that key to the vendor, for a
+   * key you hold yourself, e.g. `createAnthropic({ apiKey: env.ANTHROPIC_KEY })`.
+   *
+   * It belongs to the model it is set on, so a fallback leg keeps its own.
+   */
+  vendorKey?: "gateway" | "request";
+}
 /**
  * The options accepted next to a model object — `ai(anthropic("…"), { … })`.
- * The same shape as {@link ModelOptions}; the Workers-AI-only knobs
- * (`reasoningEffort`, `chatTemplateKwargs`) are ignored with a warning.
+ * {@link ModelOptions} plus {@link VendorKeyOptions.vendorKey}; the
+ * Workers-AI-only knobs (`reasoningEffort`, `chatTemplateKwargs`) are ignored
+ * with a warning.
  *
  * @experimental This surface is experimental and may change.
  */
-type GatewayModelOptions = ModelOptions;
+type GatewayModelOptions = ModelOptions & VendorKeyOptions;
 /**
- * The options `ai.routed()` takes: the gateway options, `headers` and
- * `sessionAffinity`.
+ * The options `ai.routed()` takes: the gateway options, `headers`,
+ * `sessionAffinity` and `vendorKey`.
  *
  * A routed embedding, image, speech or transcription model is the vendor's
  * own, and only its transport is ours — there is no chain to fall back through
@@ -74,7 +93,8 @@ type GatewayModelOptions = ModelOptions;
 type RoutedModelOptions = Omit<
   ModelOptions,
   "fallback" | "reasoningEffort" | "chatTemplateKwargs"
->;
+> &
+  VendorKeyOptions;
 /**
  * The options the Workers-AI-only methods take — `ai.embedding`, `ai.image`,
  * `ai.speech`, `ai.transcription`, `ai.reranking`.
@@ -184,7 +204,7 @@ declare class GatewayLanguageModel implements LanguageModelV4 {
   readonly specificationVersion: "v4";
   constructor(
     model: LanguageModelV4,
-    options: ModelOptions | undefined,
+    options: GatewayModelOptions | undefined,
     config: LanguageModelConfig
   );
   /** The vendor's own provider name — `anthropic.messages`, `openai.responses`. */
@@ -219,8 +239,13 @@ declare class GatewayLanguageModel implements LanguageModelV4 {
 interface AI {
   /** A Workers AI model. Third-party ids are not ids here — pass the model. */
   (modelId: WorkersAIModelId, options?: ModelOptions): LanguageModelV4;
+  /**
+   * An AI Gateway dynamic route, `dynamic/<route>`: the route configured on
+   * the gateway picks the model, and it answers like a chat model.
+   */
+  (route: DynamicRouteId, options?: ModelOptions): LanguageModelV4;
   /** Any AI SDK v4 language model, routed through AI Gateway. */
-  (model: LanguageModelV4, options?: ModelOptions): LanguageModelV4;
+  (model: LanguageModelV4, options?: GatewayModelOptions): LanguageModelV4;
   /** The AI SDK provider specification this implements. */
   readonly specificationVersion: "v4";
   /** Same as calling the provider directly. */
@@ -228,9 +253,10 @@ interface AI {
     modelId: WorkersAIModelId,
     options?: ModelOptions
   ): LanguageModelV4;
+  languageModel(route: DynamicRouteId, options?: ModelOptions): LanguageModelV4;
   languageModel(
     model: LanguageModelV4,
-    options?: ModelOptions
+    options?: GatewayModelOptions
   ): LanguageModelV4;
   /** The `ProviderV4` shape: a registry resolves models by string alone. */
   languageModel(modelId: string, options?: ModelOptions): LanguageModelV4;
@@ -339,6 +365,7 @@ export {
   type CloudflareRerankingModelId,
   type CloudflareSpeechModelId,
   type CloudflareTranscriptionModelId,
+  type DynamicRouteId,
   type FallbackLeg,
   GatewayLanguageModel,
   type GatewayModelOptions,
@@ -349,6 +376,7 @@ export {
   type ModelOptions,
   type ProviderGatewaySettings,
   type RoutedModelOptions,
+  type VendorKeyOptions,
   type WorkersAIModelId,
   createAI
 };

package/dist/models/ai-sdk/index.js

@@ -1,2 +1,2 @@
-import { n as GatewayLanguageModel, r as CloudflareAIError, t as createAI } from "../../ai-sdk-OoGkFy3s.js";
+import { n as GatewayLanguageModel, r as CloudflareAIError, t as createAI } from "../../ai-sdk-C2iTAwUd.js";
 export { CloudflareAIError, GatewayLanguageModel, createAI };

package/dist/models/opencode/index.d.ts

@@ -1,9 +1,9 @@
 import {
+  m as WorkersAIModelId,
   n as GatewayOptions,
-  p as WorkersAIModelId,
   r as ModelOptions,
   t as AISettings
-} from "../../settings-NgGwF7Qt.js";
+} from "../../settings-DnD__xuE.js";
 import { Plugin } from "@opencode/plugin";
 
 //#region src/models/opencode/index.d.ts

package/dist/models/opencode/index.js

@@ -1,4 +1,4 @@
-import { t as createAI$1 } from "../../ai-sdk-OoGkFy3s.js";
+import { t as createAI$1 } from "../../ai-sdk-C2iTAwUd.js";
 import { Model, Provider } from "@opencode/plugin";
 //#region src/models/opencode/language-v3.ts
 /**

package/dist/models/pi-ai/index.d.ts

@@ -1,17 +1,18 @@
 import {
+  d as DynamicRouteId,
+  m as WorkersAIModelId,
   n as GatewayOptions,
   o as CloudflareEmbeddingModelId,
-  p as WorkersAIModelId,
   r as ModelOptions,
   t as AISettings
-} from "../../settings-NgGwF7Qt.js";
+} from "../../settings-DnD__xuE.js";
 import {
   a as CloudflareAIError,
   i as CloudflareAIAttempt,
   n as GATEWAY_PROVIDER_NAMES,
   o as CloudflareAIErrorCode,
   r as GatewayProviderName
-} from "../../transport-k2mFrtL8.js";
+} from "../../transport-DCyarnwm.js";
 import {
   Api,
   AssistantImages,
@@ -201,6 +202,8 @@ type StreamFn = (
 interface AI {
   /** A Workers AI model: Cloudflare's own catalog, on the run path. */
   (modelId: WorkersAIModelId, options?: PiModelOptions): CloudflareModel;
+  /** An AI Gateway dynamic route, `dynamic/<route>`, on the Workers AI wire. */
+  (route: DynamicRouteId, options?: PiModelOptions): CloudflareModel;
   /** Any pi-ai model, routed through AI Gateway with its metadata intact. */
   <TApi extends Api>(model: Model<TApi>, options?: PiModelOptions): Model<TApi>;
   /**
@@ -210,6 +213,7 @@ interface AI {
   (target: string | Model<Api>, options?: PiModelOptions): RoutedModel;
   /** Same as calling the provider directly. */
   model(modelId: WorkersAIModelId, options?: PiModelOptions): CloudflareModel;
+  model(route: DynamicRouteId, options?: PiModelOptions): CloudflareModel;
   model<TApi extends Api>(
     model: Model<TApi>,
     options?: PiModelOptions
@@ -297,6 +301,7 @@ export {
   type CloudflareEmbeddingModelId,
   type CloudflareImagesModel,
   type CloudflareModel,
+  type DynamicRouteId,
   FALLBACK_DIAGNOSTIC,
   type FallbackAttempt,
   GATEWAY_PROVIDER_NAMES,

package/dist/models/pi-ai/index.js

@@ -1,5 +1,5 @@
-import { i as mergeModelOptions, o as resolveOptions, r as gatewayLayerOf } from "../../settings-C45hDliX.js";
-import { _ as isGatewayErrorEnvelope, a as normalizeChatCompletion, c as gatewaySlugForBaseUrl, d as resolveGatewayProvider, f as createTransport, g as headersToObject, h as errorFromResponse, i as normalizeChatCompletionsStream, l as isGatewayShapedUrl, m as errorFromGatewayEnvelope, n as imageMediaTypeOf, o as prepareChatCompletionsRequest, r as sseDataStream, s as GATEWAY_PROVIDER_NAMES, t as buildImageInput, v as unwrapEnvelope, x as isAbortError, y as CloudflareAIError } from "../../images-Ce9SCu3X.js";
+import { _ as isGatewayErrorEnvelope, a as normalizeChatCompletion, c as gatewaySlugForBaseUrl, d as resolveGatewayProvider, f as createTransport, g as headersToObject, h as errorFromResponse, i as normalizeChatCompletionsStream, l as isGatewayShapedUrl, m as errorFromGatewayEnvelope, n as imageMediaTypeOf, o as prepareChatCompletionsRequest, r as sseDataStream, s as GATEWAY_PROVIDER_NAMES, t as buildImageInput, v as unwrapEnvelope, w as isRunPathLanguageModelId, x as isAbortError, y as CloudflareAIError } from "../../images-C4hiIexM.js";
+import { i as mergeModelOptions, o as resolveOptions, r as gatewayLayerOf } from "../../settings-BjAiPd6Z.js";
 import { calculateCost, clampThinkingLevel, createAssistantMessageEventStream, createProvider, getCurrentTools, normalizeContext, parseStreamingJson } from "@earendil-works/pi-ai";
 import { CLOUDFLARE_AI_GATEWAY_MODELS } from "@earendil-works/pi-ai/providers/cloudflare-ai-gateway.models";
 import { CLOUDFLARE_WORKERS_AI_MODELS } from "@earendil-works/pi-ai/providers/cloudflare-workers-ai.models";
@@ -1646,7 +1646,7 @@ function legOptions(options) {
 }
 /** A leg may be given as a Workers AI id or as a model of any kind. */
 function legModel(leg, options) {
-	if (typeof leg === "string") return leg.startsWith("@cf/") ? buildWorkersAIModel(leg, options) : buildGatewayModel(leg, options);
+	if (typeof leg === "string") return isRunPathLanguageModelId(leg) ? buildWorkersAIModel(leg, options) : buildGatewayModel(leg, options);
 	const own = optionsOf(leg);
 	const inherited = gatewayLayerOf(options);
 	return withOptions(leg, mergeModelOptions(own, Object.keys(inherited).length > 0 ? inherited : void 0));
@@ -1724,16 +1724,16 @@ const VENDOR_HINTS = {
 */
 function unroutableString(specifier) {
 	const hint = VENDOR_HINTS[specifier.split("/")[0] ?? ""];
-	return /* @__PURE__ */ new TypeError(`ai("${specifier}") is not a model this provider knows. Workers AI ids start with "@cf/". A third-party model comes from its own pi-ai registry: ai(getBuiltinModel(${hint === void 0 ? "\"<provider>\"" : `"${hint}"`}, "<model id>")) from "@earendil-works/pi-ai/providers/all", or any Model object you built yourself.`);
+	return /* @__PURE__ */ new TypeError(`ai("${specifier}") is not a model this provider knows. Workers AI ids start with "@cf/", AI Gateway dynamic routes with "dynamic/". A third-party model comes from its own pi-ai registry: ai(getBuiltinModel(${hint === void 0 ? "\"<provider>\"" : `"${hint}"`}, "<model id>")) from "@earendil-works/pi-ai/providers/all", or any Model object you built yourself.`);
 }
 function buildModel(target, options) {
 	for (const leg of options?.fallback ?? []) {
-		if (typeof leg !== "string" || leg.startsWith("@cf/")) continue;
+		if (typeof leg !== "string" || isRunPathLanguageModelId(leg)) continue;
 		if (!leg.includes("/")) throw unroutableString(leg);
 		buildGatewayModel(leg, void 0);
 	}
 	if (typeof target !== "string") return withOptions(target, options);
-	if (target.startsWith("@cf/")) return buildWorkersAIModel(target, options);
+	if (isRunPathLanguageModelId(target)) return buildWorkersAIModel(target, options);
 	if (!target.includes("/")) throw unroutableString(target);
 	return buildGatewayModel(target, options);
 }