@aetherai/aether 0.0.3

package/dist/CLI/packages/core/src/tools/sdk-control-client-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-control-client-transport.js","sourceRoot":"","sources":["../../../../../../../core/src/tools/sdk-control-client-transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAiB3D;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAC5B,UAAU,CAAS;IACnB,cAAc,CAAyB;IACvC,OAAO,GAAG,KAAK,CAAC;IAExB,gCAAgC;IAChC,SAAS,CAAqC;IAC9C,OAAO,CAA0B;IACjC,OAAO,CAAc;IAErB,YAAY,OAAyC;QACnD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,+EAA+E;QAC/E,6DAA6D;IAC/D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,WAAW,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,UAAU,oCAAoC,CAClF,CAAC;QACJ,CAAC;QAED,WAAW,CAAC,KAAK,CACf,uBAAuB,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CACtE,CAAC;QAEF,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAErE,WAAW,CAAC,KAAK,CACf,2BAA2B,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAC3E,CAAC;YAEF,0CAA0C;YAC1C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,UAAU,MAAM,KAAK,EAAE,CAAC,CAAC;YAErE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,WAAW,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/CLI/packages/core/src/tools/shell.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ToolInvocation, ToolResult, ToolResultDisplay, ToolCallConfirmationDetails } from './tools.js';
+import type { PermissionDecision } from '../permissions/types.js';
+import { BaseDeclarativeTool, BaseToolInvocation } from './tools.js';
+import type { ShellExecutionConfig } from '../services/shellExecutionService.js';
+export declare const OUTPUT_UPDATE_INTERVAL_MS = 1000;
+export interface ShellToolParams {
+    command: string;
+    is_background: boolean;
+    timeout?: number;
+    description?: string;
+    directory?: string;
+}
+export declare class ShellToolInvocation extends BaseToolInvocation<ShellToolParams, ToolResult> {
+    private readonly config;
+    constructor(config: Config, params: ShellToolParams);
+    getDescription(): string;
+    /**
+     * AST-based permission check for the shell command.
+     * - Read-only commands (via AST analysis) → 'allow'
+     * - All other commands → 'ask'
+     */
+    getDefaultPermission(): Promise<PermissionDecision>;
+    /**
+     * Constructs confirmation dialog details for a shell command that needs
+     * user approval.  For compound commands (e.g. `cd foo && npm run build`),
+     * sub-commands that are already allowed (read-only) are excluded from both
+     * the displayed root-command list and the suggested permission rules.
+     */
+    getConfirmationDetails(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails>;
+    execute(signal: AbortSignal, updateOutput?: (output: ToolResultDisplay) => void, shellExecutionConfig?: ShellExecutionConfig, setPidCallback?: (pid: number) => void): Promise<ToolResult>;
+    private addCoAuthorToGitCommit;
+}
+export declare class ShellTool extends BaseDeclarativeTool<ShellToolParams, ToolResult> {
+    private readonly config;
+    static Name: string;
+    constructor(config: Config);
+    protected validateToolParamValues(params: ShellToolParams): string | null;
+    protected createInvocation(params: ShellToolParams): ToolInvocation<ShellToolParams, ToolResult>;
+}

package/dist/CLI/packages/core/src/tools/shell.js

@@ -0,0 +1,564 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os, { EOL } from 'node:os';
+import crypto from 'node:crypto';
+import { ToolNames, ToolDisplayNames } from './tool-names.js';
+import { ToolErrorType } from './tool-error.js';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { truncateToolOutput } from '../utils/truncation.js';
+import { ShellExecutionService } from '../services/shellExecutionService.js';
+import { formatMemoryUsage } from '../utils/formatters.js';
+import { isSubpaths } from '../utils/paths.js';
+import { getCommandRoot, getCommandRoots, splitCommands, stripShellWrapper, } from '../utils/shell-utils.js';
+import { createDebugLogger } from '../utils/debugLogger.js';
+import { isShellCommandReadOnlyAST, extractCommandRules, } from '../utils/shellAstParser.js';
+const debugLogger = createDebugLogger('SHELL');
+export const OUTPUT_UPDATE_INTERVAL_MS = 1000;
+const DEFAULT_FOREGROUND_TIMEOUT_MS = 120000;
+export class ShellToolInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params) {
+        super(params);
+        this.config = config;
+    }
+    getDescription() {
+        let description = `${this.params.command}`;
+        // append optional [in directory]
+        // note description is needed even if validation fails due to absolute path
+        if (this.params.directory) {
+            description += ` [in ${this.params.directory}]`;
+        }
+        // append background indicator
+        if (this.params.is_background) {
+            description += ` [background]`;
+        }
+        else if (this.params.timeout) {
+            // append timeout for foreground commands
+            description += ` [timeout: ${this.params.timeout}ms]`;
+        }
+        // append optional (description), replacing any line breaks with spaces
+        if (this.params.description) {
+            description += ` (${this.params.description.replace(/\n/g, ' ')})`;
+        }
+        return description;
+    }
+    /**
+     * AST-based permission check for the shell command.
+     * - Read-only commands (via AST analysis) → 'allow'
+     * - All other commands → 'ask'
+     */
+    async getDefaultPermission() {
+        const command = stripShellWrapper(this.params.command);
+        // AST-based read-only detection
+        try {
+            const isReadOnly = await isShellCommandReadOnlyAST(command);
+            if (isReadOnly) {
+                return 'allow';
+            }
+        }
+        catch (e) {
+            debugLogger.warn('AST read-only check failed, falling back to ask:', e);
+        }
+        return 'ask';
+    }
+    /**
+     * Constructs confirmation dialog details for a shell command that needs
+     * user approval.  For compound commands (e.g. `cd foo && npm run build`),
+     * sub-commands that are already allowed (read-only) are excluded from both
+     * the displayed root-command list and the suggested permission rules.
+     */
+    async getConfirmationDetails(_abortSignal) {
+        const command = stripShellWrapper(this.params.command);
+        const pm = this.config.getPermissionManager?.();
+        // Split compound command and filter out already-allowed (read-only) sub-commands
+        const subCommands = splitCommands(command);
+        const confirmableSubCommands = [];
+        for (const sub of subCommands) {
+            let isReadOnly = false;
+            try {
+                isReadOnly = await isShellCommandReadOnlyAST(sub);
+            }
+            catch {
+                // conservative: treat unknown commands as requiring confirmation
+            }
+            if (isReadOnly) {
+                continue;
+            }
+            if (pm) {
+                try {
+                    if ((await pm.isCommandAllowed(sub)) === 'allow') {
+                        continue;
+                    }
+                }
+                catch (e) {
+                    debugLogger.warn('PermissionManager command check failed:', e);
+                }
+            }
+            confirmableSubCommands.push(sub);
+        }
+        // Fallback to all sub-commands if everything was filtered out (shouldn't
+        // normally happen since getDefaultPermission already returned 'ask').
+        const effectiveSubCommands = confirmableSubCommands.length > 0 ? confirmableSubCommands : subCommands;
+        const rootCommands = [
+            ...new Set(effectiveSubCommands
+                .map((c) => getCommandRoot(c))
+                .filter((c) => !!c)),
+        ];
+        // Extract minimum-scope permission rules only for sub-commands that
+        // actually need confirmation.
+        let permissionRules = [];
+        try {
+            const allRules = [];
+            for (const sub of effectiveSubCommands) {
+                const rules = await extractCommandRules(sub);
+                allRules.push(...rules);
+            }
+            permissionRules = [...new Set(allRules)].map((rule) => `Bash(${rule})`);
+        }
+        catch (e) {
+            debugLogger.warn('Failed to extract command rules:', e);
+        }
+        const confirmationDetails = {
+            type: 'exec',
+            title: 'Confirm Shell Command',
+            command: this.params.command,
+            rootCommand: rootCommands.join(', '),
+            permissionRules,
+            onConfirm: async (_outcome, _payload) => {
+                // No-op: persistence is handled by coreToolScheduler via PM rules
+            },
+        };
+        return confirmationDetails;
+    }
+    async execute(signal, updateOutput, shellExecutionConfig, setPidCallback) {
+        const strippedCommand = stripShellWrapper(this.params.command);
+        if (signal.aborted) {
+            return {
+                llmContent: 'Command was cancelled by user before it could start.',
+                returnDisplay: 'Command cancelled by user.',
+            };
+        }
+        const effectiveTimeout = this.params.is_background
+            ? undefined
+            : (this.params.timeout ?? DEFAULT_FOREGROUND_TIMEOUT_MS);
+        // Create combined signal with timeout for foreground execution
+        let combinedSignal = signal;
+        if (effectiveTimeout) {
+            const timeoutSignal = AbortSignal.timeout(effectiveTimeout);
+            combinedSignal = AbortSignal.any([signal, timeoutSignal]);
+        }
+        const isWindows = os.platform() === 'win32';
+        const tempFileName = `shell_pgrep_${crypto
+            .randomBytes(6)
+            .toString('hex')}.tmp`;
+        const tempFilePath = path.join(os.tmpdir(), tempFileName);
+        try {
+            // Add co-author to git commit commands
+            const processedCommand = this.addCoAuthorToGitCommit(strippedCommand);
+            const shouldRunInBackground = this.params.is_background;
+            let finalCommand = processedCommand;
+            // On non-Windows, use & to run in background.
+            // On Windows, we don't use start /B because it creates a detached process that
+            // doesn't die when the parent dies. Instead, we rely on the race logic below
+            // to return early while keeping the process attached (detached: false).
+            if (!isWindows &&
+                shouldRunInBackground &&
+                !finalCommand.trim().endsWith('&')) {
+                finalCommand = finalCommand.trim() + ' &';
+            }
+            // On Windows, we rely on the race logic below to handle background tasks.
+            // We just ensure the command string is clean.
+            if (isWindows && shouldRunInBackground) {
+                finalCommand = finalCommand.trim().replace(/&+$/, '').trim();
+            }
+            // On non-Windows background commands, wrap with pgrep to capture
+            // subprocess PIDs so we can report them to the user.
+            const commandToExecute = !isWindows && shouldRunInBackground
+                ? (() => {
+                    let command = finalCommand.trim();
+                    if (!command.endsWith('&'))
+                        command += ';';
+                    return `{ ${command} }; __code=$?; pgrep -g 0 >${tempFilePath} 2>&1; exit $__code;`;
+                })()
+                : finalCommand;
+            const cwd = this.params.directory || this.config.getTargetDir();
+            let cumulativeOutput = '';
+            let lastUpdateTime = Date.now();
+            let isBinaryStream = false;
+            const { result: resultPromise, pid } = await ShellExecutionService.execute(commandToExecute, cwd, (event) => {
+                let shouldUpdate = false;
+                switch (event.type) {
+                    case 'data':
+                        if (isBinaryStream)
+                            break;
+                        cumulativeOutput = event.chunk;
+                        shouldUpdate = true;
+                        break;
+                    case 'binary_detected':
+                        isBinaryStream = true;
+                        cumulativeOutput =
+                            '[Binary output detected. Halting stream...]';
+                        shouldUpdate = true;
+                        break;
+                    case 'binary_progress':
+                        isBinaryStream = true;
+                        cumulativeOutput = `[Receiving binary output... ${formatMemoryUsage(event.bytesReceived)} received]`;
+                        if (Date.now() - lastUpdateTime > OUTPUT_UPDATE_INTERVAL_MS) {
+                            shouldUpdate = true;
+                        }
+                        break;
+                    default: {
+                        throw new Error('An unhandled ShellOutputEvent was found.');
+                    }
+                }
+                if (shouldUpdate && updateOutput) {
+                    updateOutput(typeof cumulativeOutput === 'string'
+                        ? cumulativeOutput
+                        : { ansiOutput: cumulativeOutput });
+                    lastUpdateTime = Date.now();
+                }
+            }, combinedSignal, shouldRunInBackground
+                ? false
+                : this.config.getShouldUseNodePtyShell(), shellExecutionConfig ?? {});
+            if (pid && setPidCallback) {
+                setPidCallback(pid);
+            }
+            // On Windows, background commands rely on early return since there's
+            // no & backgrounding or pgrep. Awaiting would block until completion.
+            if (shouldRunInBackground && isWindows) {
+                const pidMsg = pid ? ` PID: ${pid}` : '';
+                const killHint = ' (Use taskkill /F /T /PID <pid> to stop)';
+                return {
+                    llmContent: `Background command started.${pidMsg}${killHint}`,
+                    returnDisplay: `Background command started.${pidMsg}${killHint}`,
+                };
+            }
+            const result = await resultPromise;
+            if (shouldRunInBackground) {
+                // Read subprocess PIDs captured by the pgrep wrapper (non-Windows only)
+                const backgroundPIDs = [];
+                if (!isWindows) {
+                    if (fs.existsSync(tempFilePath)) {
+                        const pgrepLines = fs
+                            .readFileSync(tempFilePath, 'utf8')
+                            .split(EOL)
+                            .filter(Boolean);
+                        for (const line of pgrepLines) {
+                            if (!/^\d+$/.test(line)) {
+                                debugLogger.warn(`pgrep: ${line}`);
+                                continue;
+                            }
+                            const bgPid = Number(line);
+                            if (bgPid !== result.pid) {
+                                backgroundPIDs.push(bgPid);
+                            }
+                        }
+                    }
+                    else if (!signal.aborted) {
+                        debugLogger.warn('missing pgrep output');
+                    }
+                }
+                const bgPidMsg = backgroundPIDs.length > 0
+                    ? ` PIDs: ${backgroundPIDs.join(', ')}`
+                    : pid
+                        ? ` PID: ${pid}`
+                        : '';
+                const killHint = ' (Use kill <pid> to stop)';
+                return {
+                    llmContent: `Background command started.${bgPidMsg}${killHint}`,
+                    returnDisplay: `Background command started.${bgPidMsg}${killHint}`,
+                };
+            }
+            let llmContent = '';
+            if (result.aborted) {
+                // Check if it was a timeout or user cancellation
+                const wasTimeout = !this.params.is_background &&
+                    effectiveTimeout &&
+                    combinedSignal.aborted &&
+                    !signal.aborted;
+                if (wasTimeout) {
+                    llmContent = `Command timed out after ${effectiveTimeout}ms before it could complete.`;
+                    if (result.output.trim()) {
+                        llmContent += ` Below is the output before it timed out:\n${result.output}`;
+                    }
+                    else {
+                        llmContent += ' There was no output before it timed out.';
+                    }
+                }
+                else {
+                    llmContent =
+                        'Command was cancelled by user before it could complete.';
+                    if (result.output.trim()) {
+                        llmContent += ` Below is the output before it was cancelled:\n${result.output}`;
+                    }
+                    else {
+                        llmContent += ' There was no output before it was cancelled.';
+                    }
+                }
+            }
+            else {
+                // Create a formatted error string for display, replacing the wrapper command
+                // with the user-facing command.
+                const finalError = result.error
+                    ? result.error.message.replace(commandToExecute, this.params.command)
+                    : '(none)';
+                llmContent = [
+                    `Command: ${this.params.command}`,
+                    `Directory: ${this.params.directory || '(root)'}`,
+                    `Output: ${result.output || '(empty)'}`,
+                    `Error: ${finalError}`, // Use the cleaned error string.
+                    `Exit Code: ${result.exitCode ?? '(none)'}`,
+                    `Signal: ${result.signal ?? '(none)'}`,
+                    `Process Group PGID: ${result.pid ?? '(none)'}`,
+                ].join('\n');
+            }
+            let returnDisplayMessage = '';
+            if (this.config.getDebugMode()) {
+                returnDisplayMessage = llmContent;
+            }
+            else {
+                if (result.output.trim()) {
+                    returnDisplayMessage = result.output;
+                }
+                else {
+                    if (result.aborted) {
+                        // Check if it was a timeout or user cancellation
+                        const wasTimeout = !this.params.is_background &&
+                            effectiveTimeout &&
+                            combinedSignal.aborted &&
+                            !signal.aborted;
+                        returnDisplayMessage = wasTimeout
+                            ? `Command timed out after ${effectiveTimeout}ms.`
+                            : 'Command cancelled by user.';
+                    }
+                    else if (result.signal) {
+                        returnDisplayMessage = `Command terminated by signal: ${result.signal}`;
+                    }
+                    else if (result.error) {
+                        returnDisplayMessage = `Command failed: ${getErrorMessage(result.error)}`;
+                    }
+                    else if (result.exitCode !== null && result.exitCode !== 0) {
+                        returnDisplayMessage = `Command exited with code: ${result.exitCode}`;
+                    }
+                    // If output is empty and command succeeded (code 0, no error/signal/abort),
+                    // returnDisplayMessage will remain empty, which is fine.
+                }
+            }
+            // Truncate large output and save full content to a temp file.
+            if (typeof llmContent === 'string') {
+                const truncatedResult = await truncateToolOutput(this.config, ShellTool.Name, llmContent);
+                if (truncatedResult.outputFile) {
+                    llmContent = truncatedResult.content;
+                    returnDisplayMessage +=
+                        (returnDisplayMessage ? '\n' : '') +
+                            `Output too long and was saved to: ${truncatedResult.outputFile}`;
+                }
+            }
+            const executionError = result.error
+                ? {
+                    error: {
+                        message: result.error.message,
+                        type: ToolErrorType.SHELL_EXECUTE_ERROR,
+                    },
+                }
+                : {};
+            return {
+                llmContent,
+                returnDisplay: returnDisplayMessage,
+                ...executionError,
+            };
+        }
+        finally {
+            if (fs.existsSync(tempFilePath)) {
+                fs.unlinkSync(tempFilePath);
+            }
+        }
+    }
+    addCoAuthorToGitCommit(command) {
+        // Check if co-author feature is enabled
+        const gitCoAuthorSettings = this.config.getGitCoAuthor();
+        if (!gitCoAuthorSettings.enabled) {
+            return command;
+        }
+        // Check if this is a git commit command (anywhere in the command, e.g., after "cd /path &&")
+        const gitCommitPattern = /\bgit\s+commit\b/;
+        if (!gitCommitPattern.test(command)) {
+            return command;
+        }
+        // Define the co-author line using configuration
+        const coAuthor = `
+
+Co-authored-by: ${gitCoAuthorSettings.name} <${gitCoAuthorSettings.email}>`;
+        // Handle different git commit patterns:
+        // Match -m "message" or -m 'message', including combined flags like -am
+        // Use separate patterns to avoid ReDoS (catastrophic backtracking)
+        //
+        // Pattern breakdown:
+        //   -[a-zA-Z]*m  matches -m, -am, -nm, etc. (combined short flags)
+        //   \s+          matches whitespace after the flag
+        //   [^"\\]       matches any char except double-quote and backslash
+        //   \\.          matches escape sequences like \" or \\
+        //   (?:...|...)* matches normal chars or escapes, repeated
+        const doubleQuotePattern = /(-[a-zA-Z]*m\s+)"((?:[^"\\]|\\.)*)"/;
+        const singleQuotePattern = /(-[a-zA-Z]*m\s+)'((?:[^'\\]|\\.)*)'/;
+        const doubleMatch = command.match(doubleQuotePattern);
+        const singleMatch = command.match(singleQuotePattern);
+        const match = doubleMatch ?? singleMatch;
+        const quote = doubleMatch ? '"' : "'";
+        if (match) {
+            const [fullMatch, prefix, existingMessage] = match;
+            const newMessage = existingMessage + coAuthor;
+            const replacement = prefix + quote + newMessage + quote;
+            return command.replace(fullMatch, replacement);
+        }
+        // If no -m flag found, the command might open an editor
+        // In this case, we can't easily modify it, so return as-is
+        return command;
+    }
+}
+function getShellToolDescription() {
+    const isWindows = os.platform() === 'win32';
+    const executionWrapper = isWindows
+        ? 'cmd.exe /c <command>'
+        : 'bash -c <command>';
+    const processGroupNote = isWindows
+        ? ''
+        : '\n  - Command is executed as a subprocess that leads its own process group. Command process group can be terminated as `kill -- -PGID` or signaled as `kill -s SIGNAL -- -PGID`.';
+    return `Executes a given shell command (as \`${executionWrapper}\`) in a persistent shell session with optional timeout, ensuring proper handling and security measures.
+
+IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
+
+**Usage notes**:
+- The command argument is required.
+- You can specify an optional timeout in milliseconds (up to 600000ms / 10 minutes). If not specified, commands will timeout after 120000ms (2 minutes).
+- It is very helpful if you write a clear, concise description of what this command does in 5-10 words.
+
+- Avoid using run_shell_command with the \`find\`, \`grep\`, \`cat\`, \`head\`, \`tail\`, \`sed\`, \`awk\`, or \`echo\` commands, unless explicitly instructed or when these commands are truly necessary for the task. Instead, always prefer using the dedicated tools for these commands:
+  - File search: Use ${ToolNames.GLOB} (NOT find or ls)
+  - Content search: Use ${ToolNames.GREP} (NOT grep or rg)
+  - Read files: Use ${ToolNames.READ_FILE} (NOT cat/head/tail)
+  - Edit files: Use ${ToolNames.EDIT} (NOT sed/awk)
+  - Write files: Use ${ToolNames.WRITE_FILE} (NOT echo >/cat <<EOF)
+  - Communication: Output text directly (NOT echo/printf)
+- When issuing multiple commands:
+  - If the commands are independent and can run in parallel, make multiple run_shell_command tool calls in a single message. For example, if you need to run "git status" and "git diff", send a single message with two run_shell_command tool calls in parallel.
+  - If the commands depend on each other and must run sequentially, use a single run_shell_command call with '&&' to chain them together (e.g., \`git add . && git commit -m "message" && git push\`). For instance, if one operation must complete before another starts (like mkdir before cp, Write before run_shell_command for git operations, or git add before git commit), run these operations sequentially instead.
+  - Use ';' only when you need to run commands sequentially but don't care if earlier commands fail
+  - DO NOT use newlines to separate commands (newlines are ok in quoted strings)
+- Try to maintain your current working directory throughout the session by using absolute paths and avoiding usage of \`cd\`. You may use \`cd\` if the User explicitly requests it.
+  <good-example>
+  pytest /foo/bar/tests
+  </good-example>
+  <bad-example>
+  cd /foo/bar && pytest tests
+  </bad-example>
+
+**Background vs Foreground Execution:**
+- You should decide whether commands should run in background or foreground based on their nature:
+- Use background execution (is_background: true) for:
+  - Long-running development servers: \`npm run start\`, \`npm run dev\`, \`yarn dev\`, \`bun run start\`
+  - Build watchers: \`npm run watch\`, \`webpack --watch\`
+  - Database servers: \`mongod\`, \`mysql\`, \`redis-server\`
+  - Web servers: \`python -m http.server\`, \`php -S localhost:8000\`
+  - Any command expected to run indefinitely until manually stopped
+${processGroupNote}
+- Use foreground execution (is_background: false) for:
+  - One-time commands: \`ls\`, \`cat\`, \`grep\`
+  - Build commands: \`npm run build\`, \`make\`
+  - Installation commands: \`npm install\`, \`pip install\`
+  - Git operations: \`git commit\`, \`git push\`
+  - Test runs: \`npm test\`, \`pytest\`
+`;
+}
+function getCommandDescription() {
+    if (os.platform() === 'win32') {
+        return 'Exact command to execute as `cmd.exe /c <command>`';
+    }
+    else {
+        return 'Exact bash command to execute as `bash -c <command>`';
+    }
+}
+export class ShellTool extends BaseDeclarativeTool {
+    config;
+    static Name = ToolNames.SHELL;
+    constructor(config) {
+        super(ShellTool.Name, ToolDisplayNames.SHELL, getShellToolDescription(), Kind.Execute, {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: getCommandDescription(),
+                },
+                is_background: {
+                    type: 'boolean',
+                    description: 'Optional: Whether to run the command in background. If not specified, defaults to false (foreground execution). Explicitly set to true for long-running processes like development servers, watchers, or daemons that should continue running without blocking further commands.',
+                },
+                timeout: {
+                    type: 'number',
+                    description: 'Optional timeout in milliseconds (max 600000)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Brief description of the command for the user. Be specific and concise. Ideally a single sentence. Can be up to 3 sentences for clarity. No line breaks.',
+                },
+                directory: {
+                    type: 'string',
+                    description: '(OPTIONAL) The absolute path of the directory to run the command in. If not provided, the project root directory is used. Must be a directory within the workspace and must already exist.',
+                },
+            },
+            required: ['command'],
+        }, false, // output is not markdown
+        true);
+        this.config = config;
+    }
+    validateToolParamValues(params) {
+        // NOTE: Permission checks (read-only detection, PM rules) are handled at
+        // L3 (getDefaultPermission) and L4 (PM override) in coreToolScheduler.
+        // This method only performs pure parameter validation.
+        if (!params.command.trim()) {
+            return 'Command cannot be empty.';
+        }
+        if (getCommandRoots(params.command).length === 0) {
+            return 'Could not identify command root to obtain permission from user.';
+        }
+        if (params.timeout !== undefined) {
+            if (typeof params.timeout !== 'number' ||
+                !Number.isInteger(params.timeout)) {
+                return 'Timeout must be an integer number of milliseconds.';
+            }
+            if (params.timeout <= 0) {
+                return 'Timeout must be a positive number.';
+            }
+            if (params.timeout > 600000) {
+                return 'Timeout cannot exceed 600000ms (10 minutes).';
+            }
+        }
+        if (params.directory) {
+            if (!path.isAbsolute(params.directory)) {
+                return 'Directory must be an absolute path.';
+            }
+            const userSkillsDirs = this.config.storage.getUserSkillsDirs();
+            const resolvedDirectoryPath = path.resolve(params.directory);
+            const isWithinUserSkills = isSubpaths(userSkillsDirs, resolvedDirectoryPath);
+            if (isWithinUserSkills) {
+                return `Explicitly running shell commands from within the user skills directory is not allowed. Please use absolute paths for command parameter instead.`;
+            }
+            const workspaceDirs = this.config.getWorkspaceContext().getDirectories();
+            const isWithinWorkspace = workspaceDirs.some((wsDir) => params.directory.startsWith(wsDir));
+            if (!isWithinWorkspace) {
+                return `Directory '${params.directory}' is not within any of the registered workspace directories.`;
+            }
+        }
+        return null;
+    }
+    createInvocation(params) {
+        return new ShellToolInvocation(this.config, params);
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/CLI/packages/core/src/tools/shell.js.map

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