@animus-labs/cortex 0.2.0

package/dist/tools/bash/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Bash tool: execute shell commands in the host environment.
+ *
+ * Cross-platform: bash/zsh on macOS and Linux, PowerShell on Windows.
+ * Tracks working directory across calls within an agentic loop.
+ * Supports background execution with auto-yield.
+ *
+ * Reference: docs/cortex/tools/bash.md
+ */
+import { Type, type Static } from 'typebox';
+import type { CwdTracker } from '../shared/cwd-tracker.js';
+import type { ToolContentDetails, ToolExecuteContext } from '../../types.js';
+import { type BackgroundTask, type CortexToolRuntime } from '../runtime.js';
+export declare const BashParams: Type.TObject<{
+    command: Type.TString;
+    timeout: Type.TOptional<Type.TNumber>;
+    description: Type.TOptional<Type.TString>;
+    background: Type.TOptional<Type.TBoolean>;
+}>;
+export type BashParamsType = Static<typeof BashParams>;
+export interface BashDetails {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    duration: number;
+    interrupted: boolean;
+    timedOut: boolean;
+    backgrounded: boolean;
+    taskId: string | null;
+    finalCwd: string;
+}
+/**
+ * Partial result details emitted during bash streaming via onUpdate.
+ */
+export interface BashStreamUpdate {
+    /** New stdout chunk since last update (complete lines only). */
+    stdout: string;
+    /** New stderr chunk since last update. */
+    stderr: string;
+    /** Total stdout lines emitted so far. */
+    totalLines: number;
+}
+export interface BashToolConfig {
+    runtime?: CortexToolRuntime | undefined;
+    cwdTracker?: CwdTracker | undefined;
+    /** Custom shell path override. */
+    shellPath?: string | undefined;
+    /** Auto-yield threshold in ms. Default: 10000. */
+    autoYieldThreshold?: number | undefined;
+    /** Callback for tracking subprocess PIDs (for cleanup on exit). */
+    onProcessSpawned?: ((pid: number) => void) | undefined;
+    /** Callback for removing tracked PIDs when process exits. */
+    onProcessExited?: ((pid: number) => void) | undefined;
+    /** Utility model completion function for Layer 7 safety classifier. */
+    utilityComplete?: ((context: unknown) => Promise<unknown>) | undefined;
+    /**
+     * Consumer-set environment variable overrides that bypass the security blocklist.
+     * Merged ON TOP of the sanitized environment for shell subprocesses.
+     * Used for macOS dock icon suppression vars (DYLD_INSERT_LIBRARIES, etc.).
+     */
+    envOverrides?: Record<string, string> | undefined;
+}
+export declare function getBackgroundTask(id: string): BackgroundTask | undefined;
+export declare function getAllBackgroundTasks(): Map<string, BackgroundTask>;
+export declare function createBashTool(config: BashToolConfig): {
+    name: string;
+    description: string;
+    parameters: typeof BashParams;
+    execute: (params: BashParamsType, context?: ToolExecuteContext) => Promise<ToolContentDetails<BashDetails>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/bash/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,UAAU;;;;;EAWrB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAMvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvD,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACtD,uEAAuE;IACvE,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACvE;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE;AAED,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAEnE;AA0ID,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;CAC7G,CA8VA"}

package/dist/tools/bash/index.js

@@ -0,0 +1,485 @@
+/**
+ * Bash tool: execute shell commands in the host environment.
+ *
+ * Cross-platform: bash/zsh on macOS and Linux, PowerShell on Windows.
+ * Tracks working directory across calls within an agentic loop.
+ * Supports background execution with auto-yield.
+ *
+ * Reference: docs/cortex/tools/bash.md
+ */
+import * as child_process from 'node:child_process';
+import * as fs from 'node:fs';
+import { Type } from 'typebox';
+import { buildSafeEnv, runSafetyChecks } from './safety.js';
+import { attachRuntimeAwareTool, globalBackgroundTaskStore, } from '../runtime.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export const BashParams = Type.Object({
+    command: Type.String({ description: 'The shell command to execute' }),
+    timeout: Type.Optional(Type.Number({ description: 'Timeout in milliseconds. Default: 120000 (2 min). Max: 600000 (10 min).' })),
+    description: Type.Optional(Type.String({ description: 'Human-readable explanation of the command.' })),
+    background: Type.Optional(Type.Boolean({ description: 'Run the command in the background immediately. Default: false.' })),
+});
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT = 120_000;
+const MAX_TIMEOUT = 600_000;
+const AUTO_YIELD_THRESHOLD = 10_000; // 10 seconds
+const CWD_MARKER = '___CWD___';
+export function getBackgroundTask(id) {
+    return globalBackgroundTaskStore.get(id);
+}
+export function getAllBackgroundTasks() {
+    return globalBackgroundTaskStore.getAll();
+}
+/**
+ * Read /etc/shells and return the set of trusted shell paths.
+ */
+function readTrustedShells() {
+    const trusted = new Set();
+    try {
+        const content = fs.readFileSync('/etc/shells', 'utf8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith('#')) {
+                trusted.add(trimmed);
+            }
+        }
+    }
+    catch {
+        // /etc/shells not available; empty set means we fall back
+    }
+    return trusted;
+}
+/**
+ * Select the appropriate shell for the current platform.
+ */
+function selectShell(customShellPath) {
+    // Custom override
+    if (customShellPath) {
+        if (process.platform === 'win32') {
+            return { shell: customShellPath, args: ['-NoProfile', '-NonInteractive', '-Command'] };
+        }
+        return { shell: customShellPath, args: ['-c'] };
+    }
+    if (process.platform === 'win32') {
+        return selectWindowsShell();
+    }
+    return selectUnixShell();
+}
+function selectUnixShell() {
+    const userShell = process.env['SHELL'];
+    if (userShell) {
+        // Reject fish (incompatible with common bashisms)
+        if (userShell.endsWith('/fish')) {
+            return findUnixFallback();
+        }
+        // Validate against /etc/shells
+        const trusted = readTrustedShells();
+        if (trusted.size === 0 || trusted.has(userShell)) {
+            return { shell: userShell, args: ['-c'] };
+        }
+    }
+    return findUnixFallback();
+}
+function findUnixFallback() {
+    // Try /bin/bash first, then /bin/sh
+    for (const shell of ['/bin/bash', '/bin/sh']) {
+        try {
+            fs.accessSync(shell, fs.constants.X_OK);
+            return { shell, args: ['-c'] };
+        }
+        catch {
+            continue;
+        }
+    }
+    return { shell: '/bin/sh', args: ['-c'] };
+}
+function selectWindowsShell() {
+    // Try PowerShell 7 first
+    const ps7Paths = [
+        'C:\\Program Files\\PowerShell\\7\\pwsh.exe',
+        `${process.env['ProgramW6432']}\\PowerShell\\7\\pwsh.exe`,
+    ];
+    for (const ps7 of ps7Paths) {
+        try {
+            fs.accessSync(ps7, fs.constants.X_OK);
+            return { shell: ps7, args: ['-NoProfile', '-NonInteractive', '-Command'] };
+        }
+        catch {
+            continue;
+        }
+    }
+    // Fall back to Windows PowerShell 5.1
+    const ps5 = 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe';
+    return { shell: ps5, args: ['-NoProfile', '-NonInteractive', '-Command'] };
+}
+// ---------------------------------------------------------------------------
+// Output handling
+// ---------------------------------------------------------------------------
+/**
+ * Sanitize output by stripping binary control characters.
+ * Preserves tab, newline, and carriage return.
+ */
+function sanitizeOutput(output) {
+    // eslint-disable-next-line no-control-regex
+    return output.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '');
+}
+/**
+ * Extract CWD from output using the CWD_MARKER.
+ * Returns [cleanedOutput, extractedCwd].
+ */
+function extractCwd(output) {
+    const markerIdx = output.lastIndexOf(CWD_MARKER);
+    if (markerIdx === -1)
+        return [output, null];
+    const beforeMarker = output.slice(0, markerIdx);
+    const afterMarker = output.slice(markerIdx + CWD_MARKER.length).trim();
+    // The CWD is on the line after the marker
+    const lines = afterMarker.split('\n');
+    const cwd = (lines[0] ?? '').trim();
+    return [beforeMarker.trimEnd(), cwd || null];
+}
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createBashTool(config) {
+    const cwdTracker = config.runtime?.cwdTracker ?? config.cwdTracker;
+    if (!cwdTracker) {
+        throw new Error('createBashTool requires either runtime or cwdTracker');
+    }
+    const backgroundTasks = config.runtime?.backgroundTasks ?? globalBackgroundTaskStore;
+    const autoYieldThreshold = config.autoYieldThreshold ?? AUTO_YIELD_THRESHOLD;
+    const tool = {
+        name: 'Bash',
+        description: 'Execute a shell command in the host environment.',
+        parameters: BashParams,
+        async execute(params, context) {
+            backgroundTasks.cleanupCompletedTasks();
+            const timeout = Math.min(params.timeout ?? DEFAULT_TIMEOUT, MAX_TIMEOUT);
+            const background = params.background ?? false;
+            const startTime = Date.now();
+            // Run safety checks (Layers 2-7)
+            const safetyResult = await runSafetyChecks(params.command, cwdTracker.getDefaultDir(), cwdTracker.getCwd(), {
+                utilityComplete: config.utilityComplete,
+                description: params.description,
+            });
+            if (!safetyResult.allowed) {
+                return {
+                    content: [{ type: 'text', text: safetyResult.reason ?? 'Command blocked by safety check.' }],
+                    details: {
+                        stdout: '',
+                        stderr: '',
+                        exitCode: null,
+                        duration: Date.now() - startTime,
+                        interrupted: false,
+                        timedOut: false,
+                        backgrounded: false,
+                        taskId: null,
+                        finalCwd: cwdTracker.getCwd(),
+                    },
+                };
+            }
+            // Select shell
+            const shellConfig = selectShell(config.shellPath);
+            // Verify shell exists
+            try {
+                fs.accessSync(shellConfig.shell, fs.constants.X_OK);
+            }
+            catch {
+                return {
+                    content: [{ type: 'text', text: `Shell not found: ${shellConfig.shell}. Configure a custom shell in settings.` }],
+                    details: {
+                        stdout: '',
+                        stderr: '',
+                        exitCode: null,
+                        duration: Date.now() - startTime,
+                        interrupted: false,
+                        timedOut: false,
+                        backgrounded: false,
+                        taskId: null,
+                        finalCwd: cwdTracker.getCwd(),
+                    },
+                };
+            }
+            // Build safe environment (Layer 1), with consumer overrides merged on top
+            const safeEnv = buildSafeEnv(process.env, config.envOverrides);
+            // Append CWD capture suffix
+            const isWindows = process.platform === 'win32';
+            // Capture exit code before CWD suffix so pwd/Get-Location don't mask it
+            const cwdSuffix = isWindows
+                ? `; $__ec=$LASTEXITCODE; Write-Host "${CWD_MARKER}"; Get-Location; exit $__ec`
+                : `; __ec=$?; echo "${CWD_MARKER}"; pwd; exit $__ec`;
+            // UTF-8 prefix for Windows PowerShell
+            const utf8Prefix = isWindows
+                ? '$OutputEncoding = [System.Text.Encoding]::UTF8; [Console]::OutputEncoding = [System.Text.Encoding]::UTF8; '
+                : '';
+            const fullCommand = `${utf8Prefix}${params.command}${cwdSuffix}`;
+            // Spawn the process
+            const proc = child_process.spawn(shellConfig.shell, [...shellConfig.args, fullCommand], {
+                cwd: cwdTracker.getCwd(),
+                env: safeEnv,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                detached: !isWindows, // Process group for Unix cleanup
+            });
+            // Track PID
+            if (proc.pid && config.onProcessSpawned) {
+                config.onProcessSpawned(proc.pid);
+            }
+            // Background execution
+            if (background) {
+                const taskId = backgroundTasks.nextTaskId();
+                const task = {
+                    id: taskId,
+                    command: params.command.slice(0, 120),
+                    process: proc,
+                    stdout: '',
+                    stderr: '',
+                    exitCode: null,
+                    completed: false,
+                    startTime: Date.now(),
+                };
+                backgroundTasks.set(task);
+                proc.stdout?.setEncoding('utf8');
+                proc.stderr?.setEncoding('utf8');
+                proc.stdout?.on('data', (data) => { task.stdout += data; });
+                proc.stderr?.on('data', (data) => { task.stderr += data; });
+                proc.on('close', (code) => {
+                    task.exitCode = code;
+                    task.completed = true;
+                    if (proc.pid && config.onProcessExited) {
+                        config.onProcessExited(proc.pid);
+                    }
+                });
+                return {
+                    content: [{ type: 'text', text: `Command running in background. Task ID: ${taskId}\nUse TaskOutput to poll, send input, or kill.` }],
+                    details: {
+                        stdout: '',
+                        stderr: '',
+                        exitCode: null,
+                        duration: 0,
+                        interrupted: false,
+                        timedOut: false,
+                        backgrounded: true,
+                        taskId,
+                        finalCwd: cwdTracker.getCwd(),
+                    },
+                };
+            }
+            // Foreground execution
+            return new Promise((resolve) => {
+                let stdout = '';
+                let stderr = '';
+                let timedOut = false;
+                let autoYielded = false;
+                let taskId = null;
+                // Streaming state: buffer chunks and emit complete lines every 100ms
+                const onUpdate = context?.onUpdate;
+                let pendingStdout = '';
+                let pendingStderr = '';
+                let totalLinesEmitted = 0;
+                const flushStreamUpdate = () => {
+                    if (!onUpdate)
+                        return;
+                    // Only emit complete lines (hold partial lines in the buffer)
+                    const lastNewline = pendingStdout.lastIndexOf('\n');
+                    const lastStderrNewline = pendingStderr.lastIndexOf('\n');
+                    if (lastNewline === -1 && lastStderrNewline === -1)
+                        return;
+                    let stdoutChunk = '';
+                    if (lastNewline >= 0) {
+                        stdoutChunk = pendingStdout.slice(0, lastNewline + 1);
+                        pendingStdout = pendingStdout.slice(lastNewline + 1);
+                        totalLinesEmitted += stdoutChunk.split('\n').length - 1;
+                    }
+                    let stderrChunk = '';
+                    if (lastStderrNewline >= 0) {
+                        stderrChunk = pendingStderr.slice(0, lastStderrNewline + 1);
+                        pendingStderr = pendingStderr.slice(lastStderrNewline + 1);
+                    }
+                    onUpdate({
+                        content: [{ type: 'text', text: stdoutChunk + stderrChunk }],
+                        details: { stdout: stdoutChunk, stderr: stderrChunk, totalLines: totalLinesEmitted },
+                    });
+                };
+                const streamInterval = onUpdate ? setInterval(flushStreamUpdate, 100) : null;
+                proc.stdout?.setEncoding('utf8');
+                proc.stderr?.setEncoding('utf8');
+                proc.stdout?.on('data', (data) => {
+                    stdout += data;
+                    pendingStdout += data;
+                });
+                proc.stderr?.on('data', (data) => {
+                    stderr += data;
+                    pendingStderr += data;
+                });
+                // Timeout handler
+                const timeoutTimer = setTimeout(() => {
+                    timedOut = true;
+                    killProcessTree(proc);
+                }, timeout);
+                // Auto-yield handler
+                const autoYieldTimer = setTimeout(() => {
+                    if (!proc.exitCode && proc.pid) {
+                        autoYielded = true;
+                        taskId = backgroundTasks.nextTaskId();
+                        const task = {
+                            id: taskId,
+                            command: params.command.slice(0, 120),
+                            process: proc,
+                            stdout,
+                            stderr,
+                            exitCode: null,
+                            completed: false,
+                            startTime: Date.now(),
+                        };
+                        backgroundTasks.set(task);
+                        // Remove original foreground listeners to prevent memory leak
+                        proc.stdout?.removeAllListeners('data');
+                        proc.stderr?.removeAllListeners('data');
+                        // Continue collecting output for the background task
+                        proc.stdout?.on('data', (data) => { task.stdout += data; });
+                        proc.stderr?.on('data', (data) => { task.stderr += data; });
+                        proc.on('close', (code) => {
+                            task.exitCode = code;
+                            task.completed = true;
+                            if (proc.pid && config.onProcessExited) {
+                                config.onProcessExited(proc.pid);
+                            }
+                        });
+                        clearTimeout(timeoutTimer);
+                        if (streamInterval) {
+                            clearInterval(streamInterval);
+                            flushStreamUpdate();
+                        }
+                        const [cleanedOutput] = extractCwd(sanitizeOutput(stdout));
+                        resolve({
+                            content: [{ type: 'text', text: `${cleanedOutput}\n\n[Command auto-yielded after ${autoYieldThreshold}ms. Task ID: ${taskId}]` }],
+                            details: {
+                                stdout: cleanedOutput,
+                                stderr,
+                                exitCode: null,
+                                duration: Date.now() - startTime,
+                                interrupted: false,
+                                timedOut: false,
+                                backgrounded: true,
+                                taskId,
+                                finalCwd: cwdTracker.getCwd(),
+                            },
+                        });
+                    }
+                }, autoYieldThreshold);
+                proc.on('close', (code) => {
+                    clearTimeout(timeoutTimer);
+                    clearTimeout(autoYieldTimer);
+                    if (streamInterval) {
+                        clearInterval(streamInterval);
+                        flushStreamUpdate();
+                    }
+                    if (proc.pid && config.onProcessExited) {
+                        config.onProcessExited(proc.pid);
+                    }
+                    // If already auto-yielded, don't resolve again
+                    if (autoYielded)
+                        return;
+                    const rawOutput = sanitizeOutput(stdout);
+                    const [cleanedOutput, newCwd] = extractCwd(rawOutput);
+                    // Update CWD tracker
+                    if (newCwd) {
+                        cwdTracker.updateCwd(newCwd);
+                    }
+                    const duration = Date.now() - startTime;
+                    let text = cleanedOutput;
+                    if (stderr) {
+                        text += `\nstderr: ${stderr}`;
+                    }
+                    if (timedOut) {
+                        text += `\nCommand timed out after ${timeout}ms.`;
+                    }
+                    if (code !== null && code !== 0) {
+                        text += `\nExit code: ${code}`;
+                    }
+                    resolve({
+                        content: [{ type: 'text', text: text || '(no output)' }],
+                        details: {
+                            stdout: cleanedOutput,
+                            stderr,
+                            exitCode: code,
+                            duration,
+                            interrupted: false,
+                            timedOut,
+                            backgrounded: false,
+                            taskId: null,
+                            finalCwd: newCwd ?? cwdTracker.getCwd(),
+                        },
+                    });
+                });
+                proc.on('error', (err) => {
+                    clearTimeout(timeoutTimer);
+                    clearTimeout(autoYieldTimer);
+                    if (streamInterval) {
+                        clearInterval(streamInterval);
+                        flushStreamUpdate();
+                    }
+                    if (autoYielded)
+                        return;
+                    resolve({
+                        content: [{ type: 'text', text: `Failed to execute command: ${err.message}` }],
+                        details: {
+                            stdout,
+                            stderr,
+                            exitCode: null,
+                            duration: Date.now() - startTime,
+                            interrupted: false,
+                            timedOut: false,
+                            backgrounded: false,
+                            taskId: null,
+                            finalCwd: cwdTracker.getCwd(),
+                        },
+                    });
+                });
+            });
+        },
+    };
+    return attachRuntimeAwareTool(tool, {
+        toolKind: 'Bash',
+        cloneForRuntime: (runtime) => createBashTool({
+            ...config,
+            runtime,
+            cwdTracker: runtime.cwdTracker,
+        }),
+    });
+}
+// ---------------------------------------------------------------------------
+// Process tree cleanup
+// ---------------------------------------------------------------------------
+/**
+ * Kill the entire process tree.
+ * Unix: send SIGKILL to the process group.
+ * Windows: use taskkill /F /T.
+ */
+function killProcessTree(proc) {
+    if (!proc.pid)
+        return;
+    try {
+        if (process.platform === 'win32') {
+            child_process.execFileSync('taskkill', ['/F', '/T', '/PID', String(proc.pid)], { stdio: 'ignore' });
+        }
+        else {
+            // Kill the entire process group
+            process.kill(-proc.pid, 'SIGKILL');
+        }
+    }
+    catch {
+        // Process may have already exited
+        try {
+            proc.kill('SIGKILL');
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/bash/index.js.map

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

package/dist/tools/bash/interactive.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Interactive command detection for Bash.
+ *
+ * Catches commands that would block waiting for TTY input (editors,
+ * pagers, REPLs, interactive DB clients) and rejects them with a
+ * concrete non-interactive suggestion. Prevents the agent from burning
+ * its entire timeout budget on a hung `vim` or `psql` invocation.
+ *
+ * This is a UX gate, not a security gate: it sits at the end of the
+ * safety cascade after all security layers have passed. Security checks
+ * always come first.
+ *
+ * The module is pure — no I/O, no global state — so the rule set can be
+ * exhaustively unit-tested without a shell.
+ */
+import { type SafetyCheckResult } from './safety.js';
+/**
+ * Check a full shell command for interactive invocations. Splits on
+ * shell operators (`;`, `&&`, `||`, `|`) and inspects each sub-command
+ * independently — `cat file | less` is rejected because the `less`
+ * sub-command is interactive, even though `cat` is not.
+ *
+ * Returns the first interactive sub-command's rejection; if all
+ * sub-commands are non-interactive, returns `{ allowed: true }`.
+ */
+export declare function checkInteractive(command: string): SafetyCheckResult;
+/**
+ * Minimal shell-aware tokenizer: splits on unquoted whitespace, keeps
+ * single/double-quoted regions intact (quotes themselves are stripped),
+ * and honors backslash escapes. Sufficient for identifying the program
+ * token and distinguishing flags from positional args; not a complete
+ * POSIX shell parser.
+ */
+export declare function tokenize(command: string): string[];
+/**
+ * Find the effective program name and argument list, accounting for:
+ *   1. Leading `KEY=VALUE` env var prefixes (`FOO=bar vim file`)
+ *   2. The `env` wrapper (`env FOO=bar vim file` or `env -u BAR vim`)
+ *
+ * Returns the program's basename (last path segment) and the remaining
+ * arg tokens, or `null` if no program token is present.
+ */
+export declare function findProgram(tokens: string[]): {
+    name: string;
+    args: string[];
+} | null;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/tools/bash/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/tools/bash/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA4E5E;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiBnE;AAMD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA+BlD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CA+BzC"}