llm-advanced-tools 0.1.0

package/dist/core/registry.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+const search_1 = require("../search");
+/**
+ * Registry for managing tool definitions and discovery
+ */
+class ToolRegistry {
+    constructor(searchConfig) {
+        this.tools = new Map();
+        this.deferredTools = new Map();
+        this.loadedTools = new Set();
+        // Initialize search strategy
+        if (searchConfig?.customSearchFn) {
+            this.searchStrategy = {
+                search: async (query, tools) => searchConfig.customSearchFn(query, tools)
+            };
+        }
+        else {
+            const strategy = searchConfig?.strategy ?? 'smart';
+            const maxResults = searchConfig?.maxResults ?? 10;
+            const threshold = searchConfig?.threshold ?? 0.0;
+            // Map user-friendly names (and legacy names) to implementations
+            // 'smart' or 'bm25' → BM25 (best relevance ranking)
+            // 'keyword' or 'regex' → Regex (fast keyword matching)
+            const useSmartSearch = strategy === 'smart' ||
+                strategy === 'bm25';
+            this.searchStrategy = useSmartSearch
+                ? new search_1.BM25SearchStrategy(maxResults, threshold)
+                : new search_1.RegexSearchStrategy(maxResults, threshold);
+        }
+    }
+    /**
+     * Register a tool
+     */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+        if (tool.deferLoading) {
+            this.deferredTools.set(tool.name, tool);
+        }
+        else {
+            this.loadedTools.add(tool.name);
+        }
+    }
+    /**
+     * Register multiple tools at once
+     */
+    registerMany(tools) {
+        tools.forEach(tool => this.register(tool));
+    }
+    /**
+     * Get a specific tool by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Load a deferred tool into active context
+     */
+    load(name) {
+        const tool = this.deferredTools.get(name);
+        if (tool) {
+            this.loadedTools.add(name);
+            return tool;
+        }
+        return undefined;
+    }
+    /**
+     * Get all currently loaded tools
+     */
+    getLoadedTools() {
+        return Array.from(this.loadedTools)
+            .map(name => this.tools.get(name))
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Get all tools (including deferred)
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Search for tools matching a query
+     * @param query Search query
+     * @param maxResults Maximum results to return
+     * @param loadResults Whether to automatically load found tools
+     */
+    async search(query, maxResults, loadResults = true) {
+        // Search within deferred tools
+        const deferredToolsList = Array.from(this.deferredTools.values());
+        const results = await this.searchStrategy.search(query, deferredToolsList, maxResults);
+        // Optionally load the found tools
+        if (loadResults) {
+            results.forEach(tool => this.loadedTools.add(tool.name));
+        }
+        return results;
+    }
+    /**
+     * Clear all loaded tools (keeps registrations)
+     */
+    clearLoaded() {
+        this.loadedTools.clear();
+        // Re-add non-deferred tools
+        this.tools.forEach((tool, name) => {
+            if (!tool.deferLoading) {
+                this.loadedTools.add(name);
+            }
+        });
+    }
+    /**
+     * Unregister a tool
+     */
+    unregister(name) {
+        const deleted = this.tools.delete(name);
+        this.deferredTools.delete(name);
+        this.loadedTools.delete(name);
+        return deleted;
+    }
+    /**
+     * Get statistics about the registry
+     */
+    getStats() {
+        return {
+            total: this.tools.size,
+            loaded: this.loadedTools.size,
+            deferred: this.deferredTools.size
+        };
+    }
+    /**
+     * Create a tool search tool definition
+     * This is a meta-tool that allows LLMs to search for other tools
+     */
+    createToolSearchTool() {
+        return {
+            name: 'tool_search',
+            description: 'Search for available tools by name or description. Use this when you need to find tools for a specific task.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query describing the capability you need'
+                    },
+                    maxResults: {
+                        type: 'number',
+                        description: 'Maximum number of tools to return',
+                        default: 5
+                    }
+                },
+                required: ['query']
+            },
+            handler: async (input) => {
+                const results = await this.search(input.query, input.maxResults ?? 5, true);
+                return {
+                    tools: results.map(tool => ({
+                        name: tool.name,
+                        description: tool.description
+                    })),
+                    count: results.length
+                };
+            }
+        };
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":";;;AACA,sCAAoF;AAEpF;;GAEG;AACH,MAAa,YAAY;IAMvB,YAAY,YAA2B;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAE7B,6BAA6B;QAC7B,IAAI,YAAY,EAAE,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,GAAG;gBACpB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC7B,YAAY,CAAC,cAAe,CAAC,KAAK,EAAE,KAAK,CAAC;aAC7C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,OAAO,CAAC;YACnD,MAAM,UAAU,GAAG,YAAY,EAAE,UAAU,IAAI,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,YAAY,EAAE,SAAS,IAAI,GAAG,CAAC;YAEjD,gEAAgE;YAChE,oDAAoD;YACpD,uDAAuD;YACvD,MAAM,cAAc,GAClB,QAAQ,KAAK,OAAO;gBACpB,QAAQ,KAAK,MAAM,CAAC;YAEtB,IAAI,CAAC,cAAc,GAAG,cAAc;gBAClC,CAAC,CAAC,IAAI,2BAAkB,CAAC,UAAU,EAAE,SAAS,CAAC;gBAC/C,CAAC,CAAC,IAAI,4BAAmB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAuB;QAClC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;aAChC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,IAAI,EAA0B,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,UAAmB,EACnB,WAAW,GAAG,IAAI;QAElB,+BAA+B;QAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAEvF,kCAAkC;QAClC,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,4BAA4B;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACtB,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC7B,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;SAClC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,8GAA8G;YAChH,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iDAAiD;qBAC/D;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;wBAChD,OAAO,EAAE,CAAC;qBACX;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAE,EAAE;gBAC/D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC5E,OAAO;oBACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,WAAW,EAAE,IAAI,CAAC,WAAW;qBAC9B,CAAC,CAAC;oBACH,KAAK,EAAE,OAAO,CAAC,MAAM;iBACtB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AA/LD,oCA+LC"}

package/dist/executor/base.d.ts

@@ -0,0 +1,35 @@
+import { ExecutionResult, ExecutorConfig, ToolDefinition, ToolCall } from '../types';
+/**
+ * Base interface for code executors
+ */
+export interface CodeExecutor {
+    /**
+     * Execute code with access to tools
+     * @param code Code to execute
+     * @param tools Available tools that can be called from code
+     * @param context Additional context/variables
+     */
+    execute(code: string, tools: ToolDefinition[], context?: Record<string, any>): Promise<ExecutionResult>;
+}
+/**
+ * Abstract base class for code executors
+ */
+export declare abstract class BaseCodeExecutor implements CodeExecutor {
+    protected config: ExecutorConfig;
+    protected pendingToolCalls: ToolCall[];
+    constructor(config?: ExecutorConfig);
+    abstract execute(code: string, tools: ToolDefinition[], context?: Record<string, any>): Promise<ExecutionResult>;
+    /**
+     * Create a tool wrapper function that the executed code can call
+     */
+    protected createToolWrapper(tool: ToolDefinition): (...args: any[]) => Promise<any>;
+    /**
+     * Create the context object with tool functions
+     */
+    protected createExecutionContext(tools: ToolDefinition[], additionalContext?: Record<string, any>): Record<string, any>;
+    /**
+     * Wrap code with timeout
+     */
+    protected withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/executor/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,8BAAsB,gBAAiB,YAAW,YAAY;IAC5D,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;IACjC,SAAS,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAM;gBAEhC,MAAM,GAAE,cAAmB;IAQvC,QAAQ,CAAC,OAAO,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC;IAqCnF;;OAEG;IACH,SAAS,CAAC,sBAAsB,CAC9B,KAAK,EAAE,cAAc,EAAE,EACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAqBtB;;OAEG;cACa,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC;CAQd"}

package/dist/executor/base.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCodeExecutor = void 0;
+/**
+ * Abstract base class for code executors
+ */
+class BaseCodeExecutor {
+    constructor(config = {}) {
+        this.pendingToolCalls = [];
+        this.config = {
+            timeout: 30000, // 30 seconds default
+            memoryLimit: '256mb',
+            ...config
+        };
+    }
+    /**
+     * Create a tool wrapper function that the executed code can call
+     */
+    createToolWrapper(tool) {
+        return async (...args) => {
+            // Determine input based on schema
+            let input;
+            if (args.length === 1 && typeof args[0] === 'object') {
+                input = args[0];
+            }
+            else {
+                // If multiple args, create object from schema
+                // This is simplified - in reality would need to parse schema
+                input = args[0];
+            }
+            // Generate unique ID for this call
+            const callId = `call_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+            // Record the tool call
+            this.pendingToolCalls.push({
+                id: callId,
+                name: tool.name,
+                input,
+                caller: {
+                    type: 'code_execution',
+                    toolId: 'code_exec'
+                }
+            });
+            // Execute the tool
+            try {
+                const result = await tool.handler(input);
+                return result;
+            }
+            catch (error) {
+                throw new Error(`Tool ${tool.name} failed: ${error}`);
+            }
+        };
+    }
+    /**
+     * Create the context object with tool functions
+     */
+    createExecutionContext(tools, additionalContext) {
+        const context = {
+            console: {
+                log: (...args) => {
+                    // Capture console output
+                    return args.join(' ');
+                }
+            },
+            ...additionalContext
+        };
+        // Add each tool as a callable function
+        tools.forEach(tool => {
+            if (tool.allowedCallers?.includes('code_execution')) {
+                context[tool.name] = this.createToolWrapper(tool);
+            }
+        });
+        return context;
+    }
+    /**
+     * Wrap code with timeout
+     */
+    async withTimeout(promise, timeoutMs) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Execution timeout')), timeoutMs))
+        ]);
+    }
+}
+exports.BaseCodeExecutor = BaseCodeExecutor;
+//# sourceMappingURL=base.js.map

package/dist/executor/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/executor/base.ts"],"names":[],"mappings":";;;AAmBA;;GAEG;AACH,MAAsB,gBAAgB;IAIpC,YAAY,SAAyB,EAAE;QAF7B,qBAAgB,GAAe,EAAE,CAAC;QAG1C,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,KAAK,EAAE,qBAAqB;YACrC,WAAW,EAAE,OAAO;YACpB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAQD;;OAEG;IACO,iBAAiB,CAAC,IAAoB;QAC9C,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;YAC9B,kCAAkC;YAClC,IAAI,KAAU,CAAC;YAEf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrD,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,8CAA8C;gBAC9C,6DAA6D;gBAC7D,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAE/E,uBAAuB;YACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBACzB,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK;gBACL,MAAM,EAAE;oBACN,IAAI,EAAE,gBAAgB;oBACtB,MAAM,EAAE,WAAW;iBACpB;aACF,CAAC,CAAC;YAEH,mBAAmB;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,sBAAsB,CAC9B,KAAuB,EACvB,iBAAuC;QAEvC,MAAM,OAAO,GAAwB;YACnC,OAAO,EAAE;gBACP,GAAG,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;oBACtB,yBAAyB;oBACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxB,CAAC;aACF;YACD,GAAG,iBAAiB;SACrB,CAAC;QAEF,uCAAuC;QACvC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnB,IAAI,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,WAAW,CACzB,OAAmB,EACnB,SAAiB;QAEjB,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,CAAC,CACpE;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAnGD,4CAmGC"}

package/dist/executor/index.d.ts

@@ -0,0 +1,3 @@
+export { CodeExecutor, BaseCodeExecutor } from './base';
+export { VMExecutor, createDefaultExecutor } from './vm';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/executor/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultExecutor = exports.VMExecutor = exports.BaseCodeExecutor = void 0;
+var base_1 = require("./base");
+Object.defineProperty(exports, "BaseCodeExecutor", { enumerable: true, get: function () { return base_1.BaseCodeExecutor; } });
+var vm_1 = require("./vm");
+Object.defineProperty(exports, "VMExecutor", { enumerable: true, get: function () { return vm_1.VMExecutor; } });
+Object.defineProperty(exports, "createDefaultExecutor", { enumerable: true, get: function () { return vm_1.createDefaultExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":";;;AAAA,+BAAwD;AAAjC,wGAAA,gBAAgB,OAAA;AACvC,2BAAyD;AAAhD,gGAAA,UAAU,OAAA;AAAE,2GAAA,qBAAqB,OAAA"}

package/dist/executor/vm.d.ts

@@ -0,0 +1,18 @@
+import { ExecutionResult, ExecutorConfig, ToolDefinition } from '../types';
+import { BaseCodeExecutor } from './base';
+/**
+ * VM-based code executor
+ *
+ * WARNING: This provides basic isolation but is NOT secure for untrusted code.
+ * For production use with untrusted code, use DockerExecutor or a cloud
+ * sandbox service like E2B.
+ */
+export declare class VMExecutor extends BaseCodeExecutor {
+    constructor(config?: ExecutorConfig);
+    execute(code: string, tools: ToolDefinition[], context?: Record<string, any>): Promise<ExecutionResult>;
+}
+/**
+ * Create a default executor instance
+ */
+export declare function createDefaultExecutor(config?: ExecutorConfig): VMExecutor;
+//# sourceMappingURL=vm.d.ts.map

package/dist/executor/vm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm.d.ts","sourceRoot":"","sources":["../../src/executor/vm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG1C;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,gBAAgB;gBAClC,MAAM,GAAE,cAAmB;IAIjC,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,eAAe,CAAC;CA2D5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAEzE"}

package/dist/executor/vm.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VMExecutor = void 0;
+exports.createDefaultExecutor = createDefaultExecutor;
+const base_1 = require("./base");
+const vm = __importStar(require("vm"));
+/**
+ * VM-based code executor
+ *
+ * WARNING: This provides basic isolation but is NOT secure for untrusted code.
+ * For production use with untrusted code, use DockerExecutor or a cloud
+ * sandbox service like E2B.
+ */
+class VMExecutor extends base_1.BaseCodeExecutor {
+    constructor(config = {}) {
+        super(config);
+    }
+    async execute(code, tools, context) {
+        this.pendingToolCalls = [];
+        const capturedLogs = [];
+        let returnValue;
+        try {
+            // Create execution context with tools
+            const execContext = this.createExecutionContext(tools, context);
+            // Override console.log to capture output
+            execContext.console = {
+                log: (...args) => {
+                    const message = args.map(arg => typeof arg === 'object' ? JSON.stringify(arg) : String(arg)).join(' ');
+                    capturedLogs.push(message);
+                }
+            };
+            // Wrap code in async function
+            const wrappedCode = `
+        (async () => {
+          ${code}
+        })()
+      `;
+            // Create VM context
+            const vmContext = vm.createContext(execContext);
+            // Execute with timeout
+            const script = new vm.Script(wrappedCode);
+            const result = await this.withTimeout(script.runInContext(vmContext, {
+                timeout: this.config.timeout
+            }), this.config.timeout);
+            returnValue = result;
+            return {
+                success: true,
+                stdout: capturedLogs.join('\n'),
+                returnValue,
+                toolCalls: this.pendingToolCalls
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                stderr: error.message,
+                error: {
+                    message: error.message,
+                    stack: error.stack
+                },
+                toolCalls: this.pendingToolCalls
+            };
+        }
+    }
+}
+exports.VMExecutor = VMExecutor;
+/**
+ * Create a default executor instance
+ */
+function createDefaultExecutor(config) {
+    return new VMExecutor(config);
+}
+//# sourceMappingURL=vm.js.map

package/dist/executor/vm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm.js","sourceRoot":"","sources":["../../src/executor/vm.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,sDAEC;AArFD,iCAA0C;AAC1C,uCAAyB;AAEzB;;;;;;GAMG;AACH,MAAa,UAAW,SAAQ,uBAAgB;IAC9C,YAAY,SAAyB,EAAE;QACrC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,KAAuB,EACvB,OAA6B;QAE7B,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAE3B,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,WAAgB,CAAC;QAErB,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAEhE,yCAAyC;YACzC,WAAW,CAAC,OAAO,GAAG;gBACpB,GAAG,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;oBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC7B,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAC5D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACZ,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC7B,CAAC;aACF,CAAC;YAEF,8BAA8B;YAC9B,MAAM,WAAW,GAAG;;YAEd,IAAI;;OAET,CAAC;YAEF,oBAAoB;YACpB,MAAM,SAAS,GAAG,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAEhD,uBAAuB;YACvB,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CACnC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;gBAC7B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;aAC7B,CAAC,EACF,IAAI,CAAC,MAAM,CAAC,OAAQ,CACrB,CAAC;YAEF,WAAW,GAAG,MAAM,CAAC;YAErB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC/B,WAAW;gBACX,SAAS,EAAE,IAAI,CAAC,gBAAgB;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,KAAK,CAAC,OAAO;gBACrB,KAAK,EAAE;oBACL,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB;gBACD,SAAS,EAAE,IAAI,CAAC,gBAAgB;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApED,gCAoEC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IAC3D,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Client, ToolRegistry } from './core';
+export type { ToolDefinition, ToolCall, ToolResult, Message, ChatRequest, ChatResponse, SearchConfig, ExecutorConfig, ProviderAdapter, ProviderCapabilities, ClientConfig } from './types';
+export { OpenAIAdapter, VercelAIAdapter } from './adapters';
+export { SearchStrategy, RegexSearchStrategy, BM25SearchStrategy } from './search';
+export { CodeExecutor, VMExecutor, createDefaultExecutor } from './executor';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG9C,YAAY,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultExecutor = exports.VMExecutor = exports.BM25SearchStrategy = exports.RegexSearchStrategy = exports.VercelAIAdapter = exports.OpenAIAdapter = exports.ToolRegistry = exports.Client = void 0;
+// Core exports
+var core_1 = require("./core");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return core_1.Client; } });
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return core_1.ToolRegistry; } });
+// Adapter exports
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return adapters_1.OpenAIAdapter; } });
+Object.defineProperty(exports, "VercelAIAdapter", { enumerable: true, get: function () { return adapters_1.VercelAIAdapter; } });
+// Search exports
+var search_1 = require("./search");
+Object.defineProperty(exports, "RegexSearchStrategy", { enumerable: true, get: function () { return search_1.RegexSearchStrategy; } });
+Object.defineProperty(exports, "BM25SearchStrategy", { enumerable: true, get: function () { return search_1.BM25SearchStrategy; } });
+// Executor exports
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "VMExecutor", { enumerable: true, get: function () { return executor_1.VMExecutor; } });
+Object.defineProperty(exports, "createDefaultExecutor", { enumerable: true, get: function () { return executor_1.createDefaultExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,+BAA8C;AAArC,8FAAA,MAAM,OAAA;AAAE,oGAAA,YAAY,OAAA;AAiB7B,kBAAkB;AAClB,uCAA4D;AAAnD,yGAAA,aAAa,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEvC,iBAAiB;AACjB,mCAAmF;AAA1D,6GAAA,mBAAmB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAEhE,mBAAmB;AACnB,uCAA6E;AAAtD,sGAAA,UAAU,OAAA;AAAE,iHAAA,qBAAqB,OAAA"}

package/dist/search/base.d.ts

@@ -0,0 +1,32 @@
+import { ToolDefinition } from '../types';
+/**
+ * Base interface for tool search strategies
+ */
+export interface SearchStrategy {
+    /**
+     * Search for tools matching the query
+     * @param query Search query
+     * @param tools Available tools to search
+     * @param maxResults Maximum number of results to return
+     * @returns Matching tools, sorted by relevance
+     */
+    search(query: string, tools: ToolDefinition[], maxResults?: number): Promise<ToolDefinition[]>;
+}
+/**
+ * Abstract base class for search strategies
+ */
+export declare abstract class BaseSearchStrategy implements SearchStrategy {
+    protected maxResults: number;
+    protected threshold: number;
+    constructor(maxResults?: number, threshold?: number);
+    abstract search(query: string, tools: ToolDefinition[], maxResults?: number): Promise<ToolDefinition[]>;
+    /**
+     * Calculate relevance score for a tool
+     */
+    protected abstract scoreRelevance(query: string, tool: ToolDefinition): number;
+    /**
+     * Rank tools by relevance
+     */
+    protected rankTools(query: string, tools: ToolDefinition[], maxResults?: number): ToolDefinition[];
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/search/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,8BAAsB,kBAAmB,YAAW,cAAc;IAChE,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEhB,UAAU,SAAK,EAAE,SAAS,SAAM;IAK5C,QAAQ,CAAC,MAAM,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM;IAE9E;;OAEG;IACH,SAAS,CAAC,SAAS,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,EAAE;CAYpB"}

package/dist/search/base.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSearchStrategy = void 0;
+/**
+ * Abstract base class for search strategies
+ */
+class BaseSearchStrategy {
+    constructor(maxResults = 10, threshold = 0.0) {
+        this.maxResults = maxResults;
+        this.threshold = threshold;
+    }
+    /**
+     * Rank tools by relevance
+     */
+    rankTools(query, tools, maxResults) {
+        const scored = tools
+            .map(tool => ({
+            tool,
+            score: this.scoreRelevance(query, tool)
+        }))
+            .filter(({ score }) => score >= this.threshold)
+            .sort((a, b) => b.score - a.score);
+        const limit = maxResults ?? this.maxResults;
+        return scored.slice(0, limit).map(({ tool }) => tool);
+    }
+}
+exports.BaseSearchStrategy = BaseSearchStrategy;
+//# sourceMappingURL=base.js.map

package/dist/search/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/search/base.ts"],"names":[],"mappings":";;;AAoBA;;GAEG;AACH,MAAsB,kBAAkB;IAItC,YAAY,UAAU,GAAG,EAAE,EAAE,SAAS,GAAG,GAAG;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAaD;;OAEG;IACO,SAAS,CACjB,KAAa,EACb,KAAuB,EACvB,UAAmB;QAEnB,MAAM,MAAM,GAAG,KAAK;aACjB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;SACxC,CAAC,CAAC;aACF,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC;aAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;QAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;CACF;AAvCD,gDAuCC"}

package/dist/search/bm25.d.ts

@@ -0,0 +1,16 @@
+import { ToolDefinition } from '../types';
+import { BaseSearchStrategy } from './base';
+/**
+ * BM25-based search strategy
+ * Better relevance ranking, handles synonyms and term frequency
+ */
+export declare class BM25SearchStrategy extends BaseSearchStrategy {
+    private tokenizer;
+    private tfidf;
+    private toolsIndex;
+    constructor(maxResults?: number, threshold?: number);
+    search(query: string, tools: ToolDefinition[], maxResults?: number): Promise<ToolDefinition[]>;
+    protected scoreRelevance(query: string, tool: ToolDefinition): number;
+    private buildIndex;
+}
+//# sourceMappingURL=bm25.d.ts.map

package/dist/search/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAG5C;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,UAAU,CAA8B;gBAEpC,UAAU,SAAK,EAAE,SAAS,SAAM;IAOtC,MAAM,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC;IAsB5B,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM;IAMrE,OAAO,CAAC,UAAU;CAWnB"}