workers-ai-provider 4.0.0 → 4.0.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { C as createResumableStream, E as wireableProviders, S as WireFormat, T as findProviderBySlug, _ as GATEWAY_PROVIDERS, a as ProviderPlugin, b as ResumableStreamOptions, c as selectTransport, d as FallbackAttempt, f as GatewayErrorCode, g as Billing, h as WorkersAIGatewayError, i as ParsedSlug, l as FallbackLeg, m as WorkersAIFallbackError, n as DispatchInfo, o as Transport, p as GatewayErrorContext, r as FallbackOptions, s as parseSlug, t as DelegateCallOptions, u as createClientFallbackModel, v as GatewayDelegateError, w as detectProviderByUrl, x as ResumeExpiredPolicy, y as GatewayProviderInfo } from "./gateway-delegate-CAX7trdL.mjs";
+import { C as createResumableStream, E as wireableProviders, S as WireFormat, T as findProviderBySlug, _ as GATEWAY_PROVIDERS, a as ProviderPlugin, b as ResumableStreamOptions, c as selectTransport, d as FallbackAttempt, f as GatewayErrorCode, g as Billing, h as WorkersAIGatewayError, i as ParsedSlug, l as FallbackLeg, m as WorkersAIFallbackError, n as DispatchInfo, o as Transport, p as GatewayErrorContext, r as FallbackOptions, s as parseSlug, t as DelegateCallOptions, u as createClientFallbackModel, v as GatewayDelegateError, w as detectProviderByUrl, x as ResumeExpiredPolicy, y as GatewayProviderInfo } from "./gateway-delegate-DYjgGAa-.mjs";
 import { GatewayFetchConfig, createGatewayFetch, createGatewayProvider } from "./gateway-provider.mjs";
 import { EmbeddingModelV4, EmbeddingModelV4CallOptions, EmbeddingModelV4Result, ImageModelV4, LanguageModelV4, RerankingModelV4, SpeechModelV4, TranscriptionModelV4 } from "@ai-sdk/provider";
 
@@ -484,11 +484,40 @@ 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`.
  */
 declare function createWorkersAI(options: WorkersAISettings): WorkersAI;
+/**
+ * @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/
+ */
 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/
+ */
 interface AISearchProvider {
   (settings?: AISearchChatSettings): AISearchChatLanguageModel;
   /**
@@ -500,7 +529,11 @@ 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/
  */
 declare function createAISearch(options: AISearchSettings, /** @internal */
 
@@ -516,8 +549,9 @@ type AutoRAGSettings = AISearchSettings;
  */
 type AutoRAGProvider = AISearchProvider;
 /**
- * @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/
  */
 declare function createAutoRAG(options: AISearchSettings): AISearchProvider;
 //#endregion

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { C as GatewayDelegateError, S as headersToObject, _ as detectProviderByUrl, a as WORKERS_AI_ERROR_CODE_TO_STATUS, b as asText, c as parseWorkersAIErrorCode, d as isForcedToolChoice, f as normalizeMessagesForBinding$1, g as GATEWAY_PROVIDERS, h as createResumableStream, i as WorkersAIGatewayError, l as SSEDecoder, m as processText, n as createGatewayProvider, o as isAbortError, p as parseLeakedToolCalls$1, r as WorkersAIFallbackError, s as messageOf, t as createGatewayFetch, u as getToolNames, v as findProviderBySlug, w as _defineProperty, x as buildGatewayEntry, y as wireableProviders } from "./gateway-provider-BIZ2bimW.mjs";
+import { C as GatewayDelegateError, S as headersToObject, _ as detectProviderByUrl, a as WORKERS_AI_ERROR_CODE_TO_STATUS, b as asText, c as parseWorkersAIErrorCode, d as isForcedToolChoice, f as normalizeMessagesForBinding$1, g as GATEWAY_PROVIDERS, h as createResumableStream, i as WorkersAIGatewayError, l as SSEDecoder, m as processText, n as createGatewayProvider, o as isAbortError, p as parseLeakedToolCalls$1, r as WorkersAIFallbackError, s as messageOf, t as createGatewayFetch, u as getToolNames, v as findProviderBySlug, w as _defineProperty, x as buildGatewayEntry, y as wireableProviders } from "./gateway-provider-BQj8ZnKv.mjs";
 import { APICallError, TooManyEmbeddingValuesForCallError, UnsupportedFunctionalityError } from "@ai-sdk/provider";
 import { generateId } from "ai";
 //#region src/workersai-error.ts
@@ -1793,6 +1793,9 @@ var AutoRAGChatLanguageModel = class extends AISearchChatLanguageModel {};
 * 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/…"] })`.
 */
 function createClientFallbackModel(legs) {
 	if (legs.length === 0) throw new Error("createClientFallbackModel requires at least one model leg.");
@@ -2224,6 +2227,23 @@ const DEFAULT_GATEWAY_ID = "default";
 const DYNAMIC_ROUTE_WIRE_FORMAT = "openai";
 /**
 * 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`.
 */
 function createWorkersAI(options) {
 	if (!options.binding && !("accountId" in options && "apiKey" in options)) throw new Error("Invalid Workers AI configuration: you must provide either a binding (e.g. { binding: env.AI }) or credentials ({ accountId, apiKey }).");
@@ -2381,7 +2401,11 @@ A gateway defaults to "default" but can be set via \`gateway\`. Otherwise use a
 * 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/
 */
 function createAISearch(options, providerName = "aisearch.chat") {
 	const binding = options.binding;
@@ -2398,8 +2422,9 @@ function createAISearch(options, providerName = "aisearch.chat") {
 }
 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/
 */
 function createAutoRAG(options) {
 	if (!autoRAGWarned) {