@framers/agentos 0.1.119 → 0.1.121

package/dist/core/llm/providers/implementations/GeminiCLIProvider.js

@@ -0,0 +1,447 @@
+/**
+ * @fileoverview IProvider implementation that invokes the Gemini CLI
+ * as a subprocess, allowing users to leverage their Google account
+ * (free / AI Pro / AI Ultra) without an API key. Completely separate
+ * from the `gemini` provider (which uses GEMINI_API_KEY).
+ *
+ * @module agentos/core/llm/providers/implementations/GeminiCLIProvider
+ * @see GeminiCLIBridge
+ */
+import { GeminiCLIBridge } from './GeminiCLIBridge.js';
+import { GeminiCLIProviderError } from '../errors/GeminiCLIProviderError.js';
+/* ------------------------------------------------------------------ */
+/*  Static model catalog                                               */
+/* ------------------------------------------------------------------ */
+const GEMINI_CLI_MODELS = [
+    {
+        modelId: 'gemini-2.5-pro',
+        providerId: 'gemini-cli',
+        displayName: 'Gemini 2.5 Pro',
+        description: 'Most capable Gemini model — deep reasoning and analysis',
+        capabilities: ['chat', 'vision_input', 'tool_use'],
+        contextWindowSize: 1000000,
+        inputTokenLimit: 1000000,
+        outputTokenLimit: 65536,
+        pricePer1MTokensInput: 0,
+        pricePer1MTokensOutput: 0,
+        supportsStreaming: true,
+        isDefaultModel: false,
+    },
+    {
+        modelId: 'gemini-2.5-flash',
+        providerId: 'gemini-cli',
+        displayName: 'Gemini 2.5 Flash',
+        description: 'Fast and capable — ideal for most tasks',
+        capabilities: ['chat', 'vision_input', 'tool_use'],
+        contextWindowSize: 1000000,
+        inputTokenLimit: 1000000,
+        outputTokenLimit: 65536,
+        pricePer1MTokensInput: 0,
+        pricePer1MTokensOutput: 0,
+        supportsStreaming: true,
+        isDefaultModel: true,
+    },
+    {
+        modelId: 'gemini-2.0-flash',
+        providerId: 'gemini-cli',
+        displayName: 'Gemini 2.0 Flash',
+        description: 'Previous-gen fast model with 1M context',
+        capabilities: ['chat', 'vision_input', 'tool_use'],
+        contextWindowSize: 1000000,
+        inputTokenLimit: 1000000,
+        outputTokenLimit: 8192,
+        pricePer1MTokensInput: 0,
+        pricePer1MTokensOutput: 0,
+        supportsStreaming: true,
+        isDefaultModel: false,
+    },
+    {
+        modelId: 'gemini-2.0-flash-lite',
+        providerId: 'gemini-cli',
+        displayName: 'Gemini 2.0 Flash Lite',
+        description: 'Lightest Gemini model — high throughput, low latency',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 1000000,
+        inputTokenLimit: 1000000,
+        outputTokenLimit: 8192,
+        pricePer1MTokensInput: 0,
+        pricePer1MTokensOutput: 0,
+        supportsStreaming: true,
+        isDefaultModel: false,
+    },
+];
+/* ------------------------------------------------------------------ */
+/*  Tool call XML parsing                                              */
+/* ------------------------------------------------------------------ */
+/** Regex to extract tool_call blocks from Gemini's text response. */
+const TOOL_CALL_REGEX = /<tool_call\s+id="([^"]+)"\s+name="([^"]+)">([\s\S]*?)<\/tool_call>/g;
+/** Parse tool calls from raw text containing XML markers. */
+function parseToolCallsFromText(text) {
+    const calls = [];
+    let match;
+    /* Reset regex state */
+    TOOL_CALL_REGEX.lastIndex = 0;
+    while ((match = TOOL_CALL_REGEX.exec(text)) !== null) {
+        try {
+            const args = JSON.parse(match[3].trim());
+            calls.push({ id: match[1], name: match[2], arguments: args });
+        }
+        catch {
+            /* Malformed JSON in tool call — skip this one */
+        }
+    }
+    return calls.length > 0 ? calls : null;
+}
+/* ------------------------------------------------------------------ */
+/*  Provider                                                           */
+/* ------------------------------------------------------------------ */
+/**
+ * LLM provider that wraps the locally-installed Gemini CLI.
+ * Users authenticate Gemini separately (via `gemini` in terminal);
+ * this provider detects that installation and uses it for completions.
+ *
+ * No API key required — the user's Google account handles access.
+ * `costUSD` is always 0 since there is no per-token charge.
+ */
+export class GeminiCLIProvider {
+    constructor() {
+        this.providerId = 'gemini-cli';
+        this.isInitialized = false;
+        this.bridge = new GeminiCLIBridge();
+    }
+    /* ---- Lifecycle ------------------------------------------------- */
+    async initialize(config) {
+        this.config = {
+            defaultModelId: 'gemini-2.5-flash',
+            requestTimeout: 120000,
+            ...config,
+        };
+        this.defaultModelId = this.config.defaultModelId;
+        const installCheck = await this.bridge.checkBinaryInstalled();
+        if (!installCheck.installed) {
+            throw new GeminiCLIProviderError('Gemini CLI is not installed.', 'BINARY_NOT_FOUND', 'Install Gemini CLI: npm install -g @google/gemini-cli\n\nThen log in by running "gemini" in your terminal.\n\nAlternatively, switch to a different provider:\n  wunderland login', false);
+        }
+        const isAuth = await this.bridge.checkAuthenticated();
+        if (!isAuth) {
+            throw new GeminiCLIProviderError('Gemini CLI is installed but not logged in.', 'NOT_AUTHENTICATED', 'Open your terminal and run:\n  gemini\n\nComplete the Google account login flow, then restart your agent.', false);
+        }
+        this.isInitialized = true;
+    }
+    async shutdown() {
+        this.isInitialized = false;
+    }
+    /* ---- Completions ---------------------------------------------- */
+    async generateCompletion(modelId, messages, options) {
+        this.ensureInitialized();
+        const hasTools = options.tools && options.tools.length > 0 && options.toolChoice !== 'none';
+        const { systemPrompt, conversationPrompt } = this.formatMessages(messages);
+        const fullSystemPrompt = hasTools
+            ? this.injectToolSchemas(systemPrompt, options.tools, options.toolChoice)
+            : systemPrompt;
+        const bridgeOpts = {
+            prompt: conversationPrompt,
+            systemPrompt: fullSystemPrompt || undefined,
+            model: modelId,
+            timeout: this.config.requestTimeout,
+            abortSignal: options.abortSignal,
+        };
+        const result = await this.bridge.executeWithSystemPrompt(bridgeOpts);
+        if (result.isError) {
+            throw new GeminiCLIProviderError(`Gemini CLI returned an error: ${result.result}`, 'CRASHED', 'Try running "gemini -p test" manually to diagnose.', true);
+        }
+        /* Try parsing tool calls from XML markers */
+        if (hasTools) {
+            const toolCalls = parseToolCallsFromText(result.result);
+            if (toolCalls) {
+                return this.buildToolCallResponse(toolCalls, result, undefined, undefined, modelId);
+            }
+            /* No tool calls found — check if it's a text response or parse failure */
+            /* If text contains partial XML, retry without tools */
+            if (result.result.includes('<tool_call') && !result.result.includes('</tool_call>')) {
+                const retryOpts = { ...bridgeOpts, systemPrompt: systemPrompt || undefined };
+                const retryResult = await this.bridge.executeWithSystemPrompt(retryOpts);
+                return this.buildTextResponse(retryResult.result, retryResult, undefined, undefined, modelId);
+            }
+        }
+        return this.buildTextResponse(result.result, result, undefined, undefined, modelId);
+    }
+    async *generateCompletionStream(modelId, messages, options) {
+        this.ensureInitialized();
+        const hasTools = options.tools && options.tools.length > 0 && options.toolChoice !== 'none';
+        const { systemPrompt, conversationPrompt } = this.formatMessages(messages);
+        const fullSystemPrompt = hasTools
+            ? this.injectToolSchemas(systemPrompt, options.tools, options.toolChoice)
+            : systemPrompt;
+        const bridgeOpts = {
+            prompt: conversationPrompt,
+            systemPrompt: fullSystemPrompt || undefined,
+            model: modelId,
+            timeout: this.config.requestTimeout,
+            abortSignal: options.abortSignal,
+        };
+        let accumulatedText = '';
+        const responseId = `gc-${Date.now()}`;
+        let finalUsage;
+        let emittedFinal = false;
+        try {
+            for await (const event of this.bridge.streamWithSystemPrompt(bridgeOpts)) {
+                switch (event.type) {
+                    case 'text_delta':
+                        accumulatedText += event.text;
+                        yield {
+                            id: responseId,
+                            object: 'chat.completion.chunk',
+                            created: Date.now(),
+                            modelId,
+                            choices: [{
+                                    index: 0,
+                                    message: { role: 'assistant', content: accumulatedText },
+                                    finishReason: null,
+                                }],
+                            responseTextDelta: event.text,
+                            isFinal: false,
+                        };
+                        break;
+                    case 'result': {
+                        const usage = event.usage;
+                        finalUsage = usage
+                            ? { promptTokens: usage.input_tokens, completionTokens: usage.output_tokens, totalTokens: usage.input_tokens + usage.output_tokens, costUSD: 0 }
+                            : { totalTokens: 0, costUSD: 0 };
+                        const finalText = event.result || accumulatedText;
+                        /* Try parsing tool calls from final text */
+                        if (hasTools) {
+                            const toolCalls = parseToolCallsFromText(finalText);
+                            if (toolCalls) {
+                                emittedFinal = true;
+                                yield this.buildToolCallResponse(toolCalls, { sessionId: event.sessionId, usage: event.usage }, responseId, finalUsage, modelId);
+                                return;
+                            }
+                        }
+                        emittedFinal = true;
+                        yield this.buildTextResponse(finalText, { sessionId: event.sessionId, usage: event.usage }, responseId, finalUsage, modelId);
+                        return;
+                    }
+                    case 'error':
+                        emittedFinal = true;
+                        yield this.buildStreamErrorResponse(`Gemini CLI stream error: ${event.error}`, modelId, responseId, finalUsage);
+                        return;
+                }
+            }
+        }
+        catch (error) {
+            emittedFinal = true;
+            yield this.buildStreamErrorResponse(error?.message ?? 'Gemini CLI stream failed.', modelId, responseId, finalUsage, error?.code, error);
+            return;
+        }
+        if (!emittedFinal) {
+            yield this.buildTextResponse(accumulatedText, {}, responseId, finalUsage, modelId);
+        }
+    }
+    /* ---- Embeddings (not supported) -------------------------------- */
+    async generateEmbeddings(_modelId, _texts, _options) {
+        throw new GeminiCLIProviderError('Gemini CLI does not support embeddings. Use a different provider (OpenAI, Ollama, etc.) for embedding operations.', 'EMBEDDINGS_NOT_SUPPORTED', 'Configure an additional provider with embedding support: wunderland login', false);
+    }
+    /* ---- Model catalog -------------------------------------------- */
+    async listAvailableModels() {
+        return [...GEMINI_CLI_MODELS];
+    }
+    async getModelInfo(modelId) {
+        return GEMINI_CLI_MODELS.find(m => m.modelId === modelId);
+    }
+    /* ---- Health check --------------------------------------------- */
+    async checkHealth() {
+        const installCheck = await this.bridge.checkBinaryInstalled();
+        if (!installCheck.installed) {
+            return {
+                isHealthy: false,
+                details: {
+                    cliInstalled: false,
+                    error: 'BINARY_NOT_FOUND',
+                    guidance: 'Install Gemini CLI: npm install -g @google/gemini-cli',
+                },
+            };
+        }
+        const isAuth = await this.bridge.checkAuthenticated();
+        return {
+            isHealthy: isAuth,
+            details: {
+                cliInstalled: true,
+                cliVersion: installCheck.version,
+                cliPath: installCheck.binaryPath,
+                authenticated: isAuth,
+                ...(isAuth ? {} : {
+                    error: 'NOT_AUTHENTICATED',
+                    guidance: 'Run "gemini" in your terminal to log in with your Google account.',
+                }),
+            },
+        };
+    }
+    /* ---- Private: message formatting ------------------------------ */
+    formatMessages(messages) {
+        let systemPrompt = '';
+        const nonSystemMessages = [];
+        for (const msg of messages) {
+            if (msg.role === 'system') {
+                systemPrompt += (typeof msg.content === 'string' ? msg.content : this.contentPartsToText(msg.content)) + '\n';
+            }
+            else {
+                nonSystemMessages.push(msg);
+            }
+        }
+        const conversationPrompt = this.serializeConversationXml(nonSystemMessages);
+        return { systemPrompt: systemPrompt.trim(), conversationPrompt };
+    }
+    serializeConversationXml(messages) {
+        if (messages.length === 0)
+            return '';
+        if (messages.length === 1 && messages[0].role === 'user') {
+            return typeof messages[0].content === 'string'
+                ? messages[0].content
+                : this.contentPartsToText(messages[0].content);
+        }
+        const lines = ['<conversation>'];
+        for (const msg of messages) {
+            const content = typeof msg.content === 'string'
+                ? msg.content
+                : this.contentPartsToText(msg.content);
+            if (msg.role === 'tool') {
+                lines.push(`<message role="tool" tool_call_id="${msg.tool_call_id ?? ''}">${content}</message>`);
+            }
+            else if (msg.role === 'assistant' && msg.tool_calls?.length) {
+                const toolCallXml = msg.tool_calls.map(tc => `<tool_call name="${tc.function.name}">${tc.function.arguments}</tool_call>`).join('');
+                lines.push(`<message role="assistant">${toolCallXml}</message>`);
+            }
+            else {
+                lines.push(`<message role="${msg.role}">${content}</message>`);
+            }
+        }
+        lines.push('</conversation>');
+        return lines.join('\n');
+    }
+    contentPartsToText(content) {
+        if (!content)
+            return '';
+        if (typeof content === 'string')
+            return content;
+        if (Array.isArray(content)) {
+            return content
+                .filter((p) => p.type === 'text')
+                .map((p) => p.text)
+                .join('');
+        }
+        return String(content);
+    }
+    /* ---- Private: tool schema injection --------------------------- */
+    injectToolSchemas(systemPrompt, tools, toolChoice) {
+        const toolsXml = tools.map(t => {
+            const fn = t.function ?? t;
+            return `<tool name="${fn.name}" description="${fn.description ?? ''}">\n  <parameters>${JSON.stringify(fn.parameters ?? {})}</parameters>\n</tool>`;
+        }).join('\n');
+        const choiceInstruction = this.toolChoiceInstruction(toolChoice);
+        return `${systemPrompt}
+
+<available_tools>
+${toolsXml}
+</available_tools>
+
+<response_format>
+${choiceInstruction}
+When you want to call a tool, respond with XML:
+<tool_call id="unique-id" name="tool_name">{"arg": "value"}</tool_call>
+When responding with text, respond normally without XML tags.
+You may include multiple tool_call blocks in one response.
+Each tool_call must include id (unique string), name (tool name), and a JSON body matching the tool's parameters schema.
+</response_format>`;
+    }
+    toolChoiceInstruction(toolChoice) {
+        if (!toolChoice || toolChoice === 'auto') {
+            return 'Use tools if helpful to answer the user, otherwise respond with text.';
+        }
+        if (toolChoice === 'required') {
+            return 'You MUST call at least one tool. Do not respond with text only.';
+        }
+        if (toolChoice === 'none') {
+            return 'Do not use any tools. Respond with text only.';
+        }
+        if (typeof toolChoice === 'object' && toolChoice.function?.name) {
+            return `You MUST call the tool named "${toolChoice.function.name}".`;
+        }
+        return 'Use tools if helpful to answer the user, otherwise respond with text.';
+    }
+    /* ---- Private: response builders ------------------------------- */
+    buildTextResponse(text, result, responseId, usage, modelId) {
+        const u = usage ?? this.buildUsage(result.usage);
+        return {
+            id: responseId ?? `gc-${result.sessionId ?? Date.now()}`,
+            object: 'chat.completion',
+            created: Date.now(),
+            modelId: modelId ?? this.defaultModelId ?? 'gemini-2.5-flash',
+            choices: [{
+                    index: 0,
+                    message: { role: 'assistant', content: text },
+                    finishReason: 'stop',
+                }],
+            usage: u,
+            isFinal: true,
+        };
+    }
+    buildToolCallResponse(toolCalls, result, responseId, usage, modelId) {
+        const u = usage ?? this.buildUsage(result.usage);
+        return {
+            id: responseId ?? `gc-${result.sessionId ?? Date.now()}`,
+            object: 'chat.completion',
+            created: Date.now(),
+            modelId: modelId ?? this.defaultModelId ?? 'gemini-2.5-flash',
+            choices: [{
+                    index: 0,
+                    message: {
+                        role: 'assistant',
+                        content: null,
+                        tool_calls: toolCalls.map(tc => ({
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: typeof tc.arguments === 'string' ? tc.arguments : JSON.stringify(tc.arguments),
+                            },
+                        })),
+                    },
+                    finishReason: 'tool_calls',
+                }],
+            usage: u,
+            isFinal: true,
+        };
+    }
+    buildStreamErrorResponse(message, modelId, responseId, usage, code, details) {
+        return {
+            id: responseId,
+            object: 'chat.completion.chunk',
+            created: Date.now(),
+            modelId,
+            choices: [],
+            usage,
+            error: {
+                message,
+                ...(code === undefined ? {} : { code }),
+                ...(details === undefined ? {} : { details }),
+            },
+            isFinal: true,
+        };
+    }
+    buildUsage(raw) {
+        if (!raw)
+            return { totalTokens: 0, costUSD: 0 };
+        return {
+            promptTokens: raw.input_tokens,
+            completionTokens: raw.output_tokens,
+            totalTokens: raw.input_tokens + raw.output_tokens,
+            costUSD: 0,
+        };
+    }
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new GeminiCLIProviderError('GeminiCLIProvider is not initialized. Call initialize() first.', 'UNKNOWN', 'Ensure the provider is initialized before making API calls.', false);
+        }
+    }
+}
+//# sourceMappingURL=GeminiCLIProvider.js.map

package/dist/core/llm/providers/implementations/GeminiCLIProvider.js.map

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

package/dist/core/media/ProviderPreferences.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @file ProviderPreferences.ts
+ * Shared resolver for media provider selection across image, video, and audio
+ * subsystems.
+ *
+ * Provides two complementary mechanisms:
+ *
+ * 1. **Deterministic ordering** via {@link resolveProviderOrder} — filters and
+ *    reorders an "available" list according to user preferences (preferred
+ *    providers first, blocked providers removed).
+ *
+ * 2. **Weighted random selection** via {@link selectWeightedProvider} — picks a
+ *    single provider from a resolved list using optional per-provider weights
+ *    (useful for load-balancing or A/B testing across providers).
+ *
+ * These utilities are intentionally stateless and side-effect-free so they can
+ * be called from any subsystem without lifecycle concerns.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   resolveProviderOrder,
+ *   resolveProviderChain,
+ *   selectWeightedProvider,
+ * } from './ProviderPreferences.js';
+ *
+ * const available = ['openai', 'stability', 'replicate'];
+ *
+ * // Deterministic: preferred order with blocklist
+ * const ordered = resolveProviderOrder(available, {
+ *   preferred: ['replicate', 'openai'],
+ *   blocked: ['stability'],
+ * });
+ * // => ['replicate', 'openai']
+ *
+ * // Weighted primary selection with deterministic fallback ordering
+ * const chain = resolveProviderChain(ordered, {
+ *   weights: {
+ *     replicate: 9,
+ *     openai: 1,
+ *   },
+ * });
+ * // => ['replicate', 'openai'] most of the time
+ *
+ * // Or pick a single weighted provider directly
+ * const chosen = selectWeightedProvider(chain, {
+ *   replicate: 9,
+ *   openai: 1,
+ * });
+ * ```
+ */
+/**
+ * Per-modality provider preference configuration.
+ *
+ * - `preferred` — Ordered list of provider IDs to try first. Providers not in
+ *   this list are excluded. When omitted the full available list is used.
+ * - `weights` — Optional weight map for weighted random selection. Providers
+ *   not listed default to weight `1`.
+ * - `blocked` — Provider IDs to unconditionally exclude. Applied after the
+ *   preferred filter so a provider can be both preferred *and* blocked (the
+ *   block wins).
+ */
+export interface MediaProviderPreference {
+    /** Ordered list of preferred provider IDs. */
+    preferred?: string[];
+    /** Weight map for weighted random selection (default weight is `1`). */
+    weights?: Record<string, number>;
+    /** Provider IDs to unconditionally exclude. */
+    blocked?: string[];
+}
+/**
+ * Top-level provider preferences grouped by media modality.
+ *
+ * Each modality can have its own independent preference configuration.
+ * Audio is further split into `music` and `sfx` sub-modalities since
+ * music generation and sound-effect generation often use different
+ * provider backends.
+ */
+export interface ProviderPreferences {
+    /** Image generation provider preferences. */
+    image?: MediaProviderPreference;
+    /** Video generation provider preferences. */
+    video?: MediaProviderPreference;
+    /** Audio generation provider preferences, split by sub-modality. */
+    audio?: {
+        /** Music generation provider preferences. */
+        music?: MediaProviderPreference;
+        /** Sound-effect generation provider preferences. */
+        sfx?: MediaProviderPreference;
+    };
+}
+/**
+ * Filter and reorder an "available" provider list according to user
+ * preferences.
+ *
+ * Resolution rules (applied in order):
+ *
+ * 1. If `preferences` is `undefined` or empty, return `available` unchanged.
+ * 2. If `preferred` is set, keep only providers that appear in **both**
+ *    `available` and `preferred`, preserving the order of `preferred`.
+ * 3. If `blocked` is set, remove any provider whose ID appears in `blocked`.
+ *
+ * The result is never longer than `available` and never contains duplicates.
+ *
+ * @param available - Provider IDs currently available in the system.
+ * @param preferences - Optional preference configuration.
+ * @returns Filtered and reordered provider ID list.
+ *
+ * @example
+ * ```ts
+ * resolveProviderOrder(['a', 'b', 'c'], { preferred: ['c', 'a'] });
+ * // => ['c', 'a']
+ *
+ * resolveProviderOrder(['a', 'b', 'c'], { blocked: ['b'] });
+ * // => ['a', 'c']
+ * ```
+ */
+export declare function resolveProviderOrder(available: string[], preferences?: MediaProviderPreference): string[];
+/**
+ * Resolve a full provider chain from the available providers and preferences.
+ *
+ * This combines deterministic filtering/reordering via
+ * {@link resolveProviderOrder} with optional weighted primary selection via
+ * {@link selectWeightedProvider}. When `weights` are present, a single primary
+ * provider is chosen from the ordered list and moved to the front while the
+ * remaining providers preserve their relative order as fallbacks.
+ *
+ * @param available - Provider IDs currently available in the system.
+ * @param preferences - Optional preference configuration.
+ * @returns Ordered provider chain with the chosen primary first.
+ */
+export declare function resolveProviderChain(available: string[], preferences?: MediaProviderPreference): string[];
+/**
+ * Select a single provider from a list using optional per-provider weights.
+ *
+ * Selection rules:
+ *
+ * - If `providers` is empty, throws an `Error`.
+ * - If `weights` is `undefined` or `providers` has exactly one entry, the
+ *   first provider is returned deterministically.
+ * - Otherwise a weighted random selection is performed: each provider's
+ *   weight is looked up in `weights` (defaulting to `1` for unlisted
+ *   providers), weights are summed, and a random value in `[0, sum)` picks
+ *   the winner proportionally.
+ *
+ * @param providers - Non-empty list of provider IDs to choose from.
+ * @param weights - Optional weight map. Providers not listed get weight `1`.
+ * @returns The selected provider ID.
+ * @throws {Error} When `providers` is empty.
+ *
+ * @example
+ * ```ts
+ * // 90% suno, 10% udio (approximately)
+ * selectWeightedProvider(['suno', 'udio'], { suno: 9, udio: 1 });
+ * ```
+ */
+export declare function selectWeightedProvider(providers: string[], weights?: Record<string, number>): string;
+//# sourceMappingURL=ProviderPreferences.d.ts.map

package/dist/core/media/ProviderPreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderPreferences.d.ts","sourceRoot":"","sources":["../../../src/core/media/ProviderPreferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;IAChC,oEAAoE;IACpE,KAAK,CAAC,EAAE;QACN,6CAA6C;QAC7C,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,oDAAoD;QACpD,GAAG,CAAC,EAAE,uBAAuB,CAAC;KAC/B,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,CAAC,EAAE,uBAAuB,GACpC,MAAM,EAAE,CAuBV;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,CAAC,EAAE,uBAAuB,GACpC,MAAM,EAAE,CAQV;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAqCR"}