ultimate-playwright-mcp 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,122 @@
+/**
+ * MCP server implementation with Playwright browser control via CDP
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { DaemonManager } from "../daemon/manager.js";
+import { registerBrowserTabsTool } from "./tools/tabs.js";
+import { registerBrowserNavigateTool } from "./tools/navigate.js";
+import { registerBrowserSnapshotTool } from "./tools/snapshot.js";
+import { registerBrowserActionTools } from "./tools/actions.js";
+import { registerBrowserTabGroupTool } from "./tools/tab-group.js";
+import { warmupTabGrouper, seedExtensionIdFromPath } from "../browser/chrome-tab-groups.js";
+import { existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+export async function createMCPServer(config) {
+    const server = new Server({
+        name: "ultimate-playwright-mcp",
+        version: "0.1.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Tool registry
+    const tools = new Map();
+    // Helper to register tools
+    function registerTool(name, description, inputSchema, handler) {
+        tools.set(name, { description, inputSchema, handler });
+    }
+    // Register all tools
+    registerBrowserTabGroupTool(registerTool, config);
+    registerBrowserTabsTool(registerTool, config);
+    registerBrowserNavigateTool(registerTool, config);
+    registerBrowserSnapshotTool(registerTool, config);
+    registerBrowserActionTools(registerTool, config);
+    // List tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: Array.from(tools.entries()).map(([name, tool]) => ({
+                name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    // Call tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = tools.get(name);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        try {
+            const result = await tool.handler(args || {});
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+export async function runServer(config) {
+    // Ensure Chrome daemon is running (auto-start if needed)
+    if (!config.cdpEndpoint) {
+        await DaemonManager.ensureDaemonRunning({
+            chromeUserDataDir: config.chromeUserDataDir,
+            chromeExtensions: config.chromeExtensions,
+            chromeExecutable: config.chromeExecutable,
+        });
+        config.cdpEndpoint = DaemonManager.getCdpEndpoint();
+    }
+    const server = await createMCPServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Seed the companion extension ID so we can wake it when its SW goes dormant.
+    // Look for the bundled extension relative to this file, or in the configured extensions.
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const bundledExtPath = join(__dirname, "..", "..", "extensions", "tab-grouper");
+    if (existsSync(bundledExtPath)) {
+        seedExtensionIdFromPath(bundledExtPath);
+    }
+    // Also check if it's in the configured extensions list
+    if (config.chromeExtensions) {
+        for (const ext of config.chromeExtensions) {
+            if (ext.includes("tab-grouper") && existsSync(ext)) {
+                seedExtensionIdFromPath(ext);
+                break;
+            }
+        }
+    }
+    // Warm up: discover companion extension while its SW is still alive
+    if (config.cdpEndpoint) {
+        warmupTabGrouper(config.cdpEndpoint).catch(() => { });
+    }
+    // Log to stderr so it doesn't interfere with stdio transport
+    console.error("Ultimate Playwright MCP server running on stdio");
+    if (config.agentId) {
+        console.error(`Agent ID: ${config.agentId}`);
+    }
+    console.error(`CDP Endpoint: ${config.cdpEndpoint}`);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/actions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser action tools - click, type, hover, etc.
+ */
+import type { ServerConfig } from "../../config.js";
+export declare function registerBrowserActionTools(register: (name: string, description: string, schema: any, handler: (args: any) => Promise<any>) => void, config: ServerConfig): void;
+//# sourceMappingURL=actions.d.ts.map

package/dist/mcp/tools/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWpD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EACxG,MAAM,EAAE,YAAY,QAmQrB"}

package/dist/mcp/tools/actions.js

@@ -0,0 +1,214 @@
+/**
+ * Browser action tools - click, type, hover, etc.
+ */
+import { clickViaPlaywright, typeViaPlaywright, hoverViaPlaywright, pressKeyViaPlaywright, fillFormViaPlaywright, waitForViaPlaywright, } from "../../browser/pw-tools-interactions.js";
+export function registerBrowserActionTools(register, config) {
+    // browser_click
+    register("browser_click", "Click an element by its ref (e1, e2, etc. from snapshot)", {
+        type: "object",
+        properties: {
+            ref: {
+                type: "string",
+                description: "Element reference from snapshot (e.g., 'e1', 'e2')",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+            button: {
+                type: "string",
+                enum: ["left", "right", "middle"],
+                description: "Mouse button to click (default: left)",
+            },
+            doubleClick: {
+                type: "boolean",
+                description: "Perform a double-click",
+            },
+        },
+        required: ["ref"],
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await clickViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            ref: args.ref,
+            button: args.button,
+            doubleClick: args.doubleClick,
+        });
+        return `**Clicked** element ${args.ref}`;
+    });
+    // browser_type
+    register("browser_type", "Type text into an element", {
+        type: "object",
+        properties: {
+            ref: {
+                type: "string",
+                description: "Element reference from snapshot",
+            },
+            text: {
+                type: "string",
+                description: "Text to type",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+            submit: {
+                type: "boolean",
+                description: "Press Enter after typing",
+            },
+        },
+        required: ["ref", "text"],
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await typeViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            ref: args.ref,
+            text: args.text,
+            submit: args.submit,
+        });
+        return `**Typed** "${args.text}" into ${args.ref}`;
+    });
+    // browser_hover
+    register("browser_hover", "Hover over an element", {
+        type: "object",
+        properties: {
+            ref: {
+                type: "string",
+                description: "Element reference from snapshot",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+        },
+        required: ["ref"],
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await hoverViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            ref: args.ref,
+        });
+        return `**Hovered** over ${args.ref}`;
+    });
+    // browser_press_key
+    register("browser_press_key", "Press a keyboard key", {
+        type: "object",
+        properties: {
+            key: {
+                type: "string",
+                description: "Key to press (e.g., 'Enter', 'Escape', 'ArrowDown')",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+        },
+        required: ["key"],
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await pressKeyViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            key: args.key,
+        });
+        return `**Pressed** key: ${args.key}`;
+    });
+    // browser_fill_form
+    register("browser_fill_form", "Fill multiple form fields at once", {
+        type: "object",
+        properties: {
+            fields: {
+                type: "array",
+                description: "Array of form fields to fill",
+                items: {
+                    type: "object",
+                    properties: {
+                        ref: { type: "string" },
+                        type: { type: "string" },
+                        value: { type: ["string", "number", "boolean"] },
+                    },
+                    required: ["ref", "type"],
+                },
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+        },
+        required: ["fields"],
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await fillFormViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            fields: args.fields,
+        });
+        return `**Filled** ${args.fields.length} form field(s)`;
+    });
+    // browser_wait_for
+    register("browser_wait_for", "Wait for a condition (text, selector, load state, time, etc.)", {
+        type: "object",
+        properties: {
+            text: {
+                type: "string",
+                description: "Wait for text to appear on page",
+            },
+            textGone: {
+                type: "string",
+                description: "Wait for text to disappear from page",
+            },
+            selector: {
+                type: "string",
+                description: "Wait for CSS selector",
+            },
+            url: {
+                type: "string",
+                description: "Wait for URL to match pattern",
+            },
+            loadState: {
+                type: "string",
+                enum: ["load", "domcontentloaded", "networkidle"],
+                description: "Wait for load state",
+            },
+            timeMs: {
+                type: "number",
+                description: "Wait for specific milliseconds",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab",
+            },
+        },
+    }, async (args) => {
+        if (!config.cdpEndpoint)
+            throw new Error("CDP endpoint not configured");
+        await waitForViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            text: args.text,
+            textGone: args.textGone,
+            selector: args.selector,
+            url: args.url,
+            loadState: args.loadState,
+            timeMs: args.timeMs,
+        });
+        const conditions = [
+            args.text && `text: "${args.text}"`,
+            args.textGone && `text gone: "${args.textGone}"`,
+            args.selector && `selector: ${args.selector}`,
+            args.url && `URL: ${args.url}`,
+            args.loadState && `load state: ${args.loadState}`,
+            args.timeMs && `${args.timeMs}ms`,
+        ].filter(Boolean);
+        return `**Wait completed** for ${conditions.join(", ")}`;
+    });
+}
+//# sourceMappingURL=actions.js.map

package/dist/mcp/tools/actions.js.map

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

package/dist/mcp/tools/navigate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * browser_navigate tool - navigate to URLs in specific tabs
+ */
+import type { ServerConfig } from "../../config.js";
+export declare function registerBrowserNavigateTool(register: (name: string, description: string, schema: any, handler: (args: any) => Promise<any>) => void, config: ServerConfig): void;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/mcp/tools/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EACxG,MAAM,EAAE,YAAY,QAiCrB"}

package/dist/mcp/tools/navigate.js

@@ -0,0 +1,31 @@
+/**
+ * browser_navigate tool - navigate to URLs in specific tabs
+ */
+import { navigateViaPlaywright } from "../../browser/pw-tools-snapshot.js";
+export function registerBrowserNavigateTool(register, config) {
+    register("browser_navigate", "Navigate to a URL in a specific tab. Use targetId from browser_tabs to specify which tab.", {
+        type: "object",
+        properties: {
+            url: {
+                type: "string",
+                description: "URL to navigate to",
+            },
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab (from browser_tabs). If not provided, uses first available tab.",
+            },
+        },
+        required: ["url"],
+    }, async (args) => {
+        if (!config.cdpEndpoint) {
+            throw new Error("CDP endpoint not configured");
+        }
+        const result = await navigateViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+            url: args.url,
+        });
+        return `**Navigation successful**\\nURL: ${result.url}`;
+    });
+}
+//# sourceMappingURL=navigate.js.map

package/dist/mcp/tools/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../../src/mcp/tools/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,UAAU,2BAA2B,CACzC,QAAwG,EACxG,MAAoB;IAEpB,QAAQ,CACN,kBAAkB,EAClB,2FAA2F,EAC3F;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB,EACD,KAAK,EAAE,IAAwC,EAAE,EAAE;QACjD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;YACzC,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;QAEH,OAAO,oCAAoC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1D,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/snapshot.d.ts

@@ -0,0 +1,6 @@
+/**
+ * browser_snapshot tool - capture accessibility tree snapshot with element refs
+ */
+import type { ServerConfig } from "../../config.js";
+export declare function registerBrowserSnapshotTool(register: (name: string, description: string, schema: any, handler: (args: any) => Promise<any>) => void, config: ServerConfig): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/mcp/tools/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EACxG,MAAM,EAAE,YAAY,QA4BrB"}

package/dist/mcp/tools/snapshot.js

@@ -0,0 +1,26 @@
+/**
+ * browser_snapshot tool - capture accessibility tree snapshot with element refs
+ */
+import { snapshotRoleViaPlaywright } from "../../browser/pw-tools-snapshot.js";
+export function registerBrowserSnapshotTool(register, config) {
+    register("browser_snapshot", "Capture accessibility tree snapshot of the current page. Returns element references (e1, e2, etc.) " +
+        "that can be used with other browser tools like click, type, etc.", {
+        type: "object",
+        properties: {
+            targetId: {
+                type: "string",
+                description: "Target ID of the tab (from browser_tabs). If not provided, uses first available tab.",
+            },
+        },
+    }, async (args) => {
+        if (!config.cdpEndpoint) {
+            throw new Error("CDP endpoint not configured");
+        }
+        const result = await snapshotRoleViaPlaywright({
+            cdpUrl: config.cdpEndpoint,
+            targetId: args.targetId,
+        });
+        return result.snapshot;
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/mcp/tools/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/mcp/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,MAAM,UAAU,2BAA2B,CACzC,QAAwG,EACxG,MAAoB;IAEpB,QAAQ,CACN,kBAAkB,EAClB,qGAAqG;QACrG,kEAAkE,EAClE;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sFAAsF;aACpG;SACF;KACF,EACD,KAAK,EAAE,IAA2B,EAAE,EAAE;QACpC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/tab-group.d.ts

@@ -0,0 +1,9 @@
+/**
+ * browser_tab_group tool — manage tab groups for multi-user isolation.
+ *
+ * Each session should create a tab group first, then use the groupId
+ * with browser_tabs and other tools to stay isolated.
+ */
+import type { ServerConfig } from "../../config.js";
+export declare function registerBrowserTabGroupTool(register: (name: string, description: string, schema: any, handler: (args: any) => Promise<any>) => void, config: ServerConfig): void;
+//# sourceMappingURL=tab-group.d.ts.map

package/dist/mcp/tools/tab-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-group.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/tab-group.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmBpD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,KACjC,IAAI,EACT,MAAM,EAAE,YAAY,QA6MrB"}

package/dist/mcp/tools/tab-group.js

@@ -0,0 +1,173 @@
+/**
+ * browser_tab_group tool — manage tab groups for multi-user isolation.
+ *
+ * Each session should create a tab group first, then use the groupId
+ * with browser_tabs and other tools to stay isolated.
+ */
+import { createTabGroup, listTabGroups, deleteTabGroup, pruneStaleTargets, getTabGroup, } from "../../browser/tab-groups.js";
+import { listPagesViaPlaywright, closePageByTargetIdViaPlaywright, } from "../../browser/pw-session.js";
+import { isTabGrouperAvailable, ungroupTabsVisually, mapTargetIdsToChromeTabIds, listVisualTabGroups, } from "../../browser/chrome-tab-groups.js";
+export function registerBrowserTabGroupTool(register, config) {
+    register("browser_tab_group", "Manage tab groups for session isolation. Multiple users/agents sharing one browser " +
+        "MUST create a tab group first, then pass the groupId to browser_tabs and other tools. " +
+        "This ensures each session only sees and controls its own tabs.\n\n" +
+        "Actions:\n" +
+        "- 'create': Create a new tab group. Returns a groupId to use with all other browser tools.\n" +
+        "- 'list': List all tab groups with tab counts.\n" +
+        "- 'delete': Delete a tab group and optionally close its tabs.\n\n" +
+        "⚡ IMPORTANT: Always create a tab group before opening tabs with browser_tabs.", {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["create", "list", "delete"],
+                description: "Tab group action to perform",
+            },
+            name: {
+                type: "string",
+                description: "Human-readable name for the group (for 'create' action)",
+            },
+            color: {
+                type: "string",
+                enum: ["grey", "blue", "red", "yellow", "green", "pink", "purple", "cyan"],
+                description: "Visual color for the group (for 'create' action)",
+            },
+            groupId: {
+                type: "string",
+                description: "Group ID (for 'delete' action)",
+            },
+            closeTabs: {
+                type: "boolean",
+                description: "Whether to close all tabs in the group when deleting (default: true)",
+            },
+        },
+        required: ["action"],
+    }, async (args) => {
+        if (!config.cdpEndpoint) {
+            throw new Error("CDP endpoint not configured");
+        }
+        const { action } = args;
+        switch (action) {
+            case "create": {
+                if (!args.name) {
+                    throw new Error("'name' is required for create action");
+                }
+                const group = createTabGroup({
+                    name: args.name,
+                    color: args.color,
+                });
+                // Check if visual grouping is available
+                let visualNote = "";
+                const hasExtension = await isTabGrouperAvailable(config.cdpEndpoint);
+                if (hasExtension) {
+                    visualNote =
+                        "\nVisual grouping: ✅ Tabs will appear in a Chrome tab group.";
+                }
+                else {
+                    visualNote =
+                        "\nVisual grouping: ⚠️ Companion extension not loaded. " +
+                            "Tabs are logically isolated but won't show as a Chrome tab group. " +
+                            "Load with: --chrome-extensions extensions/tab-grouper";
+                }
+                return (`**Tab group created**\n` +
+                    `**groupId: ${group.groupId}** ← Use this with browser_tabs and other tools\n` +
+                    `Name: ${group.name}\n` +
+                    (group.color ? `Color: ${group.color}\n` : "") +
+                    visualNote +
+                    `\nNext step: Use browser_tabs with groupId="${group.groupId}" to create tabs in this group.`);
+            }
+            case "list": {
+                // Prune stale targets first
+                try {
+                    const liveTabs = await listPagesViaPlaywright({
+                        cdpUrl: config.cdpEndpoint,
+                    });
+                    const liveIds = new Set(liveTabs.map((t) => t.targetId));
+                    pruneStaleTargets(liveIds);
+                }
+                catch {
+                    // Pruning is best-effort
+                }
+                const groups = listTabGroups();
+                if (groups.length === 0) {
+                    return "**No tab groups exist.**\nCreate one with browser_tab_group({ action: 'create', name: '...' })";
+                }
+                // Check for visual groups
+                let visualGroups = [];
+                try {
+                    visualGroups = await listVisualTabGroups(config.cdpEndpoint);
+                }
+                catch {
+                    // Extension not available
+                }
+                const output = groups
+                    .map((g) => {
+                    const visual = g.chromeGroupId
+                        ? visualGroups.find((vg) => vg.id === g.chromeGroupId)
+                        : null;
+                    const visualLabel = visual
+                        ? ` | Chrome group: ${visual.title} (${visual.color})`
+                        : "";
+                    return (`• **${g.name}** (${g.groupId})\n` +
+                        `  Tabs: ${g.tabCount} | Color: ${g.color || "none"} | Created: ${new Date(g.createdAt).toISOString()}${visualLabel}`);
+                })
+                    .join("\n\n");
+                return `**${groups.length} tab group(s)**\n\n${output}`;
+            }
+            case "delete": {
+                if (!args.groupId) {
+                    throw new Error("'groupId' is required for delete action");
+                }
+                const closeTabs = args.closeTabs !== false; // default true
+                // Before deleting, try to ungroup tabs visually
+                const group = getTabGroup(args.groupId);
+                const { removedTargetIds } = deleteTabGroup(args.groupId);
+                if (closeTabs && removedTargetIds.length > 0) {
+                    // Try visual ungrouping first (before closing)
+                    if (group?.chromeGroupId) {
+                        try {
+                            const liveTabs = await listPagesViaPlaywright({
+                                cdpUrl: config.cdpEndpoint,
+                            });
+                            const toUngroup = liveTabs.filter((t) => removedTargetIds.includes(t.targetId));
+                            if (toUngroup.length > 0) {
+                                const idMap = await mapTargetIdsToChromeTabIds(config.cdpEndpoint, toUngroup);
+                                const chromeIds = [...idMap.values()];
+                                if (chromeIds.length > 0) {
+                                    await ungroupTabsVisually(config.cdpEndpoint, chromeIds);
+                                }
+                            }
+                        }
+                        catch {
+                            // Visual ungrouping is best-effort
+                        }
+                    }
+                    const closeResults = [];
+                    for (const targetId of removedTargetIds) {
+                        try {
+                            await closePageByTargetIdViaPlaywright({
+                                cdpUrl: config.cdpEndpoint,
+                                targetId,
+                            });
+                            closeResults.push(`  ✓ Closed ${targetId}`);
+                        }
+                        catch {
+                            closeResults.push(`  ✗ Could not close ${targetId} (may already be closed)`);
+                        }
+                    }
+                    return (`**Tab group deleted:** ${args.groupId}\n` +
+                        `**${removedTargetIds.length} tab(s) removed:**\n` +
+                        closeResults.join("\n"));
+                }
+                return (`**Tab group deleted:** ${args.groupId}\n` +
+                    `Tabs removed from registry: ${removedTargetIds.length}` +
+                    (!closeTabs && removedTargetIds.length > 0
+                        ? " (tabs left open in browser)"
+                        : ""));
+            }
+            default:
+                throw new Error(`Unknown action: ${action}. Use 'create', 'list', or 'delete'.`);
+        }
+    });
+}
+//# sourceMappingURL=tab-group.js.map