lonny-agent 0.2.6 → 0.2.7

package/dist/tools/execute/bash/constants.js

@@ -0,0 +1,88 @@
+/** Maximum output length (chars) to prevent context overflow. */
+export const MAX_OUTPUT_LENGTH = 10_000;
+/** Maximum stderr length included in error messages */
+export const MAX_ERROR_LENGTH = 2_000;
+/** Maximum allowed timeout (10 minutes) */
+export const MAX_TIMEOUT = 600_000;
+/** Minimum allowed timeout (100ms) */
+export const MIN_TIMEOUT = 100;
+/** Default timeout (2 minutes) */
+export const DEFAULT_TIMEOUT = 120_000;
+/**
+ * Patterns that indicate a destructive command.
+ * If matched, the tool will warn the user instead of executing.
+ */
+export const DESTRUCTIVE_PATTERNS = [
+    // ═══════════════════════
+    // Unix destructive
+    // ═══════════════════════
+    { regex: /\brm\s+-(?:rf|fr)\s+\/$/i, hint: 'rm -rf / would destroy the system' },
+    { regex: /\brm\s+-(?:rf|fr)\s+\/\*/i, hint: 'rm -rf /* would destroy the system' },
+    { regex: /\brm\s+-(?:rf|fr)\s+~$/i, hint: 'rm -rf ~ would delete the home directory' },
+    { regex: /\b(?:mkfs|dd)\s+(?:\/dev|\\.)/i, hint: 'mkfs/dd would destroy a disk device' },
+    { regex: /\bchmod\s+-R\s+0{4}\b/, hint: 'chmod -R 0000 would make files inaccessible' },
+    {
+        regex: /\b(?:shutdown|reboot|halt|poweroff)\s+(?:-h|-r|-now|now)\b/i,
+        hint: 'shutdown/reboot would halt the system',
+    },
+    {
+        regex: /\b(?:killall|pkill)\s+-9\s+/i,
+        hint: 'killall -9 would terminate all matching processes',
+    },
+    // ═══════════════════════
+    // Windows destructive
+    // ═══════════════════════
+    {
+        regex: /\b(?:Remove-Item|rmdir|rd)\s+.*(?:-Recurse|-R)\s+.*(?:-Force|-F)\b/i,
+        hint: 'recursive force delete would destroy data',
+    },
+    {
+        regex: /\b(?:Remove-Item|rmdir|rd)\s+\w:\s*[\\/]/i,
+        hint: 'recursive delete on drive root would destroy data',
+    },
+    {
+        regex: /\b(?:del|erase)\s+.*(?:\/F|\/S)\b/i,
+        hint: 'force delete would destroy files irreversibly',
+    },
+    { regex: /\bformat\s+\w:\s*\/[Qq]/i, hint: 'format would destroy a drive' },
+    { regex: /\b(?:diskpart|clean-all)\b/i, hint: 'diskpart clean-all would destroy all partitions' },
+    { regex: /\bClear-Item\s+/i, hint: 'Clear-Item would delete content irreversibly' },
+    { regex: /\bClear-Content\s+/i, hint: 'Clear-Content would delete file content irreversibly' },
+    { regex: /\bRemove-ItemProperty\s+/i, hint: 'Remove-ItemProperty would delete registry keys' },
+    { regex: /\bRemove-Variable\s+-Force\b/i, hint: 'Remove-Variable -Force would delete variables' },
+    { regex: /\breg\s+delete\s+/i, hint: 'reg delete would destroy registry entries' },
+    { regex: /\bwmic\s+\w+\s+delete\b/i, hint: 'wmic delete would destroy system resources' },
+    { regex: /\b(?:cipher|sdelete)\s+\/w:/i, hint: 'secure delete would irreversibly wipe data' },
+    {
+        regex: /\[System\.IO\.Directory\]::Delete\s*\(/i,
+        hint: 'Directory.Delete would destroy data irreversibly',
+    },
+    {
+        regex: /\[System\.IO\.File\]::Delete\s*\(/i,
+        hint: 'File.Delete would destroy data irreversibly',
+    },
+];
+/**
+ * Patterns that match sensitive data (API keys, tokens, passwords, etc.)
+ * in command output. Matching content is replaced with "[REDACTED]".
+ */
+export const SENSITIVE_PATTERNS = [
+    // Generic API keys / tokens
+    /(?:api[_-]?key|apikey|token|secret|password|passwd|credential|auth[_-]?token)[=:]\s*['"]?[A-Za-z0-9_\-.]{16,}/gi,
+    // AWS keys
+    /(?:AKIA[0-9A-Z]{16}|[A-Za-z0-9+/]{40}\s*=[=]{0,2})/g,
+    // GitHub tokens
+    /gh[pousr]_[A-Za-z0-9_]{36,}/g,
+    // npm tokens
+    /npm_[A-Za-z0-9]{36,}/g,
+    // Slack tokens
+    /xox[baprs]-[A-Za-z0-9-]{24,}/g,
+    // SSH private key content (multi-line)
+    /-----BEGIN[ A-Z]+PRIVATE KEY-----[\s\S]*?-----END[ A-Z]+PRIVATE KEY-----/g,
+    // JWT tokens
+    /eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/g,
+    // Generic password-like strings in env vars
+    /export\s+\w*(?:PASS|SECRET|TOKEN|KEY)\w*\s*=\s*['"]?\S+['"]?/gi,
+    /\$env:\w*(?:PASS|SECRET|TOKEN|KEY)\w*\s*=\s*['"]?\S+['"]?/gi,
+];
+//# sourceMappingURL=constants.js.map

package/dist/tools/execute/bash/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/execute/bash/constants.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAEvC,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAA;AAErC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsC;IACrE,0BAA0B;IAC1B,mBAAmB;IACnB,0BAA0B;IAC1B,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,mCAAmC,EAAE;IAChF,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,oCAAoC,EAAE;IAClF,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,0CAA0C,EAAE;IACtF,EAAE,KAAK,EAAE,gCAAgC,EAAE,IAAI,EAAE,qCAAqC,EAAE;IACxF,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,6CAA6C,EAAE;IACvF;QACE,KAAK,EAAE,6DAA6D;QACpE,IAAI,EAAE,uCAAuC;KAC9C;IACD;QACE,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,mDAAmD;KAC1D;IACD,0BAA0B;IAC1B,sBAAsB;IACtB,0BAA0B;IAC1B;QACE,KAAK,EAAE,qEAAqE;QAC5E,IAAI,EAAE,2CAA2C;KAClD;IACD;QACE,KAAK,EAAE,2CAA2C;QAClD,IAAI,EAAE,mDAAmD;KAC1D;IACD;QACE,KAAK,EAAE,oCAAoC;QAC3C,IAAI,EAAE,+CAA+C;KACtD;IACD,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,8BAA8B,EAAE;IAC3E,EAAE,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,iDAAiD,EAAE;IACjG,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,8CAA8C,EAAE;IACnF,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,sDAAsD,EAAE;IAC9F,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,gDAAgD,EAAE;IAC9F,EAAE,KAAK,EAAE,+BAA+B,EAAE,IAAI,EAAE,+CAA+C,EAAE;IACjG,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,2CAA2C,EAAE;IAClF,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,4CAA4C,EAAE;IACzF,EAAE,KAAK,EAAE,8BAA8B,EAAE,IAAI,EAAE,4CAA4C,EAAE;IAC7F;QACE,KAAK,EAAE,yCAAyC;QAChD,IAAI,EAAE,kDAAkD;KACzD;IACD;QACE,KAAK,EAAE,oCAAoC;QAC3C,IAAI,EAAE,6CAA6C;KACpD;CACF,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,4BAA4B;IAC5B,iHAAiH;IACjH,WAAW;IACX,qDAAqD;IACrD,gBAAgB;IAChB,8BAA8B;IAC9B,aAAa;IACb,uBAAuB;IACvB,eAAe;IACf,+BAA+B;IAC/B,uCAAuC;IACvC,2EAA2E;IAC3E,aAAa;IACb,gEAAgE;IAChE,4CAA4C;IAC5C,gEAAgE;IAChE,6DAA6D;CAC9D,CAAA"}

package/dist/tools/execute/bash/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Truncate a string to maxLength chars. If truncated, appends a warning.
+ * Returns the (possibly truncated) string.
+ */
+declare function truncateOutput(s: string, maxLength: number, label: string): string;
+/**
+ * Check if stderr contains PowerShell NativeCommandError wrapping.
+ * This happens when a native command (like git push) writes to stderr and
+ * PowerShell wraps the output in an ErrorRecord format even though the
+ * command exited successfully (exit code 0).
+ *
+ * Example format:
+ *   git : Everything up-to-date
+ *   At line:1 char:1
+ *   + git push 2>&1
+ *   + ~~~~~~~~~~~~~
+ *       + CategoryInfo          : NotSpecified: (...) [], RemoteException
+ *       + FullyQualifiedErrorId : NativeCommandError
+ *
+ * Returns the extracted actual output if detected, null otherwise.
+ */
+declare function extractPowerShellNativeOutput(stderr: string): string | null;
+/**
+ * Check if stderr indicates common PowerShell errors and return a helpful message.
+ * Returns a tip string if detected, null otherwise.
+ */
+declare function checkPowerShellError(stderr: string, command: string): string | null;
+/**
+ * Check if stderr output indicates a "command not found" error.
+ * Returns a platform-appropriate suggestion if detected, null otherwise.
+ */
+declare function checkCommandNotFound(stderr: string, command: string): string | null;
+/**
+ * Build a helpful error message for a failed command, including
+ * platform-specific suggestions when applicable.
+ */
+declare function buildErrorMsg(exitCode: number, stderr: string, command: string, timedOut: boolean, cwd?: string): string;
+export { buildErrorMsg, checkCommandNotFound, checkPowerShellError, extractPowerShellNativeOutput, truncateOutput };
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/execute/bash/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/tools/execute/bash/errors.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuCpE;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwC5E;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B5E;AAED;;;GAGG;AACH,iBAAS,aAAa,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAkIR;AAED,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,cAAc,EAAE,CAAA"}

package/dist/tools/execute/bash/errors.js

@@ -0,0 +1,249 @@
+import * as os from 'node:os';
+import { MAX_ERROR_LENGTH } from './constants.js';
+import { redactSensitive } from './security.js';
+/**
+ * Truncate a string to maxLength chars. If truncated, appends a warning.
+ * Returns the (possibly truncated) string.
+ */
+function truncateOutput(s, maxLength, label) {
+    if (s.length <= maxLength)
+        return s;
+    const truncated = s.slice(0, maxLength);
+    const warning = `\n... [${label} truncated at ${maxLength} chars, original ${s.length} chars]`;
+    return truncated + warning;
+}
+/**
+ * Check if stderr contains PowerShell NativeCommandError wrapping.
+ * This happens when a native command (like git push) writes to stderr and
+ * PowerShell wraps the output in an ErrorRecord format even though the
+ * command exited successfully (exit code 0).
+ *
+ * Example format:
+ *   git : Everything up-to-date
+ *   At line:1 char:1
+ *   + git push 2>&1
+ *   + ~~~~~~~~~~~~~
+ *       + CategoryInfo          : NotSpecified: (...) [], RemoteException
+ *       + FullyQualifiedErrorId : NativeCommandError
+ *
+ * Returns the extracted actual output if detected, null otherwise.
+ */
+function extractPowerShellNativeOutput(stderr) {
+    // Detect PowerShell ErrorRecord wrapping around native command stderr output.
+    // The key marker is "FullyQualifiedErrorId : NativeCommandError".
+    if (!/FullyQualifiedErrorId\s*:\s*NativeCommandError/i.test(stderr)) {
+        return null;
+    }
+    const lines = stderr.split(/\r?\n/);
+    const outputLines = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip PowerShell error record wrapper lines:
+        //   "   + CategoryInfo          : ..."  (indented, with +)
+        //   "   + FullyQualifiedErrorId : ..."
+        //   "At line:1 char:1" or Chinese garbled equivalent
+        //   "+ command ..." (the command echo line with leading +)
+        //   "  + ~~~~~~~~~~~~~" (the caret underline)
+        if (/^\s*\+/.test(trimmed) ||
+            /^At\s+line:\d+/i.test(trimmed) ||
+            /^\+?\s*CategoryInfo/i.test(trimmed) ||
+            /^\+?\s*FullyQualifiedErrorId/i.test(trimmed)) {
+            continue;
+        }
+        // Skip blank lines within the error record block (but keep leading whitespace for formatting)
+        if (!trimmed && outputLines.length > 0) {
+            continue;
+        }
+        // Remove leading whitespace from the first content line (the "<command> : <message>" line)
+        outputLines.push(line);
+    }
+    const result = outputLines.join('\n').trim();
+    return result || null;
+}
+/**
+ * Check if stderr indicates common PowerShell errors and return a helpful message.
+ * Returns a tip string if detected, null otherwise.
+ */
+function checkPowerShellError(stderr, command) {
+    const errLower = stderr.toLowerCase();
+    // Execution policy errors
+    if (/execution.?policy/i.test(errLower) || /running scripts is disabled/i.test(errLower)) {
+        return 'PowerShell execution policy is blocking this command. Try: `powershell -ExecutionPolicy Bypass -Command "..."`';
+    }
+    // Module not found
+    if (/module.*not (found|available)/i.test(errLower) ||
+        /could not (find|load).*module/i.test(errLower)) {
+        const moduleMatch = stderr.match(/module\s+['"]?(\w+)['"]?/i);
+        const moduleName = moduleMatch ? moduleMatch[1] : '<unknown>';
+        return `PowerShell module not found: "${moduleName}". Install it with: Install-Module ${moduleName} -Force`;
+    }
+    // Cmdlet not found
+    if (/the term '(\w+)' is not recognized/i.test(errLower)) {
+        const cmdMatch = stderr.match(/the term '(\w+)'/i);
+        const cmdName = cmdMatch ? cmdMatch[1] : command.split(/\s+/)[0] || command;
+        return `Cmdlet not found: "${cmdName}". This command may need a module or be installed separately.`;
+    }
+    // Access denied
+    if (/access is denied/i.test(errLower) ||
+        /permission denied/i.test(errLower) ||
+        /unauthorized/i.test(errLower)) {
+        return 'Access denied. Try running as Administrator (on Windows) or using sudo (on Unix).';
+    }
+    // Path not found
+    if (/cannot find (path|drive)/i.test(errLower) || /path.*does not exist/i.test(errLower)) {
+        return 'The specified path or drive was not found. Check that the path exists and is accessible.';
+    }
+    return null;
+}
+/**
+ * Check if stderr output indicates a "command not found" error.
+ * Returns a platform-appropriate suggestion if detected, null otherwise.
+ */
+function checkCommandNotFound(stderr, command) {
+    const isWindows = os.platform() === 'win32';
+    const errLower = stderr.toLowerCase();
+    if (isWindows) {
+        // PowerShell "not recognized" patterns
+        if (/not recognized/.test(errLower) ||
+            /is not recognized/.test(errLower) ||
+            /找不到/.test(errLower) ||
+            /command not found/.test(errLower) ||
+            /not found/.test(errLower) ||
+            /neither the command nor/.test(errLower)) {
+            // Extract the command name that wasn't found (first word of the command)
+            const cmdName = command.split(/\s+/)[0] || command;
+            return `Command not found: "${cmdName}". It may be a Unix command not available on Windows. Use "where" to find available commands or use PowerShell-native alternatives.`;
+        }
+    }
+    else {
+        // Unix "not found" patterns
+        if (/not found/.test(errLower) ||
+            /command not found/.test(errLower) ||
+            /no such file/.test(errLower)) {
+            const cmdName = command.split(/\s+/)[0] || command;
+            return `Command not found: "${cmdName}". Check that it is installed, or use "which ${cmdName}" to find its location.`;
+        }
+    }
+    return null;
+}
+/**
+ * Build a helpful error message for a failed command, including
+ * platform-specific suggestions when applicable.
+ */
+function buildErrorMsg(exitCode, stderr, command, timedOut, cwd) {
+    const parts = [];
+    if (timedOut) {
+        parts.push(`Command timed out (exit code ${exitCode})`);
+    }
+    else {
+        parts.push(`Command exited with code ${exitCode}`);
+    }
+    // Check for "command not found" first (before including full stderr)
+    const notFoundMsg = checkCommandNotFound(stderr, command);
+    if (notFoundMsg) {
+        parts.push(notFoundMsg);
+    }
+    // Check for common PowerShell errors
+    if (os.platform() === 'win32') {
+        const psErrMsg = checkPowerShellError(stderr, command);
+        if (psErrMsg) {
+            parts.push(psErrMsg);
+        }
+    }
+    // Include stderr content (truncated and redacted)
+    const stderrTrimmed = stderr.trim();
+    if (stderrTrimmed) {
+        const redactedStderr = redactSensitive(stderrTrimmed);
+        parts.push(`stderr:\n${truncateOutput(redactedStderr, MAX_ERROR_LENGTH, 'stderr')}`);
+    }
+    // Platform-specific suggestions for common mistakes
+    const isWindows = os.platform() === 'win32';
+    if (isWindows) {
+        // Common Windows command mistakes
+        if (/ls\b/.test(command) && !/ls\b/.test(command.replace(/".*"/g, ''))) {
+            parts.push('💡 Tip: On Windows, use `dir` instead of `ls`, or `Get-ChildItem` in PowerShell.');
+        }
+        if (/grep\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `findstr` or `Select-String` instead of `grep`.');
+        }
+        if (/touch\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, `touch` is not available. Use `New-Item` or `edit` tool to create files.');
+        }
+        if (/ps\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Get-Process` instead of `ps` for listing processes.');
+        }
+        if (/pwd\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Get-Location` or `$pwd` instead of `pwd`.');
+        }
+        if (/chmod\b/.test(command) ||
+            /cp\b/.test(command) ||
+            /mv\b/.test(command) ||
+            /rm\b/.test(command) ||
+            /mkdir\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use native equivalents: `copy`, `move`, `del`, `mkdir`, `icacls` instead of Unix commands.');
+        }
+        if (/cat\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `type` or `Get-Content` instead of `cat`.');
+        }
+        if (/which\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `where` instead of `which` to find executable locations.');
+        }
+        if (/less\b/.test(command) || /more\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `more` or `Out-Host -Paging` for paging output.');
+        }
+        if (/sort\b/.test(command) && !/sort-object/i.test(command) && !/Sort-Object/i.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Sort-Object` instead of `sort`.');
+        }
+        if (/head\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Select-Object -First` instead of `head`.');
+        }
+        if (/tail\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Get-Content -Tail` or `Select-Object -Last` instead of `tail`.');
+        }
+        if (/diff\b/.test(command) || /cmp\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Compare-Object` instead of `diff`/`cmp`.');
+        }
+        if (/curl\b/.test(command) && !/curl\b/.test(command.replace(/".*"/g, ''))) {
+            parts.push('💡 Tip: On Windows, use `Invoke-WebRequest` or `Invoke-RestMethod` instead of `curl`. curl is available in newer Windows builds.');
+        }
+        if (/wget\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Invoke-WebRequest` instead of `wget`.');
+        }
+        if (/env\b/.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Get-ChildItem Env:` to list environment variables.');
+        }
+        if (/kill\b/.test(command) && !/stop-process/i.test(command)) {
+            parts.push('💡 Tip: On Windows, use `Stop-Process` or `taskkill` instead of `kill`.');
+        }
+    }
+    else {
+        // Unix-specific tips
+        if (/dir\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `ls -la` instead of `dir`.');
+        }
+        if (/findstr\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `grep` instead of `findstr`.');
+        }
+        if (/type\b/.test(command) && !/type\b/.test(command.replace(/".*"/g, ''))) {
+            parts.push('💡 Tip: On Unix, use `cat` instead of `type`.');
+        }
+        if (/where\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `which` instead of `where` to find executable locations.');
+        }
+        if (/copy\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `cp` instead of `copy`.');
+        }
+        if (/move\b/.test(command) || /ren\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `mv` instead of `move`/`ren`.');
+        }
+        if (/del\b/.test(command)) {
+            parts.push('💡 Tip: On Unix, use `rm` instead of `del`.');
+        }
+    }
+    if (cwd) {
+        parts.push(`Working directory: ${cwd}`);
+    }
+    return parts.join('\n');
+}
+export { buildErrorMsg, checkCommandNotFound, checkPowerShellError, extractPowerShellNativeOutput, truncateOutput };
+//# sourceMappingURL=errors.js.map

package/dist/tools/execute/bash/errors.js.map

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

package/dist/tools/execute/bash/execution.d.ts

@@ -0,0 +1,18 @@
+import type { ChildProcess } from 'node:child_process';
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+}
+/**
+ * Kill a child process tree reliably across platforms.
+ * - On Windows: uses `taskkill /F /T` for force-kill of the process tree when possible.
+ * - On Unix: sends SIGTERM first, then SIGKILL after a grace period.
+ * - Handles missing pid and protects against thrown errors.
+ */
+declare function killProcess(child: ChildProcess): NodeJS.Timeout | undefined;
+declare function execCommand(command: string, timeout: number, cwd?: string): Promise<ExecResult>;
+export type { ExecResult };
+export { execCommand, killProcess };
+//# sourceMappingURL=execution.d.ts.map

package/dist/tools/execute/bash/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../../src/tools/execute/bash/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAQtD,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,GAAG,SAAS,CA4DpE;AAED,iBAAS,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4HxF;AAED,YAAY,EAAE,UAAU,EAAE,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}

package/dist/tools/execute/bash/execution.js

@@ -0,0 +1,207 @@
+import { execSync, spawn } from 'node:child_process';
+import * as os from 'node:os';
+import { fmtErr } from '../../errors.js';
+import { MAX_ERROR_LENGTH, MAX_OUTPUT_LENGTH } from './constants.js';
+import { ENCODING } from './platform.js';
+/**
+ * Kill a child process tree reliably across platforms.
+ * - On Windows: uses `taskkill /F /T` for force-kill of the process tree when possible.
+ * - On Unix: sends SIGTERM first, then SIGKILL after a grace period.
+ * - Handles missing pid and protects against thrown errors.
+ */
+function killProcess(child) {
+    try {
+        if (!child || typeof child.pid !== 'number' || Number.isNaN(child.pid)) {
+            // Best-effort kill if pid is not available
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+            return undefined;
+        }
+        if (os.platform() === 'win32') {
+            try {
+                // Use taskkill to terminate the whole process tree. If it fails, fall back to child.kill().
+                execSync(`taskkill /F /T /PID ${child.pid}`, {
+                    stdio: 'ignore',
+                    timeout: 3000,
+                });
+            }
+            catch {
+                try {
+                    child.kill();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            return undefined;
+        }
+        else {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch {
+                /* ignore */
+            }
+            // Track timer so we can force-KILL after a grace period
+            const killTimer = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch {
+                    /* already exited or cannot kill */
+                }
+            }, 5000);
+            // Ensure we clean up the timer and the listener when the child exits
+            const onExit = () => {
+                try {
+                    clearTimeout(killTimer);
+                }
+                catch {
+                    /* ignore */
+                }
+                try {
+                    child.removeListener('exit', onExit);
+                }
+                catch {
+                    /* ignore */
+                }
+            };
+            child.on('exit', onExit);
+            return killTimer;
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+function execCommand(command, timeout, cwd) {
+    return new Promise(resolve => {
+        const isWindows = os.platform() === 'win32';
+        const shellExe = isWindows ? 'powershell.exe' : process.env.SHELL || '/bin/sh';
+        const shellArgs = isWindows
+            ? ['-NoProfile', '-NonInteractive', '-Command', command]
+            : ['-c', command];
+        // Protect against spawn throwing synchronously (e.g. missing shell)
+        let child;
+        try {
+            child = spawn(shellExe, shellArgs, {
+                cwd: cwd || process.cwd(),
+                env: { ...process.env, FORCE_COLOR: '0', NO_COLOR: '1' },
+                windowsHide: true,
+            });
+        }
+        catch (err) {
+            // Return a normalized error result rather than throwing
+            resolve({ stdout: '', stderr: fmtErr(err), exitCode: 1, timedOut: false });
+            return;
+        }
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        // Keep memory bounded by limiting how much we accumulate for each stream
+        const MAX_STDOUT_BUFFER = Math.max(MAX_OUTPUT_LENGTH * 2, 20000);
+        const MAX_STDERR_BUFFER = Math.max(MAX_ERROR_LENGTH * 2, 4000);
+        let stdoutTruncated = false;
+        let stderrTruncated = false;
+        // Track which encodings work for each stream (per-chunk fallback).
+        let stdoutEncoding;
+        let stderrEncoding;
+        let treeKillTimer;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            // Attempt to kill the process tree; capture any returned timer so we can clear it on close
+            treeKillTimer = killProcess(child);
+        }, timeout);
+        child.stdout?.on('data', (data) => {
+            if (stdout.length >= MAX_STDOUT_BUFFER) {
+                stdoutTruncated = true;
+                return;
+            }
+            try {
+                const enc = stdoutEncoding || ENCODING;
+                stdout += data.toString(enc);
+                stdoutEncoding = enc;
+            }
+            catch {
+                // Detected encoding failed; fall back to utf-8
+                try {
+                    stdout += data.toString('utf-8');
+                    stdoutEncoding = 'utf-8';
+                }
+                catch {
+                    // Give up on this chunk
+                }
+            }
+        });
+        child.stderr?.on('data', (data) => {
+            if (stderr.length >= MAX_STDERR_BUFFER) {
+                stderrTruncated = true;
+                return;
+            }
+            try {
+                const enc = stderrEncoding || ENCODING;
+                stderr += data.toString(enc);
+                stderrEncoding = enc;
+            }
+            catch {
+                try {
+                    stderr += data.toString('utf-8');
+                    stderrEncoding = 'utf-8';
+                }
+                catch {
+                    // ignore
+                }
+            }
+        });
+        const finish = (code) => {
+            try {
+                clearTimeout(timer);
+            }
+            catch {
+                /* ignore */
+            }
+            if (treeKillTimer) {
+                try {
+                    clearTimeout(treeKillTimer);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            // If we truncated during streaming, append a short notice so final output can indicate truncation
+            if (stdoutTruncated)
+                stdout += '\n... [stdout truncated due to size limit]';
+            if (stderrTruncated)
+                stderr += '\n... [stderr truncated due to size limit]';
+            resolve({ stdout, stderr, exitCode: code ?? 0, timedOut });
+        };
+        child.on('close', code => finish(code));
+        child.on('error', err => {
+            try {
+                clearTimeout(timer);
+            }
+            catch {
+                /* ignore */
+            }
+            if (treeKillTimer) {
+                try {
+                    clearTimeout(treeKillTimer);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            // Include the spawn error message in stderr so callers can surface it
+            const errMsg = fmtErr(err);
+            if (errMsg)
+                stderr += (stderr ? '\n' : '') + errMsg;
+            resolve({ stdout, stderr, exitCode: 1, timedOut });
+        });
+    });
+}
+export { execCommand, killProcess };
+//# sourceMappingURL=execution.js.map

package/dist/tools/execute/bash/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../../src/tools/execute/bash/execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AASxC;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAmB;IACtC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,IAAI,OAAQ,KAAa,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAE,KAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACzF,2CAA2C;YAC3C,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,EAAE,CAAA;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,4FAA4F;gBAC5F,QAAQ,CAAC,uBAAuB,KAAK,CAAC,GAAG,EAAE,EAAE;oBAC3C,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,IAAI;iBACd,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,EAAE,CAAA;gBACd,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,wDAAwD;YACxD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACvB,CAAC;gBAAC,MAAM,CAAC;oBACP,mCAAmC;gBACrC,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAA;YACR,qEAAqE;YACrE,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,CAAC;oBACH,YAAY,CAAC,SAAS,CAAC,CAAA;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;gBACD,IAAI,CAAC;oBACH,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBACtC,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC,CAAA;YACD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACxB,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAe,EAAE,OAAe,EAAE,GAAY;IACjE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAA;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAA;QAC9E,MAAM,SAAS,GAAG,SAAS;YACzB,CAAC,CAAC,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,CAAC;YACxD,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAEnB,oEAAoE;QACpE,IAAI,KAA+B,CAAA;QACnC,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE;gBACjC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;gBACzB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;gBACxD,WAAW,EAAE,IAAI;aAClB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,wDAAwD;YACxD,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;YAC1E,OAAM;QACR,CAAC;QAED,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,QAAQ,GAAG,KAAK,CAAA;QAEpB,yEAAyE;QACzE,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;QAChE,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9D,IAAI,eAAe,GAAG,KAAK,CAAA;QAC3B,IAAI,eAAe,GAAG,KAAK,CAAA;QAE3B,mEAAmE;QACnE,IAAI,cAAkC,CAAA;QACtC,IAAI,cAAkC,CAAA;QAEtC,IAAI,aAAyC,CAAA;QAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,QAAQ,GAAG,IAAI,CAAA;YACf,2FAA2F;YAC3F,aAAa,GAAG,WAAW,CAAC,KAAM,CAAC,CAAA;QACrC,CAAC,EAAE,OAAO,CAAC,CAAA;QAEX,KAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACzC,IAAI,MAAM,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;gBACvC,eAAe,GAAG,IAAI,CAAA;gBACtB,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,cAAc,IAAI,QAAQ,CAAA;gBACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAqB,CAAC,CAAA;gBAC9C,cAAc,GAAG,GAAG,CAAA;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;gBAC/C,IAAI,CAAC;oBACH,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;oBAChC,cAAc,GAAG,OAAO,CAAA;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,KAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACzC,IAAI,MAAM,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;gBACvC,eAAe,GAAG,IAAI,CAAA;gBACtB,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,cAAc,IAAI,QAAQ,CAAA;gBACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAqB,CAAC,CAAA;gBAC9C,cAAc,GAAG,GAAG,CAAA;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC;oBACH,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;oBAChC,cAAc,GAAG,OAAO,CAAA;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,YAAY,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,YAAY,CAAC,aAAa,CAAC,CAAA;gBAC7B,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YAED,kGAAkG;YAClG,IAAI,eAAe;gBAAE,MAAM,IAAI,4CAA4C,CAAA;YAC3E,IAAI,eAAe;gBAAE,MAAM,IAAI,4CAA4C,CAAA;YAE3E,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC5D,CAAC,CAAA;QAED,KAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QAExC,KAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;YACvB,IAAI,CAAC;gBACH,YAAY,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,YAAY,CAAC,aAAa,CAAC,CAAA;gBAC7B,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,sEAAsE;YACtE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,MAAM;gBAAE,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAA;YACnD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAGD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}

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

@@ -0,0 +1,3 @@
+import type { Tool } from '../../types.js';
+export declare const bashTool: Tool;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/execute/bash/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAA;AAQtD,eAAO,MAAM,QAAQ,EAAE,IA2HtB,CAAA"}