mcp-agent-foundry 1.0.0

package/dist/providers/gemini.js

@@ -0,0 +1,414 @@
+/**
+ * Google Gemini Provider Implementation
+ *
+ * Provider adapter for the Google Gemini API (Generative Language API).
+ * Handles message formatting, streaming, and tool use for Gemini models.
+ *
+ * Key differences from Anthropic format:
+ * - Messages use "contents" array with "parts" instead of "content"
+ * - System prompt is a separate "systemInstruction" field
+ * - Tool schemas use "parameters" (OpenAI style) in function declarations
+ * - Tool calls return "functionCall" parts, results use "functionResponse" parts
+ * - Auth via API key query param or Authorization header
+ */
+import { BaseProvider } from './base.js';
+// ============================================================================
+// Gemini Provider Implementation
+// ============================================================================
+/**
+ * Google Gemini API provider adapter.
+ *
+ * Implements the Provider interface for Google's Gemini models.
+ * Handles:
+ * - Message format translation (our format -> Gemini format)
+ * - Streaming SSE event parsing
+ * - Tool use / function calling
+ * - Authentication via API key
+ */
+export class GeminiProvider extends BaseProvider {
+    name = 'google';
+    static DEFAULT_BASE_URL = 'https://generativelanguage.googleapis.com/v1beta';
+    /** Default max tokens if not specified in request */
+    static DEFAULT_MAX_TOKENS = 4096;
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Build the full API URL with model and action.
+     * Gemini uses URL path for model selection and action.
+     *
+     * @param model - Model identifier
+     * @param action - API action (generateContent, streamGenerateContent)
+     * @returns Full API URL
+     */
+    buildUrl(model, action) {
+        const baseUrl = this.getBaseUrl(GeminiProvider.DEFAULT_BASE_URL);
+        const url = `${baseUrl}/models/${model}:${action}`;
+        // Gemini supports API key as query parameter
+        if (this.config.api_key) {
+            return `${url}?key=${this.config.api_key}`;
+        }
+        return url;
+    }
+    /**
+     * Build headers for Gemini API requests.
+     * Uses Bearer token if API key is provided (alternative to query param).
+     */
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Gemini also supports Authorization header (alternative to query param)
+        // We use query param by default, but support Bearer if explicitly configured
+        if (this.config.headers?.['Authorization']) {
+            headers['Authorization'] = this.config.headers['Authorization'];
+        }
+        // Add any custom headers from config
+        if (this.config.headers) {
+            Object.assign(headers, this.config.headers);
+        }
+        return headers;
+    }
+    /**
+     * Execute a completion request and return the full response.
+     */
+    async complete(request) {
+        const url = this.buildUrl(request.model, 'generateContent');
+        const geminiRequest = this.translateRequest(request);
+        const response = await this.makeRequest({
+            method: 'POST',
+            url,
+            headers: this.buildHeaders(),
+            body: geminiRequest,
+            timeoutMs: request.timeout_ms ?? this.defaultTimeoutMs,
+        });
+        return this.translateResponse(response, request.model);
+    }
+    /**
+     * Execute a streaming completion request.
+     */
+    async *completeStream(request) {
+        // Gemini uses streamGenerateContent endpoint with alt=sse query param
+        let url = this.buildUrl(request.model, 'streamGenerateContent');
+        // Add alt=sse for server-sent events format
+        url += url.includes('?') ? '&alt=sse' : '?alt=sse';
+        const geminiRequest = this.translateRequest(request);
+        const response = await this.makeStreamingRequest({
+            method: 'POST',
+            url,
+            headers: this.buildHeaders(),
+            body: geminiRequest,
+            timeoutMs: request.timeout_ms ?? this.defaultTimeoutMs,
+            stream: true,
+        });
+        if (!response.body) {
+            throw new Error('No response body for streaming request');
+        }
+        // Track state for content block management
+        let hasStartedContent = false;
+        let currentToolCallIndex = 0;
+        const activeToolCalls = new Map();
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // Process complete SSE events
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed === 'data: [DONE]') {
+                        continue;
+                    }
+                    if (trimmed.startsWith('data: ')) {
+                        const jsonStr = trimmed.slice(6);
+                        try {
+                            const chunk = JSON.parse(jsonStr);
+                            const chunks = this.translateStreamChunk(chunk, hasStartedContent, currentToolCallIndex, activeToolCalls);
+                            for (const streamChunk of chunks) {
+                                // Track state for content block management
+                                if (streamChunk.type === 'content_block_start' &&
+                                    streamChunk.content_block?.type === 'text') {
+                                    hasStartedContent = true;
+                                }
+                                if (streamChunk.type === 'content_block_start' &&
+                                    streamChunk.content_block?.type === 'tool_use') {
+                                    currentToolCallIndex++;
+                                }
+                                yield streamChunk;
+                            }
+                        }
+                        catch {
+                            // Skip malformed JSON chunks
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        // Emit message_stop at the end
+        yield { type: 'message_stop' };
+    }
+    /**
+     * Check if the Gemini API is available and credentials are valid.
+     */
+    async healthCheck() {
+        // List models endpoint to verify API key
+        const baseUrl = this.getBaseUrl(GeminiProvider.DEFAULT_BASE_URL);
+        let url = `${baseUrl}/models`;
+        if (this.config.api_key) {
+            url += `?key=${this.config.api_key}`;
+        }
+        await this.makeRequest({
+            method: 'GET',
+            url,
+            headers: this.buildHeaders(),
+            timeoutMs: 10000,
+        });
+    }
+    // ==========================================================================
+    // Translation Methods
+    // ==========================================================================
+    /**
+     * Translate AgentRouter request to Gemini format.
+     */
+    translateRequest(request) {
+        const geminiRequest = {
+            contents: this.translateMessages(request.messages),
+        };
+        // Add generation config if any options specified
+        const generationConfig = {};
+        if (request.temperature !== undefined) {
+            generationConfig.temperature = request.temperature;
+        }
+        if (request.max_tokens !== undefined) {
+            generationConfig.maxOutputTokens = request.max_tokens;
+        }
+        else {
+            generationConfig.maxOutputTokens = GeminiProvider.DEFAULT_MAX_TOKENS;
+        }
+        if (Object.keys(generationConfig).length > 0) {
+            geminiRequest.generationConfig = generationConfig;
+        }
+        // Translate tools if present
+        if (request.tools && request.tools.length > 0) {
+            geminiRequest.tools = [
+                {
+                    functionDeclarations: this.translateTools(request.tools),
+                },
+            ];
+        }
+        return geminiRequest;
+    }
+    /**
+     * Translate messages from AgentRouter format to Gemini format.
+     *
+     * Key translations:
+     * - role: "user" -> "user", role: "assistant" -> "model"
+     * - Content blocks become parts
+     * - tool_use blocks become functionCall parts
+     * - tool_result blocks become functionResponse parts
+     */
+    translateMessages(messages) {
+        const geminiContents = [];
+        for (const message of messages) {
+            const role = message.role === 'assistant' ? 'model' : 'user';
+            const parts = [];
+            if (typeof message.content === 'string') {
+                // Simple string content
+                parts.push({ text: message.content });
+            }
+            else {
+                // Content blocks - translate each type
+                for (const block of message.content) {
+                    switch (block.type) {
+                        case 'text':
+                            if (block.text) {
+                                parts.push({ text: block.text });
+                            }
+                            break;
+                        case 'tool_use':
+                            if (block.name) {
+                                parts.push({
+                                    functionCall: {
+                                        name: block.name,
+                                        args: block.input || {},
+                                    },
+                                });
+                            }
+                            break;
+                        case 'tool_result':
+                            if (block.tool_use_id && block.content) {
+                                // Gemini expects function name, not ID
+                                // We need to track tool calls to map IDs to names
+                                // For now, use the ID as name (caller should ensure consistency)
+                                parts.push({
+                                    functionResponse: {
+                                        name: block.tool_use_id,
+                                        response: {
+                                            content: block.content,
+                                        },
+                                    },
+                                });
+                            }
+                            break;
+                    }
+                }
+            }
+            if (parts.length > 0) {
+                geminiContents.push({ role, parts });
+            }
+        }
+        return geminiContents;
+    }
+    /**
+     * Translate tools from AgentRouter format to Gemini function declarations.
+     */
+    translateTools(tools) {
+        return tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.input_schema,
+        }));
+    }
+    /**
+     * Translate Gemini response to AgentRouter format.
+     */
+    translateResponse(response, model) {
+        const candidate = response.candidates?.[0];
+        if (!candidate) {
+            throw new Error('No candidates in Gemini response');
+        }
+        const content = [];
+        let toolCallCounter = 0;
+        // Translate parts to content blocks
+        for (const part of candidate.content.parts) {
+            if (part.text !== undefined) {
+                content.push({
+                    type: 'text',
+                    text: part.text,
+                });
+            }
+            if (part.functionCall) {
+                // Generate a unique ID for the tool call
+                const toolId = `call_${Date.now()}_${toolCallCounter++}`;
+                content.push({
+                    type: 'tool_use',
+                    id: toolId,
+                    name: part.functionCall.name,
+                    input: part.functionCall.args,
+                });
+            }
+        }
+        // Map Gemini finish reason to AgentRouter stop_reason
+        let stopReason = 'end_turn';
+        switch (candidate.finishReason) {
+            case 'STOP':
+                stopReason = 'end_turn';
+                break;
+            case 'MAX_TOKENS':
+                stopReason = 'max_tokens';
+                break;
+            case 'SAFETY':
+                stopReason = 'content_filter';
+                break;
+            case 'RECITATION':
+                stopReason = 'content_filter';
+                break;
+            default:
+                stopReason = 'end_turn';
+        }
+        // Check if we have tool calls - that changes the stop reason
+        if (content.some((block) => block.type === 'tool_use')) {
+            stopReason = 'tool_use';
+        }
+        const result = {
+            id: `gemini-${Date.now()}`, // Gemini doesn't provide response ID
+            content,
+            model,
+            stop_reason: stopReason,
+        };
+        if (response.usageMetadata) {
+            result.usage = {
+                input_tokens: response.usageMetadata.promptTokenCount,
+                output_tokens: response.usageMetadata.candidatesTokenCount,
+            };
+        }
+        return result;
+    }
+    /**
+     * Translate Gemini streaming chunk to AgentRouter StreamChunk format.
+     */
+    translateStreamChunk(chunk, hasStartedContent, currentToolCallIndex, activeToolCalls) {
+        const chunks = [];
+        const candidate = chunk.candidates?.[0];
+        if (!candidate?.content?.parts) {
+            return chunks;
+        }
+        for (const part of candidate.content.parts) {
+            // Handle text content
+            if (part.text !== undefined) {
+                // Emit content_block_start if this is the first content
+                if (!hasStartedContent) {
+                    chunks.push({
+                        type: 'content_block_start',
+                        index: 0,
+                        content_block: {
+                            type: 'text',
+                            text: '',
+                        },
+                    });
+                }
+                // Emit content delta
+                chunks.push({
+                    type: 'content_block_delta',
+                    index: 0,
+                    delta: {
+                        type: 'text_delta',
+                        text: part.text,
+                    },
+                });
+            }
+            // Handle function calls
+            if (part.functionCall) {
+                const toolIndex = currentToolCallIndex;
+                const toolId = `call_${Date.now()}_${toolIndex}`;
+                // Track this tool call
+                activeToolCalls.set(toolIndex, {
+                    id: toolId,
+                    name: part.functionCall.name,
+                });
+                // Emit content_block_start for tool use
+                chunks.push({
+                    type: 'content_block_start',
+                    index: toolIndex + 1, // Offset by 1 since text is at index 0
+                    content_block: {
+                        type: 'tool_use',
+                        id: toolId,
+                        name: part.functionCall.name,
+                        input: part.functionCall.args,
+                    },
+                });
+                // Emit the full arguments as a delta (Gemini sends complete args)
+                chunks.push({
+                    type: 'content_block_delta',
+                    index: toolIndex + 1,
+                    delta: {
+                        type: 'input_json_delta',
+                        text: JSON.stringify(part.functionCall.args),
+                    },
+                });
+            }
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

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

package/dist/providers/kimi.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Kimi (Moonshot AI) Provider Implementation
+ *
+ * Kimi uses an OpenAI-compatible API format.
+ * This provider extends OpenAIProvider with the correct name identifier.
+ */
+import { OpenAIProvider } from './openai.js';
+import type { ProviderConfig } from '../types.js';
+/**
+ * Kimi (Moonshot AI) API provider adapter.
+ *
+ * Uses OpenAI-compatible API format but with Kimi endpoints.
+ * Default base URL: https://api.moonshot.cn/v1
+ */
+export declare class KimiProvider extends OpenAIProvider {
+    readonly name = "kimi";
+    constructor(config: ProviderConfig);
+}
+//# sourceMappingURL=kimi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../src/providers/kimi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAyB,IAAI,UAAU;gBAE3B,MAAM,EAAE,cAAc;CAGnC"}

package/dist/providers/kimi.js

@@ -0,0 +1,20 @@
+/**
+ * Kimi (Moonshot AI) Provider Implementation
+ *
+ * Kimi uses an OpenAI-compatible API format.
+ * This provider extends OpenAIProvider with the correct name identifier.
+ */
+import { OpenAIProvider } from './openai.js';
+/**
+ * Kimi (Moonshot AI) API provider adapter.
+ *
+ * Uses OpenAI-compatible API format but with Kimi endpoints.
+ * Default base URL: https://api.moonshot.cn/v1
+ */
+export class KimiProvider extends OpenAIProvider {
+    name = 'kimi';
+    constructor(config) {
+        super(config);
+    }
+}
+//# sourceMappingURL=kimi.js.map

package/dist/providers/kimi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.js","sourceRoot":"","sources":["../../src/providers/kimi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,cAAc;IACrB,IAAI,GAAG,MAAM,CAAC;IAEvC,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/providers/manager.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Provider Manager
+ *
+ * Manages the registry of LLM providers, handling provider creation,
+ * retrieval, and configuration updates. Provides a factory method for
+ * creating provider instances based on their type.
+ */
+import { type Provider, type ProviderConfig, type ProviderType } from '../types.js';
+/**
+ * Factory function type for creating provider instances.
+ */
+export type ProviderFactory = (config: ProviderConfig) => Provider;
+/**
+ * Manager for LLM provider instances.
+ *
+ * Handles:
+ * - Provider registration and retrieval
+ * - Provider instance creation via factory methods
+ * - Configuration updates with instance recreation
+ * - Lazy instantiation of providers
+ *
+ * @example
+ * ```ts
+ * const manager = new ProviderManager();
+ *
+ * // Register provider factories
+ * manager.registerFactory('anthropic', (config) => new AnthropicProvider(config));
+ * manager.registerFactory('openai', (config) => new OpenAIProvider(config));
+ *
+ * // Update configurations (creates instances lazily)
+ * manager.updateConfig({
+ *   anthropic: { api_key: 'sk-...' },
+ *   openai: { api_key: 'sk-...' }
+ * });
+ *
+ * // Get a provider instance
+ * const provider = manager.get('anthropic');
+ * ```
+ */
+export declare class ProviderManager {
+    /** Registry of provider factories and instances by name */
+    private readonly providers;
+    /** Registry of active provider instances */
+    private readonly instances;
+    /**
+     * Register a provider factory for a given provider type.
+     * The factory will be used to create provider instances when needed.
+     *
+     * @param name - Provider name (e.g., 'anthropic', 'openai')
+     * @param factory - Factory function that creates provider instances
+     */
+    registerFactory(name: string, factory: ProviderFactory): void;
+    /**
+     * Register a pre-created provider instance directly.
+     * Useful for testing or custom provider implementations.
+     *
+     * @param name - Provider name
+     * @param provider - Provider instance
+     */
+    register(name: string, provider: Provider): void;
+    /**
+     * Get a provider instance by name.
+     * Creates the instance lazily if it hasn't been created yet.
+     *
+     * @param name - Provider name
+     * @returns The provider instance
+     * @throws ConfigurationError if the provider is not registered or not configured
+     */
+    get(name: string): Provider;
+    /**
+     * Check if a provider is registered (has a factory).
+     *
+     * @param name - Provider name
+     * @returns True if the provider is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Check if a provider is configured and ready to use.
+     *
+     * @param name - Provider name
+     * @returns True if the provider is configured
+     */
+    isConfigured(name: string): boolean;
+    /**
+     * Update provider configurations.
+     * This will invalidate existing instances so they are recreated with new configs.
+     *
+     * @param configs - Map of provider name to configuration
+     */
+    updateConfig(configs: Record<string, ProviderConfig>): void;
+    /**
+     * Get the configuration for a provider.
+     *
+     * @param name - Provider name
+     * @returns The provider configuration, or undefined if not configured
+     */
+    getConfig(name: string): ProviderConfig | undefined;
+    /**
+     * List all registered provider names.
+     *
+     * @returns Array of provider names
+     */
+    listProviders(): string[];
+    /**
+     * List all configured provider names (ready to use).
+     *
+     * @returns Array of configured provider names
+     */
+    listConfigured(): string[];
+    /**
+     * Remove a provider from the registry.
+     *
+     * @param name - Provider name to remove
+     */
+    remove(name: string): void;
+    /**
+     * Clear all providers from the registry.
+     */
+    clear(): void;
+    /**
+     * Run health checks on all configured providers.
+     *
+     * @returns Map of provider name to health check result (true = healthy, Error = failed)
+     */
+    healthCheckAll(): Promise<Map<string, true | Error>>;
+}
+/**
+ * Create a provider instance based on provider type.
+ * This is a factory function that maps provider types to their implementations.
+ *
+ * Note: This function requires the provider implementations to be imported
+ * and registered. Use ProviderManager.registerFactory() to register providers.
+ *
+ * @param type - Provider type
+ * @param config - Provider configuration
+ * @param manager - Provider manager with registered factories
+ * @returns Provider instance
+ * @throws ConfigurationError if the provider type is not supported
+ */
+export declare function createProvider(type: ProviderType, config: ProviderConfig, manager: ProviderManager): Provider;
+/**
+ * Create a ProviderManager with default provider factories registered.
+ * Provider implementations must be passed in to avoid circular dependencies.
+ *
+ * @param factories - Map of provider type to factory function
+ * @returns Configured ProviderManager
+ *
+ * @example
+ * ```ts
+ * import { AnthropicProvider } from './anthropic.js';
+ * import { OpenAIProvider } from './openai.js';
+ *
+ * const manager = createProviderManager({
+ *   anthropic: (config) => new AnthropicProvider(config),
+ *   openai: (config) => new OpenAIProvider(config),
+ * });
+ * ```
+ */
+export declare function createProviderManager(factories: Partial<Record<ProviderType, ProviderFactory>>): ProviderManager;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/providers/manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,KAAM,QAAQ,EAAC,KAAM,cAAc,EAAC,KAAM,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzG;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,QAAQ,CAAC;AAcnE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAe;IAC1B,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IAErE,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD;;;;;;OAMG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAcpE;;;;;;OAMG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAUvD;;;;;;;OAOG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAkClC;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1C;;;;;OAKG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAwBlE;;;;;OAKG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1D;;;;OAIG;IACI,aAAa,IAAI,MAAM,EAAE;IAOhC;;;;OAIG;IACI,cAAc,IAAI,MAAM,EAAE;IAIjC;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;;OAIG;IACU,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;CAkBlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,GACvB,QAAQ,CAIV;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,GACxD,eAAe,CAUjB"}