@nexus-ai-nexoralabs/cli 0.1.0

package/dist/tools/toolExecutor.js

@@ -0,0 +1,440 @@
+import { FilesystemAdapter } from './adapters/filesystemAdapter.js';
+import { TerminalAdapter } from './adapters/terminalAdapter.js';
+import { TerminalCommandPolicy } from './adapters/terminalCommandPolicy.js';
+import { Logger } from '../common/logger.js';
+export class ToolExecutor {
+    fsAdapter;
+    terminalAdapter;
+    terminalPolicy;
+    logger;
+    workspaceRoot;
+    constructor(workspaceRoot, maxFileSize = 2 * 1024 * 1024, logLevel = 'info') {
+        this.logger = new Logger('ToolExecutor', logLevel);
+        this.workspaceRoot = workspaceRoot;
+        this.fsAdapter = new FilesystemAdapter(workspaceRoot, maxFileSize, logLevel);
+        this.terminalAdapter = new TerminalAdapter(workspaceRoot, logLevel);
+        this.terminalPolicy = new TerminalCommandPolicy(logLevel);
+    }
+    /**
+     * Get the workspace root directory path.
+     */
+    getWorkspaceRoot() {
+        return this.workspaceRoot;
+    }
+    /**
+     * Get the underlying filesystem adapter (useful for testing or direct sandbox checks).
+     */
+    getFilesystemAdapter() {
+        return this.fsAdapter;
+    }
+    /**
+     * Execute an authorized tool request.
+     *
+     * @param request Authorized ToolExecutionRequest.
+     * @returns Normalized ToolExecutionResult contract.
+     */
+    execute(request) {
+        const timestamp = new Date().toISOString();
+        // Handler 1: filesystem_read / fs_read_tool
+        if (request.toolId === 'filesystem_read' || request.toolId === 'fs_read_tool') {
+            const relativePath = request.params?.relativePath ?? request.params?.path;
+            if (typeof relativePath !== 'string') {
+                this.logger.warn(`Execution failed: invalid parameter`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    errorCategory: 'INVALID_INPUT',
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: 'INVALID_INPUT',
+                    errorMessage: "Tool parameter 'relativePath' or 'path' must be a non-empty string.",
+                    timestamp,
+                };
+            }
+            const readResult = this.fsAdapter.readFile(relativePath);
+            if (!readResult.success) {
+                this.logger.warn(`Tool execution failed`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    errorCategory: readResult.errorCategory,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: readResult.errorCategory,
+                    errorMessage: readResult.errorMessage,
+                    timestamp,
+                };
+            }
+            this.logger.info(`Tool execution succeeded`, {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                bytes: readResult.bytes,
+            });
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                executed: true,
+                success: true,
+                output: {
+                    content: readResult.content,
+                    bytes: readResult.bytes,
+                    relativePath: readResult.relativePath,
+                },
+                timestamp,
+            };
+        }
+        // Handler 2: workspace_tree (P6-A)
+        if (request.toolId === 'workspace_tree') {
+            const relPath = typeof request.params?.path === 'string' && request.params.path.trim() !== ''
+                ? request.params.path.trim()
+                : '.';
+            const maxDepth = typeof request.params?.maxDepth === 'number' ? request.params.maxDepth : undefined;
+            const maxEntries = typeof request.params?.maxEntries === 'number' ? request.params.maxEntries : undefined;
+            const treeResult = this.fsAdapter.getWorkspaceTree(relPath, { maxDepth, maxEntries });
+            if (!treeResult.success) {
+                this.logger.warn(`workspace_tree tool execution failed`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    errorCategory: treeResult.errorCategory,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: treeResult.errorCategory,
+                    errorMessage: treeResult.errorMessage,
+                    timestamp,
+                };
+            }
+            this.logger.info(`workspace_tree tool execution succeeded`, {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                totalEntries: treeResult.totalEntries,
+                truncated: treeResult.truncated,
+            });
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                executed: true,
+                success: true,
+                output: {
+                    root: treeResult.root,
+                    entries: treeResult.entries,
+                    totalEntries: treeResult.totalEntries,
+                    truncated: treeResult.truncated,
+                },
+                timestamp,
+            };
+        }
+        // Handler 3: code_search (P6-A)
+        if (request.toolId === 'code_search') {
+            const query = typeof request.params?.query === 'string' ? request.params.query : '';
+            const relPath = typeof request.params?.path === 'string' ? request.params.path : '.';
+            const maxResults = typeof request.params?.maxResults === 'number' ? request.params.maxResults : undefined;
+            const fileExtensions = Array.isArray(request.params?.fileExtensions)
+                ? request.params.fileExtensions
+                : undefined;
+            if (!query.trim()) {
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: 'INVALID_INPUT',
+                    errorMessage: "Tool parameter 'query' must be a non-empty string.",
+                    timestamp,
+                };
+            }
+            const searchResult = this.fsAdapter.searchCode(query, relPath, { maxResults, fileExtensions });
+            if (!searchResult.success) {
+                this.logger.warn(`code_search tool execution failed`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    errorCategory: searchResult.errorCategory,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: searchResult.errorCategory,
+                    errorMessage: searchResult.errorMessage,
+                    timestamp,
+                };
+            }
+            this.logger.info(`code_search tool execution succeeded`, {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                totalMatches: searchResult.totalMatches,
+                filesSearched: searchResult.filesSearched,
+                truncated: searchResult.truncated,
+            });
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                executed: true,
+                success: true,
+                output: {
+                    query: searchResult.query,
+                    results: searchResult.results,
+                    totalMatches: searchResult.totalMatches,
+                    filesSearched: searchResult.filesSearched,
+                    truncated: searchResult.truncated,
+                },
+                timestamp,
+            };
+        }
+        // Handler 4: filesystem_write (P6-B)
+        if (request.toolId === 'filesystem_write') {
+            const relPath = typeof request.params?.relativePath === 'string' && request.params.relativePath.trim() !== ''
+                ? request.params.relativePath.trim()
+                : typeof request.params?.path === 'string'
+                    ? request.params.path.trim()
+                    : '';
+            const content = typeof request.params?.content === 'string' ? request.params.content : undefined;
+            if (!relPath || content === undefined) {
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: 'INVALID_INPUT',
+                    errorMessage: "Tool parameters 'relativePath' (or 'path') and 'content' must be specified.",
+                    timestamp,
+                };
+            }
+            const writeResult = this.fsAdapter.writeFile(relPath, content);
+            if (!writeResult.success) {
+                this.logger.warn(`filesystem_write tool execution failed`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    errorCategory: writeResult.errorCategory,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: writeResult.errorCategory,
+                    errorMessage: writeResult.errorMessage,
+                    timestamp,
+                };
+            }
+            this.logger.info(`filesystem_write tool execution succeeded`, {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                path: writeResult.path,
+                bytesWritten: writeResult.bytesWritten,
+            });
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                executed: true,
+                success: true,
+                output: {
+                    path: writeResult.path,
+                    bytesWritten: writeResult.bytesWritten,
+                    created: writeResult.created,
+                    diff: writeResult.diff,
+                },
+                timestamp,
+            };
+        }
+        // Handler 5: filesystem_edit (P6-B)
+        if (request.toolId === 'filesystem_edit') {
+            const relPath = typeof request.params?.relativePath === 'string' && request.params.relativePath.trim() !== ''
+                ? request.params.relativePath.trim()
+                : typeof request.params?.path === 'string'
+                    ? request.params.path.trim()
+                    : '';
+            const expectedContentHash = typeof request.params?.expectedContentHash === 'string' ? request.params.expectedContentHash : '';
+            const oldText = typeof request.params?.oldText === 'string' ? request.params.oldText : '';
+            const newText = typeof request.params?.newText === 'string' ? request.params.newText : '';
+            const replaceMode = typeof request.params?.replaceMode === 'string' ? request.params.replaceMode : 'single';
+            if (!relPath || !expectedContentHash || !oldText || newText === undefined) {
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: 'INVALID_INPUT',
+                    errorMessage: "Tool parameters 'path', 'expectedContentHash', 'oldText', and 'newText' are required.",
+                    timestamp,
+                };
+            }
+            const editResult = this.fsAdapter.editFile(relPath, expectedContentHash, oldText, newText, replaceMode);
+            if (!editResult.success) {
+                this.logger.warn(`filesystem_edit tool execution failed`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    errorCategory: editResult.errorCategory,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: editResult.errorCategory,
+                    errorMessage: editResult.errorMessage,
+                    timestamp,
+                };
+            }
+            this.logger.info(`filesystem_edit tool execution succeeded`, {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                path: editResult.path,
+                bytesWritten: editResult.bytesWritten,
+            });
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                executed: true,
+                success: true,
+                output: {
+                    path: editResult.path,
+                    bytesWritten: editResult.bytesWritten,
+                    diff: editResult.diff,
+                },
+                timestamp,
+            };
+        }
+        // Handler 6: terminal_execute (P6-C)
+        if (request.toolId === 'terminal_execute') {
+            const command = typeof request.params?.command === 'string' ? request.params.command : '';
+            const args = Array.isArray(request.params?.args)
+                ? request.params.args
+                : [];
+            const cwd = typeof request.params?.cwd === 'string' ? request.params.cwd : undefined;
+            const timeoutMs = typeof request.params?.timeoutMs === 'number' ? request.params.timeoutMs : undefined;
+            const maxStdoutBytes = typeof request.params?.maxStdoutBytes === 'number' ? request.params.maxStdoutBytes : undefined;
+            const maxStderrBytes = typeof request.params?.maxStderrBytes === 'number' ? request.params.maxStderrBytes : undefined;
+            const params = {
+                command,
+                args,
+                cwd,
+                timeoutMs,
+                maxStdoutBytes,
+                maxStderrBytes,
+            };
+            // 1. Evaluate against TerminalCommandPolicy
+            const policyResult = this.terminalPolicy.evaluate(params);
+            if (!policyResult.allowed) {
+                this.logger.warn(`terminal_execute command policy rejected`, {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    decision: policyResult.decision,
+                    reason: policyResult.reason,
+                });
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: false,
+                    errorCategory: policyResult.decision,
+                    errorMessage: policyResult.reason,
+                    timestamp,
+                };
+            }
+            // 2. Dispatch to TerminalAdapter
+            const resolvedCommand = policyResult.resolvedCommand || command;
+            const resolvedArgs = policyResult.resolvedArgs || args;
+            return (async () => {
+                const termResult = await this.terminalAdapter.execute(resolvedCommand, resolvedArgs, params);
+                if (!termResult.success) {
+                    this.logger.warn(`terminal_execute tool execution failed`, {
+                        requestId: request.requestId,
+                        taskId: request.taskId,
+                        exitCode: termResult.exitCode,
+                        signal: termResult.signal,
+                        timedOut: termResult.timedOut,
+                        errorCategory: termResult.errorCategory,
+                    });
+                }
+                else {
+                    this.logger.info(`terminal_execute tool execution succeeded`, {
+                        requestId: request.requestId,
+                        taskId: request.taskId,
+                        durationMs: termResult.durationMs,
+                    });
+                }
+                return {
+                    requestId: request.requestId,
+                    taskId: request.taskId,
+                    toolId: request.toolId,
+                    executed: true,
+                    success: termResult.success,
+                    errorCategory: termResult.errorCategory,
+                    errorMessage: termResult.errorMessage,
+                    output: {
+                        success: termResult.success,
+                        exitCode: termResult.exitCode,
+                        signal: termResult.signal,
+                        stdout: termResult.stdout,
+                        stderr: termResult.stderr,
+                        stdoutTruncated: termResult.stdoutTruncated,
+                        stderrTruncated: termResult.stderrTruncated,
+                        durationMs: termResult.durationMs,
+                        timedOut: termResult.timedOut,
+                        cancelled: termResult.cancelled,
+                    },
+                    timestamp,
+                };
+            })();
+        }
+        // Default: unsupported tool execution
+        this.logger.warn(`Execution rejected: unsupported tool handler`, {
+            requestId: request.requestId,
+            taskId: request.taskId,
+            toolId: request.toolId,
+            errorCategory: 'UNSUPPORTED_TOOL_OPERATION',
+        });
+        return {
+            requestId: request.requestId,
+            taskId: request.taskId,
+            toolId: request.toolId,
+            executed: false,
+            success: false,
+            errorCategory: 'UNSUPPORTED_TOOL_OPERATION',
+            errorMessage: `Tool '${request.toolId}' does not have an active execution handler configured.`,
+            timestamp,
+        };
+    }
+    /**
+     * Get the underlying terminal adapter.
+     */
+    getTerminalAdapter() {
+        return this.terminalAdapter;
+    }
+    /**
+     * Get the underlying terminal command policy.
+     */
+    getTerminalPolicy() {
+        return this.terminalPolicy;
+    }
+}
+//# sourceMappingURL=toolExecutor.js.map

package/dist/tools/toolExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolExecutor.js","sourceRoot":"","sources":["../../src/tools/toolExecutor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAAE,MAAM,EAAY,MAAM,qBAAqB,CAAC;AAEvD,MAAM,OAAO,YAAY;IACf,SAAS,CAAoB;IAC7B,eAAe,CAAkB;IACjC,cAAc,CAAwB;IACtC,MAAM,CAAS;IACf,aAAa,CAAS;IAE9B,YACE,aAAqB,EACrB,cAAsB,CAAC,GAAG,IAAI,GAAG,IAAI,EACrC,WAAqB,MAAM;QAE3B,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QACpE,IAAI,CAAC,cAAc,GAAG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CACL,OAA6B;QAE7B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,4CAA4C;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,iBAAiB,IAAI,OAAO,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9E,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;YAE1E,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;oBACtD,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,eAAe;iBAC/B,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,eAAe;oBAC9B,YAAY,EAAE,qEAAqE;oBACnF,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAEzD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;oBACxC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,UAAU,CAAC,aAAa;iBACxC,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBAC3C,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,UAAU,CAAC,KAAK;aACxB,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;oBACvB,YAAY,EAAE,UAAU,CAAC,YAAY;iBACtC;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC3F,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC5B,CAAC,CAAC,GAAG,CAAC;YACR,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YACpG,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAE1G,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtF,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;oBACvD,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,UAAU,CAAC,aAAa;iBACxC,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;gBAC1D,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,SAAS,EAAE,UAAU,CAAC,SAAS;aAChC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,SAAS,EAAE,UAAU,CAAC,SAAS;iBAChC;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACrF,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1G,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC;gBAClE,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC,cAA2B;gBAC7C,CAAC,CAAC,SAAS,CAAC;YAEd,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClB,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,eAAe;oBAC9B,YAAY,EAAE,oDAAoD;oBAClE,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;YAE/F,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;oBACpD,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,YAAY,CAAC,aAAa;iBAC1C,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,YAAY,CAAC,aAAa;oBACzC,YAAY,EAAE,YAAY,CAAC,YAAY;oBACvC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBACvD,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,YAAY,CAAC,YAAY;gBACvC,aAAa,EAAE,YAAY,CAAC,aAAa;gBACzC,SAAS,EAAE,YAAY,CAAC,SAAS;aAClC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,KAAK,EAAE,YAAY,CAAC,KAAK;oBACzB,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,YAAY,EAAE,YAAY,CAAC,YAAY;oBACvC,aAAa,EAAE,YAAY,CAAC,aAAa;oBACzC,SAAS,EAAE,YAAY,CAAC,SAAS;iBAClC;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YAC1C,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC3F,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;gBACpC,CAAC,CAAC,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ;oBAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC5B,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAEjG,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,eAAe;oBAC9B,YAAY,EAAE,6EAA6E;oBAC3F,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;oBACzD,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,WAAW,CAAC,aAAa;iBACzC,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,WAAW,CAAC,aAAa;oBACxC,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;gBAC5D,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,YAAY,EAAE,WAAW,CAAC,YAAY;aACvC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,OAAO,EAAE,WAAW,CAAC,OAAO;oBAC5B,IAAI,EAAE,WAAW,CAAC,IAAI;iBACvB;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACzC,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC3F,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;gBACpC,CAAC,CAAC,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ;oBAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;oBAC5B,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,mBAAmB,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9H,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;YAE5G,IAAI,CAAC,OAAO,IAAI,CAAC,mBAAmB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1E,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,eAAe;oBAC9B,YAAY,EAAE,uFAAuF;oBACrG,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAExG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;oBACxD,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,aAAa,EAAE,UAAU,CAAC,aAAa;iBACxC,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;gBAC3D,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,YAAY,EAAE,UAAU,CAAC,YAAY;aACtC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,IAAI,EAAE,UAAU,CAAC,IAAI;iBACtB;gBACD,SAAS;aACV,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBAC9C,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC,IAAiB;gBACnC,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YACrF,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACvG,MAAM,cAAc,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;YACtH,MAAM,cAAc,GAAG,OAAO,OAAO,CAAC,MAAM,EAAE,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtH,MAAM,MAAM,GAA0B;gBACpC,OAAO;gBACP,IAAI;gBACJ,GAAG;gBACH,SAAS;gBACT,cAAc;gBACd,cAAc;aACf,CAAC;YAEF,4CAA4C;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE1D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;oBAC3D,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,YAAY,CAAC,QAAQ;oBAC/B,MAAM,EAAE,YAAY,CAAC,MAAM;iBAC5B,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,YAAY,CAAC,QAAkB;oBAC9C,YAAY,EAAE,YAAY,CAAC,MAAM;oBACjC,SAAS;iBACV,CAAC;YACJ,CAAC;YAED,iCAAiC;YACjC,MAAM,eAAe,GAAG,YAAY,CAAC,eAAe,IAAI,OAAO,CAAC;YAChE,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,IAAI,IAAI,CAAC;YAEvD,OAAO,CAAC,KAAK,IAAI,EAAE;gBACjB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;gBAE7F,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;wBACzD,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,aAAa,EAAE,UAAU,CAAC,aAAa;qBACxC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE;wBAC5D,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,UAAU,EAAE,UAAU,CAAC,UAAU;qBAClC,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO;oBACL,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,YAAY,EAAE,UAAU,CAAC,YAAY;oBACrC,MAAM,EAAE;wBACN,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,eAAe,EAAE,UAAU,CAAC,eAAe;wBAC3C,eAAe,EAAE,UAAU,CAAC,eAAe;wBAC3C,UAAU,EAAE,UAAU,CAAC,UAAU;wBACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;qBAChC;oBACD,SAAS;iBACV,CAAC;YACJ,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;YAC/D,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,4BAA4B;SAC5C,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,4BAA4B;YAC3C,YAAY,EAAE,SAAS,OAAO,CAAC,MAAM,yDAAyD;YAC9F,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/tools/toolRegistry.d.ts

@@ -0,0 +1,34 @@
+import type { ToolDefinition } from './types.js';
+import { LogLevel } from '../common/logger.js';
+export declare class ToolRegistry {
+    private tools;
+    private logger;
+    constructor(logLevel?: LogLevel);
+    /**
+     * Register a new tool definition into the registry.
+     * Throws an error if tool metadata is invalid or if a tool with the same ID already exists.
+     */
+    registerTool(definition: ToolDefinition): void;
+    /**
+     * Retrieve a registered tool by ID. Returns null if not found.
+     */
+    getTool(id: string): ToolDefinition | null;
+    /**
+     * List all registered tools.
+     */
+    listTools(): ToolDefinition[];
+    /**
+     * Enable or disable a registered tool.
+     * Returns true if updated, false if tool ID was not found.
+     */
+    setToolEnabled(id: string, enabled: boolean): boolean;
+    /**
+     * Check if a tool ID is registered.
+     */
+    isRegistered(id: string): boolean;
+    /**
+     * Clear all registered tools (used for testing or resetting environment).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=toolRegistry.d.ts.map

package/dist/tools/toolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/toolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,GAAE,QAAiB;IAIvC;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IA4C9C;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAK1C;;OAEG;IACH,SAAS,IAAI,cAAc,EAAE;IAO7B;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAUrD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/tools/toolRegistry.js

@@ -0,0 +1,92 @@
+import { VALID_CAPABILITIES } from './types.js';
+import { Logger } from '../common/logger.js';
+export class ToolRegistry {
+    tools = new Map();
+    logger;
+    constructor(logLevel = 'info') {
+        this.logger = new Logger('ToolRegistry', logLevel);
+    }
+    /**
+     * Register a new tool definition into the registry.
+     * Throws an error if tool metadata is invalid or if a tool with the same ID already exists.
+     */
+    registerTool(definition) {
+        if (!definition.id || typeof definition.id !== 'string' || definition.id.trim() === '') {
+            throw new Error('Tool registration failed: tool ID is required and must be a non-empty string.');
+        }
+        if (!definition.name || typeof definition.name !== 'string' || definition.name.trim() === '') {
+            throw new Error(`Tool registration failed: tool '${definition.id}' missing required name.`);
+        }
+        if (this.tools.has(definition.id)) {
+            throw new Error(`Tool registration failed: duplicate tool ID '${definition.id}' already registered.`);
+        }
+        if (!Array.isArray(definition.requiredPermissions)) {
+            throw new Error(`Tool registration failed: tool '${definition.id}' requiredPermissions must be an array.`);
+        }
+        for (const cap of definition.requiredPermissions) {
+            if (!VALID_CAPABILITIES.has(cap)) {
+                throw new Error(`Tool registration failed: tool '${definition.id}' specifies unknown capability '${cap}'.`);
+            }
+        }
+        const record = {
+            id: definition.id,
+            name: definition.name,
+            description: definition.description || '',
+            version: definition.version || '1.0.0',
+            category: definition.category || 'utility',
+            riskLevel: definition.riskLevel || 'low',
+            requiredPermissions: [...definition.requiredPermissions],
+            inputSchema: definition.inputSchema || {},
+            enabled: definition.enabled ?? true,
+        };
+        this.tools.set(record.id, record);
+        this.logger.info(`Registered tool '${record.id}'`, {
+            name: record.name,
+            category: record.category,
+            riskLevel: record.riskLevel,
+            enabled: record.enabled,
+        });
+    }
+    /**
+     * Retrieve a registered tool by ID. Returns null if not found.
+     */
+    getTool(id) {
+        const tool = this.tools.get(id);
+        return tool ? { ...tool, requiredPermissions: [...tool.requiredPermissions] } : null;
+    }
+    /**
+     * List all registered tools.
+     */
+    listTools() {
+        return Array.from(this.tools.values()).map((tool) => ({
+            ...tool,
+            requiredPermissions: [...tool.requiredPermissions],
+        }));
+    }
+    /**
+     * Enable or disable a registered tool.
+     * Returns true if updated, false if tool ID was not found.
+     */
+    setToolEnabled(id, enabled) {
+        const tool = this.tools.get(id);
+        if (!tool) {
+            return false;
+        }
+        tool.enabled = enabled;
+        this.logger.info(`Tool '${id}' state changed`, { enabled });
+        return true;
+    }
+    /**
+     * Check if a tool ID is registered.
+     */
+    isRegistered(id) {
+        return this.tools.has(id);
+    }
+    /**
+     * Clear all registered tools (used for testing or resetting environment).
+     */
+    clear() {
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=toolRegistry.js.map

package/dist/tools/toolRegistry.js.map

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