@google/gemini-cli 0.1.1 → 0.1.3-rc.0

package/dist/src/ui/editors/editorSettingsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorSettingsManager.js","sourceRoot":"","sources":["../../../../src/ui/editors/editorSettingsManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAQjC,MAAM,CAAC,MAAM,oBAAoB,GAA+B;IAC9D,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,MAAM,qBAAqB;IACR,gBAAgB,CAAkB;IAEnD;QACE,MAAM,WAAW,GAAiB;YAChC,KAAK;YACL,QAAQ;YACR,UAAU;YACV,QAAQ;YACR,KAAK;SACN,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG;YACtB;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;aAChB;YACD,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC1B,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC3C,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;gBAE1D,IAAI,WAAW,GAAG,CAAC,kBAAkB;oBACnC,CAAC,CAAC,6BAA6B;oBAC/B,CAAC,CAAC,EAAE,CAAC;gBACP,WAAW,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC;gBAE5D,OAAO;oBACL,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAAG,WAAW;oBAC9C,IAAI;oBACJ,QAAQ,EAAE,CAAC,SAAS,IAAI,CAAC,kBAAkB;iBAC5C,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/src/ui/hooks/atCommandProcessor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { PartListUnion } from '@google/genai';
+import { Config } from '@google/gemini-cli-core';
+import { UseHistoryManagerReturn } from './useHistoryManager.js';
+interface HandleAtCommandParams {
+    query: string;
+    config: Config;
+    addItem: UseHistoryManagerReturn['addItem'];
+    onDebugMessage: (message: string) => void;
+    messageId: number;
+    signal: AbortSignal;
+}
+interface HandleAtCommandResult {
+    processedQuery: PartListUnion | null;
+    shouldProceed: boolean;
+}
+/**
+ * Processes user input potentially containing one or more '@<path>' commands.
+ * If found, it attempts to read the specified files/directories using the
+ * 'read_many_files' tool. The user query is modified to include resolved paths,
+ * and the content of the files is appended in a structured block.
+ *
+ * @returns An object indicating whether the main hook should proceed with an
+ *          LLM call and the processed query parts (including file content).
+ */
+export declare function handleAtCommand({ query, config, addItem, onDebugMessage, messageId: userMessageTimestamp, signal, }: HandleAtCommandParams): Promise<HandleAtCommandResult>;
+export {};

package/dist/src/ui/hooks/atCommandProcessor.js

@@ -0,0 +1,312 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { getErrorMessage, isNodeError, unescapePath, } from '@google/gemini-cli-core';
+import { ToolCallStatus, } from '../types.js';
+/**
+ * Parses a query string to find all '@<path>' commands and text segments.
+ * Handles \ escaped spaces within paths.
+ */
+function parseAllAtCommands(query) {
+    const parts = [];
+    let currentIndex = 0;
+    while (currentIndex < query.length) {
+        let atIndex = -1;
+        let nextSearchIndex = currentIndex;
+        // Find next unescaped '@'
+        while (nextSearchIndex < query.length) {
+            if (query[nextSearchIndex] === '@' &&
+                (nextSearchIndex === 0 || query[nextSearchIndex - 1] !== '\\')) {
+                atIndex = nextSearchIndex;
+                break;
+            }
+            nextSearchIndex++;
+        }
+        if (atIndex === -1) {
+            // No more @
+            if (currentIndex < query.length) {
+                parts.push({ type: 'text', content: query.substring(currentIndex) });
+            }
+            break;
+        }
+        // Add text before @
+        if (atIndex > currentIndex) {
+            parts.push({
+                type: 'text',
+                content: query.substring(currentIndex, atIndex),
+            });
+        }
+        // Parse @path
+        let pathEndIndex = atIndex + 1;
+        let inEscape = false;
+        while (pathEndIndex < query.length) {
+            const char = query[pathEndIndex];
+            if (inEscape) {
+                inEscape = false;
+            }
+            else if (char === '\\') {
+                inEscape = true;
+            }
+            else if (/\s/.test(char)) {
+                // Path ends at first whitespace not escaped
+                break;
+            }
+            pathEndIndex++;
+        }
+        const rawAtPath = query.substring(atIndex, pathEndIndex);
+        // unescapePath expects the @ symbol to be present, and will handle it.
+        const atPath = unescapePath(rawAtPath);
+        parts.push({ type: 'atPath', content: atPath });
+        currentIndex = pathEndIndex;
+    }
+    // Filter out empty text parts that might result from consecutive @paths or leading/trailing spaces
+    return parts.filter((part) => !(part.type === 'text' && part.content.trim() === ''));
+}
+/**
+ * Processes user input potentially containing one or more '@<path>' commands.
+ * If found, it attempts to read the specified files/directories using the
+ * 'read_many_files' tool. The user query is modified to include resolved paths,
+ * and the content of the files is appended in a structured block.
+ *
+ * @returns An object indicating whether the main hook should proceed with an
+ *          LLM call and the processed query parts (including file content).
+ */
+export async function handleAtCommand({ query, config, addItem, onDebugMessage, messageId: userMessageTimestamp, signal, }) {
+    const commandParts = parseAllAtCommands(query);
+    const atPathCommandParts = commandParts.filter((part) => part.type === 'atPath');
+    if (atPathCommandParts.length === 0) {
+        addItem({ type: 'user', text: query }, userMessageTimestamp);
+        return { processedQuery: [{ text: query }], shouldProceed: true };
+    }
+    addItem({ type: 'user', text: query }, userMessageTimestamp);
+    // Get centralized file discovery service
+    const fileDiscovery = config.getFileService();
+    const respectGitIgnore = config.getFileFilteringRespectGitIgnore();
+    const pathSpecsToRead = [];
+    const atPathToResolvedSpecMap = new Map();
+    const contentLabelsForDisplay = [];
+    const ignoredPaths = [];
+    const toolRegistry = await config.getToolRegistry();
+    const readManyFilesTool = toolRegistry.getTool('read_many_files');
+    const globTool = toolRegistry.getTool('glob');
+    if (!readManyFilesTool) {
+        addItem({ type: 'error', text: 'Error: read_many_files tool not found.' }, userMessageTimestamp);
+        return { processedQuery: null, shouldProceed: false };
+    }
+    for (const atPathPart of atPathCommandParts) {
+        const originalAtPath = atPathPart.content; // e.g., "@file.txt" or "@"
+        if (originalAtPath === '@') {
+            onDebugMessage('Lone @ detected, will be treated as text in the modified query.');
+            continue;
+        }
+        const pathName = originalAtPath.substring(1);
+        if (!pathName) {
+            // This case should ideally not be hit if parseAllAtCommands ensures content after @
+            // but as a safeguard:
+            addItem({
+                type: 'error',
+                text: `Error: Invalid @ command '${originalAtPath}'. No path specified.`,
+            }, userMessageTimestamp);
+            // Decide if this is a fatal error for the whole command or just skip this @ part
+            // For now, let's be strict and fail the command if one @path is malformed.
+            return { processedQuery: null, shouldProceed: false };
+        }
+        // Check if path should be ignored by git
+        if (fileDiscovery.shouldGitIgnoreFile(pathName)) {
+            const reason = respectGitIgnore
+                ? 'git-ignored and will be skipped'
+                : 'ignored by custom patterns';
+            onDebugMessage(`Path ${pathName} is ${reason}.`);
+            ignoredPaths.push(pathName);
+            continue;
+        }
+        let currentPathSpec = pathName;
+        let resolvedSuccessfully = false;
+        try {
+            const absolutePath = path.resolve(config.getTargetDir(), pathName);
+            const stats = await fs.stat(absolutePath);
+            if (stats.isDirectory()) {
+                currentPathSpec = pathName.endsWith('/')
+                    ? `${pathName}**`
+                    : `${pathName}/**`;
+                onDebugMessage(`Path ${pathName} resolved to directory, using glob: ${currentPathSpec}`);
+            }
+            else {
+                onDebugMessage(`Path ${pathName} resolved to file: ${currentPathSpec}`);
+            }
+            resolvedSuccessfully = true;
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === 'ENOENT') {
+                if (config.getEnableRecursiveFileSearch() && globTool) {
+                    onDebugMessage(`Path ${pathName} not found directly, attempting glob search.`);
+                    try {
+                        const globResult = await globTool.execute({ pattern: `**/*${pathName}*`, path: config.getTargetDir() }, signal);
+                        if (globResult.llmContent &&
+                            typeof globResult.llmContent === 'string' &&
+                            !globResult.llmContent.startsWith('No files found') &&
+                            !globResult.llmContent.startsWith('Error:')) {
+                            const lines = globResult.llmContent.split('\n');
+                            if (lines.length > 1 && lines[1]) {
+                                const firstMatchAbsolute = lines[1].trim();
+                                currentPathSpec = path.relative(config.getTargetDir(), firstMatchAbsolute);
+                                onDebugMessage(`Glob search for ${pathName} found ${firstMatchAbsolute}, using relative path: ${currentPathSpec}`);
+                                resolvedSuccessfully = true;
+                            }
+                            else {
+                                onDebugMessage(`Glob search for '**/*${pathName}*' did not return a usable path. Path ${pathName} will be skipped.`);
+                            }
+                        }
+                        else {
+                            onDebugMessage(`Glob search for '**/*${pathName}*' found no files or an error. Path ${pathName} will be skipped.`);
+                        }
+                    }
+                    catch (globError) {
+                        console.error(`Error during glob search for ${pathName}: ${getErrorMessage(globError)}`);
+                        onDebugMessage(`Error during glob search for ${pathName}. Path ${pathName} will be skipped.`);
+                    }
+                }
+                else {
+                    onDebugMessage(`Glob tool not found. Path ${pathName} will be skipped.`);
+                }
+            }
+            else {
+                console.error(`Error stating path ${pathName}: ${getErrorMessage(error)}`);
+                onDebugMessage(`Error stating path ${pathName}. Path ${pathName} will be skipped.`);
+            }
+        }
+        if (resolvedSuccessfully) {
+            pathSpecsToRead.push(currentPathSpec);
+            atPathToResolvedSpecMap.set(originalAtPath, currentPathSpec);
+            contentLabelsForDisplay.push(pathName);
+        }
+    }
+    // Construct the initial part of the query for the LLM
+    let initialQueryText = '';
+    for (let i = 0; i < commandParts.length; i++) {
+        const part = commandParts[i];
+        if (part.type === 'text') {
+            initialQueryText += part.content;
+        }
+        else {
+            // type === 'atPath'
+            const resolvedSpec = atPathToResolvedSpecMap.get(part.content);
+            if (i > 0 &&
+                initialQueryText.length > 0 &&
+                !initialQueryText.endsWith(' ') &&
+                resolvedSpec) {
+                // Add space if previous part was text and didn't end with space, or if previous was @path
+                const prevPart = commandParts[i - 1];
+                if (prevPart.type === 'text' ||
+                    (prevPart.type === 'atPath' &&
+                        atPathToResolvedSpecMap.has(prevPart.content))) {
+                    initialQueryText += ' ';
+                }
+            }
+            if (resolvedSpec) {
+                initialQueryText += `@${resolvedSpec}`;
+            }
+            else {
+                // If not resolved for reading (e.g. lone @ or invalid path that was skipped),
+                // add the original @-string back, ensuring spacing if it's not the first element.
+                if (i > 0 &&
+                    initialQueryText.length > 0 &&
+                    !initialQueryText.endsWith(' ') &&
+                    !part.content.startsWith(' ')) {
+                    initialQueryText += ' ';
+                }
+                initialQueryText += part.content;
+            }
+        }
+    }
+    initialQueryText = initialQueryText.trim();
+    // Inform user about ignored paths
+    if (ignoredPaths.length > 0) {
+        const ignoreType = respectGitIgnore ? 'git-ignored' : 'custom-ignored';
+        onDebugMessage(`Ignored ${ignoredPaths.length} ${ignoreType} files: ${ignoredPaths.join(', ')}`);
+    }
+    // Fallback for lone "@" or completely invalid @-commands resulting in empty initialQueryText
+    if (pathSpecsToRead.length === 0) {
+        onDebugMessage('No valid file paths found in @ commands to read.');
+        if (initialQueryText === '@' && query.trim() === '@') {
+            // If the only thing was a lone @, pass original query (which might have spaces)
+            return { processedQuery: [{ text: query }], shouldProceed: true };
+        }
+        else if (!initialQueryText && query) {
+            // If all @-commands were invalid and no surrounding text, pass original query
+            return { processedQuery: [{ text: query }], shouldProceed: true };
+        }
+        // Otherwise, proceed with the (potentially modified) query text that doesn't involve file reading
+        return {
+            processedQuery: [{ text: initialQueryText || query }],
+            shouldProceed: true,
+        };
+    }
+    const processedQueryParts = [{ text: initialQueryText }];
+    const toolArgs = {
+        paths: pathSpecsToRead,
+        respectGitIgnore, // Use configuration setting
+    };
+    let toolCallDisplay;
+    try {
+        const result = await readManyFilesTool.execute(toolArgs, signal);
+        toolCallDisplay = {
+            callId: `client-read-${userMessageTimestamp}`,
+            name: readManyFilesTool.displayName,
+            description: readManyFilesTool.getDescription(toolArgs),
+            status: ToolCallStatus.Success,
+            resultDisplay: result.returnDisplay ||
+                `Successfully read: ${contentLabelsForDisplay.join(', ')}`,
+            confirmationDetails: undefined,
+        };
+        if (Array.isArray(result.llmContent)) {
+            const fileContentRegex = /^--- (.*?) ---\n\n([\s\S]*?)\n\n$/;
+            processedQueryParts.push({
+                text: '\n--- Content from referenced files ---',
+            });
+            for (const part of result.llmContent) {
+                if (typeof part === 'string') {
+                    const match = fileContentRegex.exec(part);
+                    if (match) {
+                        const filePathSpecInContent = match[1]; // This is a resolved pathSpec
+                        const fileActualContent = match[2].trim();
+                        processedQueryParts.push({
+                            text: `\nContent from @${filePathSpecInContent}:\n`,
+                        });
+                        processedQueryParts.push({ text: fileActualContent });
+                    }
+                    else {
+                        processedQueryParts.push({ text: part });
+                    }
+                }
+                else {
+                    // part is a Part object.
+                    processedQueryParts.push(part);
+                }
+            }
+            processedQueryParts.push({ text: '\n--- End of content ---' });
+        }
+        else {
+            onDebugMessage('read_many_files tool returned no content or empty content.');
+        }
+        addItem({ type: 'tool_group', tools: [toolCallDisplay] }, userMessageTimestamp);
+        return { processedQuery: processedQueryParts, shouldProceed: true };
+    }
+    catch (error) {
+        toolCallDisplay = {
+            callId: `client-read-${userMessageTimestamp}`,
+            name: readManyFilesTool.displayName,
+            description: readManyFilesTool.getDescription(toolArgs),
+            status: ToolCallStatus.Error,
+            resultDisplay: `Error reading files (${contentLabelsForDisplay.join(', ')}): ${getErrorMessage(error)}`,
+            confirmationDetails: undefined,
+        };
+        addItem({ type: 'tool_group', tools: [toolCallDisplay] }, userMessageTimestamp);
+        return { processedQuery: null, shouldProceed: false };
+    }
+}
+//# sourceMappingURL=atCommandProcessor.js.map

package/dist/src/ui/hooks/atCommandProcessor.js.map

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

package/dist/src/ui/hooks/shellCommandProcessor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HistoryItemWithoutId } from '../types.js';
+import { Config, GeminiClient } from '@google/gemini-cli-core';
+import { type PartListUnion } from '@google/genai';
+import { UseHistoryManagerReturn } from './useHistoryManager.js';
+/**
+ * Hook to process shell commands.
+ * Orchestrates command execution and updates history and agent context.
+ */
+export declare const useShellCommandProcessor: (addItemToHistory: UseHistoryManagerReturn["addItem"], setPendingHistoryItem: React.Dispatch<React.SetStateAction<HistoryItemWithoutId | null>>, onExec: (command: Promise<void>) => void, onDebugMessage: (message: string) => void, config: Config, geminiClient: GeminiClient) => {
+    handleShellCommand: (rawQuery: PartListUnion, abortSignal: AbortSignal) => boolean;
+};

package/dist/src/ui/hooks/shellCommandProcessor.js

@@ -0,0 +1,261 @@
+/**
+ * @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