@petukhovart/agent-view 0.1.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,14 @@
+{
+  "name": "agent-view",
+  "owner": {
+    "name": "PetukhovArt",
+    "url": "https://github.com/PetukhovArt"
+  },
+  "plugins": [
+    {
+      "name": "agent-view",
+      "source": "./",
+      "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."
+    }
+  ]
+}

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.",
-  "version": "0.1.0",
+  "description": "Visual verification CLI for desktop apps (Electron/Tauri/Browser) via Chrome DevTools Protocol. Ships two skills: verify (run DOM, screenshot, eval, watch, console checks against a live app) and verify-recipe (author a disciplined verification plan as a .md file).",
+  "version": "0.5.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

@@ -1,13 +1,24 @@
 # agent-view
 
-**Give your AI agent eyes and hands for desktop apps.**
+**Give your AI agent eyes and hands for complex desktop apps verification**
 
 AI coding agents can write code, run tests, and read logs — but they can't *see* what the app actually looks like. Without visual verification, an agent is essentially **coding blind** — builds pass, tests are green, but the login form is broken, the button is off-screen, or the modal never appears.
 
-agent-view bridges that gap: it connects to any Chromium-based desktop app via Chrome DevTools Protocol and lets the agent inspect the UI, take screenshots, click buttons, and fill forms.
+agent-view bridges that gap: it connects to any Chromium-based desktop app via Chrome DevTools Protocol and lets the agent inspect, interact, and verify.
 
 Built for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), but works with any AI agent or automation pipeline that can call CLI commands.
 
+## What it does
+
+- **DOM accessibility tree** with ref IDs — compact, LLM-friendly, with text/role filters; `--compact` merges single-child chains for 40–60% fewer tokens, `--count` returns just the match count, `--max-lines` caps output, `--diff` emits only what changed since the last call
+- **Screenshots** — full-res PNG, scaled WebP (~3–12× fewer vision tokens), or `--crop <filter>` to a single element bounding box
+- **Interaction** — click, fill, and drag by ref or coordinates; works with Vue/React/native frameworks
+- **JS state via `eval`** — read store contents, computed values, async results without scraping the DOM
+- **Reactive state via `watch`** — stream JSON-patch diffs of any expression (store, ref, computed) until a condition is met
+- **Console capture** — `console.log/warn/error` per page and per worker, with level/since filters and `--follow --until <pattern>` for early exit on a matching log
+- **Worker access** — SharedWorker, ServiceWorker, dedicated Worker visible alongside pages; fuzzy `--target` resolution everywhere (id → title → URL)
+- **Canvas / WebGL scene graph** — PixiJS today, engine-pluggable; `--compact` mirrors the DOM mode
+
 ## Why CLI, not MCP?
 
 Most alternatives in this space are MCP servers with 30+ tool definitions loaded into context on every session. That burns tokens before the agent even starts working.
@@ -16,31 +27,70 @@ agent-view is a CLI. One Bash call, compact text output, zero schema overhead. T
 
 And CLI works everywhere — Claude Code, Copilot, Codex, custom pipelines, CI. No MCP client required.
 
-## The feedback loop
+## Install & Update
+
+### Claude Code (recommended)
+
+Two steps — both required:
+
+```bash
+# 1. Install the plugin — adds two skills: verify (run checks against a live app) and verify-recipe (author a verification plan)
+/plugin marketplace add PetukhovArt/agent-view
+/plugin install agent-view@agent-view
+
+# 2. Install the CLI — the skill calls these binaries; the plugin doesn't bundle them
+npm install -g @petukhovart/agent-view
+```
+
+The plugin ships two skills. **`verify`** executes visual and runtime checks against a running app. **`verify-recipe`** generates a `.claude/verify-recipes/<slug>.md` file — a disciplined, cheapest-first command sequence for a feature or bugfix — that you or any AI agent can run later. Trigger it with phrases like "write a verify-recipe for the login fix" or "generate a verification plan for this feature".
 
-The real power isn't in individual commands — it's in the **loop**:
+Verify:
 
+```bash
+agent-view --version   # 0.5.0+
 ```
-Code → Launch → See → Verify → Fix → See again
+
+### Standalone CLI (any other agent, CI, or scripting)
+
+```bash
+npm install -g @petukhovart/agent-view
 ```
 
-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.
+Everything works from this alone — `agent-view dom`, `screenshot`, `eval`, etc. Skip the plugin step.
+
+### Update
+
+```bash
+# Update the CLI to the latest version
+npm update -g @petukhovart/agent-view
+
+# Update the Claude Code plugin (refreshes skills from the marketplace)
+/plugin marketplace update agent-view
+/plugin install agent-view@agent-view   # re-run to pick up new skill versions
+```
+
+The two are independent — bump the CLI when a new release ships features (see `CHANGELOG.md`), bump the plugin when skill instructions change.
 
 ## Enabling CDP
 
+agent-view talks to your app over Chrome DevTools Protocol. Your app must be launched with a debugging port open.
+
 ### Recommended: in code (reliable, works with any build tool)
 
 Add to your Electron main process:
 
 ```js
-app.commandLine.appendSwitch('remote-debugging-port', '9222');
+app.commandLine.appendSwitch('remote-debugging-port', '9876');
 ```
 
+> Any free port works — `9876` is just an example. Avoid `9222` (Chrome's own default remote-debugging port) to prevent
+> collisions when Chrome is open.
+
 For dev-only:
 
 ```js
 if (!app.isPackaged) {
-  app.commandLine.appendSwitch('remote-debugging-port', '9222');
+    app.commandLine.appendSwitch('remote-debugging-port', '9876');
 }
 ```
 
@@ -48,32 +98,26 @@ if (!app.isPackaged) {
 
 ```bash
 # Plain Electron
-electron . --remote-debugging-port=9222
+electron . --remote-debugging-port=9876
 
 # electron-vite (note the -- to forward the flag past the build tool)
-npx electron-vite dev -- --remote-debugging-port=9222
+npx electron-vite dev -- --remote-debugging-port=9876
 ```
 
 ### Other runtimes
 
-| Runtime | Setup |
-|---------|-------|
-| **Tauri** | CDP via devtools configuration |
-| **Any Chromium app** | `--remote-debugging-port=9222` launch flag |
+| Runtime              | Setup                                      |
+|----------------------|--------------------------------------------|
+| **Tauri**            | CDP via devtools configuration             |
+| **Any Chromium app** | `--remote-debugging-port=9876` launch flag |
 
 ### Verify CDP is working
 
 ```bash
-curl -s http://localhost:9222/json/version
+curl -s http://localhost:9876/json/version
 ```
 
-If you see a JSON response with browser info — you're good.
-
-## Install
-
-```bash
-npm install -g agent-view
-```
+If you see a JSON response with process info — you're good.
 
 ## Quick start
 
@@ -93,7 +137,7 @@ agent-view screenshot        # PNG screenshot
 
 # 4. Interact
 agent-view click 5           # Click element by ref
-agent-view fill 3 "hello"   # Type into input
+agent-view fill 3 "hello"    # Type into input
 
 # 5. Verify the result
 agent-view dom --filter "success"   # Check for expected element
@@ -110,25 +154,47 @@ A background server connects to your app's CDP port, caches sessions, and auto-s
 
 ## Config
 
-Running `agent-view init` in your project root generates `agent-view.config.json`:
+Running `agent-view init` in your project root generates `agent-view.config.json`. Minimal form:
 
 ```json
 {
   "runtime": "electron",
-  "port": 9222,
+  "port": 9876,
   "launch": "npm run dev"
 }
 ```
 
-| Field | Required | Description |
-|-------|----------|-------------|
-| `runtime` | yes | `"electron"`, `"tauri"`, or `"browser"` |
-| `port` | yes | CDP debugging port |
-| `launch` | no | Command to start the app |
-| `webgl.engine` | no | `"pixi"` (scene extractor architecture supports adding more engines) |
+Full form with all optional fields:
+
+```json
+{
+  "runtime": "electron",
+  "port": 9876,
+  "launch": "npm run dev",
+  "allowEval": true,
+  "webgl": {
+    "engine": "pixi"
+  },
+  "consoleBufferSize": 500,
+  "consoleTargets": ["page", "shared_worker", "service_worker"]
+}
+```
+
+| Field               | Required | Description                                                                                               |
+|---------------------|----------|-----------------------------------------------------------------------------------------------------------|
+| `runtime`           | yes      | `"electron"`, `"tauri"`, or `"browser"`                                                                   |
+| `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` and `watch`. 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
 
+Every command targeting a window accepts `--window <id|title-substring>` (IDs come from `discover`). Examples below omit
+it for brevity.
+
 ### `init`
 
 Auto-generates config by reading `package.json`.
@@ -149,9 +215,22 @@ Dumps the accessibility tree in compact text format. Each element gets a session
 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 --max-lines 200      # Hard line budget (refs for hidden nodes still stored)
+agent-view dom --text               # Fall back to DOM textContent search when AX returns no match
+agent-view dom --compact            # Merge single-child chains onto one line (saves ~40-60% tokens)
+agent-view dom --count              # Return only the count of matching nodes (e.g. "5")
+agent-view dom --filter "row" --count  # Count how many rows match
+agent-view dom --diff               # Show only lines that changed since last call
 ```
 
+When `--filter` is set, depth defaults to unlimited so deep matches aren't truncated.
+
+`--count` skips tree formatting and ref-store mutations entirely — useful for assertions like "does this section have N rows?" without the token cost of a full tree dump.
+
+`--max-lines <n>` caps the number of output lines. When the tree exceeds the budget, output is truncated after `n-1` lines and a summary tail `… M more nodes` is appended. Refs for all nodes — including those past the cutoff — are still registered in the ref store, so a follow-up `dom --filter` or `click <ref>` works without re-running.
+
+`--diff` computes a line-level diff against the previous `dom` call for the same target. The first call always returns the full tree (no prior snapshot). Subsequent calls emit only added (`+ `) and removed (`- `) lines. Returns `No changes` when the tree is identical.
+
 ### `click`
 
 Clicks a DOM element by ref ID or coordinates.
@@ -169,15 +248,41 @@ Types text into an input. Uses native value setter + dispatches input/change eve
 agent-view fill 3 "hello@example.com"
 ```
 
+### `drag`
+
+HTML5 / pointer-driven drag-and-drop via CDP `Input.dispatchMouseEvent`
+(`mousePressed` → N × `mouseMoved` → `mouseReleased`). Real mouse events, not
+synthesized JS events — works with `vue-draggable-resizable`, `react-grid-layout`,
+gridstack, kanban boards, file drop zones, map pin drags, resize handles.
+
+```bash
+agent-view drag --from 42 --to 88                   # ref → ref
+agent-view drag --from-pos 86,792 --to-pos 640,200  # coord → coord (canvas, custom DnD)
+agent-view drag --from 42 --to-pos 640,200          # mixed
+agent-view drag --from 5 --to 9 --steps 20 --hold-ms 150
+```
+
+`--steps` (default 10) controls intermediate `mouseMoved` events so libraries
+that throttle on movement deltas still see continuous motion. `--hold-ms`
+inserts a pause between press and the first move (some libs require >100ms
+for touch-style activation). `--button` accepts `left|right|middle`.
+
 ### `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; WebP (q=80) when `--scale` is set (JPEG fallback for older Chrome/Electron).
 
 ```bash
 agent-view screenshot
-agent-view screenshot --window "Settings"
+agent-view screenshot --scale 0.5             # Half-res WebP (~3× fewer vision tokens)
+agent-view screenshot --scale 0.25            # Quarter-res WebP (~12× fewer, 1 tile)
+agent-view screenshot --crop "Sidebar"        # Crop to element bounding box (~12× fewer in best case)
+agent-view screenshot --crop "Chart" --scale 0.5  # Crop + scale (stacks)
 ```
 
+`--scale` accepts a factor in `(0, 1]`. CDP-side clip + WebP encode — recommended for agent loops where vision tokens dominate cost.
+
+`--crop <filter>` resolves a DOM element by the same filter syntax as `dom --filter`, then crops the screenshot to its bounding box before encoding. One tile (~1.6k vision tokens) instead of twelve (~19k) in the best case. If the filter matches nothing a warning is emitted to stderr and the full window is captured instead. Combines naturally with `--scale`.
+
 ### `scene`
 
 Reads the WebGL scene graph for canvas-based apps. Currently supports PixiJS via `window.__PIXI_DEVTOOLS__`.
@@ -187,14 +292,16 @@ agent-view scene                    # Full scene graph
 agent-view scene --diff             # Changes since last call
 agent-view scene --filter "player"  # Filter by name/type
 agent-view scene --verbose          # Extended props (alpha, scale, bounds)
+agent-view scene --compact          # Merge single-child chains onto one line
 ```
 
 ### `snap`
 
-Combined DOM + scene graph in one call. Shows DOM always; scene section appears when a WebGL engine is detected.
+Combined DOM + scene graph in one call. Shows DOM always; scene section appears when a WebGL engine is detected. Pass `--scale` to also capture a screenshot and append it as a third section.
 
 ```bash
 agent-view snap
+agent-view snap --scale 0.5   # DOM + Scene + Screenshot (path written to tmp)
 ```
 
 ### `wait`
@@ -210,48 +317,91 @@ 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.
 
-### `stop`
-
-Stops the background lazy server.
-
-## Multiwindow
+### `targets`
 
-All commands accept `--window` with either an ID (from `discover`) or a window title substring:
+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 dom --window "Settings"
-agent-view screenshot --window "About"
+agent-view targets                                       # all supported types
+agent-view targets --type shared_worker,service_worker   # filter
+agent-view targets --json                                # machine-readable
 ```
 
-## Output format
+### `eval`
 
-| Command | Format | Why |
-|---------|--------|-----|
-| `dom`, `scene`, `snap` | Plain text | LLM-friendly, minimal tokens |
-| `discover` | JSON | Machine-parseable |
-| `screenshot` | File path | Agent reads the image |
+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.
 
-## Claude Code plugin
+```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 })"
+```
 
-agent-view ships as a Claude Code plugin with a built-in `verify` skill. The skill teaches Claude how to use agent-view for UI verification after code changes.
+Output is capped at 64 KB. Thrown exceptions and syntax errors propagate as non-zero exit with the CDP error message.
 
-### Local development
+### `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
-claude --plugin-dir /path/to/agent-view
+agent-view console                              # buffered messages since attach
+agent-view console --follow --timeout 10        # stream for 10s
+agent-view console --follow --until "ready"     # exit as soon as a message contains "ready"
+agent-view console --follow --until "/error/i"  # exit on regex match (case-insensitive)
+agent-view console --target IJ56KL              # restrict to one target (exact id)
+agent-view console --target sync-worker         # restrict to one target (title/URL substring)
+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
 ```
 
-The skill becomes available as `/agent-view:verify`.
+`--until <pattern>` requires `--follow`. Exits as soon as a message matches the pattern (substring or `/regex/flags`). On timeout without match exits non-zero with `Timeout: pattern not seen in <N>s`.
+
+`--target` resolves the same way as `eval --target`: exact id wins, then title substring, then URL substring. If no match is found, an error is returned.
+
+Default attached target types: `page`, `shared_worker`, `service_worker`. Override with `consoleTargets` in config.
 
-### After npm install
+### `watch`
+
+Polls a JS expression and streams JSON-patch (RFC 6902) diffs as it changes. Closes the "what changed between click and final state?" gap that screenshots and DOM dumps can't cover. **Requires `"allowEval": true`** (same gate as `eval`).
 
 ```bash
-# Find where the package is installed
-npm root -g
-# Use that path with --plugin-dir
-claude --plugin-dir "$(npm root -g)/agent-view"
+agent-view watch "store.cart.total"                          # 250ms poll, exits at 10 changes or 30s
+agent-view watch "appState" --interval 100 --duration 60     # tighter cadence, longer window
+agent-view watch "store.status" --until "store.status === 'ready'"  # wait-for assertion
+agent-view watch "appState" --max-changes 1                  # snapshot first change after a click
+agent-view watch "appState" --json                           # NDJSON, one frame per line
 ```
 
+Output frames: `init` (baseline value), `diff` (RFC 6902 ops since last frame), `error`, `stop`. SIGINT exits cleanly. Snapshot size cap 256 KB — narrow the expression (e.g. `store.cart.items.length`) when watching large objects.
+
+### `stop`
+
+Stops the background lazy server.
+
+## Output format
+
+| Command                | Format     | Why                          |
+|------------------------|------------|------------------------------|
+| `dom`, `scene`, `snap` | Plain text | LLM-friendly, minimal tokens |
+| `discover`             | JSON       | Machine-parseable            |
+| `screenshot`           | File path  | Agent reads the image        |
+
+## Performance
+
+Built for tight `dom → click → dom` loops. Typical Electron app, ~200 AX nodes:
+
+| Scenario                       | agent-view | Playwright (estimate) |
+|--------------------------------|------------|-----------------------|
+| `dom` cold fetch               | 2ms        | ~30–80ms              |
+| `dom` warm (cache hit)         | 1ms        | ~30–80ms              |
+| Full cycle `dom → click → dom` | 17ms       | ~75ms                 |
+
+What makes it fast: 300ms AX-tree cache (invalidated on `click`/`fill`/navigation; cached responses prefixed with
+`[cache]`), parallel CDP calls in `click`, `Accessibility.queryAXTree` for filter lookups, and a single persistent CDP
+WebSocket reused across commands (no relay).
+
 ## Example: testing a login flow
 
 ```bash
@@ -279,8 +429,8 @@ agent-view screenshot
 
 ### CDP not responding
 
-1. Check the port is listening: `curl -s http://localhost:9222/json/version`
-2. For electron-vite: make sure you use `--` before the flag: `npx electron-vite dev -- --remote-debugging-port=9222`
+1. Check the port is listening: `curl -s http://localhost:9876/json/version`
+2. For electron-vite: make sure you use `--` before the flag: `npx electron-vite dev -- --remote-debugging-port=9876`
 3. Restart the app — HMR doesn't restart the main process
 
 ### Stale refs after HMR

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"}