@office-ai/aioncli-core 0.30.0 → 0.30.1

package/dist/src/agents/browser/browserAgentDefinition.js

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { isPreviewModel, PREVIEW_GEMINI_FLASH_MODEL, DEFAULT_GEMINI_FLASH_MODEL, } from '../../config/models.js';
+/** Canonical agent name — used for routing and configuration lookup. */
+export const BROWSER_AGENT_NAME = 'browser_agent';
+/**
+ * Output schema for browser agent results.
+ */
+export const BrowserTaskResultSchema = z.object({
+    success: z.boolean().describe('Whether the task was completed successfully'),
+    summary: z
+        .string()
+        .describe('A summary of what was accomplished or what went wrong'),
+    data: z
+        .unknown()
+        .optional()
+        .describe('Optional extracted data from the task'),
+});
+const VISUAL_SECTION = `
+VISUAL IDENTIFICATION (analyze_screenshot):
+When you need to identify elements by visual attributes not in the AX tree (e.g., "click the yellow button", "find the red error message"), or need precise pixel coordinates:
+1. Call analyze_screenshot with a clear instruction describing what to find
+2. It returns visual analysis with coordinates/descriptions — it does NOT perform actions
+3. Use the returned coordinates with click_at(x, y) or other tools yourself
+4. If the analysis is insufficient, call it again with a more specific instruction
+`;
+/**
+ * System prompt for the semantic browser agent.
+ * Extracted from prototype (computer_use_subagent_cdt branch).
+ *
+ * @param visionEnabled Whether visual tools (analyze_screenshot, click_at) are available.
+ */
+export function buildBrowserSystemPrompt(visionEnabled) {
+    return `You are an expert browser automation agent (Orchestrator). Your goal is to completely fulfill the user's request.
+
+IMPORTANT: You will receive an accessibility tree snapshot showing elements with uid values (e.g., uid=87_4 button "Login"). 
+Use these uid values directly with your tools:
+- click(uid="87_4") to click the Login button
+- fill(uid="87_2", value="john") to fill a text field
+- fill_form(elements=[{uid: "87_2", value: "john"}, {uid: "87_3", value: "pass"}]) to fill multiple fields at once
+
+PARALLEL TOOL CALLS - CRITICAL:
+- Do NOT make parallel calls for actions that change page state (click, fill, press_key, etc.)
+- Each action changes the DOM and invalidates UIDs from the current snapshot
+- Make state-changing actions ONE AT A TIME, then observe the results
+
+OVERLAY/POPUP HANDLING:
+Before interacting with page content, scan the accessibility tree for blocking overlays:
+- Tooltips, popups, modals, cookie banners, newsletter prompts, promo dialogs
+- These often have: close buttons (×, X, Close, Dismiss), "Got it", "Accept", "No thanks" buttons
+- Common patterns: elements with role="dialog", role="tooltip", role="alertdialog", or aria-modal="true"
+- If you see such elements, DISMISS THEM FIRST by clicking close/dismiss buttons before proceeding
+- If a click seems to have no effect, check if an overlay appeared or is blocking the target
+${visionEnabled ? VISUAL_SECTION : ''}
+
+COMPLEX WEB APPS (spreadsheets, rich editors, canvas apps):
+Many web apps (Google Sheets/Docs, Notion, Figma, etc.) use custom rendering rather than standard HTML inputs.
+- fill does NOT work on these apps. Instead, click the target element, then use type_text to enter the value.
+- type_text supports a submitKey parameter to press a key after typing (e.g., submitKey="Enter" to submit, submitKey="Tab" to move to the next field). This is much faster than separate press_key calls.
+- Navigate cells/fields using keyboard shortcuts (Tab, Enter, ArrowDown) — more reliable than clicking UIDs.
+- Use the Name Box (cell reference input, usually showing "A1") to jump to specific cells.
+
+TERMINAL FAILURES — STOP IMMEDIATELY:
+Some errors are unrecoverable and retrying will never help. When you see ANY of these, call complete_task immediately with success=false and include the EXACT error message (including any remediation steps it contains) in your summary:
+- "Could not connect to Chrome" or "Failed to connect to Chrome" or "Timed out connecting to Chrome" — Include the full error message with its remediation steps in your summary verbatim. Do NOT paraphrase or omit instructions.
+- "Browser closed" or "Target closed" or "Session closed" — The browser process has terminated. Include the error and tell the user to try again.
+- "net::ERR_" network errors on the SAME URL after 2 retries — the site is unreachable. Report the URL and error.
+- Any error that appears IDENTICALLY 3+ times in a row — it will not resolve by retrying.
+Do NOT keep retrying terminal errors. Report them with actionable remediation steps and exit immediately.
+
+CRITICAL: When you have fully completed the user's task, you MUST call the complete_task tool with a summary of what you accomplished. Do NOT just return text - you must explicitly call complete_task to exit the loop.`;
+}
+/**
+ * Browser Agent Definition Factory.
+ *
+ * Following the CodebaseInvestigatorAgent pattern:
+ * - Returns a factory function that takes Config for dynamic model selection
+ * - kind: 'local' for LocalAgentExecutor
+ * - toolConfig is set dynamically by browserAgentFactory
+ */
+export const BrowserAgentDefinition = (config, visionEnabled = false) => {
+    // Use Preview Flash model if the main model is any of the preview models.
+    // If the main model is not a preview model, use the default flash model.
+    const model = isPreviewModel(config.getModel())
+        ? PREVIEW_GEMINI_FLASH_MODEL
+        : DEFAULT_GEMINI_FLASH_MODEL;
+    return {
+        name: BROWSER_AGENT_NAME,
+        kind: 'local',
+        experimental: true,
+        displayName: 'Browser Agent',
+        description: `Specialized autonomous agent for end-to-end web browser automation and objective-driven problem solving. Delegate complete, high-level tasks to this agent — it independently plans, executes multi-step interactions, interprets dynamic page feedback (e.g., game states, form validation errors, search results), and iterates until the goal is achieved. It perceives page structure through the Accessibility Tree, handles overlays and popups, and supports complex web apps.`,
+        inputConfig: {
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    task: {
+                        type: 'string',
+                        description: 'The task to perform in the browser.',
+                    },
+                },
+                required: ['task'],
+            },
+        },
+        outputConfig: {
+            outputName: 'result',
+            description: 'The result of the browser task.',
+            schema: BrowserTaskResultSchema,
+        },
+        processOutput: (output) => JSON.stringify(output, null, 2),
+        modelConfig: {
+            // Dynamic model based on whether user is using preview models
+            model,
+            generateContentConfig: {
+                temperature: 0.1,
+                topP: 0.95,
+            },
+        },
+        runConfig: {
+            maxTimeMinutes: 10,
+            maxTurns: 50,
+        },
+        // Tools are set dynamically by browserAgentFactory after MCP connection
+        // This is undefined here and will be set at invocation time
+        toolConfig: undefined,
+        promptConfig: {
+            query: `Your task is:
+<task>
+\${task}
+</task>
+
+First, use new_page to open the relevant URL. Then call take_snapshot to see the page and proceed with your task.`,
+            systemPrompt: buildBrowserSystemPrompt(visionEnabled),
+        },
+    };
+};
+//# sourceMappingURL=browserAgentDefinition.js.map

package/dist/src/agents/browser/browserAgentDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserAgentDefinition.js","sourceRoot":"","sources":["../../../../src/agents/browser/browserAgentDefinition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC5E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,uDAAuD,CAAC;IACpE,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG;;;;;;;CAOtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,aAAsB;IAC7D,OAAO;;;;;;;;;;;;;;;;;;;;EAoBP,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;0NAiBqL,CAAC;AAC3N,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAc,EACd,aAAa,GAAG,KAAK,EACiC,EAAE;IACxD,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7C,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,0BAA0B,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,udAAud;QAEpe,WAAW,EAAE;YACX,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qCAAqC;qBACnD;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;QAED,YAAY,EAAE;YACZ,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,iCAAiC;YAC9C,MAAM,EAAE,uBAAuB;SAChC;QAED,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,WAAW,EAAE;YACX,8DAA8D;YAC9D,KAAK;YACL,qBAAqB,EAAE;gBACrB,WAAW,EAAE,GAAG;gBAChB,IAAI,EAAE,IAAI;aACX;SACF;QAED,SAAS,EAAE;YACT,cAAc,EAAE,EAAE;YAClB,QAAQ,EAAE,EAAE;SACb;QAED,wEAAwE;QACxE,4DAA4D;QAC5D,UAAU,EAAE,SAAS;QAErB,YAAY,EAAE;YACZ,KAAK,EAAE;;;;;kHAKqG;YAC5G,YAAY,EAAE,wBAAwB,CAAC,aAAa,CAAC;SACtD;KACF,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Factory for creating browser agent definitions with configured tools.
+ *
+ * This factory is called when the browser agent is invoked via delegate_to_agent.
+ * It creates a BrowserManager, connects the isolated MCP client, wraps tools,
+ * and returns a fully configured LocalAgentDefinition.
+ *
+ * IMPORTANT: The MCP tools are ONLY available to the browser agent's isolated
+ * registry. They are NOT registered in the main agent's ToolRegistry.
+ */
+import type { Config } from '../../config/config.js';
+import type { LocalAgentDefinition } from '../types.js';
+import type { MessageBus } from '../../confirmation-bus/message-bus.js';
+import { BrowserManager } from './browserManager.js';
+import { type BrowserTaskResultSchema } from './browserAgentDefinition.js';
+/**
+ * Creates a browser agent definition with MCP tools configured.
+ *
+ * This is called when the browser agent is invoked via delegate_to_agent.
+ * The MCP client is created fresh and tools are wrapped for the agent's
+ * isolated registry - NOT registered with the main agent.
+ *
+ * @param config Runtime configuration
+ * @param messageBus Message bus for tool invocations
+ * @param printOutput Optional callback for progress messages
+ * @returns Fully configured LocalAgentDefinition with MCP tools
+ */
+export declare function createBrowserAgentDefinition(config: Config, messageBus: MessageBus, printOutput?: (msg: string) => void): Promise<{
+    definition: LocalAgentDefinition<typeof BrowserTaskResultSchema>;
+    browserManager: BrowserManager;
+}>;
+/**
+ * Cleans up browser resources after agent execution.
+ *
+ * @param browserManager The browser manager to clean up
+ */
+export declare function cleanupBrowserAgent(browserManager: BrowserManager): Promise<void>;

package/dist/src/agents/browser/browserAgentFactory.js

@@ -0,0 +1,116 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AuthType } from '../../core/contentGenerator.js';
+import { BrowserManager } from './browserManager.js';
+import { BrowserAgentDefinition, } from './browserAgentDefinition.js';
+import { createMcpDeclarativeTools } from './mcpToolWrapper.js';
+import { createAnalyzeScreenshotTool } from './analyzeScreenshot.js';
+import { injectAutomationOverlay } from './automationOverlay.js';
+import { debugLogger } from '../../utils/debugLogger.js';
+/**
+ * Creates a browser agent definition with MCP tools configured.
+ *
+ * This is called when the browser agent is invoked via delegate_to_agent.
+ * The MCP client is created fresh and tools are wrapped for the agent's
+ * isolated registry - NOT registered with the main agent.
+ *
+ * @param config Runtime configuration
+ * @param messageBus Message bus for tool invocations
+ * @param printOutput Optional callback for progress messages
+ * @returns Fully configured LocalAgentDefinition with MCP tools
+ */
+export async function createBrowserAgentDefinition(config, messageBus, printOutput) {
+    debugLogger.log('Creating browser agent definition with isolated MCP tools...');
+    // Create and initialize browser manager with isolated MCP client
+    const browserManager = new BrowserManager(config);
+    await browserManager.ensureConnection();
+    if (printOutput) {
+        printOutput('Browser connected with isolated MCP client.');
+    }
+    // Inject automation overlay if not in headless mode
+    const browserConfig = config.getBrowserAgentConfig();
+    if (!browserConfig?.customConfig?.headless) {
+        if (printOutput) {
+            printOutput('Injecting automation overlay...');
+        }
+        await injectAutomationOverlay(browserManager);
+    }
+    // Create declarative tools from dynamically discovered MCP tools
+    // These tools dispatch to browserManager's isolated client
+    const mcpTools = await createMcpDeclarativeTools(browserManager, messageBus);
+    const availableToolNames = mcpTools.map((t) => t.name);
+    // Validate required semantic tools are available
+    const requiredSemanticTools = [
+        'click',
+        'fill',
+        'navigate_page',
+        'take_snapshot',
+    ];
+    const missingSemanticTools = requiredSemanticTools.filter((t) => !availableToolNames.includes(t));
+    if (missingSemanticTools.length > 0) {
+        debugLogger.warn(`Semantic tools missing (${missingSemanticTools.join(', ')}). ` +
+            'Some browser interactions may not work correctly.');
+    }
+    // Only click_at is strictly required — text input can use press_key or fill.
+    const requiredVisualTools = ['click_at'];
+    const missingVisualTools = requiredVisualTools.filter((t) => !availableToolNames.includes(t));
+    // Check whether vision can be enabled; returns undefined if all gates pass.
+    function getVisionDisabledReason() {
+        const browserConfig = config.getBrowserAgentConfig();
+        if (!browserConfig.customConfig.visualModel) {
+            return 'No visualModel configured.';
+        }
+        if (missingVisualTools.length > 0) {
+            return (`Visual tools missing (${missingVisualTools.join(', ')}). ` +
+                `The installed chrome-devtools-mcp version may be too old.`);
+        }
+        const authType = config.getContentGeneratorConfig()?.authType;
+        const blockedAuthTypes = new Set([
+            AuthType.LOGIN_WITH_GOOGLE,
+            AuthType.LEGACY_CLOUD_SHELL,
+            AuthType.COMPUTE_ADC,
+        ]);
+        if (authType && blockedAuthTypes.has(authType)) {
+            return 'Visual agent model not available for current auth type.';
+        }
+        return undefined;
+    }
+    const allTools = [...mcpTools];
+    const visionDisabledReason = getVisionDisabledReason();
+    if (visionDisabledReason) {
+        debugLogger.log(`Vision disabled: ${visionDisabledReason}`);
+    }
+    else {
+        allTools.push(createAnalyzeScreenshotTool(browserManager, config, messageBus));
+    }
+    debugLogger.log(`Created ${allTools.length} tools for browser agent: ` +
+        allTools.map((t) => t.name).join(', '));
+    // Create configured definition with tools
+    // BrowserAgentDefinition is a factory function - call it with config
+    const baseDefinition = BrowserAgentDefinition(config, !visionDisabledReason);
+    const definition = {
+        ...baseDefinition,
+        toolConfig: {
+            tools: allTools,
+        },
+    };
+    return { definition, browserManager };
+}
+/**
+ * Cleans up browser resources after agent execution.
+ *
+ * @param browserManager The browser manager to clean up
+ */
+export async function cleanupBrowserAgent(browserManager) {
+    try {
+        await browserManager.close();
+        debugLogger.log('Browser agent cleanup complete');
+    }
+    catch (error) {
+        debugLogger.error(`Error during browser cleanup: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=browserAgentFactory.js.map

package/dist/src/agents/browser/browserAgentFactory.js.map

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

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

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

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

@@ -0,0 +1,240 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createBrowserAgentDefinition, cleanupBrowserAgent, } from './browserAgentFactory.js';
+import { injectAutomationOverlay } from './automationOverlay.js';
+import { makeFakeConfig } from '../../test-utils/config.js';
+// Create mock browser manager
+const mockBrowserManager = {
+    ensureConnection: vi.fn().mockResolvedValue(undefined),
+    getDiscoveredTools: vi.fn().mockResolvedValue([
+        // Semantic tools
+        { name: 'take_snapshot', description: 'Take snapshot' },
+        { name: 'click', description: 'Click element' },
+        { name: 'fill', description: 'Fill form field' },
+        { name: 'navigate_page', description: 'Navigate to URL' },
+        // Visual tools (from --experimental-vision)
+        { name: 'click_at', description: 'Click at coordinates' },
+    ]),
+    callTool: vi.fn().mockResolvedValue({ content: [] }),
+    close: vi.fn().mockResolvedValue(undefined),
+};
+// Mock dependencies
+vi.mock('./browserManager.js', () => ({
+    BrowserManager: vi.fn(() => mockBrowserManager),
+}));
+vi.mock('./automationOverlay.js', () => ({
+    injectAutomationOverlay: vi.fn().mockResolvedValue(undefined),
+}));
+vi.mock('../../utils/debugLogger.js', () => ({
+    debugLogger: {
+        log: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+import { buildBrowserSystemPrompt, BROWSER_AGENT_NAME, } from './browserAgentDefinition.js';
+describe('browserAgentFactory', () => {
+    let mockConfig;
+    let mockMessageBus;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(injectAutomationOverlay).mockClear();
+        // Reset mock implementations
+        mockBrowserManager.ensureConnection.mockResolvedValue(undefined);
+        mockBrowserManager.getDiscoveredTools.mockResolvedValue([
+            // Semantic tools
+            { name: 'take_snapshot', description: 'Take snapshot' },
+            { name: 'click', description: 'Click element' },
+            { name: 'fill', description: 'Fill form field' },
+            { name: 'navigate_page', description: 'Navigate to URL' },
+            // Visual tools (from --experimental-vision)
+            { name: 'click_at', description: 'Click at coordinates' },
+        ]);
+        mockBrowserManager.close.mockResolvedValue(undefined);
+        mockConfig = makeFakeConfig({
+            agents: {
+                overrides: {
+                    browser_agent: {
+                        enabled: true,
+                    },
+                },
+                browser: {
+                    headless: false,
+                },
+            },
+        });
+        mockMessageBus = {
+            publish: vi.fn().mockResolvedValue(undefined),
+            subscribe: vi.fn(),
+            unsubscribe: vi.fn(),
+        };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('createBrowserAgentDefinition', () => {
+        it('should ensure browser connection', async () => {
+            await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            expect(mockBrowserManager.ensureConnection).toHaveBeenCalled();
+        });
+        it('should inject automation overlay when not in headless mode', async () => {
+            await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            expect(injectAutomationOverlay).toHaveBeenCalledWith(mockBrowserManager);
+        });
+        it('should not inject automation overlay when in headless mode', async () => {
+            const headlessConfig = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        headless: true,
+                    },
+                },
+            });
+            await createBrowserAgentDefinition(headlessConfig, mockMessageBus);
+            expect(injectAutomationOverlay).not.toHaveBeenCalled();
+        });
+        it('should return agent definition with discovered tools', async () => {
+            const { definition } = await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            expect(definition.name).toBe(BROWSER_AGENT_NAME);
+            // 5 MCP tools + 1 type_text composite tool (no analyze_screenshot without visualModel)
+            expect(definition.toolConfig?.tools).toHaveLength(6);
+        });
+        it('should return browser manager for cleanup', async () => {
+            const { browserManager } = await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            expect(browserManager).toBeDefined();
+        });
+        it('should call printOutput when provided', async () => {
+            const printOutput = vi.fn();
+            await createBrowserAgentDefinition(mockConfig, mockMessageBus, printOutput);
+            expect(printOutput).toHaveBeenCalled();
+        });
+        it('should create definition with correct structure', async () => {
+            const { definition } = await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            expect(definition.kind).toBe('local');
+            expect(definition.inputConfig).toBeDefined();
+            expect(definition.outputConfig).toBeDefined();
+            expect(definition.promptConfig).toBeDefined();
+        });
+        it('should exclude visual prompt section when visualModel is not configured', async () => {
+            const { definition } = await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            const systemPrompt = definition.promptConfig?.systemPrompt ?? '';
+            expect(systemPrompt).not.toContain('analyze_screenshot');
+            expect(systemPrompt).not.toContain('VISUAL IDENTIFICATION');
+        });
+        it('should include visual prompt section when visualModel is configured', async () => {
+            const configWithVision = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        headless: false,
+                        visualModel: 'gemini-2.5-flash-preview',
+                    },
+                },
+            });
+            const { definition } = await createBrowserAgentDefinition(configWithVision, mockMessageBus);
+            const systemPrompt = definition.promptConfig?.systemPrompt ?? '';
+            expect(systemPrompt).toContain('analyze_screenshot');
+            expect(systemPrompt).toContain('VISUAL IDENTIFICATION');
+        });
+        it('should include analyze_screenshot tool when visualModel is configured', async () => {
+            const configWithVision = makeFakeConfig({
+                agents: {
+                    overrides: {
+                        browser_agent: {
+                            enabled: true,
+                        },
+                    },
+                    browser: {
+                        headless: false,
+                        visualModel: 'gemini-2.5-flash-preview',
+                    },
+                },
+            });
+            const { definition } = await createBrowserAgentDefinition(configWithVision, mockMessageBus);
+            // 5 MCP tools + 1 type_text + 1 analyze_screenshot
+            expect(definition.toolConfig?.tools).toHaveLength(7);
+            const toolNames = definition.toolConfig?.tools
+                ?.filter((t) => typeof t === 'object' && 'name' in t)
+                .map((t) => t.name) ?? [];
+            expect(toolNames).toContain('analyze_screenshot');
+        });
+        it('should include all MCP navigation tools (new_page, navigate_page) in definition', async () => {
+            mockBrowserManager.getDiscoveredTools.mockResolvedValue([
+                { name: 'take_snapshot', description: 'Take snapshot' },
+                { name: 'click', description: 'Click element' },
+                { name: 'fill', description: 'Fill form field' },
+                { name: 'navigate_page', description: 'Navigate to URL' },
+                { name: 'new_page', description: 'Open a new page/tab' },
+                { name: 'close_page', description: 'Close page' },
+                { name: 'select_page', description: 'Select page' },
+                { name: 'press_key', description: 'Press key' },
+                { name: 'hover', description: 'Hover element' },
+            ]);
+            const { definition } = await createBrowserAgentDefinition(mockConfig, mockMessageBus);
+            const toolNames = definition.toolConfig?.tools
+                ?.filter((t) => typeof t === 'object' && 'name' in t)
+                .map((t) => t.name) ?? [];
+            // All MCP tools must be present
+            expect(toolNames).toContain('new_page');
+            expect(toolNames).toContain('navigate_page');
+            expect(toolNames).toContain('close_page');
+            expect(toolNames).toContain('select_page');
+            expect(toolNames).toContain('click');
+            expect(toolNames).toContain('take_snapshot');
+            expect(toolNames).toContain('press_key');
+            // Custom composite tool must also be present
+            expect(toolNames).toContain('type_text');
+            // Total: 9 MCP + 1 type_text (no analyze_screenshot without visualModel)
+            expect(definition.toolConfig?.tools).toHaveLength(10);
+        });
+    });
+    describe('cleanupBrowserAgent', () => {
+        it('should call close on browser manager', async () => {
+            await cleanupBrowserAgent(mockBrowserManager);
+            expect(mockBrowserManager.close).toHaveBeenCalled();
+        });
+        it('should handle errors during cleanup gracefully', async () => {
+            const errorManager = {
+                close: vi.fn().mockRejectedValue(new Error('Close failed')),
+            };
+            // Should not throw
+            await expect(cleanupBrowserAgent(errorManager)).resolves.toBeUndefined();
+        });
+    });
+});
+describe('buildBrowserSystemPrompt', () => {
+    it('should include visual section when vision is enabled', () => {
+        const prompt = buildBrowserSystemPrompt(true);
+        expect(prompt).toContain('VISUAL IDENTIFICATION');
+        expect(prompt).toContain('analyze_screenshot');
+        expect(prompt).toContain('click_at');
+    });
+    it('should exclude visual section when vision is disabled', () => {
+        const prompt = buildBrowserSystemPrompt(false);
+        expect(prompt).not.toContain('VISUAL IDENTIFICATION');
+        expect(prompt).not.toContain('analyze_screenshot');
+    });
+    it('should always include core sections regardless of vision', () => {
+        for (const visionEnabled of [true, false]) {
+            const prompt = buildBrowserSystemPrompt(visionEnabled);
+            expect(prompt).toContain('PARALLEL TOOL CALLS');
+            expect(prompt).toContain('OVERLAY/POPUP HANDLING');
+            expect(prompt).toContain('COMPLEX WEB APPS');
+            expect(prompt).toContain('TERMINAL FAILURES');
+            expect(prompt).toContain('complete_task');
+        }
+    });
+});
+//# sourceMappingURL=browserAgentFactory.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browserAgentFactory.test.js","sourceRoot":"","sources":["../../../../src/agents/browser/browserAgentFactory.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAK5D,8BAA8B;AAC9B,MAAM,kBAAkB,GAAG;IACzB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IACtD,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;QAC5C,iBAAiB;QACjB,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE;QACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE;QAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAChD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE;QACzD,4CAA4C;QAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE;KAC1D,CAAC;IACF,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACpD,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAC5C,CAAC;AAEF,oBAAoB;AACpB,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC;CAChD,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,uBAAuB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAC9D,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,WAAW,EAAE;QACX,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;QACZ,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;KACf;CACF,CAAC,CAAC,CAAC;AAEJ,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,UAAkB,CAAC;IACvB,IAAI,cAA0B,CAAC;IAE/B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QAEnB,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,SAAS,EAAE,CAAC;QAE/C,6BAA6B;QAC7B,kBAAkB,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACjE,kBAAkB,CAAC,kBAAkB,CAAC,iBAAiB,CAAC;YACtD,iBAAiB;YACjB,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE;YACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE;YAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE;YAChD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE;YACzD,4CAA4C;YAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE;SAC1D,CAAC,CAAC;QACH,kBAAkB,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEtD,UAAU,GAAG,cAAc,CAAC;YAC1B,MAAM,EAAE;gBACN,SAAS,EAAE;oBACT,aAAa,EAAE;wBACb,OAAO,EAAE,IAAI;qBACd;iBACF;gBACD,OAAO,EAAE;oBACP,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF,CAAC,CAAC;QAEH,cAAc,GAAG;YACf,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC7C,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;SACI,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,4BAA4B,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAE/D,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,4BAA4B,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAC/D,MAAM,CAAC,uBAAuB,CAAC,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,cAAc,GAAG,cAAc,CAAC;gBACpC,MAAM,EAAE;oBACN,SAAS,EAAE;wBACT,aAAa,EAAE;4BACb,OAAO,EAAE,IAAI;yBACd;qBACF;oBACD,OAAO,EAAE;wBACP,QAAQ,EAAE,IAAI;qBACf;iBACF;aACF,CAAC,CAAC;YACH,MAAM,4BAA4B,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YACnE,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,UAAU,EACV,cAAc,CACf,CAAC;YAEF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACjD,uFAAuF;YACvF,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,4BAA4B,CAC3D,UAAU,EACV,cAAc,CACf,CAAC;YAEF,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAE5B,MAAM,4BAA4B,CAChC,UAAU,EACV,cAAc,EACd,WAAW,CACZ,CAAC;YAEF,MAAM,CAAC,WAAW,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,UAAU,EACV,cAAc,CACf,CAAC;YAEF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;YACvF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,UAAU,EACV,cAAc,CACf,CAAC;YAEF,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,EAAE,YAAY,IAAI,EAAE,CAAC;YACjE,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YACzD,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACnF,MAAM,gBAAgB,GAAG,cAAc,CAAC;gBACtC,MAAM,EAAE;oBACN,SAAS,EAAE;wBACT,aAAa,EAAE;4BACb,OAAO,EAAE,IAAI;yBACd;qBACF;oBACD,OAAO,EAAE;wBACP,QAAQ,EAAE,KAAK;wBACf,WAAW,EAAE,0BAA0B;qBACxC;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,gBAAgB,EAChB,cAAc,CACf,CAAC;YAEF,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,EAAE,YAAY,IAAI,EAAE,CAAC;YACjE,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YACrD,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;YACrF,MAAM,gBAAgB,GAAG,cAAc,CAAC;gBACtC,MAAM,EAAE;oBACN,SAAS,EAAE;wBACT,aAAa,EAAE;4BACb,OAAO,EAAE,IAAI;yBACd;qBACF;oBACD,OAAO,EAAE;wBACP,QAAQ,EAAE,KAAK;wBACf,WAAW,EAAE,0BAA0B;qBACxC;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,gBAAgB,EAChB,cAAc,CACf,CAAC;YAEF,mDAAmD;YACnD,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,SAAS,GACb,UAAU,CAAC,UAAU,EAAE,KAAK;gBAC1B,EAAE,MAAM,CACN,CAAC,CAAC,EAAyB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,CACnE;iBACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;YAC/F,kBAAkB,CAAC,kBAAkB,CAAC,iBAAiB,CAAC;gBACtD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE;gBACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE;gBAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBAChD,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBACzD,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBACxD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE;gBACjD,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE;gBACnD,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE;gBAC/C,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE;aAChD,CAAC,CAAC;YAEH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,4BAA4B,CACvD,UAAU,EACV,cAAc,CACf,CAAC;YAEF,MAAM,SAAS,GACb,UAAU,CAAC,UAAU,EAAE,KAAK;gBAC1B,EAAE,MAAM,CACN,CAAC,CAAC,EAAyB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,CACnE;iBACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAE9B,gCAAgC;YAChC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC1C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;YAC3C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzC,6CAA6C;YAC7C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzC,yEAAyE;YACzE,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,mBAAmB,CACvB,kBAA+C,CAChD,CAAC;YAEF,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,YAAY,GAAG;gBACnB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;aAC/B,CAAC;YAE/B,mBAAmB;YACnB,MAAM,MAAM,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC3E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,KAAK,MAAM,aAAa,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../../config/config.js';
+import { BaseToolInvocation, type ToolResult, type ToolLiveOutput } from '../../tools/tools.js';
+import { type AgentInputs } from '../types.js';
+import type { MessageBus } from '../../confirmation-bus/message-bus.js';
+/**
+ * Browser agent invocation with async tool setup.
+ *
+ * This invocation handles the browser agent's special requirements:
+ * - MCP connection and tool wrapping at invocation time
+ * - Browser cleanup after execution
+ */
+export declare class BrowserAgentInvocation extends BaseToolInvocation<AgentInputs, ToolResult> {
+    private readonly config;
+    constructor(config: Config, params: AgentInputs, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string);
+    /**
+     * Returns a concise, human-readable description of the invocation.
+     */
+    getDescription(): string;
+    /**
+     * Executes the browser agent.
+     *
+     * This method:
+     * 1. Creates browser manager and MCP connection
+     * 2. Wraps MCP tools for the isolated registry
+     * 3. Runs the agent via LocalAgentExecutor
+     * 4. Cleans up browser resources
+     */
+    execute(signal: AbortSignal, updateOutput?: (output: ToolLiveOutput) => void): Promise<ToolResult>;
+}