@eddym06/custom-chrome-mcp 1.0.4 → 1.1.0

package/dist/index.js

@@ -15,6 +15,8 @@ import { createCaptureTools } from './tools/capture.js';
 import { createSessionTools } from './tools/session.js';
 import { createSystemTools } from './tools/system.js';
 import { createPlaywrightLauncherTools } from './tools/playwright-launcher.js';
+import { createNetworkAccessibilityTools } from './tools/network-accessibility.js';
+import { createAdvancedNetworkTools } from './tools/advanced-network.js';
 // Parse command line arguments
 const args = process.argv.slice(2);
 const portArg = args.find(arg => arg.startsWith('--port='));
@@ -40,6 +42,8 @@ const allTools = [
     ...createCaptureTools(connector),
     ...createSessionTools(connector),
     ...createSystemTools(connector),
+    ...createNetworkAccessibilityTools(connector), // Network interception + Accessibility tree
+    ...createAdvancedNetworkTools(connector), // Advanced network tools (Response, Mock, WebSocket, HAR, Patterns, Injection)
 ];
 // Create tool map for quick lookup
 const toolMap = new Map(allTools.map(tool => [tool.name, tool]));
@@ -48,18 +52,36 @@ function zodTypeToJsonSchema(schema) {
     if (!schema)
         return { type: 'string' };
     let current = schema;
-    let isOptional = false;
-    // Unwrap Optional/Default wrappers
-    while (current._def.typeName === 'ZodOptional' || current._def.typeName === 'ZodDefault') {
-        if (current._def.typeName === 'ZodOptional')
-            isOptional = true;
-        current = current._def.innerType;
+    let description = current.description;
+    let defaultValue = undefined;
+    // Unwrap Optional/Default/Effects wrappers and collect metadata
+    while (current._def.typeName === 'ZodOptional' ||
+        current._def.typeName === 'ZodDefault' ||
+        current._def.typeName === 'ZodEffects') {
+        if (current.description)
+            description = current.description;
+        if (current._def.typeName === 'ZodDefault') {
+            defaultValue = current._def.defaultValue();
+        }
+        if (current._def.typeName === 'ZodEffects') {
+            current = current._def.schema;
+        }
+        else {
+            current = current._def.innerType;
+        }
+    }
+    // If we still haven't found a description on the wrappers, check the inner type
+    if (!description && current.description) {
+        description = current.description;
     }
     const def = current._def;
     let type = 'string'; // Default fallback
     const jsonSchema = {};
-    if (current.description) {
-        jsonSchema.description = current.description;
+    if (description) {
+        jsonSchema.description = description;
+    }
+    if (defaultValue !== undefined) {
+        jsonSchema.default = defaultValue;
     }
     switch (def.typeName) {
         case 'ZodString':
@@ -75,6 +97,15 @@ function zodTypeToJsonSchema(schema) {
             type = 'string';
             jsonSchema.enum = def.values;
             break;
+        case 'ZodArray':
+            type = 'array';
+            jsonSchema.items = zodTypeToJsonSchema(def.type);
+            break;
+        case 'ZodNativeEnum':
+            type = 'string';
+            // Basic support for numeric enums or string enums
+            jsonSchema.enum = Object.values(def.values);
+            break;
     }
     jsonSchema.type = type;
     return jsonSchema;
@@ -94,10 +125,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     // Check if required
                     let isOptional = false;
                     let current = zodSchema;
-                    while (current._def.typeName === 'ZodOptional' || current._def.typeName === 'ZodDefault') {
-                        if (current._def.typeName === 'ZodOptional')
+                    // Unwrap to check strict optionality
+                    while (current._def.typeName === 'ZodOptional' ||
+                        current._def.typeName === 'ZodDefault' ||
+                        current._def.typeName === 'ZodEffects') {
+                        if (current._def.typeName === 'ZodOptional' || current._def.typeName === 'ZodDefault') {
                             isOptional = true;
-                        current = current._def.innerType;
+                        }
+                        if (current._def.typeName === 'ZodEffects') {
+                            current = current._def.schema;
+                        }
+                        else {
+                            current = current._def.innerType;
+                        }
                     }
                     if (!isOptional) {
                         required.push(key);
@@ -177,7 +217,24 @@ async function main() {
         console.error('  - Session & Cookies (9 tools)');
         console.error('  - System & Extensions (4 tools)');
         console.error('');
-        console.error('✨ Server ready! Use launch_chrome_with_profile to start...');
+        console.error('✨ Server ready!');
+        console.error('');
+        // Auto-launch Chrome on startup
+        console.error('🚀 Auto-launching Chrome with Default profile...');
+        try {
+            const launchTool = allTools.find(t => t.name === 'launch_chrome_with_profile');
+            if (launchTool?.handler) {
+                const launchPromise = launchTool.handler({ profileDirectory: 'Default' });
+                const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('Launch timeout after 15s')), 15000));
+                await Promise.race([launchPromise, timeoutPromise]);
+                console.error('✅ Chrome launched successfully!');
+            }
+        }
+        catch (error) {
+            console.error('⚠️ Auto-launch failed:', error.message);
+            console.error('   You can manually use "launch_chrome_with_profile" tool later');
+        }
+        console.error('');
         // Start MCP server with stdio transport
         const transport = new StdioServerTransport();
         await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,+BAA+B;AAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE9D,8BAA8B;AAC9B,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;AAE5C,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,oBAAoB;AACpB,MAAM,QAAQ,GAAG;IACf,GAAG,6BAA6B,CAAC,SAAS,CAAC,EAAG,uCAAuC;IACrF,GAAG,qBAAqB,CAAC,SAAS,CAAC;IACnC,GAAG,sBAAsB,CAAC,SAAS,CAAC;IACpC,GAAG,wBAAwB,CAAC,SAAS,CAAC;IACtC,GAAG,wBAAwB,CAAC,SAAS,CAAC;IACtC,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,kBAAkB,CAAC,SAAS,CAAC;IAChC,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC/B,GAAG,+BAA+B,CAAC,SAAS,CAAC,EAAG,4CAA4C;IAC5F,GAAG,0BAA0B,CAAC,SAAS,CAAC,EAAG,+EAA+E;CAC3H,CAAC;AAEF,mCAAmC;AACnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjE,uDAAuD;AACvD,SAAS,mBAAmB,CAAC,MAAW;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEvC,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,IAAI,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACtC,IAAI,YAAY,GAAQ,SAAS,CAAC;IAElC,gEAAgE;IAChE,OACE,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,aAAa;QACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY;QACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EACtC,CAAC;QACD,IAAI,OAAO,CAAC,WAAW;YAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAE3D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACzC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC3C,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACpC,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,GAAG,QAAQ,CAAC,CAAC,mBAAmB;IACxC,MAAM,UAAU,GAAQ,EAAE,CAAC;IAE3B,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7B,UAAU,CAAC,OAAO,GAAG,YAAY,CAAC;IACtC,CAAC;IAED,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,IAAI,GAAG,QAAQ,CAAC;YAChB,MAAM;QACR,KAAK,WAAW;YACd,IAAI,GAAG,QAAQ,CAAC;YAChB,MAAM;QACR,KAAK,YAAY;YACf,IAAI,GAAG,SAAS,CAAC;YACjB,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,GAAG,QAAQ,CAAC;YAChB,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;YAC7B,MAAM;QACR,KAAK,UAAU;YACb,IAAI,GAAG,OAAO,CAAC;YACf,UAAU,CAAC,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM;QACR,KAAK,eAAe;YAClB,IAAI,GAAG,QAAQ,CAAC;YAChB,kDAAkD;YAClD,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM;IACV,CAAC;IAED,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;IACvB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,sBAAsB;AACtB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACzB,kCAAkC;YAClC,MAAM,KAAK,GAAS,IAAI,CAAC,WAAmB,CAAC,KAAK,CAAC;YACnD,MAAM,UAAU,GAAQ,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;oBAEjD,oBAAoB;oBACpB,IAAI,UAAU,GAAG,KAAK,CAAC;oBACvB,IAAI,OAAO,GAAG,SAAS,CAAC;oBAExB,qCAAqC;oBACrC,OACE,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,aAAa;wBACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY;wBACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EACtC,CAAC;wBACA,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;4BACtF,UAAU,GAAG,IAAI,CAAC;wBACpB,CAAC;wBAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;4BAC3C,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;wBAChC,CAAC;6BAAM,CAAC;4BACN,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;wBACnC,CAAC;oBACJ,CAAC;oBAED,IAAI,CAAC,UAAU,EAAE,CAAC;wBAChB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU;oBACV,QAAQ;iBACT;aACF,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,wBAAwB;AACxB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,8BAA8B;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAEzD,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAEjD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAc,CAAC;QAE3B,sCAAsC;QACtC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,GAAG,CAAC,OAAO;wBAClB,IAAI,EAAE,IAAI;qBACX,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACvF,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAC5E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,gCAAgC;QAChC,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,4BAA4B,CAAC,CAAC;YAC/E,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;gBACxB,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1E,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,KAAK,CAAC,CACvE,CAAC;gBAEF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;gBACpD,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,wCAAwC;QACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAElC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAc,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC1F,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,aAAa;AACb,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tests/execute-script-tests.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Execute Script Testing Suite
+ * Progressive tests from simple to complex
+ */
+export declare const executeScriptTests: ({
+    name: string;
+    script: string;
+    expectedResult: number;
+    timeoutMs: number;
+    awaitPromise?: undefined;
+    shouldFail?: undefined;
+} | {
+    name: string;
+    script: string;
+    expectedResult: string;
+    timeoutMs: number;
+    awaitPromise?: undefined;
+    shouldFail?: undefined;
+} | {
+    name: string;
+    script: string;
+    expectedResult: number[];
+    timeoutMs: number;
+    awaitPromise?: undefined;
+    shouldFail?: undefined;
+} | {
+    name: string;
+    script: string;
+    expectedResult: {
+        name: string;
+        value: number;
+    };
+    timeoutMs: number;
+    awaitPromise?: undefined;
+    shouldFail?: undefined;
+} | {
+    name: string;
+    script: string;
+    expectedResult: string;
+    timeoutMs: number;
+    awaitPromise: boolean;
+    shouldFail?: undefined;
+} | {
+    name: string;
+    script: string;
+    expectedResult: string;
+    shouldFail: boolean;
+    timeoutMs: number;
+    awaitPromise?: undefined;
+})[];
+/**
+ * Test runner instructions for AI
+ */
+export declare const testInstructions = "\nEXECUTE_SCRIPT TESTING PROTOCOL\n\nPrerequisites:\n1. Chrome browser must be running (launch_chrome_with_profile)\n2. Navigate to a test page (e.g., https://example.com or https://apple.com)\n\nTesting Sequence:\n1. Start with LEVEL 1 tests (simple expressions)\n2. If all pass, proceed to LEVEL 2 (basic DOM)\n3. Continue through levels progressively\n4. Stop at first failure and report\n\nFor each test:\n1. Call execute_script with the test script\n2. Record: success/failure, result, execution time\n3. Compare result with expected (if not error test)\n4. Note any deviations or unexpected behavior\n\nExpected Outcomes:\n- LEVEL 1-2: Should have 100% success rate\n- LEVEL 3-4: Should have >90% success rate\n- LEVEL 5: May have some failures (network dependent)\n- LEVEL 6: Should fail gracefully with error messages (not crash)\n\nFailure Analysis:\nIf a test fails, check:\n1. Is Chrome connection active? (list_tabs)\n2. Is page loaded? (get_url, screenshot)\n3. Is timeout sufficient? (increase timeoutMs)\n4. Is error message descriptive?\n\nReport Format:\n{\n  level: \"LEVEL X\",\n  passed: X,\n  failed: Y,\n  total: Z,\n  failures: [{test: \"name\", error: \"message\"}]\n}\n";
+/**
+ * Real-world usage examples
+ */
+export declare const realWorldExamples: {
+    scenario: string;
+    script: string;
+}[];
+//# sourceMappingURL=execute-script-tests.d.ts.map

package/dist/tests/execute-script-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-script-tests.d.ts","sourceRoot":"","sources":["../../src/tests/execute-script-tests.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2L9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,+qCAwC5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;GA4C7B,CAAC"}

package/dist/tests/execute-script-tests.js

@@ -0,0 +1,280 @@
+/**
+ * Execute Script Testing Suite
+ * Progressive tests from simple to complex
+ */
+export const executeScriptTests = [
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 1: BASIC EXPRESSIONS (should all work)
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Simple arithmetic",
+        script: "return 1 + 1;",
+        expectedResult: 2,
+        timeoutMs: 5000
+    },
+    {
+        name: "String concatenation",
+        script: "return 'Hello' + ' ' + 'World';",
+        expectedResult: "Hello World",
+        timeoutMs: 5000
+    },
+    {
+        name: "Get page title",
+        script: "return document.title;",
+        expectedResult: "<any string>",
+        timeoutMs: 5000
+    },
+    {
+        name: "Get URL",
+        script: "return window.location.href;",
+        expectedResult: "<url>",
+        timeoutMs: 5000
+    },
+    {
+        name: "Array creation",
+        script: "return [1, 2, 3, 4, 5];",
+        expectedResult: [1, 2, 3, 4, 5],
+        timeoutMs: 5000
+    },
+    {
+        name: "Object creation",
+        script: "return {name: 'test', value: 123};",
+        expectedResult: { name: 'test', value: 123 },
+        timeoutMs: 5000
+    },
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 2: DOM QUERIES (basic)
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Count all elements",
+        script: "return document.querySelectorAll('*').length;",
+        expectedResult: "<number>",
+        timeoutMs: 5000
+    },
+    {
+        name: "Get all link hrefs",
+        script: `
+      return Array.from(document.querySelectorAll('a'))
+        .map(a => a.href)
+        .filter(href => href.startsWith('http'));
+    `,
+        expectedResult: "<array of urls>",
+        timeoutMs: 10000
+    },
+    {
+        name: "Get all button texts",
+        script: `
+      return Array.from(document.querySelectorAll('button'))
+        .map(btn => btn.textContent.trim())
+        .filter(text => text.length > 0);
+    `,
+        expectedResult: "<array of strings>",
+        timeoutMs: 10000
+    },
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 3: COMPLEX QUERIES
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Extract structured data",
+        script: `
+      return Array.from(document.querySelectorAll('article, .post, .item'))
+        .slice(0, 10)
+        .map(item => ({
+          text: item.textContent.trim().substring(0, 100),
+          links: Array.from(item.querySelectorAll('a')).length,
+          images: Array.from(item.querySelectorAll('img')).length
+        }));
+    `,
+        expectedResult: "<array of objects>",
+        timeoutMs: 15000
+    },
+    {
+        name: "Get form field info",
+        script: `
+      return Array.from(document.querySelectorAll('input, textarea, select'))
+        .map(field => ({
+          type: field.type || field.tagName,
+          name: field.name || field.id,
+          value: field.value ? '[has value]' : '[empty]'
+        }));
+    `,
+        expectedResult: "<array of form fields>",
+        timeoutMs: 10000
+    },
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 4: WINDOW OBJECT ACCESS
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Check window variables",
+        script: `
+      return {
+        hasJQuery: typeof window.jQuery !== 'undefined',
+        hasReact: typeof window.React !== 'undefined',
+        hasAngular: typeof window.angular !== 'undefined',
+        hasVue: typeof window.Vue !== 'undefined'
+      };
+    `,
+        expectedResult: "<object with boolean values>",
+        timeoutMs: 5000
+    },
+    {
+        name: "Get localStorage items",
+        script: `
+      const items = {};
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        items[key] = localStorage.getItem(key).substring(0, 50);
+      }
+      return items;
+    `,
+        expectedResult: "<object>",
+        timeoutMs: 5000
+    },
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 5: ASYNC OPERATIONS
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Async timeout",
+        script: `
+      return new Promise(resolve => {
+        setTimeout(() => resolve('Async completed'), 1000);
+      });
+    `,
+        expectedResult: "Async completed",
+        timeoutMs: 5000,
+        awaitPromise: true
+    },
+    {
+        name: "Fetch test (if available)",
+        script: `
+      if (typeof fetch === 'undefined') {
+        return 'Fetch not available';
+      }
+      return 'Fetch available (use with caution in tests)';
+    `,
+        expectedResult: "<string>",
+        timeoutMs: 5000
+    },
+    // ═══════════════════════════════════════════════════════════════
+    // LEVEL 6: ERROR HANDLING TESTS (should fail gracefully)
+    // ═══════════════════════════════════════════════════════════════
+    {
+        name: "Syntax error",
+        script: "return this is invalid javascript;",
+        expectedResult: "<error>",
+        shouldFail: true,
+        timeoutMs: 5000
+    },
+    {
+        name: "Runtime error",
+        script: "return undefinedVariable.property;",
+        expectedResult: "<error>",
+        shouldFail: true,
+        timeoutMs: 5000
+    },
+    {
+        name: "Return DOM node (should be handled)",
+        script: "return document.body;",
+        expectedResult: "[DOM Node - use get_text or get_attribute instead]",
+        timeoutMs: 5000
+    },
+    {
+        name: "Return function (should be handled)",
+        script: "return function() { return 'test'; };",
+        expectedResult: "[Function]",
+        timeoutMs: 5000
+    }
+];
+/**
+ * Test runner instructions for AI
+ */
+export const testInstructions = `
+EXECUTE_SCRIPT TESTING PROTOCOL
+
+Prerequisites:
+1. Chrome browser must be running (launch_chrome_with_profile)
+2. Navigate to a test page (e.g., https://example.com or https://apple.com)
+
+Testing Sequence:
+1. Start with LEVEL 1 tests (simple expressions)
+2. If all pass, proceed to LEVEL 2 (basic DOM)
+3. Continue through levels progressively
+4. Stop at first failure and report
+
+For each test:
+1. Call execute_script with the test script
+2. Record: success/failure, result, execution time
+3. Compare result with expected (if not error test)
+4. Note any deviations or unexpected behavior
+
+Expected Outcomes:
+- LEVEL 1-2: Should have 100% success rate
+- LEVEL 3-4: Should have >90% success rate
+- LEVEL 5: May have some failures (network dependent)
+- LEVEL 6: Should fail gracefully with error messages (not crash)
+
+Failure Analysis:
+If a test fails, check:
+1. Is Chrome connection active? (list_tabs)
+2. Is page loaded? (get_url, screenshot)
+3. Is timeout sufficient? (increase timeoutMs)
+4. Is error message descriptive?
+
+Report Format:
+{
+  level: "LEVEL X",
+  passed: X,
+  failed: Y,
+  total: Z,
+  failures: [{test: "name", error: "message"}]
+}
+`;
+/**
+ * Real-world usage examples
+ */
+export const realWorldExamples = [
+    {
+        scenario: "Extract product prices from e-commerce",
+        script: `
+      return Array.from(document.querySelectorAll('.price, [data-price], .product-price'))
+        .map(el => el.textContent.trim())
+        .filter(text => text.match(/\\$|€|£/));
+    `
+    },
+    {
+        scenario: "Check if user is logged in",
+        script: `
+      return {
+        hasLoginButton: !!document.querySelector('[href*="login"], button:contains("Login")'),
+        hasUserMenu: !!document.querySelector('.user-menu, .profile-menu, [data-user]'),
+        hasLogoutButton: !!document.querySelector('[href*="logout"], button:contains("Logout")')
+      };
+    `
+    },
+    {
+        scenario: "Get all image URLs",
+        script: `
+      return Array.from(document.querySelectorAll('img'))
+        .map(img => ({
+          src: img.src,
+          alt: img.alt,
+          width: img.naturalWidth,
+          height: img.naturalHeight
+        }))
+        .filter(img => img.width > 100);
+    `
+    },
+    {
+        scenario: "Inject console logger",
+        script: `
+      window.originalConsoleLog = console.log;
+      window.logHistory = [];
+      console.log = function(...args) {
+        window.logHistory.push(args);
+        window.originalConsoleLog.apply(console, args);
+      };
+      return 'Console logger injected. Access logs via window.logHistory';
+    `
+    }
+];
+//# sourceMappingURL=execute-script-tests.js.map

package/dist/tests/execute-script-tests.js.map

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

package/dist/tests/run-execute-tests.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Automated Execute Script Testing
+ * Run this after building to verify execute_script works correctly
+ */
+export {};
+//# sourceMappingURL=run-execute-tests.d.ts.map

package/dist/tests/run-execute-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-execute-tests.d.ts","sourceRoot":"","sources":["../../src/tests/run-execute-tests.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/tests/run-execute-tests.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * Automated Execute Script Testing
+ * Run this after building to verify execute_script works correctly
+ */
+import { executeScriptTests, testInstructions } from './execute-script-tests.js';
+console.log('🧪 EXECUTE_SCRIPT TESTING SUITE');
+console.log('═'.repeat(80));
+console.log('\n' + testInstructions + '\n');
+console.log('═'.repeat(80));
+console.log('\n📋 TEST DEFINITIONS LOADED\n');
+// Group tests by level
+const testsByLevel = {
+    'LEVEL 1: BASIC EXPRESSIONS': [],
+    'LEVEL 2: DOM QUERIES (basic)': [],
+    'LEVEL 3: COMPLEX QUERIES': [],
+    'LEVEL 4: WINDOW OBJECT ACCESS': [],
+    'LEVEL 5: ASYNC OPERATIONS': [],
+    'LEVEL 6: ERROR HANDLING': []
+};
+let currentLevel = 'LEVEL 1: BASIC EXPRESSIONS';
+executeScriptTests.forEach((test, index) => {
+    if (index === 6)
+        currentLevel = 'LEVEL 2: DOM QUERIES (basic)';
+    if (index === 9)
+        currentLevel = 'LEVEL 3: COMPLEX QUERIES';
+    if (index === 11)
+        currentLevel = 'LEVEL 4: WINDOW OBJECT ACCESS';
+    if (index === 13)
+        currentLevel = 'LEVEL 5: ASYNC OPERATIONS';
+    if (index === 15)
+        currentLevel = 'LEVEL 6: ERROR HANDLING';
+    testsByLevel[currentLevel].push(test);
+});
+// Print test summary
+Object.entries(testsByLevel).forEach(([level, tests]) => {
+    console.log(`\n${level}`);
+    console.log('─'.repeat(80));
+    tests.forEach((test, i) => {
+        const status = test.shouldFail ? '⚠️ ' : '✓ ';
+        console.log(`  ${status}${i + 1}. ${test.name}`);
+        console.log(`     Script: ${test.script.trim().substring(0, 60)}...`);
+        console.log(`     Timeout: ${test.timeoutMs}ms`);
+        if (test.shouldFail) {
+            console.log(`     Expected: Error (graceful failure)`);
+        }
+    });
+});
+console.log('\n\n' + '═'.repeat(80));
+console.log('📝 TESTING INSTRUCTIONS');
+console.log('═'.repeat(80));
+console.log(`
+To run these tests manually with the MCP:
+
+1. Start MCP server: npm run build && node dist/index.js
+2. Connect via MCP client (VS Code Copilot)
+3. Execute these commands in order:
+
+   # Setup
+   launch_chrome_with_profile()
+   navigate({ url: "https://example.com" })
+   wait_for_load_state({ state: "networkidle" })
+
+   # Run Level 1 tests (copy one by one)
+   execute_script({ script: "return 1 + 1;", timeoutMs: 5000 })
+   execute_script({ script: "return 'Hello' + ' ' + 'World';", timeoutMs: 5000 })
+   execute_script({ script: "return document.title;", timeoutMs: 5000 })
+   
+   # ... etc
+
+4. Record results in this format:
+   {
+     test: "Simple arithmetic",
+     expected: 2,
+     actual: 2,
+     success: true,
+     timeMs: 45
+   }
+
+5. Report any failures with full error messages
+
+AUTOMATED TESTING (if MCP client supports it):
+You can also use the MCP programmatically to run all tests in sequence.
+See the executeScriptTests array for the complete test suite.
+`);
+console.log('\n✅ Test definitions ready. Total tests: ' + executeScriptTests.length);
+console.log('✅ To execute, run tests manually through MCP or use automated test runner\n');
+//# sourceMappingURL=run-execute-tests.js.map

package/dist/tests/run-execute-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-execute-tests.js","sourceRoot":"","sources":["../../src/tests/run-execute-tests.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAE9C,uBAAuB;AACvB,MAAM,YAAY,GAA0B;IAC1C,4BAA4B,EAAE,EAAE;IAChC,8BAA8B,EAAE,EAAE;IAClC,0BAA0B,EAAE,EAAE;IAC9B,+BAA+B,EAAE,EAAE;IACnC,2BAA2B,EAAE,EAAE;IAC/B,yBAAyB,EAAE,EAAE;CAC9B,CAAC;AAEF,IAAI,YAAY,GAAG,4BAA4B,CAAC;AAChD,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IACzC,IAAI,KAAK,KAAK,CAAC;QAAE,YAAY,GAAG,8BAA8B,CAAC;IAC/D,IAAI,KAAK,KAAK,CAAC;QAAE,YAAY,GAAG,0BAA0B,CAAC;IAC3D,IAAI,KAAK,KAAK,EAAE;QAAE,YAAY,GAAG,+BAA+B,CAAC;IACjE,IAAI,KAAK,KAAK,EAAE;QAAE,YAAY,GAAG,2BAA2B,CAAC;IAC7D,IAAI,KAAK,KAAK,EAAE;QAAE,YAAY,GAAG,yBAAyB,CAAC;IAE3D,YAAY,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,qBAAqB;AACrB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;IACtD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACvC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCX,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,2CAA2C,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACrF,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC"}