mcp-agent-foundry 1.0.0

package/dist/providers/manager.js

@@ -0,0 +1,264 @@
+/**
+ * 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 { ConfigurationError } from '../types.js';
+/**
+ * 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 class ProviderManager {
+    /** Registry of provider factories and instances by name */
+    providers = new Map();
+    /** Registry of active provider instances */
+    instances = new Map();
+    /**
+     * 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, factory) {
+        const existing = this.providers.get(name);
+        if (existing) {
+            // Update the factory but preserve existing config
+            existing.factory = factory;
+            // Clear instance so it will be recreated with new factory
+            delete existing.instance;
+            this.instances.delete(name);
+        }
+        else {
+            this.providers.set(name, { factory });
+        }
+    }
+    /**
+     * Register a pre-created provider instance directly.
+     * Useful for testing or custom provider implementations.
+     *
+     * @param name - Provider name
+     * @param provider - Provider instance
+     */
+    register(name, provider) {
+        this.instances.set(name, provider);
+        // Also store in providers map with a dummy factory
+        this.providers.set(name, {
+            factory: () => provider,
+            instance: provider,
+        });
+    }
+    /**
+     * 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) {
+        // Check for directly registered instance first
+        const directInstance = this.instances.get(name);
+        if (directInstance) {
+            return directInstance;
+        }
+        // Check for factory-based registration
+        const registration = this.providers.get(name);
+        if (!registration) {
+            throw new ConfigurationError(`Provider '${name}' is not registered. Available providers: ${this.listProviders().join(', ') || 'none'}`);
+        }
+        // Return existing instance if available
+        if (registration.instance) {
+            return registration.instance;
+        }
+        // Check if we have configuration
+        if (!registration.config) {
+            throw new ConfigurationError(`Provider '${name}' is registered but not configured. Call updateConfig() first.`);
+        }
+        // Create new instance
+        registration.instance = registration.factory(registration.config);
+        this.instances.set(name, registration.instance);
+        return registration.instance;
+    }
+    /**
+     * Check if a provider is registered (has a factory).
+     *
+     * @param name - Provider name
+     * @returns True if the provider is registered
+     */
+    has(name) {
+        return this.providers.has(name) || this.instances.has(name);
+    }
+    /**
+     * Check if a provider is configured and ready to use.
+     *
+     * @param name - Provider name
+     * @returns True if the provider is configured
+     */
+    isConfigured(name) {
+        const registration = this.providers.get(name);
+        return !!registration?.config || this.instances.has(name);
+    }
+    /**
+     * 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) {
+        for (const [name, config] of Object.entries(configs)) {
+            const registration = this.providers.get(name);
+            if (registration) {
+                // Update config and clear instance to force recreation
+                registration.config = config;
+                delete registration.instance;
+                this.instances.delete(name);
+            }
+            else {
+                // Store config even if no factory registered yet
+                // This allows config to be loaded before factories are registered
+                this.providers.set(name, {
+                    factory: () => {
+                        throw new ConfigurationError(`No factory registered for provider '${name}'`);
+                    },
+                    config,
+                });
+            }
+        }
+    }
+    /**
+     * Get the configuration for a provider.
+     *
+     * @param name - Provider name
+     * @returns The provider configuration, or undefined if not configured
+     */
+    getConfig(name) {
+        return this.providers.get(name)?.config;
+    }
+    /**
+     * List all registered provider names.
+     *
+     * @returns Array of provider names
+     */
+    listProviders() {
+        const names = new Set();
+        this.providers.forEach((_, name) => names.add(name));
+        this.instances.forEach((_, name) => names.add(name));
+        return Array.from(names);
+    }
+    /**
+     * List all configured provider names (ready to use).
+     *
+     * @returns Array of configured provider names
+     */
+    listConfigured() {
+        return this.listProviders().filter((name) => this.isConfigured(name));
+    }
+    /**
+     * Remove a provider from the registry.
+     *
+     * @param name - Provider name to remove
+     */
+    remove(name) {
+        this.providers.delete(name);
+        this.instances.delete(name);
+    }
+    /**
+     * Clear all providers from the registry.
+     */
+    clear() {
+        this.providers.clear();
+        this.instances.clear();
+    }
+    /**
+     * Run health checks on all configured providers.
+     *
+     * @returns Map of provider name to health check result (true = healthy, Error = failed)
+     */
+    async healthCheckAll() {
+        const results = new Map();
+        const configured = this.listConfigured();
+        await Promise.all(configured.map(async (name) => {
+            try {
+                const provider = this.get(name);
+                await provider.healthCheck();
+                results.set(name, true);
+            }
+            catch (error) {
+                results.set(name, error instanceof Error ? error : new Error(String(error)));
+            }
+        }));
+        return results;
+    }
+}
+/**
+ * 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 function createProvider(type, config, manager) {
+    // Update config and get instance from manager
+    manager.updateConfig({ [type]: config });
+    return manager.get(type);
+}
+/**
+ * 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 function createProviderManager(factories) {
+    const manager = new ProviderManager();
+    for (const [type, factory] of Object.entries(factories)) {
+        if (factory) {
+            manager.registerFactory(type, factory);
+        }
+    }
+    return manager;
+}
+//# sourceMappingURL=manager.js.map

package/dist/providers/manager.js.map

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

package/dist/providers/ollama.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Ollama Provider Implementation
+ *
+ * Implements the Provider interface for Ollama's OpenAI-compatible API.
+ * Ollama provides local LLM inference with an API that mirrors OpenAI's format.
+ *
+ * Key characteristics:
+ * - Local server running at http://localhost:11434
+ * - No authentication required (local)
+ * - Uses OpenAI-compatible /v1/chat/completions endpoint
+ * - May not support all features (especially function calling)
+ * - Server may be slower than cloud providers
+ */
+import { type CompletionRequest, type CompletionResponse, type StreamChunk } from '../types.js';
+import { BaseProvider } from './base.js';
+/**
+ * Ollama provider adapter for local LLM inference.
+ *
+ * Ollama provides an OpenAI-compatible API for running local models.
+ * This provider translates AgentRouter requests to the Ollama format
+ * and handles the specific characteristics of local inference.
+ *
+ * Features:
+ * - No authentication required (local server)
+ * - Supports streaming responses
+ * - Limited function calling support (depends on model)
+ * - Graceful connection error handling
+ */
+export declare class OllamaProvider extends BaseProvider {
+    readonly name = "ollama";
+    private static readonly DEFAULT_BASE_URL;
+    /**
+     * Build headers for Ollama API requests.
+     * No authentication required for local server.
+     */
+    protected buildHeaders(): Record<string, string>;
+    /**
+     * Execute a completion request and return the full response.
+     */
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /**
+     * Execute a streaming completion request.
+     */
+    completeStream(request: CompletionRequest): AsyncIterable<StreamChunk>;
+    /**
+     * Check if the Ollama server is running and available.
+     * Uses the native Ollama tags API to list available models.
+     */
+    healthCheck(): Promise<void>;
+    /**
+     * Handle Ollama-specific errors with helpful messages.
+     */
+    private handleOllamaError;
+    /**
+     * Translate AgentRouter request to Ollama format.
+     */
+    private translateRequest;
+    /**
+     * Translate messages from AgentRouter format to Ollama format.
+     *
+     * Key translations:
+     * - Content blocks are flattened to strings
+     * - tool_use blocks become tool_calls array on assistant messages
+     * - tool_result blocks become separate role: "tool" messages
+     */
+    private translateMessages;
+    /**
+     * Translate tools from AgentRouter format to Ollama format.
+     */
+    private translateTools;
+    /**
+     * Translate Ollama response to AgentRouter format.
+     */
+    private translateResponse;
+    /**
+     * Translate Ollama streaming chunk to AgentRouter StreamChunk format.
+     *
+     * Ollama streams deltas that need to be accumulated for tool calls.
+     * Text content can be yielded immediately.
+     */
+    private translateStreamChunk;
+}
+//# sourceMappingURL=ollama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../src/providers/ollama.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAIjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkJzC;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,SAAgB,IAAI,YAAY;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAEpE;;;OAGG;cACgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAazD;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqB9E;;OAEG;IACW,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC;IA4FpF;;;OAGG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BzC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAoFzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2DzB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CA+F7B"}