@sashabogi/foundation 0.1.6 → 0.1.8

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,YAAY,CAAC;AAKjD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAyB,IAAI,UAAU;gBAE3B,MAAM,EAAE,cAAc;CAQnC"}

package/dist/providers/kimi.js

@@ -0,0 +1,27 @@
+/**
+ * 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';
+// Default base URL for Kimi API
+const KIMI_BASE_URL = 'https://api.moonshot.ai/v1';
+/**
+ * Kimi (Moonshot AI) API provider adapter.
+ *
+ * Uses OpenAI-compatible API format but with Kimi endpoints.
+ * Default base URL: https://api.moonshot.ai/v1
+ */
+export class KimiProvider extends OpenAIProvider {
+    name = 'kimi';
+    constructor(config) {
+        // Ensure base_url defaults to Kimi endpoint if not specified
+        const configWithDefaults = {
+            ...config,
+            base_url: config.base_url ?? KIMI_BASE_URL,
+        };
+        super(configWithDefaults);
+    }
+}
+//# 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,gCAAgC;AAChC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,cAAc;IACrB,IAAI,GAAG,MAAM,CAAC;IAEvC,YAAY,MAAsB;QAChC,6DAA6D;QAC7D,MAAM,kBAAkB,GAAmB;YACzC,GAAG,MAAM;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,aAAa;SAC3C,CAAC;QACF,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/providers/manager.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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();
+ *
+ * // 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;
+    /**
+     * Create a new ProviderManager with default factories registered.
+     */
+    constructor();
+    /**
+     * 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.
+ *
+ * @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.
+ *
+ * @returns Configured ProviderManager
+ */
+export declare function createProviderManager(): 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,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAiBvG;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,QAAQ,CAAC;AAiCnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,eAAe;IAC1B,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IAErE,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD;;OAEG;;IAQH;;;;;;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;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,GACvB,QAAQ,CAIV;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/providers/manager.js

@@ -0,0 +1,279 @@
+/**
+ * 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';
+// Import all provider implementations
+import { AnthropicProvider } from './anthropic.js';
+import { OpenAIProvider } from './openai.js';
+import { GeminiProvider } from './gemini.js';
+import { OllamaProvider } from './ollama.js';
+import { GroqProvider } from './groq.js';
+import { TogetherProvider } from './together.js';
+import { FireworksProvider } from './fireworks.js';
+import { OpenRouterProvider } from './openrouter.js';
+import { PerplexityProvider } from './perplexity.js';
+import { KimiProvider } from './kimi.js';
+import { KimiCodeProvider } from './kimi-code.js';
+import { ZAIProvider } from './zai.js';
+import { DeepSeekProvider } from './deepseek.js';
+/**
+ * Default provider factories for all supported providers.
+ */
+const DEFAULT_FACTORIES = {
+    anthropic: (config) => new AnthropicProvider(config),
+    openai: (config) => new OpenAIProvider(config),
+    google: (config) => new GeminiProvider(config),
+    ollama: (config) => new OllamaProvider(config),
+    groq: (config) => new GroqProvider(config),
+    together: (config) => new TogetherProvider(config),
+    fireworks: (config) => new FireworksProvider(config),
+    openrouter: (config) => new OpenRouterProvider(config),
+    perplexity: (config) => new PerplexityProvider(config),
+    kimi: (config) => new KimiProvider(config),
+    'kimi-code': (config) => new KimiCodeProvider(config),
+    zai: (config) => new ZAIProvider(config),
+    deepseek: (config) => new DeepSeekProvider(config),
+};
+/**
+ * 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();
+ *
+ * // 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();
+    /**
+     * Create a new ProviderManager with default factories registered.
+     */
+    constructor() {
+        // Register all default factories
+        for (const [type, factory] of Object.entries(DEFAULT_FACTORIES)) {
+            this.registerFactory(type, factory);
+        }
+    }
+    /**
+     * 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.
+ *
+ * @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.
+ *
+ * @returns Configured ProviderManager
+ */
+export function createProviderManager() {
+    return new ProviderManager();
+}
+//# 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 Foundation 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 Foundation request to Ollama format.
+     */
+    private translateRequest;
+    /**
+     * Translate messages from Foundation 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 Foundation format to Ollama format.
+     */
+    private translateTools;
+    /**
+     * Translate Ollama response to Foundation format.
+     */
+    private translateResponse;
+    /**
+     * Translate Ollama streaming chunk to Foundation 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,YAAY,CAAC;AAEpB,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;IAyFpF;;;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"}