@petukhovart/agent-view 0.3.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,7 +1,7 @@
 {
   "name": "agent-view",
-  "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",
+  "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",

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,68 +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
-
-The real power isn't in individual commands — it's in the **loop**:
+## Install & Update
 
-```
-Code → Launch → See → Verify → Fix → See again
-```
+### Claude Code (recommended)
 
-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.
+Two steps — both required:
 
-## 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.
+```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
 
-See [Commands](#commands) for flags. Full notes in [CHANGELOG](CHANGELOG.md).
+# 2. Install the CLI — the skill calls these binaries; the plugin doesn't bundle them
+npm install -g @petukhovart/agent-view
+```
 
-## Performance
+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".
 
-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.
+Verify:
 
-### Benchmark results (Electron app, ~200 AX nodes)
+```bash
+agent-view --version   # 0.5.0+
+```
 
-| 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 |
+### Standalone CLI (any other agent, CI, or scripting)
 
-\* *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)*
+```bash
+npm install -g @petukhovart/agent-view
+```
 
-### What makes it fast
+Everything works from this alone — `agent-view dom`, `screenshot`, `eval`, etc. Skip the plugin step.
 
-**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.
+### Update
 
-**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).
+```bash
+# Update the CLI to the latest version
+npm update -g @petukhovart/agent-view
 
-**`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.
+# 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
+```
 
-**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.
+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');
 }
 ```
 
@@ -85,46 +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
-
-### As CLI tool
-
-```bash
-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.
+If you see a JSON response with process info — you're good.
 
 ## Quick start
 
@@ -144,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
@@ -161,28 +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) |
-| `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"]` |
+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`.
@@ -203,12 +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.
@@ -226,18 +248,40 @@ 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 screenshot, saves to temp dir, prints the file path. PNG by default; JPEG when `--scale` is set.
+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 JPEG (~3× fewer vision tokens)
-agent-view screenshot --scale 0.25            # Quarter-res JPEG (~12× fewer, 1 tile)
+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 + JPEG encode — recommended for agent loops where vision tokens dominate cost.
+`--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`
 
@@ -248,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`
@@ -301,55 +347,60 @@ Streams or dumps console output (`Runtime.consoleAPICalled` + `Log.entryAdded`)
 ```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 --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
 ```
 
-Default attached target types: `page`, `shared_worker`, `service_worker`. Override with `consoleTargets` in config.
+`--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`.
 
-### `stop`
+`--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.
 
-Stops the background lazy server.
+Default attached target types: `page`, `shared_worker`, `service_worker`. Override with `consoleTargets` in config.
 
-## Multiwindow
+### `watch`
 
-All commands accept `--window` with either an ID (from `discover`) or a window title substring:
+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
-agent-view dom --window "Settings"
-agent-view screenshot --window "About"
+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 format
+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.
 
-| Command | Format | Why |
-|---------|--------|-----|
-| `dom`, `scene`, `snap` | Plain text | LLM-friendly, minimal tokens |
-| `discover` | JSON | Machine-parseable |
-| `screenshot` | File path | Agent reads the image |
+### `stop`
 
-## Claude Code plugin
+Stops the background lazy server.
 
-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 format
 
-### Local development
+| Command                | Format     | Why                          |
+|------------------------|------------|------------------------------|
+| `dom`, `scene`, `snap` | Plain text | LLM-friendly, minimal tokens |
+| `discover`             | JSON       | Machine-parseable            |
+| `screenshot`           | File path  | Agent reads the image        |
 
-```bash
-claude --plugin-dir /path/to/agent-view
-```
+## Performance
 
-The skill becomes available as `/agent-view:verify`.
+Built for tight `dom → click → dom` loops. Typical Electron app, ~200 AX nodes:
 
-### After npm install
+| 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                 |
 
-```bash
-# Find where the package is installed
-npm root -g
-# Use that path with --plugin-dir
-claude --plugin-dir "$(npm root -g)/agent-view"
-```
+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
 
@@ -378,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/cdp/ax-cache.d.ts

@@ -1,7 +1,14 @@
 import type { AXNode } from './types.js';
+export type AxTreeResult = {
+    nodes: AXNode[];
+    fromCache: boolean;
+};
 export declare class AxTreeCache {
     private entries;
     get(key: string): AXNode[] | null;
+    getWithMeta(key: string): AxTreeResult & {
+        found: boolean;
+    };
     set(key: string, nodes: AXNode[]): void;
     invalidate(key: string): void;
     invalidateAll(): void;

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

@@ -1 +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"}
+{"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,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAgC;IAE/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAUjC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE;IAQ3D,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

@@ -11,6 +11,13 @@ export class AxTreeCache {
         }
         return entry.nodes;
     }
+    getWithMeta(key) {
+        const cached = this.get(key);
+        if (cached) {
+            return { nodes: cached, fromCache: true, found: true };
+        }
+        return { nodes: [], fromCache: false, found: false };
+    }
     set(key, nodes) {
         this.entries.set(key, { nodes, timestamp: Date.now() });
     }

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

@@ -1 +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"}
+{"version":3,"file":"ax-cache.js","sourceRoot":"","sources":["../../src/cdp/ax-cache.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,GAAG,CAAA;AAY3B,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,WAAW,CAAC,GAAW;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QACxD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACtD,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/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/cdp/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,SAAS,EAGd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAGjB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAoBhD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkBpE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAQ9E;AAsKD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAmBhG;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,WAAW,CAAC,CAmItB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/cdp/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,SAAS,EAId,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAoBhD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkBpE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAQ9E;AAsKD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAmBhG;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,WAAW,CAAC,CAoNtB"}