@office-ai/aioncli-core 0.26.0 → 0.30.1

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

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../../utils/debugLogger.js';
+const OVERLAY_ELEMENT_ID = '__gemini_automation_overlay';
+/**
+ * Builds the JavaScript function string that injects the automation overlay.
+ *
+ * Returns a plain arrow-function expression (no trailing invocation) because
+ * chrome-devtools-mcp's evaluate_script tool invokes it internally.
+ *
+ * Avoids nested template literals by using string concatenation for cssText.
+ */
+function buildInjectionScript() {
+    return `() => {
+    const id = '${OVERLAY_ELEMENT_ID}';
+    const existing = document.getElementById(id);
+    if (existing) existing.remove();
+
+    const overlay = document.createElement('div');
+    overlay.id = id;
+    overlay.setAttribute('aria-hidden', 'true');
+    overlay.setAttribute('role', 'presentation');
+
+    Object.assign(overlay.style, {
+      position: 'fixed',
+      top: '0',
+      left: '0',
+      right: '0',
+      bottom: '0',
+      zIndex: '2147483647',
+      pointerEvents: 'none',
+      border: '6px solid rgba(66, 133, 244, 1.0)',
+    });
+
+    document.documentElement.appendChild(overlay);
+
+    try {
+      overlay.animate([
+        { borderColor: 'rgba(66,133,244,0.3)', boxShadow: 'inset 0 0 8px rgba(66,133,244,0.15)' },
+        { borderColor: 'rgba(66,133,244,1.0)', boxShadow: 'inset 0 0 16px rgba(66,133,244,0.5)' },
+        { borderColor: 'rgba(66,133,244,0.3)', boxShadow: 'inset 0 0 8px rgba(66,133,244,0.15)' }
+      ], { duration: 2000, iterations: Infinity, easing: 'ease-in-out' });
+    } catch (e) {
+      // Silently ignore animation errors, as they can happen on sites with strict CSP.
+      // The border itself is the most important visual indicator.
+    }
+
+    return 'overlay-injected';
+  }`;
+}
+/**
+ * Builds the JavaScript function string that removes the automation overlay.
+ */
+function buildRemovalScript() {
+    return `() => {
+    const el = document.getElementById('${OVERLAY_ELEMENT_ID}');
+    if (el) el.remove();
+    return 'overlay-removed';
+  }`;
+}
+/**
+ * Injects the automation overlay into the current page.
+ */
+export async function injectAutomationOverlay(browserManager, signal) {
+    try {
+        debugLogger.log('Injecting automation overlay...');
+        const result = await browserManager.callTool('evaluate_script', { function: buildInjectionScript() }, signal);
+        if (result.isError) {
+            debugLogger.warn('Failed to inject automation overlay:', result);
+        }
+        else {
+            debugLogger.log('Automation overlay injected successfully');
+        }
+    }
+    catch (error) {
+        debugLogger.warn('Error injecting automation overlay:', error);
+    }
+}
+/**
+ * Removes the automation overlay from the current page.
+ */
+export async function removeAutomationOverlay(browserManager, signal) {
+    try {
+        debugLogger.log('Removing automation overlay...');
+        const result = await browserManager.callTool('evaluate_script', { function: buildRemovalScript() }, signal);
+        if (result.isError) {
+            debugLogger.warn('Failed to remove automation overlay:', result);
+        }
+        else {
+            debugLogger.log('Automation overlay removed successfully');
+        }
+    }
+    catch (error) {
+        debugLogger.warn('Error removing automation overlay:', error);
+    }
+}
+//# sourceMappingURL=automationOverlay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automationOverlay.js","sourceRoot":"","sources":["../../../../src/agents/browser/automationOverlay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,kBAAkB,GAAG,6BAA6B,CAAC;AAEzD;;;;;;;GAOG;AACH,SAAS,oBAAoB;IAC3B,OAAO;kBACS,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkChC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB;IACzB,OAAO;0CACiC,kBAAkB;;;IAGxD,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,cAA8B,EAC9B,MAAoB;IAEpB,IAAI,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,CAC1C,iBAAiB,EACjB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,EAAE,EACpC,MAAM,CACP,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,cAA8B,EAC9B,MAAoB;IAEpB,IAAI,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,CAC1C,iBAAiB,EACjB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,EAClC,MAAM,CACP,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,sCAAsC,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,IAAI,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @fileoverview Browser Agent definition following the LocalAgentDefinition pattern.
+ *
+ * This agent uses LocalAgentExecutor for its reAct loop, like CodebaseInvestigatorAgent.
+ * It is available ONLY via delegate_to_agent, NOT as a direct tool.
+ *
+ * Tools are configured dynamically at invocation time via browserAgentFactory.
+ */
+import type { LocalAgentDefinition } from '../types.js';
+import type { Config } from '../../config/config.js';
+import { z } from 'zod';
+/** Canonical agent name — used for routing and configuration lookup. */
+export declare const BROWSER_AGENT_NAME = "browser_agent";
+/**
+ * Output schema for browser agent results.
+ */
+export declare const BrowserTaskResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    summary: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    summary: string;
+    data?: unknown;
+}, {
+    success: boolean;
+    summary: string;
+    data?: unknown;
+}>;
+/**
+ * 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 declare function buildBrowserSystemPrompt(visionEnabled: boolean): string;
+/**
+ * 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 declare const BrowserAgentDefinition: (config: Config, visionEnabled?: boolean) => LocalAgentDefinition<typeof BrowserTaskResultSchema>;

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