@cloudflare/tanstack-ai 0.0.0 → 0.1.1

package/dist/_tsup-dts-rollup.d.cts

@@ -0,0 +1,820 @@
+import type { AiModels as AiModels_2 } from '@cloudflare/workers-types';
+import { ANTHROPIC_MODELS } from '@tanstack/ai-anthropic';
+import { AnthropicChatModel } from '@tanstack/ai-anthropic';
+import { AnthropicSummarizeAdapter } from '@tanstack/ai-anthropic';
+import type { AnyTextAdapter } from '@tanstack/ai';
+import type { BaseAiTextEmbeddings as BaseAiTextEmbeddings_2 } from '@cloudflare/workers-types';
+import type { BaseAiTextGeneration as BaseAiTextGeneration_2 } from '@cloudflare/workers-types';
+import type { BaseAiTextToImage as BaseAiTextToImage_2 } from '@cloudflare/workers-types';
+import { BaseImageAdapter } from '@tanstack/ai/adapters';
+import { BaseSummarizeAdapter } from '@tanstack/ai/adapters';
+import { BaseTextAdapter } from '@tanstack/ai/adapters';
+import { BaseTranscriptionAdapter } from '@tanstack/ai/adapters';
+import { BaseTTSAdapter } from '@tanstack/ai/adapters';
+import { GeminiImageAdapter } from '@tanstack/ai-gemini';
+import { GeminiImageModel } from '@tanstack/ai-gemini';
+import { GeminiImageModels } from '@tanstack/ai-gemini';
+import { GeminiSummarizeAdapter } from '@tanstack/ai-gemini';
+import { GeminiSummarizeModel } from '@tanstack/ai-gemini';
+import { GeminiSummarizeModels } from '@tanstack/ai-gemini';
+import { GeminiTextModel } from '@tanstack/ai-gemini';
+import { GeminiTextModels } from '@tanstack/ai-gemini';
+import { GeminiTTSAdapter } from '@tanstack/ai-gemini';
+import { GeminiTTSModels } from '@tanstack/ai-gemini';
+import { GROK_CHAT_MODELS } from '@tanstack/ai-grok';
+import { GROK_IMAGE_MODELS } from '@tanstack/ai-grok';
+import { GrokChatModel } from '@tanstack/ai-grok';
+import { GrokImageAdapter } from '@tanstack/ai-grok';
+import { GrokImageModel } from '@tanstack/ai-grok';
+import { GrokSummarizeAdapter } from '@tanstack/ai-grok';
+import { GrokSummarizeModel } from '@tanstack/ai-grok';
+import { GrokTextAdapter } from '@tanstack/ai-grok';
+import type { ImageGenerationOptions } from '@tanstack/ai';
+import type { ImageGenerationResult } from '@tanstack/ai';
+import { OPENAI_CHAT_MODELS } from '@tanstack/ai-openai';
+import { OPENAI_IMAGE_MODELS } from '@tanstack/ai-openai';
+import { OPENAI_TRANSCRIPTION_MODELS } from '@tanstack/ai-openai';
+import { OPENAI_TTS_MODELS } from '@tanstack/ai-openai';
+import { OPENAI_VIDEO_MODELS } from '@tanstack/ai-openai';
+import { OpenAIChatModel } from '@tanstack/ai-openai';
+import { OpenAIImageAdapter } from '@tanstack/ai-openai';
+import { OpenAIImageModel } from '@tanstack/ai-openai';
+import { OpenAISummarizeAdapter } from '@tanstack/ai-openai';
+import { OpenAITextAdapter } from '@tanstack/ai-openai';
+import { OpenAITranscriptionAdapter } from '@tanstack/ai-openai';
+import { OpenAITranscriptionModel } from '@tanstack/ai-openai';
+import { OpenAITTSAdapter } from '@tanstack/ai-openai';
+import { OpenAITTSModel } from '@tanstack/ai-openai';
+import { OpenAIVideoAdapter } from '@tanstack/ai-openai';
+import { OpenAIVideoModel } from '@tanstack/ai-openai';
+import { OpenRouterImageAdapter } from '@tanstack/ai-openrouter';
+import { OpenRouterSummarizeAdapter } from '@tanstack/ai-openrouter';
+import type { StreamChunk } from '@tanstack/ai';
+import { StructuredOutputOptions } from '@tanstack/ai/adapters';
+import { StructuredOutputResult } from '@tanstack/ai/adapters';
+import type { SummarizationOptions } from '@tanstack/ai';
+import type { SummarizationResult } from '@tanstack/ai';
+import type { TextOptions } from '@tanstack/ai';
+import type { TranscriptionOptions } from '@tanstack/ai';
+import type { TranscriptionResult } from '@tanstack/ai';
+import type { TTSOptions } from '@tanstack/ai';
+import type { TTSResult } from '@tanstack/ai';
+
+declare type AiGatewayAdapterConfig = (AiGatewayBindingConfig | AiGatewayCredentialsConfig) & AiGatewayConfig;
+export { AiGatewayAdapterConfig }
+export { AiGatewayAdapterConfig as AiGatewayAdapterConfig_alias_1 }
+
+export declare interface AiGatewayBindingConfig {
+    /**
+     * The AI Gateway binding
+     * @example
+     * env.AI.gateway('my-gateway-id')
+     */
+    binding: CloudflareAiGateway;
+    /**
+     * The Provider API Key if you want to manually pass it, ignore if using Unified Billing or BYOK.
+     */
+    apiKey?: string;
+}
+
+export declare interface AiGatewayConfig {
+    skipCache?: boolean;
+    cacheTtl?: number;
+    customCacheKey?: string;
+    metadata?: Record<string, unknown>;
+}
+
+export declare interface AiGatewayCredentialsConfig {
+    /**
+     * The Cloudflare account ID
+     */
+    accountId: string;
+    /**
+     * The AI Gateway ID
+     */
+    gatewayId: string;
+    /**
+     * The Provider API Key if you want to manually pass it, ignore if using Unified Billing or BYOK.
+     */
+    apiKey?: string;
+    /**
+     * The Cloudflare AI Gateway API Key, required if your Gateway is authenticated.
+     */
+    cfApiKey?: string;
+}
+
+export { ANTHROPIC_MODELS }
+export { ANTHROPIC_MODELS as ANTHROPIC_MODELS_alias_1 }
+
+export { AnthropicChatModel }
+export { AnthropicChatModel as AnthropicChatModel_alias_1 }
+
+declare type AnthropicGatewayConfig = AiGatewayAdapterConfig & {
+    anthropicVersion?: string;
+};
+export { AnthropicGatewayConfig }
+export { AnthropicGatewayConfig as AnthropicGatewayConfig_alias_1 }
+
+/**
+ * Normalise a Workers AI binary response to a base64 string.
+ *
+ * Handles:
+ * - `Uint8Array` / `ArrayBuffer` — raw bytes
+ * - `ReadableStream<Uint8Array>` — streamed bytes
+ * - `{ [binaryKey]: "base64..." }` — JSON wrapper (e.g. `{ image: "..." }`)
+ *
+ * @param result  The raw value returned from Workers AI
+ * @param binaryKey  The JSON field to look for when the result is an object
+ *                   (defaults to `"image"`; pass `"audio"` for TTS responses)
+ */
+export declare function binaryToBase64(result: unknown, binaryKey?: string): Promise<string>;
+
+export declare interface CloudflareAiGateway {
+    run(request: unknown): Promise<Response>;
+}
+
+/**
+ * Collect all chunks from a ReadableStream<Uint8Array> into a single Uint8Array.
+ */
+export declare function collectStream(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
+
+/**
+ * Creates an Anthropic chat adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ *
+ * Since AnthropicTextConfig extends the Anthropic SDK's ClientOptions,
+ * we can inject the gateway fetch directly — no subclassing needed.
+ */
+declare function createAnthropicChat(model: AnthropicChatModel, config: AnthropicGatewayConfig): AnyTextAdapter;
+export { createAnthropicChat }
+export { createAnthropicChat as createAnthropicChat_alias_1 }
+
+/**
+ * Creates an Anthropic summarize adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ */
+declare function createAnthropicSummarize(model: AnthropicChatModel, config: AnthropicGatewayConfig): AnthropicSummarizeAdapter<"claude-opus-4-6" | "claude-opus-4-5" | "claude-sonnet-4-5" | "claude-haiku-4-5" | "claude-opus-4-1" | "claude-sonnet-4" | "claude-3-7-sonnet" | "claude-opus-4" | "claude-3-5-haiku" | "claude-3-haiku">;
+export { createAnthropicSummarize }
+export { createAnthropicSummarize as createAnthropicSummarize_alias_1 }
+
+export declare function createGatewayFetch(provider: string, config: AiGatewayAdapterConfig, headers?: Record<string, string>): typeof fetch;
+
+/**
+ * Creates a Gemini adapter which uses Cloudflare AI Gateway.
+ * Does not support the AI binding (Google GenAI SDK lacks custom fetch support).
+ * See {@link https://github.com/googleapis/js-genai/issues/999 | googleapis/js-genai#999}.
+ * @param model The Gemini model to use
+ * @param config Configuration options (credentials only)
+ */
+declare function createGeminiChat(model: GeminiChatModel, config: GeminiGatewayConfig): AnyTextAdapter;
+export { createGeminiChat }
+export { createGeminiChat as createGeminiChat_alias_1 }
+
+/**
+ * Creates a Gemini Image adapter which uses Cloudflare AI Gateway.
+ * Does not support the AI binding (Google GenAI SDK lacks custom fetch support).
+ * See {@link https://github.com/googleapis/js-genai/issues/999 | googleapis/js-genai#999}.
+ * @param model The Gemini model to use
+ * @param config Configuration options (credentials only)
+ */
+declare function createGeminiImage(model: GeminiImageModel, config: GeminiGatewayConfig): GeminiImageAdapter<"gemini-3-pro-image-preview" | "gemini-2.5-flash-image" | "gemini-2.0-flash-preview-image-generation" | "imagen-3.0-generate-002" | "imagen-4.0-generate-001" | "imagen-4.0-fast-generate-001" | "imagen-4.0-ultra-generate-001">;
+export { createGeminiImage }
+export { createGeminiImage as createGeminiImage_alias_1 }
+
+/**
+ * Creates a Gemini Summarize adapter which uses Cloudflare AI Gateway.
+ * Does not support the AI binding (Google GenAI SDK lacks custom fetch support).
+ * See {@link https://github.com/googleapis/js-genai/issues/999 | googleapis/js-genai#999}.
+ * @param model The Gemini model to use
+ * @param config Configuration options (credentials only)
+ */
+declare function createGeminiSummarize(model: GeminiSummarizeModel, config: GeminiGatewayConfig): GeminiSummarizeAdapter<"gemini-2.0-flash" | "gemini-2.0-flash-lite" | "gemini-1.5-flash" | "gemini-1.5-pro">;
+export { createGeminiSummarize }
+export { createGeminiSummarize as createGeminiSummarize_alias_1 }
+
+/**
+ * Creates a Gemini TTS adapter which uses Cloudflare AI Gateway.
+ * Does not support the AI binding (Google GenAI SDK lacks custom fetch support).
+ * See {@link https://github.com/googleapis/js-genai/issues/999 | googleapis/js-genai#999}.
+ *
+ * @experimental Gemini TTS is an experimental feature and may change.
+ * @param model The Gemini TTS model to use
+ * @param config Configuration options (credentials only)
+ */
+declare function createGeminiTts(model: GeminiTTSModel, config: GeminiGatewayConfig): GeminiTTSAdapter<"gemini-2.5-flash-preview-tts" | "gemini-2.5-pro-preview-tts">;
+export { createGeminiTts }
+export { createGeminiTts as createGeminiTts_alias_1 }
+
+/**
+ * Creates a Grok chat adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ *
+ * Since GrokTextConfig extends the OpenAI SDK's ClientOptions,
+ * we can inject the gateway fetch directly — no subclassing needed.
+ */
+declare function createGrokChat(model: GrokChatModel, config: GrokGatewayConfig): GrokTextAdapter<"grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning" | "grok-code-fast-1" | "grok-4-fast-reasoning" | "grok-4-fast-non-reasoning" | "grok-4" | "grok-3" | "grok-3-mini" | "grok-2-vision-1212">;
+export { createGrokChat }
+export { createGrokChat as createGrokChat_alias_1 }
+
+/**
+ * Creates a Grok image adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ */
+declare function createGrokImage(model: GrokImageModel, config: GrokGatewayConfig): GrokImageAdapter<"grok-2-image-1212">;
+export { createGrokImage }
+export { createGrokImage as createGrokImage_alias_1 }
+
+/**
+ * Creates a Grok summarize adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ */
+declare function createGrokSummarize(model: GrokSummarizeModel, config: GrokGatewayConfig): GrokSummarizeAdapter<"grok-4-1-fast-reasoning" | "grok-4-1-fast-non-reasoning" | "grok-code-fast-1" | "grok-4-fast-reasoning" | "grok-4-fast-non-reasoning" | "grok-4" | "grok-3" | "grok-3-mini" | "grok-2-vision-1212">;
+export { createGrokSummarize }
+export { createGrokSummarize as createGrokSummarize_alias_1 }
+
+/**
+ * Creates an OpenAI chat adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ * @param model The OpenAI model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiChat(model: OpenAIChatModel, config: OpenAiGatewayConfig): OpenAITextAdapter<"gpt-5.2" | "gpt-5.2-pro" | "gpt-5.2-chat-latest" | "gpt-5.1" | "gpt-5.1-codex" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-pro" | "gpt-5-codex" | "o3" | "o3-pro" | "o3-mini" | "o4-mini" | "o3-deep-research" | "o4-mini-deep-research" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "gpt-4" | "gpt-4-turbo" | "gpt-4o" | "gpt-4o-mini" | "gpt-3.5-turbo" | "gpt-audio" | "gpt-audio-mini" | "gpt-4o-audio" | "gpt-4o-mini-audio" | "gpt-5.1-chat-latest" | "gpt-5-chat-latest" | "chatgpt-4o-latest" | "gpt-5.1-codex-mini" | "codex-mini-latest" | "gpt-4o-search-preview" | "gpt-4o-mini-search-preview" | "computer-use-preview" | "o1" | "o1-pro">;
+export { createOpenAiChat }
+export { createOpenAiChat as createOpenAiChat_alias_1 }
+
+/**
+ * Creates an OpenAI image adapter which uses Cloudflare AI Gateway.
+ * @param model The OpenAI image model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiImage(model: OpenAIImageModel, config: OpenAiGatewayConfig): OpenAIImageAdapter<"gpt-image-1" | "gpt-image-1-mini" | "dall-e-3" | "dall-e-2">;
+export { createOpenAiImage }
+export { createOpenAiImage as createOpenAiImage_alias_1 }
+
+/**
+ * Creates an OpenAI summarize adapter which uses Cloudflare AI Gateway.
+ * @param model The OpenAI model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiSummarize(model: OpenAIChatModel, config: OpenAiGatewayConfig): OpenAISummarizeAdapter<"gpt-5.2" | "gpt-5.2-pro" | "gpt-5.2-chat-latest" | "gpt-5.1" | "gpt-5.1-codex" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-pro" | "gpt-5-codex" | "o3" | "o3-pro" | "o3-mini" | "o4-mini" | "o3-deep-research" | "o4-mini-deep-research" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "gpt-4" | "gpt-4-turbo" | "gpt-4o" | "gpt-4o-mini" | "gpt-3.5-turbo" | "gpt-audio" | "gpt-audio-mini" | "gpt-4o-audio" | "gpt-4o-mini-audio" | "gpt-5.1-chat-latest" | "gpt-5-chat-latest" | "chatgpt-4o-latest" | "gpt-5.1-codex-mini" | "codex-mini-latest" | "gpt-4o-search-preview" | "gpt-4o-mini-search-preview" | "computer-use-preview" | "o1" | "o1-pro">;
+export { createOpenAiSummarize }
+export { createOpenAiSummarize as createOpenAiSummarize_alias_1 }
+
+/**
+ * Creates an OpenAI transcription adapter which uses Cloudflare AI Gateway.
+ * @param model The OpenAI transcription model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiTranscription(model: OpenAITranscriptionModel, config: OpenAiGatewayConfig): OpenAITranscriptionAdapter<"whisper-1" | "gpt-4o-transcribe" | "gpt-4o-mini-transcribe" | "gpt-4o-transcribe-diarize">;
+export { createOpenAiTranscription }
+export { createOpenAiTranscription as createOpenAiTranscription_alias_1 }
+
+/**
+ * Creates an OpenAI TTS adapter which uses Cloudflare AI Gateway.
+ * @param model The OpenAI TTS model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiTts(model: OpenAITTSModel, config: OpenAiGatewayConfig): OpenAITTSAdapter<"tts-1" | "tts-1-hd" | "gpt-4o-audio-preview">;
+export { createOpenAiTts }
+export { createOpenAiTts as createOpenAiTts_alias_1 }
+
+/**
+ * Creates an OpenAI video adapter which uses Cloudflare AI Gateway.
+ * @param model The OpenAI video model to use
+ * @param config Configuration options
+ */
+declare function createOpenAiVideo(model: OpenAIVideoModel, config: OpenAiGatewayConfig): OpenAIVideoAdapter<"sora-2" | "sora-2-pro">;
+export { createOpenAiVideo }
+export { createOpenAiVideo as createOpenAiVideo_alias_1 }
+
+/**
+ * Creates an OpenRouter chat adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ *
+ * @param model The model to use (e.g. "openai/gpt-4o", "anthropic/claude-sonnet-4-5")
+ * @param config Configuration options
+ */
+declare function createOpenRouterChat(model: OpenRouterChatModel, config: OpenRouterGatewayConfig): AnyTextAdapter;
+export { createOpenRouterChat }
+export { createOpenRouterChat as createOpenRouterChat_alias_1 }
+
+/**
+ * Creates an OpenRouter image adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ *
+ * @param model The image model to use
+ * @param config Configuration options
+ */
+declare function createOpenRouterImage(model: OpenRouterImageModel, config: OpenRouterGatewayConfig): OpenRouterImageAdapter<any>;
+export { createOpenRouterImage }
+export { createOpenRouterImage as createOpenRouterImage_alias_1 }
+
+/**
+ * Creates an OpenRouter summarize adapter which uses Cloudflare AI Gateway.
+ * Supports both binding and credential-based configurations.
+ *
+ * @param model The model to use for summarization
+ * @param config Configuration options
+ */
+declare function createOpenRouterSummarize(model: OpenRouterSummarizeModel, config: OpenRouterGatewayConfig): OpenRouterSummarizeAdapter<any>;
+export { createOpenRouterSummarize }
+export { createOpenRouterSummarize as createOpenRouterSummarize_alias_1 }
+
+/**
+ * Creates a fetch function that intercepts OpenAI SDK requests and translates them
+ * to Workers AI binding calls (env.AI.run). This allows the WorkersAiTextAdapter
+ * to use the OpenAI SDK against a plain Workers AI binding.
+ *
+ * NOTE: The `input` URL parameter is intentionally ignored. The model name and all
+ * request parameters are extracted from the JSON body, matching Workers AI's
+ * `binding.run(model, inputs)` calling convention.
+ */
+export declare function createWorkersAiBindingFetch(binding: WorkersAiBinding): typeof fetch;
+
+declare function createWorkersAiChat(model: WorkersAiTextModel, config: WorkersAiAdapterConfig): WorkersAiTextAdapter<WorkersAiTextModel>;
+export { createWorkersAiChat }
+export { createWorkersAiChat as createWorkersAiChat_alias_1 }
+
+/**
+ * Creates a Workers AI embedding adapter.
+ *
+ * Note: Factory takes `(model, config)` for ergonomics — the class constructor
+ * uses `(config, model)` to match TanStack AI's upstream convention.
+ */
+export declare function createWorkersAiEmbedding(model: WorkersAiEmbeddingModel, config: WorkersAiAdapterConfig): WorkersAiEmbeddingAdapter;
+
+/**
+ * Creates a Workers AI image generation adapter.
+ *
+ * Works with TanStack AI's `generateImage()` activity function:
+ * ```ts
+ * import { generateImage } from "@tanstack/ai";
+ * import { createWorkersAiImage } from "@cloudflare/tanstack-ai";
+ *
+ * const adapter = createWorkersAiImage(
+ *   "@cf/stabilityai/stable-diffusion-xl-base-1.0",
+ *   { binding: env.AI },
+ * );
+ *
+ * const result = await generateImage({ adapter, prompt: "a cat in space" });
+ * ```
+ *
+ * Note: Factory takes `(model, config)` for ergonomics — the class constructor
+ * uses `(config, model)` to match TanStack AI's upstream convention.
+ */
+declare function createWorkersAiImage(model: WorkersAiImageModel, config: WorkersAiAdapterConfig): WorkersAiImageAdapter;
+export { createWorkersAiImage }
+export { createWorkersAiImage as createWorkersAiImage_alias_1 }
+
+/**
+ * Creates a Workers AI summarization adapter.
+ *
+ * Works with TanStack AI's `summarize()` activity function:
+ * ```ts
+ * import { summarize } from "@tanstack/ai";
+ * import { createWorkersAiSummarize } from "@cloudflare/tanstack-ai";
+ *
+ * const adapter = createWorkersAiSummarize("@cf/facebook/bart-large-cnn", {
+ *   binding: env.AI,
+ * });
+ *
+ * const result = await summarize({ adapter, text: "Long article here..." });
+ * // result.summary
+ * ```
+ *
+ * Note: Factory takes `(model, config)` for ergonomics — the class constructor
+ * uses `(config, model)` to match TanStack AI's upstream convention.
+ */
+declare function createWorkersAiSummarize(model: WorkersAiSummarizeModel, config: WorkersAiAdapterConfig): WorkersAiSummarizeAdapter;
+export { createWorkersAiSummarize }
+export { createWorkersAiSummarize as createWorkersAiSummarize_alias_1 }
+
+/**
+ * Creates a Workers AI transcription adapter for speech-to-text.
+ *
+ * Works with TanStack AI's `generateTranscription()` activity function:
+ * ```ts
+ * import { generateTranscription } from "@tanstack/ai";
+ * import { createWorkersAiTranscription } from "@cloudflare/tanstack-ai";
+ *
+ * const adapter = createWorkersAiTranscription(
+ *   "@cf/openai/whisper-large-v3-turbo",
+ *   { binding: env.AI },
+ * );
+ *
+ * const result = await generateTranscription({ adapter, audio: audioData });
+ * // result.text — the transcribed text
+ * ```
+ *
+ * Note: Factory takes `(model, config)` for ergonomics — the class constructor
+ * uses `(config, model)` to match TanStack AI's upstream convention.
+ */
+declare function createWorkersAiTranscription(model: WorkersAiTranscriptionModel, config: WorkersAiAdapterConfig): WorkersAiTranscriptionAdapter;
+export { createWorkersAiTranscription }
+export { createWorkersAiTranscription as createWorkersAiTranscription_alias_1 }
+
+/**
+ * Creates a Workers AI text-to-speech adapter.
+ *
+ * Works with TanStack AI's `generateSpeech()` activity function:
+ * ```ts
+ * import { generateSpeech } from "@tanstack/ai";
+ * import { createWorkersAiTts } from "@cloudflare/tanstack-ai";
+ *
+ * const adapter = createWorkersAiTts(
+ *   "@cf/deepgram/aura-1",
+ *   { binding: env.AI },
+ * );
+ *
+ * const result = await generateSpeech({ adapter, text: "Hello world" });
+ * // result.audio — base64-encoded audio
+ * ```
+ *
+ * Note: Factory takes `(model, config)` for ergonomics — the class constructor
+ * uses `(config, model)` to match TanStack AI's upstream convention.
+ */
+declare function createWorkersAiTts(model: WorkersAiTTSModel, config: WorkersAiAdapterConfig): WorkersAiTTSAdapter;
+export { createWorkersAiTts }
+export { createWorkersAiTts as createWorkersAiTts_alias_1 }
+
+export declare const default_alias: {
+    fetch(request: Request, env: Env): Promise<Response>;
+};
+
+declare interface Env {
+    AI: Ai;
+}
+
+/** Alias for consistency with other providers (AnthropicChatModel, GrokChatModel, etc.) */
+declare type GeminiChatModel = GeminiTextModel;
+export { GeminiChatModel }
+export { GeminiChatModel as GeminiChatModel_alias_1 }
+
+/**
+ * Gemini-specific gateway config (credentials only, no binding support).
+ * Includes cache control options from AiGatewayConfig.
+ * See {@link https://github.com/googleapis/js-genai/issues/999 | googleapis/js-genai#999}.
+ */
+declare type GeminiGatewayConfig = AiGatewayCredentialsConfig & AiGatewayConfig;
+export { GeminiGatewayConfig }
+export { GeminiGatewayConfig as GeminiGatewayConfig_alias_1 }
+
+export { GeminiImageModel }
+export { GeminiImageModel as GeminiImageModel_alias_1 }
+
+export { GeminiImageModels }
+export { GeminiImageModels as GeminiImageModels_alias_1 }
+
+export { GeminiSummarizeModel }
+export { GeminiSummarizeModel as GeminiSummarizeModel_alias_1 }
+
+export { GeminiSummarizeModels }
+export { GeminiSummarizeModels as GeminiSummarizeModels_alias_1 }
+
+export { GeminiTextModel }
+export { GeminiTextModel as GeminiTextModel_alias_1 }
+
+export { GeminiTextModels }
+export { GeminiTextModels as GeminiTextModels_alias_1 }
+
+/** Derived from GeminiTTSModels since @tanstack/ai-gemini doesn't export a GeminiTTSModel type. */
+declare type GeminiTTSModel = (typeof GeminiTTSModels)[number];
+export { GeminiTTSModel }
+export { GeminiTTSModel as GeminiTTSModel_alias_1 }
+
+export { GeminiTTSModels }
+export { GeminiTTSModels as GeminiTTSModels_alias_1 }
+
+export { GROK_CHAT_MODELS }
+export { GROK_CHAT_MODELS as GROK_CHAT_MODELS_alias_1 }
+
+export { GROK_IMAGE_MODELS }
+export { GROK_IMAGE_MODELS as GROK_IMAGE_MODELS_alias_1 }
+
+export { GrokChatModel }
+export { GrokChatModel as GrokChatModel_alias_1 }
+
+declare type GrokGatewayConfig = AiGatewayAdapterConfig;
+export { GrokGatewayConfig }
+export { GrokGatewayConfig as GrokGatewayConfig_alias_1 }
+
+export { GrokImageModel }
+export { GrokImageModel as GrokImageModel_alias_1 }
+
+export { GrokSummarizeModel }
+export { GrokSummarizeModel as GrokSummarizeModel_alias_1 }
+
+/** Returns true if this is a plain Workers AI binding config (`{ binding: env.AI }`) */
+export declare function isDirectBindingConfig(config: WorkersAiAdapterConfig): config is WorkersAiDirectBindingConfig;
+
+/** Returns true if this is a plain Workers AI REST config (accountId + apiKey, no gatewayId) */
+export declare function isDirectCredentialsConfig(config: WorkersAiAdapterConfig): config is WorkersAiDirectCredentialsConfig;
+
+/** Returns true if this is an AI Gateway config (has gateway binding or `gatewayId`) */
+export declare function isGatewayConfig(config: WorkersAiAdapterConfig): config is AiGatewayAdapterConfig;
+
+export { OPENAI_CHAT_MODELS }
+export { OPENAI_CHAT_MODELS as OPENAI_CHAT_MODELS_alias_1 }
+
+export { OPENAI_IMAGE_MODELS }
+export { OPENAI_IMAGE_MODELS as OPENAI_IMAGE_MODELS_alias_1 }
+
+export { OPENAI_TRANSCRIPTION_MODELS }
+export { OPENAI_TRANSCRIPTION_MODELS as OPENAI_TRANSCRIPTION_MODELS_alias_1 }
+
+export { OPENAI_TTS_MODELS }
+export { OPENAI_TTS_MODELS as OPENAI_TTS_MODELS_alias_1 }
+
+export { OPENAI_VIDEO_MODELS }
+export { OPENAI_VIDEO_MODELS as OPENAI_VIDEO_MODELS_alias_1 }
+
+export { OpenAIChatModel }
+export { OpenAIChatModel as OpenAIChatModel_alias_1 }
+
+declare type OpenAiGatewayConfig = AiGatewayAdapterConfig;
+export { OpenAiGatewayConfig }
+export { OpenAiGatewayConfig as OpenAiGatewayConfig_alias_1 }
+
+export { OpenAIImageModel }
+export { OpenAIImageModel as OpenAIImageModel_alias_1 }
+
+export { OpenAITranscriptionModel }
+export { OpenAITranscriptionModel as OpenAITranscriptionModel_alias_1 }
+
+export { OpenAITTSModel }
+export { OpenAITTSModel as OpenAITTSModel_alias_1 }
+
+export { OpenAIVideoModel }
+export { OpenAIVideoModel as OpenAIVideoModel_alias_1 }
+
+/** OpenRouter chat model identifier. Accepts any string since OpenRouter proxies hundreds of models. */
+declare type OpenRouterChatModel = string;
+export { OpenRouterChatModel }
+export { OpenRouterChatModel as OpenRouterChatModel_alias_1 }
+
+declare type OpenRouterGatewayConfig = AiGatewayAdapterConfig;
+export { OpenRouterGatewayConfig }
+export { OpenRouterGatewayConfig as OpenRouterGatewayConfig_alias_1 }
+
+/** OpenRouter image model identifier. */
+declare type OpenRouterImageModel = string;
+export { OpenRouterImageModel }
+export { OpenRouterImageModel as OpenRouterImageModel_alias_1 }
+
+/** OpenRouter summarize model identifier (same as chat models). */
+declare type OpenRouterSummarizeModel = string;
+export { OpenRouterSummarizeModel }
+export { OpenRouterSummarizeModel as OpenRouterSummarizeModel_alias_1 }
+
+/**
+ * Shared binary-data utilities for Workers AI adapters.
+ *
+ * Workers AI returns binary data (images, audio) in various formats —
+ * Uint8Array, ArrayBuffer, ReadableStream, or JSON objects with a base64 field.
+ * These helpers normalise everything into base64 strings for the TanStack AI
+ * result types.
+ */
+/**
+ * Convert a Uint8Array to a base64 string.
+ */
+export declare function uint8ArrayToBase64(bytes: Uint8Array): string;
+
+/**
+ * Config for Workers AI adapters. Supports four modes:
+ * - Plain binding: `{ binding: env.AI }`
+ * - Plain REST: `{ accountId, apiKey }`
+ * - AI Gateway binding: `{ binding: env.AI.gateway(id) }`
+ * - AI Gateway REST: `{ accountId, gatewayId, ... }`
+ *
+ * The third union member intersects `AiGatewayAdapterConfig` with `{ apiKey?: string }`.
+ * For the gateway binding variant, `AiGatewayBindingConfig` already includes `apiKey?`,
+ * so the intersection is redundant there. For the gateway credentials variant, this
+ * `apiKey` represents the Workers AI token (used in the `Authorization` header to the
+ * upstream provider), distinct from `cfApiKey` (used in the `cf-aig-authorization`
+ * header for authenticated gateways).
+ */
+declare type WorkersAiAdapterConfig = WorkersAiDirectBindingConfig | WorkersAiDirectCredentialsConfig | (AiGatewayAdapterConfig & {
+    apiKey?: string;
+});
+export { WorkersAiAdapterConfig }
+export { WorkersAiAdapterConfig as WorkersAiAdapterConfig_alias_1 }
+
+/**
+ * The Workers AI binding interface (env.AI).
+ * Accepts a model name and inputs, returns results directly.
+ * Includes `gateway()` which is present on `env.AI` but not on `env.AI.gateway(id)`,
+ * enabling structural discrimination from `CloudflareAiGateway`.
+ */
+export declare interface WorkersAiBinding {
+    run(model: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    gateway(gatewayId: string): CloudflareAiGateway;
+}
+
+export declare interface WorkersAiDirectBindingConfig {
+    /**
+     * The Workers AI binding (env.AI).
+     * @example
+     * { binding: env.AI }
+     */
+    binding: WorkersAiBinding;
+}
+
+export declare interface WorkersAiDirectCredentialsConfig {
+    /**
+     * The Cloudflare account ID
+     */
+    accountId: string;
+    /**
+     * The Cloudflare API key for Workers AI
+     */
+    apiKey: string;
+}
+
+export declare class WorkersAiEmbeddingAdapter {
+    readonly name: "workers-ai-embedding";
+    private model;
+    private config;
+    constructor(config: WorkersAiAdapterConfig, model: WorkersAiEmbeddingModel);
+    embed(texts: string[]): Promise<WorkersAiEmbeddingResult>;
+    private embedViaBinding;
+    private embedViaRest;
+    private embedViaGateway;
+}
+
+export declare type WorkersAiEmbeddingModel = {
+    [K in keyof AiModels_2]: AiModels_2[K] extends BaseAiTextEmbeddings_2 ? K : never;
+}[keyof AiModels_2];
+
+export declare interface WorkersAiEmbeddingResult {
+    embeddings: number[][];
+}
+
+export declare class WorkersAiImageAdapter extends BaseImageAdapter<WorkersAiImageModel> {
+    readonly name: "workers-ai-image";
+    private adapterConfig;
+    constructor(config: WorkersAiAdapterConfig, model: WorkersAiImageModel);
+    generateImages(options: ImageGenerationOptions): Promise<ImageGenerationResult>;
+    private generateViaBinding;
+    private generateViaRest;
+    private generateViaGateway;
+    /** Wrap a base64 image string into the standard ImageGenerationResult. */
+    private wrapResult;
+}
+
+declare type WorkersAiImageModel = {
+    [K in keyof AiModels_2]: AiModels_2[K] extends BaseAiTextToImage_2 ? K : never;
+}[keyof AiModels_2];
+export { WorkersAiImageModel }
+export { WorkersAiImageModel as WorkersAiImageModel_alias_1 }
+
+/**
+ * Make a REST API call to Workers AI.
+ *
+ * Handles the common pattern shared by all Workers AI adapters:
+ * - Build the URL from account ID and model name
+ * - Set Authorization and Content-Type headers
+ * - Check response.ok and throw a descriptive error on failure
+ *
+ * @param config  Credentials config with accountId and apiKey
+ * @param model   Workers AI model name (e.g. "@cf/stabilityai/stable-diffusion-xl-base-1.0")
+ * @param body    JSON request body
+ * @param options Optional settings:
+ *   - `label`  — human-readable label for error messages (default: "Workers AI")
+ *   - `signal` — AbortSignal for request cancellation / timeout
+ * @returns The raw Response object — caller is responsible for parsing
+ */
+export declare function workersAiRestFetch(config: WorkersAiDirectCredentialsConfig, model: string, body: Record<string, unknown>, options?: {
+    label?: string;
+    signal?: AbortSignal;
+}): Promise<Response>;
+
+/**
+ * Make a binary REST API call to Workers AI.
+ *
+ * Some models (e.g. `@cf/deepgram/nova-3`) require raw binary audio with an
+ * appropriate `Content-Type` header instead of JSON. This function sends the
+ * audio bytes directly as the request body.
+ *
+ * @param config  Credentials config with accountId and apiKey
+ * @param model   Workers AI model name
+ * @param audioBytes  Raw audio bytes
+ * @param contentType  MIME type of the audio (e.g. "audio/wav")
+ * @param options Optional settings
+ * @returns The raw Response object
+ */
+export declare function workersAiRestFetchBinary(config: WorkersAiDirectCredentialsConfig, model: string, audioBytes: Uint8Array, contentType: string, options?: {
+    label?: string;
+    signal?: AbortSignal;
+}): Promise<Response>;
+
+export declare class WorkersAiSummarizeAdapter extends BaseSummarizeAdapter<WorkersAiSummarizeModel> {
+    readonly name: "workers-ai-summarize";
+    private adapterConfig;
+    constructor(config: WorkersAiAdapterConfig, model: WorkersAiSummarizeModel);
+    summarize(options: SummarizationOptions): Promise<SummarizationResult>;
+    private summarizeViaBinding;
+    private summarizeViaRest;
+    private summarizeViaGateway;
+    private wrapResult;
+}
+
+/**
+ * Workers AI models that support summarization.
+ */
+declare type WorkersAiSummarizeModel = "@cf/facebook/bart-large-cnn";
+export { WorkersAiSummarizeModel }
+export { WorkersAiSummarizeModel as WorkersAiSummarizeModel_alias_1 }
+
+export declare class WorkersAiTextAdapter<TModel extends WorkersAiTextModel> extends BaseTextAdapter<TModel, any, any, any> {
+    name: "workers-ai";
+    private client;
+    constructor(model: TModel, config: WorkersAiAdapterConfig);
+    chatStream(options: TextOptions<any>): AsyncIterable<StreamChunk>;
+    structuredOutput(options: StructuredOutputOptions<any>): Promise<StructuredOutputResult<unknown>>;
+}
+
+declare type WorkersAiTextModel = {
+    [K in keyof AiModels_2]: AiModels_2[K] extends BaseAiTextGeneration_2 ? K : never;
+}[keyof AiModels_2];
+export { WorkersAiTextModel }
+export { WorkersAiTextModel as WorkersAiTextModel_alias_1 }
+
+export declare class WorkersAiTranscriptionAdapter extends BaseTranscriptionAdapter<WorkersAiTranscriptionModel> {
+    readonly name: "workers-ai-transcription";
+    private adapterConfig;
+    constructor(config: WorkersAiAdapterConfig, model: WorkersAiTranscriptionModel);
+    transcribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+    /**
+     * Build the audio field for the request payload, handling model-specific formats.
+     *
+     * - `@cf/deepgram/nova-3` requires `{ body: base64, contentType: "audio/..." }`
+     * - `@cf/openai/whisper-large-v3-turbo` REST/gateway accepts a base64 string
+     * - Other Whisper models accept `number[]` (binding) or base64 (REST)
+     */
+    private buildAudioPayload;
+    private transcribeViaBinding;
+    private transcribeViaRest;
+    /**
+     * Transcribe via REST using raw binary audio.
+     * Required for models like Deepgram Nova-3 that expect raw audio bytes
+     * with a Content-Type header (e.g. "audio/wav") instead of JSON.
+     */
+    private transcribeViaRestBinary;
+    private transcribeViaGateway;
+    /**
+     * Normalize Workers AI transcription results into the standard
+     * TanStack AI TranscriptionResult shape.
+     *
+     * Handles three response formats:
+     * - Whisper: `{ text, words?, vtt? }`
+     * - Whisper v3-turbo: `{ text, segments?, transcription_info? }`
+     * - Deepgram Nova-3: `{ results: { channels: [{ alternatives: [{ transcript, words }] }] } }`
+     */
+    private normalizeResult;
+}
+
+/**
+ * Workers AI models that support speech-to-text transcription.
+ *
+ * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag
+ * behind what's deployed. We use a string union here that matches the known
+ * models including Deepgram partner models.
+ *
+ * **Nova-3 note:** `@cf/deepgram/nova-3` uses a different input format than the
+ * Whisper models. Via binding it accepts `{ audio: { body: base64, contentType } }`.
+ * Via REST it requires multipart form data (not JSON). The adapter handles both.
+ */
+declare type WorkersAiTranscriptionModel = "@cf/openai/whisper" | "@cf/openai/whisper-tiny-en" | "@cf/openai/whisper-large-v3-turbo" | "@cf/deepgram/nova-3";
+export { WorkersAiTranscriptionModel }
+export { WorkersAiTranscriptionModel as WorkersAiTranscriptionModel_alias_1 }
+
+export declare class WorkersAiTTSAdapter extends BaseTTSAdapter<WorkersAiTTSModel> {
+    readonly name: "workers-ai-tts";
+    private adapterConfig;
+    constructor(config: WorkersAiAdapterConfig, model: WorkersAiTTSModel);
+    generateSpeech(options: TTSOptions): Promise<TTSResult>;
+    private generateViaBinding;
+    private generateViaRest;
+    private generateViaGateway;
+    /**
+     * Normalize binding results. Workers AI TTS can return:
+     * - Uint8Array / ArrayBuffer (raw audio bytes)
+     * - ReadableStream<Uint8Array> (streamed audio bytes)
+     * - { audio: "base64..." } (JSON wrapper)
+     */
+    private normalizeResult;
+    private wrapAudioResult;
+}
+
+/**
+ * Workers AI models that support text-to-speech generation.
+ *
+ * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag
+ * behind what's deployed. We use a string union here that matches the known
+ * models including Deepgram partner models.
+ */
+declare type WorkersAiTTSModel = "@cf/deepgram/aura-1" | "@cf/deepgram/aura-2-en" | "@cf/deepgram/aura-2-es";
+export { WorkersAiTTSModel }
+export { WorkersAiTTSModel as WorkersAiTTSModel_alias_1 }
+
+export { }