@wingman-ai/gateway 0.3.0 → 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

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>;
@@ -131,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";
@@ -150,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>;

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/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":
@@ -121,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":
@@ -90,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",

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

@@ -0,0 +1,35 @@
+"use strict";
+var __webpack_exports__ = {};
+const external_node_fs_namespaceObject = require("node:fs");
+const external_node_os_namespaceObject = require("node:os");
+const external_node_path_namespaceObject = require("node:path");
+const external_vitest_namespaceObject = require("vitest");
+const browser_control_cjs_namespaceObject = require("../tools/browser_control.cjs");
+(0, external_vitest_namespaceObject.describe)("browser_control helpers", ()=>{
+    const tempDirs = [];
+    (0, external_vitest_namespaceObject.afterEach)(()=>{
+        for (const dir of tempDirs)(0, external_node_fs_namespaceObject.rmSync)(dir, {
+            recursive: true,
+            force: true
+        });
+        tempDirs.length = 0;
+    });
+    (0, external_vitest_namespaceObject.it)("removes stale DevToolsActivePort before launch", ()=>{
+        const userDataDir = (0, external_node_fs_namespaceObject.mkdtempSync)((0, external_node_path_namespaceObject.join)((0, external_node_os_namespaceObject.tmpdir)(), "wingman-browser-profile-"));
+        tempDirs.push(userDataDir);
+        const activePortPath = (0, external_node_path_namespaceObject.join)(userDataDir, "DevToolsActivePort");
+        (0, external_node_fs_namespaceObject.writeFileSync)(activePortPath, "52145\n/devtools/browser/stale");
+        (0, external_vitest_namespaceObject.expect)((0, external_node_fs_namespaceObject.existsSync)(activePortPath)).toBe(true);
+        (0, browser_control_cjs_namespaceObject.clearStaleDevtoolsArtifacts)(userDataDir);
+        (0, external_vitest_namespaceObject.expect)((0, external_node_fs_namespaceObject.existsSync)(activePortPath)).toBe(false);
+    });
+    (0, external_vitest_namespaceObject.it)("does not throw when DevToolsActivePort is absent", ()=>{
+        const userDataDir = (0, external_node_fs_namespaceObject.mkdtempSync)((0, external_node_path_namespaceObject.join)((0, external_node_os_namespaceObject.tmpdir)(), "wingman-browser-profile-"));
+        tempDirs.push(userDataDir);
+        (0, external_vitest_namespaceObject.expect)(()=>(0, browser_control_cjs_namespaceObject.clearStaleDevtoolsArtifacts)(userDataDir)).not.toThrow();
+    });
+});
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/agent/tests/browserControlHelpers.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,29 @@
+import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { clearStaleDevtoolsArtifacts } from "../tools/browser_control.js";
+describe("browser_control helpers", ()=>{
+    const tempDirs = [];
+    afterEach(()=>{
+        for (const dir of tempDirs)rmSync(dir, {
+            recursive: true,
+            force: true
+        });
+        tempDirs.length = 0;
+    });
+    it("removes stale DevToolsActivePort before launch", ()=>{
+        const userDataDir = mkdtempSync(join(tmpdir(), "wingman-browser-profile-"));
+        tempDirs.push(userDataDir);
+        const activePortPath = join(userDataDir, "DevToolsActivePort");
+        writeFileSync(activePortPath, "52145\n/devtools/browser/stale");
+        expect(existsSync(activePortPath)).toBe(true);
+        clearStaleDevtoolsArtifacts(userDataDir);
+        expect(existsSync(activePortPath)).toBe(false);
+    });
+    it("does not throw when DevToolsActivePort is absent", ()=>{
+        const userDataDir = mkdtempSync(join(tmpdir(), "wingman-browser-profile-"));
+        tempDirs.push(userDataDir);
+        expect(()=>clearStaleDevtoolsArtifacts(userDataDir)).not.toThrow();
+    });
+});