@petukhovart/agent-view 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+const [nodeMajor] = process.versions.node.split('.').map(Number);
+if (nodeMajor < 18) {
+    process.stderr.write(`agent-view requires Node.js 18 or higher. Current: ${process.versions.node}\n`);
+    process.exit(1);
+}
+import { Command } from 'commander';
+import { readConfig } from '../config/manager.js';
+import { runInit } from './commands/init.js';
+import { runDiscover } from './commands/discover.js';
+import { runLaunch } from './commands/launch.js';
+import { runDom } from './commands/dom.js';
+import { runClick } from './commands/click.js';
+import { runFill } from './commands/fill.js';
+import { runScreenshot } from './commands/screenshot.js';
+import { runScene } from './commands/scene.js';
+import { runSnap } from './commands/snap.js';
+import { runStop } from './commands/stop.js';
+import { runWait } from './commands/wait.js';
+const program = new Command()
+    .name('agent-view')
+    .description('Visual verification CLI for desktop apps')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Auto-generate agent-view.config.json')
+    .action(() => {
+    runInit(process.cwd());
+});
+program
+    .command('discover')
+    .description('Discover running application and its windows')
+    .action(async () => {
+    const config = requireConfig();
+    await runDiscover(config);
+});
+program
+    .command('launch')
+    .description('Launch application from config and wait for CDP readiness')
+    .action(async () => {
+    const config = requireConfig();
+    await runLaunch(config);
+});
+program
+    .command('dom')
+    .description('Get DOM accessibility tree')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .option('-f, --filter <text>', 'Filter by text/name')
+    .option('-d, --depth <n>', 'Max tree depth', parseDepth)
+    .action(async (options) => {
+    const config = requireConfig();
+    await runDom(config, options);
+});
+program
+    .command('click [ref]')
+    .description('Click DOM element by ref, filter, or position')
+    .option('-f, --filter <text>', 'Find element by text and click')
+    .option('-p, --pos <x,y>', 'Click at coordinates (for canvas)')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .action(async (ref, options) => {
+    const config = requireConfig();
+    await runClick(config, ref, options);
+});
+program
+    .command('fill <refOrValue> [value]')
+    .description('Type text into input by ref or filter')
+    .option('-f, --filter <text>', 'Find input by label/text and fill')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .action(async (refOrValue, value, options) => {
+    const config = requireConfig();
+    await runFill(config, refOrValue, value, options);
+});
+program
+    .command('wait')
+    .description('Wait for element to appear in DOM')
+    .requiredOption('-f, --filter <text>', 'Text to wait for')
+    .option('-t, --timeout <seconds>', 'Max wait time (default: 10)')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .action(async (options) => {
+    const config = requireConfig();
+    await runWait(config, options);
+});
+program
+    .command('screenshot')
+    .description('Capture screenshot and save to temp dir')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .action(async (options) => {
+    const config = requireConfig();
+    await runScreenshot(config, options);
+});
+program
+    .command('scene')
+    .description('Get PixiJS scene graph')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .option('-f, --filter <text>', 'Filter by name')
+    .option('-d, --depth <n>', 'Max tree depth', parseDepth)
+    .option('-v, --verbose', 'Show extended properties')
+    .option('--diff', 'Show only changes since last call')
+    .action(async (options) => {
+    const config = requireConfig();
+    await runScene(config, options);
+});
+program
+    .command('snap')
+    .description('Combined DOM + scene graph snapshot')
+    .option('-w, --window <id>', 'Target window ID or name')
+    .option('-f, --filter <text>', 'Filter by text/name')
+    .option('-d, --depth <n>', 'Max tree depth', parseDepth)
+    .action(async (options) => {
+    const config = requireConfig();
+    await runSnap(config, options);
+});
+program
+    .command('stop')
+    .description('Stop the lazy server')
+    .action(async () => {
+    await runStop();
+});
+function requireConfig() {
+    const config = readConfig(process.cwd());
+    if (!config) {
+        console.error('No agent-view.config.json found. Run `agent-view init` first.');
+        process.exit(1);
+    }
+    return config;
+}
+function parseDepth(value) {
+    const n = parseInt(value, 10);
+    if (isNaN(n)) {
+        console.error(`Invalid depth value: "${value}"`);
+        process.exit(1);
+    }
+    return n;
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,5 @@
+import type { AgentViewConfig } from './types.js';
+export declare function readConfig(cwd: string): AgentViewConfig | null;
+export declare function generateConfig(cwd: string): AgentViewConfig;
+export declare function writeConfig(cwd: string, config: AgentViewConfig): void;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAKjD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAS9D;AAyBD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAuB3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAGtE"}

package/dist/config/manager.js

@@ -0,0 +1,84 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { RuntimeType, WebGLEngine } from '../types.js';
+const CONFIG_FILENAME = 'agent-view.config.json';
+export function readConfig(cwd) {
+    const configPath = join(cwd, CONFIG_FILENAME);
+    if (!existsSync(configPath))
+        return null;
+    const raw = readFileSync(configPath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!isValidConfig(parsed)) {
+        throw new Error(`Invalid agent-view.config.json: must have runtime, port (number), and launch (string)`);
+    }
+    return parsed;
+}
+function isValidConfig(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const c = obj;
+    const validRuntimes = Object.values(RuntimeType);
+    const validEngines = Object.values(WebGLEngine);
+    if (typeof c.runtime !== 'string' ||
+        !validRuntimes.includes(c.runtime) ||
+        typeof c.port !== 'number' ||
+        c.port < 1 || c.port > 65535 ||
+        typeof c.launch !== 'string')
+        return false;
+    // Validate optional webgl.engine
+    if (c.webgl !== undefined) {
+        if (!c.webgl || typeof c.webgl !== 'object')
+            return false;
+        const w = c.webgl;
+        if (typeof w.engine !== 'string' || !validEngines.includes(w.engine))
+            return false;
+    }
+    return true;
+}
+export function generateConfig(cwd) {
+    const pkgPath = join(cwd, 'package.json');
+    if (!existsSync(pkgPath)) {
+        throw new Error(`package.json not found in ${cwd}`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const runtime = detectRuntime(allDeps);
+    const webglEngine = detectWebGL(allDeps);
+    const launch = detectLaunchCommand(cwd, pkg.scripts);
+    const config = {
+        runtime,
+        port: 9222,
+        launch,
+    };
+    if (webglEngine) {
+        config.webgl = { engine: webglEngine };
+    }
+    return config;
+}
+export function writeConfig(cwd, config) {
+    const configPath = join(cwd, CONFIG_FILENAME);
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+function detectRuntime(deps) {
+    if (deps['electron'] || deps['electron-vite'])
+        return RuntimeType.Electron;
+    if (deps['@tauri-apps/api'] || deps['@tauri-apps/cli'])
+        return RuntimeType.Tauri;
+    return RuntimeType.Browser;
+}
+function detectWebGL(deps) {
+    if (deps['pixi.js'] || deps['@pixi/app'])
+        return WebGLEngine.Pixi;
+    return undefined;
+}
+function detectLaunchCommand(cwd, scripts) {
+    const pm = existsSync(join(cwd, 'pnpm-lock.yaml')) ? 'pnpm' : 'npm';
+    if (!scripts)
+        return `${pm} run dev`;
+    if (scripts['dev'])
+        return `${pm} run dev`;
+    if (scripts['start'])
+        return `${pm} start`;
+    return `${pm} run dev`;
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeType, WebGLEngine } from '../types.js';
+export type AgentViewConfig = {
+    runtime: RuntimeType;
+    port: number;
+    launch: string;
+    webgl?: {
+        engine: WebGLEngine;
+    };
+    verify?: Record<string, {
+        steps: string[];
+    }>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE3D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,WAAW,CAAA;KACpB,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAC7C,CAAA"}

package/dist/config/types.js

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

package/dist/config/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { RuntimeType, WebGLEngine, WindowInfo, RuntimeInfo } from './types.js';
+export type { AgentViewConfig } from './config/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/inspectors/dom.d.ts

@@ -0,0 +1,17 @@
+import type { AXNode } from '../cdp/types.js';
+export type RefEntry = {
+    ref: number;
+    backendDOMNodeId: number;
+};
+export type DOMSnapshotOptions = {
+    filter?: string;
+    depth?: number;
+    startRef?: number;
+};
+export type DOMSnapshotResult = {
+    text: string;
+    refs: RefEntry[];
+    nextRef: number;
+};
+export declare function formatAccessibilityTree(nodes: AXNode[], options?: DOMSnapshotOptions): DOMSnapshotResult;
+//# sourceMappingURL=dom.d.ts.map

package/dist/inspectors/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/inspectors/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,EAAE,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAgInB"}

package/dist/inspectors/dom.js

@@ -0,0 +1,131 @@
+export function formatAccessibilityTree(nodes, options = {}) {
+    const { filter, depth: maxDepth } = options;
+    const refs = [];
+    let nextRef = options.startRef ?? 1;
+    const lines = [];
+    const nodeMap = new Map();
+    for (const node of nodes) {
+        nodeMap.set(node.nodeId, node);
+    }
+    const rootNodeId = nodes[0]?.nodeId;
+    if (!rootNodeId)
+        return { text: '(empty)', refs: [], nextRef };
+    const ALWAYS_SKIP_ROLES = new Set(['InlineTextBox']);
+    const SKIP_WHEN_EMPTY_ROLES = new Set(['none', 'generic', 'StaticText']);
+    // WAI-ARIA-like fallback: when a node has no accessible name,
+    // walk its children to find the first non-empty name, description, or title.
+    // This handles cases like v-list-item with title on a child v-icon.
+    function resolveNameFromChildren(node, depthLimit = 5) {
+        if (depthLimit <= 0 || !node.childIds)
+            return '';
+        for (const childId of node.childIds) {
+            const child = nodeMap.get(childId);
+            if (!child)
+                continue;
+            // Check child's own name
+            if (child.name?.value)
+                return child.name.value;
+            // Check description/title in AX properties
+            const desc = child.properties?.find(p => p.name === 'description');
+            if (desc?.value?.value && typeof desc.value.value === 'string')
+                return desc.value.value;
+            // Recurse into grandchildren
+            const deeper = resolveNameFromChildren(child, depthLimit - 1);
+            if (deeper)
+                return deeper;
+        }
+        return '';
+    }
+    // Collect all descendant text for heuristic filter matching.
+    // Searches name and description of all descendants, not just current node.
+    function getDescendantText(node, depthLimit = 10) {
+        const parts = [];
+        function collect(n, depth) {
+            if (depth > depthLimit || !n.childIds)
+                return;
+            for (const childId of n.childIds) {
+                const child = nodeMap.get(childId);
+                if (!child)
+                    continue;
+                if (child.name?.value)
+                    parts.push(child.name.value);
+                const desc = child.properties?.find(p => p.name === 'description');
+                if (desc?.value?.value && typeof desc.value.value === 'string')
+                    parts.push(desc.value.value);
+                collect(child, depth + 1);
+            }
+        }
+        collect(node, 0);
+        return parts.join(' ').toLowerCase();
+    }
+    function hasMatchingDescendant(node, lowerFilter) {
+        if (!node.childIds)
+            return false;
+        for (const childId of node.childIds) {
+            const child = nodeMap.get(childId);
+            if (!child)
+                continue;
+            const childRole = child.role?.value ?? '';
+            if (ALWAYS_SKIP_ROLES.has(childRole))
+                continue;
+            const childName = child.name?.value?.toLowerCase() ?? '';
+            if (childName.includes(lowerFilter) || childRole.toLowerCase().includes(lowerFilter))
+                return true;
+            if (hasMatchingDescendant(child, lowerFilter))
+                return true;
+        }
+        return false;
+    }
+    const HARD_MAX_DEPTH = 100;
+    function walk(nodeId, depth, indent) {
+        if (indent > HARD_MAX_DEPTH)
+            return;
+        if (maxDepth !== undefined && indent > maxDepth)
+            return;
+        const node = nodeMap.get(nodeId);
+        if (!node)
+            return;
+        const role = node.role?.value ?? '';
+        const ownName = node.name?.value ?? '';
+        // Fallback: resolve name from children when node has no accessible name
+        const fallbackName = !ownName ? resolveNameFromChildren(node) : '';
+        const name = ownName || fallbackName;
+        if (ALWAYS_SKIP_ROLES.has(role))
+            return;
+        const skip = SKIP_WHEN_EMPTY_ROLES.has(role) && !name;
+        if (!skip) {
+            if (filter) {
+                const lowerFilter = filter.toLowerCase();
+                const matchesName = name.toLowerCase().includes(lowerFilter);
+                const matchesRole = role.toLowerCase().includes(lowerFilter);
+                // Heuristic: also search descendant names/descriptions
+                const matchesDescendants = !matchesName && !matchesRole
+                    ? getDescendantText(node, 10).includes(lowerFilter)
+                    : false;
+                if (!matchesName && !matchesRole && !matchesDescendants && !hasMatchingDescendant(node, lowerFilter)) {
+                    return;
+                }
+            }
+            const ref = nextRef++;
+            if (node.backendDOMNodeId) {
+                refs.push({ ref, backendDOMNodeId: node.backendDOMNodeId });
+            }
+            const padding = '  '.repeat(indent);
+            const isFallback = !ownName && fallbackName;
+            const nameStr = name ? ` "${name}"${isFallback ? ' [fallback]' : ''}` : '';
+            lines.push(`${padding}${role}${nameStr} [ref=${ref}]`);
+        }
+        if (node.childIds) {
+            for (const childId of node.childIds) {
+                walk(childId, depth + 1, skip ? indent : indent + 1);
+            }
+        }
+    }
+    walk(rootNodeId, 0, 0);
+    return {
+        text: lines.join('\n') || '(no matching elements)',
+        refs,
+        nextRef,
+    };
+}
+//# sourceMappingURL=dom.js.map

package/dist/inspectors/dom.js.map

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

package/dist/inspectors/scene/formatter.d.ts

@@ -0,0 +1,5 @@
+import type { SceneNode, SceneOptions } from './types.js';
+export declare function formatNode(node: SceneNode, depth: number, lines: string[], options: SceneOptions): void;
+export declare function diffScenes(prev: SceneNode, curr: SceneNode): string;
+export declare function hasMatch(node: SceneNode, filter: string): boolean;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/inspectors/scene/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/inspectors/scene/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAIzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAqCvG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAInE;AA0CD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMjE"}

package/dist/inspectors/scene/formatter.js

@@ -0,0 +1,91 @@
+const HARD_MAX_DEPTH = 100;
+export function formatNode(node, depth, lines, options) {
+    if (depth > HARD_MAX_DEPTH)
+        return;
+    if (options.depth !== undefined && depth > options.depth)
+        return;
+    const matchesFilter = !options.filter ||
+        node.name.toLowerCase().includes(options.filter.toLowerCase()) ||
+        node.type.toLowerCase().includes(options.filter.toLowerCase());
+    const hasMatchingChildren = options.filter
+        ? (node.children || []).some(c => hasMatch(c, options.filter))
+        : false;
+    if (matchesFilter || hasMatchingChildren) {
+        const indent = '  '.repeat(depth);
+        const vis = node.visible ? '' : ' [hidden]';
+        const nameStr = node.name ? ` "${node.name}"` : '';
+        let line = `${indent}${node.type}${nameStr} (${node.x},${node.y})${vis}`;
+        if (node.tint !== '0xffffff' && node.tint !== '#ffffff') {
+            line += ` tint=${node.tint}`;
+        }
+        if (options.verbose) {
+            const extras = [];
+            if (node.alpha !== undefined && node.alpha !== 1)
+                extras.push(`alpha=${node.alpha}`);
+            if (node.scaleX !== 1 || node.scaleY !== 1)
+                extras.push(`scale=(${node.scaleX},${node.scaleY})`);
+            if (node.rotation !== 0)
+                extras.push(`rot=${node.rotation}°`);
+            if (node.width || node.height)
+                extras.push(`size=${node.width}x${node.height}`);
+            if (extras.length > 0)
+                line += ` ${extras.join(' ')}`;
+        }
+        lines.push(line);
+    }
+    for (const child of node.children || []) {
+        formatNode(child, depth + 1, lines, options);
+    }
+}
+export function diffScenes(prev, curr) {
+    const changes = [];
+    diffNode(prev, curr, 0, changes);
+    return changes.length > 0 ? changes.join('\n') : 'No changes';
+}
+function diffNode(prev, curr, depth, changes) {
+    if (depth > HARD_MAX_DEPTH)
+        return;
+    const indent = '  '.repeat(depth);
+    const nameStr = curr.name ? ` "${curr.name}"` : '';
+    const diffs = [];
+    if (prev.x !== curr.x || prev.y !== curr.y)
+        diffs.push(`pos: (${prev.x},${prev.y})→(${curr.x},${curr.y})`);
+    if (prev.visible !== curr.visible)
+        diffs.push(`visible: ${prev.visible}→${curr.visible}`);
+    if (prev.tint !== curr.tint)
+        diffs.push(`tint: ${prev.tint}→${curr.tint}`);
+    if (prev.alpha !== curr.alpha)
+        diffs.push(`alpha: ${prev.alpha}→${curr.alpha}`);
+    if (diffs.length > 0) {
+        changes.push(`${indent}~ ${curr.type}${nameStr}: ${diffs.join(', ')}`);
+    }
+    const prevChildren = prev.children || [];
+    const currChildren = curr.children || [];
+    const prevByKey = new Map(prevChildren.map((c, i) => [childKey(c, i), c]));
+    const currByKey = new Map(currChildren.map((c, i) => [childKey(c, i), c]));
+    for (const [key, child] of currByKey) {
+        const prevChild = prevByKey.get(key);
+        if (!prevChild) {
+            changes.push(`${indent}  + ${child.type}${child.name ? ` "${child.name}"` : ''} (${child.x},${child.y})`);
+        }
+        else {
+            diffNode(prevChild, child, depth + 1, changes);
+        }
+    }
+    for (const [key, child] of prevByKey) {
+        if (!currByKey.has(key)) {
+            changes.push(`${indent}  - ${child.type}${child.name ? ` "${child.name}"` : ''} (${child.x},${child.y})`);
+        }
+    }
+}
+function childKey(node, index) {
+    return node.name ? `${node.type}:${node.name}` : `${node.type}:${index}`;
+}
+export function hasMatch(node, filter) {
+    const lower = filter.toLowerCase();
+    if (node.name.toLowerCase().includes(lower) || node.type.toLowerCase().includes(lower)) {
+        return true;
+    }
+    return (node.children || []).some(c => hasMatch(c, lower));
+}
+//# sourceMappingURL=formatter.js.map

package/dist/inspectors/scene/formatter.js.map

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

package/dist/inspectors/scene/index.d.ts

@@ -0,0 +1,8 @@
+import type { CDPConnection } from '../../cdp/types.js';
+import type { WebGLEngine } from '../../types.js';
+import type { SceneOptions, SceneNode } from './types.js';
+export declare function getSceneGraph(conn: CDPConnection, engine: WebGLEngine | undefined, options?: SceneOptions): Promise<string>;
+export declare function getRawScene(conn: CDPConnection, engine: WebGLEngine | undefined): Promise<SceneNode | null>;
+export { diffScenes } from './formatter.js';
+export type { SceneNode, SceneOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/inspectors/scene/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/inspectors/scene/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,wBAAsB,aAAa,CACjC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAI3B;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/inspectors/scene/index.js

@@ -0,0 +1,26 @@
+import { getExtractor } from './registry.js';
+import { formatNode } from './formatter.js';
+export async function getSceneGraph(conn, engine, options = {}) {
+    if (!engine) {
+        return 'No WebGL engine configured. Add "webgl": { "engine": "pixi" } to agent-view.config.json';
+    }
+    const extractor = getExtractor(engine);
+    const tree = await extractor.extract(conn);
+    if (!tree) {
+        return `No ${engine} scene found`;
+    }
+    const lines = [];
+    formatNode(tree, 0, lines, options);
+    if (lines.length === 0 && options.filter) {
+        return `No scene objects matching "${options.filter}"`;
+    }
+    return lines.join('\n');
+}
+export async function getRawScene(conn, engine) {
+    if (!engine)
+        return null;
+    const extractor = getExtractor(engine);
+    return extractor.extract(conn);
+}
+export { diffScenes } from './formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/inspectors/scene/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/inspectors/scene/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAA;AAKvD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAmB,EACnB,MAA+B,EAC/B,UAAwB,EAAE;IAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,yFAAyF,CAAA;IAClG,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,MAAM,MAAM,cAAc,CAAA;IACnC,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACzC,OAAO,8BAA8B,OAAO,CAAC,MAAM,GAAG,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAmB,EACnB,MAA+B;IAE/B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACtC,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAChC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/inspectors/scene/pixi.d.ts

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

package/dist/inspectors/scene/pixi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixi.d.ts","sourceRoot":"","sources":["../../../src/inspectors/scene/pixi.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAA;AA8C3D,eAAO,MAAM,aAAa,EAAE,cAM3B,CAAA"}