universal-llm-client 3.0.0

package/dist/mcp.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Universal LLM Client v3 — MCP Integration
+ *
+ * Native MCP tool discovery and execution bridge.
+ * Uses @modelcontextprotocol/sdk as a peer dependency.
+ *
+ * Supports:
+ *  - Stdio transport (Node/Bun/Deno — spawns server processes)
+ *  - Streamable HTTP transport (all runtimes including browsers)
+ *
+ * Usage:
+ *   const mcp = new MCPToolBridge({
+ *       servers: {
+ *           filesystem: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', './'] },
+ *           weather: { url: 'https://mcp.example.com/weather' },
+ *       }
+ *   });
+ *   await mcp.connect();
+ *   await mcp.registerTools(model); // or registerTools(model)
+ *   // ... use model.chatWithTools() — MCP tools are now callable
+ *   await mcp.disconnect();
+ */
+import type { AIModel } from './ai-model.js';
+import type { Auditor } from './auditor.js';
+export interface MCPServerConfig {
+    /** Stdio transport: command to spawn the MCP server */
+    command?: string;
+    /** Stdio transport: arguments for the command */
+    args?: string[];
+    /** Stdio transport: environment variables for the spawned process */
+    env?: Record<string, string>;
+    /** HTTP transport: URL of the remote MCP server */
+    url?: string;
+    /** HTTP transport: additional headers for requests */
+    headers?: Record<string, string>;
+}
+export interface MCPBridgeConfig {
+    /** Named MCP server configurations */
+    servers: Record<string, MCPServerConfig>;
+    /** Auditor for observability */
+    auditor?: Auditor;
+}
+export interface MCPTool {
+    /** Server this tool came from */
+    serverName: string;
+    /** Tool name (as reported by the server) */
+    name: string;
+    /** Full qualified name (serverName:toolName) */
+    qualifiedName: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for tool input */
+    inputSchema: Record<string, unknown>;
+}
+export declare class MCPToolBridge {
+    private config;
+    private auditor;
+    private clients;
+    private transports;
+    private discoveredTools;
+    private connected;
+    constructor(config: MCPBridgeConfig);
+    /**
+     * Connect to all configured MCP servers and discover their tools.
+     * Requires @modelcontextprotocol/sdk to be installed.
+     */
+    connect(): Promise<void>;
+    /**
+     * Register all discovered MCP tools with an AIModel instance.
+     * Each MCP tool becomes a callable tool that forwards execution
+     * to the appropriate MCP server.
+     */
+    registerTools(model: AIModel): Promise<void>;
+    /**
+     * Get all discovered MCP tools (for inspection).
+     */
+    getTools(): ReadonlyArray<MCPTool>;
+    /**
+     * Disconnect from all MCP servers and clean up.
+     */
+    disconnect(): Promise<void>;
+    private createToolHandler;
+    private convertInputSchema;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,WAAW,eAAe;IAC5B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC5B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACpB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAiBD,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,eAAe;IASnC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwH9B;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC;IAQlC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC,OAAO,CAAC,iBAAiB;IA2DzB,OAAO,CAAC,kBAAkB;CAO7B"}

package/dist/mcp.js

@@ -0,0 +1,255 @@
+/**
+ * Universal LLM Client v3 — MCP Integration
+ *
+ * Native MCP tool discovery and execution bridge.
+ * Uses @modelcontextprotocol/sdk as a peer dependency.
+ *
+ * Supports:
+ *  - Stdio transport (Node/Bun/Deno — spawns server processes)
+ *  - Streamable HTTP transport (all runtimes including browsers)
+ *
+ * Usage:
+ *   const mcp = new MCPToolBridge({
+ *       servers: {
+ *           filesystem: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', './'] },
+ *           weather: { url: 'https://mcp.example.com/weather' },
+ *       }
+ *   });
+ *   await mcp.connect();
+ *   await mcp.registerTools(model); // or registerTools(model)
+ *   // ... use model.chatWithTools() — MCP tools are now callable
+ *   await mcp.disconnect();
+ */
+import { NoopAuditor } from './auditor.js';
+// ============================================================================
+// MCPToolBridge
+// ============================================================================
+export class MCPToolBridge {
+    config;
+    auditor;
+    clients = new Map();
+    transports = new Map();
+    discoveredTools = [];
+    connected = false;
+    constructor(config) {
+        this.config = config;
+        this.auditor = config.auditor ?? new NoopAuditor();
+    }
+    // ========================================================================
+    // Connection Lifecycle
+    // ========================================================================
+    /**
+     * Connect to all configured MCP servers and discover their tools.
+     * Requires @modelcontextprotocol/sdk to be installed.
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        // Dynamic import of MCP SDK (peer dependency)
+        let sdk;
+        try {
+            // @ts-ignore — peer dependency, may not be installed
+            sdk = await import('@modelcontextprotocol/sdk/client/index.js');
+        }
+        catch {
+            throw new Error('MCP integration requires @modelcontextprotocol/sdk.\n' +
+                'Install it: bun add @modelcontextprotocol/sdk');
+        }
+        const entries = Object.entries(this.config.servers);
+        for (const [serverName, serverConfig] of entries) {
+            try {
+                const client = new sdk.Client({ name: 'universal-llm-client', version: '3.0.0' }, { capabilities: {} });
+                let transport;
+                if (serverConfig.url) {
+                    // HTTP transport (all runtimes)
+                    if (!sdk.StreamableHTTPClientTransport) {
+                        // Try separate import path
+                        // @ts-ignore — peer dependency, may not be installed
+                        const httpModule = await import('@modelcontextprotocol/sdk/client/streamableHttp.js').catch(() => null);
+                        if (!httpModule?.StreamableHTTPClientTransport) {
+                            throw new Error('StreamableHTTPClientTransport not available in this SDK version');
+                        }
+                        transport = new httpModule.StreamableHTTPClientTransport(new URL(serverConfig.url), serverConfig.headers ? { requestInit: { headers: serverConfig.headers } } : undefined);
+                    }
+                    else {
+                        transport = new sdk.StreamableHTTPClientTransport(new URL(serverConfig.url), serverConfig.headers ? { requestInit: { headers: serverConfig.headers } } : undefined);
+                    }
+                }
+                else if (serverConfig.command) {
+                    // Stdio transport (Node/Bun/Deno only)
+                    if (!sdk.StdioClientTransport) {
+                        // @ts-ignore — peer dependency, may not be installed
+                        const stdioModule = await import('@modelcontextprotocol/sdk/client/stdio.js').catch(() => null);
+                        if (!stdioModule?.StdioClientTransport) {
+                            throw new Error('Stdio transport not available. This is expected in browser environments.\n' +
+                                'Use HTTP transport (url) instead, or run in Node/Bun/Deno.');
+                        }
+                        transport = new stdioModule.StdioClientTransport({
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
+                    else {
+                        transport = new sdk.StdioClientTransport({
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
+                }
+                else {
+                    throw new Error(`MCP server "${serverName}" must have either "url" or "command" configured`);
+                }
+                await client.connect(transport);
+                this.clients.set(serverName, client);
+                this.transports.set(serverName, transport);
+                // Discover tools
+                const toolList = await client.listTools();
+                for (const tool of toolList.tools) {
+                    this.discoveredTools.push({
+                        serverName,
+                        name: tool.name,
+                        qualifiedName: `${serverName}:${tool.name}`,
+                        description: tool.description ?? '',
+                        inputSchema: tool.inputSchema,
+                    });
+                }
+                this.auditor.record({
+                    timestamp: Date.now(),
+                    type: 'response',
+                    metadata: {
+                        event: 'mcp_connected',
+                        server: serverName,
+                        toolCount: toolList.tools.length,
+                    },
+                });
+            }
+            catch (error) {
+                this.auditor.record({
+                    timestamp: Date.now(),
+                    type: 'error',
+                    error: error instanceof Error ? error.message : String(error),
+                    metadata: { event: 'mcp_connect_failed', server: serverName },
+                });
+                throw error;
+            }
+        }
+        this.connected = true;
+    }
+    // ========================================================================
+    // Tool Registration
+    // ========================================================================
+    /**
+     * Register all discovered MCP tools with an AIModel instance.
+     * Each MCP tool becomes a callable tool that forwards execution
+     * to the appropriate MCP server.
+     */
+    async registerTools(model) {
+        if (!this.connected) {
+            await this.connect();
+        }
+        const tools = this.discoveredTools.map(mcpTool => ({
+            name: mcpTool.qualifiedName,
+            description: mcpTool.description,
+            parameters: this.convertInputSchema(mcpTool.inputSchema),
+            handler: this.createToolHandler(mcpTool),
+        }));
+        model.registerTools(tools);
+    }
+    /**
+     * Get all discovered MCP tools (for inspection).
+     */
+    getTools() {
+        return this.discoveredTools;
+    }
+    // ========================================================================
+    // Disconnect
+    // ========================================================================
+    /**
+     * Disconnect from all MCP servers and clean up.
+     */
+    async disconnect() {
+        for (const [serverName, client] of this.clients) {
+            try {
+                await client.close();
+            }
+            catch (error) {
+                this.auditor.record({
+                    timestamp: Date.now(),
+                    type: 'error',
+                    error: error instanceof Error ? error.message : String(error),
+                    metadata: { event: 'mcp_disconnect_failed', server: serverName },
+                });
+            }
+        }
+        this.clients.clear();
+        this.transports.clear();
+        this.discoveredTools = [];
+        this.connected = false;
+    }
+    // ========================================================================
+    // Internal
+    // ========================================================================
+    createToolHandler(mcpTool) {
+        return async (args) => {
+            const client = this.clients.get(mcpTool.serverName);
+            if (!client) {
+                throw new Error(`MCP server "${mcpTool.serverName}" is not connected`);
+            }
+            const start = Date.now();
+            this.auditor.record({
+                timestamp: start,
+                type: 'tool_call',
+                metadata: {
+                    event: 'mcp_tool_call',
+                    server: mcpTool.serverName,
+                    tool: mcpTool.name,
+                },
+            });
+            try {
+                const result = await client.callTool({
+                    name: mcpTool.name,
+                    arguments: args,
+                });
+                // Extract text content from MCP response
+                const textParts = result.content
+                    .filter(c => c.type === 'text' && c.text)
+                    .map(c => c.text);
+                const output = textParts.length === 1 ? textParts[0] : textParts.join('\n');
+                this.auditor.record({
+                    timestamp: Date.now(),
+                    type: 'tool_result',
+                    metadata: {
+                        event: 'mcp_tool_result',
+                        server: mcpTool.serverName,
+                        tool: mcpTool.name,
+                        duration: Date.now() - start,
+                    },
+                });
+                return output;
+            }
+            catch (error) {
+                this.auditor.record({
+                    timestamp: Date.now(),
+                    type: 'error',
+                    error: error instanceof Error ? error.message : String(error),
+                    metadata: {
+                        event: 'mcp_tool_error',
+                        server: mcpTool.serverName,
+                        tool: mcpTool.name,
+                    },
+                });
+                throw error;
+            }
+        };
+    }
+    convertInputSchema(schema) {
+        return {
+            type: 'object',
+            properties: schema['properties'] ?? {},
+            required: schema['required'],
+        };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/providers/google.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Universal LLM Client v3 — Google Provider
+ *
+ * Implements BaseLLMClient for Google AI Studio and Vertex AI.
+ * Supports Gemini and Gemma models with full tool calling,
+ * streaming, embeddings, and system prompt handling.
+ */
+import { BaseLLMClient } from '../client.js';
+import type { LLMClientOptions, LLMChatMessage, LLMChatResponse, ChatOptions } from '../interfaces.js';
+import type { DecodedEvent } from '../stream-decoder.js';
+import type { Auditor } from '../auditor.js';
+export declare class GoogleClient extends BaseLLMClient {
+    private isVertex;
+    private apiVersion;
+    constructor(options: LLMClientOptions, auditor?: Auditor);
+    private getBaseUrl;
+    private getChatUrl;
+    private getStreamUrl;
+    private getEmbedUrl;
+    private getHeaders;
+    chat(messages: LLMChatMessage[], options?: ChatOptions): Promise<LLMChatResponse>;
+    chatStream(messages: LLMChatMessage[], options?: ChatOptions): AsyncGenerator<DecodedEvent, LLMChatResponse | void, unknown>;
+    embed(text: string): Promise<number[]>;
+    getModels(): Promise<string[]>;
+    private buildRequestBody;
+    private buildGenerationConfig;
+    private convertToGoogleMessages;
+    private convertContentToGoogleParts;
+    private convertToGoogleTool;
+    private convertFunctionCallToToolCall;
+    private parseGoogleResponse;
+}
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,KAAK,EACR,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EAYd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,qBAAa,YAAa,SAAQ,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO;IAUxD,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,UAAU;IAcZ,IAAI,CACN,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,eAAe,CAAC;IAqCpB,UAAU,CACb,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACtB,cAAc,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,EAAE,OAAO,CAAC;IAkG1D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBtC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBpC,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,uBAAuB;IA4F/B,OAAO,CAAC,2BAA2B;IA+BnC,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,6BAA6B;IAsBrC,OAAO,CAAC,mBAAmB;CAwC9B"}