@nexus-cortex/executors 4.26.0

package/dist/implementations/execution/KillShellTool.js

@@ -0,0 +1,144 @@
+/**
+ * KillShell Tool Executor
+ *
+ * Terminates background shell processes started by ShellTool.
+ * Uses BackgroundProcessRegistry to track and kill processes.
+ *
+ * Ported from Gemini CLI kill-shell functionality
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { BackgroundProcessRegistry } from './BackgroundProcessRegistry.js';
+/**
+ * KillShell Tool Executor
+ *
+ * Features:
+ * - Terminates background shell processes by shell ID
+ * - Sends SIGTERM signal to process
+ * - Returns success/failure status
+ * - Removes terminated process from registry
+ */
+export class KillShellTool extends BaseTool {
+    config;
+    registry;
+    constructor(config) {
+        super('KillShell', 'KillShell', `Kills a running background bash shell by its ID. Sends SIGTERM signal to the process. Returns a success or failure status.`, {
+            type: 'object',
+            properties: {
+                shell_id: {
+                    type: 'string',
+                    description: 'The ID of the background shell to kill',
+                },
+            },
+            required: ['shell_id'],
+        });
+        this.config = config;
+        this.registry = BackgroundProcessRegistry.getInstance();
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Validate shell_id is not empty
+        if (!params.shell_id || !params.shell_id.trim()) {
+            return "The 'shell_id' parameter cannot be empty.";
+        }
+        return null;
+    }
+    getDescription(params) {
+        return `Killing background shell: ${params.shell_id}`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Check if process exists
+            const process = this.registry.getProcess(params.shell_id);
+            if (!process) {
+                return {
+                    ...this.createErrorResult(`Background shell '${params.shell_id}' not found. It may have already exited or been removed from the registry.`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        shell_id: params.shell_id,
+                        found: false,
+                    },
+                };
+            }
+            // Check if already not running
+            if (!process.isRunning) {
+                return {
+                    ...this.createSuccessResult(`Shell '${params.shell_id}' (PID: ${process.pid}) was already not running (exit code: ${process.exitCode}). Removed from registry.`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        shell_id: params.shell_id,
+                        pid: process.pid,
+                        wasRunning: false,
+                        exitCode: process.exitCode,
+                    },
+                };
+            }
+            // Attempt to kill the process
+            const killed = this.registry.killProcess(params.shell_id);
+            if (killed) {
+                // Wait a moment to see if process exits
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                // Remove from registry
+                this.registry.removeProcess(params.shell_id);
+                return {
+                    ...this.createSuccessResult(`Successfully killed shell '${params.shell_id}' (PID: ${process.pid}) and removed from registry.`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        shell_id: params.shell_id,
+                        pid: process.pid,
+                        killed: true,
+                    },
+                };
+            }
+            else {
+                return {
+                    ...this.createErrorResult(`Failed to kill shell '${params.shell_id}' (PID: ${process.pid}). Process may have already exited or permission denied.`),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        shell_id: params.shell_id,
+                        pid: process.pid,
+                        killed: false,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Kill operation was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        shell_id: params.shell_id,
+                    },
+                };
+            }
+            // Handle errors
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error killing shell: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    shell_id: params.shell_id,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=KillShellTool.js.map

package/dist/implementations/execution/KillShellTool.js.map

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

package/dist/implementations/execution/SearchToolsTool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Search Tools Tool
+ *
+ * Client-side tool discovery for non-PTC providers with deferred tool loading.
+ * Searches the tool registry by name, description, or category and returns
+ * matching tool schemas. Discovered tools are recorded in the progressive
+ * loading filter so they're included in subsequent requests.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+export interface SearchToolsParams {
+    /** Search query to match tool names and descriptions */
+    query?: string;
+    /** Filter by tool category (e.g., "execution", "search", "file") */
+    category?: string;
+}
+interface ToolEntry {
+    name: string;
+    description: string;
+    category?: string;
+    schema: unknown;
+}
+export declare class SearchToolsTool extends BaseTool<SearchToolsParams> {
+    private toolProvider?;
+    constructor();
+    setToolProvider(provider: () => ToolEntry[]): void;
+    validateToolParams(params: SearchToolsParams): string | null;
+    execute(params: SearchToolsParams, _signal: AbortSignal): Promise<ToolResult>;
+    private scoreMatch;
+    private toResults;
+}
+export {};
+//# sourceMappingURL=SearchToolsTool.d.ts.map

package/dist/implementations/execution/SearchToolsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchToolsTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/execution/SearchToolsTool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AASD,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IAC9D,OAAO,CAAC,YAAY,CAAC,CAAoB;;IAuBzC,eAAe,CAAC,QAAQ,EAAE,MAAM,SAAS,EAAE,GAAG,IAAI;IAIlD,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI;IAStD,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAwCnF,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,SAAS;CAQlB"}

package/dist/implementations/execution/SearchToolsTool.js

@@ -0,0 +1,109 @@
+/**
+ * Search Tools Tool
+ *
+ * Client-side tool discovery for non-PTC providers with deferred tool loading.
+ * Searches the tool registry by name, description, or category and returns
+ * matching tool schemas. Discovered tools are recorded in the progressive
+ * loading filter so they're included in subsequent requests.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+export class SearchToolsTool extends BaseTool {
+    toolProvider;
+    constructor() {
+        super('SearchTools', 'Search Tools', 'Search the tool registry to discover available tools by name, description, or category.', {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query — keywords matched against tool names and descriptions. Use "select:Name1,Name2" to fetch exact tools by name.',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Filter by tool category',
+                },
+            },
+        });
+    }
+    setToolProvider(provider) {
+        this.toolProvider = provider;
+    }
+    validateToolParams(params) {
+        const error = SchemaValidator.validate(this.parameterSchema, params);
+        if (error)
+            return error;
+        if (!params.query && !params.category) {
+            return 'At least one of "query" or "category" is required';
+        }
+        return null;
+    }
+    async execute(params, _signal) {
+        if (!this.toolProvider) {
+            return {
+                llmContent: JSON.stringify({ matches: 0, tools: [], error: 'Tool provider not configured' }),
+                success: false,
+                error: 'Tool provider not configured',
+            };
+        }
+        const allTools = this.toolProvider();
+        // "select:Name1,Name2" — exact name lookup (like CC's ToolSearch)
+        if (params.query?.startsWith('select:')) {
+            const names = params.query.slice(7).split(',').map((n) => n.trim());
+            const nameSet = new Set(names.map((n) => n.toLowerCase()));
+            const exact = allTools.filter((t) => nameSet.has(t.name.toLowerCase()));
+            return {
+                llmContent: JSON.stringify({ matches: exact.length, tools: this.toResults(exact) }),
+                success: true,
+            };
+        }
+        // Score-based keyword search
+        const scored = allTools.map((t) => ({
+            tool: t,
+            score: this.scoreMatch(t, params.query, params.category),
+        }));
+        const matches = scored
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, 10)
+            .map((s) => s.tool);
+        return {
+            llmContent: JSON.stringify({ matches: matches.length, tools: this.toResults(matches) }),
+            success: true,
+        };
+    }
+    scoreMatch(tool, query, category) {
+        let score = 0;
+        const nameLower = tool.name.toLowerCase();
+        const descLower = tool.description.toLowerCase();
+        if (category) {
+            const catLower = category.toLowerCase();
+            if (tool.category?.toLowerCase() === catLower) {
+                score += 5;
+            }
+            else if (nameLower.includes(catLower) || descLower.includes(catLower)) {
+                score += 2;
+            }
+        }
+        if (query) {
+            const words = query.toLowerCase().split(/\s+/).filter((w) => w.length > 1);
+            for (const word of words) {
+                if (nameLower === word)
+                    score += 10;
+                else if (nameLower.includes(word))
+                    score += 5;
+                if (descLower.includes(word))
+                    score += 1;
+            }
+        }
+        return score;
+    }
+    toResults(tools) {
+        return tools.map((t) => ({
+            name: t.name,
+            category: t.category,
+            description: t.description,
+            schema: t.schema,
+        }));
+    }
+}
+//# sourceMappingURL=SearchToolsTool.js.map

package/dist/implementations/execution/SearchToolsTool.js.map

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

package/dist/implementations/execution/ShellTool.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Shell Tool Executor
+ *
+ * Executes shell commands via bash/cmd and captures output.
+ * Supports background processes, timeouts, and abort handling.
+ *
+ * Adapted and simplified from Gemini CLI patterns
+ * - Removed: Complex allow/block lists, summarization
+ * - Kept: Core execution, background process detection, timeout enforcement
+ * - Simplified: Security model (path-based only)
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the Shell tool
+ */
+export interface ShellToolParams {
+    /**
+     * The bash command to execute
+     */
+    command: string;
+    /**
+     * Optional directory to run the command in (relative to working directory)
+     */
+    directory?: string;
+    /**
+     * Optional timeout in milliseconds (default: 120000ms = 2 minutes)
+     */
+    timeout?: number;
+    /**
+     * Run command in background and return immediately with a bash_id.
+     * Use BashOutput to poll output, KillShell to stop.
+     */
+    run_in_background?: boolean;
+    /**
+     * Run command in persistent tmux session (requires tmux)
+     */
+    persistentSession?: boolean;
+    /**
+     * ID of persistent session (auto-generated if not provided)
+     */
+    sessionId?: string;
+    /**
+     * Capture entire scrollback history (for persistent sessions)
+     */
+    captureHistory?: boolean;
+}
+/**
+ * Shell Tool Executor
+ *
+ * Features:
+ * - Executes commands via bash -c (or cmd.exe on Windows)
+ * - Captures stdout, stderr, exit code
+ * - Background process detection (Unix only)
+ * - Timeout enforcement
+ * - Abort signal support
+ * - Streaming output updates
+ *
+ * Security:
+ * - Commands run in specified working directory
+ * - Path traversal prevention for directory parameter
+ * - Blocks command substitution with $()
+ */
+export declare class ShellTool extends BaseTool<ShellToolParams, ToolResult> {
+    private config;
+    private static readonly DEFAULT_TIMEOUT_MS;
+    private static readonly OUTPUT_UPDATE_INTERVAL_MS;
+    private static readonly MAX_OUTPUT_LENGTH;
+    private tmux;
+    private persistence;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: ShellToolParams): string | null;
+    getDescription(params: ShellToolParams): string;
+    execute(params: ShellToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Executes the shell command and captures output
+     * @private
+     */
+    private executeCommand;
+    /**
+     * Kills a process and its children
+     * @private
+     */
+    private killProcess;
+    /**
+     * Execute command in persistent tmux session
+     * @private
+     */
+    private executeInPersistentSession;
+    /**
+     * Checks if a command should be routed to a dedicated tool instead of Bash.
+     * Returns an error message with guidance if redirected, or null if allowed.
+     * @private
+     */
+    private checkToolRedirect;
+    /**
+     * Execute command in background — returns immediately with bash_id.
+     * The process is registered in BackgroundProcessRegistry for polling via BashOutput.
+     * @private
+     */
+    private executeInBackground;
+    /**
+     * Removes ANSI escape codes from string
+     * @private
+     */
+    private stripAnsi;
+}
+//# sourceMappingURL=ShellTool.d.ts.map

package/dist/implementations/execution/ShellTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/execution/ShellTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IAQtD,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAQ;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAElD,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,WAAW,CAAqB;gBAEpB,MAAM,EAAE,cAAc;IAgC1C,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IA0D1D,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAYzC,OAAO,CACX,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAqDtB;;;OAGG;YACW,cAAc;IAsM5B;;;OAGG;YACW,WAAW;IA2BzB;;;OAGG;YACW,0BAA0B;IAmFxC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA2D3B;;;OAGG;IACH,OAAO,CAAC,SAAS;CAOlB"}