@eddym06/custom-chrome-mcp 1.0.4 → 1.1.0

package/dist/tools/network-accessibility.js

@@ -0,0 +1,367 @@
+/**
+ * Network Interception and Accessibility Tools
+ */
+import { z } from 'zod';
+import { withTimeout } from '../utils/helpers.js';
+// Store for intercepted requests (per tab)
+const interceptedRequests = new Map();
+export function createNetworkAccessibilityTools(connector) {
+    return [
+        // Enable network interception
+        {
+            name: 'enable_network_interception',
+            description: '🔒 Enables REQUEST interception (modify/block requests before they send). USE THIS WHEN: 1️⃣ Modifying request URLs (redirect API calls). 2️⃣ Changing request headers/method (test API variations). 3️⃣ Blocking specific resources (speed testing without ads). WORKFLOW: enable_network_interception → list_intercepted_requests → modify_intercepted_request/fail_intercepted_request. DIFFERENT FROM: enable_response_interception (responses, not requests). PATTERNS: ["*"] = all, ["*.js"] = JS only.',
+            inputSchema: z.object({
+                patterns: z.array(z.string()).default(['*']).describe('URL patterns to intercept (e.g., ["*.js", "*.css", "*api*"]). Use "*" for all requests.'),
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ patterns = ['*'], tabId }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Network, Fetch } = client;
+                // Enable Network domain
+                await Network.enable();
+                // Enable Fetch domain for interception
+                await Fetch.enable({
+                    patterns: patterns.map((pattern) => ({
+                        urlPattern: pattern,
+                        requestStage: 'Request'
+                    }))
+                });
+                // Initialize storage for this tab
+                const effectiveTabId = tabId || 'default';
+                if (!interceptedRequests.has(effectiveTabId)) {
+                    interceptedRequests.set(effectiveTabId, new Map());
+                }
+                // Listen for intercepted requests
+                Fetch.requestPaused((params) => {
+                    const requests = interceptedRequests.get(effectiveTabId);
+                    requests.set(params.requestId, params);
+                });
+                return {
+                    success: true,
+                    message: `Network interception enabled for patterns: ${patterns.join(', ')}`,
+                    interceptedCount: 0
+                };
+            }
+        },
+        // List intercepted requests
+        {
+            name: 'list_intercepted_requests',
+            description: '📝 Lists paused requests (after enable_network_interception). USE THIS WHEN: 1️⃣ After enable_network_interception (see what\'s paused). 2️⃣ Getting requestId for modification/blocking. 3️⃣ Checking request details (URL, method, headers). PREREQUISITE: enable_network_interception must be called first. RETURNS: Array with requestId, URL, method, resourceType. NEXT STEPS: Use requestId with modify_intercepted_request, fail_intercepted_request, or continue_intercepted_request.',
+            inputSchema: z.object({
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ tabId }) => {
+                await connector.verifyConnection();
+                const effectiveTabId = tabId || 'default';
+                const requests = interceptedRequests.get(effectiveTabId);
+                if (!requests || requests.size === 0) {
+                    return {
+                        success: true,
+                        interceptedRequests: [],
+                        count: 0,
+                        message: 'No requests currently intercepted. Use enable_network_interception first.'
+                    };
+                }
+                const requestList = Array.from(requests.values()).map((req) => ({
+                    requestId: req.requestId,
+                    url: req.request.url,
+                    method: req.request.method,
+                    resourceType: req.resourceType,
+                    headers: req.request.headers
+                }));
+                return {
+                    success: true,
+                    interceptedRequests: requestList,
+                    count: requestList.length
+                };
+            }
+        },
+        // Modify and continue intercepted request
+        {
+            name: 'modify_intercepted_request',
+            description: '✏️ Modifies paused request before sending. USE THIS WHEN: 1️⃣ Redirecting request (change URL to different API). 2️⃣ Modifying headers (add auth token, change User-Agent). 3️⃣ Changing HTTP method (POST → GET for testing). 4️⃣ Testing API variations (modify request body). PREREQUISITE: Get requestId from list_intercepted_requests. PARAMETERS: All optional - only provide what needs changing. EFFECT: Modified request sent to server.',
+            inputSchema: z.object({
+                requestId: z.string().describe('Request ID from list_intercepted_requests'),
+                modifiedUrl: z.string().optional().describe('New URL to request'),
+                modifiedMethod: z.string().optional().describe('New HTTP method (GET, POST, etc.)'),
+                modifiedHeaders: z.record(z.string()).optional().describe('New/modified headers'),
+                modifiedPostData: z.string().optional().describe('New POST body data'),
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ requestId, modifiedUrl, modifiedMethod, modifiedHeaders, modifiedPostData, tabId }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Fetch } = client;
+                const effectiveTabId = tabId || 'default';
+                const requests = interceptedRequests.get(effectiveTabId);
+                const originalRequest = requests?.get(requestId);
+                if (!originalRequest) {
+                    throw new Error(`Request ${requestId} not found. It may have already been processed.`);
+                }
+                // Prepare modified headers
+                let headers;
+                if (modifiedHeaders) {
+                    headers = Object.entries(modifiedHeaders).map(([name, value]) => ({ name, value }));
+                }
+                // Continue request with modifications
+                await Fetch.continueRequest({
+                    requestId,
+                    url: modifiedUrl,
+                    method: modifiedMethod,
+                    headers,
+                    postData: modifiedPostData
+                });
+                // Remove from pending requests
+                requests?.delete(requestId);
+                return {
+                    success: true,
+                    message: `Request ${requestId} modified and continued`,
+                    originalUrl: originalRequest.request.url,
+                    modifiedUrl: modifiedUrl || originalRequest.request.url
+                };
+            }
+        },
+        // Fail intercepted request
+        {
+            name: 'fail_intercepted_request',
+            description: '⛔ Blocks intercepted request (network error). USE THIS WHEN: 1️⃣ Simulating network failures (test offline behavior). 2️⃣ Blocking ads/trackers (prevent resource load). 3️⃣ Testing error handling (force API failure). 4️⃣ Speed testing (block slow resources). PREREQUISITE: Get requestId from list_intercepted_requests. ERROR REASONS: Failed, Aborted, TimedOut, AccessDenied, ConnectionClosed, ConnectionReset, ConnectionRefused. EFFECT: Request fails as if network error occurred.',
+            inputSchema: z.object({
+                requestId: z.string().describe('Request ID from list_intercepted_requests'),
+                errorReason: z.enum([
+                    'Failed',
+                    'Aborted',
+                    'TimedOut',
+                    'AccessDenied',
+                    'ConnectionClosed',
+                    'ConnectionReset',
+                    'ConnectionRefused',
+                    'ConnectionAborted',
+                    'ConnectionFailed',
+                    'NameNotResolved',
+                    'InternetDisconnected',
+                    'AddressUnreachable',
+                    'BlockedByClient',
+                    'BlockedByResponse'
+                ]).default('Failed').describe('Reason for failing the request'),
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ requestId, errorReason = 'Failed', tabId }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Fetch } = client;
+                const effectiveTabId = tabId || 'default';
+                const requests = interceptedRequests.get(effectiveTabId);
+                const originalRequest = requests?.get(requestId);
+                if (!originalRequest) {
+                    throw new Error(`Request ${requestId} not found. It may have already been processed.`);
+                }
+                // Fail the request
+                await Fetch.failRequest({
+                    requestId,
+                    errorReason
+                });
+                // Remove from pending requests
+                requests?.delete(requestId);
+                return {
+                    success: true,
+                    message: `Request ${requestId} failed with reason: ${errorReason}`,
+                    url: originalRequest.request.url
+                };
+            }
+        },
+        // Continue intercepted request (without modifications)
+        {
+            name: 'continue_intercepted_request',
+            description: '▶️ Continues paused request without changes. USE THIS WHEN: 1️⃣ Inspected request but don\'t need to modify (let it proceed). 2️⃣ Conditionally modifying (if condition not met, continue). 3️⃣ Analyzing requests without altering behavior. PREREQUISITE: Get requestId from list_intercepted_requests. EFFECT: Request proceeds normally to server. TIP: Must call this, modify_intercepted_request, or fail_intercepted_request for ALL intercepted requests.',
+            inputSchema: z.object({
+                requestId: z.string().describe('Request ID from list_intercepted_requests'),
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ requestId, tabId }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Fetch } = client;
+                const effectiveTabId = tabId || 'default';
+                const requests = interceptedRequests.get(effectiveTabId);
+                const originalRequest = requests?.get(requestId);
+                if (!originalRequest) {
+                    throw new Error(`Request ${requestId} not found. It may have already been processed.`);
+                }
+                // Continue without modifications
+                await Fetch.continueRequest({ requestId });
+                // Remove from pending requests
+                requests?.delete(requestId);
+                return {
+                    success: true,
+                    message: `Request ${requestId} continued without modifications`,
+                    url: originalRequest.request.url
+                };
+            }
+        },
+        // Disable network interception
+        {
+            name: 'disable_network_interception',
+            description: '🔓 Disables request interception (cleanup). USE THIS WHEN: 1️⃣ Done testing request modifications. 2️⃣ Switching to normal browsing (no interception). 3️⃣ Cleanup after testing. EFFECT: All pending requests released, future requests not intercepted. CLEANUP: Clears intercepted request storage. TIP: Call after finishing with modify_intercepted_request workflow.',
+            inputSchema: z.object({
+                tabId: z.string().optional().describe('Tab ID (optional)')
+            }),
+            handler: async ({ tabId }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Fetch } = client;
+                // Disable Fetch domain
+                await Fetch.disable();
+                // Clear intercepted requests for this tab
+                const effectiveTabId = tabId || 'default';
+                interceptedRequests.delete(effectiveTabId);
+                return {
+                    success: true,
+                    message: 'Network interception disabled'
+                };
+            }
+        },
+        // Get accessibility tree
+        {
+            name: 'get_accessibility_tree',
+            description: '🌳 Full accessibility tree (screen reader view). USE THIS WHEN: 1️⃣ Testing accessibility compliance (ARIA roles, labels). 2️⃣ Debugging screen reader behavior (what\'s announced). 3️⃣ Verifying semantic HTML structure. 4️⃣ Finding accessibility issues (missing labels, invalid roles). RETURNS: Hierarchical tree with roles, names, values, children. COMMON ROLES: button, link, heading, textbox, region. TIP: Use get_accessibility_snapshot for simplified view.',
+            inputSchema: z.object({
+                tabId: z.string().optional().describe('Tab ID (optional)'),
+                depth: z.number().default(-1).describe('Depth of the tree to retrieve (-1 for full tree)'),
+                includeIgnored: z.boolean().default(false).describe('Include ignored accessibility nodes')
+            }),
+            handler: async ({ tabId, depth = -1, includeIgnored = false }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Accessibility } = client;
+                // Get the full accessibility tree
+                const result = await withTimeout(Accessibility.getFullAXTree({ depth }), 30000, 'Accessibility tree retrieval timed out');
+                const nodes = result.nodes || [];
+                // Filter out ignored nodes if requested
+                const filteredNodes = includeIgnored
+                    ? nodes
+                    : nodes.filter((node) => !node.ignored);
+                // Format tree in a more readable structure
+                const formatNode = (node) => {
+                    const formatted = {
+                        nodeId: node.nodeId,
+                        role: node.role?.value || 'unknown',
+                        name: node.name?.value || '',
+                    };
+                    // Add additional properties if present
+                    if (node.description?.value)
+                        formatted.description = node.description.value;
+                    if (node.value?.value)
+                        formatted.value = node.value.value;
+                    if (node.properties) {
+                        formatted.properties = node.properties.reduce((acc, prop) => {
+                            acc[prop.name] = prop.value.value;
+                            return acc;
+                        }, {});
+                    }
+                    // Add children references
+                    if (node.childIds && node.childIds.length > 0) {
+                        formatted.childIds = node.childIds;
+                    }
+                    return formatted;
+                };
+                const formattedTree = filteredNodes.map(formatNode);
+                // Create a hierarchical view (root nodes)
+                const rootNodes = formattedTree.filter((node) => {
+                    // Root nodes are those not referenced as children by others
+                    const allChildIds = new Set(formattedTree.flatMap((n) => n.childIds || []));
+                    return !allChildIds.has(node.nodeId);
+                });
+                return {
+                    success: true,
+                    totalNodes: formattedTree.length,
+                    rootNodes: rootNodes.map((n) => ({
+                        nodeId: n.nodeId,
+                        role: n.role,
+                        name: n.name
+                    })),
+                    nodes: formattedTree,
+                    message: `Retrieved ${formattedTree.length} accessibility nodes (${rootNodes.length} root nodes)`
+                };
+            }
+        },
+        // Get accessibility snapshot (simpler, Playwright-style)
+        {
+            name: 'get_accessibility_snapshot',
+            description: '📸 Simplified accessibility snapshot (key info only). USE THIS WHEN: 1️⃣ Quick accessibility check (don\'t need full tree). 2️⃣ Finding interactive elements (buttons, links). 3️⃣ Verifying labels exist (form inputs have names). 4️⃣ Smaller output than get_accessibility_tree. RETURNS: Flat list with role, name, value for each element. FASTER: Less data than full tree. USE CASE: Playwright-style accessibility testing.',
+            inputSchema: z.object({
+                tabId: z.string().optional().describe('Tab ID (optional)'),
+                interestingOnly: z.boolean().default(true).describe('Only include interesting nodes (buttons, links, inputs, etc.)')
+            }),
+            handler: async ({ tabId, interestingOnly = true }) => {
+                await connector.verifyConnection();
+                const client = await connector.getTabClient(tabId);
+                const { Accessibility } = client;
+                // Get the accessibility snapshot
+                const result = await withTimeout(Accessibility.getFullAXTree({}), 30000, 'Accessibility snapshot retrieval timed out');
+                const nodes = result.nodes || [];
+                // Filter interesting roles if requested
+                const interestingRoles = new Set([
+                    'button', 'link', 'textbox', 'searchbox', 'checkbox', 'radio',
+                    'combobox', 'listbox', 'menuitem', 'tab', 'heading', 'article',
+                    'navigation', 'main', 'banner', 'form', 'dialog', 'alert'
+                ]);
+                const filteredNodes = nodes.filter((node) => {
+                    if (node.ignored)
+                        return false;
+                    if (!interestingOnly)
+                        return true;
+                    return interestingRoles.has(node.role?.value?.toLowerCase() || '');
+                });
+                // Build a YAML-like string representation
+                const lines = [];
+                const nodeMap = new Map(nodes.map((n) => [n.nodeId, n]));
+                const processed = new Set();
+                function renderNode(node, indent = 0) {
+                    if (processed.has(node.nodeId))
+                        return;
+                    processed.add(node.nodeId);
+                    const prefix = '  '.repeat(indent) + '- ';
+                    const role = node.role?.value || 'unknown';
+                    const name = node.name?.value || '';
+                    const value = node.value?.value || '';
+                    let line = `${prefix}${role}`;
+                    if (name)
+                        line += ` "${name}"`;
+                    if (value && value !== name)
+                        line += ` [value: "${value}"]`;
+                    if (node.nodeId)
+                        line += ` [ref=${node.nodeId.substring(0, 8)}]`;
+                    lines.push(line);
+                    // Render children
+                    if (node.childIds) {
+                        for (const childId of node.childIds) {
+                            const childNode = nodeMap.get(childId);
+                            if (childNode && !processed.has(childId)) {
+                                const isInteresting = !interestingOnly ||
+                                    interestingRoles.has(childNode.role?.value?.toLowerCase() || '');
+                                if (isInteresting) {
+                                    renderNode(childNode, indent + 1);
+                                }
+                            }
+                        }
+                    }
+                }
+                // Find root node
+                const rootNode = nodes.find((n) => n.role?.value === 'RootWebArea' || n.role?.value === 'WebArea');
+                if (rootNode) {
+                    renderNode(rootNode, 0);
+                }
+                const snapshot = lines.join('\n');
+                return {
+                    success: true,
+                    snapshot,
+                    nodeCount: filteredNodes.length,
+                    totalNodes: nodes.length
+                };
+            }
+        }
+    ];
+}
+//# sourceMappingURL=network-accessibility.js.map

package/dist/tools/network-accessibility.js.map

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

package/dist/tools/playwright-launcher.d.ts

@@ -8,7 +8,7 @@ export declare function createPlaywrightLauncherTools(connector: ChromeConnector
     name: string;
     description: string;
     inputSchema: z.ZodObject<{
-        profileDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        profileDirectory: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         profileDirectory: string;
     }, {

package/dist/tools/playwright-launcher.js

@@ -7,9 +7,9 @@ export function createPlaywrightLauncherTools(connector) {
     return [
         {
             name: 'launch_chrome_with_profile',
-            description: 'Launch Chrome using Playwright with your user profile (keeps cookies, sessions, extensions). This is the recommended way to start Chrome.',
+            description: '🚀 Launches Chrome with YOUR profile (cookies, extensions, sessions). USE THIS WHEN: 1️⃣ Starting automation (first tool to call). 2️⃣ Need existing login sessions (avoid re-login). 3️⃣ Testing with extensions enabled. 4️⃣ Keeping browsing history/bookmarks. PROFILES: "Default" (main), "Profile 1", "Profile 2". PREREQUISITE: Close ALL Chrome windows first (conflict error otherwise). RECOMMENDED: Always use this instead of connecting to external Chrome.',
             inputSchema: z.object({
-                profileDirectory: z.string().optional().default('Default').describe('Profile directory name: "Default", "Profile 1", "Profile 2", etc.'),
+                profileDirectory: z.string().default('Default').describe('Profile directory name: "Default", "Profile 1", "Profile 2", etc.'),
                 userDataDir: z.string().optional().describe('Full path to Chrome User Data directory. Leave empty for default location.')
             }),
             handler: async ({ profileDirectory, userDataDir }) => {
@@ -40,9 +40,9 @@ export function createPlaywrightLauncherTools(connector) {
         },
         {
             name: 'launch_edge_with_profile',
-            description: 'Launch Microsoft Edge using Playwright with your user profile',
+            description: '🧭Launches Microsoft Edge with YOUR profile (Edge-specific). USE THIS WHEN: 1️⃣ Testing Edge-specific features. 2️⃣ Need Edge browser specifically (not Chrome). 3️⃣ Using Edge profile with saved logins. PROFILES: "Default", "Profile 1". PREREQUISITE: Close all Edge windows. NOTE: Most features work identically to Chrome (Chromium-based).',
             inputSchema: z.object({
-                profileDirectory: z.string().optional().default('Default').describe('Profile directory name')
+                profileDirectory: z.string().default('Default').describe('Profile directory name')
             }),
             handler: async ({ profileDirectory }) => {
                 try {
@@ -70,7 +70,7 @@ export function createPlaywrightLauncherTools(connector) {
         },
         {
             name: 'close_browser',
-            description: 'Close the Playwright-managed browser instance',
+            description: '🚪 Closes Playwright-managed browser (cleanup). USE THIS WHEN: 1️⃣ Done with automation session. 2️⃣ Want to release browser lock (launch again). 3️⃣ Cleaning up after testing. PREREQUISITE: Browser launched with launch_chrome_with_profile. EFFECT: Browser closes, profile unlocked. NOTE: Only works for Playwright-managed browsers (not external connections).',
             inputSchema: z.object({}),
             handler: async () => {
                 try {
@@ -96,7 +96,7 @@ export function createPlaywrightLauncherTools(connector) {
         },
         {
             name: 'get_browser_status',
-            description: 'Check if browser is running and how it was launched',
+            description: '📊 Checks browser connection status. USE THIS WHEN: 1️⃣ Verifying browser launched successfully. 2️⃣ Debugging connection issues. 3️⃣ Checking if Playwright-managed or external. RETURNS: connected (boolean), playwrightManaged (boolean), port (CDP port), status (string). STATES: "Running via Playwright", "Connected to external Chrome", "Not connected".',
             inputSchema: z.object({}),
             handler: async () => {
                 const isConnected = connector.isConnected();

package/dist/tools/playwright-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-launcher.js","sourceRoot":"","sources":["../../src/tools/playwright-launcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,6BAA6B,CAAC,SAA0B;IACtE,OAAO;QACL;YACE,IAAI,EAAE,4BAA4B;YAClC,WAAW,EAAE,2IAA2I;YACxJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;gBACxI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;aAC1H,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAAE,WAAW,EAAO,EAAE,EAAE;gBACxD,IAAI,CAAC;oBACH,MAAM,OAAO,GAAQ;wBACnB,QAAQ,EAAE,KAAK;wBACf,gBAAgB;qBACjB,CAAC;oBAEF,IAAI,WAAW,EAAE,CAAC;wBAChB,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;oBACpC,CAAC;oBAED,MAAM,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;oBAE3C,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,iCAAiC,gBAAgB,EAAE;wBAC5D,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE;wBAC5B,IAAI,EAAE,iHAAiH;qBACxH,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAG,KAAe,CAAC,OAAO;wBAC/B,UAAU,EAAE,kFAAkF;qBAC/F,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;QAED;YACE,IAAI,EAAE,0BAA0B;YAChC,WAAW,EAAE,+DAA+D;YAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;aAC9F,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAAO,EAAE,EAAE;gBAC3C,IAAI,CAAC;oBACH,MAAM,YAAY,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,8BAA8B,CAAC;oBAC/E,MAAM,OAAO,GAAG,mEAAmE,CAAC;oBAEpF,MAAM,SAAS,CAAC,iBAAiB,CAAC;wBAChC,QAAQ,EAAE,KAAK;wBACf,gBAAgB;wBAChB,WAAW,EAAE,YAAY;wBACzB,cAAc,EAAE,OAAO;qBACxB,CAAC,CAAC;oBAEH,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,+BAA+B,gBAAgB,EAAE;wBAC1D,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE;qBAC7B,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAG,KAAe,CAAC,OAAO;qBAChC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;QAED;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,+CAA+C;YAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC;oBACH,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,CAAC;wBACrC,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,OAAO,EAAE,wCAAwC;yBAClD,CAAC;oBACJ,CAAC;oBAED,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;oBAE7B,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,6BAA6B;qBACvC,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAG,KAAe,CAAC,OAAO;qBAChC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;QAED;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,qDAAqD;YAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC5C,MAAM,YAAY,GAAG,SAAS,CAAC,mBAAmB,EAAE,CAAC;gBAErD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,WAAW;oBACtB,iBAAiB,EAAE,YAAY;oBAC/B,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE;oBACzB,MAAM,EAAE,WAAW;wBACjB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,8BAA8B,CAAC;wBAC5E,CAAC,CAAC,eAAe;iBACpB,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"playwright-launcher.js","sourceRoot":"","sources":["../../src/tools/playwright-launcher.ts"],"names":[],"mappings":"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"}

package/dist/tools/service-worker.d.ts

@@ -23,8 +23,8 @@ export declare function createServiceWorkerTools(connector: ChromeConnector): ({
     description: string;
     inputSchema: z.ZodObject<{
         targetId: z.ZodString;
-        executeTestLogs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        captureTimeMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        executeTestLogs: z.ZodDefault<z.ZodBoolean>;
+        captureTimeMs: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         targetId: string;
         executeTestLogs: boolean;

package/dist/tools/service-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-worker.d.ts","sourceRoot":"","sources":["../../src/tools/service-worker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,eAAe;;;;;;;;;;yBASlC,GAAG;;;;;;;;;;;;;;;;;;;;;4DA2C8C,GAAG;;;;;kBASpD,MAAM;oBAAU,MAAM;kBAAQ,MAAM;qBAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;oCAwG1C,GAAG;;;;;;;;;;;;;;;;;;;;;;;;mCAmCJ,GAAG;;;;;;;;;;;;;;;;;oCAgGF,GAAG;;;;;;;;;;;;;;yBAiEd,GAAG;;;;;KAoBnC"}
+{"version":3,"file":"service-worker.d.ts","sourceRoot":"","sources":["../../src/tools/service-worker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,eAAe;;;;;;;;;;yBASlC,GAAG;;;;;;;;;;;;;;;;;;;;;4DA4C8C,GAAG;;;;;kBAUpD,MAAM;oBAAU,MAAM;kBAAQ,MAAM;qBAAW,MAAM;;;;;;;;;;;;;;;;;;;;;;oCAwG1C,GAAG;;;;;;;;;;;;;;;;;;;;;;;;mCAoCJ,GAAG;;;;;;;;;;;;;;;;;oCAmGF,GAAG;;;;;;;;;;;;;;yBAoEd,GAAG;;;;;KAqBnC"}