@sashabogi/foundation 0.1.6 → 0.1.7

package/dist/providers/base.js

@@ -0,0 +1,227 @@
+/**
+ * Base Provider Implementation
+ *
+ * Abstract base class that implements common functionality for all LLM providers.
+ * Handles authentication headers, error handling, timeout management, and
+ * provides the interface that concrete providers must implement.
+ */
+import { ProviderError, RateLimitError, AuthenticationError, TimeoutError, } from './types.js';
+/**
+ * Abstract base class for LLM providers.
+ *
+ * Provides common functionality including:
+ * - Authentication header management
+ * - HTTP request helpers with timeout support
+ * - Standardized error handling
+ * - Response parsing utilities
+ *
+ * Concrete providers must implement:
+ * - complete(): Execute a completion request
+ * - completeStream(): Execute a streaming completion request
+ * - healthCheck(): Verify provider connectivity
+ */
+export class BaseProvider {
+    /** Provider configuration */
+    config;
+    /** Default timeout in milliseconds (3 minutes for complex LLM operations) */
+    defaultTimeoutMs = 180000;
+    /**
+     * Create a new provider instance.
+     *
+     * @param config - Provider-specific configuration (API keys, URLs, etc.)
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Build common HTTP headers for provider requests.
+     * Includes authentication and content-type headers.
+     *
+     * @returns Headers object for HTTP requests
+     */
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add API key authentication if configured
+        if (this.config.api_key) {
+            headers['Authorization'] = `Bearer ${this.config.api_key}`;
+        }
+        // Add any custom headers from config
+        if (this.config.headers) {
+            Object.assign(headers, this.config.headers);
+        }
+        return headers;
+    }
+    /**
+     * Make an HTTP request to the provider API with timeout support.
+     *
+     * @param options - Request options
+     * @returns Promise resolving to the parsed JSON response
+     * @throws ProviderError for API errors
+     * @throws TimeoutError if the request times out
+     */
+    async makeRequest(options) {
+        const { method, url, headers, body, timeoutMs = this.defaultTimeoutMs } = options;
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => { controller.abort(); }, timeoutMs);
+        try {
+            const fetchOptions = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, fetchOptions);
+            // Clear timeout on successful response
+            clearTimeout(timeoutId);
+            // Handle non-OK responses
+            if (!response.ok) {
+                await this.handleErrorResponse(response);
+            }
+            // Parse and return JSON response
+            return (await response.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            this.handleRequestError(error, timeoutMs);
+            // handleRequestError always throws, but TypeScript needs this
+            throw error;
+        }
+    }
+    /**
+     * Make a streaming HTTP request to the provider API.
+     *
+     * @param options - Request options
+     * @returns Response object for streaming
+     * @throws ProviderError for API errors
+     * @throws TimeoutError if the connection times out
+     */
+    async makeStreamingRequest(options) {
+        const { method, url, headers, body, timeoutMs = this.defaultTimeoutMs } = options;
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => { controller.abort(); }, timeoutMs);
+        try {
+            const fetchOptions = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, fetchOptions);
+            // Clear timeout once we have a response (streaming will handle its own timing)
+            clearTimeout(timeoutId);
+            // Handle non-OK responses
+            if (!response.ok) {
+                await this.handleErrorResponse(response);
+            }
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            this.handleRequestError(error, timeoutMs);
+            // handleRequestError always throws, but TypeScript needs this
+            throw error;
+        }
+    }
+    /**
+     * Handle HTTP error responses from provider APIs.
+     * Throws appropriate error types based on status code.
+     *
+     * @param response - The HTTP response object
+     * @throws RateLimitError for 429 responses
+     * @throws AuthenticationError for 401 responses
+     * @throws ProviderError for other error responses
+     */
+    async handleErrorResponse(response) {
+        let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+        let retryAfterMs;
+        // Try to parse error details from response body
+        try {
+            const errorBody = (await response.json());
+            if (errorBody.error?.message) {
+                errorMessage = errorBody.error.message;
+            }
+            else if (errorBody.message) {
+                errorMessage = errorBody.message;
+            }
+        }
+        catch {
+            // Ignore JSON parse errors, use default message
+        }
+        // Check for retry-after header on rate limits
+        const retryAfter = response.headers.get('retry-after');
+        if (retryAfter) {
+            retryAfterMs = parseInt(retryAfter, 10) * 1000;
+        }
+        // Throw appropriate error type based on status
+        switch (response.status) {
+            case 401:
+            case 403:
+                throw new AuthenticationError(this.name);
+            case 429:
+                throw new RateLimitError(this.name, retryAfterMs);
+            default:
+                throw new ProviderError(errorMessage, this.name, response.status);
+        }
+    }
+    /**
+     * Handle request-level errors (network, timeout, etc.).
+     *
+     * @param error - The caught error
+     * @param timeoutMs - The timeout that was configured
+     * @throws TimeoutError for abort errors
+     * @throws ProviderError for other errors
+     */
+    handleRequestError(error, timeoutMs) {
+        // Check if this is an abort error (timeout)
+        if (error instanceof Error) {
+            if (error.name === 'AbortError') {
+                throw new TimeoutError(this.name, timeoutMs);
+            }
+            // Re-throw if it's already one of our error types
+            if (error instanceof ProviderError ||
+                error instanceof RateLimitError ||
+                error instanceof AuthenticationError ||
+                error instanceof TimeoutError) {
+                throw error;
+            }
+            // Wrap other errors
+            throw new ProviderError(error.message, this.name, undefined, error);
+        }
+        // Handle non-Error objects
+        throw new ProviderError(String(error), this.name);
+    }
+    /**
+     * Get the base URL for API requests.
+     * Uses configured base_url or returns the default for the provider.
+     *
+     * @param defaultUrl - Default URL if not configured
+     * @returns The base URL to use for requests
+     */
+    getBaseUrl(defaultUrl) {
+        return this.config.base_url || defaultUrl;
+    }
+    /**
+     * Create an AbortController with a timeout.
+     * Useful for streaming requests where we need to track the controller.
+     *
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Object containing the controller and a cleanup function
+     */
+    createTimeoutController(timeoutMs) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => { controller.abort(); }, timeoutMs);
+        return {
+            controller,
+            cleanup: () => { clearTimeout(timeoutId); },
+        };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

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

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DeepSeek Provider Implementation
+ *
+ * DeepSeek provides high-quality open models.
+ * It 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';
+/**
+ * DeepSeek API provider adapter.
+ *
+ * Uses OpenAI-compatible API format with DeepSeek endpoints.
+ * Provides access to DeepSeek's powerful models.
+ *
+ * Default base URL: https://api.deepseek.com
+ * Available models: deepseek-chat, deepseek-coder, deepseek-reasoner
+ */
+export declare class DeepSeekProvider extends OpenAIProvider {
+    readonly name = "deepseek";
+    constructor(config: ProviderConfig);
+}
+//# sourceMappingURL=deepseek.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,SAAyB,IAAI,cAAc;gBAE/B,MAAM,EAAE,cAAc;CAQnC"}

package/dist/providers/deepseek.js

@@ -0,0 +1,31 @@
+/**
+ * DeepSeek Provider Implementation
+ *
+ * DeepSeek provides high-quality open models.
+ * It uses an OpenAI-compatible API format.
+ * This provider extends OpenAIProvider with the correct name identifier.
+ */
+import { OpenAIProvider } from './openai.js';
+// Default base URL for DeepSeek API
+const DEEPSEEK_BASE_URL = 'https://api.deepseek.com';
+/**
+ * DeepSeek API provider adapter.
+ *
+ * Uses OpenAI-compatible API format with DeepSeek endpoints.
+ * Provides access to DeepSeek's powerful models.
+ *
+ * Default base URL: https://api.deepseek.com
+ * Available models: deepseek-chat, deepseek-coder, deepseek-reasoner
+ */
+export class DeepSeekProvider extends OpenAIProvider {
+    name = 'deepseek';
+    constructor(config) {
+        // Ensure base_url defaults to DeepSeek endpoint if not specified
+        const configWithDefaults = {
+            ...config,
+            base_url: config.base_url ?? DEEPSEEK_BASE_URL,
+        };
+        super(configWithDefaults);
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,oCAAoC;AACpC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IACzB,IAAI,GAAG,UAAU,CAAC;IAE3C,YAAY,MAAsB;QAChC,iEAAiE;QACjE,MAAM,kBAAkB,GAAmB;YACzC,GAAG,MAAM;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,iBAAiB;SAC/C,CAAC;QACF,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/providers/fireworks.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fireworks AI Provider Implementation
+ *
+ * Fireworks AI provides fast inference for DeepSeek, Llama, and other open models.
+ * It 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';
+/**
+ * Fireworks AI API provider adapter.
+ *
+ * Uses OpenAI-compatible API format with Fireworks AI endpoints.
+ * Provides fast inference for DeepSeek, Llama, and other models.
+ *
+ * Default base URL: https://api.fireworks.ai/inference/v1
+ * Available models: accounts/fireworks/models/llama-v3p3-70b-instruct, accounts/fireworks/models/deepseek-v3
+ */
+export declare class FireworksProvider extends OpenAIProvider {
+    readonly name = "fireworks";
+    constructor(config: ProviderConfig);
+}
+//# sourceMappingURL=fireworks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fireworks.d.ts","sourceRoot":"","sources":["../../src/providers/fireworks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,SAAyB,IAAI,eAAe;gBAEhC,MAAM,EAAE,cAAc;CAQnC"}

package/dist/providers/fireworks.js

@@ -0,0 +1,31 @@
+/**
+ * Fireworks AI Provider Implementation
+ *
+ * Fireworks AI provides fast inference for DeepSeek, Llama, and other open models.
+ * It uses an OpenAI-compatible API format.
+ * This provider extends OpenAIProvider with the correct name identifier.
+ */
+import { OpenAIProvider } from './openai.js';
+// Default base URL for Fireworks AI API
+const FIREWORKS_BASE_URL = 'https://api.fireworks.ai/inference/v1';
+/**
+ * Fireworks AI API provider adapter.
+ *
+ * Uses OpenAI-compatible API format with Fireworks AI endpoints.
+ * Provides fast inference for DeepSeek, Llama, and other models.
+ *
+ * Default base URL: https://api.fireworks.ai/inference/v1
+ * Available models: accounts/fireworks/models/llama-v3p3-70b-instruct, accounts/fireworks/models/deepseek-v3
+ */
+export class FireworksProvider extends OpenAIProvider {
+    name = 'fireworks';
+    constructor(config) {
+        // Ensure base_url defaults to Fireworks AI endpoint if not specified
+        const configWithDefaults = {
+            ...config,
+            base_url: config.base_url ?? FIREWORKS_BASE_URL,
+        };
+        super(configWithDefaults);
+    }
+}
+//# sourceMappingURL=fireworks.js.map

package/dist/providers/fireworks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fireworks.js","sourceRoot":"","sources":["../../src/providers/fireworks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,wCAAwC;AACxC,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IAC1B,IAAI,GAAG,WAAW,CAAC;IAE5C,YAAY,MAAsB;QAChC,qEAAqE;QACrE,MAAM,kBAAkB,GAAmB;YACzC,GAAG,MAAM;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,kBAAkB;SAChD,CAAC;QACF,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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';
+import type { CompletionRequest, CompletionResponse, StreamChunk, ProviderConfig } from './types.js';
+/**
+ * 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 declare class GeminiProvider extends BaseProvider {
+    readonly name = "google";
+    private static readonly DEFAULT_BASE_URL;
+    /** Default max tokens if not specified in request */
+    private static readonly DEFAULT_MAX_TOKENS;
+    constructor(config: ProviderConfig);
+    /**
+     * 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
+     */
+    private buildUrl;
+    /**
+     * Build headers for Gemini API requests.
+     * Uses Bearer token if API key is provided (alternative to query param).
+     */
+    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 Gemini API is available and credentials are valid.
+     */
+    healthCheck(): Promise<void>;
+    /**
+     * Translate Foundation request to Gemini format.
+     */
+    private translateRequest;
+    /**
+     * Translate messages from Foundation 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
+     */
+    private translateMessages;
+    /**
+     * Translate tools from Foundation format to Gemini function declarations.
+     */
+    private translateTools;
+    /**
+     * Translate Gemini response to Foundation format.
+     */
+    private translateResponse;
+    /**
+     * Translate Gemini streaming chunk to Foundation StreamChunk format.
+     */
+    private translateStreamChunk;
+}
+//# sourceMappingURL=gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EAIX,cAAc,EACf,MAAM,YAAY,CAAC;AAqHpB;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,SAAgB,IAAI,YAAY;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAsD;IAE9F,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;gBAEtC,MAAM,EAAE,cAAc;IAIlC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAYhB;;;OAGG;cACgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmBzD;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAe9E;;OAEG;IACW,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC;IAwFpF;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBzC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuEzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA4E7B"}