llm-advanced-tools 0.1.0

package/dist/adapters/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/adapters/vercel-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,aAAa,EAAkB,MAAM,IAAI,CAAC;AAEjE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,EAEX,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAOzC;IAEF,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAS;IAE7B;;;OAGG;gBACS,KAAK,EAAE,aAAa,EAAE,YAAY,SAAW;IAKzD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAyBrD;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsDvB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA6EvD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE;IAQ5C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,GAAG;IAK7C;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/adapters/vercel-ai.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VercelAIAdapter = void 0;
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+/**
+ * Vercel AI SDK adapter
+ * Works with any provider supported by AI SDK (OpenAI, Anthropic, Google, etc.)
+ */
+class VercelAIAdapter {
+    /**
+     * @param model - AI SDK language model (e.g., from @ai-sdk/openai, @ai-sdk/anthropic)
+     * @param providerName - Optional provider name for identification
+     */
+    constructor(model, providerName = 'ai-sdk') {
+        this.name = 'vercel-ai';
+        this.capabilities = {
+            supportsNativeToolSearch: false,
+            supportsNativeCodeExecution: false,
+            supportsNativeExamples: false,
+            supportsStreaming: true,
+            supportsParallelToolCalls: true,
+            maxTokens: 128000 // Depends on model, using safe default
+        };
+        this.model = model;
+        this.providerName = providerName;
+    }
+    /**
+     * Format a tool definition for AI SDK's format
+     */
+    formatTool(tool) {
+        // AI SDK uses Zod schemas, but also accepts JSON schema
+        let parameters = tool.inputSchema;
+        // If it's already a Zod schema, use it directly
+        if (typeof parameters === 'object' && 'parse' in parameters) {
+            parameters = tool.inputSchema;
+        }
+        // Add examples to description for better accuracy
+        let description = tool.description;
+        if (tool.inputExamples && tool.inputExamples.length > 0) {
+            description += '\n\nExample usage:';
+            tool.inputExamples.forEach((example, i) => {
+                description += `\n${i + 1}. ${JSON.stringify(example)}`;
+            });
+        }
+        // AI SDK CoreTool format
+        return {
+            description,
+            parameters
+        };
+    }
+    /**
+     * Convert our Message format to AI SDK's format
+     */
+    convertMessages(messages) {
+        const converted = [];
+        for (const msg of messages) {
+            if (msg.role === 'tool') {
+                // Tool results are handled differently in AI SDK
+                // They're included in the tool execution flow
+                continue;
+            }
+            converted.push({
+                role: msg.role,
+                content: typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content)
+            });
+        }
+        return converted;
+    }
+    /**
+     * Convert JSON Schema to Zod schema (simplified)
+     */
+    jsonSchemaToZod(schema) {
+        // If it's already a Zod schema, return it
+        if (schema && typeof schema === 'object' && 'parse' in schema) {
+            return schema;
+        }
+        // Simple JSON Schema to Zod conversion
+        // This is a simplified version - for production, use a proper converter
+        if (schema.type === 'object') {
+            const shape = {};
+            const required = schema.required || [];
+            for (const [key, value] of Object.entries(schema.properties || {})) {
+                const prop = value;
+                let zodType;
+                switch (prop.type) {
+                    case 'string':
+                        zodType = zod_1.z.string();
+                        if (prop.enum) {
+                            zodType = zod_1.z.enum(prop.enum);
+                        }
+                        break;
+                    case 'number':
+                        zodType = zod_1.z.number();
+                        break;
+                    case 'boolean':
+                        zodType = zod_1.z.boolean();
+                        break;
+                    case 'array':
+                        zodType = zod_1.z.array(zod_1.z.any());
+                        break;
+                    default:
+                        zodType = zod_1.z.any();
+                }
+                if (prop.description) {
+                    zodType = zodType.describe(prop.description);
+                }
+                // Make field optional if not in required array
+                if (!required.includes(key)) {
+                    zodType = zodType.optional();
+                }
+                shape[key] = zodType;
+            }
+            return zod_1.z.object(shape);
+        }
+        return zod_1.z.any();
+    }
+    /**
+     * Create a chat completion using AI SDK
+     */
+    async chat(request) {
+        const messages = this.convertMessages(request.messages);
+        // Convert our tools to AI SDK format using the tool() helper
+        const tools = {};
+        const toolDefinitions = request.tools?.filter(t => !t.deferLoading) || [];
+        for (const toolDef of toolDefinitions) {
+            // Add examples to description
+            let description = toolDef.description;
+            if (toolDef.inputExamples && toolDef.inputExamples.length > 0) {
+                description += '\n\nExample usage:';
+                toolDef.inputExamples.forEach((example, i) => {
+                    description += `\n${i + 1}. ${JSON.stringify(example)}`;
+                });
+            }
+            // Convert schema to Zod
+            const parameters = this.jsonSchemaToZod(toolDef.inputSchema);
+            // Create the tool using AI SDK's tool() helper
+            tools[toolDef.name] = (0, ai_1.tool)({
+                description,
+                parameters,
+                execute: async (args) => {
+                    try {
+                        const result = await toolDef.handler(args);
+                        return result;
+                    }
+                    catch (error) {
+                        throw new Error(`Tool ${toolDef.name} failed: ${error.message}`);
+                    }
+                }
+            });
+        }
+        // Generate text with tools
+        const result = await (0, ai_1.generateText)({
+            model: this.model,
+            messages: messages.map(m => ({
+                role: m.role,
+                content: m.content
+            })),
+            tools: Object.keys(tools).length > 0 ? tools : undefined,
+            maxTokens: request.maxTokens,
+            temperature: request.temperature
+        });
+        // Parse tool calls from result
+        const toolCalls = [];
+        if (result.toolCalls && result.toolCalls.length > 0) {
+            result.toolCalls.forEach((tc, index) => {
+                toolCalls.push({
+                    id: `call_${index}`,
+                    name: tc.toolName,
+                    input: tc.args
+                });
+            });
+        }
+        return {
+            message: {
+                role: 'assistant',
+                content: result.text || '',
+                toolCalls
+            },
+            usage: result.usage
+                ? {
+                    inputTokens: result.usage.promptTokens,
+                    outputTokens: result.usage.completionTokens,
+                    totalTokens: result.usage.totalTokens
+                }
+                : undefined,
+            stopReason: this.mapFinishReason(result.finishReason),
+            toolCalls
+        };
+    }
+    /**
+     * Parse tool calls from AI SDK response
+     */
+    parseToolCalls(toolCalls) {
+        return toolCalls.map((tc, index) => ({
+            id: `call_${index}`,
+            name: tc.toolName,
+            input: tc.args
+        }));
+    }
+    /**
+     * Format tool results for AI SDK
+     */
+    formatToolResults(results) {
+        // AI SDK handles tool results automatically in the execute callback
+        return results;
+    }
+    /**
+     * Map AI SDK finish reason to our format
+     */
+    mapFinishReason(reason) {
+        switch (reason) {
+            case 'stop':
+                return 'end_turn';
+            case 'length':
+                return 'max_tokens';
+            case 'tool-calls':
+                return 'tool_use';
+            case 'content-filter':
+            case 'error':
+                return 'stop_sequence';
+            default:
+                return undefined;
+        }
+    }
+}
+exports.VercelAIAdapter = VercelAIAdapter;
+//# sourceMappingURL=vercel-ai.js.map

package/dist/adapters/vercel-ai.js.map

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

package/dist/core/client.d.ts

@@ -0,0 +1,36 @@
+import { ClientConfig, ChatRequest, ChatResponse } from '../types';
+import { ToolRegistry } from './registry';
+/**
+ * Main client for provider-agnostic tool use
+ */
+export declare class Client {
+    private config;
+    private registry;
+    private executor?;
+    constructor(config: ClientConfig, registry?: ToolRegistry);
+    /**
+     * Get the tool registry
+     */
+    getRegistry(): ToolRegistry;
+    /**
+     * Send a chat message
+     */
+    chat(request: Omit<ChatRequest, 'tools'>): Promise<ChatResponse>;
+    /**
+     * Handle tool calls from LLM response
+     */
+    private handleToolCalls;
+    /**
+     * Handle programmatic tool calling (code execution)
+     */
+    private handleProgrammaticToolCall;
+    /**
+     * Execute tool calls
+     */
+    private executeToolCalls;
+    /**
+     * Helper method for simple text chat
+     */
+    ask(prompt: string, systemPrompt?: string): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EAIb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAe;gBAEpB,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,YAAY;IASzD;;OAEG;IACH,WAAW,IAAI,YAAY;IAI3B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BtE;;OAEG;YACW,eAAe;IAiC7B;;OAEG;YACW,0BAA0B;IAsCxC;;OAEG;YACW,gBAAgB;IA2D9B;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBlE"}

package/dist/core/client.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const registry_1 = require("./registry");
+const executor_1 = require("../executor");
+/**
+ * Main client for provider-agnostic tool use
+ */
+class Client {
+    constructor(config, registry) {
+        this.config = config;
+        this.registry = registry || new registry_1.ToolRegistry(config.searchConfig);
+        if (config.enableProgrammaticCalling) {
+            this.executor = (0, executor_1.createDefaultExecutor)(config.executorConfig);
+        }
+    }
+    /**
+     * Get the tool registry
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Send a chat message
+     */
+    async chat(request) {
+        const messages = [...request.messages];
+        // If tool search is enabled and provider doesn't support it natively,
+        // add the tool search tool to loaded tools
+        if (this.config.enableToolSearch &&
+            !this.config.adapter.capabilities.supportsNativeToolSearch) {
+            const toolSearchTool = this.registry.createToolSearchTool();
+            this.registry.register(toolSearchTool);
+        }
+        // Get loaded tools for this request
+        const tools = this.registry.getLoadedTools();
+        // Make the request
+        const response = await this.config.adapter.chat({
+            ...request,
+            messages,
+            tools
+        });
+        // Handle tool calls if any
+        if (response.toolCalls && response.toolCalls.length > 0) {
+            return this.handleToolCalls(request, response);
+        }
+        return response;
+    }
+    /**
+     * Handle tool calls from LLM response
+     */
+    async handleToolCalls(originalRequest, response) {
+        const toolCalls = response.toolCalls;
+        // Check if any tool call is for code execution
+        const codeExecutionCall = toolCalls.find(tc => tc.name === 'code_execution');
+        if (codeExecutionCall && this.executor && this.config.enableProgrammaticCalling) {
+            return this.handleProgrammaticToolCall(originalRequest, response, codeExecutionCall);
+        }
+        // Regular tool execution
+        const results = await this.executeToolCalls(toolCalls);
+        // Add tool results to messages and continue conversation
+        const messages = [
+            ...originalRequest.messages,
+            response.message,
+            {
+                role: 'tool',
+                content: '',
+                toolResults: results
+            }
+        ];
+        return this.chat({
+            ...originalRequest,
+            messages
+        });
+    }
+    /**
+     * Handle programmatic tool calling (code execution)
+     */
+    async handleProgrammaticToolCall(originalRequest, response, codeCall) {
+        const code = codeCall.input.code;
+        const tools = this.registry.getLoadedTools();
+        // Execute the code with access to tools
+        const execResult = await this.executor.execute(code, tools);
+        // Create tool result message
+        const result = {
+            toolCallId: codeCall.id,
+            data: {
+                stdout: execResult.stdout,
+                returnValue: execResult.returnValue
+            },
+            error: execResult.error
+        };
+        // Continue conversation with execution result
+        const messages = [
+            ...originalRequest.messages,
+            response.message,
+            {
+                role: 'tool',
+                content: '',
+                toolResults: [result]
+            }
+        ];
+        return this.chat({
+            ...originalRequest,
+            messages
+        });
+    }
+    /**
+     * Execute tool calls
+     */
+    async executeToolCalls(toolCalls) {
+        const results = [];
+        for (const call of toolCalls) {
+            const tool = this.registry.get(call.name);
+            if (!tool) {
+                results.push({
+                    toolCallId: call.id,
+                    error: {
+                        message: `Tool "${call.name}" not found`,
+                        code: 'TOOL_NOT_FOUND'
+                    }
+                });
+                continue;
+            }
+            // Special handling for tool_search
+            if (call.name === 'tool_search') {
+                try {
+                    const data = await tool.handler(call.input);
+                    results.push({
+                        toolCallId: call.id,
+                        data
+                    });
+                }
+                catch (error) {
+                    results.push({
+                        toolCallId: call.id,
+                        error: {
+                            message: error.message,
+                            code: 'EXECUTION_ERROR'
+                        }
+                    });
+                }
+                continue;
+            }
+            // Execute regular tool
+            try {
+                const data = await tool.handler(call.input);
+                results.push({
+                    toolCallId: call.id,
+                    data
+                });
+            }
+            catch (error) {
+                results.push({
+                    toolCallId: call.id,
+                    error: {
+                        message: error.message,
+                        code: 'EXECUTION_ERROR',
+                        details: error
+                    }
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Helper method for simple text chat
+     */
+    async ask(prompt, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({
+                role: 'system',
+                content: systemPrompt
+            });
+        }
+        messages.push({
+            role: 'user',
+            content: prompt
+        });
+        const response = await this.chat({ messages });
+        return typeof response.message.content === 'string'
+            ? response.message.content
+            : JSON.stringify(response.message.content);
+    }
+}
+exports.Client = Client;
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export { ToolRegistry } from './registry';
+export { Client } from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = exports.ToolRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_1.Client; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/dist/core/registry.d.ts

@@ -0,0 +1,64 @@
+import { ToolDefinition, SearchConfig } from '../types';
+/**
+ * Registry for managing tool definitions and discovery
+ */
+export declare class ToolRegistry {
+    private tools;
+    private deferredTools;
+    private loadedTools;
+    private searchStrategy;
+    constructor(searchConfig?: SearchConfig);
+    /**
+     * Register a tool
+     */
+    register(tool: ToolDefinition): void;
+    /**
+     * Register multiple tools at once
+     */
+    registerMany(tools: ToolDefinition[]): void;
+    /**
+     * Get a specific tool by name
+     */
+    get(name: string): ToolDefinition | undefined;
+    /**
+     * Load a deferred tool into active context
+     */
+    load(name: string): ToolDefinition | undefined;
+    /**
+     * Get all currently loaded tools
+     */
+    getLoadedTools(): ToolDefinition[];
+    /**
+     * Get all tools (including deferred)
+     */
+    getAllTools(): ToolDefinition[];
+    /**
+     * Search for tools matching a query
+     * @param query Search query
+     * @param maxResults Maximum results to return
+     * @param loadResults Whether to automatically load found tools
+     */
+    search(query: string, maxResults?: number, loadResults?: boolean): Promise<ToolDefinition[]>;
+    /**
+     * Clear all loaded tools (keeps registrations)
+     */
+    clearLoaded(): void;
+    /**
+     * Unregister a tool
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get statistics about the registry
+     */
+    getStats(): {
+        total: number;
+        loaded: number;
+        deferred: number;
+    };
+    /**
+     * Create a tool search tool definition
+     * This is a meta-tool that allows LLMs to search for other tools
+     */
+    createToolSearchTool(): ToolDefinition;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,YAAY,CAAC,EAAE,YAAY;IA6BvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAcpC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAI3C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAS9C;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAMlC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,UAAO,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC;IAa5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOjC;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB;IAQD;;;OAGG;IACH,oBAAoB,IAAI,cAAc;CAgCvC"}