Beta Shell v2.0

File Manager

~ /usr/local/lib/node_modules/@google/gemini-cli/dist/src/ui/hooks

Name	Size	Perms	Modified	Actions
[ .. / .. ]
atCommandProcessor.d.ts	1.21 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
atCommandProcessor.js	14.18 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
atCommandProcessor.js.map	10.15 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
shellCommandProcessor.d.ts	860 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
shellCommandProcessor.js	11.26 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
shellCommandProcessor.js.map	8.18 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
slashCommandProcessor.d.ts	1.75 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
slashCommandProcessor.js	44.94 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
slashCommandProcessor.js.map	27.01 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAuthCommand.d.ts	581 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAuthCommand.js	1.89 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAuthCommand.js.map	1.73 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAutoAcceptIndicator.d.ts	328 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAutoAcceptIndicator.js	1.35 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useAutoAcceptIndicator.js.map	1.18 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useBracketedPaste.d.ts	357 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useBracketedPaste.js	1.01 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useBracketedPaste.js.map	903 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useCompletion.d.ts	864 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useCompletion.js	14.97 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useCompletion.js.map	11.65 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useConsoleMessages.d.ts	398 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useConsoleMessages.js	2.35 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useConsoleMessages.js.map	2.21 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useEditorSettings.d.ts	722 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useEditorSettings.js	1.53 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useEditorSettings.js.map	1.38 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.d.ts	1.35 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.js	24.15 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.js.map	17.46 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.test.d.ts	99 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.test.js	31.87 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGeminiStream.test.js.map	25.13 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGitBranchName.d.ts	163 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGitBranchName.js	2.27 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useGitBranchName.js.map	1.88 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useHistoryManager.d.ts	809 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useHistoryManager.js	2.65 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useHistoryManager.js.map	1.98 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useInputHistory.d.ts	590 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useInputHistory.js	2.63 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useInputHistory.js.map	2.17 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useKeypress.d.ts	910 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useKeypress.js	2.97 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useKeypress.js.map	2.27 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLoadingIndicator.d.ts	276 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLoadingIndicator.js	2.15 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLoadingIndicator.js.map	1.63 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLogger.d.ts	238 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLogger.js	886 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useLogger.js.map	660 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePhraseCycler.d.ts	520 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePhraseCycler.js	7.97 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePhraseCycler.js.map	3.37 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePrivacySettings.d.ts	441 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePrivacySettings.js	3.71 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
usePrivacySettings.js.map	3.06 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useReactToolScheduler.d.ts	1.83 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useReactToolScheduler.js	7.57 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useReactToolScheduler.js.map	5.57 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useRefreshMemoryCommand.d.ts	157 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useRefreshMemoryCommand.js	200 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useRefreshMemoryCommand.js.map	212 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShellHistory.d.ts	331 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShellHistory.js	3.03 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShellHistory.js.map	3.12 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShowMemoryCommand.d.ts	394 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShowMemoryCommand.js	2.3 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useShowMemoryCommand.js.map	1.8 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useStateAndRef.d.ts	300 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useStateAndRef.js	894 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useStateAndRef.js.map	799 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTerminalSize.d.ts	175 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTerminalSize.js	797 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTerminalSize.js.map	871 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useThemeCommand.d.ts	686 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useThemeCommand.js	3.12 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useThemeCommand.js.map	2.41 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTimer.d.ts	434 B	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTimer.js	1.96 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del
useTimer.js.map	1.52 KB	-rw-r--r--	1985-10-26 08:15:00	Edit Del

Editing: shellCommandProcessor.js (11.26 KB)

/**
 * @license
 * Copyright 2025 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */
import { spawn } from 'child_process';
import { StringDecoder } from 'string_decoder';
import { useCallback } from 'react';
import { formatMemoryUsage } from '../utils/formatters.js';
import { isBinary } from '../utils/textUtils.js';
import crypto from 'crypto';
import path from 'path';
import os from 'os';
import fs from 'fs';
import stripAnsi from 'strip-ansi';
const OUTPUT_UPDATE_INTERVAL_MS = 1000;
const MAX_OUTPUT_LENGTH = 10000;
/**
 * Executes a shell command using `spawn`, capturing all output and lifecycle events.
 * This is the single, unified implementation for shell execution.
 *
 * @param commandToExecute The exact command string to run.
 * @param cwd The working directory to execute the command in.
 * @param abortSignal An AbortSignal to terminate the process.
 * @param onOutputChunk A callback for streaming real-time output.
 * @param onDebugMessage A callback for logging debug information.
 * @returns A promise that resolves with the complete execution result.
 */
function executeShellCommand(commandToExecute, cwd, abortSignal, onOutputChunk, onDebugMessage) {
    return new Promise((resolve) => {
        const isWindows = os.platform() === 'win32';
        const shell = isWindows ? 'cmd.exe' : 'bash';
        const shellArgs = isWindows
            ? ['/c', commandToExecute]
            : ['-c', commandToExecute];
        const child = spawn(shell, shellArgs, {
            cwd,
            stdio: ['ignore', 'pipe', 'pipe'],
            detached: !isWindows, // Use process groups on non-Windows for robust killing
        });
        // Use decoders to handle multi-byte characters safely (for streaming output).
        const stdoutDecoder = new StringDecoder('utf8');
        const stderrDecoder = new StringDecoder('utf8');
        let stdout = '';
        let stderr = '';
        const outputChunks = [];
        let error = null;
        let exited = false;
        let streamToUi = true;
        const MAX_SNIFF_SIZE = 4096;
        let sniffedBytes = 0;
        const handleOutput = (data, stream) => {
            outputChunks.push(data);
            if (streamToUi && sniffedBytes < MAX_SNIFF_SIZE) {
                // Use a limited-size buffer for the check to avoid performance issues.
                const sniffBuffer = Buffer.concat(outputChunks.slice(0, 20));
                sniffedBytes = sniffBuffer.length;
                if (isBinary(sniffBuffer)) {
                    streamToUi = false;
                    // Overwrite any garbled text that may have streamed with a clear message.
                    onOutputChunk('[Binary output detected. Halting stream...]');
                }
            }
            const decodedChunk = stream === 'stdout'
                ? stdoutDecoder.write(data)
                : stderrDecoder.write(data);
            if (stream === 'stdout') {
                stdout += stripAnsi(decodedChunk);
            }
            else {
                stderr += stripAnsi(decodedChunk);
            }
            if (!exited && streamToUi) {
                // Send only the new chunk to avoid re-rendering the whole output.
                const combinedOutput = stdout + (stderr ? `\n${stderr}` : '');
                onOutputChunk(combinedOutput);
            }
            else if (!exited && !streamToUi) {
                // Send progress updates for the binary stream
                const totalBytes = outputChunks.reduce((sum, chunk) => sum + chunk.length, 0);
                onOutputChunk(`[Receiving binary output... ${formatMemoryUsage(totalBytes)} received]`);
            }
        };
        child.stdout.on('data', (data) => handleOutput(data, 'stdout'));
        child.stderr.on('data', (data) => handleOutput(data, 'stderr'));
        child.on('error', (err) => {
            error = err;
        });
        const abortHandler = async () => {
            if (child.pid && !exited) {
                onDebugMessage(`Aborting shell command (PID: ${child.pid})`);
                if (isWindows) {
                    spawn('taskkill', ['/pid', child.pid.toString(), '/f', '/t']);
                }
                else {
                    try {
                        // Kill the entire process group (negative PID).
                        // SIGTERM first, then SIGKILL if it doesn't die.
                        process.kill(-child.pid, 'SIGTERM');
                        await new Promise((res) => setTimeout(res, 200));
                        if (!exited) {
                            process.kill(-child.pid, 'SIGKILL');
                        }
                    }
                    catch (_e) {
                        // Fallback to killing just the main process if group kill fails.
                        if (!exited)
                            child.kill('SIGKILL');
                    }
                }
            }
        };
        abortSignal.addEventListener('abort', abortHandler, { once: true });
        child.on('exit', (code, signal) => {
            exited = true;
            abortSignal.removeEventListener('abort', abortHandler);
            // Handle any final bytes lingering in the decoders
            stdout += stdoutDecoder.end();
            stderr += stderrDecoder.end();
            const finalBuffer = Buffer.concat(outputChunks);
            resolve({
                rawOutput: finalBuffer,
                output: stdout + (stderr ? `\n${stderr}` : ''),
                exitCode: code,
                signal,
                error,
                aborted: abortSignal.aborted,
            });
        });
    });
}
function addShellCommandToGeminiHistory(geminiClient, rawQuery, resultText) {
    const modelContent = resultText.length > MAX_OUTPUT_LENGTH
        ? resultText.substring(0, MAX_OUTPUT_LENGTH) + '\n... (truncated)'
        : resultText;
    geminiClient.addHistory({
        role: 'user',
        parts: [
            {
                text: `I ran the following shell command:
\`\`\`sh
${rawQuery}
\`\`\`

This produced the following result:
\`\`\`
${modelContent}
\`\`\``,
            },
        ],
    });
}
/**
 * Hook to process shell commands.
 * Orchestrates command execution and updates history and agent context.
 */
export const useShellCommandProcessor = (addItemToHistory, setPendingHistoryItem, onExec, onDebugMessage, config, geminiClient) => {
    const handleShellCommand = useCallback((rawQuery, abortSignal) => {
        if (typeof rawQuery !== 'string' || rawQuery.trim() === '') {
            return false;
        }
        const userMessageTimestamp = Date.now();
        addItemToHistory({ type: 'user_shell', text: rawQuery }, userMessageTimestamp);
        const isWindows = os.platform() === 'win32';
        const targetDir = config.getTargetDir();
        let commandToExecute = rawQuery;
        let pwdFilePath;
        // On non-windows, wrap the command to capture the final working directory.
        if (!isWindows) {
            let command = rawQuery.trim();
            const pwdFileName = `shell_pwd_${crypto.randomBytes(6).toString('hex')}.tmp`;
            pwdFilePath = path.join(os.tmpdir(), pwdFileName);
            // Ensure command ends with a separator before adding our own.
            if (!command.endsWith(';') && !command.endsWith('&')) {
                command += ';';
            }
            commandToExecute = `{ ${command} }; __code=$?; pwd > "${pwdFilePath}"; exit $__code`;
        }
        const execPromise = new Promise((resolve) => {
            let lastUpdateTime = 0;
            onDebugMessage(`Executing in ${targetDir}: ${commandToExecute}`);
            executeShellCommand(commandToExecute, targetDir, abortSignal, (streamedOutput) => {
                // Throttle pending UI updates to avoid excessive re-renders.
                if (Date.now() - lastUpdateTime > OUTPUT_UPDATE_INTERVAL_MS) {
                    setPendingHistoryItem({ type: 'info', text: streamedOutput });
                    lastUpdateTime = Date.now();
                }
            }, onDebugMessage)
                .then((result) => {
                // TODO(abhipatel12) - Consider updating pending item and using timeout to ensure
                // there is no jump where intermediate output is skipped.
                setPendingHistoryItem(null);
                let historyItemType = 'info';
                let mainContent;
                // The context sent to the model utilizes a text tokenizer which means raw binary data is
                // cannot be parsed and understood and thus would only pollute the context window and waste
                // tokens.
                if (isBinary(result.rawOutput)) {
                    mainContent =
                        '[Command produced binary output, which is not shown.]';
                }
                else {
                    mainContent =
                        result.output.trim() || '(Command produced no output)';
                }
                let finalOutput = mainContent;
                if (result.error) {
                    historyItemType = 'error';
                    finalOutput = `${result.error.message}\n${finalOutput}`;
                }
                else if (result.aborted) {
                    finalOutput = `Command was cancelled.\n${finalOutput}`;
                }
                else if (result.signal) {
                    historyItemType = 'error';
                    finalOutput = `Command terminated by signal: ${result.signal}.\n${finalOutput}`;
                }
                else if (result.exitCode !== 0) {
                    historyItemType = 'error';
                    finalOutput = `Command exited with code ${result.exitCode}.\n${finalOutput}`;
                }
                if (pwdFilePath && fs.existsSync(pwdFilePath)) {
                    const finalPwd = fs.readFileSync(pwdFilePath, 'utf8').trim();
                    if (finalPwd && finalPwd !== targetDir) {
                        const warning = `WARNING: shell mode is stateless; the directory change to '${finalPwd}' will not persist.`;
                        finalOutput = `${warning}\n\n${finalOutput}`;
                    }
                }
                // Add the complete, contextual result to the local UI history.
                addItemToHistory({ type: historyItemType, text: finalOutput }, userMessageTimestamp);
                // Add the same complete, contextual result to the LLM's history.
                addShellCommandToGeminiHistory(geminiClient, rawQuery, finalOutput);
            })
                .catch((err) => {
                setPendingHistoryItem(null);
                const errorMessage = err instanceof Error ? err.message : String(err);
                addItemToHistory({
                    type: 'error',
                    text: `An unexpected error occurred: ${errorMessage}`,
                }, userMessageTimestamp);
            })
                .finally(() => {
                if (pwdFilePath && fs.existsSync(pwdFilePath)) {
                    fs.unlinkSync(pwdFilePath);
                }
                resolve();
            });
        });
        onExec(execPromise);
        return true; // Command was initiated
    }, [
        config,
        onDebugMessage,
        addItemToHistory,
        setPendingHistoryItem,
        onExec,
        geminiClient,
    ]);
    return { handleShellCommand };
};
//# sourceMappingURL=shellCommandProcessor.js.map