@machina.ai/cell-cli-core 1.36.0-rc1 → 1.38.1-rc2

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

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult } from './tools.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { AgentLoopContext } from '../config/agent-loop-context.js';
+declare class ListBackgroundProcessesInvocation extends BaseToolInvocation<Record<string, never>, ToolResult> {
+    private readonly context;
+    constructor(context: AgentLoopContext, params: Record<string, never>, messageBus: MessageBus, toolName?: string, toolDisplayName?: string);
+    getDescription(): string;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}
+export declare class ListBackgroundProcessesTool extends BaseDeclarativeTool<Record<string, never>, ToolResult> {
+    private readonly context;
+    static readonly Name = "list_background_processes";
+    constructor(context: AgentLoopContext, messageBus: MessageBus);
+    protected createInvocation(params: Record<string, never>, messageBus: MessageBus): ListBackgroundProcessesInvocation;
+}
+interface ReadBackgroundOutputParams {
+    pid: number;
+    lines?: number;
+    delay_ms?: number;
+}
+declare class ReadBackgroundOutputInvocation extends BaseToolInvocation<ReadBackgroundOutputParams, ToolResult> {
+    private readonly context;
+    constructor(context: AgentLoopContext, params: ReadBackgroundOutputParams, messageBus: MessageBus, toolName?: string, toolDisplayName?: string);
+    getDescription(): string;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}
+export declare class ReadBackgroundOutputTool extends BaseDeclarativeTool<ReadBackgroundOutputParams, ToolResult> {
+    private readonly context;
+    static readonly Name = "read_background_output";
+    constructor(context: AgentLoopContext, messageBus: MessageBus);
+    protected createInvocation(params: ReadBackgroundOutputParams, messageBus: MessageBus): ReadBackgroundOutputInvocation;
+}
+export {};

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

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

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

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
+import { ShellExecutionService } from '../services/shellExecutionService.js';
+import { ListBackgroundProcessesTool, ReadBackgroundOutputTool, } from './shellBackgroundTools.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+import { NoopSandboxManager } from '../services/sandboxManager.js';
+import os from 'node:os';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// Integration test simulating model interaction cycle
+describe('Background Tools Integration', () => {
+    const bus = createMockMessageBus();
+    let listTool;
+    let readTool;
+    let tempRootDir;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        const mockContext = {
+            config: { getSessionId: () => 'default' },
+        };
+        listTool = new ListBackgroundProcessesTool(mockContext, bus);
+        readTool = new ReadBackgroundOutputTool(mockContext, bus);
+        tempRootDir = fs.mkdtempSync(path.join(os.tmpdir(), 'shell-bg-test-'));
+        // Clear history to avoid state leakage from previous runs
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ShellExecutionService.backgroundProcessHistory.clear();
+    });
+    afterEach(() => {
+        if (tempRootDir && fs.existsSync(tempRootDir)) {
+            fs.rmSync(tempRootDir, { recursive: true, force: true });
+        }
+    });
+    it('should support interaction cycle: start background -> list -> read logs', async () => {
+        const controller = new AbortController();
+        // 1. Start a backgroundable process
+        // We use node to print continuous logs until killed
+        const scriptPath = path.join(tempRootDir, 'log.js');
+        fs.writeFileSync(scriptPath, "setInterval(() => console.log('Log line'), 100);");
+        // Using 'node' directly avoids cross-platform shell quoting issues with absolute paths.
+        const commandString = `node "${scriptPath}"`;
+        const realHandle = await ShellExecutionService.execute(commandString, process.cwd(), () => { }, controller.signal, true, {
+            originalCommand: 'node continuous_log',
+            sessionId: 'default',
+            sanitizationConfig: {
+                allowedEnvironmentVariables: [],
+                blockedEnvironmentVariables: [],
+                enableEnvironmentVariableRedaction: false,
+            },
+            sandboxManager: new NoopSandboxManager(),
+        });
+        const pid = realHandle.pid;
+        if (pid === undefined) {
+            throw new Error('pid is undefined');
+        }
+        expect(pid).toBeGreaterThan(0);
+        // 2. Simulate model triggering background operations
+        ShellExecutionService.background(pid, 'default', 'node continuous_log');
+        // 3. Model decides to inspect list
+        const listInvocation = listTool.build({});
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        listInvocation.context = {
+            config: { getSessionId: () => 'default' },
+        };
+        const listResult = await listInvocation.execute(new AbortController().signal);
+        expect(listResult.llmContent).toContain(`[PID ${pid}] RUNNING: \`node continuous_log\``);
+        // 4. Give it time to write output to interval
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // 5. Model decides to read logs
+        const readInvocation = readTool.build({ pid, lines: 2 });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        readInvocation.context = {
+            config: { getSessionId: () => 'default' },
+        };
+        const readResult = await readInvocation.execute(new AbortController().signal);
+        expect(readResult.llmContent).toContain('Showing last');
+        expect(readResult.llmContent).toContain('Log line');
+        // Cleanup
+        await ShellExecutionService.kill(pid);
+        controller.abort();
+    });
+});
+//# sourceMappingURL=shellBackgroundTools.integration.test.js.map

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

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

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 {};