@google/gemini-cli-core 0.30.0-preview.6 → 0.31.0-preview.0

package/dist/src/agents/browser/browserManager.test.d.ts

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

package/dist/src/agents/browser/browserManager.test.js

@@ -0,0 +1,314 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { BrowserManager } from './browserManager.js';
+import { makeFakeConfig } from '../../test-utils/config.js';
+// Mock the MCP SDK
+vi.mock('@modelcontextprotocol/sdk/client/index.js', () => ({
+    Client: vi.fn().mockImplementation(() => ({
+        connect: vi.fn().mockResolvedValue(undefined),
+        close: vi.fn().mockResolvedValue(undefined),
+        listTools: vi.fn().mockResolvedValue({
+            tools: [
+                { name: 'take_snapshot', description: 'Take a snapshot' },
+                { name: 'click', description: 'Click an element' },
+                { name: 'click_at', description: 'Click at coordinates' },
+                { name: 'take_screenshot', description: 'Take a screenshot' },
+            ],
+        }),
+        callTool: vi.fn().mockResolvedValue({
+            content: [{ type: 'text', text: 'Tool result' }],
+        }),
+    })),
+}));
+vi.mock('@modelcontextprotocol/sdk/client/stdio.js', () => ({
+    StdioClientTransport: vi.fn().mockImplementation(() => ({
+        close: vi.fn().mockResolvedValue(undefined),
+        stderr: null,
+    })),
+}));
+vi.mock('../../utils/debugLogger.js', () => ({
+    debugLogger: {
+        log: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+describe('BrowserManager', () => {
+    let mockConfig;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        // Setup mock config
+        mockConfig = makeFakeConfig({
+            agents: {
+                overrides: {
+                    browser_agent: {
+                        enabled: true,
+                    },
+                },
+                browser: {
+                    headless: false,
+                },
+            },
+        });
+        // Re-setup Client mock after reset
+        vi.mocked(Client).mockImplementation(() => ({
+            connect: vi.fn().mockResolvedValue(undefined),
+            close: vi.fn().mockResolvedValue(undefined),
+            listTools: vi.fn().mockResolvedValue({
+                tools: [
+                    { name: 'take_snapshot', description: 'Take a snapshot' },
+                    { name: 'click', description: 'Click an element' },
+                    { name: 'click_at', description: 'Click at coordinates' },
+                    { name: 'take_screenshot', description: 'Take a screenshot' },
+                ],
+            }),
+            callTool: vi.fn().mockResolvedValue({
+                content: [{ type: 'text', text: 'Tool result' }],
+            }),
+        }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('getRawMcpClient', () => {
+        it('should ensure connection and return raw MCP client', async () => {
+            const manager = new BrowserManager(mockConfig);
+            const client = await manager.getRawMcpClient();
+            expect(client).toBeDefined();
+            expect(Client).toHaveBeenCalled();
+        });
+        it('should return cached client if already connected', async () => {
+            const manager = new BrowserManager(mockConfig);
+            // First call
+            const client1 = await manager.getRawMcpClient();
+            // Second call should use cache
+            const client2 = await manager.getRawMcpClient();
+            expect(client1).toBe(client2);
+            // Client constructor should only be called once
+            expect(Client).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('getDiscoveredTools', () => {
+        it('should return tools discovered from MCP server including visual tools', async () => {
+            const manager = new BrowserManager(mockConfig);
+            const tools = await manager.getDiscoveredTools();
+            expect(tools).toHaveLength(4);
+            expect(tools.map((t) => t.name)).toContain('take_snapshot');
+            expect(tools.map((t) => t.name)).toContain('click');
+            expect(tools.map((t) => t.name)).toContain('click_at');
+            expect(tools.map((t) => t.name)).toContain('take_screenshot');
+        });
+    });
+    describe('callTool', () => {
+        it('should call tool on MCP client and return result', async () => {
+            const manager = new BrowserManager(mockConfig);
+            const result = await manager.callTool('take_snapshot', { verbose: true });
+            expect(result).toEqual({
+                content: [{ type: 'text', text: 'Tool result' }],
+                isError: false,
+            });
+        });
+    });
+    describe('MCP connection', () => {
+        it('should spawn npx chrome-devtools-mcp with --experimental-vision (persistent mode by default)', async () => {
+            const manager = new BrowserManager(mockConfig);
+            await manager.ensureConnection();
+            // Verify StdioClientTransport was created with correct args
+            expect(StdioClientTransport).toHaveBeenCalledWith(expect.objectContaining({
+                command: 'npx',
+                args: expect.arrayContaining([
+                    '-y',
+                    expect.stringMatching(/chrome-devtools-mcp@/),
+                    '--experimental-vision',
+                ]),
+            }));
+            // Persistent mode should NOT include --isolated or --autoConnect
+            const args = vi.mocked(StdioClientTransport).mock.calls[0]?.[0]
+                ?.args;
+            expect(args).not.toContain('--isolated');
+            expect(args).not.toContain('--autoConnect');
+            // Persistent mode should set the default --userDataDir under ~/.gemini
+            expect(args).toContain('--userDataDir');
+            const userDataDirIndex = args.indexOf('--userDataDir');
+            expect(args[userDataDirIndex + 1]).toMatch(/cli-browser-profile$/);
+        });
+        it('should pass headless flag when configured', async () => {
+            const headlessConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        headless: true,
+                    },
+                },
+            });
+            const manager = new BrowserManager(headlessConfig);
+            await manager.ensureConnection();
+            expect(StdioClientTransport).toHaveBeenCalledWith(expect.objectContaining({
+                command: 'npx',
+                args: expect.arrayContaining(['--headless']),
+            }));
+        });
+        it('should pass profilePath as --userDataDir when configured', async () => {
+            const profileConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        profilePath: '/path/to/profile',
+                    },
+                },
+            });
+            const manager = new BrowserManager(profileConfig);
+            await manager.ensureConnection();
+            expect(StdioClientTransport).toHaveBeenCalledWith(expect.objectContaining({
+                command: 'npx',
+                args: expect.arrayContaining(['--userDataDir', '/path/to/profile']),
+            }));
+        });
+        it('should pass --isolated when sessionMode is isolated', async () => {
+            const isolatedConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        sessionMode: 'isolated',
+                    },
+                },
+            });
+            const manager = new BrowserManager(isolatedConfig);
+            await manager.ensureConnection();
+            const args = vi.mocked(StdioClientTransport).mock.calls[0]?.[0]
+                ?.args;
+            expect(args).toContain('--isolated');
+            expect(args).not.toContain('--autoConnect');
+        });
+        it('should pass --autoConnect when sessionMode is existing', async () => {
+            const existingConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        sessionMode: 'existing',
+                    },
+                },
+            });
+            const manager = new BrowserManager(existingConfig);
+            await manager.ensureConnection();
+            const args = vi.mocked(StdioClientTransport).mock.calls[0]?.[0]
+                ?.args;
+            expect(args).toContain('--autoConnect');
+            expect(args).not.toContain('--isolated');
+        });
+        it('should throw actionable error when existing mode connection fails', async () => {
+            // Make the Client mock's connect method reject
+            vi.mocked(Client).mockImplementation(() => ({
+                connect: vi.fn().mockRejectedValue(new Error('Connection refused')),
+                close: vi.fn().mockResolvedValue(undefined),
+                listTools: vi.fn(),
+                callTool: vi.fn(),
+            }));
+            const existingConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        sessionMode: 'existing',
+                    },
+                },
+            });
+            const manager = new BrowserManager(existingConfig);
+            await expect(manager.ensureConnection()).rejects.toThrow(/Failed to connect to existing Chrome instance/);
+            // Create a fresh manager to verify the error message includes remediation steps
+            const manager2 = new BrowserManager(existingConfig);
+            await expect(manager2.ensureConnection()).rejects.toThrow(/chrome:\/\/inspect\/#remote-debugging/);
+        });
+        it('should throw profile-lock remediation when persistent mode hits "already running"', async () => {
+            vi.mocked(Client).mockImplementation(() => ({
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new Error('Could not connect to Chrome. The browser is already running for the current profile.')),
+                close: vi.fn().mockResolvedValue(undefined),
+                listTools: vi.fn(),
+                callTool: vi.fn(),
+            }));
+            // Default config = persistent mode
+            const manager = new BrowserManager(mockConfig);
+            await expect(manager.ensureConnection()).rejects.toThrow(/Close all Chrome windows using this profile/);
+            const manager2 = new BrowserManager(mockConfig);
+            await expect(manager2.ensureConnection()).rejects.toThrow(/Set sessionMode to "isolated"/);
+        });
+        it('should throw timeout-specific remediation for persistent mode', async () => {
+            vi.mocked(Client).mockImplementation(() => ({
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new Error('Timed out connecting to chrome-devtools-mcp')),
+                close: vi.fn().mockResolvedValue(undefined),
+                listTools: vi.fn(),
+                callTool: vi.fn(),
+            }));
+            const manager = new BrowserManager(mockConfig);
+            await expect(manager.ensureConnection()).rejects.toThrow(/Chrome is not installed/);
+        });
+        it('should include sessionMode in generic fallback error', async () => {
+            vi.mocked(Client).mockImplementation(() => ({
+                connect: vi
+                    .fn()
+                    .mockRejectedValue(new Error('Some unexpected error')),
+                close: vi.fn().mockResolvedValue(undefined),
+                listTools: vi.fn(),
+                callTool: vi.fn(),
+            }));
+            const manager = new BrowserManager(mockConfig);
+            await expect(manager.ensureConnection()).rejects.toThrow(/sessionMode: persistent/);
+        });
+    });
+    describe('MCP isolation', () => {
+        it('should use raw MCP SDK Client, not McpClient wrapper', async () => {
+            const manager = new BrowserManager(mockConfig);
+            await manager.ensureConnection();
+            // Verify we're using the raw Client from MCP SDK
+            expect(Client).toHaveBeenCalledWith(expect.objectContaining({
+                name: 'gemini-cli-browser-agent',
+            }), expect.any(Object));
+        });
+        it('should not use McpClientManager from config', async () => {
+            // Spy on config method to verify isolation
+            const getMcpClientManagerSpy = vi.spyOn(mockConfig, 'getMcpClientManager');
+            const manager = new BrowserManager(mockConfig);
+            await manager.ensureConnection();
+            // Config's getMcpClientManager should NOT be called
+            // This ensures isolation from main registry
+            expect(getMcpClientManagerSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('close', () => {
+        it('should close MCP connections', async () => {
+            const manager = new BrowserManager(mockConfig);
+            const client = await manager.getRawMcpClient();
+            await manager.close();
+            expect(client.close).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=browserManager.test.js.map

package/dist/src/agents/browser/browserManager.test.js.map

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

package/dist/src/agents/browser/mcpToolWrapper.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DeclarativeTool, type ToolResult, type ToolInvocation } from '../../tools/tools.js';
+import type { MessageBus } from '../../confirmation-bus/message-bus.js';
+import type { BrowserManager } from './browserManager.js';
+/**
+ * DeclarativeTool wrapper for an MCP tool.
+ */
+declare class McpDeclarativeTool extends DeclarativeTool<Record<string, unknown>, ToolResult> {
+    private readonly browserManager;
+    constructor(browserManager: BrowserManager, name: string, description: string, parameterSchema: unknown, messageBus: MessageBus);
+    build(params: Record<string, unknown>): ToolInvocation<Record<string, unknown>, ToolResult>;
+}
+/**
+ * DeclarativeTool for the custom type_text composite tool.
+ */
+declare class TypeTextDeclarativeTool extends DeclarativeTool<Record<string, unknown>, ToolResult> {
+    private readonly browserManager;
+    constructor(browserManager: BrowserManager, messageBus: MessageBus);
+    build(params: Record<string, unknown>): ToolInvocation<Record<string, unknown>, ToolResult>;
+}
+/**
+ * Creates DeclarativeTool instances from dynamically discovered MCP tools,
+ * plus custom composite tools (like type_text).
+ *
+ * These tools are registered in the browser agent's isolated ToolRegistry,
+ * NOT in the main agent's registry.
+ *
+ * Tool definitions are fetched dynamically from the MCP server at runtime.
+ *
+ * @param browserManager The browser manager with isolated MCP client
+ * @param messageBus Message bus for tool invocations
+ * @returns Array of DeclarativeTools that dispatch to the isolated MCP client
+ */
+export declare function createMcpDeclarativeTools(browserManager: BrowserManager, messageBus: MessageBus): Promise<Array<McpDeclarativeTool | TypeTextDeclarativeTool>>;
+/**
+ * Post-processes tool results to add contextual hints for common error patterns.
+ * This helps the agent recover from overlay blocking, element not found, etc.
+ * Also strips embedded snapshots to prevent token bloat.
+ */
+export declare function postProcessToolResult(toolName: string, result: string): string;
+export {};