@rudderjs/ai 1.4.0 → 1.6.0

package/dist/providers/bedrock.js

@@ -0,0 +1,167 @@
+import { splitSystemMessages, toAnthropicMessages, toAnthropicTools, toAnthropicToolChoice, fromAnthropicResponse, applyCacheToSystem, applyCacheToTools, applyCacheToMessages, } from './anthropic.js';
+export class BedrockProvider {
+    name = 'bedrock';
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    create(model) {
+        return new BedrockAdapter(this.config, model);
+    }
+}
+// ─── Adapter ──────────────────────────────────────────────
+class BedrockAdapter {
+    config;
+    model;
+    client = null;
+    constructor(config, model) {
+        this.config = config;
+        this.model = model;
+        if (!isAnthropicOnBedrock(model)) {
+            throw new Error(`[RudderJS AI] Bedrock model "${model}" is not yet supported. v1 only supports Anthropic Claude models on Bedrock ` +
+                `(model id starts with "anthropic."). File an issue at https://github.com/rudderjs/rudder/issues if you need another family.`);
+        }
+    }
+    async getClient() {
+        if (this.client)
+            return this.client;
+        const sdk = await import(/* @vite-ignore */ '@aws-sdk/client-bedrock-runtime');
+        const BedrockRuntimeClient = sdk.BedrockRuntimeClient;
+        const clientConfig = { region: this.config.region };
+        if (this.config.credentials) {
+            const c = this.config.credentials;
+            clientConfig['credentials'] = {
+                accessKeyId: c.accessKeyId,
+                secretAccessKey: c.secretAccessKey,
+                ...(c.sessionToken ? { sessionToken: c.sessionToken } : {}),
+            };
+        }
+        this.client = new BedrockRuntimeClient(clientConfig);
+        return this.client;
+    }
+    async generate(options) {
+        const client = await this.getClient();
+        const sdk = await import(/* @vite-ignore */ '@aws-sdk/client-bedrock-runtime');
+        const InvokeModelCommand = sdk.InvokeModelCommand;
+        const body = this.buildAnthropicBody(options);
+        const command = new InvokeModelCommand({
+            modelId: this.model,
+            contentType: 'application/json',
+            accept: 'application/json',
+            body: JSON.stringify(body),
+        });
+        const abortOpts = options.signal ? { abortSignal: options.signal } : undefined;
+        const response = await client.send(command, abortOpts);
+        const decoded = JSON.parse(new TextDecoder().decode(response.body));
+        return fromAnthropicResponse(decoded);
+    }
+    async *stream(options) {
+        const client = await this.getClient();
+        const sdk = await import(/* @vite-ignore */ '@aws-sdk/client-bedrock-runtime');
+        const InvokeModelWithResponseStreamCommand = sdk.InvokeModelWithResponseStreamCommand;
+        const body = this.buildAnthropicBody(options);
+        const command = new InvokeModelWithResponseStreamCommand({
+            modelId: this.model,
+            contentType: 'application/json',
+            accept: 'application/json',
+            body: JSON.stringify(body),
+        });
+        const abortOpts = options.signal ? { abortSignal: options.signal } : undefined;
+        const response = await client.send(command, abortOpts);
+        if (!response.body)
+            return;
+        const decoder = new TextDecoder();
+        for await (const event of response.body) {
+            if (!event.chunk?.bytes)
+                continue;
+            const decoded = JSON.parse(decoder.decode(event.chunk.bytes));
+            yield* mapBedrockAnthropicEvent(decoded);
+        }
+    }
+    /**
+     * Build the Bedrock-Anthropic request body. The shape mirrors the native
+     * Anthropic Messages API minus `model` (Bedrock takes the modelId in the
+     * URL) and plus `anthropic_version` (required by Bedrock).
+     *
+     * Spec: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages.html
+     */
+    buildAnthropicBody(options) {
+        const { system, messages } = splitSystemMessages(options.messages);
+        const cache = options.cache;
+        const body = {
+            anthropic_version: 'bedrock-2023-05-31',
+            max_tokens: options.maxTokens ?? 4096,
+            messages: applyCacheToMessages(toAnthropicMessages(messages), cache?.messages),
+        };
+        const sys = applyCacheToSystem(system, cache?.instructions === true);
+        if (sys !== undefined)
+            body['system'] = sys;
+        if (options.temperature !== undefined)
+            body['temperature'] = options.temperature;
+        if (options.topP !== undefined)
+            body['top_p'] = options.topP;
+        if (options.stop)
+            body['stop_sequences'] = options.stop;
+        if (options.tools?.length) {
+            body['tools'] = applyCacheToTools(toAnthropicTools(options.tools), cache?.tools === true);
+        }
+        const choice = options.toolChoice ? toAnthropicToolChoice(options.toolChoice) : undefined;
+        if (choice !== undefined)
+            body['tool_choice'] = choice;
+        return body;
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────
+/**
+ * Bedrock model ids for Anthropic look like `anthropic.claude-3-5-sonnet-20241022-v2:0`.
+ * Any other prefix (`meta.`, `amazon.`, `cohere.`, `mistral.`, `ai21.`) is a
+ * different model family that needs its own conversion path.
+ */
+export function isAnthropicOnBedrock(model) {
+    return model.startsWith('anthropic.') || model.startsWith('us.anthropic.') || model.startsWith('eu.anthropic.') || model.startsWith('apac.anthropic.');
+}
+/**
+ * Map a single decoded Bedrock-Anthropic stream event to zero-or-more
+ * `StreamChunk`s. Bedrock wraps Anthropic's native streaming events 1:1 in
+ * `chunk.bytes`, so the body shape matches `anthropic.ts`'s loop — but we
+ * keep the mapping here so a future model family can be added cleanly.
+ */
+export function* mapBedrockAnthropicEvent(event) {
+    if (event['type'] === 'content_block_delta') {
+        const delta = event['delta'];
+        if (delta?.type === 'text_delta') {
+            yield { type: 'text-delta', text: delta.text };
+        }
+        else if (delta?.type === 'input_json_delta') {
+            yield { type: 'tool-call-delta', text: delta.partial_json };
+        }
+    }
+    else if (event['type'] === 'content_block_start' && event['content_block']?.type === 'tool_use') {
+        yield {
+            type: 'tool-call-delta',
+            toolCall: { id: event['content_block'].id, name: event['content_block'].name },
+        };
+    }
+    else if (event['type'] === 'message_delta') {
+        yield {
+            type: 'finish',
+            finishReason: event['delta']?.stop_reason === 'tool_use' ? 'tool_calls' : 'stop',
+            usage: {
+                promptTokens: 0,
+                completionTokens: event['usage']?.output_tokens ?? 0,
+                totalTokens: event['usage']?.output_tokens ?? 0,
+            },
+        };
+    }
+    else if (event['type'] === 'message_start' && event['message']?.usage) {
+        yield {
+            type: 'usage',
+            usage: {
+                promptTokens: event['message'].usage.input_tokens ?? 0,
+                completionTokens: event['message'].usage.output_tokens ?? 0,
+                totalTokens: (event['message'].usage.input_tokens ?? 0) + (event['message'].usage.output_tokens ?? 0),
+            },
+        };
+    }
+}
+//# sourceMappingURL=bedrock.js.map

package/dist/providers/bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.js","sourceRoot":"","sources":["../../src/providers/bedrock.ts"],"names":[],"mappings":"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"}

package/dist/providers/elevenlabs.d.ts

@@ -0,0 +1,98 @@
+/**
+ * ElevenLabs provider — premium TTS + STT (#B9).
+ *
+ * Implements `TextToSpeechAdapter` + `SpeechToTextAdapter` only — ElevenLabs
+ * has no chat-completions surface, so `create()` throws. Apps reach this
+ * provider through `AudioGenerator.of(...).model('elevenlabs/<voice_id>').generate()`
+ * and `Transcription.of(...).model('elevenlabs/scribe_v1').transcribe()`.
+ *
+ * Wire-protocol via raw `fetch` (no SDK peer dep), matching the Jina /
+ * Cohere shape. ElevenLabs's REST API is small enough that pulling in
+ * `@elevenlabs/elevenlabs-js` (or any SDK) would add weight without much
+ * leverage.
+ *
+ * @example  Config-driven (recommended)
+ * ```ts
+ * // config/ai.ts
+ * export default {
+ *   default: 'openai/gpt-4o',
+ *   providers: {
+ *     openai:     { driver: 'openai',     apiKey: env('OPENAI_API_KEY')! },
+ *     elevenlabs: { driver: 'elevenlabs', apiKey: env('ELEVENLABS_API_KEY')! },
+ *   },
+ * }
+ *
+ * // somewhere in app code
+ * await AudioGenerator
+ *   .of('Hello world')
+ *   .model('elevenlabs/21m00Tcm4TlvDq8ikWAM')   // voice_id (Rachel)
+ *   .generate()
+ * ```
+ *
+ * @example  Failover from OpenAI TTS to ElevenLabs
+ * ```ts
+ * await AudioGenerator
+ *   .of('Hello')
+ *   .model('openai/tts-1-hd')
+ *   .failover('elevenlabs/21m00Tcm4TlvDq8ikWAM')
+ *   .generate()
+ * ```
+ *
+ * # Model strings
+ *
+ * **TTS:** the model string after `elevenlabs/` is the **voice id**
+ * (e.g. `21m00Tcm4TlvDq8ikWAM` for Rachel). The actual TTS model
+ * (`eleven_multilingual_v2`, `eleven_turbo_v2_5`, ...) defaults to
+ * {@link DEFAULT_TTS_MODEL_ID}; override via `ElevenLabsConfig.defaultTtsModelId`.
+ * Voice ids are the discriminator most apps want to vary per-call — the
+ * underlying TTS model is usually stable per deployment.
+ *
+ * **STT:** the model string is the actual model id (`scribe_v1` is the
+ * only model today).
+ *
+ * # Format mapping (TTS)
+ *
+ * `TextToSpeechOptions.format` maps to ElevenLabs's `output_format`:
+ *
+ * | Our format | ElevenLabs |
+ * |---|---|
+ * | `mp3` (default) | `mp3_44100_128` |
+ * | `opus`          | `opus_48000_128` |
+ * | `wav` / `aac` / `flac` | not supported by ElevenLabs — throws clearly |
+ *
+ * # Speed knob (TTS)
+ *
+ * `TextToSpeechOptions.speed` is **ignored** by this adapter — ElevenLabs
+ * doesn't expose a top-level speed multiplier on the TTS endpoint
+ * (timing is steered via `voice_settings.stability` etc., out of scope
+ * for v1). OpenAI's TTS supports speed natively; failover from OpenAI
+ * to ElevenLabs will produce audio at default speed.
+ */
+import type { ProviderFactory, ProviderAdapter, TextToSpeechAdapter, SpeechToTextAdapter } from '../types.js';
+/** Default TTS model when `ElevenLabsConfig.defaultTtsModelId` is unset. */
+export declare const DEFAULT_TTS_MODEL_ID = "eleven_multilingual_v2";
+/** Default voice when no voice id is encoded into the model string and no `opts.voice` override. */
+export declare const DEFAULT_VOICE_ID = "21m00Tcm4TlvDq8ikWAM";
+export interface ElevenLabsConfig {
+    apiKey: string;
+    /**
+     * Override `https://api.elevenlabs.io`. Useful for proxying through a
+     * gateway or for self-hosted ElevenLabs-compatible APIs.
+     */
+    baseUrl?: string;
+    /**
+     * The TTS model id to send in the request body. Defaults to
+     * `eleven_multilingual_v2`. Override per-deployment when piloting a
+     * newer model (e.g. `eleven_turbo_v2_5` for lower-latency runs).
+     */
+    defaultTtsModelId?: string;
+}
+export declare class ElevenLabsProvider implements ProviderFactory {
+    readonly name = "elevenlabs";
+    private readonly config;
+    constructor(config: ElevenLabsConfig);
+    create(_model: string): ProviderAdapter;
+    createTts(model: string): TextToSpeechAdapter;
+    createStt(model: string): SpeechToTextAdapter;
+}
+//# sourceMappingURL=elevenlabs.d.ts.map

package/dist/providers/elevenlabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../src/providers/elevenlabs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EAGnB,mBAAmB,EAGpB,MAAM,aAAa,CAAA;AAIpB,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,2BAA2B,CAAA;AAE5D,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,yBAAyB,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,gBAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAIpC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAI7C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;CAG9C"}

package/dist/providers/elevenlabs.js

@@ -0,0 +1,229 @@
+/**
+ * ElevenLabs provider — premium TTS + STT (#B9).
+ *
+ * Implements `TextToSpeechAdapter` + `SpeechToTextAdapter` only — ElevenLabs
+ * has no chat-completions surface, so `create()` throws. Apps reach this
+ * provider through `AudioGenerator.of(...).model('elevenlabs/<voice_id>').generate()`
+ * and `Transcription.of(...).model('elevenlabs/scribe_v1').transcribe()`.
+ *
+ * Wire-protocol via raw `fetch` (no SDK peer dep), matching the Jina /
+ * Cohere shape. ElevenLabs's REST API is small enough that pulling in
+ * `@elevenlabs/elevenlabs-js` (or any SDK) would add weight without much
+ * leverage.
+ *
+ * @example  Config-driven (recommended)
+ * ```ts
+ * // config/ai.ts
+ * export default {
+ *   default: 'openai/gpt-4o',
+ *   providers: {
+ *     openai:     { driver: 'openai',     apiKey: env('OPENAI_API_KEY')! },
+ *     elevenlabs: { driver: 'elevenlabs', apiKey: env('ELEVENLABS_API_KEY')! },
+ *   },
+ * }
+ *
+ * // somewhere in app code
+ * await AudioGenerator
+ *   .of('Hello world')
+ *   .model('elevenlabs/21m00Tcm4TlvDq8ikWAM')   // voice_id (Rachel)
+ *   .generate()
+ * ```
+ *
+ * @example  Failover from OpenAI TTS to ElevenLabs
+ * ```ts
+ * await AudioGenerator
+ *   .of('Hello')
+ *   .model('openai/tts-1-hd')
+ *   .failover('elevenlabs/21m00Tcm4TlvDq8ikWAM')
+ *   .generate()
+ * ```
+ *
+ * # Model strings
+ *
+ * **TTS:** the model string after `elevenlabs/` is the **voice id**
+ * (e.g. `21m00Tcm4TlvDq8ikWAM` for Rachel). The actual TTS model
+ * (`eleven_multilingual_v2`, `eleven_turbo_v2_5`, ...) defaults to
+ * {@link DEFAULT_TTS_MODEL_ID}; override via `ElevenLabsConfig.defaultTtsModelId`.
+ * Voice ids are the discriminator most apps want to vary per-call — the
+ * underlying TTS model is usually stable per deployment.
+ *
+ * **STT:** the model string is the actual model id (`scribe_v1` is the
+ * only model today).
+ *
+ * # Format mapping (TTS)
+ *
+ * `TextToSpeechOptions.format` maps to ElevenLabs's `output_format`:
+ *
+ * | Our format | ElevenLabs |
+ * |---|---|
+ * | `mp3` (default) | `mp3_44100_128` |
+ * | `opus`          | `opus_48000_128` |
+ * | `wav` / `aac` / `flac` | not supported by ElevenLabs — throws clearly |
+ *
+ * # Speed knob (TTS)
+ *
+ * `TextToSpeechOptions.speed` is **ignored** by this adapter — ElevenLabs
+ * doesn't expose a top-level speed multiplier on the TTS endpoint
+ * (timing is steered via `voice_settings.stability` etc., out of scope
+ * for v1). OpenAI's TTS supports speed natively; failover from OpenAI
+ * to ElevenLabs will produce audio at default speed.
+ */
+const ELEVENLABS_BASE_URL = 'https://api.elevenlabs.io';
+/** Default TTS model when `ElevenLabsConfig.defaultTtsModelId` is unset. */
+export const DEFAULT_TTS_MODEL_ID = 'eleven_multilingual_v2';
+/** Default voice when no voice id is encoded into the model string and no `opts.voice` override. */
+export const DEFAULT_VOICE_ID = '21m00Tcm4TlvDq8ikWAM';
+export class ElevenLabsProvider {
+    name = 'elevenlabs';
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    create(_model) {
+        throw new Error('[RudderJS AI] ElevenLabs does not support text generation. Use it for text-to-speech and speech-to-text.');
+    }
+    createTts(model) {
+        return new ElevenLabsTtsAdapter(this.config, model);
+    }
+    createStt(model) {
+        return new ElevenLabsSttAdapter(this.config, model);
+    }
+}
+// ─── TTS Adapter ─────────────────────────────────────────
+class ElevenLabsTtsAdapter {
+    config;
+    modelOrVoiceId;
+    constructor(config, 
+    /**
+     * Treated as a **voice id** (e.g. `21m00Tcm4TlvDq8ikWAM` for Rachel).
+     * The TTS model id ships from `ElevenLabsConfig.defaultTtsModelId`.
+     * Apps that want to vary the TTS model per-call should use multiple
+     * registered providers (one per model) — the model-string convention
+     * across @rudderjs/ai is `<provider>/<voice-or-model>`.
+     */
+    modelOrVoiceId) {
+        this.config = config;
+        this.modelOrVoiceId = modelOrVoiceId;
+    }
+    async generate(options) {
+        const baseUrl = this.config.baseUrl ?? ELEVENLABS_BASE_URL;
+        const ttsModelId = this.config.defaultTtsModelId ?? DEFAULT_TTS_MODEL_ID;
+        // Per-call `voice` overrides whatever's encoded in the model string.
+        // Falls back to the model-string voice id, then DEFAULT_VOICE_ID.
+        const voiceId = options.voice ?? this.modelOrVoiceId ?? DEFAULT_VOICE_ID;
+        const ourFormat = options.format ?? 'mp3';
+        const elevenFormat = elevenLabsOutputFormat(ourFormat);
+        const url = `${baseUrl}/v1/text-to-speech/${encodeURIComponent(voiceId)}?output_format=${elevenFormat}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'xi-api-key': this.config.apiKey,
+                'Content-Type': 'application/json',
+                'Accept': acceptForFormat(ourFormat),
+            },
+            body: JSON.stringify({
+                text: options.text,
+                model_id: ttsModelId,
+            }),
+        });
+        if (!response.ok) {
+            const text = await safeText(response);
+            throw new Error(`[RudderJS AI] ElevenLabs TTS failed (${response.status}): ${text}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return {
+            audio: Buffer.from(arrayBuffer),
+            format: ourFormat,
+            // Returned as the voice id the caller used — that's the load-bearing
+            // discriminator for ElevenLabs (TTS model id is a deployment knob).
+            model: voiceId,
+        };
+    }
+}
+// ─── STT Adapter ─────────────────────────────────────────
+class ElevenLabsSttAdapter {
+    config;
+    model;
+    constructor(config, model) {
+        this.config = config;
+        this.model = model;
+    }
+    async transcribe(options) {
+        const baseUrl = this.config.baseUrl ?? ELEVENLABS_BASE_URL;
+        const url = `${baseUrl}/v1/speech-to-text`;
+        // Multipart form with the audio Blob + the model id (+ optional language).
+        // ElevenLabs's only STT model today is `scribe_v1`; the field is
+        // required so we always send it.
+        const form = new FormData();
+        const audioBlob = new Blob([toUint8Array(options.audio)], { type: 'audio/mpeg' });
+        form.append('file', audioBlob, 'audio');
+        form.append('model_id', this.model);
+        if (options.language)
+            form.append('language_code', options.language);
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'xi-api-key': this.config.apiKey },
+            body: form,
+        });
+        if (!response.ok) {
+            const text = await safeText(response);
+            throw new Error(`[RudderJS AI] ElevenLabs STT failed (${response.status}): ${text}`);
+        }
+        const data = await response.json();
+        const text = typeof data.text === 'string' ? data.text : '';
+        const language = typeof data.language_code === 'string' ? data.language_code : undefined;
+        const duration = lastWordEnd(data.words);
+        const result = { text, model: this.model };
+        if (language !== undefined)
+            result.language = language;
+        if (duration !== undefined)
+            result.duration = duration;
+        return result;
+    }
+}
+// ─── Helpers ─────────────────────────────────────────────
+function elevenLabsOutputFormat(format) {
+    switch (format) {
+        case 'mp3': return 'mp3_44100_128';
+        case 'opus': return 'opus_48000_128';
+        case 'wav':
+        case 'aac':
+        case 'flac':
+            throw new Error(`[RudderJS AI] ElevenLabs TTS does not support format '${format}'. ` +
+                `Supported: 'mp3' (default), 'opus'. ` +
+                `Generate the source as mp3 and re-encode if you need ${format}, or use a provider with native ${format} support.`);
+    }
+}
+function acceptForFormat(format) {
+    switch (format) {
+        case 'mp3': return 'audio/mpeg';
+        case 'opus': return 'audio/opus';
+        // The throwing cases above never reach here, but TypeScript doesn't
+        // know — return a neutral value so the type stays satisfied.
+        default: return 'application/octet-stream';
+    }
+}
+function toUint8Array(audio) {
+    if (audio instanceof Uint8Array)
+        return audio;
+    if (audio instanceof ArrayBuffer)
+        return new Uint8Array(audio);
+    // Buffer is a Uint8Array — the typeof check above already handles it,
+    // but the function signature widens for safety.
+    return new Uint8Array(audio);
+}
+function lastWordEnd(words) {
+    if (!Array.isArray(words) || words.length === 0)
+        return undefined;
+    const last = words[words.length - 1]?.end;
+    return typeof last === 'number' ? last : undefined;
+}
+async function safeText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return '<unreadable response body>';
+    }
+}
+//# sourceMappingURL=elevenlabs.js.map

package/dist/providers/elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.js","sourceRoot":"","sources":["../../src/providers/elevenlabs.ts"],"names":[],"mappings":"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"}

package/dist/providers/google.d.ts

@@ -1,4 +1,5 @@
-import type { ProviderFactory, ProviderAdapter, ProviderRequestOptions, ProviderResponse, StreamChunk, EmbeddingAdapter, ImageGenerationAdapter, FileAdapter } from '../types.js';
+import type { ProviderFactory, ProviderAdapter, ProviderRequestOptions, ProviderResponse, StreamChunk, EmbeddingAdapter, ImageGenerationAdapter, FileAdapter, VectorStoreAdapter, VectorStoreInfo, VectorStoreFileInfo } from '../types.js';
+import type { FileSearchFilter } from '../file-search.js';
 import { GoogleCacheRegistry } from './google-cache-registry.js';
 export interface GoogleConfig {
     apiKey: string;
@@ -12,6 +13,7 @@ export declare class GoogleProvider implements ProviderFactory {
     createEmbedding(model: string): EmbeddingAdapter;
     createImage(model: string): ImageGenerationAdapter;
     createFiles(): FileAdapter;
+    createVectorStores(): VectorStoreAdapter;
 }
 export declare class GoogleAdapter implements ProviderAdapter {
     private readonly config;
@@ -30,4 +32,84 @@ export declare class GoogleAdapter implements ProviderAdapter {
     generate(options: ProviderRequestOptions): Promise<ProviderResponse>;
     stream(options: ProviderRequestOptions): AsyncIterable<StreamChunk>;
 }
+/**
+ * Translate a typed `FileSearchFilter` (OpenAI-shaped) into Gemini's
+ * `metadataFilter` string syntax (#B8.5).
+ *
+ * - `{ type: 'eq',  key, value }` → `key = value`
+ * - `{ type: 'ne',  key, value }` → `key != value`
+ * - `{ type: 'gt',  key, value }` → `key > value`
+ * - `{ type: 'gte', key, value }` → `key >= value`
+ * - `{ type: 'lt',  key, value }` → `key < value`
+ * - `{ type: 'lte', key, value }` → `key <= value`
+ * - `{ type: 'and', filters }`    → `(f1) AND (f2) AND ...`
+ * - `{ type: 'or',  filters }`    → `(f1) OR (f2) OR ...`
+ *
+ * String values are wrapped in double quotes with `"` and `\` escaped.
+ * Numbers and booleans render bare.
+ *
+ * Exported for unit testing — see `google-vector-stores.test.ts`.
+ *
+ * @internal
+ */
+export declare function filterToGeminiString(filter: FileSearchFilter): string;
+/**
+ * Map a Gemini `FileSearchStore` resource into the framework's
+ * `VectorStoreInfo` shape. `displayNameOverride` lets `create()` populate
+ * the human-friendly name from the user-supplied value when the API
+ * response omits it (some response variants do).
+ *
+ * @internal
+ */
+export declare function fromGeminiFileSearchStore(raw: unknown, displayNameOverride?: string): VectorStoreInfo;
+/**
+ * Map a Gemini `Document` resource into the framework's
+ * `VectorStoreFileInfo` shape. `DocumentState` enum values flatten to the
+ * shared `'in_progress' | 'completed' | 'failed' | 'cancelled'` union.
+ *
+ * @internal
+ */
+export declare function fromGeminiDocument(raw: unknown, storeId: string): VectorStoreFileInfo;
+/**
+ * Convert the framework's flat attribute map to Gemini's `CustomMetadata`
+ * array shape. Strings → `stringValue`, numbers → `numericValue`,
+ * booleans → `stringValue: 'true' | 'false'` (Gemini has no boolean
+ * variant — string is the safe lossless choice; filter-builders can
+ * still match on `key = "true"`).
+ *
+ * @internal
+ */
+export declare function attributesToCustomMetadata(attrs: Record<string, string | number | boolean>): Array<{
+    key: string;
+    stringValue?: string;
+    numericValue?: number;
+}>;
+/**
+ * Inverse of {@link attributesToCustomMetadata}. Drops `stringListValue`
+ * variants (no flat-attribute representation; apps that need lists
+ * should read the raw Document via the SDK).
+ *
+ * @internal
+ */
+export declare function customMetadataToAttributes(metadata: Array<{
+    key?: string;
+    stringValue?: string;
+    numericValue?: number;
+    stringListValue?: {
+        values?: string[];
+    };
+}>): Record<string, string | number | boolean>;
+/**
+ * Best-effort MIME type from a filename extension. Gemini's
+ * `uploadToFileSearchStore` requires a mimeType on Blob uploads (it
+ * reads `blob.type`, which is empty on untyped `new Blob([data])`).
+ *
+ * Coverage matches Gemini's supported FileSearchStore document formats.
+ * Unknown extensions return `''` — the caller drops the field so the
+ * Gemini SDK's own error fires loudly rather than silently picking a
+ * wrong type.
+ *
+ * @internal
+ */
+export declare function mimeTypeFromFilename(filename: string): string;
 //# sourceMappingURL=google.d.ts.map

package/dist/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EAKX,gBAAgB,EAEhB,sBAAsB,EAGtB,WAAW,EAIZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,mBAAmB,EAKpB,MAAM,4BAA4B,CAAA;AAEnC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,YAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAqB;gBAExC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,mBAAmB;IAKrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAItC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAIhD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAIlD,WAAW,IAAI,WAAW;CAG3B;AAID,qBAAa,aAAc,YAAW,eAAe;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IALjC,OAAO,CAAC,MAAM,CAAY;gBAGP,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,mBAAmB,GAAG,SAAS;YAGpD,SAAS;IAQvB;;;;;OAKG;YACW,YAAY;IA0DpB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBnE,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAAC,WAAW,CAAC;CAkD3E"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EAKX,gBAAgB,EAEhB,sBAAsB,EAGtB,WAAW,EAIX,kBAAkB,EAElB,eAAe,EACf,mBAAmB,EAKpB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EACL,mBAAmB,EAKpB,MAAM,4BAA4B,CAAA;AAEnC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,YAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAqB;gBAExC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,mBAAmB;IAKrE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAItC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAIhD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAIlD,WAAW,IAAI,WAAW;IAI1B,kBAAkB,IAAI,kBAAkB;CAGzC;AAID,qBAAa,aAAc,YAAW,eAAe;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IALjC,OAAO,CAAC,MAAM,CAAY;gBAGP,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,mBAAmB,GAAG,SAAS;YAGpD,SAAS;IAQvB;;;;;OAKG;YACW,YAAY;IA4DpB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBnE,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAAC,WAAW,CAAC;CAkD3E;AAwHD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAsBrE;AA0cD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,eAAe,CAuBrG;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAuBrF;AAWD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAC/C,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAMrE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,KAAK,CAAC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC,GACtH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAc3C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoB7D"}