@google/gemini-cli-core 0.1.0-development.1

package/dist/src/tools/shell.js

@@ -0,0 +1,421 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import crypto from 'crypto';
+import { BaseTool, ToolConfirmationOutcome, } from './tools.js';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { getErrorMessage } from '../utils/errors.js';
+import stripAnsi from 'strip-ansi';
+import { spawn } from 'child_process';
+const OUTPUT_UPDATE_INTERVAL_MS = 1000;
+export class ShellTool extends BaseTool {
+    config;
+    static Name = 'run_shell_command';
+    whitelist = new Set();
+    constructor(config) {
+        super(ShellTool.Name, 'Shell', `This tool executes a given shell command as \`bash -c <command>\`. Command can start background processes using \`&\`. 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\`.
+
+The following information is returned:
+
+Command: Executed command.
+Directory: Directory (relative to project root) where command was executed, or \`(root)\`.
+Stdout: Output on stdout stream. Can be \`(empty)\` or partial on error and for any unwaited background processes.
+Stderr: Output on stderr stream. Can be \`(empty)\` or partial on error and for any unwaited background processes.
+Error: Error or \`(none)\` if no error was reported for the subprocess.
+Exit Code: Exit code or \`(none)\` if terminated by signal.
+Signal: Signal number or \`(none)\` if no signal was received.
+Background PIDs: List of background processes started or \`(none)\`.
+Process Group PGID: Process group started or \`(none)\``, {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'Exact bash command to execute as `bash -c <command>`',
+                },
+                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) Directory to run the command in, if not the project root directory. Must be relative to the project root directory and must already exist.',
+                },
+            },
+            required: ['command'],
+        }, false, // output is not markdown
+        true);
+        this.config = config;
+    }
+    getDescription(params) {
+        let description = `${params.command}`;
+        // append optional [in directory]
+        // note description is needed even if validation fails due to absolute path
+        if (params.directory) {
+            description += ` [in ${params.directory}]`;
+        }
+        // append optional (description), replacing any line breaks with spaces
+        if (params.description) {
+            description += ` (${params.description.replace(/\n/g, ' ')})`;
+        }
+        return description;
+    }
+    /**
+     * Extracts the root command from a given shell command string.
+     * This is used to identify the base command for permission checks.
+     *
+     * @param command The shell command string to parse
+     * @returns The root command name, or undefined if it cannot be determined
+     * @example getCommandRoot("ls -la /tmp") returns "ls"
+     * @example getCommandRoot("git status && npm test") returns "git"
+     */
+    getCommandRoot(command) {
+        return command
+            .trim() // remove leading and trailing whitespace
+            .replace(/[{}()]/g, '') // remove all grouping operators
+            .split(/[\s;&|]+/)[0] // split on any whitespace or separator or chaining operators and take first part
+            ?.split(/[/\\]/) // split on any path separators (or return undefined if previous line was undefined)
+            .pop(); // take last part and return command root (or undefined if previous line was empty)
+    }
+    /**
+     * Determines whether a given shell command is allowed to execute based on
+     * the tool's configuration including allowlists and blocklists.
+     *
+     * @param command The shell command string to validate
+     * @returns An object with 'allowed' boolean and optional 'reason' string if not allowed
+     */
+    isCommandAllowed(command) {
+        // 0. Disallow command substitution
+        if (command.includes('$(')) {
+            return {
+                allowed: false,
+                reason: 'Command substitution using $() is not allowed for security reasons',
+            };
+        }
+        const SHELL_TOOL_NAMES = [ShellTool.name, ShellTool.Name];
+        const normalize = (cmd) => cmd.trim().replace(/\s+/g, ' ');
+        /**
+         * Checks if a command string starts with a given prefix, ensuring it's a
+         * whole word match (i.e., followed by a space or it's an exact match).
+         * e.g., `isPrefixedBy('npm install', 'npm')` -> true
+         * e.g., `isPrefixedBy('npm', 'npm')` -> true
+         * e.g., `isPrefixedBy('npminstall', 'npm')` -> false
+         */
+        const isPrefixedBy = (cmd, prefix) => {
+            if (!cmd.startsWith(prefix)) {
+                return false;
+            }
+            return cmd.length === prefix.length || cmd[prefix.length] === ' ';
+        };
+        /**
+         * Extracts and normalizes shell commands from a list of tool strings.
+         * e.g., 'ShellTool("ls -l")' becomes 'ls -l'
+         */
+        const extractCommands = (tools) => tools.flatMap((tool) => {
+            for (const toolName of SHELL_TOOL_NAMES) {
+                if (tool.startsWith(`${toolName}(`) && tool.endsWith(')')) {
+                    return [normalize(tool.slice(toolName.length + 1, -1))];
+                }
+            }
+            return [];
+        });
+        const coreTools = this.config.getCoreTools() || [];
+        const excludeTools = this.config.getExcludeTools() || [];
+        // 1. Check if the shell tool is globally disabled.
+        if (SHELL_TOOL_NAMES.some((name) => excludeTools.includes(name))) {
+            return {
+                allowed: false,
+                reason: 'Shell tool is globally disabled in configuration',
+            };
+        }
+        const blockedCommands = new Set(extractCommands(excludeTools));
+        const allowedCommands = new Set(extractCommands(coreTools));
+        const hasSpecificAllowedCommands = allowedCommands.size > 0;
+        const isWildcardAllowed = SHELL_TOOL_NAMES.some((name) => coreTools.includes(name));
+        const commandsToValidate = command.split(/&&|\|\||\||;/).map(normalize);
+        const blockedCommandsArr = [...blockedCommands];
+        for (const cmd of commandsToValidate) {
+            // 2. Check if the command is on the blocklist.
+            const isBlocked = blockedCommandsArr.some((blocked) => isPrefixedBy(cmd, blocked));
+            if (isBlocked) {
+                return {
+                    allowed: false,
+                    reason: `Command '${cmd}' is blocked by configuration`,
+                };
+            }
+            // 3. If in strict allow-list mode, check if the command is permitted.
+            const isStrictAllowlist = hasSpecificAllowedCommands && !isWildcardAllowed;
+            const allowedCommandsArr = [...allowedCommands];
+            if (isStrictAllowlist) {
+                const isAllowed = allowedCommandsArr.some((allowed) => isPrefixedBy(cmd, allowed));
+                if (!isAllowed) {
+                    return {
+                        allowed: false,
+                        reason: `Command '${cmd}' is not in the allowed commands list`,
+                    };
+                }
+            }
+        }
+        // 4. If all checks pass, the command is allowed.
+        return { allowed: true };
+    }
+    validateToolParams(params) {
+        const commandCheck = this.isCommandAllowed(params.command);
+        if (!commandCheck.allowed) {
+            if (!commandCheck.reason) {
+                console.error('Unexpected: isCommandAllowed returned false without a reason');
+                return `Command is not allowed: ${params.command}`;
+            }
+            return commandCheck.reason;
+        }
+        if (!SchemaValidator.validate(this.parameterSchema, params)) {
+            return `Parameters failed schema validation.`;
+        }
+        if (!params.command.trim()) {
+            return 'Command cannot be empty.';
+        }
+        if (!this.getCommandRoot(params.command)) {
+            return 'Could not identify command root to obtain permission from user.';
+        }
+        if (params.directory) {
+            if (path.isAbsolute(params.directory)) {
+                return 'Directory cannot be absolute. Must be relative to the project root directory.';
+            }
+            const directory = path.resolve(this.config.getTargetDir(), params.directory);
+            if (!fs.existsSync(directory)) {
+                return 'Directory must exist.';
+            }
+        }
+        return null;
+    }
+    async shouldConfirmExecute(params, _abortSignal) {
+        if (this.validateToolParams(params)) {
+            return false; // skip confirmation, execute call will fail immediately
+        }
+        const rootCommand = this.getCommandRoot(params.command); // must be non-empty string post-validation
+        if (this.whitelist.has(rootCommand)) {
+            return false; // already approved and whitelisted
+        }
+        const confirmationDetails = {
+            type: 'exec',
+            title: 'Confirm Shell Command',
+            command: params.command,
+            rootCommand,
+            onConfirm: async (outcome) => {
+                if (outcome === ToolConfirmationOutcome.ProceedAlways) {
+                    this.whitelist.add(rootCommand);
+                }
+            },
+        };
+        return confirmationDetails;
+    }
+    async execute(params, abortSignal, updateOutput) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return {
+                llmContent: [
+                    `Command rejected: ${params.command}`,
+                    `Reason: ${validationError}`,
+                ].join('\n'),
+                returnDisplay: `Error: ${validationError}`,
+            };
+        }
+        if (abortSignal.aborted) {
+            return {
+                llmContent: 'Command was cancelled by user before it could start.',
+                returnDisplay: 'Command cancelled by user.',
+            };
+        }
+        const isWindows = os.platform() === 'win32';
+        const tempFileName = `shell_pgrep_${crypto
+            .randomBytes(6)
+            .toString('hex')}.tmp`;
+        const tempFilePath = path.join(os.tmpdir(), tempFileName);
+        // pgrep is not available on Windows, so we can't get background PIDs
+        const command = isWindows
+            ? params.command
+            : (() => {
+                // wrap command to append subprocess pids (via pgrep) to temporary file
+                let command = params.command.trim();
+                if (!command.endsWith('&'))
+                    command += ';';
+                return `{ ${command} }; __code=$?; pgrep -g 0 >${tempFilePath} 2>&1; exit $__code;`;
+            })();
+        // spawn command in specified directory (or project root if not specified)
+        const shell = isWindows
+            ? spawn('cmd.exe', ['/c', command], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                // detached: true, // ensure subprocess starts its own process group (esp. in Linux)
+                cwd: path.resolve(this.config.getTargetDir(), params.directory || ''),
+            })
+            : spawn('bash', ['-c', command], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                detached: true, // ensure subprocess starts its own process group (esp. in Linux)
+                cwd: path.resolve(this.config.getTargetDir(), params.directory || ''),
+            });
+        let exited = false;
+        let stdout = '';
+        let output = '';
+        let lastUpdateTime = Date.now();
+        const appendOutput = (str) => {
+            output += str;
+            if (updateOutput &&
+                Date.now() - lastUpdateTime > OUTPUT_UPDATE_INTERVAL_MS) {
+                updateOutput(output);
+                lastUpdateTime = Date.now();
+            }
+        };
+        shell.stdout.on('data', (data) => {
+            // continue to consume post-exit for background processes
+            // removing listeners can overflow OS buffer and block subprocesses
+            // destroying (e.g. shell.stdout.destroy()) can terminate subprocesses via SIGPIPE
+            if (!exited) {
+                const str = stripAnsi(data.toString());
+                stdout += str;
+                appendOutput(str);
+            }
+        });
+        let stderr = '';
+        shell.stderr.on('data', (data) => {
+            if (!exited) {
+                const str = stripAnsi(data.toString());
+                stderr += str;
+                appendOutput(str);
+            }
+        });
+        let error = null;
+        shell.on('error', (err) => {
+            error = err;
+            // remove wrapper from user's command in error message
+            error.message = error.message.replace(command, params.command);
+        });
+        let code = null;
+        let processSignal = null;
+        const exitHandler = (_code, _signal) => {
+            exited = true;
+            code = _code;
+            processSignal = _signal;
+        };
+        shell.on('exit', exitHandler);
+        const abortHandler = async () => {
+            if (shell.pid && !exited) {
+                if (os.platform() === 'win32') {
+                    // For Windows, use taskkill to kill the process tree
+                    spawn('taskkill', ['/pid', shell.pid.toString(), '/f', '/t']);
+                }
+                else {
+                    try {
+                        // attempt to SIGTERM process group (negative PID)
+                        // fall back to SIGKILL (to group) after 200ms
+                        process.kill(-shell.pid, 'SIGTERM');
+                        await new Promise((resolve) => setTimeout(resolve, 200));
+                        if (shell.pid && !exited) {
+                            process.kill(-shell.pid, 'SIGKILL');
+                        }
+                    }
+                    catch (_e) {
+                        // if group kill fails, fall back to killing just the main process
+                        try {
+                            if (shell.pid) {
+                                shell.kill('SIGKILL');
+                            }
+                        }
+                        catch (_e) {
+                            console.error(`failed to kill shell process ${shell.pid}: ${_e}`);
+                        }
+                    }
+                }
+            }
+        };
+        abortSignal.addEventListener('abort', abortHandler);
+        // wait for the shell to exit
+        try {
+            await new Promise((resolve) => shell.on('exit', resolve));
+        }
+        finally {
+            abortSignal.removeEventListener('abort', abortHandler);
+        }
+        // parse pids (pgrep output) from temporary file and remove it
+        const backgroundPIDs = [];
+        if (os.platform() !== 'win32') {
+            if (fs.existsSync(tempFilePath)) {
+                const pgrepLines = fs
+                    .readFileSync(tempFilePath, 'utf8')
+                    .split('\n')
+                    .filter(Boolean);
+                for (const line of pgrepLines) {
+                    if (!/^\d+$/.test(line)) {
+                        console.error(`pgrep: ${line}`);
+                    }
+                    const pid = Number(line);
+                    // exclude the shell subprocess pid
+                    if (pid !== shell.pid) {
+                        backgroundPIDs.push(pid);
+                    }
+                }
+                fs.unlinkSync(tempFilePath);
+            }
+            else {
+                if (!abortSignal.aborted) {
+                    console.error('missing pgrep output');
+                }
+            }
+        }
+        let llmContent = '';
+        if (abortSignal.aborted) {
+            llmContent = 'Command was cancelled by user before it could complete.';
+            if (output.trim()) {
+                llmContent += ` Below is the output (on stdout and stderr) before it was cancelled:\n${output}`;
+            }
+            else {
+                llmContent += ' There was no output before it was cancelled.';
+            }
+        }
+        else {
+            llmContent = [
+                `Command: ${params.command}`,
+                `Directory: ${params.directory || '(root)'}`,
+                `Stdout: ${stdout || '(empty)'}`,
+                `Stderr: ${stderr || '(empty)'}`,
+                `Error: ${error ?? '(none)'}`,
+                `Exit Code: ${code ?? '(none)'}`,
+                `Signal: ${processSignal ?? '(none)'}`,
+                `Background PIDs: ${backgroundPIDs.length ? backgroundPIDs.join(', ') : '(none)'}`,
+                `Process Group PGID: ${shell.pid ?? '(none)'}`,
+            ].join('\n');
+        }
+        let returnDisplayMessage = '';
+        if (this.config.getDebugMode()) {
+            returnDisplayMessage = llmContent;
+        }
+        else {
+            if (output.trim()) {
+                returnDisplayMessage = output;
+            }
+            else {
+                // Output is empty, let's provide a reason if the command failed or was cancelled
+                if (abortSignal.aborted) {
+                    returnDisplayMessage = 'Command cancelled by user.';
+                }
+                else if (processSignal) {
+                    returnDisplayMessage = `Command terminated by signal: ${processSignal}`;
+                }
+                else if (error) {
+                    // If error is not null, it's an Error object (or other truthy value)
+                    returnDisplayMessage = `Command failed: ${getErrorMessage(error)}`;
+                }
+                else if (code !== null && code !== 0) {
+                    returnDisplayMessage = `Command exited with code: ${code}`;
+                }
+                // If output is empty and command succeeded (code 0, no error/signal/abort),
+                // returnDisplayMessage will remain empty, which is fine.
+            }
+        }
+        return { llmContent, returnDisplay: returnDisplayMessage };
+    }
+}
+//# sourceMappingURL=shell.js.map

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

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

package/dist/src/tools/shell.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};