@google/gemini-cli-core 0.37.0-preview.2 → 0.38.0-preview.0

package/dist/src/tools/shellBackgroundTools.js

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs';
+import { ShellExecutionService } from '../services/shellExecutionService.js';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from './tools.js';
+import { ToolErrorType } from './tool-error.js';
+import { isNodeError } from '../utils/errors.js';
+const MAX_BUFFER_LOAD_CAP_BYTES = 64 * 1024; // Safe 64KB buffer load Cap
+const DEFAULT_TAIL_LINES_COUNT = 100;
+// --- list_background_processes ---
+class ListBackgroundProcessesInvocation extends BaseToolInvocation {
+    context;
+    constructor(context, params, messageBus, toolName, toolDisplayName) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.context = context;
+    }
+    getDescription() {
+        return 'Lists all active and recently completed background processes for the current session.';
+    }
+    async execute(_signal) {
+        const processes = ShellExecutionService.listBackgroundProcesses(this.context.config.getSessionId());
+        if (processes.length === 0) {
+            return {
+                llmContent: 'No background processes found.',
+                returnDisplay: 'No background processes found.',
+            };
+        }
+        const lines = processes.map((p) => `- [PID ${p.pid}] ${p.status.toUpperCase()}: \`${p.command}\`${p.exitCode !== undefined ? ` (Exit Code: ${p.exitCode})` : ''}${p.signal ? ` (Signal: ${p.signal})` : ''}`);
+        const content = lines.join('\n');
+        return {
+            llmContent: content,
+            returnDisplay: content,
+        };
+    }
+}
+export class ListBackgroundProcessesTool extends BaseDeclarativeTool {
+    context;
+    static Name = 'list_background_processes';
+    constructor(context, messageBus) {
+        super(ListBackgroundProcessesTool.Name, 'List Background Processes', 'Lists all active and recently completed background shell processes orchestrating by the agent.', Kind.Read, {
+            type: 'object',
+            properties: {},
+        }, messageBus);
+        this.context = context;
+    }
+    createInvocation(params, messageBus) {
+        return new ListBackgroundProcessesInvocation(this.context, params, messageBus, this.name);
+    }
+}
+class ReadBackgroundOutputInvocation extends BaseToolInvocation {
+    context;
+    constructor(context, params, messageBus, toolName, toolDisplayName) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.context = context;
+    }
+    getDescription() {
+        return `Reading output for background process ${this.params.pid}`;
+    }
+    async execute(_signal) {
+        const pid = this.params.pid;
+        if (this.params.delay_ms && this.params.delay_ms > 0) {
+            await new Promise((resolve) => setTimeout(resolve, this.params.delay_ms));
+        }
+        // Verify process belongs to this session to prevent reading logs of processes from other sessions/users
+        const processes = ShellExecutionService.listBackgroundProcesses(this.context.config.getSessionId());
+        if (!processes.some((p) => p.pid === pid)) {
+            return {
+                llmContent: `Access denied. Background process ID ${pid} not found in this session's history.`,
+                returnDisplay: 'Access denied.',
+                error: {
+                    message: `Background process history lookup failed for PID ${pid}`,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        try {
+            await fs.promises.access(logPath);
+        }
+        catch {
+            return {
+                llmContent: `No output log found for process ID ${pid}. It might not have produced output or was cleaned up.`,
+                returnDisplay: `No log found for PID ${pid}`,
+                error: {
+                    message: `Log file not found at ${logPath}`,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+        try {
+            const fileHandle = await fs.promises.open(logPath, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
+            let content = '';
+            let position = 0;
+            try {
+                const stats = await fileHandle.stat();
+                const readSize = Math.min(stats.size, MAX_BUFFER_LOAD_CAP_BYTES);
+                position = Math.max(0, stats.size - readSize);
+                const buffer = Buffer.alloc(readSize);
+                await fileHandle.read(buffer, 0, readSize, position);
+                content = buffer.toString('utf-8');
+            }
+            finally {
+                await fileHandle.close();
+            }
+            if (!content) {
+                return {
+                    llmContent: 'Log is empty.',
+                    returnDisplay: 'Log is empty.',
+                };
+            }
+            const logLines = content.split('\n');
+            if (logLines.length > 0 && logLines[logLines.length - 1] === '') {
+                logLines.pop();
+            }
+            // Discard first line if we started reading from middle of file to avoid partial lines
+            if (position > 0 && logLines.length > 0) {
+                logLines.shift();
+            }
+            const requestedLinesCount = this.params.lines ?? DEFAULT_TAIL_LINES_COUNT;
+            const tailLines = logLines.slice(-requestedLinesCount);
+            const output = tailLines.join('\n');
+            const header = requestedLinesCount < logLines.length
+                ? `Showing last ${requestedLinesCount} of ${logLines.length} lines:\n`
+                : 'Full Log Output:\n';
+            const responseContent = header + output;
+            return {
+                llmContent: responseContent,
+                returnDisplay: responseContent,
+            };
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === 'ELOOP') {
+                return {
+                    llmContent: 'Symbolic link detected at predicted log path. Access is denied for security reasons.',
+                    returnDisplay: `Symlink detected for PID ${pid}`,
+                    error: {
+                        message: 'Symbolic link detected at predicted log path. Access is denied for security reasons.',
+                        type: ToolErrorType.EXECUTION_FAILED,
+                    },
+                };
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error reading background log: ${errorMessage}`,
+                returnDisplay: 'Failed to read log.',
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+export class ReadBackgroundOutputTool extends BaseDeclarativeTool {
+    context;
+    static Name = 'read_background_output';
+    constructor(context, messageBus) {
+        super(ReadBackgroundOutputTool.Name, 'Read Background Output', 'Reads the output log of a background shell process. Support reading tail snapshot.', Kind.Read, {
+            type: 'object',
+            properties: {
+                pid: {
+                    type: 'integer',
+                    description: 'The process ID (PID) of the background process to inspect.',
+                },
+                lines: {
+                    type: 'integer',
+                    minimum: 1,
+                    description: 'Optional. Number of lines to read from the end of the log. Defaults to 100.',
+                },
+                delay_ms: {
+                    type: 'integer',
+                    description: 'Optional. Delay in milliseconds to wait before reading the output. Useful to allow the process to start and generate initial output.',
+                },
+            },
+            required: ['pid'],
+        }, messageBus);
+        this.context = context;
+    }
+    createInvocation(params, messageBus) {
+        return new ReadBackgroundOutputInvocation(this.context, params, messageBus, this.name);
+    }
+}
+//# sourceMappingURL=shellBackgroundTools.js.map

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

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

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

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

package/dist/src/tools/shellBackgroundTools.test.js

@@ -0,0 +1,230 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { ShellExecutionService } from '../services/shellExecutionService.js';
+import { ListBackgroundProcessesTool, ReadBackgroundOutputTool, } from './shellBackgroundTools.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+import fs from 'node:fs';
+describe('Background Tools', () => {
+    let listTool;
+    let readTool;
+    const bus = createMockMessageBus();
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        const mockContext = {
+            config: { getSessionId: () => 'default' },
+        };
+        listTool = new ListBackgroundProcessesTool(mockContext, bus);
+        readTool = new ReadBackgroundOutputTool(mockContext, bus);
+        // Clear history to avoid state leakage from previous runs
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.clear();
+    });
+    it('list_background_processes should return empty message when no processes', async () => {
+        const invocation = listTool.build({});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toBe('No background processes found.');
+    });
+    it('list_background_processes should list processes after they are backgrounded', async () => {
+        const pid = 99999 + Math.floor(Math.random() * 1000);
+        // Simulate adding to history
+        // Since background method relies on activePtys/activeChildProcesses,
+        // we should probably mock those or just call the history add logic if we can't easily trigger background.
+        // Wait, ShellExecutionService.background() reads from activePtys/activeChildProcesses!
+        // So we MUST populate them or mock them!
+        // Let's use vi.spyOn or populate the map if accessible?
+        // activePtys is private static.
+        // Mock active process map to provide sessionId
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.activeChildProcesses.set(pid, {
+            process: {},
+            state: { output: '' },
+            command: 'unknown command',
+            sessionId: 'default',
+        });
+        ShellExecutionService.background(pid, 'default', 'unknown command');
+        const invocation = listTool.build({});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain(`[PID ${pid}] RUNNING: \`unknown command\``);
+    });
+    it('list_background_processes should show exited status with code or signal', async () => {
+        const pid = 98989;
+        const history = new Map();
+        history.set(pid, {
+            command: 'exited command',
+            status: 'exited',
+            exitCode: 1,
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        const invocation = listTool.build({});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain(`- [PID ${pid}] EXITED: \`exited command\` (Exit Code: 1)`);
+    });
+    it('read_background_output should return error if log file does not exist', async () => {
+        const pid = 12345 + Math.floor(Math.random() * 1000);
+        const history = new Map();
+        history.set(pid, {
+            command: 'unknown command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        const invocation = readTool.build({ pid });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.error).toBeDefined();
+        expect(result.llmContent).toContain('No output log found');
+    });
+    it('read_background_output should read content from log file', async () => {
+        const pid = 88888 + Math.floor(Math.random() * 1000);
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        const logDir = ShellExecutionService.getLogDir();
+        // Ensure dir exists
+        // Add to history to pass access check
+        const history = new Map();
+        history.set(pid, {
+            command: 'unknown command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        // Ensure dir exists
+        fs.mkdirSync(logDir, { recursive: true });
+        // Write mock log
+        fs.writeFileSync(logPath, 'line 1\nline 2\nline 3\n');
+        const invocation = readTool.build({ pid, lines: 2 });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain('Showing last 2 of 3 lines');
+        expect(result.llmContent).toContain('line 2\nline 3');
+        // Cleanup
+        fs.unlinkSync(logPath);
+    });
+    it('read_background_output should return Access Denied for processes in other sessions', async () => {
+        const pid = 77777;
+        const history = new Map();
+        history.set(pid, {
+            command: 'other command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('other-session', history);
+        const invocation = readTool.build({ pid });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } }; // Asking for PID from another session
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.error).toBeDefined();
+        expect(result.llmContent).toContain('Access denied');
+    });
+    it('read_background_output should handle empty log files', async () => {
+        const pid = 66666;
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        const logDir = ShellExecutionService.getLogDir();
+        const history = new Map();
+        history.set(pid, {
+            command: 'empty output command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.writeFileSync(logPath, '');
+        const invocation = readTool.build({ pid });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain('Log is empty');
+        fs.unlinkSync(logPath);
+    });
+    it('read_background_output should handle direct tool errors gracefully', async () => {
+        const pid = 55555;
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        const logDir = ShellExecutionService.getLogDir();
+        const history = new Map();
+        history.set(pid, {
+            command: 'fail command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.writeFileSync(logPath, 'dummy content');
+        // Mock open to throw to hit catch block
+        vi.spyOn(fs.promises, 'open').mockRejectedValue(new Error('Simulated read error'));
+        const invocation = readTool.build({ pid });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.error).toBeDefined();
+        expect(result.llmContent).toContain('Error reading background log');
+        fs.unlinkSync(logPath);
+    });
+    it('read_background_output should deny access if log is a symbolic link', async () => {
+        const pid = 66666;
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        const logDir = ShellExecutionService.getLogDir();
+        const history = new Map();
+        history.set(pid, {
+            command: 'symlink command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        fs.mkdirSync(logDir, { recursive: true });
+        fs.writeFileSync(logPath, 'dummy content');
+        // Mock open to throw ELOOP error for symbolic link
+        const mockError = new Error('ELOOP: too many symbolic links encountered');
+        Object.assign(mockError, { code: 'ELOOP' });
+        vi.spyOn(fs.promises, 'open').mockRejectedValue(mockError);
+        const invocation = readTool.build({ pid });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain('Access is denied');
+        expect(result.error?.message).toContain('Symbolic link detected');
+        fs.unlinkSync(logPath);
+    });
+    it('read_background_output should tail reading trailing logic correctly', async () => {
+        const pid = 77777;
+        const logPath = ShellExecutionService.getLogFilePath(pid);
+        const logDir = ShellExecutionService.getLogDir();
+        const history = new Map();
+        history.set(pid, {
+            command: 'tail command',
+            status: 'running',
+            startTime: Date.now(),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.set('default', history);
+        fs.mkdirSync(logDir, { recursive: true });
+        // Write 5 lines
+        fs.writeFileSync(logPath, 'line1\nline2\nline3\nline4\nline5');
+        const invocation = readTool.build({ pid, lines: 2 });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        invocation.context = { config: { getSessionId: () => 'default' } };
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result.llmContent).toContain('line4\nline5');
+        expect(result.llmContent).not.toContain('line1');
+        fs.unlinkSync(logPath);
+    });
+});
+//# sourceMappingURL=shellBackgroundTools.test.js.map

package/dist/src/tools/shellBackgroundTools.test.js.map

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

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

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

package/dist/src/tools/shell_proactive.test.js

@@ -0,0 +1,122 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, beforeAll, afterEach, } from 'vitest';
+import os from 'node:os';
+import { ShellTool } from './shell.js';
+import {} from '../config/config.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+import * as proactivePermissions from '../sandbox/utils/proactivePermissions.js';
+import { initializeShellParsers } from '../utils/shell-utils.js';
+vi.mock('node:fs', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        default: {
+            ...original,
+            realpathSync: vi.fn((p) => p),
+        },
+        realpathSync: vi.fn((p) => p),
+    };
+});
+vi.mock('../sandbox/utils/proactivePermissions.js', () => ({
+    getProactiveToolSuggestions: vi.fn(),
+    isNetworkReliantCommand: vi.fn(),
+}));
+const mockPlatform = (platform) => {
+    vi.stubGlobal('process', Object.create(process, {
+        platform: {
+            get: () => platform,
+        },
+    }));
+    vi.spyOn(os, 'platform').mockReturnValue(platform);
+};
+describe('ShellTool Proactive Expansion', () => {
+    let mockConfig;
+    let shellTool;
+    beforeAll(async () => {
+        await initializeShellParsers();
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.restoreAllMocks();
+    });
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockPlatform('darwin');
+        mockConfig = {
+            get config() {
+                return this;
+            },
+            getSandboxEnabled: vi.fn().mockReturnValue(false),
+            getTargetDir: vi.fn().mockReturnValue('/tmp'),
+            getApprovalMode: vi.fn().mockReturnValue('strict'),
+            sandboxPolicyManager: {
+                getCommandPermissions: vi.fn().mockReturnValue({
+                    fileSystem: { read: [], write: [] },
+                    network: false,
+                }),
+                getModeConfig: vi.fn().mockReturnValue({ readonly: false }),
+            },
+            getEnableInteractiveShell: vi.fn().mockReturnValue(false),
+            getEnableShellOutputEfficiency: vi.fn().mockReturnValue(true),
+            getShellToolInactivityTimeout: vi.fn().mockReturnValue(1000),
+        };
+        const bus = createMockMessageBus();
+        shellTool = new ShellTool(mockConfig, bus);
+    });
+    it('should NOT call getProactiveToolSuggestions when sandboxing is disabled', async () => {
+        const invocation = shellTool.build({ command: 'npm install' });
+        const abortSignal = new AbortController().signal;
+        await invocation.shouldConfirmExecute(abortSignal);
+        expect(proactivePermissions.getProactiveToolSuggestions).not.toHaveBeenCalled();
+    });
+    it('should call getProactiveToolSuggestions when sandboxing is enabled', async () => {
+        vi.mocked(mockConfig.getSandboxEnabled).mockReturnValue(true);
+        vi.mocked(proactivePermissions.getProactiveToolSuggestions).mockResolvedValue({
+            network: true,
+        });
+        vi.mocked(proactivePermissions.isNetworkReliantCommand).mockReturnValue(true);
+        const invocation = shellTool.build({ command: 'npm install' });
+        const abortSignal = new AbortController().signal;
+        await invocation.shouldConfirmExecute(abortSignal);
+        expect(proactivePermissions.getProactiveToolSuggestions).toHaveBeenCalledWith('npm');
+    });
+    it('should normalize command names (lowercase and strip .exe) when sandboxing is enabled', async () => {
+        vi.mocked(mockConfig.getSandboxEnabled).mockReturnValue(true);
+        vi.mocked(proactivePermissions.getProactiveToolSuggestions).mockResolvedValue({
+            network: true,
+        });
+        vi.mocked(proactivePermissions.isNetworkReliantCommand).mockReturnValue(true);
+        const invocation = shellTool.build({ command: 'NPM.EXE install' });
+        const abortSignal = new AbortController().signal;
+        await invocation.shouldConfirmExecute(abortSignal);
+        expect(proactivePermissions.getProactiveToolSuggestions).toHaveBeenCalledWith('npm');
+    });
+    it('should NOT request expansion if paths are already approved (case-insensitive subpath)', async () => {
+        // This test assumes Darwin or Windows for case-insensitivity
+        vi.mocked(mockConfig.getSandboxEnabled).mockReturnValue(true);
+        vi.mocked(proactivePermissions.getProactiveToolSuggestions).mockResolvedValue({
+            fileSystem: { read: ['/project/src'], write: [] },
+        });
+        vi.mocked(proactivePermissions.isNetworkReliantCommand).mockReturnValue(true);
+        // Current approval is for the parent dir, with different casing
+        vi.mocked(mockConfig.sandboxPolicyManager.getCommandPermissions).mockReturnValue({
+            fileSystem: { read: ['/PROJECT'], write: [] },
+            network: false,
+        });
+        const invocation = shellTool.build({ command: 'npm install' });
+        const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+        // If it's correctly approved, result should be false (no expansion needed)
+        // or a normal 'exec' confirmation, but NOT 'sandbox_expansion'.
+        if (result) {
+            expect(result.type).not.toBe('sandbox_expansion');
+        }
+        else {
+            expect(result).toBe(false);
+        }
+    });
+});
+//# sourceMappingURL=shell_proactive.test.js.map

package/dist/src/tools/shell_proactive.test.js.map

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

package/dist/src/tools/tool-names.d.ts

@@ -3,8 +3,8 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, PARAM_FILE_PATH, PARAM_DIR_PATH, PARAM_PATTERN, PARAM_CASE_SENSITIVE, PARAM_RESPECT_GIT_IGNORE, PARAM_RESPECT_GEMINI_IGNORE, PARAM_FILE_FILTERING_OPTIONS, PARAM_DESCRIPTION, READ_FILE_PARAM_START_LINE, READ_FILE_PARAM_END_LINE, WRITE_FILE_PARAM_CONTENT, GREP_PARAM_INCLUDE_PATTERN, GREP_PARAM_EXCLUDE_PATTERN, GREP_PARAM_NAMES_ONLY, GREP_PARAM_MAX_MATCHES_PER_FILE, GREP_PARAM_TOTAL_MAX_MATCHES, GREP_PARAM_FIXED_STRINGS, GREP_PARAM_CONTEXT, GREP_PARAM_AFTER, GREP_PARAM_BEFORE, GREP_PARAM_NO_IGNORE, EDIT_PARAM_INSTRUCTION, EDIT_PARAM_OLD_STRING, EDIT_PARAM_NEW_STRING, EDIT_PARAM_ALLOW_MULTIPLE, LS_PARAM_IGNORE, SHELL_PARAM_COMMAND, SHELL_PARAM_IS_BACKGROUND, WEB_SEARCH_PARAM_QUERY, WEB_FETCH_PARAM_PROMPT, READ_MANY_PARAM_INCLUDE, READ_MANY_PARAM_EXCLUDE, READ_MANY_PARAM_RECURSIVE, READ_MANY_PARAM_USE_DEFAULT_EXCLUDES, MEMORY_PARAM_FACT, TODOS_PARAM_TODOS, TODOS_ITEM_PARAM_DESCRIPTION, TODOS_ITEM_PARAM_STATUS, DOCS_PARAM_PATH, ASK_USER_PARAM_QUESTIONS, ASK_USER_QUESTION_PARAM_QUESTION, ASK_USER_QUESTION_PARAM_HEADER, ASK_USER_QUESTION_PARAM_TYPE, ASK_USER_QUESTION_PARAM_OPTIONS, ASK_USER_QUESTION_PARAM_MULTI_SELECT, ASK_USER_QUESTION_PARAM_PLACEHOLDER, ASK_USER_OPTION_PARAM_LABEL, ASK_USER_OPTION_PARAM_DESCRIPTION, PLAN_MODE_PARAM_REASON, EXIT_PLAN_PARAM_PLAN_FILENAME, SKILL_PARAM_NAME, UPDATE_TOPIC_TOOL_NAME, UPDATE_TOPIC_DISPLAY_NAME, TOPIC_PARAM_TITLE, TOPIC_PARAM_SUMMARY, TOPIC_PARAM_STRATEGIC_INTENT } from './definitions/coreTools.js';
-export { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, UPDATE_TOPIC_TOOL_NAME, UPDATE_TOPIC_DISPLAY_NAME, PARAM_FILE_PATH, PARAM_DIR_PATH, PARAM_PATTERN, PARAM_CASE_SENSITIVE, PARAM_RESPECT_GIT_IGNORE, PARAM_RESPECT_GEMINI_IGNORE, PARAM_FILE_FILTERING_OPTIONS, PARAM_DESCRIPTION, READ_FILE_PARAM_START_LINE, READ_FILE_PARAM_END_LINE, WRITE_FILE_PARAM_CONTENT, GREP_PARAM_INCLUDE_PATTERN, GREP_PARAM_EXCLUDE_PATTERN, GREP_PARAM_NAMES_ONLY, GREP_PARAM_MAX_MATCHES_PER_FILE, GREP_PARAM_TOTAL_MAX_MATCHES, GREP_PARAM_FIXED_STRINGS, GREP_PARAM_CONTEXT, GREP_PARAM_AFTER, GREP_PARAM_BEFORE, GREP_PARAM_NO_IGNORE, EDIT_PARAM_INSTRUCTION, EDIT_PARAM_OLD_STRING, EDIT_PARAM_NEW_STRING, EDIT_PARAM_ALLOW_MULTIPLE, LS_PARAM_IGNORE, SHELL_PARAM_COMMAND, SHELL_PARAM_IS_BACKGROUND, WEB_SEARCH_PARAM_QUERY, WEB_FETCH_PARAM_PROMPT, READ_MANY_PARAM_INCLUDE, READ_MANY_PARAM_EXCLUDE, READ_MANY_PARAM_RECURSIVE, READ_MANY_PARAM_USE_DEFAULT_EXCLUDES, MEMORY_PARAM_FACT, TODOS_PARAM_TODOS, TODOS_ITEM_PARAM_DESCRIPTION, TODOS_ITEM_PARAM_STATUS, DOCS_PARAM_PATH, ASK_USER_PARAM_QUESTIONS, ASK_USER_QUESTION_PARAM_QUESTION, ASK_USER_QUESTION_PARAM_HEADER, ASK_USER_QUESTION_PARAM_TYPE, ASK_USER_QUESTION_PARAM_OPTIONS, ASK_USER_QUESTION_PARAM_MULTI_SELECT, ASK_USER_QUESTION_PARAM_PLACEHOLDER, ASK_USER_OPTION_PARAM_LABEL, ASK_USER_OPTION_PARAM_DESCRIPTION, PLAN_MODE_PARAM_REASON, EXIT_PLAN_PARAM_PLAN_FILENAME, SKILL_PARAM_NAME, TOPIC_PARAM_TITLE, TOPIC_PARAM_SUMMARY, TOPIC_PARAM_STRATEGIC_INTENT, };
+import { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, PARAM_FILE_PATH, PARAM_DIR_PATH, PARAM_PATTERN, PARAM_CASE_SENSITIVE, PARAM_RESPECT_GIT_IGNORE, PARAM_RESPECT_GEMINI_IGNORE, PARAM_FILE_FILTERING_OPTIONS, PARAM_DESCRIPTION, READ_FILE_PARAM_START_LINE, READ_FILE_PARAM_END_LINE, WRITE_FILE_PARAM_CONTENT, GREP_PARAM_INCLUDE_PATTERN, GREP_PARAM_EXCLUDE_PATTERN, GREP_PARAM_NAMES_ONLY, GREP_PARAM_MAX_MATCHES_PER_FILE, GREP_PARAM_TOTAL_MAX_MATCHES, GREP_PARAM_FIXED_STRINGS, GREP_PARAM_CONTEXT, GREP_PARAM_AFTER, GREP_PARAM_BEFORE, GREP_PARAM_NO_IGNORE, EDIT_PARAM_INSTRUCTION, EDIT_PARAM_OLD_STRING, EDIT_PARAM_NEW_STRING, EDIT_PARAM_ALLOW_MULTIPLE, LS_PARAM_IGNORE, SHELL_PARAM_COMMAND, SHELL_PARAM_IS_BACKGROUND, WEB_SEARCH_PARAM_QUERY, WEB_FETCH_PARAM_PROMPT, READ_MANY_PARAM_INCLUDE, READ_MANY_PARAM_EXCLUDE, READ_MANY_PARAM_RECURSIVE, READ_MANY_PARAM_USE_DEFAULT_EXCLUDES, MEMORY_PARAM_FACT, TODOS_PARAM_TODOS, TODOS_ITEM_PARAM_DESCRIPTION, TODOS_ITEM_PARAM_STATUS, DOCS_PARAM_PATH, ASK_USER_PARAM_QUESTIONS, ASK_USER_QUESTION_PARAM_QUESTION, ASK_USER_QUESTION_PARAM_HEADER, ASK_USER_QUESTION_PARAM_TYPE, ASK_USER_QUESTION_PARAM_OPTIONS, ASK_USER_QUESTION_PARAM_MULTI_SELECT, ASK_USER_QUESTION_PARAM_PLACEHOLDER, ASK_USER_OPTION_PARAM_LABEL, ASK_USER_OPTION_PARAM_DESCRIPTION, PLAN_MODE_PARAM_REASON, EXIT_PLAN_PARAM_PLAN_FILENAME, SKILL_PARAM_NAME, UPDATE_TOPIC_TOOL_NAME, UPDATE_TOPIC_DISPLAY_NAME, COMPLETE_TASK_TOOL_NAME, COMPLETE_TASK_DISPLAY_NAME, TOPIC_PARAM_TITLE, TOPIC_PARAM_SUMMARY, TOPIC_PARAM_STRATEGIC_INTENT } from './definitions/coreTools.js';
+export { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, UPDATE_TOPIC_TOOL_NAME, UPDATE_TOPIC_DISPLAY_NAME, COMPLETE_TASK_TOOL_NAME, COMPLETE_TASK_DISPLAY_NAME, PARAM_FILE_PATH, PARAM_DIR_PATH, PARAM_PATTERN, PARAM_CASE_SENSITIVE, PARAM_RESPECT_GIT_IGNORE, PARAM_RESPECT_GEMINI_IGNORE, PARAM_FILE_FILTERING_OPTIONS, PARAM_DESCRIPTION, READ_FILE_PARAM_START_LINE, READ_FILE_PARAM_END_LINE, WRITE_FILE_PARAM_CONTENT, GREP_PARAM_INCLUDE_PATTERN, GREP_PARAM_EXCLUDE_PATTERN, GREP_PARAM_NAMES_ONLY, GREP_PARAM_MAX_MATCHES_PER_FILE, GREP_PARAM_TOTAL_MAX_MATCHES, GREP_PARAM_FIXED_STRINGS, GREP_PARAM_CONTEXT, GREP_PARAM_AFTER, GREP_PARAM_BEFORE, GREP_PARAM_NO_IGNORE, EDIT_PARAM_INSTRUCTION, EDIT_PARAM_OLD_STRING, EDIT_PARAM_NEW_STRING, EDIT_PARAM_ALLOW_MULTIPLE, LS_PARAM_IGNORE, SHELL_PARAM_COMMAND, SHELL_PARAM_IS_BACKGROUND, WEB_SEARCH_PARAM_QUERY, WEB_FETCH_PARAM_PROMPT, READ_MANY_PARAM_INCLUDE, READ_MANY_PARAM_EXCLUDE, READ_MANY_PARAM_RECURSIVE, READ_MANY_PARAM_USE_DEFAULT_EXCLUDES, MEMORY_PARAM_FACT, TODOS_PARAM_TODOS, TODOS_ITEM_PARAM_DESCRIPTION, TODOS_ITEM_PARAM_STATUS, DOCS_PARAM_PATH, ASK_USER_PARAM_QUESTIONS, ASK_USER_QUESTION_PARAM_QUESTION, ASK_USER_QUESTION_PARAM_HEADER, ASK_USER_QUESTION_PARAM_TYPE, ASK_USER_QUESTION_PARAM_OPTIONS, ASK_USER_QUESTION_PARAM_MULTI_SELECT, ASK_USER_QUESTION_PARAM_PLACEHOLDER, ASK_USER_OPTION_PARAM_LABEL, ASK_USER_OPTION_PARAM_DESCRIPTION, PLAN_MODE_PARAM_REASON, EXIT_PLAN_PARAM_PLAN_FILENAME, SKILL_PARAM_NAME, TOPIC_PARAM_TITLE, TOPIC_PARAM_SUMMARY, TOPIC_PARAM_STRATEGIC_INTENT, };
 export declare const EDIT_TOOL_NAMES: Set<string>;
 /**
  * Tools that require mandatory argument narrowing (e.g., file paths, command prefixes)
@@ -40,7 +40,7 @@ export declare const TOOL_LEGACY_ALIASES: Record<string, string>;
 export declare function getToolAliases(name: string): string[];
 /** Prefix used for tools discovered via the tool DiscoveryCommand. */
 export declare const DISCOVERED_TOOL_PREFIX = "discovered_tool_";
-export declare const ALL_BUILTIN_TOOL_NAMES: readonly ["glob", "write_todos", "write_file", "google_web_search", "web_fetch", "replace", "run_shell_command", "grep_search", "read_many_files", "read_file", "list_directory", "save_memory", "activate_skill", "ask_user", "tracker_create_task", "tracker_update_task", "tracker_get_task", "tracker_list_tasks", "tracker_add_dependency", "tracker_visualize", "get_internal_docs", "enter_plan_mode", "exit_plan_mode", "update_topic"];
+export declare const ALL_BUILTIN_TOOL_NAMES: readonly ["glob", "write_todos", "write_file", "google_web_search", "web_fetch", "replace", "run_shell_command", "grep_search", "read_many_files", "read_file", "list_directory", "save_memory", "activate_skill", "ask_user", "tracker_create_task", "tracker_update_task", "tracker_get_task", "tracker_list_tasks", "tracker_add_dependency", "tracker_visualize", "get_internal_docs", "enter_plan_mode", "exit_plan_mode", "update_topic", "complete_task"];
 /**
  * Read-only tools available in Plan Mode.
  * This list is used to dynamically generate the Plan Mode prompt,