mcp-agent-foundry 1.0.0

package/dist/providers/base.d.ts

@@ -0,0 +1,151 @@
+/**
+ * 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 { type Provider, type ProviderConfig, type CompletionRequest, type CompletionResponse, type StreamChunk } from '../types.js';
+/**
+ * Options for making HTTP requests to provider APIs.
+ */
+export interface RequestOptions {
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Request URL */
+    url: string;
+    /** Request headers */
+    headers: Record<string, string>;
+    /** Request body (will be JSON stringified) */
+    body?: unknown;
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+    /** Whether this is a streaming request */
+    stream?: boolean;
+}
+/**
+ * Error response structure from provider APIs.
+ */
+export interface ProviderErrorResponse {
+    error?: {
+        message?: string;
+        type?: string;
+        code?: string;
+    };
+    message?: string;
+}
+/**
+ * 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 declare abstract class BaseProvider implements Provider {
+    /** Provider name identifier */
+    abstract readonly name: string;
+    /** Provider configuration */
+    protected readonly config: ProviderConfig;
+    /** Default timeout in milliseconds (3 minutes for complex LLM operations) */
+    protected readonly defaultTimeoutMs: number;
+    /**
+     * Create a new provider instance.
+     *
+     * @param config - Provider-specific configuration (API keys, URLs, etc.)
+     */
+    constructor(config: ProviderConfig);
+    /**
+     * Execute a completion request and return the full response.
+     * Must be implemented by concrete providers.
+     *
+     * @param request - The completion request
+     * @returns Promise resolving to the completion response
+     */
+    abstract complete(request: CompletionRequest): Promise<CompletionResponse>;
+    /**
+     * Execute a streaming completion request.
+     * Must be implemented by concrete providers.
+     *
+     * @param request - The completion request
+     * @returns Async iterable of stream chunks
+     */
+    abstract completeStream(request: CompletionRequest): AsyncIterable<StreamChunk>;
+    /**
+     * Check if the provider is available and configured correctly.
+     * Must be implemented by concrete providers.
+     *
+     * @throws ProviderError if the health check fails
+     */
+    abstract healthCheck(): Promise<void>;
+    /**
+     * Build common HTTP headers for provider requests.
+     * Includes authentication and content-type headers.
+     *
+     * @returns Headers object for HTTP requests
+     */
+    protected buildHeaders(): Record<string, string>;
+    /**
+     * 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
+     */
+    protected makeRequest<T>(options: RequestOptions): Promise<T>;
+    /**
+     * 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
+     */
+    protected makeStreamingRequest(options: RequestOptions): Promise<Response>;
+    /**
+     * 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
+     */
+    protected handleErrorResponse(response: Response): Promise<never>;
+    /**
+     * 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
+     */
+    protected handleRequestError(error: unknown, timeoutMs: number): never;
+    /**
+     * 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
+     */
+    protected getBaseUrl(defaultUrl: string): string;
+    /**
+     * 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
+     */
+    protected createTimeoutController(timeoutMs: number): {
+        controller: AbortController;
+        cleanup: () => void;
+    };
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKP,KACE,QAAQ,EAAC,KACT,cAAc,EAAC,KACf,iBAAiB,EAAC,KAClB,kBAAkB,EAAC,KACnB,WAAW,EAAC,MAAM,aAAa,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,8BAAsB,YAAa,YAAW,QAAQ;IACpD,+BAA+B;IAC/B,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,6BAA6B;IAC7B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAE1C,6EAA6E;IAC7E,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAU;IAErD;;;;OAIG;gBACS,MAAM,EAAE,cAAc;IAIlC;;;;;;OAMG;aACa,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAEjF;;;;;;OAMG;aACa,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC;IAEtF;;;;;OAKG;aACa,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBhD;;;;;;;OAOG;cACa,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAoCnE;;;;;;;OAOG;cACa,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmChF;;;;;;;;OAQG;cACa,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAoCvE;;;;;;;OAOG;IACH,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAyBtE;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhD;;;;;;OAMG;IACH,SAAS,CAAC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG;QACpD,UAAU,EAAE,eAAe,CAAC;QAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB;CASF"}

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/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 AgentRouter request to Gemini format.
+     */
+    private translateRequest;
+    /**
+     * 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
+     */
+    private translateMessages;
+    /**
+     * Translate tools from AgentRouter format to Gemini function declarations.
+     */
+    private translateTools;
+    /**
+     * Translate Gemini response to AgentRouter format.
+     */
+    private translateResponse;
+    /**
+     * Translate Gemini streaming chunk to AgentRouter 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,aAAa,CAAC;AAqHrB;;;;;;;;;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"}