@petukhovart/agent-view 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "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",
+  "author": {
+    "name": "PetukhovArt"
+  },
+  "homepage": "https://github.com/PetukhovArt/agent-view",
+  "license": "MIT"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artem Petukhov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,296 @@
+# agent-view
+
+**Give your AI agent eyes and hands for desktop apps.**
+
+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.
+
+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.
+
+## 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.
+
+agent-view is a CLI. One Bash call, compact text output, zero schema overhead. The accessibility tree comes back as plain text — not wrapped in JSON-RPC with metadata. For an agent that runs dozens of verification steps, the token savings add up fast.
+
+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**:
+
+```
+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.
+
+## Enabling CDP
+
+### Recommended: in code (reliable, works with any build tool)
+
+Add to your Electron main process:
+
+```js
+app.commandLine.appendSwitch('remote-debugging-port', '9222');
+```
+
+For dev-only:
+
+```js
+if (!app.isPackaged) {
+  app.commandLine.appendSwitch('remote-debugging-port', '9222');
+}
+```
+
+### Alternative: via CLI flag (no code changes)
+
+```bash
+# Plain Electron
+electron . --remote-debugging-port=9222
+
+# electron-vite (note the -- to forward the flag past the build tool)
+npx electron-vite dev -- --remote-debugging-port=9222
+```
+
+### Other runtimes
+
+| Runtime | Setup |
+|---------|-------|
+| **Tauri** | CDP via devtools configuration |
+| **Any Chromium app** | `--remote-debugging-port=9222` launch flag |
+
+### Verify CDP is working
+
+```bash
+curl -s http://localhost:9222/json/version
+```
+
+If you see a JSON response with browser info — you're good.
+
+## Install
+
+```bash
+npm install -g agent-view
+```
+
+## Quick start
+
+```bash
+cd your-electron-project
+
+# 1. Generate config (auto-detects runtime, port, launch command)
+agent-view init
+
+# 2. Start your app (or let agent-view do it)
+agent-view launch
+
+# 3. See what's on screen
+agent-view discover          # List all windows
+agent-view dom               # Accessibility tree with ref IDs
+agent-view screenshot        # PNG screenshot
+
+# 4. Interact
+agent-view click 5           # Click element by ref
+agent-view fill 3 "hello"   # Type into input
+
+# 5. Verify the result
+agent-view dom --filter "success"   # Check for expected element
+agent-view screenshot               # Visual confirmation
+```
+
+## How it works
+
+```
+CLI → TCP → Lazy Server → CDP → Your App
+```
+
+A background server connects to your app's CDP port, caches sessions, and auto-shuts down after 5 minutes of inactivity. No manual `connect` step — the server starts on first CLI call and handles connection lifecycle automatically.
+
+## Config
+
+Running `agent-view init` in your project root generates `agent-view.config.json`:
+
+```json
+{
+  "runtime": "electron",
+  "port": 9222,
+  "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) |
+
+## Commands
+
+### `init`
+
+Auto-generates config by reading `package.json`.
+
+### `discover`
+
+Lists running app windows as JSON — window IDs, titles, URLs.
+
+```bash
+agent-view discover
+```
+
+### `dom`
+
+Dumps the accessibility tree in compact text format. Each element gets a session ref ID for interaction.
+
+```bash
+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
+```
+
+### `click`
+
+Clicks a DOM element by ref ID or coordinates.
+
+```bash
+agent-view click 5                  # By ref from dom output
+agent-view click --pos 100,200      # By coordinates (for canvas)
+```
+
+### `fill`
+
+Types text into an input. Uses native value setter + dispatches input/change events (works with Vue, React, and other frameworks).
+
+```bash
+agent-view fill 3 "hello@example.com"
+```
+
+### `screenshot`
+
+Captures a PNG screenshot, saves to temp dir, prints the file path.
+
+```bash
+agent-view screenshot
+agent-view screenshot --window "Settings"
+```
+
+### `scene`
+
+Reads the WebGL scene graph for canvas-based apps. Currently supports PixiJS via `window.__PIXI_DEVTOOLS__`.
+
+```bash
+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)
+```
+
+### `snap`
+
+Combined DOM + scene graph in one call. Shows DOM always; scene section appears when a WebGL engine is detected.
+
+```bash
+agent-view snap
+```
+
+### `wait`
+
+Waits for a DOM element matching the filter to appear. Useful after navigation or async operations.
+
+```bash
+agent-view wait --filter "Dashboard"              # Wait for element (default 10s)
+agent-view wait --filter "Dashboard" --timeout 30 # Custom timeout in seconds
+```
+
+### `launch`
+
+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
+
+All commands accept `--window` with either an ID (from `discover`) or a window title substring:
+
+```bash
+agent-view dom --window "Settings"
+agent-view screenshot --window "About"
+```
+
+## 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 |
+
+## Claude Code plugin
+
+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.
+
+### Local development
+
+```bash
+claude --plugin-dir /path/to/agent-view
+```
+
+The skill becomes available as `/agent-view:verify`.
+
+### After npm install
+
+```bash
+# Find where the package is installed
+npm root -g
+# Use that path with --plugin-dir
+claude --plugin-dir "$(npm root -g)/agent-view"
+```
+
+## Example: testing a login flow
+
+```bash
+# Start the app
+agent-view launch
+
+# See the login page
+agent-view dom --filter "login"
+# RootWebArea "My App"
+#   textbox "Email" [ref=3]
+#   textbox "Password" [ref=5]
+#   button "Sign in" [ref=7]
+
+# Fill credentials and submit
+agent-view fill 3 "admin@example.com"
+agent-view fill 5 "password123"
+agent-view click 7
+
+# Verify — did we land on the dashboard?
+agent-view dom --depth 2
+agent-view screenshot
+```
+
+## Troubleshooting
+
+### 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`
+3. Restart the app — HMR doesn't restart the main process
+
+### Stale refs after HMR
+
+After hot reload, refs from previous `dom` calls become invalid. Run `agent-view dom` again to get fresh refs.
+
+### Launch timeout
+
+Complex Electron apps may take >60s on cold start. If `agent-view launch` times out, start the app manually and use `agent-view discover` to verify.
+
+## License
+
+MIT

package/dist/adapters/browser.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeAdapter } from './types.js';
+export declare const browserAdapter: RuntimeAdapter;
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +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"}

package/dist/adapters/browser.js

@@ -0,0 +1,20 @@
+import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { RuntimeType } from '../types.js';
+export const browserAdapter = {
+    runtime: RuntimeType.Browser,
+    async discover(port) {
+        const targets = await listTargets(port);
+        return targets
+            .filter(t => t.type === 'page')
+            .map(t => ({
+            id: t.id,
+            title: t.title,
+            url: t.url,
+            type: t.type,
+        }));
+    },
+    async connect(port, windowId) {
+        return connectToTarget(port, windowId);
+    },
+};
+//# sourceMappingURL=browser.js.map

package/dist/adapters/browser.js.map

@@ -0,0 +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"}

package/dist/adapters/electron.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeAdapter } from './types.js';
+export declare const electronAdapter: RuntimeAdapter;
+//# sourceMappingURL=electron.d.ts.map

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

@@ -0,0 +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"}

package/dist/adapters/electron.js

@@ -0,0 +1,20 @@
+import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { RuntimeType } from '../types.js';
+export const electronAdapter = {
+    runtime: RuntimeType.Electron,
+    async discover(port) {
+        const targets = await listTargets(port);
+        return targets
+            .filter(t => t.type === 'page')
+            .map(t => ({
+            id: t.id,
+            title: t.title,
+            url: t.url,
+            type: t.type,
+        }));
+    },
+    async connect(port, windowId) {
+        return connectToTarget(port, windowId);
+    },
+};
+//# sourceMappingURL=electron.js.map

package/dist/adapters/electron.js.map

@@ -0,0 +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"}

package/dist/adapters/registry.d.ts

@@ -0,0 +1,4 @@
+import { RuntimeType } from '../types.js';
+import type { RuntimeAdapter } from './types.js';
+export declare function getAdapter(runtime: RuntimeType): RuntimeAdapter;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAWhD,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAE/D"}

package/dist/adapters/registry.js

@@ -0,0 +1,13 @@
+import { RuntimeType } from '../types.js';
+import { electronAdapter } from './electron.js';
+import { browserAdapter } from './browser.js';
+import { tauriAdapter } from './tauri.js';
+const adapters = {
+    [RuntimeType.Electron]: electronAdapter,
+    [RuntimeType.Browser]: browserAdapter,
+    [RuntimeType.Tauri]: tauriAdapter,
+};
+export function getAdapter(runtime) {
+    return adapters[runtime];
+}
+//# sourceMappingURL=registry.js.map

package/dist/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,QAAQ,GAAwC;IACpD,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,eAAe;IACvC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc;IACrC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY;CAClC,CAAA;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AAC1B,CAAC"}

package/dist/adapters/tauri.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeAdapter } from './types.js';
+export declare function isAppTarget(target: {
+    type: string;
+    url: string;
+    title: string;
+}): boolean;
+export declare const tauriAdapter: RuntimeAdapter;
+//# sourceMappingURL=tauri.d.ts.map

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

@@ -0,0 +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"}

package/dist/adapters/tauri.js

@@ -0,0 +1,32 @@
+import { listTargets, connectToTarget } from '../cdp/transport.js';
+import { RuntimeType } from '../types.js';
+/** URLs that Tauri/WebView2 exposes as CDP targets but aren't app windows */
+const INTERNAL_URL_PATTERNS = [
+    'about:blank',
+    'devtools://',
+    'chrome-extension://',
+];
+export function isAppTarget(target) {
+    if (target.type !== 'page')
+        return false;
+    const url = target.url.toLowerCase();
+    return !INTERNAL_URL_PATTERNS.some(pattern => url.startsWith(pattern));
+}
+export const tauriAdapter = {
+    runtime: RuntimeType.Tauri,
+    async discover(port) {
+        const targets = await listTargets(port);
+        return targets
+            .filter(isAppTarget)
+            .map(t => ({
+            id: t.id,
+            title: t.title,
+            url: t.url,
+            type: t.type,
+        }));
+    },
+    async connect(port, windowId) {
+        return connectToTarget(port, windowId);
+    },
+};
+//# sourceMappingURL=tauri.js.map

package/dist/adapters/tauri.js.map

@@ -0,0 +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"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,8 @@
+import type { WindowInfo, RuntimeType } from '../types.js';
+import type { CDPConnection } from '../cdp/types.js';
+export type RuntimeAdapter = {
+    readonly runtime: RuntimeType;
+    discover(port: number): Promise<WindowInfo[]>;
+    connect(port: number, windowId: string): Promise<CDPConnection>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":""}

package/dist/cdp/transport.d.ts

@@ -0,0 +1,4 @@
+import type { CDPConnection, CDPTarget } from './types.js';
+export declare function listTargets(port: number): Promise<CDPTarget[]>;
+export declare function connectToTarget(port: number, targetId: string): Promise<CDPConnection>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/cdp/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/cdp/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAU,MAAM,YAAY,CAAA;AAQlE,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkBpE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwE5F"}

package/dist/cdp/transport.js

@@ -0,0 +1,89 @@
+// @ts-expect-error no types available for chrome-remote-interface
+import CDP from 'chrome-remote-interface';
+// CDP hosts to try: IPv4 first, then IPv6 (WebView2/Tauri often listens on ::1)
+const CDP_HOSTS = ['127.0.0.1', '::1'];
+// Maps targetId → host for connection routing
+const targetHostMap = new Map();
+export async function listTargets(port) {
+    const seen = new Set();
+    const result = [];
+    for (const host of CDP_HOSTS) {
+        try {
+            const targets = await CDP.List({ host, port });
+            for (const t of targets) {
+                if (!seen.has(t.id)) {
+                    seen.add(t.id);
+                    targetHostMap.set(`${port}:${t.id}`, host);
+                    result.push(t);
+                }
+            }
+        }
+        catch { /* host not available */ }
+    }
+    return result;
+}
+export async function connectToTarget(port, targetId) {
+    const host = targetHostMap.get(`${port}:${targetId}`) ?? 'localhost';
+    const client = await CDP({ host, port, target: targetId });
+    const { Runtime, Accessibility, Page, DOM, Input } = client;
+    await Page.enable();
+    await DOM.enable();
+    await Accessibility.enable();
+    async function dispatchClick(x, y) {
+        await Input.dispatchMouseEvent({ type: 'mousePressed', x, y, button: 'left', clickCount: 1 });
+        await Input.dispatchMouseEvent({ type: 'mouseReleased', x, y, button: 'left', clickCount: 1 });
+    }
+    return {
+        async evaluate(expression) {
+            const { result } = await Runtime.evaluate({
+                expression,
+                returnByValue: true,
+            });
+            return result.value;
+        },
+        async getAccessibilityTree() {
+            const { nodes } = await Accessibility.getFullAXTree();
+            return nodes;
+        },
+        async captureScreenshot() {
+            const { data } = await Page.captureScreenshot({ format: 'png' });
+            return Buffer.from(data, 'base64');
+        },
+        async clickByNodeId(backendNodeId) {
+            const { object } = await DOM.resolveNode({ backendNodeId });
+            await Runtime.callFunctionOn({
+                objectId: object.objectId,
+                functionDeclaration: 'function() { this.scrollIntoViewIfNeeded() }',
+            });
+            const { model } = await DOM.getBoxModel({ backendNodeId });
+            const [x1, y1, x2, y2, x3, y3, x4, y4] = model.content;
+            const cx = (x1 + x2 + x3 + x4) / 4;
+            const cy = (y1 + y2 + y3 + y4) / 4;
+            await dispatchClick(cx, cy);
+        },
+        async clickAtPosition(x, y) {
+            await dispatchClick(x, y);
+        },
+        async fillByNodeId(backendNodeId, value) {
+            const { object } = await DOM.resolveNode({ backendNodeId });
+            await DOM.focus({ backendNodeId });
+            // Set value and dispatch input/change events for framework reactivity
+            await Runtime.callFunctionOn({
+                objectId: object.objectId,
+                functionDeclaration: `function(val) {
+          const nativeSetter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value')?.set
+            || Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value')?.set;
+          if (nativeSetter) nativeSetter.call(this, val);
+          else this.value = val;
+          this.dispatchEvent(new Event('input', { bubbles: true }));
+          this.dispatchEvent(new Event('change', { bubbles: true }));
+        }`,
+                arguments: [{ value }],
+            });
+        },
+        async close() {
+            await client.close();
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/cdp/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/cdp/transport.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,GAAG,MAAM,yBAAyB,CAAA;AAGzC,gFAAgF;AAChF,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,KAAK,CAAU,CAAA;AAE/C,8CAA8C;AAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;AAE/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,MAAM,GAAgB,EAAE,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC9C,KAAK,MAAM,CAAC,IAAI,OAAsB,EAAE,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBACpB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;oBACd,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;oBAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAClE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,IAAI,WAAW,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1D,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAE3D,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;IACnB,MAAM,GAAG,CAAC,MAAM,EAAE,CAAA;IAClB,MAAM,aAAa,CAAC,MAAM,EAAE,CAAA;IAE5B,KAAK,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;QAC/C,MAAM,KAAK,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7F,MAAM,KAAK,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,UAAkB;YAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;gBACxC,UAAU;gBACV,aAAa,EAAE,IAAI;aACpB,CAAC,CAAA;YACF,OAAO,MAAM,CAAC,KAAK,CAAA;QACrB,CAAC;QAED,KAAK,CAAC,oBAAoB;YACxB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,CAAA;YACrD,OAAO,KAAiB,CAAA;QAC1B,CAAC;QAED,KAAK,CAAC,iBAAiB;YACrB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YAChE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACpC,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,aAAqB;YACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;YAC3D,MAAM,OAAO,CAAC,cAAc,CAAC;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,mBAAmB,EAAE,8CAA8C;aACpE,CAAC,CAAA;YACF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;YAC1D,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAA;YACtD,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC7B,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,CAAS,EAAE,CAAS;YACxC,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC3B,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,aAAqB,EAAE,KAAa;YACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;YAC3D,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,CAAA;YAClC,sEAAsE;YACtE,MAAM,OAAO,CAAC,cAAc,CAAC;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,mBAAmB,EAAE;;;;;;;UAOnB;gBACF,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/cdp/types.d.ts

@@ -0,0 +1,37 @@
+export type CDPTarget = {
+    id: string;
+    type: string;
+    title: string;
+    url: string;
+    webSocketDebuggerUrl: string;
+};
+export type CDPConnection = {
+    getAccessibilityTree: () => Promise<AXNode[]>;
+    captureScreenshot: () => Promise<Buffer>;
+    clickByNodeId: (backendNodeId: number) => Promise<void>;
+    clickAtPosition: (x: number, y: number) => Promise<void>;
+    fillByNodeId: (backendNodeId: number, value: string) => Promise<void>;
+    /** Executes arbitrary JS in the target process. Only pass trusted, hardcoded expressions. */
+    evaluate: (js: string) => Promise<unknown>;
+    close: () => Promise<void>;
+};
+export type AXNode = {
+    nodeId: string;
+    role: {
+        value: string;
+    };
+    name?: {
+        value: string;
+    };
+    childIds?: string[];
+    backendDOMNodeId?: number;
+    properties?: AXProperty[];
+};
+export type AXProperty = {
+    name: string;
+    value: {
+        type: string;
+        value?: unknown;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cdp/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7C,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,aAAa,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,6FAA6F;IAC7F,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CACzC,CAAA"}

package/dist/cdp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cdp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cdp/types.ts"],"names":[],"mappings":""}

package/dist/cli/client.d.ts

@@ -0,0 +1,3 @@
+import type { ServerRequest, ServerResponse } from '../types.js';
+export declare function sendCommand(request: ServerRequest): Promise<ServerResponse>;
+//# sourceMappingURL=client.d.ts.map