workers-ai-provider 3.3.1 → 4.0.1

package/dist/openai.d.mts

@@ -1,4 +1,4 @@
-import { a as ProviderPlugin } from "./gateway-delegate-D_zkIp5r.mjs";
+import { a as ProviderPlugin } from "./gateway-delegate-DYjgGAa-.mjs";
 
 //#region src/openai.d.ts
 /**
@@ -11,8 +11,13 @@ import { a as ProviderPlugin } from "./gateway-delegate-D_zkIp5r.mjs";
  *
  * Requires `@ai-sdk/openai` (an optional peer dependency — install it yourself).
  *
- * Uses `.chat()` (Chat Completions) deliberately: AI SDK v6's bare `openai()`
- * defaults to the Responses API, which the AI Gateway run catalog does not serve.
+ * Uses `.chat()` (Chat Completions) deliberately: the bare `openai()` call
+ * (AI SDK v6+) defaults to the Responses API, which the AI Gateway run catalog
+ * does not serve.
+ *
+ * @deprecated Pass the vendor's own model to `createAI` from
+ * `agents/models/ai-sdk` instead of a plugin plus a slug:
+ * `ai(createOpenAI({ apiKey: "cloudflare" }).chat("gpt-5.4"))`.
  */
 declare const openai: ProviderPlugin;
 //#endregion

package/dist/openai.mjs

@@ -10,8 +10,13 @@ import { createOpenAI } from "@ai-sdk/openai";
 *
 * Requires `@ai-sdk/openai` (an optional peer dependency — install it yourself).
 *
-* Uses `.chat()` (Chat Completions) deliberately: AI SDK v6's bare `openai()`
-* defaults to the Responses API, which the AI Gateway run catalog does not serve.
+* Uses `.chat()` (Chat Completions) deliberately: the bare `openai()` call
+* (AI SDK v6+) defaults to the Responses API, which the AI Gateway run catalog
+* does not serve.
+*
+* @deprecated Pass the vendor's own model to `createAI` from
+* `agents/models/ai-sdk` instead of a plugin plus a slug:
+* `ai(createOpenAI({ apiKey: "cloudflare" }).chat("gpt-5.4"))`.
 */
 const openai = {
 	wireFormat: "openai",

package/dist/openai.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openai.mjs","names":[],"sources":["../src/openai.ts"],"sourcesContent":["import { createOpenAI } from \"@ai-sdk/openai\";\nimport type { ProviderPlugin } from \"./gateway-delegate\";\n\n/**\n * OpenAI-wire provider plugin for the gateway delegate. Pass to\n * `createGatewayDelegate({ providers: [openai] })` to handle every\n * OpenAI-compatible provider in one go — `openai/…`, plus the OpenAI-compatible\n * long tail (`deepseek/…`, `xai/…`, `groq/…`, `mistral/…`, `perplexity/…`,\n * `openrouter/…`, `cohere/…`, …). The registry routes each slug to its gateway\n * provider id; this plugin only supplies the response parser.\n *\n * Requires `@ai-sdk/openai` (an optional peer dependency — install it yourself).\n *\n * Uses `.chat()` (Chat Completions) deliberately: AI SDK v6's bare `openai()`\n * defaults to the Responses API, which the AI Gateway run catalog does not serve.\n */\nexport const openai: ProviderPlugin = {\n\twireFormat: \"openai\",\n\tcreate: ({ modelId, fetch, baseURL }) =>\n\t\t// apiKey is a placeholder — the gateway handles auth (unified billing / BYOK)\n\t\t// and the delegate strips the Authorization header on the gateway path.\n\t\t// baseURL (set by the registry for non-OpenAI openai-wire providers) makes\n\t\t// the generated URL host-strip to the right gateway-native endpoint.\n\t\tcreateOpenAI({ apiKey: \"unused\", fetch, ...(baseURL ? { baseURL } : {}) }).chat(modelId),\n};\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAa,SAAyB;CACrC,YAAY;CACZ,SAAS,EAAE,SAAS,OAAO,cAK1B,aAAa;EAAE,QAAQ;EAAU;EAAO,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;CAAG,CAAC,CAAC,CAAC,KAAK,OAAO;AACzF"}
+{"version":3,"file":"openai.mjs","names":[],"sources":["../src/openai.ts"],"sourcesContent":["import { createOpenAI } from \"@ai-sdk/openai\";\nimport type { ProviderPlugin } from \"./gateway-delegate\";\n\n/**\n * OpenAI-wire provider plugin for the gateway delegate. Pass to\n * `createGatewayDelegate({ providers: [openai] })` to handle every\n * OpenAI-compatible provider in one go — `openai/…`, plus the OpenAI-compatible\n * long tail (`deepseek/…`, `xai/…`, `groq/…`, `mistral/…`, `perplexity/…`,\n * `openrouter/…`, `cohere/…`, …). The registry routes each slug to its gateway\n * provider id; this plugin only supplies the response parser.\n *\n * Requires `@ai-sdk/openai` (an optional peer dependency — install it yourself).\n *\n * Uses `.chat()` (Chat Completions) deliberately: the bare `openai()` call\n * (AI SDK v6+) defaults to the Responses API, which the AI Gateway run catalog\n * does not serve.\n *\n * @deprecated Pass the vendor's own model to `createAI` from\n * `agents/models/ai-sdk` instead of a plugin plus a slug:\n * `ai(createOpenAI({ apiKey: \"cloudflare\" }).chat(\"gpt-5.4\"))`.\n */\nexport const openai: ProviderPlugin = {\n\twireFormat: \"openai\",\n\tcreate: ({ modelId, fetch, baseURL }) =>\n\t\t// apiKey is a placeholder — the gateway handles auth (unified billing / BYOK)\n\t\t// and the delegate strips the Authorization header on the gateway path.\n\t\t// baseURL (set by the registry for non-OpenAI openai-wire providers) makes\n\t\t// the generated URL host-strip to the right gateway-native endpoint.\n\t\tcreateOpenAI({ apiKey: \"unused\", fetch, ...(baseURL ? { baseURL } : {}) }).chat(modelId),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,SAAyB;CACrC,YAAY;CACZ,SAAS,EAAE,SAAS,OAAO,cAK1B,aAAa;EAAE,QAAQ;EAAU;EAAO,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;CAAG,CAAC,CAAC,CAAC,KAAK,OAAO;AACzF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workers-ai-provider",
-  "version": "3.3.1",
+  "version": "4.0.1",
   "description": "Workers AI Provider for the vercel AI SDK",
   "keywords": [
     "ai",
@@ -53,21 +53,21 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^3.0.84",
-    "@ai-sdk/google": "^3.0.0",
-    "@ai-sdk/openai": "^3.0.71",
-    "@ai-sdk/provider": "^3.0.10",
+    "@ai-sdk/anthropic": "^4.0.5",
+    "@ai-sdk/google": "^4.0.6",
+    "@ai-sdk/openai": "^4.0.5",
+    "@ai-sdk/provider": "^4.0.1",
     "@cloudflare/workers-types": "^4.20260628.1",
-    "ai": "^6.0.204",
+    "ai": "^7.0.11",
     "zod": "^4.4.3",
     "@cloudflare/gateway-core": "0.0.0"
   },
   "peerDependencies": {
-    "@ai-sdk/anthropic": "^3.0.0",
-    "@ai-sdk/google": "^3.0.0",
-    "@ai-sdk/openai": "^3.0.0",
-    "@ai-sdk/provider": "^3.0.0",
-    "ai": "^6.0.0"
+    "@ai-sdk/anthropic": "^4.0.0",
+    "@ai-sdk/google": "^4.0.0",
+    "@ai-sdk/openai": "^4.0.0",
+    "@ai-sdk/provider": "^4.0.0",
+    "ai": "^7.0.0"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/anthropic": {

package/src/aisearch-chat-language-model.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV3, SharedV3Warning } from "@ai-sdk/provider";
+import type { LanguageModelV4, SharedV4Warning } from "@ai-sdk/provider";
 
 import type { AISearchChatSettings } from "./aisearch-chat-settings";
 import { convertToWorkersAIChatMessages } from "./convert-to-workersai-chat-messages";
@@ -13,8 +13,8 @@ type AISearchChatConfig = {
 	gateway?: GatewayOptions;
 };
 
-export class AISearchChatLanguageModel implements LanguageModelV3 {
-	readonly specificationVersion = "v3";
+export class AISearchChatLanguageModel implements LanguageModelV4 {
+	readonly specificationVersion = "v4";
 	readonly defaultObjectGenerationMode = "json";
 
 	readonly supportedUrls: Record<string, RegExp[]> | PromiseLike<Record<string, RegExp[]>> = {};
@@ -43,8 +43,8 @@ export class AISearchChatLanguageModel implements LanguageModelV3 {
 		frequencyPenalty,
 		presencePenalty,
 		responseFormat,
-	}: Parameters<LanguageModelV3["doGenerate"]>[0]): SharedV3Warning[] {
-		const warnings: SharedV3Warning[] = [];
+	}: Parameters<LanguageModelV4["doGenerate"]>[0]): SharedV4Warning[] {
+		const warnings: SharedV4Warning[] = [];
 
 		if (tools != null && tools.length > 0) {
 			console.warn(
@@ -72,14 +72,14 @@ export class AISearchChatLanguageModel implements LanguageModelV3 {
 	 * Build the search query from messages.
 	 * Flattens the conversation into a single string for aiSearch.
 	 */
-	private buildQuery(prompt: Parameters<LanguageModelV3["doGenerate"]>[0]["prompt"]): string {
+	private buildQuery(prompt: Parameters<LanguageModelV4["doGenerate"]>[0]["prompt"]): string {
 		const { messages } = convertToWorkersAIChatMessages(prompt);
 		return messages.map(({ content, role }) => `${role}: ${content}`).join("\n\n");
 	}
 
 	async doGenerate(
-		options: Parameters<LanguageModelV3["doGenerate"]>[0],
-	): Promise<Awaited<ReturnType<LanguageModelV3["doGenerate"]>>> {
+		options: Parameters<LanguageModelV4["doGenerate"]>[0],
+	): Promise<Awaited<ReturnType<LanguageModelV4["doGenerate"]>>> {
 		const warnings = this.getWarnings(options);
 		const query = this.buildQuery(options.prompt);
 
@@ -109,8 +109,8 @@ export class AISearchChatLanguageModel implements LanguageModelV3 {
 	}
 
 	async doStream(
-		options: Parameters<LanguageModelV3["doStream"]>[0],
-	): Promise<Awaited<ReturnType<LanguageModelV3["doStream"]>>> {
+		options: Parameters<LanguageModelV4["doStream"]>[0],
+	): Promise<Awaited<ReturnType<LanguageModelV4["doStream"]>>> {
 		const warnings = this.getWarnings(options);
 		const query = this.buildQuery(options.prompt);
 

package/src/anthropic.ts

@@ -7,6 +7,10 @@ import type { ProviderPlugin } from "./gateway-delegate";
  * `"anthropic/<model>"` slugs.
  *
  * Requires `@ai-sdk/anthropic` (an optional peer dependency — install it yourself).
+ *
+ * @deprecated Pass the vendor's own model to `createAI` from
+ * `agents/models/ai-sdk` instead of a plugin plus a slug:
+ * `ai(createAnthropic({ apiKey: "cloudflare" })("claude-opus-4-8"))`.
  */
 export const anthropic: ProviderPlugin = {
 	wireFormat: "anthropic",

package/src/client-fallback.ts

@@ -1,8 +1,8 @@
 import type {
-	LanguageModelV3,
-	LanguageModelV3CallOptions,
-	LanguageModelV3GenerateResult,
-	LanguageModelV3StreamResult,
+	LanguageModelV4,
+	LanguageModelV4CallOptions,
+	LanguageModelV4GenerateResult,
+	LanguageModelV4StreamResult,
 } from "@ai-sdk/provider";
 import { type FallbackAttempt, WorkersAIFallbackError, WorkersAIGatewayError } from "./errors";
 import type { Transport } from "./gateway-delegate";
@@ -12,7 +12,7 @@ export interface FallbackLeg {
 	/** The model slug this leg dispatches. */
 	slug: string;
 	/** The built AI SDK model. */
-	model: LanguageModelV3;
+	model: LanguageModelV4;
 	/** Transport the leg uses. */
 	transport: Transport;
 }
@@ -25,14 +25,17 @@ export interface FallbackLeg {
  * Fallback triggers on `doGenerate`/`doStream` rejection (the dispatch never
  * produced a stream). Errors that surface *mid-stream* — after content has
  * already been emitted — are not recoverable here and propagate as-is.
+ *
+ * @deprecated Use the `fallback` option of `createAI` from
+ * `agents/models/ai-sdk`: `ai(primary, { fallback: [secondary, "@cf/…"] })`.
  */
-export function createClientFallbackModel(legs: FallbackLeg[]): LanguageModelV3 {
+export function createClientFallbackModel(legs: FallbackLeg[]): LanguageModelV4 {
 	if (legs.length === 0) {
 		throw new Error("createClientFallbackModel requires at least one model leg.");
 	}
 	const primary = legs[0].model;
 
-	async function attempt<T>(run: (model: LanguageModelV3) => PromiseLike<T>): Promise<T> {
+	async function attempt<T>(run: (model: LanguageModelV4) => PromiseLike<T>): Promise<T> {
 		const attempts: FallbackAttempt[] = [];
 		for (const leg of legs) {
 			try {
@@ -54,16 +57,16 @@ export function createClientFallbackModel(legs: FallbackLeg[]): LanguageModelV3
 	}
 
 	return {
-		specificationVersion: "v3",
+		specificationVersion: "v4",
 		provider: primary.provider,
 		modelId: primary.modelId,
 		supportedUrls: primary.supportedUrls,
 		doGenerate(
-			options: LanguageModelV3CallOptions,
-		): PromiseLike<LanguageModelV3GenerateResult> {
+			options: LanguageModelV4CallOptions,
+		): PromiseLike<LanguageModelV4GenerateResult> {
 			return attempt((m) => m.doGenerate(options));
 		},
-		doStream(options: LanguageModelV3CallOptions): PromiseLike<LanguageModelV3StreamResult> {
+		doStream(options: LanguageModelV4CallOptions): PromiseLike<LanguageModelV4StreamResult> {
 			return attempt((m) => m.doStream(options));
 		},
 	};

package/src/convert-to-workersai-chat-messages.ts

@@ -1,45 +1,72 @@
-import type { LanguageModelV3DataContent, LanguageModelV3Prompt } from "@ai-sdk/provider";
+import type { LanguageModelV4Prompt, SharedV4FileData } from "@ai-sdk/provider";
 import { UnsupportedFunctionalityError } from "@ai-sdk/provider";
 import { toWorkersAIToolCallId } from "./utils";
 import type { WorkersAIContentPart, WorkersAIChatPrompt } from "./workersai-chat-prompt";
 
 /**
- * Normalise any LanguageModelV3DataContent value to a Uint8Array.
+ * Normalise a tagged `SharedV4FileData` value to a Uint8Array.
  *
  * Handles:
- *   - Uint8Array  → returned as-is
- *   - string      → decoded from base64 (with or without data-URL prefix)
- *   - URL         → not supported (Workers AI needs raw bytes, not a reference)
+ *   - { type: 'data' }      → Uint8Array returned as-is; string decoded from
+ *                             base64 (with or without data-URL prefix)
+ *   - { type: 'url' }       → not supported (Workers AI needs raw bytes, not a reference)
+ *   - { type: 'reference' } → not supported (Workers AI has no file store to resolve it)
+ *   - { type: 'text' }      → not supported for image parts
  */
-function toUint8Array(data: LanguageModelV3DataContent): Uint8Array | null {
-	if (data instanceof Uint8Array) {
-		return data;
-	}
-
-	if (typeof data === "string") {
-		let base64 = data;
-		if (base64.startsWith("data:")) {
-			const commaIndex = base64.indexOf(",");
-			if (commaIndex >= 0) {
-				base64 = base64.slice(commaIndex + 1);
+function toUint8Array(fileData: SharedV4FileData): Uint8Array | null {
+	switch (fileData.type) {
+		case "data": {
+			const data = fileData.data;
+			if (data instanceof Uint8Array) {
+				return data;
+			}
+			let base64 = data;
+			if (base64.startsWith("data:")) {
+				const commaIndex = base64.indexOf(",");
+				if (commaIndex >= 0) {
+					base64 = base64.slice(commaIndex + 1);
+				}
+			}
+			const binaryString = atob(base64);
+			const bytes = new Uint8Array(binaryString.length);
+			for (let i = 0; i < binaryString.length; i++) {
+				bytes[i] = binaryString.charCodeAt(i);
 			}
+			return bytes;
 		}
-		const binaryString = atob(base64);
-		const bytes = new Uint8Array(binaryString.length);
-		for (let i = 0; i < binaryString.length; i++) {
-			bytes[i] = binaryString.charCodeAt(i);
+
+		case "url": {
+			throw new Error(
+				"URL image sources are not supported by Workers AI. " +
+					"Provide image data as a Uint8Array or base64 string instead.",
+			);
 		}
-		return bytes;
-	}
 
-	if (data instanceof URL) {
-		throw new Error(
-			"URL image sources are not supported by Workers AI. " +
-				"Provide image data as a Uint8Array or base64 string instead.",
-		);
-	}
+		case "reference": {
+			throw new UnsupportedFunctionalityError({
+				functionality: "file-part-provider-reference",
+				message:
+					"Provider file references are not supported by Workers AI. " +
+					"Provide image data as a Uint8Array or base64 string instead.",
+			});
+		}
 
-	return null;
+		case "text": {
+			throw new UnsupportedFunctionalityError({
+				functionality: "file-part-inline-text",
+				message:
+					"Inline text file parts are not supported by Workers AI chat. " +
+					"Pass text as a regular text part instead.",
+			});
+		}
+
+		default: {
+			const exhaustiveCheck = fileData satisfies never;
+			throw new Error(
+				`Unsupported file data type: ${(exhaustiveCheck as { type: string }).type}`,
+			);
+		}
+	}
 }
 
 function assertImageMediaType(mediaType: string | undefined): string {
@@ -76,7 +103,7 @@ function uint8ArrayToBase64(bytes: Uint8Array): string {
 	return btoa(binary);
 }
 
-export function convertToWorkersAIChatMessages(prompt: LanguageModelV3Prompt): {
+export function convertToWorkersAIChatMessages(prompt: LanguageModelV4Prompt): {
 	messages: WorkersAIChatPrompt;
 } {
 	const messages: WorkersAIChatPrompt = [];
@@ -164,6 +191,18 @@ export function convertToWorkersAIChatMessages(prompt: LanguageModelV3Prompt): {
 							break;
 						}
 
+						case "reasoning-file": {
+							// Files inside reasoning traces (new in spec v4) cannot be
+							// replayed to Workers AI - no action needed
+							break;
+						}
+
+						case "custom": {
+							// Provider-specific custom parts (new in spec v4) from other
+							// providers are not replayable to Workers AI - no action needed
+							break;
+						}
+
 						case "tool-call": {
 							toolCalls.push({
 								function: {

package/src/gateway-delegate.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV3, LanguageModelV3CallOptions } from "@ai-sdk/provider";
+import type { LanguageModelV4, LanguageModelV4CallOptions } from "@ai-sdk/provider";
 import {
 	asText,
 	buildGatewayEntry,
@@ -154,7 +154,7 @@ export interface ProviderPlugin {
 		modelId: string;
 		fetch: typeof globalThis.fetch;
 		baseURL?: string;
-	}): LanguageModelV3;
+	}): LanguageModelV4;
 }
 
 // ---------------------------------------------------------------------------
@@ -401,7 +401,7 @@ export interface GatewayDelegateConfig {
 }
 
 export interface GatewayDelegate {
-	(slug: string, options?: DelegateCallOptions): LanguageModelV3;
+	(slug: string, options?: DelegateCallOptions): LanguageModelV4;
 }
 
 /**
@@ -431,7 +431,7 @@ export function createGatewayDelegate(config: GatewayDelegateConfig): GatewayDel
 	const buildOne = (
 		slug: string,
 		options: DelegateCallOptions,
-	): { model: LanguageModelV3; transport: Transport } => {
+	): { model: LanguageModelV4; transport: Transport } => {
 		const parsed = parseSlug(slug);
 		const info = resolveProvider(slug, parsed);
 
@@ -816,7 +816,7 @@ function makeServerFallbackModel(params: {
 	opts: DelegateCallOptions;
 	selection: Selection;
 	callOptions: DelegateCallOptions;
-}): LanguageModelV3 {
+}): LanguageModelV4 {
 	const { binding, gatewayId, gatewayOptions, legs, opts, selection, callOptions } = params;
 	const first = legs[0]!;
 
@@ -834,7 +834,7 @@ function makeServerFallbackModel(params: {
 
 	const dispatch = async (
 		method: "doGenerate" | "doStream",
-		options: LanguageModelV3CallOptions,
+		options: LanguageModelV4CallOptions,
 	): Promise<unknown> => {
 		// 1) Capture each leg's native request without hitting the network.
 		const entries: GatewayEntry[] = [];
@@ -854,7 +854,7 @@ function makeServerFallbackModel(params: {
 				...(leg.info.baseURL ? { baseURL: leg.info.baseURL } : {}),
 			});
 			try {
-				await (model[method] as (o: LanguageModelV3CallOptions) => Promise<unknown>)(
+				await (model[method] as (o: LanguageModelV4CallOptions) => Promise<unknown>)(
 					options,
 				);
 			} catch (e) {
@@ -905,21 +905,21 @@ function makeServerFallbackModel(params: {
 			fetch: (async () => resp) as typeof globalThis.fetch,
 			...(winner.info.baseURL ? { baseURL: winner.info.baseURL } : {}),
 		});
-		return (winnerModel[method] as (o: LanguageModelV3CallOptions) => Promise<unknown>)(
+		return (winnerModel[method] as (o: LanguageModelV4CallOptions) => Promise<unknown>)(
 			options,
 		);
 	};
 
 	return {
-		specificationVersion: "v3",
+		specificationVersion: "v4",
 		provider: refModel.provider,
 		modelId: refModel.modelId,
 		supportedUrls: refModel.supportedUrls,
 		doGenerate(options) {
-			return dispatch("doGenerate", options) as ReturnType<LanguageModelV3["doGenerate"]>;
+			return dispatch("doGenerate", options) as ReturnType<LanguageModelV4["doGenerate"]>;
 		},
 		doStream(options) {
-			return dispatch("doStream", options) as ReturnType<LanguageModelV3["doStream"]>;
+			return dispatch("doStream", options) as ReturnType<LanguageModelV4["doStream"]>;
 		},
-	} as LanguageModelV3;
+	} as LanguageModelV4;
 }

package/src/gateway-provider.ts

@@ -56,6 +56,12 @@ interface AiGatewayRunner {
  * A `fetch` that dispatches the wrapped provider's request through AI Gateway.
  * Detects the gateway provider id from the request URL (or uses `config.provider`),
  * strips the provider host to the endpoint path, and forwards the body verbatim.
+ *
+ * @deprecated Route the vendor's model with `createAI` from
+ * `agents/models/ai-sdk`: `ai(model)` for language models, `ai.routed(model)`
+ * for embedding, image, speech and transcription models, on AI Gateway's
+ * provider-native path. `vendorKey: "request"` forwards the vendor key, as
+ * `byok: true` does here.
  */
 export function createGatewayFetch(config: GatewayFetchConfig): typeof globalThis.fetch {
 	if (!config?.binding) {
@@ -130,6 +136,12 @@ export function createGatewayFetch(config: GatewayFetchConfig): typeof globalThi
  * });
  * const model = openai("gpt-5");
  * ```
+ *
+ * @deprecated Route the vendor's model with `createAI` from
+ * `agents/models/ai-sdk`: `ai(model)` for language models, `ai.routed(model)`
+ * for embedding, image, speech and transcription models, on AI Gateway's
+ * provider-native path. `vendorKey: "request"` forwards the vendor key, as
+ * `byok: true` does here.
  */
 export function createGatewayProvider<T>(
 	factory: (opts: { apiKey?: string; baseURL?: string; fetch: typeof globalThis.fetch }) => T,

package/src/google.ts

@@ -1,4 +1,4 @@
-import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createGoogle } from "@ai-sdk/google";
 import type { ProviderPlugin } from "./gateway-delegate";
 
 /**
@@ -7,13 +7,15 @@ import type { ProviderPlugin } from "./gateway-delegate";
  * (Google AI Studio) and `"google-vertex/<model>"` slugs.
  *
  * Requires `@ai-sdk/google` (an optional peer dependency — install it yourself).
+ *
+ * @deprecated Pass the vendor's own model to `createAI` from
+ * `agents/models/ai-sdk` instead of a plugin plus a slug:
+ * `ai(createGoogle({ apiKey: "cloudflare" })("gemini-2.5-flash"))`.
  */
 export const google: ProviderPlugin = {
 	wireFormat: "google",
 	create: ({ modelId, fetch, baseURL }) =>
 		// apiKey is a placeholder — the gateway handles auth (unified billing / BYOK)
 		// and the delegate strips the x-goog-api-key header on the gateway path.
-		createGoogleGenerativeAI({ apiKey: "unused", fetch, ...(baseURL ? { baseURL } : {}) })(
-			modelId,
-		),
+		createGoogle({ apiKey: "unused", fetch, ...(baseURL ? { baseURL } : {}) })(modelId),
 };

package/src/index.ts

@@ -276,6 +276,23 @@ export interface WorkersAI {
 
 /**
  * Create a Workers AI provider instance.
+ *
+ * @deprecated Use `createAI` from `agents/models/ai-sdk`, with the binding or
+ * with an account id and API token (credentials mode's `apiKey`):
+ *
+ * ```ts
+ * import { createAI } from "agents/models/ai-sdk";
+ * const ai = createAI({ binding: env.AI }); // or { accountId, apiToken }
+ * ai("@cf/zai-org/glm-4.7-flash"); // was workersai("@cf/…")
+ * ai("anthropic/claude-opus-4.8"); // was "anthropic/…" + providers; the catalog's spelling
+ * ai("dynamic/support"); // dynamic routes, as before
+ * ai(createAnthropic({ apiKey: "cloudflare" })("claude-opus-4-8")); // a vendor's own model
+ * ai.embedding("@cf/baai/bge-base-en-v1.5"); // .image/.speech/.transcription/.reranking alike
+ * ```
+ *
+ * `vendorKey`, `byokAlias` and `zdr` cover BYOK, and through the binding a
+ * catalog stream resumes after a dropped connection. For AI Search, use
+ * `ai-search-provider`.
  */
 export function createWorkersAI(options: WorkersAISettings): WorkersAI {
 	if (!options.binding && !("accountId" in options && "apiKey" in options)) {
@@ -508,7 +525,7 @@ export function createWorkersAI(options: WorkersAISettings): WorkersAI {
 					"catalog",
 				);
 			}
-			// The delegate returns a `LanguageModelV3` built by the configured plugin.
+			// The delegate returns a `LanguageModelV4` built by the configured plugin.
 			// It's structurally compatible with the AI SDK consumers this provider is
 			// used with; the cast keeps the public return type unchanged.
 			return getDelegate(modelId)(
@@ -600,10 +617,22 @@ export function createWorkersAI(options: WorkersAISettings): WorkersAI {
 // AI Search (formerly AutoRAG)
 // ---------------------------------------------------------------------------
 
+/**
+ * @deprecated Use `createAISearchNamespace` from `ai-search-provider`, over the
+ * `ai_search_namespaces` binding that replaces `env.AI.autorag()`:
+ * `createAISearchNamespace({ binding: env.AI_SEARCH }).get("my-instance").chat()`.
+ * @see https://developers.cloudflare.com/ai-search/api/migration/workers-binding/
+ */
 export type AISearchSettings = {
 	binding: AutoRAG;
 };
 
+/**
+ * @deprecated Use `createAISearchNamespace` from `ai-search-provider`, over the
+ * `ai_search_namespaces` binding that replaces `env.AI.autorag()`:
+ * `createAISearchNamespace({ binding: env.AI_SEARCH }).get("my-instance").chat()`.
+ * @see https://developers.cloudflare.com/ai-search/api/migration/workers-binding/
+ */
 export interface AISearchProvider {
 	(settings?: AISearchChatSettings): AISearchChatLanguageModel;
 	/**
@@ -616,7 +645,11 @@ export interface AISearchProvider {
  * Create an AI Search provider instance.
  *
  * AI Search (formerly AutoRAG) is Cloudflare's managed search service.
- * @see https://developers.cloudflare.com/ai-search/
+ *
+ * @deprecated Use `createAISearchNamespace` from `ai-search-provider`, over the
+ * `ai_search_namespaces` binding that replaces `env.AI.autorag()`:
+ * `createAISearchNamespace({ binding: env.AI_SEARCH }).get("my-instance").chat()`.
+ * @see https://developers.cloudflare.com/ai-search/api/migration/workers-binding/
  */
 export function createAISearch(
 	options: AISearchSettings,
@@ -662,8 +695,9 @@ export type AutoRAGProvider = AISearchProvider;
 let autoRAGWarned = false;
 
 /**
- * @deprecated Use `createAISearch` instead. AutoRAG has been renamed to AI Search.
- * @see https://developers.cloudflare.com/ai-search/
+ * @deprecated Use `createAISearchNamespace` from `ai-search-provider`. AutoRAG
+ * has been renamed to AI Search.
+ * @see https://developers.cloudflare.com/ai-search/api/migration/workers-binding/
  */
 export function createAutoRAG(options: AISearchSettings): AISearchProvider {
 	if (!autoRAGWarned) {

package/src/map-workersai-finish-reason.ts

@@ -1,4 +1,4 @@
-import type { LanguageModelV3FinishReason } from "@ai-sdk/provider";
+import type { LanguageModelV4FinishReason } from "@ai-sdk/provider";
 
 /**
  * Map a Workers AI finish reason to the AI SDK unified finish reason.
@@ -9,7 +9,7 @@ import type { LanguageModelV3FinishReason } from "@ai-sdk/provider";
  */
 export function mapWorkersAIFinishReason(
 	finishReasonOrResponse: string | null | undefined | Record<string, unknown>,
-): LanguageModelV3FinishReason {
+): LanguageModelV4FinishReason {
 	let finishReason: string | null | undefined;
 
 	if (

package/src/map-workersai-usage.ts

@@ -1,7 +1,7 @@
-import type { LanguageModelV3Usage } from "@ai-sdk/provider";
+import type { LanguageModelV4Usage } from "@ai-sdk/provider";
 
 /**
- * Map Workers AI usage data to the AI SDK V3 usage format.
+ * Map Workers AI usage data to the AI SDK v4 usage format.
  * Accepts any object that may have a `usage` property with token counts.
  *
  * Workers AI mirrors the OpenAI usage shape, including
@@ -11,7 +11,7 @@ import type { LanguageModelV3Usage } from "@ai-sdk/provider";
  */
 export function mapWorkersAIUsage(
 	output: Record<string, unknown> | AiTextGenerationOutput | AiTextToImageOutput,
-): LanguageModelV3Usage {
+): LanguageModelV4Usage {
 	const usage = (
 		output as {
 			usage?: {
@@ -30,7 +30,7 @@ export function mapWorkersAIUsage(
 	const cachedTokens = usage.prompt_tokens_details?.cached_tokens;
 
 	// Clamp at 0 in case the provider ever reports cached_tokens > prompt_tokens;
-	// the v3 spec expects non-negative counts.
+	// the v4 spec expects non-negative counts.
 	const noCache =
 		cachedTokens !== undefined ? Math.max(0, promptTokens - cachedTokens) : undefined;
 

package/src/openai.ts

@@ -11,8 +11,13 @@ import type { ProviderPlugin } from "./gateway-delegate";
  *
  * Requires `@ai-sdk/openai` (an optional peer dependency — install it yourself).
  *
- * Uses `.chat()` (Chat Completions) deliberately: AI SDK v6's bare `openai()`
- * defaults to the Responses API, which the AI Gateway run catalog does not serve.
+ * Uses `.chat()` (Chat Completions) deliberately: the bare `openai()` call
+ * (AI SDK v6+) defaults to the Responses API, which the AI Gateway run catalog
+ * does not serve.
+ *
+ * @deprecated Pass the vendor's own model to `createAI` from
+ * `agents/models/ai-sdk` instead of a plugin plus a slug:
+ * `ai(createOpenAI({ apiKey: "cloudflare" }).chat("gpt-5.4"))`.
  */
 export const openai: ProviderPlugin = {
 	wireFormat: "openai",