cdp-mcp-server 5.0.3 → 5.1.0

package/README.md

@@ -64,6 +64,20 @@ command lines are never logged — disable with `CDP_PROCESS_SCAN=false`), and
 can connect via the `chrome://inspect` toggle by reading `DevToolsActivePort`.
 `ping`/`status` report the connection mode (`legacy` | `approval`).
 
+## Browser compatibility
+
+| Browser | Flag mode | Toggle (approval) | Process scan | Notes |
+|---------|-----------|-------------------|--------------|-------|
+| Chrome 136+ | ✅ requires non-default `--user-data-dir` | ✅ Chrome 144+ | ✅ | default-profile restriction since Chrome 136 |
+| Brave | ✅ | ✅ (verified on 153) | ✅ (verified on 153) | portapps wrappers: launch inner `app\brave.exe`, not wrapper shortcut |
+| Edge | ✅ | ✅ Chrome 144+ | ✅ | same Chromium behavior |
+| Chromium | ✅ | ✅ Chrome 144+ | ✅ | restriction is Chrome-branding-gated |
+| Vivaldi | ✅ | ✅ Chrome 144+ | ✅ | discovery path added in 5.0.3 |
+| Opera | ✅ | ✅ Chrome 144+ | ✅ | discovery path added in 5.0.3 |
+| Chrome for Testing | ✅ no restriction | — | ✅ | recommended automated/CI setups |
+
+Connection failures auto-detect the failure mode and print the exact fix — see Troubleshooting above.
+
 ## Environment variables
 
 | Variable | Default | Description |

package/dist/config.js

@@ -33,6 +33,8 @@ export function loadConfig() {
         userDataDir: process.env.CDP_USER_DATA || '',
         /** Process command-line scan on discovery failure (default ON). */
         processScan: process.env.CDP_PROCESS_SCAN !== 'false',
+        /** Actionability gate before element interactions (default ON). */
+        autoWait: process.env.CDP_AUTO_WAIT !== 'false',
         slimMode: process.env.CDP_SLIM_MODE === 'true',
     };
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,WAAW;QAC5C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC;QAErD,kBAAkB;QAClB,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,EAAE,EAAE,CAAC;QACtE,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC9E,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1E,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC;QAE/D,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,EAAE,EAAE,CAAC;QACjE,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC;QAE1E,mEAAmE;QACnE,sBAAsB,EACnB,OAAO,CAAC,GAAG,CAAC,oBAAwC,IAAI,QAAQ;QAEnE,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,sBAAsB;QAC/D,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;QAE3C,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QAEjD,0EAA0E;QAC1E,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QAE5C,mEAAmE;QACnE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO;QAErD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM;KAC/C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,WAAW;QAC5C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC;QAErD,kBAAkB;QAClB,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,EAAE,EAAE,CAAC;QACtE,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC9E,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1E,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,EAAE,EAAE,CAAC;QAE/D,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,EAAE,EAAE,CAAC;QACjE,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC;QAE1E,mEAAmE;QACnE,sBAAsB,EACnB,OAAO,CAAC,GAAG,CAAC,oBAAwC,IAAI,QAAQ;QAEnE,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,sBAAsB;QAC/D,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;QAE3C,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QAEjD,0EAA0E;QAC1E,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QAE5C,mEAAmE;QACnE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,OAAO;QAErD,mEAAmE;QACnE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO;QAE/C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM;KAC/C,CAAC;AACJ,CAAC"}

package/dist/connection/capabilities.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CDP domain capability report (5.1.0 B1, redesigned as multi-canary probing).
+ *
+ * `Schema.getDomains` — the original probe — was removed from Chrome years ago:
+ * on any modern Chrome/Brave it replies "'Schema.getDomains' wasn't found"
+ * (confirmed live on Brave 153, approval mode). There is no domain-enumeration
+ * command anymore, so presence is now probed per domain with a real canary
+ * command whose empty-params call is either read-only or rejected by parameter
+ * validation before any handler runs — a probe never mutates meaningful state.
+ *
+ * Classification:
+ * - `"'X' wasn't found"` → domain/method absent
+ * - any other outcome (success / Invalid parameters / domain-specific error)
+ *   → domain present
+ *
+ * Cache lives on the instance and is invalidated on disconnect
+ * (wired in index.ts next to the other per-connection caches).
+ */
+import type { CDPClient } from './cdp-client.js';
+/** Domains whose absence is worth surfacing in `status` output. */
+export declare const NOTABLE_DOMAINS: readonly ["WebAuthn", "FedCm", "WebMCP", "Preload", "Ads", "Extensions", "PWA", "FindInPage", "Tracing", "Overlay"];
+export type NotableDomain = (typeof NOTABLE_DOMAINS)[number];
+/** True when a CDP error means "domain or method not implemented". */
+export declare function isMethodMissingError(err: unknown): boolean;
+export declare class DomainCapabilities {
+    /** Probe key (domain or Domain.method) → present? */
+    private cache;
+    private inFlight;
+    /**
+     * Probe a single canary / method. Empty params on purpose:
+     * required-params canaries fail validation (proving presence), read-only
+     * canaries succeed (proving presence), unknown methods report "wasn't found".
+     *
+     * Pass a page-session id when probing page-scoped domains: the browser-level
+     * endpoint only serves browser-wide domains (Target/Browser/SystemInfo/
+     * Tracing/Extensions...), so page-scoped domains report "wasn't found"
+     * without a session (live-confirmed: browser-level probes said 2/10).
+     */
+    hasMethod(client: CDPClient, method: string, sessionId?: string): Promise<boolean>;
+    /**
+     * True when the connected browser supports the given domain. Domain names
+     * resolve through their canary; dotted "Domain.method" keys probe directly
+     * (useful for version-gated methods like Emulation.setCPUPerformanceOverride).
+     */
+    has(client: CDPClient, key: string, sessionId?: string): Promise<boolean>;
+    /** Feature-gate helper: throws an actionable error when absent. */
+    require(client: CDPClient, key: string, minChrome?: string, sessionId?: string): Promise<void>;
+    /** Invalidate on disconnect/reconnect. */
+    clear(): void;
+    /**
+     * Summary for the `status` tool: how many of the notable domains are
+     * present, and which are missing. Every entry is individually probed.
+     */
+    summarize(client: CDPClient, sessionId?: string): Promise<{
+        count: number;
+        missing: string[];
+    }>;
+}

package/dist/connection/capabilities.js

@@ -0,0 +1,126 @@
+/** Domains whose absence is worth surfacing in `status` output. */
+export const NOTABLE_DOMAINS = [
+    'WebAuthn',
+    'FedCm',
+    'WebMCP',
+    'Preload',
+    'Ads',
+    'Extensions',
+    'PWA',
+    'FindInPage',
+    'Tracing',
+    'Overlay',
+];
+/**
+ * Canary command per domain (method names verified against the Chromium
+ * browser-protocol surface shipped with Playwright 1.65):
+ *
+ * - requires parameters → `{}` is rejected with "Invalid parameters" before
+ *   the handler runs (zero side effect): WebAuthn.addVirtualAuthenticator
+ *   (options), FedCm.selectAccount (dialogId+accountIndex),
+ *   WebMCP.invokeTool (frameId+toolName+input), Extensions.loadUnpacked
+ *   (path), PWA.getOsAppState (manifestId), FindInPage.findFirst (query),
+ *   Overlay.setInspectMode (mode)
+ * - read-only with no required params → succeeds harmlessly:
+ *   Ads.getAdScripts, Tracing.getCategories
+ * - Preload.enable is the one intentional soft exception: it succeeds and
+ *   merely enables speculative preloading for the session (the browser's
+ *   own default behavior).
+ */
+const CANARIES = {
+    WebAuthn: 'WebAuthn.addVirtualAuthenticator',
+    FedCm: 'FedCm.selectAccount',
+    WebMCP: 'WebMCP.invokeTool',
+    Preload: 'Preload.enable',
+    Ads: 'Ads.getAdScripts',
+    Extensions: 'Extensions.loadUnpacked',
+    PWA: 'PWA.getOsAppState',
+    FindInPage: 'FindInPage.findFirst',
+    Overlay: 'Overlay.setInspectMode',
+    Tracing: 'Tracing.getCategories',
+};
+/** True when a CDP error means "domain or method not implemented". */
+export function isMethodMissingError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return /wasn'?t found|not found/i.test(msg);
+}
+export class DomainCapabilities {
+    /** Probe key (domain or Domain.method) → present? */
+    cache = new Map();
+    inFlight = new Map();
+    /**
+     * Probe a single canary / method. Empty params on purpose:
+     * required-params canaries fail validation (proving presence), read-only
+     * canaries succeed (proving presence), unknown methods report "wasn't found".
+     *
+     * Pass a page-session id when probing page-scoped domains: the browser-level
+     * endpoint only serves browser-wide domains (Target/Browser/SystemInfo/
+     * Tracing/Extensions...), so page-scoped domains report "wasn't found"
+     * without a session (live-confirmed: browser-level probes said 2/10).
+     */
+    async hasMethod(client, method, sessionId) {
+        const cached = this.cache.get(method);
+        if (cached !== undefined)
+            return cached;
+        const pending = this.inFlight.get(method);
+        if (pending)
+            return pending;
+        const probe = (async () => {
+            try {
+                await client.send(method, {}, sessionId);
+                return true;
+            }
+            catch (err) {
+                if (isMethodMissingError(err))
+                    return false;
+                // Invalid parameters / domain-specific error → the method exists
+                return true;
+            }
+            finally {
+                this.inFlight.delete(method);
+            }
+        })();
+        this.inFlight.set(method, probe);
+        const present = await probe;
+        this.cache.set(method, present);
+        return present;
+    }
+    /**
+     * True when the connected browser supports the given domain. Domain names
+     * resolve through their canary; dotted "Domain.method" keys probe directly
+     * (useful for version-gated methods like Emulation.setCPUPerformanceOverride).
+     */
+    async has(client, key, sessionId) {
+        if (key.includes('.'))
+            return this.hasMethod(client, key, sessionId);
+        const canary = CANARIES[key];
+        if (!canary)
+            return false; // no canary → unknown, treated as absent
+        return this.hasMethod(client, canary, sessionId);
+    }
+    /** Feature-gate helper: throws an actionable error when absent. */
+    async require(client, key, minChrome, sessionId) {
+        if (await this.has(client, key, sessionId))
+            return;
+        const versionNote = minChrome ? ` (requires Chrome ${minChrome}+)` : '';
+        const err = new Error(`This browser does not support the CDP "${key}" feature${versionNote}. ` +
+            `Update Chrome/Brave or use a feature-gated alternative.`);
+        err.name = 'DomainUnsupportedError';
+        throw err;
+    }
+    /** Invalidate on disconnect/reconnect. */
+    clear() {
+        this.cache.clear();
+        this.inFlight.clear();
+    }
+    /**
+     * Summary for the `status` tool: how many of the notable domains are
+     * present, and which are missing. Every entry is individually probed.
+     */
+    async summarize(client, sessionId) {
+        const results = await Promise.all(NOTABLE_DOMAINS.map(async (d) => [d, await this.has(client, d, sessionId)]));
+        const missing = results.filter(([, present]) => !present).map(([d]) => d);
+        return { count: results.length - missing.length, missing };
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/connection/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/connection/capabilities.ts"],"names":[],"mappings":"AAoBA,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU;IACV,OAAO;IACP,QAAQ;IACR,SAAS;IACT,KAAK;IACL,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,SAAS;IACT,SAAS;CACD,CAAC;AAIX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,QAAQ,GAAkC;IAC9C,QAAQ,EAAE,kCAAkC;IAC5C,KAAK,EAAE,qBAAqB;IAC5B,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,gBAAgB;IACzB,GAAG,EAAE,kBAAkB;IACvB,UAAU,EAAE,yBAAyB;IACrC,GAAG,EAAE,mBAAmB;IACxB,UAAU,EAAE,sBAAsB;IAClC,OAAO,EAAE,wBAAwB;IACjC,OAAO,EAAE,uBAAuB;CACjC,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,kBAAkB;IAC7B,qDAAqD;IAC7C,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACnC,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS,CAAC,MAAiB,EAAE,MAAc,EAAE,SAAkB;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;gBACzC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,oBAAoB,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC5C,iEAAiE;gBACjE,OAAO,IAAI,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,MAAiB,EAAE,GAAW,EAAE,SAAkB;QAC1D,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAoB,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,CAAC,yCAAyC;QACpE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,OAAO,CAAC,MAAiB,EAAE,GAAW,EAAE,SAAkB,EAAE,SAAkB;QAClF,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC;YAAE,OAAO;QACnD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,qBAAqB,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,0CAA0C,GAAG,YAAY,WAAW,IAAI;YACtE,yDAAyD,CAC5D,CAAC;QACF,GAAG,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACpC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,0CAA0C;IAC1C,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,MAAiB,EAAE,SAAkB;QACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAU,CAAC,CACrF,CAAC;QACF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7D,CAAC;CACF"}

package/dist/connection/index.d.ts

@@ -6,6 +6,7 @@ export type { ConnectionState, CDPClientOptions } from './cdp-client.js';
 export { discoverBrowserInstances, resolveWsUrl, resolveWsUrlAsync, findBestInstance, parseBrowserCommandLine, scanBrowserProcesses, } from './browser-discovery.js';
 export type { DiscoverOptions, WsUrlResult, CommandLineInfo, ProcessScanResult, } from './browser-discovery.js';
 export { HealthMonitor } from './health-monitor.js';
+export { DomainCapabilities } from './capabilities.js';
 export type { HealthStatus, HealthState, HealthMonitorOptions, ConnectionMode, } from './health-monitor.js';
 export { DomainManager } from './domain-manager.js';
 export { TabSessionService } from './tab-session-service.js';

package/dist/connection/index.js

@@ -4,6 +4,7 @@
 export { CDPClient } from './cdp-client.js';
 export { discoverBrowserInstances, resolveWsUrl, resolveWsUrlAsync, findBestInstance, parseBrowserCommandLine, scanBrowserProcesses, } from './browser-discovery.js';
 export { HealthMonitor } from './health-monitor.js';
+export { DomainCapabilities } from './capabilities.js';
 export { DomainManager } from './domain-manager.js';
 export { TabSessionService } from './tab-session-service.js';
 //# sourceMappingURL=index.js.map

package/dist/connection/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/connection/tab-session-service.d.ts

@@ -19,6 +19,10 @@ export declare class TabSessionService {
     private childToParent;
     /** uid → childSessionId routing for cross-frame element resolution */
     private refSessionRouting;
+    /** CDP sessionId → tabId (reverse lookup for auto-attach event routing) */
+    private sessionToTab;
+    /** CDP clients already wired for auto-attach event routing */
+    private wiredClients;
     /**
      * Get (or create) a CDP session for a tab.
      *
@@ -32,9 +36,15 @@ export declare class TabSessionService {
      */
     ensureDomain(cdpClient: CDPClient, tabId: string, domain: string): Promise<void>;
     /**
-     * Enable Target.setAutoAttach on a tab session to discover OOP iframes.
+     * Register Target.autoAttach event routing (idempotent per CDP client).
+     *
+     * `Target.attachedToTarget` events emitted by managed page sessions are
+     * translated into child-session registrations (OOP iframes);
+     * `Target.detachedFromTarget` prunes them. This is what feeds
+     * `captureFullTree`'s multi-frame snapshot and the uid → child-session
+     * routing used for cross-frame element interaction.
      */
-    setupAutoAttach(cdpClient: CDPClient, tabId: string): Promise<void>;
+    private wireAutoAttachEvents;
     /** Track a child session (OOP iframe) under a parent session. */
     addChildSession(parentSessionId: string, childTargetId: string, childSessionId: string, url: string): void;
     /** Remove a child session when an OOP iframe detaches. */

package/dist/connection/tab-session-service.js

@@ -18,6 +18,10 @@ export class TabSessionService {
     childToParent = new Map();
     /** uid → childSessionId routing for cross-frame element resolution */
     refSessionRouting = new Map();
+    /** CDP sessionId → tabId (reverse lookup for auto-attach event routing) */
+    sessionToTab = new Map();
+    /** CDP clients already wired for auto-attach event routing */
+    wiredClients = new WeakSet();
     /**
      * Get (or create) a CDP session for a tab.
      *
@@ -25,21 +29,28 @@ export class TabSessionService {
      * Otherwise calls Target.attachToTarget with flatten: true.
      */
     async getSession(cdpClient, tabId) {
+        // Idempotent: register auto-attach event routing before any session can
+        // emit Target.attachedToTarget (no missed events on first attach)
+        this.wireAutoAttachEvents(cdpClient);
         // Check the CDPClient's own session pool first, then our map
         const pooled = cdpClient.getPooledSession(tabId);
         if (pooled) {
             this.sessions.set(tabId, pooled);
+            this.sessionToTab.set(pooled, tabId);
             return pooled;
         }
         const existing = this.sessions.get(tabId);
-        if (existing)
+        if (existing) {
+            this.sessionToTab.set(existing, tabId);
             return existing;
+        }
         const result = await cdpClient.send('Target.attachToTarget', {
             targetId: tabId,
             flatten: true,
         });
         const sessionId = result.sessionId;
         this.sessions.set(tabId, sessionId);
+        this.sessionToTab.set(sessionId, tabId);
         cdpClient.poolSession(tabId, sessionId);
         // Enable auto-attach for OOP (cross-origin) iframe discovery
         try {
@@ -72,20 +83,41 @@ export class TabSessionService {
         // Domain manager already tracks via ensureDomain if needed externally
     }
     /**
-     * Enable Target.setAutoAttach on a tab session to discover OOP iframes.
+     * Register Target.autoAttach event routing (idempotent per CDP client).
+     *
+     * `Target.attachedToTarget` events emitted by managed page sessions are
+     * translated into child-session registrations (OOP iframes);
+     * `Target.detachedFromTarget` prunes them. This is what feeds
+     * `captureFullTree`'s multi-frame snapshot and the uid → child-session
+     * routing used for cross-frame element interaction.
      */
-    async setupAutoAttach(cdpClient, tabId) {
-        const sessionId = await this.getSession(cdpClient, tabId);
-        try {
-            await cdpClient.send('Target.setAutoAttach', {
-                autoAttach: true,
-                waitForDebuggerOnStart: false,
-                flatten: true,
-            }, sessionId);
-        }
-        catch {
-            // Older Chrome versions may not support auto-attach on page sessions
-        }
+    wireAutoAttachEvents(cdpClient) {
+        if (this.wiredClients.has(cdpClient))
+            return;
+        this.wiredClients.add(cdpClient);
+        cdpClient.on('event', (event) => {
+            if (event.method === 'Target.attachedToTarget' && event.sessionId) {
+                const parentSessionId = event.sessionId;
+                // Only page sessions we manage — browser-level / foreign events ignored
+                if (!this.sessionToTab.has(parentSessionId))
+                    return;
+                const params = event.params;
+                if (!params?.sessionId || !params.targetInfo?.targetId)
+                    return;
+                if (params.targetInfo.type !== 'iframe')
+                    return;
+                this.addChildSession(parentSessionId, params.targetInfo.targetId, params.sessionId, params.targetInfo.url ?? '');
+            }
+            else if (event.method === 'Target.detachedFromTarget') {
+                const params = event.params;
+                if (!params?.sessionId)
+                    return;
+                const parentSessionId = this.getParentSession(params.sessionId);
+                if (parentSessionId) {
+                    this.removeChildSession(parentSessionId, params.sessionId);
+                }
+            }
+        });
     }
     /** Track a child session (OOP iframe) under a parent session. */
     addChildSession(parentSessionId, childTargetId, childSessionId, url) {
@@ -148,6 +180,7 @@ export class TabSessionService {
                 this.childSessions.delete(sessionId);
             }
             this.refSessionRouting.delete(sessionId);
+            this.sessionToTab.delete(sessionId);
             cdpClient?.unpoolSession(tabId);
         }
         this.sessions.delete(tabId);
@@ -167,6 +200,7 @@ export class TabSessionService {
         this.childSessions.clear();
         this.childToParent.clear();
         this.refSessionRouting.clear();
+        this.sessionToTab.clear();
     }
     /** Iterate over all [tabId, sessionId] pairs. */
     entries() {

package/dist/connection/tab-session-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"tab-session-service.js","sourceRoot":"","sources":["../../src/connection/tab-session-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tab-session-service.js","sourceRoot":"","sources":["../../src/connection/tab-session-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,OAAO,iBAAiB;IAC5B,uCAAuC;IAC/B,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,qDAAqD;IAC7C,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExD,0FAA0F;IAClF,aAAa,GAAG,IAAI,GAAG,EAA2D,CAAC;IAE3F,sEAAsE;IAC9D,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,sEAAsE;IAC9D,iBAAiB,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEnE,2EAA2E;IACnE,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEjD,8DAA8D;IACtD,YAAY,GAAG,IAAI,OAAO,EAAa,CAAC;IAEhD;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoB,EAAE,KAAa;QAClD,wEAAwE;QACxE,kEAAkE;QAClE,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAErC,6DAA6D;QAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACvC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,uBAAuB,EAAE;YAC3D,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SACd,CAA0B,CAAC;QAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACxC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAExC,6DAA6D;QAC7D,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAC3C,UAAU,EAAE,IAAI;gBAChB,sBAAsB,EAAE,KAAK;gBAC7B,OAAO,EAAE,IAAI;aACd,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,SAAoB,EACpB,KAAa,EACb,MAAc;QAEd,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,IAAI,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QAEhC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,sEAAsE;IACxE,CAAC;IAED;;;;;;;;OAQG;IACK,oBAAoB,CAAC,SAAoB;QAC/C,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO;QAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAe,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,MAAM,KAAK,yBAAyB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClE,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC;gBACxC,wEAAwE;gBACxE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC;oBAAE,OAAO;gBACpD,MAAM,MAAM,GAAG,KAAK,CAAC,MAGpB,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ;oBAAE,OAAO;gBAC/D,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO;gBAChD,IAAI,CAAC,eAAe,CAClB,eAAe,EACf,MAAM,CAAC,UAAU,CAAC,QAAQ,EAC1B,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CAC5B,CAAC;YACJ,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,2BAA2B,EAAE,CAAC;gBACxD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgC,CAAC;gBACtD,IAAI,CAAC,MAAM,EAAE,SAAS;oBAAE,OAAO;gBAC/B,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAChE,IAAI,eAAe,EAAE,CAAC;oBACpB,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,eAAe,CAAC,eAAuB,EAAE,aAAqB,EAAE,cAAsB,EAAE,GAAW;QACjG,IAAI,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC1D,CAAC;IAED,0DAA0D;IAC1D,kBAAkB,CAAC,eAAuB,EAAE,wBAAgC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,oDAAoD;QACpD,IAAI,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAE,CAAC;YACnD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,SAAS,KAAK,wBAAwB,EAAE,CAAC;oBAChD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC1C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,gBAAgB,CAAC,eAAuB;QACtC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IAC9D,CAAC;IAED,8EAA8E;IAC9E,aAAa,CAAC,eAAuB,EAAE,OAA4B;QACjE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,8EAA8E;IAC9E,aAAa,CAAC,eAAuB,EAAE,GAAW;QAChD,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,sDAAsD;IACtD,gBAAgB,CAAC,cAAsB;QACrC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,KAAa,EAAE,SAAqB;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtC,uCAAuC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;oBACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACpC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,4CAA4C;IAC5C,GAAG,CAAC,KAAa;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,KAAa;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.js

@@ -30,6 +30,7 @@ import { SessionManager } from './session/session-manager.js';
 import { TabOwnership } from './session/tab-ownership.js';
 import { ModalStateManager } from './session/modal-state.js';
 import { HealthMonitor } from './connection/health-monitor.js';
+import { DomainCapabilities } from './connection/capabilities.js';
 import { SnapshotCache } from './snapshot/cache.js';
 import { ToolRegistry } from './tools/registry.js';
 import { preprocessToolCall } from './tools/dispatch.js';
@@ -50,7 +51,7 @@ import { registerDebugTools } from './tools/debug.js';
 import { registerFormTools } from './tools/form.js';
 import { getSlimTools, mapSlimToFull } from './tools/slim-mode.js';
 // ─── Bootstrap ──────────────────────────────────────────────────────
-const VERSION = '5.0.3';
+const VERSION = '5.1.0';
 const config = loadConfig();
 const cdpClient = new CDPClient({ commandTimeout: config.globalTimeout });
 // Lazy initialization: HealthMonitor is created but doesn't discover browsers
@@ -64,6 +65,8 @@ const healthMonitor = new HealthMonitor(cdpClient, {
 const domainManager = new DomainManager();
 const tabSessionService = new TabSessionService();
 const snapshotCache = new SnapshotCache();
+// CDP domain capability report (5.1.0 B1) — invalidated on disconnect below
+const capabilities = new DomainCapabilities();
 const registry = new ToolRegistry();
 // Wire auto-reconnect: when the WebSocket drops, let HealthMonitor retry
 // and clear domain state since all sessions are invalidated
@@ -74,6 +77,7 @@ cdpClient.on('disconnected', () => {
     eventPipelineWired = false;
     domainManager.clearAll();
     snapshotCache.clear();
+    capabilities.clear();
     tabSessionService.clear();
     healthMonitor.onDisconnect().catch(() => {
         // Reconnect failed — next tool call will trigger autoConnect
@@ -406,6 +410,7 @@ function wireEventPipeline(serverCtx) {
 }
 // ─── Server Context (DI container) ──────────────────────────────────
 const ctx = {
+    capabilities,
     config,
     cdpClient,
     healthMonitor,
@@ -422,6 +427,7 @@ const ctx = {
     networkReqs: new Map(),
     downloads: new Map(),
     pendingDialogs: new Map(),
+    findState: new Map(),
     pendingFileChoosers: new Map(),
     pausedTabs: new Map(),
     pendingFetchRequests: new Map(),
@@ -442,12 +448,13 @@ async function ensureConnected() {
     }
 }
 // ─── Demo Tools ─────────────────────────────────────────────────────
+const AUTO_CONNECT_HINT = '\nBrowser connects automatically when you use any browser tool — just call tabs.list or page.goto.';
 registry.register(defineTool({
     name: 'ping',
     description: 'Health check. Returns server version and connection status.',
     inputSchema: { type: 'object', properties: {} },
     handler: async () => success(`pong — CDP Browser MCP v${VERSION}\nConnected: ${cdpClient.isConnected}` +
-        (cdpClient.isConnected ? `\nMode: ${healthMonitor.connectionMode}` : '')),
+        (cdpClient.isConnected ? `\nMode: ${healthMonitor.connectionMode}` : AUTO_CONNECT_HINT)),
 }));
 registry.register(defineTool({
     name: 'status',
@@ -459,13 +466,41 @@ registry.register(defineTool({
             `Connected: ${cdpClient.isConnected}`,
             ...(cdpClient.isConnected
                 ? [`Connection mode: ${healthMonitor.connectionMode}`]
-                : []),
+                : [AUTO_CONNECT_HINT.trim()]),
             `Process scan: ${config.processScan ? 'on' : 'off'}`,
             `Default timeout: ${config.globalTimeout}ms`,
             `Default cleanup: ${config.defaultCleanupStrategy}`,
             `Session TTL: ${config.sessionTTL}ms`,
             `Registered tools: ${registry.size}`,
         ];
+        if (cdpClient.isConnected) {
+            try {
+                // Probe through a managed page session - the browser-level endpoint
+                // only serves browser-wide domains, so page-scoped domains (Overlay,
+                // FindInPage, Ads, ...) report "wasn't found" without one.
+                let firstSession = tabSessionService.entries().next().value?.[1];
+                if (!firstSession) {
+                    // No managed tab yet - attach to any open page tab just for probing
+                    // (canaries are read-only or validation-rejected; attaching is inert)
+                    try {
+                        const { targetInfos } = (await cdpClient.send('Target.getTargets', {}));
+                        const pageTarget = targetInfos?.find((t) => t.type === 'page');
+                        if (pageTarget) {
+                            firstSession = (await tabSessionService.getSession(cdpClient, pageTarget.targetId));
+                        }
+                    }
+                    catch { /* fall back to browser-level probe */ }
+                }
+                const { count, missing } = await capabilities.summarize(cdpClient, firstSession);
+                lines.push(`CDP features (probed${firstSession ? ' on page session' : ' browser-level - no page session'}): ${count}/${count + missing.length}`);
+                if (missing.length > 0) {
+                    lines.push(`Notable domains missing: ${missing.join(', ')}`);
+                }
+            }
+            catch (e) {
+                lines.push('CDP features: unavailable (' + (e instanceof Error ? e.message : String(e)) + ')');
+            }
+        }
         return success(lines.join('\n'));
     },
 }));
@@ -506,7 +541,12 @@ else {
     registerFormTools(registry, ctx);
 }
 // ─── MCP Server─────────────────────────────────────────────────────
-const server = new Server({ name: 'cdp-browser', version: VERSION }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'cdp-browser', version: VERSION }, {
+    capabilities: { tools: {} },
+    instructions: `CDP Browser MCP attaches your REAL running browser (cookies, logins, extensions stay). 14 tools: tabs, page, interact, form, execute, observe, emulate, storage, intercept, debug, browser, cleanup, ping, status. The browser connects automatically on the first browser-tool call - ping/status may say Connected: false before that; just call any browser tool.
+
+CALLING CONVENTION (critical): every tool is ONE tool with an action enum parameter - there are NO per-action subtools. Call like tools["cdp-browser"].tabs({ action: "list" }), tools["cdp-browser"].page({ action: "goto", tabId, url }), tools["cdp-browser"].interact({ action: "click", tabId, uid }). WRONG: tabs.list(), tabs(), page.goto(url) - these tool names do not exist and fail schema validation. If unsure of an action or parameter, read the tool's description/enum first; tabs without action defaults to listing. Two connection modes: launch flag (--remote-debugging-port + explicit --user-data-dir) or the browser built-in chrome://inspect/#remote-debugging toggle (a permission dialog appears - click Allow).`,
+});
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: config.slimMode
         ? registry.list().filter(t => t.name.startsWith('browser_') || t.name === 'ping' || t.name === 'status')