webmcp-cli 1.0.0 → 1.2.1

package/dist/browser/interceptor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * WebMCP API Interception Script
+ *
+ * This script is injected into pages BEFORE any page scripts run.
+ * It hooks the navigator.modelContext API to capture all tool registrations.
+ */
+/**
+ * The interception script to be injected via page.addInitScript()
+ */
+export declare const INTERCEPT_SCRIPT = "\n(function() {\n  'use strict';\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Storage for captured data\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  window.__agentready_captured_tools = [];\n  window.__agentready_context_calls = [];\n  window.__agentready_events = [];\n  window.__agentready_hooked = false;\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Helper: Safely serialize an object (handles circular refs, functions)\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  function safeSerialize(obj) {\n    try {\n      return JSON.parse(JSON.stringify(obj, (key, value) => {\n        if (typeof value === 'function') {\n          return '[Function]';\n        }\n        if (value instanceof Error) {\n          return { error: value.message, stack: value.stack };\n        }\n        return value;\n      }));\n    } catch (e) {\n      return { serializationError: e.message };\n    }\n  }\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Hook the navigator.modelContext API\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  function hookModelContext() {\n    if (window.__agentready_hooked) return true;\n    if (!navigator.modelContext) return false;\n\n    const mc = navigator.modelContext;\n\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    // Hook: registerTool()\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n    if (typeof mc.registerTool === 'function') {\n      const originalRegister = mc.registerTool.bind(mc);\n\n      mc.registerTool = function(toolDef) {\n        const captured = {\n          name: toolDef.name || null,\n          description: toolDef.description || null,\n          inputSchema: safeSerialize(toolDef.inputSchema || {}),\n          annotations: toolDef.annotations ? safeSerialize(toolDef.annotations) : null,\n          hasExecute: typeof toolDef.execute === 'function',\n          executeSource: null,\n          registeredAt: Date.now(),\n          registrationMethod: 'registerTool',\n          pageUrl: window.location.href\n        };\n\n        // Try to capture execute function source\n        if (typeof toolDef.execute === 'function') {\n          try {\n            captured.executeSource = toolDef.execute.toString();\n          } catch (e) {\n            captured.executeSource = '[Unable to serialize]';\n          }\n        }\n\n        window.__agentready_captured_tools.push(captured);\n\n        // Call original\n        return originalRegister(toolDef);\n      };\n    }\n\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    // Hook: provideContext()\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n    if (typeof mc.provideContext === 'function') {\n      const originalProvide = mc.provideContext.bind(mc);\n\n      mc.provideContext = function(context) {\n        // Record the provideContext call\n        window.__agentready_context_calls.push({\n          type: 'provideContext',\n          timestamp: Date.now(),\n          toolCount: context.tools ? context.tools.length : 0,\n          pageUrl: window.location.href\n        });\n\n        // Capture each tool in the context\n        if (context.tools && Array.isArray(context.tools)) {\n          context.tools.forEach(function(toolDef) {\n            const captured = {\n              name: toolDef.name || null,\n              description: toolDef.description || null,\n              inputSchema: safeSerialize(toolDef.inputSchema || {}),\n              annotations: toolDef.annotations ? safeSerialize(toolDef.annotations) : null,\n              hasExecute: typeof toolDef.execute === 'function',\n              executeSource: null,\n              registeredAt: Date.now(),\n              registrationMethod: 'provideContext',\n              pageUrl: window.location.href\n            };\n\n            if (typeof toolDef.execute === 'function') {\n              try {\n                captured.executeSource = toolDef.execute.toString();\n              } catch (e) {\n                captured.executeSource = '[Unable to serialize]';\n              }\n            }\n\n            window.__agentready_captured_tools.push(captured);\n          });\n        }\n\n        return originalProvide(context);\n      };\n    }\n\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    // Hook: unregisterTool()\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n    if (typeof mc.unregisterTool === 'function') {\n      const originalUnregister = mc.unregisterTool.bind(mc);\n\n      mc.unregisterTool = function(name) {\n        window.__agentready_context_calls.push({\n          type: 'unregisterTool',\n          toolName: name,\n          timestamp: Date.now(),\n          pageUrl: window.location.href\n        });\n\n        return originalUnregister(name);\n      };\n    }\n\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    // Hook: clearContext()\n    // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n    if (typeof mc.clearContext === 'function') {\n      const originalClear = mc.clearContext.bind(mc);\n\n      mc.clearContext = function() {\n        window.__agentready_context_calls.push({\n          type: 'clearContext',\n          timestamp: Date.now(),\n          pageUrl: window.location.href\n        });\n\n        return originalClear();\n      };\n    }\n\n    window.__agentready_hooked = true;\n    return true;\n  }\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Listen for WebMCP-specific events\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  window.addEventListener('toolactivated', function(e) {\n    window.__agentready_events.push({\n      type: 'toolactivated',\n      toolName: e.toolName || e.detail?.toolName || null,\n      timestamp: Date.now(),\n      pageUrl: window.location.href\n    });\n  });\n\n  window.addEventListener('toolcancel', function(e) {\n    window.__agentready_events.push({\n      type: 'toolcancel',\n      toolName: e.toolName || e.detail?.toolName || null,\n      timestamp: Date.now(),\n      pageUrl: window.location.href\n    });\n  });\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Try to hook immediately, then poll if not available yet\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  if (!hookModelContext()) {\n    // navigator.modelContext doesn't exist yet\n    // Either WebMCP isn't enabled or it loads asynchronously\n    let attempts = 0;\n    const maxAttempts = 50;\n    const pollInterval = 100; // ms\n\n    const interval = setInterval(function() {\n      if (hookModelContext() || attempts++ >= maxAttempts) {\n        clearInterval(interval);\n      }\n    }, pollInterval);\n  }\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Expose retrieval function for Playwright\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  window.__agentready_getData = function() {\n    return {\n      hasModelContext: typeof navigator.modelContext !== 'undefined' && navigator.modelContext !== null,\n      hooked: window.__agentready_hooked,\n      tools: window.__agentready_captured_tools,\n      contextCalls: window.__agentready_context_calls,\n      events: window.__agentready_events\n    };\n  };\n\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n  // Expose function to check for feature detection patterns in scripts\n  // \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n  window.__agentready_checkFeatureDetection = function() {\n    const scripts = document.querySelectorAll('script');\n    let hasFeatureDetection = false;\n\n    scripts.forEach(function(script) {\n      const content = script.textContent || '';\n      // Check for common feature detection patterns\n      if (\n        content.includes('\"modelContext\" in navigator') ||\n        content.includes(\"'modelContext' in navigator\") ||\n        content.includes('navigator.modelContext') ||\n        content.includes('typeof navigator.modelContext')\n      ) {\n        hasFeatureDetection = true;\n      }\n    });\n\n    return hasFeatureDetection;\n  };\n\n})();\n";
+/**
+ * Interface for data returned by the interception script
+ */
+export interface InterceptedData {
+    /**
+     * Whether navigator.modelContext exists
+     */
+    hasModelContext: boolean;
+    /**
+     * Whether we successfully hooked the API
+     */
+    hooked: boolean;
+    /**
+     * All captured tool registrations
+     */
+    tools: InterceptedTool[];
+    /**
+     * All context API calls (provideContext, unregisterTool, clearContext)
+     */
+    contextCalls: ContextCall[];
+    /**
+     * WebMCP events that were fired
+     */
+    events: WebMCPEvent[];
+}
+/**
+ * A tool captured from the interception
+ */
+export interface InterceptedTool {
+    name: string | null;
+    description: string | null;
+    inputSchema: Record<string, unknown>;
+    annotations: Record<string, unknown> | null;
+    hasExecute: boolean;
+    executeSource: string | null;
+    registeredAt: number;
+    registrationMethod: 'registerTool' | 'provideContext';
+    pageUrl: string;
+}
+/**
+ * A context API call
+ */
+export interface ContextCall {
+    type: 'provideContext' | 'unregisterTool' | 'clearContext';
+    toolName?: string;
+    toolCount?: number;
+    timestamp: number;
+    pageUrl: string;
+}
+/**
+ * A WebMCP event
+ */
+export interface WebMCPEvent {
+    type: 'toolactivated' | 'toolcancel';
+    toolName: string | null;
+    timestamp: number;
+    pageUrl: string;
+}

package/dist/browser/interceptor.js

@@ -0,0 +1,257 @@
+/**
+ * WebMCP API Interception Script
+ *
+ * This script is injected into pages BEFORE any page scripts run.
+ * It hooks the navigator.modelContext API to capture all tool registrations.
+ */
+/**
+ * The interception script to be injected via page.addInitScript()
+ */
+export const INTERCEPT_SCRIPT = `
+(function() {
+  'use strict';
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Storage for captured data
+  // ═══════════════════════════════════════════════════════════════════
+
+  window.__agentready_captured_tools = [];
+  window.__agentready_context_calls = [];
+  window.__agentready_events = [];
+  window.__agentready_hooked = false;
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Helper: Safely serialize an object (handles circular refs, functions)
+  // ═══════════════════════════════════════════════════════════════════
+
+  function safeSerialize(obj) {
+    try {
+      return JSON.parse(JSON.stringify(obj, (key, value) => {
+        if (typeof value === 'function') {
+          return '[Function]';
+        }
+        if (value instanceof Error) {
+          return { error: value.message, stack: value.stack };
+        }
+        return value;
+      }));
+    } catch (e) {
+      return { serializationError: e.message };
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Hook the navigator.modelContext API
+  // ═══════════════════════════════════════════════════════════════════
+
+  function hookModelContext() {
+    if (window.__agentready_hooked) return true;
+    if (!navigator.modelContext) return false;
+
+    const mc = navigator.modelContext;
+
+    // ─────────────────────────────────────────────────────────────────
+    // Hook: registerTool()
+    // ─────────────────────────────────────────────────────────────────
+
+    if (typeof mc.registerTool === 'function') {
+      const originalRegister = mc.registerTool.bind(mc);
+
+      mc.registerTool = function(toolDef) {
+        const captured = {
+          name: toolDef.name || null,
+          description: toolDef.description || null,
+          inputSchema: safeSerialize(toolDef.inputSchema || {}),
+          annotations: toolDef.annotations ? safeSerialize(toolDef.annotations) : null,
+          hasExecute: typeof toolDef.execute === 'function',
+          executeSource: null,
+          registeredAt: Date.now(),
+          registrationMethod: 'registerTool',
+          pageUrl: window.location.href
+        };
+
+        // Try to capture execute function source
+        if (typeof toolDef.execute === 'function') {
+          try {
+            captured.executeSource = toolDef.execute.toString();
+          } catch (e) {
+            captured.executeSource = '[Unable to serialize]';
+          }
+        }
+
+        window.__agentready_captured_tools.push(captured);
+
+        // Call original
+        return originalRegister(toolDef);
+      };
+    }
+
+    // ─────────────────────────────────────────────────────────────────
+    // Hook: provideContext()
+    // ─────────────────────────────────────────────────────────────────
+
+    if (typeof mc.provideContext === 'function') {
+      const originalProvide = mc.provideContext.bind(mc);
+
+      mc.provideContext = function(context) {
+        // Record the provideContext call
+        window.__agentready_context_calls.push({
+          type: 'provideContext',
+          timestamp: Date.now(),
+          toolCount: context.tools ? context.tools.length : 0,
+          pageUrl: window.location.href
+        });
+
+        // Capture each tool in the context
+        if (context.tools && Array.isArray(context.tools)) {
+          context.tools.forEach(function(toolDef) {
+            const captured = {
+              name: toolDef.name || null,
+              description: toolDef.description || null,
+              inputSchema: safeSerialize(toolDef.inputSchema || {}),
+              annotations: toolDef.annotations ? safeSerialize(toolDef.annotations) : null,
+              hasExecute: typeof toolDef.execute === 'function',
+              executeSource: null,
+              registeredAt: Date.now(),
+              registrationMethod: 'provideContext',
+              pageUrl: window.location.href
+            };
+
+            if (typeof toolDef.execute === 'function') {
+              try {
+                captured.executeSource = toolDef.execute.toString();
+              } catch (e) {
+                captured.executeSource = '[Unable to serialize]';
+              }
+            }
+
+            window.__agentready_captured_tools.push(captured);
+          });
+        }
+
+        return originalProvide(context);
+      };
+    }
+
+    // ─────────────────────────────────────────────────────────────────
+    // Hook: unregisterTool()
+    // ─────────────────────────────────────────────────────────────────
+
+    if (typeof mc.unregisterTool === 'function') {
+      const originalUnregister = mc.unregisterTool.bind(mc);
+
+      mc.unregisterTool = function(name) {
+        window.__agentready_context_calls.push({
+          type: 'unregisterTool',
+          toolName: name,
+          timestamp: Date.now(),
+          pageUrl: window.location.href
+        });
+
+        return originalUnregister(name);
+      };
+    }
+
+    // ─────────────────────────────────────────────────────────────────
+    // Hook: clearContext()
+    // ─────────────────────────────────────────────────────────────────
+
+    if (typeof mc.clearContext === 'function') {
+      const originalClear = mc.clearContext.bind(mc);
+
+      mc.clearContext = function() {
+        window.__agentready_context_calls.push({
+          type: 'clearContext',
+          timestamp: Date.now(),
+          pageUrl: window.location.href
+        });
+
+        return originalClear();
+      };
+    }
+
+    window.__agentready_hooked = true;
+    return true;
+  }
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Listen for WebMCP-specific events
+  // ═══════════════════════════════════════════════════════════════════
+
+  window.addEventListener('toolactivated', function(e) {
+    window.__agentready_events.push({
+      type: 'toolactivated',
+      toolName: e.toolName || e.detail?.toolName || null,
+      timestamp: Date.now(),
+      pageUrl: window.location.href
+    });
+  });
+
+  window.addEventListener('toolcancel', function(e) {
+    window.__agentready_events.push({
+      type: 'toolcancel',
+      toolName: e.toolName || e.detail?.toolName || null,
+      timestamp: Date.now(),
+      pageUrl: window.location.href
+    });
+  });
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Try to hook immediately, then poll if not available yet
+  // ═══════════════════════════════════════════════════════════════════
+
+  if (!hookModelContext()) {
+    // navigator.modelContext doesn't exist yet
+    // Either WebMCP isn't enabled or it loads asynchronously
+    let attempts = 0;
+    const maxAttempts = 50;
+    const pollInterval = 100; // ms
+
+    const interval = setInterval(function() {
+      if (hookModelContext() || attempts++ >= maxAttempts) {
+        clearInterval(interval);
+      }
+    }, pollInterval);
+  }
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Expose retrieval function for Playwright
+  // ═══════════════════════════════════════════════════════════════════
+
+  window.__agentready_getData = function() {
+    return {
+      hasModelContext: typeof navigator.modelContext !== 'undefined' && navigator.modelContext !== null,
+      hooked: window.__agentready_hooked,
+      tools: window.__agentready_captured_tools,
+      contextCalls: window.__agentready_context_calls,
+      events: window.__agentready_events
+    };
+  };
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Expose function to check for feature detection patterns in scripts
+  // ═══════════════════════════════════════════════════════════════════
+
+  window.__agentready_checkFeatureDetection = function() {
+    const scripts = document.querySelectorAll('script');
+    let hasFeatureDetection = false;
+
+    scripts.forEach(function(script) {
+      const content = script.textContent || '';
+      // Check for common feature detection patterns
+      if (
+        content.includes('"modelContext" in navigator') ||
+        content.includes("'modelContext' in navigator") ||
+        content.includes('navigator.modelContext') ||
+        content.includes('typeof navigator.modelContext')
+      ) {
+        hasFeatureDetection = true;
+      }
+    });
+
+    return hasFeatureDetection;
+  };
+
+})();
+`;
+//# sourceMappingURL=interceptor.js.map

package/dist/browser/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/browser/interceptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsP/B,CAAC"}

package/dist/browser/playwright.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Playwright Browser Setup
+ *
+ * Configures Chromium with WebMCP flag enabled and script injection.
+ */
+import { type Browser, type BrowserContext, type Page } from 'playwright';
+import { type InterceptedData } from './interceptor.js';
+/**
+ * Options for creating an audit browser
+ */
+export interface AuditBrowserOptions {
+    /**
+     * Run in visible (non-headless) mode
+     */
+    headless?: boolean;
+    /**
+     * Slow down operations by this many ms (for debugging)
+     */
+    slowMo?: number;
+    /**
+     * Timeout for page operations (ms)
+     */
+    timeout?: number;
+    /**
+     * User agent string override
+     */
+    userAgent?: string;
+    /**
+     * Viewport size
+     */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Result of creating an audit browser
+ */
+export interface AuditBrowser {
+    browser: Browser;
+    context: BrowserContext;
+}
+/**
+ * Create a browser configured for WebMCP auditing
+ *
+ * The browser is launched with the WebMCP flag enabled and has the
+ * interception script injected into every page.
+ */
+export declare function createAuditBrowser(options?: AuditBrowserOptions): Promise<AuditBrowser>;
+/**
+ * Navigate to a URL and wait for it to be ready
+ */
+export declare function navigateAndWait(page: Page, url: string, options?: {
+    timeout?: number;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+    extraWaitMs?: number;
+}): Promise<void>;
+/**
+ * Retrieve captured WebMCP data from the page
+ */
+export declare function getCapturedData(page: Page): Promise<InterceptedData>;
+/**
+ * Check if the page has feature detection for WebMCP
+ */
+export declare function hasFeatureDetection(page: Page): Promise<boolean>;
+/**
+ * Get the page's HTML content
+ */
+export declare function getPageHTML(page: Page): Promise<string>;
+/**
+ * Get the page's title
+ */
+export declare function getPageTitle(page: Page): Promise<string>;
+/**
+ * Take a screenshot of the page
+ */
+export declare function takeScreenshot(page: Page, path: string, options?: {
+    fullPage?: boolean;
+}): Promise<void>;
+/**
+ * Close the browser and clean up
+ */
+export declare function closeBrowser(browser: Browser): Promise<void>;
+/**
+ * Audit a single page and return captured data
+ */
+export declare function auditPage(context: BrowserContext, url: string, options?: {
+    timeout?: number;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+    extraWaitMs?: number;
+    screenshot?: string;
+}): Promise<{
+    page: Page;
+    data: InterceptedData;
+    html: string;
+    title: string;
+    hasFeatureDetection: boolean;
+}>;

package/dist/browser/playwright.js

@@ -0,0 +1,158 @@
+/**
+ * Playwright Browser Setup
+ *
+ * Configures Chromium with WebMCP flag enabled and script injection.
+ */
+import { chromium } from 'playwright';
+import { INTERCEPT_SCRIPT } from './interceptor.js';
+/**
+ * Default browser options
+ */
+const DEFAULT_OPTIONS = {
+    headless: true,
+    slowMo: 0,
+    timeout: 30000,
+    userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 AgentReady/0.1.0',
+    viewport: { width: 1280, height: 720 },
+};
+/**
+ * Create a browser configured for WebMCP auditing
+ *
+ * The browser is launched with the WebMCP flag enabled and has the
+ * interception script injected into every page.
+ */
+export async function createAuditBrowser(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const browser = await chromium.launch({
+        headless: opts.headless,
+        slowMo: opts.slowMo,
+        args: [
+            // Enable WebMCP experimental feature
+            '--enable-features=WebMCP',
+            // Disable various security features that can interfere with auditing
+            '--disable-web-security',
+            '--disable-features=IsolateOrigins,site-per-process',
+            // Performance optimizations for headless
+            '--disable-gpu',
+            '--no-sandbox',
+            '--disable-setuid-sandbox',
+            '--disable-dev-shm-usage',
+        ],
+    });
+    const context = await browser.newContext({
+        userAgent: opts.userAgent,
+        viewport: opts.viewport,
+        ignoreHTTPSErrors: true,
+        javaScriptEnabled: true,
+    });
+    // Set default timeout
+    context.setDefaultTimeout(opts.timeout);
+    // Inject the interception script into every page BEFORE any page scripts run
+    await context.addInitScript(INTERCEPT_SCRIPT);
+    return { browser, context };
+}
+/**
+ * Navigate to a URL and wait for it to be ready
+ */
+export async function navigateAndWait(page, url, options = {}) {
+    const { timeout = 30000, waitUntil = 'networkidle', extraWaitMs = 2000 } = options;
+    await page.goto(url, {
+        timeout,
+        waitUntil,
+    });
+    // Wait a bit more for SPA hydration and lazy tool registration
+    // Many sites register tools after the initial load
+    if (extraWaitMs > 0) {
+        await page.waitForTimeout(extraWaitMs);
+    }
+}
+/**
+ * Retrieve captured WebMCP data from the page
+ */
+export async function getCapturedData(page) {
+    const data = await page.evaluate(() => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const win = window;
+        if (typeof win.__agentready_getData === 'function') {
+            return win.__agentready_getData();
+        }
+        return {
+            hasModelContext: false,
+            hooked: false,
+            tools: [],
+            contextCalls: [],
+            events: [],
+        };
+    });
+    return data;
+}
+/**
+ * Check if the page has feature detection for WebMCP
+ */
+export async function hasFeatureDetection(page) {
+    return page.evaluate(() => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const win = window;
+        if (typeof win.__agentready_checkFeatureDetection === 'function') {
+            return win.__agentready_checkFeatureDetection();
+        }
+        return false;
+    });
+}
+/**
+ * Get the page's HTML content
+ */
+export async function getPageHTML(page) {
+    return page.content();
+}
+/**
+ * Get the page's title
+ */
+export async function getPageTitle(page) {
+    return page.title();
+}
+/**
+ * Take a screenshot of the page
+ */
+export async function takeScreenshot(page, path, options = {}) {
+    await page.screenshot({
+        path,
+        fullPage: options.fullPage ?? false,
+    });
+}
+/**
+ * Close the browser and clean up
+ */
+export async function closeBrowser(browser) {
+    await browser.close();
+}
+/**
+ * Audit a single page and return captured data
+ */
+export async function auditPage(context, url, options = {}) {
+    const page = await context.newPage();
+    try {
+        await navigateAndWait(page, url, options);
+        const [data, html, title, featureDetection] = await Promise.all([
+            getCapturedData(page),
+            getPageHTML(page),
+            getPageTitle(page),
+            hasFeatureDetection(page),
+        ]);
+        if (options.screenshot) {
+            await takeScreenshot(page, options.screenshot);
+        }
+        return {
+            page,
+            data,
+            html,
+            title,
+            hasFeatureDetection: featureDetection,
+        };
+    }
+    catch (error) {
+        await page.close();
+        throw error;
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/dist/browser/playwright.js.map

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

package/dist/cli/commands/audit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Audit Command
+ *
+ * Run a full WebMCP audit on a website.
+ */
+import type { AuditOptions } from '../../core/types/audit.js';
+/**
+ * Run the audit command
+ */
+export declare function runAudit(urlString: string, options: AuditOptions & {
+    animation?: boolean;
+}): Promise<number>;