@petukhovart/agent-view 0.1.0 → 0.3.0

package/.claude-plugin/plugin.json

@@ -1,10 +1,21 @@
 {
   "name": "agent-view",
-  "description": "Multi-platform visual verification CLI for Frontend apps (Electron/Tauri/Browser) via Chrome DevTools Protocol. Inspect DOM, interact with UI, capture screenshots, WebGL libraries support. Use when verifying UI changes, checking visual regressions, testing user interactions, or when any workflow phase needs to inspect the running application.",
+  "description": "Visual verification CLI for desktop apps (Electron/Tauri/Browser) via Chrome DevTools Protocol. Inspect DOM, interact with UI, capture screenshots, and read WebGL scene graphs.",
   "version": "0.1.0",
+  "keywords": [
+    "cdp",
+    "electron",
+    "tauri",
+    "desktop",
+    "testing",
+    "accessibility",
+    "screenshot",
+    "automation"
+  ],
   "author": {
     "name": "PetukhovArt"
   },
   "homepage": "https://github.com/PetukhovArt/agent-view",
+  "repository": "https://github.com/PetukhovArt/agent-view",
   "license": "MIT"
 }

package/README.md

@@ -26,6 +26,43 @@ Code → Launch → See → Verify → Fix → See again
 
 The agent writes code, then immediately checks what the user would see. If something's wrong, it fixes and re-checks — no human needed. This catches problems that builds and tests miss: CSS regressions, broken layouts, missing error messages, silent IPC failures.
 
+## v0.3.0 — DevTools access (eval, console, workers)
+
+Beyond DOM and screenshots, v0.3.0 adds direct access to JS state and console — including SharedWorker / ServiceWorker. Useful when «what's rendered» isn't enough and you need to check what's actually in the store, in a worker, or in the console.
+
+- `eval <expr>` — read state directly (`store.user.role`, computed values, async getters). Gated by `"allowEval": true` in config.
+- `eval --target <worker>` — same, but inside a SharedWorker / ServiceWorker / dedicated Worker.
+- `console` — capture `console.log/warn/error` per page or per worker. `--clear` for baselines, `--level` to filter.
+- `targets` — list every connectable CDP target.
+
+See [Commands](#commands) for flags. Full notes in [CHANGELOG](CHANGELOG.md).
+
+## Performance
+
+AI agents run dozens of `dom → click → dom` verification cycles per session. Every millisecond compounds. agent-view v0.2.0 is built specifically for this pattern.
+
+### Benchmark results (Electron app, ~200 AX nodes)
+
+| Scenario | v0.1.0 | v0.2.0 | vs Playwright* |
+|---|---|---|---|
+| `dom` cold fetch | 10ms | 2ms | ~30–80ms |
+| `dom` warm (cache hit) | 10ms | 1ms | ~30–80ms |
+| Full cycle `dom → click → dom` | 27ms | 17ms | ~75ms |
+| `click --filter "Save"` | 12ms | 17ms† | ~15–30ms |
+
+\* *Playwright estimate based on architectural analysis — no published Electron-specific benchmarks exist*
+† *queryAXTree has CDP overhead that exceeds the benefit on small DOMs; improves on large production DOMs (1000+ nodes)*
+
+### What makes it fast
+
+**AX tree cache (300ms TTL).** The single biggest win. When an agent calls `dom`, then immediately `click --filter`, the second fetch hits the in-process cache instead of making a CDP round-trip. Cache is invalidated aggressively — busted on every `click`, `fill`, or page navigation.
+
+**Parallel CDP calls in click.** Previously 5 serial round-trips; now 3 parallel batches. `DOM.resolveNode` and `DOM.getBoxModel` run concurrently, then mouse events fire back-to-back without waiting for each response (the same approach Playwright uses internally).
+
+**`Accessibility.queryAXTree` for targeted lookups.** Plain string filters (`click --filter "Save"`) and `role:name` filters (`click --filter "button:Save"`) query the browser directly instead of fetching the full tree. Falls back gracefully on older Electron versions.
+
+**Raw CDP, no relay.** No Playwright client-server relay between your agent and the browser. The server process holds the CDP WebSocket connection and reuses it across commands.
+
 ## Enabling CDP
 
 ### Recommended: in code (reliable, works with any build tool)
@@ -71,10 +108,24 @@ If you see a JSON response with browser info — you're good.
 
 ## Install
 
+### As CLI tool
+
 ```bash
-npm install -g agent-view
+npm install -g @petukhovart/agent-view
+```
+
+### As Claude Code plugin
+
+```bash
+# Add marketplace (once)
+/plugin marketplace add PetukhovArt/agent-view
+
+# Install plugin
+/plugin install agent-view@agent-view
 ```
 
+This gives Claude the `/agent-view:verify` skill — it knows when and how to use agent-view for visual verification during development workflows.
+
 ## Quick start
 
 ```bash
@@ -126,6 +177,9 @@ Running `agent-view init` in your project root generates `agent-view.config.json
 | `port` | yes | CDP debugging port |
 | `launch` | no | Command to start the app |
 | `webgl.engine` | no | `"pixi"` (scene extractor architecture supports adding more engines) |
+| `allowEval` | no | `true` to enable `agent-view eval`. Off by default — opt-in for arbitrary JS execution |
+| `consoleBufferSize` | no | Per-target console ring capacity. Default `500` |
+| `consoleTargets` | no | Target types `agent-view console` auto-attaches to. Default `["page", "shared_worker", "service_worker"]` |
 
 ## Commands
 
@@ -150,8 +204,11 @@ agent-view dom
 agent-view dom --filter "Submit"    # Filter by text/role
 agent-view dom --depth 3            # Limit tree depth
 agent-view dom --window "Settings"  # Target specific window
+agent-view dom --text               # Fall back to DOM textContent search when AX returns no match
 ```
 
+When `--filter` is set, depth defaults to unlimited so deep matches aren't truncated.
+
 ### `click`
 
 Clicks a DOM element by ref ID or coordinates.
@@ -171,13 +228,17 @@ agent-view fill 3 "hello@example.com"
 
 ### `screenshot`
 
-Captures a PNG screenshot, saves to temp dir, prints the file path.
+Captures a screenshot, saves to temp dir, prints the file path. PNG by default; JPEG when `--scale` is set.
 
 ```bash
 agent-view screenshot
 agent-view screenshot --window "Settings"
+agent-view screenshot --scale 0.5             # Half-res JPEG (~3× fewer vision tokens)
+agent-view screenshot --scale 0.25            # Quarter-res JPEG (~12× fewer, 1 tile)
 ```
 
+`--scale` accepts a factor in `(0, 1]`. CDP-side clip + JPEG encode — recommended for agent loops where vision tokens dominate cost.
+
 ### `scene`
 
 Reads the WebGL scene graph for canvas-based apps. Currently supports PixiJS via `window.__PIXI_DEVTOOLS__`.
@@ -210,6 +271,44 @@ agent-view wait --filter "Dashboard" --timeout 30 # Custom timeout in seconds
 
 Starts the app using the `launch` command from config. Polls CDP until ready (60s timeout). Idempotent — skips if already running.
 
+### `targets`
+
+Lists every CDP target — pages, iframes, shared/service/dedicated workers. Use this when you need access to non-page targets (e.g. an Electron app with a `SharedWorker`).
+
+```bash
+agent-view targets                                       # all supported types
+agent-view targets --type shared_worker,service_worker   # filter
+agent-view targets --json                                # machine-readable
+```
+
+### `eval`
+
+Runs `Runtime.evaluate` in any connectable target. **Requires `"allowEval": true` in `agent-view.config.json`** — the local socket is shared and this is the project-owner opt-in.
+
+```bash
+agent-view eval "document.title"
+agent-view eval --target IJ56KL "self.constructor.name"           # by id (or title/url substring)
+agent-view eval --window "Monitor 1" --await "fetch('/api/health').then(r => r.status)"
+agent-view eval --json "({ buttons: document.querySelectorAll('button').length })"
+```
+
+Output is capped at 64 KB. Thrown exceptions and syntax errors propagate as non-zero exit with the CDP error message.
+
+### `console`
+
+Streams or dumps console output (`Runtime.consoleAPICalled` + `Log.entryAdded`) from auto-attached targets. Lazy: first call attaches matching targets, subsequent calls reuse them.
+
+```bash
+agent-view console                              # buffered messages since attach
+agent-view console --follow --timeout 10        # stream for 10s
+agent-view console --target IJ56KL              # restrict to one target
+agent-view console --level error,warn           # level filter
+agent-view console --since "2026-04-26T10:00:00Z"
+agent-view console --clear                      # drop in-memory ring
+```
+
+Default attached target types: `page`, `shared_worker`, `service_worker`. Override with `consoleTargets` in config.
+
 ### `stop`
 
 Stops the background lazy server.

package/dist/adapters/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAIhD,eAAO,MAAM,cAAc,EAAE,cAkB5B,CAAA"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKhD,eAAO,MAAM,cAAc,EAAE,cAgB5B,CAAA"}

package/dist/adapters/browser.js

@@ -1,20 +1,20 @@
-import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { listSupportedTargets, connectToPage } from '../cdp/transport.js';
 import { RuntimeType } from '../types.js';
+import { TargetType } from '../cdp/types.js';
 export const browserAdapter = {
     runtime: RuntimeType.Browser,
     async discover(port) {
-        const targets = await listTargets(port);
+        const targets = await listSupportedTargets(port);
         return targets
-            .filter(t => t.type === 'page')
-            .map(t => ({
-            id: t.id,
-            title: t.title,
-            url: t.url,
-            type: t.type,
-        }));
+            .filter(t => t.type === TargetType.Page)
+            .map(t => ({ id: t.id, title: t.title, url: t.url, type: t.type }));
     },
-    async connect(port, windowId) {
-        return connectToTarget(port, windowId);
+    async connect(port, windowId, cache) {
+        const targets = await listSupportedTargets(port);
+        const target = targets.find(t => t.id === windowId);
+        if (!target)
+            throw new Error(`Target not found: ${windowId}`);
+        return connectToPage(port, target, cache);
     },
 };
 //# sourceMappingURL=browser.js.map

package/dist/adapters/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAG1D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,OAAO,EAAE,WAAW,CAAC,OAAO;IAE5B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAA;IACP,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB;QAC1C,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;CACF,CAAA"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAA;AAG9D,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,OAAO,EAAE,WAAW,CAAC,OAAO;IAE5B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAkB;QAC9D,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;QACnD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAA;QAC7D,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;CACF,CAAA"}

package/dist/adapters/electron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"electron.d.ts","sourceRoot":"","sources":["../../src/adapters/electron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAIhD,eAAO,MAAM,eAAe,EAAE,cAkB7B,CAAA"}
+{"version":3,"file":"electron.d.ts","sourceRoot":"","sources":["../../src/adapters/electron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKhD,eAAO,MAAM,eAAe,EAAE,cAgB7B,CAAA"}

package/dist/adapters/electron.js

@@ -1,20 +1,20 @@
-import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { listSupportedTargets, connectToPage } from '../cdp/transport.js';
 import { RuntimeType } from '../types.js';
+import { TargetType } from '../cdp/types.js';
 export const electronAdapter = {
     runtime: RuntimeType.Electron,
     async discover(port) {
-        const targets = await listTargets(port);
+        const targets = await listSupportedTargets(port);
         return targets
-            .filter(t => t.type === 'page')
-            .map(t => ({
-            id: t.id,
-            title: t.title,
-            url: t.url,
-            type: t.type,
-        }));
+            .filter(t => t.type === TargetType.Page)
+            .map(t => ({ id: t.id, title: t.title, url: t.url, type: t.type }));
     },
-    async connect(port, windowId) {
-        return connectToTarget(port, windowId);
+    async connect(port, windowId, cache) {
+        const targets = await listSupportedTargets(port);
+        const target = targets.find(t => t.id === windowId);
+        if (!target)
+            throw new Error(`Target not found: ${windowId}`);
+        return connectToPage(port, target, cache);
     },
 };
 //# sourceMappingURL=electron.js.map

package/dist/adapters/electron.js.map

@@ -1 +1 @@
-{"version":3,"file":"electron.js","sourceRoot":"","sources":["../../src/adapters/electron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAG1D,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,OAAO,EAAE,WAAW,CAAC,QAAQ;IAE7B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAA;IACP,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB;QAC1C,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;CACF,CAAA"}
+{"version":3,"file":"electron.js","sourceRoot":"","sources":["../../src/adapters/electron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAA;AAG9D,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,OAAO,EAAE,WAAW,CAAC,QAAQ;IAE7B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAkB;QAC9D,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;QACnD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAA;QAC7D,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;CACF,CAAA"}

package/dist/adapters/tauri.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tauri.d.ts","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAWhD,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAIzF;AAED,eAAO,MAAM,YAAY,EAAE,cAkB1B,CAAA"}
+{"version":3,"file":"tauri.d.ts","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAYhD,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAIzF;AAED,eAAO,MAAM,YAAY,EAAE,cAgB1B,CAAA"}

package/dist/adapters/tauri.js

@@ -1,5 +1,6 @@
-import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { listSupportedTargets, connectToPage } from '../cdp/transport.js';
 import { RuntimeType } from '../types.js';
+import { TargetType } from '../cdp/types.js';
 /** URLs that Tauri/WebView2 exposes as CDP targets but aren't app windows */
 const INTERNAL_URL_PATTERNS = [
     'about:blank',
@@ -7,7 +8,7 @@ const INTERNAL_URL_PATTERNS = [
     'chrome-extension://',
 ];
 export function isAppTarget(target) {
-    if (target.type !== 'page')
+    if (target.type !== TargetType.Page)
         return false;
     const url = target.url.toLowerCase();
     return !INTERNAL_URL_PATTERNS.some(pattern => url.startsWith(pattern));
@@ -15,18 +16,17 @@ export function isAppTarget(target) {
 export const tauriAdapter = {
     runtime: RuntimeType.Tauri,
     async discover(port) {
-        const targets = await listTargets(port);
+        const targets = await listSupportedTargets(port);
         return targets
             .filter(isAppTarget)
-            .map(t => ({
-            id: t.id,
-            title: t.title,
-            url: t.url,
-            type: t.type,
-        }));
+            .map(t => ({ id: t.id, title: t.title, url: t.url, type: t.type }));
     },
-    async connect(port, windowId) {
-        return connectToTarget(port, windowId);
+    async connect(port, windowId, cache) {
+        const targets = await listSupportedTargets(port);
+        const target = targets.find(t => t.id === windowId);
+        if (!target)
+            throw new Error(`Target not found: ${windowId}`);
+        return connectToPage(port, target, cache);
     },
 };
 //# sourceMappingURL=tauri.js.map

package/dist/adapters/tauri.js.map

@@ -1 +1 @@
-{"version":3,"file":"tauri.js","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAG1D,6EAA6E;AAC7E,MAAM,qBAAqB,GAAG;IAC5B,aAAa;IACb,aAAa;IACb,qBAAqB;CACtB,CAAA;AAED,MAAM,UAAU,WAAW,CAAC,MAAoD;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IACpC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,OAAO,EAAE,WAAW,CAAC,KAAK;IAE1B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,OAAO;aACX,MAAM,CAAC,WAAW,CAAC;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAA;IACP,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB;QAC1C,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;CACF,CAAA"}
+{"version":3,"file":"tauri.js","sourceRoot":"","sources":["../../src/adapters/tauri.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEzE,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAA;AAG9D,6EAA6E;AAC7E,MAAM,qBAAqB,GAAG;IAC5B,aAAa;IACb,aAAa;IACb,qBAAqB;CACtB,CAAA;AAED,MAAM,UAAU,WAAW,CAAC,MAAoD;IAC9E,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IACpC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,OAAO,EAAE,WAAW,CAAC,KAAK;IAE1B,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,OAAO,OAAO;aACX,MAAM,CAAC,WAAW,CAAC;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAkB;QAC9D,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;QACnD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAA;QAC7D,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;CACF,CAAA"}

package/dist/adapters/types.d.ts

@@ -1,8 +1,11 @@
 import type { WindowInfo, RuntimeType } from '../types.js';
-import type { CDPConnection } from '../cdp/types.js';
+import type { PageSession } from '../cdp/types.js';
+import type { AxTreeCache } from '../cdp/ax-cache.js';
 export type RuntimeAdapter = {
     readonly runtime: RuntimeType;
+    /** Discover page-targets only — kept for back-compat. Use `listSupportedTargets` for all targets. */
     discover(port: number): Promise<WindowInfo[]>;
-    connect(port: number, windowId: string): Promise<CDPConnection>;
+    /** Connect to a page-target. Worker targets go through `connectToRuntime` directly. */
+    connect(port: number, windowId: string, cache: AxTreeCache): Promise<PageSession>;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAChE,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC7C,uFAAuF;IACvF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAClF,CAAA"}

package/dist/cdp/_tests/console-stream.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeSession, ConsoleMessage, ConsoleLevel, TargetType } from '../types.js';
+export type ConsoleStreamOptions = {
+    /** Per-target ring size. Default 500. */
+    capacity?: number;
+};
+export type ConsoleFilter = {
+    since?: number;
+    level?: ReadonlySet<ConsoleLevel>;
+    targetId?: string;
+};
+export type StampedConsoleMessage = ConsoleMessage & {
+    targetId: string;
+    targetType: TargetType;
+};
+/**
+ * Multi-target console subscription with per-target ring buffer.
+ * Server owns one instance for its lifetime; commands attach/drain.
+ */
+export declare class ConsoleStream {
+    private readonly capacity;
+    private readonly targets;
+    private readonly extraSubscribers;
+    constructor(opts?: ConsoleStreamOptions);
+    get attachedCount(): number;
+    /** Idempotent per target id — second attach for same id is a no-op. */
+    attach(session: RuntimeSession): void;
+    detach(targetId?: string): void;
+    clear(targetId?: string): void;
+    /** Snapshot of buffered messages, sorted by timestamp (oldest first). */
+    drain(filter?: ConsoleFilter): StampedConsoleMessage[];
+    /** Subscribe to live messages. Returns disposer. Used by --follow streaming. */
+    subscribe(handler: (msg: StampedConsoleMessage) => void): () => void;
+    private snapshot;
+}
+//# sourceMappingURL=console-stream.d.ts.map

package/dist/cdp/_tests/console-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-stream.d.ts","sourceRoot":"","sources":["../../../src/cdp/_tests/console-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI3F,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAUD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkD;gBAEvE,IAAI,GAAE,oBAAyB;IAI3C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,uEAAuE;IACvE,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA6BrC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY/B,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAc9B,yEAAyE;IACzE,KAAK,CAAC,MAAM,GAAE,aAAkB,GAAG,qBAAqB,EAAE;IAe1D,gFAAgF;IAChF,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKpE,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/cdp/_tests/console-stream.js

@@ -0,0 +1,103 @@
+const DEFAULT_CAPACITY = 500;
+/**
+ * Multi-target console subscription with per-target ring buffer.
+ * Server owns one instance for its lifetime; commands attach/drain.
+ */
+export class ConsoleStream {
+    capacity;
+    targets = new Map();
+    extraSubscribers = new Set();
+    constructor(opts = {}) {
+        this.capacity = opts.capacity ?? DEFAULT_CAPACITY;
+    }
+    get attachedCount() {
+        return this.targets.size;
+    }
+    /** Idempotent per target id — second attach for same id is a no-op. */
+    attach(session) {
+        const id = session.target.id;
+        if (this.targets.has(id))
+            return;
+        const entry = {
+            session,
+            ring: new Array(this.capacity),
+            cursor: 0,
+            full: false,
+            dispose: () => { },
+        };
+        entry.dispose = session.onConsole((msg) => {
+            const stamped = {
+                ...msg,
+                targetId: id,
+                targetType: session.target.type,
+            };
+            entry.ring[entry.cursor] = stamped;
+            entry.cursor = (entry.cursor + 1) % this.capacity;
+            if (entry.cursor === 0)
+                entry.full = true;
+            for (const sub of this.extraSubscribers) {
+                try {
+                    sub(stamped);
+                }
+                catch { /* ignore */ }
+            }
+        });
+        this.targets.set(id, entry);
+    }
+    detach(targetId) {
+        if (targetId === undefined) {
+            for (const t of this.targets.values())
+                t.dispose();
+            this.targets.clear();
+            return;
+        }
+        const t = this.targets.get(targetId);
+        if (!t)
+            return;
+        t.dispose();
+        this.targets.delete(targetId);
+    }
+    clear(targetId) {
+        if (targetId === undefined) {
+            for (const t of this.targets.values()) {
+                t.cursor = 0;
+                t.full = false;
+            }
+            return;
+        }
+        const t = this.targets.get(targetId);
+        if (!t)
+            return;
+        t.cursor = 0;
+        t.full = false;
+    }
+    /** Snapshot of buffered messages, sorted by timestamp (oldest first). */
+    drain(filter = {}) {
+        const result = [];
+        for (const [id, entry] of this.targets) {
+            if (filter.targetId && filter.targetId !== id)
+                continue;
+            const msgs = this.snapshot(entry);
+            for (const m of msgs) {
+                if (filter.since !== undefined && m.ts < filter.since)
+                    continue;
+                if (filter.level && !filter.level.has(m.level))
+                    continue;
+                result.push(m);
+            }
+        }
+        result.sort((a, b) => a.ts - b.ts);
+        return result;
+    }
+    /** Subscribe to live messages. Returns disposer. Used by --follow streaming. */
+    subscribe(handler) {
+        this.extraSubscribers.add(handler);
+        return () => this.extraSubscribers.delete(handler);
+    }
+    snapshot(entry) {
+        if (!entry.full)
+            return entry.ring.slice(0, entry.cursor);
+        return [...entry.ring.slice(entry.cursor), ...entry.ring.slice(0, entry.cursor)];
+    }
+}
+//# sourceMappingURL=console-stream.js.map

package/dist/cdp/_tests/console-stream.js.map

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

package/dist/cdp/ax-cache.d.ts

@@ -0,0 +1,9 @@
+import type { AXNode } from './types.js';
+export declare class AxTreeCache {
+    private entries;
+    get(key: string): AXNode[] | null;
+    set(key: string, nodes: AXNode[]): void;
+    invalidate(key: string): void;
+    invalidateAll(): void;
+}
+//# sourceMappingURL=ax-cache.d.ts.map

package/dist/cdp/ax-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ax-cache.d.ts","sourceRoot":"","sources":["../../src/cdp/ax-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AASxC,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAgC;IAE/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAUjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,aAAa,IAAI,IAAI;CAGtB"}

package/dist/cdp/ax-cache.js

@@ -0,0 +1,24 @@
+const AX_CACHE_TTL_MS = 300;
+export class AxTreeCache {
+    entries = new Map();
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > AX_CACHE_TTL_MS) {
+            this.entries.delete(key);
+            return null;
+        }
+        return entry.nodes;
+    }
+    set(key, nodes) {
+        this.entries.set(key, { nodes, timestamp: Date.now() });
+    }
+    invalidate(key) {
+        this.entries.delete(key);
+    }
+    invalidateAll() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=ax-cache.js.map

package/dist/cdp/ax-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ax-cache.js","sourceRoot":"","sources":["../../src/cdp/ax-cache.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,GAAG,CAAA;AAO3B,MAAM,OAAO,WAAW;IACd,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAA;IAE/C,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,eAAe,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAA;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAe;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/cdp/console-stream.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeSession, ConsoleMessage, ConsoleLevel, TargetType } from './types.js';
+export type ConsoleStreamOptions = {
+    /** Per-target ring size. Default 500. */
+    capacity?: number;
+};
+export type ConsoleFilter = {
+    since?: number;
+    level?: ReadonlySet<ConsoleLevel>;
+    targetId?: string;
+};
+export type StampedConsoleMessage = ConsoleMessage & {
+    targetId: string;
+    targetType: TargetType;
+};
+/**
+ * Multi-target console subscription with per-target ring buffer.
+ * Server owns one instance for its lifetime; commands attach/drain.
+ */
+export declare class ConsoleStream {
+    private readonly capacity;
+    private readonly targets;
+    private readonly extraSubscribers;
+    constructor(opts?: ConsoleStreamOptions);
+    get attachedCount(): number;
+    /** Idempotent per target id — second attach for same id is a no-op. */
+    attach(session: RuntimeSession): void;
+    detach(targetId?: string): void;
+    clear(targetId?: string): void;
+    /** Snapshot of buffered messages, sorted by timestamp (oldest first). */
+    drain(filter?: ConsoleFilter): StampedConsoleMessage[];
+    /** Subscribe to live messages. Returns disposer. Used by --follow streaming. */
+    subscribe(handler: (msg: StampedConsoleMessage) => void): () => void;
+    private snapshot;
+}
+//# sourceMappingURL=console-stream.d.ts.map

package/dist/cdp/console-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-stream.d.ts","sourceRoot":"","sources":["../../src/cdp/console-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI1F,MAAM,MAAM,oBAAoB,GAAG;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAUD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkD;gBAEvE,IAAI,GAAE,oBAAyB;IAI3C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,uEAAuE;IACvE,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA6BrC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAY/B,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAc9B,yEAAyE;IACzE,KAAK,CAAC,MAAM,GAAE,aAAkB,GAAG,qBAAqB,EAAE;IAe1D,gFAAgF;IAChF,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKpE,OAAO,CAAC,QAAQ;CAIjB"}