@compass-ai/nova 1.0.72 → 1.0.74

package/dist/tools/shell-tools.js

@@ -0,0 +1,409 @@
+/**
+ * Shell/command execution tools
+ *
+ * Tools for executing shell commands with features like approval flow,
+ * background process management, and smart build output truncation.
+ */
+import { getShellExecutor, getPreferredShell } from '../services/shell-executor.js';
+import { getApprovalManager } from '../services/approval-manager.js';
+import { ActionType } from '../services/action-logger.js';
+import { getCacheService, CACHE_TTL } from '../services/cache-service.js';
+import { MAX_COMMAND_OUTPUT_TOKENS, SHELL_COMMAND_MAX_TIMEOUT_MS } from '../constants/defaults.js';
+import { INSTALL_HINTS } from '../constants/install-hints.js';
+import { smartTruncateBuildOutput, truncateToolResult, } from './shared-utils.js';
+import { logger } from '../utils/logger.js';
+export function registerShellTools(registry) {
+    const shell = getPreferredShell();
+    const isPowerShell = shell === 'powershell' || shell === 'pwsh';
+    const shellNote = isPowerShell
+        ? ' IMPORTANT: Commands run through PowerShell. Do NOT use "&&" to chain commands — it is not valid PowerShell syntax. Use ";" to separate sequential commands (e.g., "npm install ; npm run build"), or make separate execute_command calls.'
+        : '';
+    const commandExample = isPowerShell
+        ? 'The command to execute using PowerShell syntax (e.g., "npm test", "git status"). Do NOT use "&&" — use ";" to chain commands.'
+        : 'The command to execute (e.g., "npm test", "git status")';
+    registry.registerTool('execute_command', `Executes a shell command and WAITS for it to complete. Use for build tools, tests, linters, and short-lived operations only. Commands have a default timeout of 2 minutes (120000ms) and maximum of 10 minutes (600000ms). If a command times out, the result will have timedOut=true and the process will be killed.\n⚠️  NEVER use for web servers, dev servers, file watchers, or any process that runs until stopped (e.g. npm start, npm run dev, ui5 serve, vite, webpack serve). Doing so will permanently block execution. Use execute_background for those instead.${shellNote}`, {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: commandExample,
+            },
+            description: {
+                type: 'string',
+                description: 'Human-readable description of what this command does',
+            },
+            timeout: {
+                type: 'number',
+                description: `Maximum execution time in milliseconds. Default: 120000 (2 minutes). Maximum: ${SHELL_COMMAND_MAX_TIMEOUT_MS} (10 minutes). If the command exceeds this timeout, it will be killed and the result will have timedOut=true.`,
+                default: 120000,
+            },
+        },
+        required: ['command'],
+    }, async (input, context) => {
+        const shellExecutor = getShellExecutor();
+        const approvalManager = getApprovalManager();
+        // Debug: Log approval state
+        logger.info(`[execute_command] Requesting approval for: ${input.command}`);
+        logger.info(`[execute_command] Current mode: ${approvalManager.getMode()}`);
+        logger.info(`[execute_command] Session auto-approval: ${approvalManager.isSessionAutoApprovalEnabled()}`);
+        // Request approval before executing the command
+        const approvalResponse = await approvalManager.requestApproval('shell_command', input.description || `Execute command: ${input.command}`, {
+            command: input.command,
+            affectedFiles: 0,
+        });
+        logger.info(`[execute_command] Approval response: approved=${approvalResponse.approved}, reason=${approvalResponse.reason}`);
+        // If not approved, reject the operation
+        if (!approvalResponse.approved) {
+            return {
+                command: input.command,
+                exitCode: 1,
+                stdout: '',
+                stderr: '',
+                success: false,
+                timedOut: false,
+                duration: 0,
+                error: 'Operation rejected by user',
+            };
+        }
+        // Detect long-running server/watcher commands and redirect to execute_background
+        const SERVER_PATTERNS = [
+            /\bnpm\s+(run\s+)?(start|dev|serve|watch)\b/i,
+            /\byarn\s+(run\s+)?(start|dev|serve|watch)\b/i,
+            /\bpnpm\s+(run\s+)?(start|dev|serve|watch)\b/i,
+            /\bui5\s+serve\b/i,
+            /\bvite(\s+dev)?\b/i,
+            /\bwebpack(-dev-server|\s+serve)\b/i,
+            /\bng\s+serve\b/i,
+            /\bhttp-server\b/i,
+            /\bpython[3]?\s+-m\s+http\.server\b/i,
+            /\bnpx\s+(serve|http-server|vite|webpack-dev-server)\b/i,
+            // GUI/headed browser processes — block until window is closed
+            /\bplaywright(-cli)?\s+\S*\s*(open|show|record|codegen)\b/i,
+            /\b--headed\b/i,
+            /\bcypress\s+(open|run\s+--headed)\b/i,
+            /\belectron\b/i,
+            /\btauri\s+(dev|run)\b/i,
+        ];
+        const isServerCommand = SERVER_PATTERNS.some(p => p.test(input.command));
+        if (isServerCommand) {
+            return {
+                command: input.command,
+                exitCode: 1,
+                stdout: '',
+                stderr: '',
+                success: false,
+                timedOut: false,
+                duration: 0,
+                error: `"${input.command}" looks like a long-running server or watcher process. Use the execute_background tool instead — it starts the process without blocking and returns a processId so you can stop it later with kill_shell.`,
+            };
+        }
+        // Cap timeout at maximum allowed value
+        const requestedTimeout = input.timeout || 120000;
+        const timeout = Math.min(requestedTimeout, SHELL_COMMAND_MAX_TIMEOUT_MS);
+        const result = await shellExecutor.execute(input.command, {
+            cwd: context.projectRoot,
+            timeout,
+            toolCallId: context.toolCallId, // Enable real-time status updates in UI
+            signal: context.abortSignal,
+        });
+        // Check if the command was skipped by the user (Ctrl+X abort)
+        if (context.abortSignal?.aborted) {
+            const duration = result.duration ?? 0;
+            return {
+                command: input.command,
+                exitCode: result.exitCode ?? -1,
+                stdout: result.stdout || '',
+                stderr: result.stderr || '',
+                success: false,
+                skippedByUser: true,
+                duration,
+                outputTruncated: false,
+            };
+        }
+        // Try smart build truncation first (prioritizes errors/warnings for build commands)
+        const smartResult = smartTruncateBuildOutput(result.stdout || '', result.stderr || '', input.command, MAX_COMMAND_OUTPUT_TOKENS);
+        let finalStdout;
+        let finalStderr;
+        let wasTruncated;
+        if (smartResult.strategy === 'smart_build') {
+            // Smart build truncation was applied
+            finalStdout = smartResult.stdout;
+            finalStderr = smartResult.stderr;
+            wasTruncated = smartResult.wasTruncated;
+            if (wasTruncated) {
+                logger.info(`Smart build truncation applied for "${input.command.slice(0, 50)}...": errors/warnings prioritized`);
+            }
+        }
+        else {
+            // Standard truncation for non-build commands
+            const stdoutBudget = Math.floor(MAX_COMMAND_OUTPUT_TOKENS * 0.7);
+            const stderrBudget = Math.floor(MAX_COMMAND_OUTPUT_TOKENS * 0.3);
+            const stdoutResult = truncateToolResult(result.stdout || '', stdoutBudget, 'Command stdout');
+            const stderrResult = truncateToolResult(result.stderr || '', stderrBudget, 'Command stderr');
+            finalStdout = stdoutResult.content;
+            finalStderr = stderrResult.content;
+            wasTruncated = stdoutResult.wasTruncated || stderrResult.wasTruncated;
+            if (wasTruncated) {
+                logger.info(`Standard truncation for "${input.command.slice(0, 50)}...": stdout ${stdoutResult.originalTokens}->${stdoutResult.truncatedTokens}, stderr ${stderrResult.originalTokens}->${stderrResult.truncatedTokens}`);
+            }
+        }
+        return {
+            command: input.command,
+            exitCode: result.exitCode,
+            stdout: finalStdout,
+            stderr: finalStderr,
+            success: result.success,
+            timedOut: result.timedOut,
+            duration: result.duration,
+            outputTruncated: wasTruncated,
+            truncationStrategy: smartResult.strategy,
+        };
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false, // Approval is now handled internally in the handler
+        category: 'command_execution',
+        tags: ['shell', 'execute', 'build'],
+        displayName: 'Execute',
+    });
+    registry.registerTool('execute_and_verify', 'Executes a command and verifies it starts successfully by monitoring output for success/error patterns. Use this for long-running commands like "npm start", "npm run dev", or any dev server that you want to verify works but don\'t need to keep running. The process is automatically terminated after verification.', {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: 'The command to execute and verify (e.g., "npm start", "npm run dev")',
+            },
+            description: {
+                type: 'string',
+                description: 'Human-readable description of what this command does',
+            },
+            success_patterns: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Patterns that indicate successful startup (e.g., ["Listening on port", "Server started"]). Uses defaults if not provided.',
+            },
+            error_patterns: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Patterns that indicate an error (e.g., ["Error:", "EADDRINUSE"]). Uses defaults if not provided.',
+            },
+            verification_timeout: {
+                type: 'number',
+                description: 'Maximum time in milliseconds to wait for verification (default: 15000)',
+                default: 15000,
+            },
+        },
+        required: ['command'],
+    }, async (input, context) => {
+        const shellExecutor = getShellExecutor();
+        const approvalManager = getApprovalManager();
+        // Request approval before executing the command
+        const approvalResponse = await approvalManager.requestApproval('shell_command', input.description || `Execute and verify: ${input.command}`, {
+            command: input.command,
+            affectedFiles: 0,
+        });
+        // If not approved, reject the operation
+        if (!approvalResponse.approved) {
+            return {
+                command: input.command,
+                exitCode: 1,
+                stdout: '',
+                stderr: '',
+                success: false,
+                verified: false,
+                error: 'Operation rejected by user',
+            };
+        }
+        const result = await shellExecutor.executeAndVerify(input.command, {
+            cwd: context.projectRoot,
+            successPatterns: input.success_patterns,
+            errorPatterns: input.error_patterns,
+            verificationTimeout: input.verification_timeout || 15000,
+            toolCallId: context.toolCallId,
+            signal: context.abortSignal,
+        });
+        return {
+            command: input.command,
+            exitCode: result.exitCode,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            success: result.success,
+            verified: result.verified,
+            matchedPattern: result.matchedPattern,
+            terminatedAfterVerification: result.terminatedAfterVerification,
+            duration: result.duration,
+            message: result.verified
+                ? `Command verified successfully: ${result.matchedPattern}`
+                : result.matchedPattern
+                    ? `Command failed with error: ${result.matchedPattern}`
+                    : 'Verification timed out - no success or error pattern matched',
+        };
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false, // Approval is handled internally
+        category: 'command_execution',
+        tags: ['shell', 'execute', 'verify', 'dev-server'],
+        displayName: 'Verify',
+    });
+    registry.registerTool('execute_background', 'Executes a shell command in the background without blocking. REQUIRED for web servers, dev servers, watchers, and any process that runs until stopped (e.g. npm start, npm run dev, ui5 serve, vite, webpack serve). Returns a processId — use kill_shell to stop it when done.', {
+        type: 'object',
+        properties: {
+            command: {
+                type: 'string',
+                description: 'The command to execute in the background (e.g., "npm run dev", "python -m http.server")',
+            },
+            description: {
+                type: 'string',
+                description: 'Human-readable description of what this command does',
+            },
+        },
+        required: ['command'],
+    }, async (input, context) => {
+        const shellExecutor = getShellExecutor();
+        const result = shellExecutor.executeBackground(input.command, {
+            cwd: context.projectRoot,
+        });
+        if (result.status === 'blocked') {
+            return {
+                success: false,
+                error: `Command not allowed: ${input.command}`,
+            };
+        }
+        return {
+            success: true,
+            processId: result.id,
+            command: result.command,
+            status: result.status,
+            message: `Background process started with ID: ${result.id}. Use 'kill_shell' to stop it or 'list_processes' to check status.`,
+        };
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: true,
+        category: 'command_execution',
+        tags: ['shell', 'execute', 'background', 'async'],
+        displayName: 'Background',
+    });
+    registry.registerTool('kill_shell', 'Kills a running background shell process by its ID. Use this to stop long-running processes like dev servers or watch tasks.', {
+        type: 'object',
+        properties: {
+            process_id: {
+                type: 'string',
+                description: 'The ID of the background process to kill (returned by execute_background)',
+            },
+            signal: {
+                type: 'string',
+                enum: ['SIGTERM', 'SIGKILL', 'SIGINT'],
+                description: 'The signal to send to the process (default: SIGTERM)',
+                default: 'SIGTERM',
+            },
+        },
+        required: ['process_id'],
+    }, async (input) => {
+        const shellExecutor = getShellExecutor();
+        const signal = (input.signal || 'SIGTERM');
+        const result = shellExecutor.killProcess(input.process_id, signal);
+        if (!result.success) {
+            return {
+                success: false,
+                error: result.message,
+            };
+        }
+        return {
+            success: true,
+            processId: input.process_id,
+            message: result.message,
+            command: result.process?.command,
+            duration: result.process
+                ? Date.now() - new Date(result.process.startedAt).getTime()
+                : undefined,
+        };
+    }, {
+        actionType: ActionType.COMMAND_EXEC,
+        requiresApproval: false, // Killing is safe, process was already approved
+        category: 'command_execution',
+        tags: ['shell', 'kill', 'stop', 'process'],
+        displayName: 'Kill Shell',
+    });
+    registry.registerTool('list_processes', 'Lists all tracked background shell processes and their current status.', {
+        type: 'object',
+        properties: {
+            filter: {
+                type: 'string',
+                enum: ['running', 'completed', 'failed', 'killed'],
+                description: 'Optional filter by process status',
+            },
+        },
+        required: [],
+    }, async (input) => {
+        const shellExecutor = getShellExecutor();
+        const processes = shellExecutor.listProcesses(input.filter);
+        return {
+            count: processes.length,
+            filter: input.filter || 'all',
+            processes: processes.map((p) => ({
+                id: p.id,
+                command: p.command,
+                status: p.status,
+                startedAt: p.startedAt,
+                exitCode: p.exitCode,
+                stdoutPreview: p.stdout.slice(0, 200),
+                stderrPreview: p.stderr.slice(0, 200),
+            })),
+        };
+    }, {
+        actionType: ActionType.SEARCH,
+        requiresApproval: false,
+        category: 'command_execution',
+        tags: ['shell', 'list', 'process', 'status'],
+        displayName: 'Processes',
+    });
+    registry.registerTool('check_tool_availability', 'Checks whether one or more CLI tools/commands are available on the system. Returns availability status, version info for available commands, and install hints for missing ones. Use this before attempting to run a tool you are not sure is installed (e.g. kubectl, terraform, az, dotnet, cargo).', {
+        type: 'object',
+        properties: {
+            commands: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Command names to check (e.g. ["kubectl", "az", "terraform"])',
+            },
+        },
+        required: ['commands'],
+    }, async (input) => {
+        const shellExecutor = getShellExecutor();
+        const cache = getCacheService();
+        const platform = process.platform;
+        const results = {};
+        await Promise.all(input.commands.map(async (cmd) => {
+            const cacheKey = `tool_avail:${cmd}`;
+            const cached = cache.get(cacheKey);
+            if (cached !== undefined) {
+                results[cmd] = { ...cached };
+                if (!cached.available) {
+                    const hint = INSTALL_HINTS[cmd]?.[platform];
+                    if (hint)
+                        results[cmd].install_hint = hint;
+                }
+                return;
+            }
+            const available = await shellExecutor.commandExists(cmd);
+            let version = null;
+            if (available) {
+                version = await shellExecutor.getCommandVersion(cmd);
+            }
+            const entry = { available, ...(version ? { version } : {}) };
+            cache.set(cacheKey, entry, CACHE_TTL.TOKEN_COUNT); // 1-hour TTL
+            results[cmd] = { ...entry };
+            if (!available) {
+                const hint = INSTALL_HINTS[cmd]?.[platform];
+                if (hint)
+                    results[cmd].install_hint = hint;
+            }
+        }));
+        return { results, platform };
+    }, {
+        actionType: ActionType.SEARCH,
+        requiresApproval: false,
+        category: 'command_execution',
+        tags: ['shell', 'check', 'availability', 'system'],
+        displayName: 'Check Tools',
+    });
+}
+//# sourceMappingURL=shell-tools.js.map

package/dist/tools/shell-tools.js.map

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

package/dist/tools/skill-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Skill invocation tools
+ *
+ * Tools for the model to invoke skills automatically.
+ * Skills are directory-based prompts that can be executed inline
+ * or in a forked subagent context.
+ */
+import type { ToolRegistry } from '../services/tool-registry.js';
+/**
+ * Registers skill-related tools with the tool registry.
+ */
+export declare function registerSkillTools(registry: ToolRegistry): Promise<void>;
+//# sourceMappingURL=skill-tools.d.ts.map

package/dist/tools/skill-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tools.d.ts","sourceRoot":"","sources":["../../src/tools/skill-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAUjE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuL9E"}