@wingman-ai/gateway 0.2.5 → 0.3.1

package/README.md

@@ -74,6 +74,14 @@ npm install -g @wingman-ai/gateway
 wingman init
 ```
 
+### Re-sync Bundled Agent Templates
+
+```bash
+wingman init --mode sync --only agents
+wingman init --mode sync --only agents --agents main,coding
+wingman init --mode sync --only agents --force
+```
+
 ### Start the Gateway
 
 ```bash
@@ -253,6 +261,7 @@ wingman gateway start --discovery tailscale --name "Work Gateway"
 - **Hooks** for pre/post tool automation.
 - **Skills** for reusable, domain-specific instruction sets.
 - **MCP tools** to connect external systems and custom integrations.
+- **Bundled MCP servers** for finance (`bun run mcp:finance`) and FAL AI multimodal generation (`bun run mcp:fal-ai`).
 
 ## Development
 

package/dist/agent/config/agentConfig.cjs

@@ -24,6 +24,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    AgentBrowserTransportSchema: ()=>AgentBrowserTransportSchema,
     WingmanDirectory: ()=>WingmanDirectory,
     AgentConfigSchema: ()=>AgentConfigSchema,
     AvailableToolNames: ()=>AvailableToolNames,
@@ -38,6 +39,7 @@ const WingmanDirectory = ".wingman";
 const AvailableToolNames = external_zod_namespaceObject["enum"]([
     "internet_search",
     "web_crawler",
+    "browser_control",
     "command_execute",
     "background_terminal",
     "think",
@@ -56,6 +58,11 @@ const ReasoningEffortSchema = external_zod_namespaceObject.preprocess((value)=>{
     "medium",
     "high"
 ]));
+const AgentBrowserTransportSchema = external_zod_namespaceObject["enum"]([
+    "auto",
+    "playwright",
+    "relay"
+]);
 const PromptRefinementSchema = external_zod_namespaceObject.preprocess((value)=>{
     if (void 0 === value) return;
     if ("boolean" == typeof value) return {
@@ -76,6 +83,9 @@ const BaseAgentConfigSchema = external_zod_namespaceObject.object({
     blockedCommands: external_zod_namespaceObject.array(external_zod_namespaceObject.string()).optional().describe("List of blocked commands for command_execute tool (e.g., ['rm', 'mv'])"),
     allowScriptExecution: external_zod_namespaceObject.boolean().optional().default(true).describe("Whether to allow script execution in command_execute tool"),
     commandTimeout: external_zod_namespaceObject.number().optional().default(300000).describe("Command execution timeout in milliseconds (default: 300000)"),
+    browserProfile: external_zod_namespaceObject.string().min(1).optional().describe("Optional named browser profile ID for persistent browser_control sessions"),
+    browserTransport: AgentBrowserTransportSchema.optional().describe('Optional browser_control transport preference ("auto", "playwright", or "relay")'),
+    browserExtensions: external_zod_namespaceObject.array(external_zod_namespaceObject.string().min(1)).optional().describe("Optional extension IDs to load for browser_control sessions (maps from wingman.config browser.extensions)"),
     toolHooks: types_cjs_namespaceObject.HooksConfigSchema.optional().describe("Agent-specific tool hooks configuration"),
     mcp: mcp_cjs_namespaceObject.MCPServersConfigSchema.optional().describe("Agent-specific MCP server configurations"),
     mcpUseGlobal: external_zod_namespaceObject.boolean().optional().default(false).describe("Whether this agent should also load global MCP servers from wingman.config.json"),
@@ -135,12 +145,14 @@ function validateAgentConfig(config) {
         };
     }
 }
+exports.AgentBrowserTransportSchema = __webpack_exports__.AgentBrowserTransportSchema;
 exports.AgentConfigSchema = __webpack_exports__.AgentConfigSchema;
 exports.AvailableToolNames = __webpack_exports__.AvailableToolNames;
 exports.ReasoningEffortSchema = __webpack_exports__.ReasoningEffortSchema;
 exports.WingmanDirectory = __webpack_exports__.WingmanDirectory;
 exports.validateAgentConfig = __webpack_exports__.validateAgentConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "AgentBrowserTransportSchema",
     "AgentConfigSchema",
     "AvailableToolNames",
     "ReasoningEffortSchema",

package/dist/agent/config/agentConfig.d.ts

@@ -6,6 +6,7 @@ export declare const WingmanDirectory = ".wingman";
 export declare const AvailableToolNames: z.ZodEnum<{
     internet_search: "internet_search";
     web_crawler: "web_crawler";
+    browser_control: "browser_control";
     command_execute: "command_execute";
     background_terminal: "background_terminal";
     think: "think";
@@ -23,6 +24,11 @@ export declare const ReasoningEffortSchema: z.ZodPipe<z.ZodTransform<unknown, un
     high: "high";
 }>>;
 export type ReasoningEffort = z.infer<typeof ReasoningEffortSchema>;
+export declare const AgentBrowserTransportSchema: z.ZodEnum<{
+    auto: "auto";
+    playwright: "playwright";
+    relay: "relay";
+}>;
 declare const PromptRefinementSchema: z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     instructionsPath: z.ZodOptional<z.ZodString>;
@@ -35,6 +41,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
     tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         internet_search: "internet_search";
         web_crawler: "web_crawler";
+        browser_control: "browser_control";
         command_execute: "command_execute";
         background_terminal: "background_terminal";
         think: "think";
@@ -54,6 +61,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
     blockedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
     allowScriptExecution: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     commandTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    browserProfile: z.ZodOptional<z.ZodString>;
+    browserTransport: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        playwright: "playwright";
+        relay: "relay";
+    }>>;
+    browserExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     toolHooks: z.ZodOptional<z.ZodObject<{
         PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
             matcher: z.ZodOptional<z.ZodString>;
@@ -83,12 +97,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
         servers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             name: z.ZodString;
             transport: z.ZodLiteral<"stdio">;
+            defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
             command: z.ZodString;
             args: z.ZodOptional<z.ZodArray<z.ZodString>>;
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>, z.ZodObject<{
             name: z.ZodString;
             transport: z.ZodLiteral<"sse">;
+            defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
             url: z.ZodString;
             headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>]>>>;
@@ -129,6 +145,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             internet_search: "internet_search";
             web_crawler: "web_crawler";
+            browser_control: "browser_control";
             command_execute: "command_execute";
             background_terminal: "background_terminal";
             think: "think";
@@ -148,6 +165,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
         blockedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
         allowScriptExecution: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         commandTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        browserProfile: z.ZodOptional<z.ZodString>;
+        browserTransport: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            playwright: "playwright";
+            relay: "relay";
+        }>>;
+        browserExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
         toolHooks: z.ZodOptional<z.ZodObject<{
             PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 matcher: z.ZodOptional<z.ZodString>;
@@ -177,12 +201,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             servers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                 name: z.ZodString;
                 transport: z.ZodLiteral<"stdio">;
+                defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
                 command: z.ZodString;
                 args: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>, z.ZodObject<{
                 name: z.ZodString;
                 transport: z.ZodLiteral<"sse">;
+                defaultToolTimeout: z.ZodOptional<z.ZodNumber>;
                 url: z.ZodString;
                 headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>]>>>;

package/dist/agent/config/agentConfig.js

@@ -6,6 +6,7 @@ const WingmanDirectory = ".wingman";
 const AvailableToolNames = external_zod_enum([
     "internet_search",
     "web_crawler",
+    "browser_control",
     "command_execute",
     "background_terminal",
     "think",
@@ -24,6 +25,11 @@ const ReasoningEffortSchema = preprocess((value)=>{
     "medium",
     "high"
 ]));
+const AgentBrowserTransportSchema = external_zod_enum([
+    "auto",
+    "playwright",
+    "relay"
+]);
 const PromptRefinementSchema = preprocess((value)=>{
     if (void 0 === value) return;
     if ("boolean" == typeof value) return {
@@ -44,6 +50,9 @@ const BaseAgentConfigSchema = object({
     blockedCommands: array(string()).optional().describe("List of blocked commands for command_execute tool (e.g., ['rm', 'mv'])"),
     allowScriptExecution: external_zod_boolean().optional().default(true).describe("Whether to allow script execution in command_execute tool"),
     commandTimeout: number().optional().default(300000).describe("Command execution timeout in milliseconds (default: 300000)"),
+    browserProfile: string().min(1).optional().describe("Optional named browser profile ID for persistent browser_control sessions"),
+    browserTransport: AgentBrowserTransportSchema.optional().describe('Optional browser_control transport preference ("auto", "playwright", or "relay")'),
+    browserExtensions: array(string().min(1)).optional().describe("Optional extension IDs to load for browser_control sessions (maps from wingman.config browser.extensions)"),
     toolHooks: HooksConfigSchema.optional().describe("Agent-specific tool hooks configuration"),
     mcp: MCPServersConfigSchema.optional().describe("Agent-specific MCP server configurations"),
     mcpUseGlobal: external_zod_boolean().optional().default(false).describe("Whether this agent should also load global MCP servers from wingman.config.json"),
@@ -103,4 +112,4 @@ function validateAgentConfig(config) {
         };
     }
 }
-export { AgentConfigSchema, AvailableToolNames, ReasoningEffortSchema, WingmanDirectory, validateAgentConfig };
+export { AgentBrowserTransportSchema, AgentConfigSchema, AvailableToolNames, ReasoningEffortSchema, WingmanDirectory, validateAgentConfig };

package/dist/agent/config/agentLoader.cjs

@@ -228,6 +228,15 @@ class AgentLoader {
                 blockedCommands: source.blockedCommands,
                 allowScriptExecution: source.allowScriptExecution,
                 timeout: source.commandTimeout,
+                browserProfile: source.browserProfile || this.wingmanConfig?.browser?.defaultProfile,
+                browserTransport: source.browserTransport || this.wingmanConfig?.browser?.transport,
+                browserProfilesDirectory: this.wingmanConfig?.browser?.profilesDir,
+                browserProfiles: this.wingmanConfig?.browser?.profiles,
+                browserExtensions: source.browserExtensions,
+                browserExtensionsDirectory: this.wingmanConfig?.browser?.extensionsDir,
+                browserExtensionsById: this.wingmanConfig?.browser?.extensions,
+                browserDefaultExtensions: this.wingmanConfig?.browser?.defaultExtensions,
+                browserRelay: this.wingmanConfig?.browser?.relay,
                 searchConfig: this.wingmanConfig?.search,
                 mcpConfigs,
                 skillsDirectory,

package/dist/agent/config/agentLoader.js

@@ -200,6 +200,15 @@ class AgentLoader {
                 blockedCommands: source.blockedCommands,
                 allowScriptExecution: source.allowScriptExecution,
                 timeout: source.commandTimeout,
+                browserProfile: source.browserProfile || this.wingmanConfig?.browser?.defaultProfile,
+                browserTransport: source.browserTransport || this.wingmanConfig?.browser?.transport,
+                browserProfilesDirectory: this.wingmanConfig?.browser?.profilesDir,
+                browserProfiles: this.wingmanConfig?.browser?.profiles,
+                browserExtensions: source.browserExtensions,
+                browserExtensionsDirectory: this.wingmanConfig?.browser?.extensionsDir,
+                browserExtensionsById: this.wingmanConfig?.browser?.extensions,
+                browserDefaultExtensions: this.wingmanConfig?.browser?.defaultExtensions,
+                browserRelay: this.wingmanConfig?.browser?.relay,
                 searchConfig: this.wingmanConfig?.search,
                 mcpConfigs,
                 skillsDirectory,

package/dist/agent/config/mcpClientManager.cjs

@@ -26,8 +26,8 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     MCPClientManager: ()=>MCPClientManager
 });
-const mcp_adapters_namespaceObject = require("@langchain/mcp-adapters");
 const tools_namespaceObject = require("@langchain/core/tools");
+const mcp_adapters_namespaceObject = require("@langchain/mcp-adapters");
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -45,26 +45,51 @@ class MCPClientManager {
         return Array.from(serverMap.values());
     }
     buildClientConfig() {
-        const clientConfig = {};
+        const mcpServers = {};
         for (const server of this.serverConfigs)if ("stdio" === server.transport) {
             const stdioServer = server;
             const resolvedEnv = {};
             for (const [key, value] of Object.entries(stdioServer.env || {}))resolvedEnv[key] = resolveEnvValue(value);
-            clientConfig[server.name] = {
+            const runtimeEnv = this.applyRuntimeEnv(resolvedEnv);
+            const defaultToolTimeout = getDefaultToolTimeout(stdioServer);
+            mcpServers[server.name] = {
                 transport: "stdio",
                 command: stdioServer.command,
                 args: stdioServer.args || [],
-                env: resolvedEnv
+                env: runtimeEnv,
+                ...void 0 !== defaultToolTimeout ? {
+                    defaultToolTimeout
+                } : {}
             };
         } else if ("sse" === server.transport) {
             const sseServer = server;
-            clientConfig[server.name] = {
+            const defaultToolTimeout = getDefaultToolTimeout(sseServer);
+            mcpServers[server.name] = {
                 transport: "sse",
                 url: sseServer.url,
-                headers: sseServer.headers || {}
+                headers: sseServer.headers || {},
+                ...void 0 !== defaultToolTimeout ? {
+                    defaultToolTimeout
+                } : {}
             };
         }
-        return clientConfig;
+        return {
+            mcpServers,
+            useStandardContentBlocks: false,
+            outputHandling: {
+                image: "artifact",
+                audio: "artifact",
+                resource: "artifact"
+            }
+        };
+    }
+    applyRuntimeEnv(env) {
+        if (!this.executionWorkspace) return env;
+        const next = {
+            ...env
+        };
+        next.WINGMAN_WORKDIR = this.executionWorkspace;
+        return next;
     }
     async initialize() {
         if (0 === this.serverConfigs.length) return void this.logger.debug("No MCP servers configured");
@@ -117,7 +142,8 @@ class MCPClientManager {
             if (sanitized === original) return tool;
             const originalLabel = `Original tool name: ${original}`;
             const description = tool.description ? `${tool.description}\n\n${originalLabel}` : originalLabel;
-            const schema = tool.schema ?? tool.inputSchema;
+            const toolWithSchema = tool;
+            const schema = toolWithSchema.schema ?? toolWithSchema.inputSchema;
             if (!schema) try {
                 tool.name = sanitized;
                 tool.description = description;
@@ -128,7 +154,7 @@ class MCPClientManager {
             return (0, tools_namespaceObject.tool)(async (input)=>tool.invoke(input), {
                 name: sanitized,
                 description,
-                schema
+                schema: schema
             });
         });
     }
@@ -145,12 +171,14 @@ class MCPClientManager {
     hasServers() {
         return this.serverConfigs.length > 0;
     }
-    constructor(configs, logger){
+    constructor(configs, logger, options){
         _define_property(this, "client", null);
         _define_property(this, "logger", void 0);
         _define_property(this, "serverConfigs", void 0);
+        _define_property(this, "executionWorkspace", void 0);
         this.logger = logger;
         this.serverConfigs = this.mergeConfigs(configs);
+        this.executionWorkspace = options?.executionWorkspace?.trim() || null;
     }
 }
 function resolveEnvValue(value) {
@@ -159,6 +187,12 @@ function resolveEnvValue(value) {
     const envValue = process.env[match[1]];
     return envValue ?? "";
 }
+function getDefaultToolTimeout(server) {
+    const candidate = server.defaultToolTimeout;
+    if ("number" != typeof candidate) return;
+    if (!Number.isFinite(candidate) || candidate <= 0) return;
+    return Math.floor(candidate);
+}
 exports.MCPClientManager = __webpack_exports__.MCPClientManager;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "MCPClientManager"

package/dist/agent/config/mcpClientManager.d.ts

@@ -1,6 +1,6 @@
 import type { StructuredTool } from "@langchain/core/tools";
-import type { MCPServersConfig } from "@/types/mcp.js";
 import type { Logger } from "@/logger.js";
+import type { MCPServersConfig } from "@/types/mcp.js";
 /**
  * Manages MCP server connections and tool retrieval
  * Handles server lifecycle: initialization, tool loading, and cleanup
@@ -9,7 +9,10 @@ export declare class MCPClientManager {
     private client;
     private logger;
     private serverConfigs;
-    constructor(configs: MCPServersConfig[], logger: Logger);
+    private executionWorkspace;
+    constructor(configs: MCPServersConfig[], logger: Logger, options?: {
+        executionWorkspace?: string | null;
+    });
     /**
      * Merge multiple MCP configurations (global + agent-specific)
      * Agent-specific servers override global ones with same name
@@ -19,6 +22,7 @@ export declare class MCPClientManager {
      * Convert Wingman MCP config to MultiServerMCPClient format
      */
     private buildClientConfig;
+    private applyRuntimeEnv;
     /**
      * Initialize MCP client and connect to servers
      */

package/dist/agent/config/mcpClientManager.js

@@ -1,5 +1,5 @@
-import { MultiServerMCPClient } from "@langchain/mcp-adapters";
 import { tool as tools_tool } from "@langchain/core/tools";
+import { MultiServerMCPClient } from "@langchain/mcp-adapters";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -17,26 +17,51 @@ class MCPClientManager {
         return Array.from(serverMap.values());
     }
     buildClientConfig() {
-        const clientConfig = {};
+        const mcpServers = {};
         for (const server of this.serverConfigs)if ("stdio" === server.transport) {
             const stdioServer = server;
             const resolvedEnv = {};
             for (const [key, value] of Object.entries(stdioServer.env || {}))resolvedEnv[key] = resolveEnvValue(value);
-            clientConfig[server.name] = {
+            const runtimeEnv = this.applyRuntimeEnv(resolvedEnv);
+            const defaultToolTimeout = getDefaultToolTimeout(stdioServer);
+            mcpServers[server.name] = {
                 transport: "stdio",
                 command: stdioServer.command,
                 args: stdioServer.args || [],
-                env: resolvedEnv
+                env: runtimeEnv,
+                ...void 0 !== defaultToolTimeout ? {
+                    defaultToolTimeout
+                } : {}
             };
         } else if ("sse" === server.transport) {
             const sseServer = server;
-            clientConfig[server.name] = {
+            const defaultToolTimeout = getDefaultToolTimeout(sseServer);
+            mcpServers[server.name] = {
                 transport: "sse",
                 url: sseServer.url,
-                headers: sseServer.headers || {}
+                headers: sseServer.headers || {},
+                ...void 0 !== defaultToolTimeout ? {
+                    defaultToolTimeout
+                } : {}
             };
         }
-        return clientConfig;
+        return {
+            mcpServers,
+            useStandardContentBlocks: false,
+            outputHandling: {
+                image: "artifact",
+                audio: "artifact",
+                resource: "artifact"
+            }
+        };
+    }
+    applyRuntimeEnv(env) {
+        if (!this.executionWorkspace) return env;
+        const next = {
+            ...env
+        };
+        next.WINGMAN_WORKDIR = this.executionWorkspace;
+        return next;
     }
     async initialize() {
         if (0 === this.serverConfigs.length) return void this.logger.debug("No MCP servers configured");
@@ -89,7 +114,8 @@ class MCPClientManager {
             if (sanitized === original) return tool;
             const originalLabel = `Original tool name: ${original}`;
             const description = tool.description ? `${tool.description}\n\n${originalLabel}` : originalLabel;
-            const schema = tool.schema ?? tool.inputSchema;
+            const toolWithSchema = tool;
+            const schema = toolWithSchema.schema ?? toolWithSchema.inputSchema;
             if (!schema) try {
                 tool.name = sanitized;
                 tool.description = description;
@@ -100,7 +126,7 @@ class MCPClientManager {
             return tools_tool(async (input)=>tool.invoke(input), {
                 name: sanitized,
                 description,
-                schema
+                schema: schema
             });
         });
     }
@@ -117,12 +143,14 @@ class MCPClientManager {
     hasServers() {
         return this.serverConfigs.length > 0;
     }
-    constructor(configs, logger){
+    constructor(configs, logger, options){
         _define_property(this, "client", null);
         _define_property(this, "logger", void 0);
         _define_property(this, "serverConfigs", void 0);
+        _define_property(this, "executionWorkspace", void 0);
         this.logger = logger;
         this.serverConfigs = this.mergeConfigs(configs);
+        this.executionWorkspace = options?.executionWorkspace?.trim() || null;
     }
 }
 function resolveEnvValue(value) {
@@ -131,4 +159,10 @@ function resolveEnvValue(value) {
     const envValue = process.env[match[1]];
     return envValue ?? "";
 }
+function getDefaultToolTimeout(server) {
+    const candidate = server.defaultToolTimeout;
+    if ("number" != typeof candidate) return;
+    if (!Number.isFinite(candidate) || candidate <= 0) return;
+    return Math.floor(candidate);
+}
 export { MCPClientManager };

package/dist/agent/config/toolRegistry.cjs

@@ -31,6 +31,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_logger_cjs_namespaceObject = require("../../logger.cjs");
 const background_terminal_cjs_namespaceObject = require("../tools/background_terminal.cjs");
+const browser_control_cjs_namespaceObject = require("../tools/browser_control.cjs");
 const code_search_cjs_namespaceObject = require("../tools/code_search.cjs");
 const command_execute_cjs_namespaceObject = require("../tools/command_execute.cjs");
 const git_status_cjs_namespaceObject = require("../tools/git_status.cjs");
@@ -65,6 +66,21 @@ function createTool(name, options = {}) {
             return (0, internet_search_cjs_namespaceObject.createInternetSearchTool)(searchConfig);
         case "web_crawler":
             return web_crawler_cjs_namespaceObject.webCrawler;
+        case "browser_control":
+            return (0, browser_control_cjs_namespaceObject.createBrowserControlTool)({
+                workspace: runtimeWorkspace,
+                configWorkspace: workspace,
+                launchTimeoutMs: timeout,
+                browserProfile: options.browserProfile,
+                browserTransport: options.browserTransport,
+                profilesRootDir: options.browserProfilesDirectory,
+                profilePaths: options.browserProfiles,
+                browserExtensions: options.browserExtensions,
+                extensionsRootDir: options.browserExtensionsDirectory,
+                extensionPaths: options.browserExtensionsById,
+                defaultExtensions: options.browserDefaultExtensions,
+                relayConfig: options.browserRelay
+            });
         case "command_execute":
             return (0, command_execute_cjs_namespaceObject.createCommandExecuteTool)(runtimeWorkspace, process.env, blockedCommands, allowScriptExecution, timeout);
         case "background_terminal":
@@ -102,7 +118,9 @@ async function createTools(toolNames, options = {}) {
         else logger.warn(`Skipping unknown tool: ${name}`);
     }
     if (options.mcpConfigs && options.mcpConfigs.length > 0) try {
-        const mcpManager = new external_mcpClientManager_cjs_namespaceObject.MCPClientManager(options.mcpConfigs, logger);
+        const mcpManager = new external_mcpClientManager_cjs_namespaceObject.MCPClientManager(options.mcpConfigs, logger, {
+            executionWorkspace: options.executionWorkspace || options.workspace || null
+        });
         await mcpManager.initialize();
         const mcpTools = await mcpManager.getTools();
         if (mcpTools.length > 0) {
@@ -119,6 +137,7 @@ function getAvailableTools() {
     return [
         "internet_search",
         "web_crawler",
+        "browser_control",
         "command_execute",
         "background_terminal",
         "think",

package/dist/agent/config/toolRegistry.d.ts

@@ -9,6 +9,21 @@ export interface ToolOptions {
     blockedCommands?: string[];
     allowScriptExecution?: boolean;
     timeout?: number;
+    browserProfile?: string;
+    browserTransport?: "auto" | "playwright" | "relay";
+    browserProfilesDirectory?: string;
+    browserProfiles?: Record<string, string>;
+    browserExtensions?: string[];
+    browserExtensionsDirectory?: string;
+    browserExtensionsById?: Record<string, string>;
+    browserDefaultExtensions?: string[];
+    browserRelay?: {
+        enabled?: boolean;
+        host?: string;
+        port?: number;
+        requireAuth?: boolean;
+        authToken?: string;
+    };
     terminalOwnerId?: string;
     terminalSessionManager?: TerminalSessionManager;
     searchConfig?: SearchConfig;

package/dist/agent/config/toolRegistry.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../../logger.js";
 import { createBackgroundTerminalTool } from "../tools/background_terminal.js";
+import { createBrowserControlTool } from "../tools/browser_control.js";
 import { createCodeSearchTool } from "../tools/code_search.js";
 import { createCommandExecuteTool } from "../tools/command_execute.js";
 import { createGitStatusTool } from "../tools/git_status.js";
@@ -34,6 +35,21 @@ function createTool(name, options = {}) {
             return createInternetSearchTool(searchConfig);
         case "web_crawler":
             return webCrawler;
+        case "browser_control":
+            return createBrowserControlTool({
+                workspace: runtimeWorkspace,
+                configWorkspace: workspace,
+                launchTimeoutMs: timeout,
+                browserProfile: options.browserProfile,
+                browserTransport: options.browserTransport,
+                profilesRootDir: options.browserProfilesDirectory,
+                profilePaths: options.browserProfiles,
+                browserExtensions: options.browserExtensions,
+                extensionsRootDir: options.browserExtensionsDirectory,
+                extensionPaths: options.browserExtensionsById,
+                defaultExtensions: options.browserDefaultExtensions,
+                relayConfig: options.browserRelay
+            });
         case "command_execute":
             return createCommandExecuteTool(runtimeWorkspace, process.env, blockedCommands, allowScriptExecution, timeout);
         case "background_terminal":
@@ -71,7 +87,9 @@ async function createTools(toolNames, options = {}) {
         else logger.warn(`Skipping unknown tool: ${name}`);
     }
     if (options.mcpConfigs && options.mcpConfigs.length > 0) try {
-        const mcpManager = new MCPClientManager(options.mcpConfigs, logger);
+        const mcpManager = new MCPClientManager(options.mcpConfigs, logger, {
+            executionWorkspace: options.executionWorkspace || options.workspace || null
+        });
         await mcpManager.initialize();
         const mcpTools = await mcpManager.getTools();
         if (mcpTools.length > 0) {
@@ -88,6 +106,7 @@ function getAvailableTools() {
     return [
         "internet_search",
         "web_crawler",
+        "browser_control",
         "command_execute",
         "background_terminal",
         "think",

package/dist/agent/tests/agentConfig.test.cjs

@@ -34,7 +34,9 @@ const agentConfig_cjs_namespaceObject = require("../config/agentConfig.cjs");
                     "mv"
                 ],
                 allowScriptExecution: true,
-                commandTimeout: 300000
+                commandTimeout: 300000,
+                browserProfile: "trading",
+                browserTransport: "relay"
             };
             const result = (0, agentConfig_cjs_namespaceObject.validateAgentConfig)(config);
             (0, external_vitest_namespaceObject.expect)(result.success).toBe(true);
@@ -51,6 +53,8 @@ const agentConfig_cjs_namespaceObject = require("../config/agentConfig.cjs");
                 ]);
                 (0, external_vitest_namespaceObject.expect)(result.data.allowScriptExecution).toBe(true);
                 (0, external_vitest_namespaceObject.expect)(result.data.commandTimeout).toBe(300000);
+                (0, external_vitest_namespaceObject.expect)(result.data.browserProfile).toBe("trading");
+                (0, external_vitest_namespaceObject.expect)(result.data.browserTransport).toBe("relay");
             }
         });
         (0, external_vitest_namespaceObject.it)("should allow subagents to override models", ()=>{
@@ -189,6 +193,7 @@ const agentConfig_cjs_namespaceObject = require("../config/agentConfig.cjs");
             const validTools = [
                 "internet_search",
                 "web_crawler",
+                "browser_control",
                 "command_execute",
                 "background_terminal",
                 "think",

package/dist/agent/tests/agentConfig.test.js

@@ -32,7 +32,9 @@ describe("Agent Configuration Schema", ()=>{
                     "mv"
                 ],
                 allowScriptExecution: true,
-                commandTimeout: 300000
+                commandTimeout: 300000,
+                browserProfile: "trading",
+                browserTransport: "relay"
             };
             const result = validateAgentConfig(config);
             expect(result.success).toBe(true);
@@ -49,6 +51,8 @@ describe("Agent Configuration Schema", ()=>{
                 ]);
                 expect(result.data.allowScriptExecution).toBe(true);
                 expect(result.data.commandTimeout).toBe(300000);
+                expect(result.data.browserProfile).toBe("trading");
+                expect(result.data.browserTransport).toBe("relay");
             }
         });
         it("should allow subagents to override models", ()=>{
@@ -187,6 +191,7 @@ describe("Agent Configuration Schema", ()=>{
             const validTools = [
                 "internet_search",
                 "web_crawler",
+                "browser_control",
                 "command_execute",
                 "background_terminal",
                 "think",