@kritchoff/agent-browser 0.9.2

package/dist/dualmode-fetcher.js

@@ -0,0 +1,449 @@
+/**
+ * DualMode Accessibility Tree Fetcher
+ *
+ * Fetches enhanced accessibility tree from WootzApp Android browser via CDP.
+ * Transforms flat node list into hierarchical tree structure with refs.
+ */
+import { CDPClient } from './cdp-client.js';
+import * as fs from 'fs';
+/**
+ * DualMode AXTree fetcher
+ */
+export class DualModeAXTreeFetcher {
+    host;
+    port;
+    constructor(host = 'localhost', port = 9224) {
+        this.host = host;
+        this.port = port;
+    }
+    /**
+     * Clear Chrome app data using pm clear command
+     */
+    async clearBrowserData() {
+        try {
+            console.log('[DualMode] Clearing browser data...');
+            const { exec } = await import('child_process');
+            const { promisify } = await import('util');
+            const execAsync = promisify(exec);
+            // Clear Chrome app data using pm clear
+            console.log('[DualMode] Clearing app data with pm clear...');
+            await execAsync('docker exec android-world adb shell pm clear org.chromium.chrome');
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            console.log('[DualMode] ✓ Browser cleared successfully');
+        }
+        catch (error) {
+            console.warn('[DualMode] Failed to clear browser:', error.message);
+            throw error;
+        }
+    }
+    /**
+     * Fetch DualMode AXTree for a URL
+     */
+    async fetchTree(url) {
+        // EXACT FLOW AS REQUESTED:
+        // 1. Connect to CDP
+        // 2. Get current URL from Playwright (passed as parameter)
+        // 3. Load URL in emulator browser and wait till completely loaded
+        // 4. Call getDualModeAXTree through CDP
+        // 5. Clear chromium app data using pm clear
+        const { exec } = await import('child_process');
+        const { promisify } = await import('util');
+        const execAsync = promisify(exec);
+        // Create a new CDP client for this fetch
+        const cdpClient = new CDPClient({
+            timeout: 30000,
+            commandTimeout: 15000,
+        });
+        try {
+            // Step 1: Connect to CDP
+            console.log('[DualMode] Step 1: Getting WebSocket debugger URL...');
+            const wsUrl = await CDPClient.getWebSocketDebuggerUrl(this.host, this.port);
+            console.log('[DualMode] Step 1: Connecting to CDP...');
+            await cdpClient.connect(wsUrl);
+            console.log('[DualMode] ✓ Connected to CDP');
+            // Enable Page domain
+            await cdpClient.send('Page.enable');
+            // Step 2: URL is already from Playwright (passed as parameter)
+            console.log(`[DualMode] Step 2: URL from Playwright: ${url}`);
+            // Step 3: Load URL in emulator browser and wait till completely loaded
+            console.log(`[DualMode] Step 3: Navigating Android browser to: ${url}`);
+            await cdpClient.send('Page.navigate', { url });
+            console.log('[DualMode] Step 3: Waiting for page load event...');
+            await cdpClient.waitForEvent('Page.loadEventFired', 30000);
+            // Wait for accessibility tree to fully build
+            console.log('[DualMode] Step 3: Waiting for accessibility tree to settle (3s)...');
+            await new Promise(resolve => setTimeout(resolve, 3000));
+            console.log('[DualMode] ✓ Page completely loaded');
+            // Step 4: Call getDualModeAXTree through CDP
+            console.log('[DualMode] Step 4: Enabling Accessibility domain...');
+            await cdpClient.send('Accessibility.enable');
+            console.log('[DualMode] Step 4: Calling getDualModeAXTree...');
+            const result = await cdpClient.send('Accessibility.getDualModeAXTree', {});
+            fs.appendFileSync('/tmp/debug.log', `[DualMode] Raw Response: ${JSON.stringify(result, null, 2)}\n`);
+            console.log('[DualMode] Raw AXTree response:', JSON.stringify(result, null, 2));
+            console.log(`[DualMode] ✓ Successfully fetched tree with ${result.nodes?.length || 0} nodes`);
+            // Disable Accessibility domain (cleanup)
+            await cdpClient.send('Accessibility.disable');
+            // Step 5: Clear chromium app data using pm clear
+            console.log('[DualMode] Step 5: Clearing chromium app data...');
+            await execAsync('docker exec android-world adb shell pm clear org.chromium.chrome');
+            console.log('[DualMode] ✓ Chromium app data cleared');
+            return result;
+        }
+        finally {
+            // Always close CDP connection
+            await cdpClient.close();
+        }
+    }
+    /**
+     * Convert standard CDP accessibility tree to DualMode format
+     */
+    convertStandardTreeToDualMode(standardTree) {
+        const nodes = [];
+        if (!standardTree.nodes || !Array.isArray(standardTree.nodes)) {
+            console.warn('[DualMode] No nodes in standard tree response');
+            return { nodes: [] };
+        }
+        console.log(`[DualMode] Converting ${standardTree.nodes.length} nodes...`);
+        for (const node of standardTree.nodes) {
+            // Skip ignored nodes
+            if (node.ignored)
+                continue;
+            const nodeId = this.parseNodeId(node.nodeId);
+            const backendNodeId = node.backendDomNodeId;
+            // Extract role
+            const role = node.role?.value || 'unknown';
+            // Extract name
+            const name = node.name?.value || '';
+            // Build child IDs
+            const childrenIds = [];
+            if (node.childIds && Array.isArray(node.childIds)) {
+                childrenIds.push(...node.childIds.map((id) => this.parseNodeId(id)));
+            }
+            // Determine parent (we'll set this in a second pass)
+            const parentId = null;
+            // Convert to DualMode format
+            const dualModeNode = {
+                core: {
+                    nodeId,
+                    backendNodeId,
+                    className: role, // Use role as className for now
+                    childrenIds,
+                    parentId,
+                    text: name,
+                    contentDescription: node.description?.value,
+                    focusable: node.focusable,
+                    clickable: node.properties?.some((p) => p.name === 'clickable') || false,
+                    enabled: !node.disabled,
+                },
+                xrayMode: {
+                    semantics: {
+                        role,
+                        name,
+                        description: node.description?.value,
+                    },
+                    dom: {
+                        tagName: node.properties?.find((p) => p.name === 'htmlTag')?.value?.value,
+                    },
+                },
+            };
+            nodes.push(dualModeNode);
+        }
+        // Second pass: set parent IDs
+        const nodeMap = new Map(nodes.map(n => [n.core.nodeId, n]));
+        for (const node of nodes) {
+            for (const childId of node.core.childrenIds) {
+                const child = nodeMap.get(childId);
+                if (child) {
+                    child.core.parentId = node.core.nodeId;
+                }
+            }
+        }
+        console.log(`[DualMode] Conversion complete: ${nodes.length} nodes`);
+        return { nodes };
+    }
+    /**
+     * Parse node ID (handle string or number)
+     */
+    parseNodeId(nodeId) {
+        if (typeof nodeId === 'number')
+            return nodeId;
+        const parsed = parseInt(nodeId, 10);
+        return isNaN(parsed) ? 0 : parsed;
+    }
+    /**
+     * Fetch tree for current page (no navigation)
+     */
+    async fetchCurrentPageTree() {
+        // Create a new CDP client for each fetch
+        const cdpClient = new CDPClient({
+            timeout: 30000,
+            commandTimeout: 15000,
+        });
+        try {
+            // Get WebSocket URL
+            const wsUrl = await CDPClient.getWebSocketDebuggerUrl(this.host, this.port);
+            // Connect to CDP
+            await cdpClient.connect(wsUrl);
+            // Enable Accessibility domain
+            await cdpClient.send('Accessibility.enable');
+            // Fetch DualMode tree
+            const result = await cdpClient.send('Accessibility.getDualModeAXTree');
+            // Disable Accessibility domain (cleanup)
+            await cdpClient.send('Accessibility.disable');
+            return result;
+        }
+        finally {
+            await cdpClient.close();
+        }
+    }
+    /**
+     * Build hierarchical tree from flat node list
+     */
+    buildTree(response) {
+        const nodes = response.nodes;
+        const nodeMap = new Map();
+        // First pass: populate nodeMap
+        for (const node of nodes) {
+            nodeMap.set(node.core.nodeId, { ...node, children: [] });
+        }
+        // Second pass: build parent-child relationships
+        let root = null;
+        for (const node of nodeMap.values()) {
+            if (node.core.parentId === null) {
+                root = node;
+            }
+            else {
+                const parent = nodeMap.get(node.core.parentId);
+                if (parent) {
+                    parent.children = parent.children || [];
+                    parent.children.push(node);
+                }
+            }
+        }
+        if (!root) {
+            throw new Error('No root node found in DualMode tree');
+        }
+        // Collect interactive elements
+        const interactiveElements = [];
+        let refCounter = 0;
+        const collectInteractive = (node) => {
+            const isInteractive = node.core.clickable ||
+                node.core.focusable ||
+                this.isInteractiveRole(node.xrayMode?.semantics?.role);
+            if (isInteractive) {
+                interactiveElements.push({
+                    node,
+                    ref: `e${++refCounter}`,
+                    selector: this.generateSelector(node),
+                });
+            }
+            if (node.children) {
+                for (const child of node.children) {
+                    collectInteractive(child);
+                }
+            }
+        };
+        collectInteractive(root);
+        return {
+            root,
+            nodeMap,
+            interactiveElements,
+        };
+    }
+    /**
+     * Check if role is interactive
+     */
+    isInteractiveRole(role) {
+        if (!role)
+            return false;
+        const interactiveRoles = [
+            'button', 'link', 'textbox', 'checkbox', 'radio',
+            'combobox', 'listbox', 'menuitem', 'searchbox',
+            'slider', 'spinbutton', 'switch', 'tab',
+        ];
+        return interactiveRoles.includes(role.toLowerCase());
+    }
+    /**
+     * Generate selector for node (best effort)
+     */
+    generateSelector(node) {
+        const dom = node.xrayMode?.dom;
+        // Prefer ID selector
+        if (dom?.id) {
+            return `#${dom.id}`;
+        }
+        // Use role and name for Playwright-style selector
+        const role = node.xrayMode?.semantics?.role;
+        const name = node.xrayMode?.semantics?.name || node.core.text;
+        if (role && name) {
+            return `role=${role}[name="${name}"]`;
+        }
+        if (role) {
+            return `role=${role}`;
+        }
+        // Fallback to CSS selector
+        if (dom?.selector) {
+            return dom.selector;
+        }
+        // Last resort: use text content
+        const text = node.core.text || node.core.contentDescription;
+        if (text) {
+            return `text="${text.substring(0, 50)}"`;
+        }
+        return `node-${node.core.nodeId}`;
+    }
+    /**
+     * Generate text tree representation
+     */
+    generateTextTree(tree, options = {}) {
+        const lines = [];
+        const refMap = new Map();
+        // Build ref map
+        for (const elem of tree.interactiveElements) {
+            refMap.set(elem.node.core.nodeId, elem.ref);
+        }
+        const traverse = (node, depth = 0) => {
+            // Check depth limit
+            if (options.maxDepth !== undefined && depth > options.maxDepth) {
+                return;
+            }
+            // Check if should include node
+            if (options.interactive && !refMap.has(node.core.nodeId)) {
+                // Skip non-interactive nodes in interactive mode
+                // but still traverse children
+                if (node.children) {
+                    for (const child of node.children) {
+                        traverse(child, depth);
+                    }
+                }
+                return;
+            }
+            // Check intent filter
+            if (options.intentFilter && options.intentFilter.length > 0) {
+                const intentTags = node.xrayMode?.semantics?.intentTags || [];
+                const hasMatchingIntent = options.intentFilter.some(filter => intentTags.includes(filter));
+                if (!hasMatchingIntent) {
+                    return;
+                }
+            }
+            // Check importance threshold
+            if (options.minImportance !== undefined) {
+                const importance = node.xrayMode?.insights?.importance ?? 0;
+                if (importance < options.minImportance) {
+                    return;
+                }
+            }
+            // Build node line
+            const indent = '  '.repeat(depth);
+            const role = node.xrayMode?.semantics?.role || node.core.className;
+            const name = node.xrayMode?.semantics?.name ||
+                node.core.text ||
+                node.core.contentDescription || '';
+            const ref = refMap.get(node.core.nodeId);
+            const refPart = ref ? ` [ref=${ref}]` : '';
+            let line = `${indent}- ${role}`;
+            if (name) {
+                line += ` "${name}"`;
+            }
+            line += refPart;
+            // Add metadata if requested
+            if (options.includeMetadata && node.xrayMode) {
+                const tags = node.xrayMode.semantics?.intentTags;
+                if (tags && tags.length > 0) {
+                    line += ` [intent:${tags.join(',')}]`;
+                }
+                const importance = node.xrayMode.insights?.importance;
+                if (importance !== undefined) {
+                    line += ` [importance:${importance.toFixed(2)}]`;
+                }
+            }
+            lines.push(line);
+            // Traverse children
+            if (node.children) {
+                for (const child of node.children) {
+                    traverse(child, depth + 1);
+                }
+            }
+        };
+        traverse(tree.root);
+        return lines.join('\n');
+    }
+    /**
+     * Get enhanced snapshot with refs
+     */
+    async getEnhancedSnapshot(url, options = {}) {
+        const response = await this.fetchTree(url);
+        const tree = this.buildTree(response);
+        const textTree = this.generateTextTree(tree, options);
+        // Build refs map
+        const refs = {};
+        for (const elem of tree.interactiveElements) {
+            refs[elem.ref] = {
+                selector: elem.selector || '',
+                role: elem.node.xrayMode?.semantics?.role || elem.node.core.className,
+                name: elem.node.xrayMode?.semantics?.name || elem.node.core.text,
+                nodeId: elem.node.core.nodeId,
+            };
+        }
+        return {
+            tree: textTree,
+            refs,
+            dualModeTree: tree,
+            metadata: {
+                engine: 'wootzapp',
+                timestamp: Date.now(),
+                url,
+                nodeCount: tree.nodeMap.size,
+                interactiveCount: tree.interactiveElements.length,
+            },
+        };
+    }
+    /**
+     * Get current page snapshot (no navigation)
+     */
+    async getCurrentPageSnapshot(options = {}) {
+        const response = await this.fetchCurrentPageTree();
+        const tree = this.buildTree(response);
+        const textTree = this.generateTextTree(tree, options);
+        // Build refs map
+        const refs = {};
+        for (const elem of tree.interactiveElements) {
+            refs[elem.ref] = {
+                selector: elem.selector || '',
+                role: elem.node.xrayMode?.semantics?.role || elem.node.core.className,
+                name: elem.node.xrayMode?.semantics?.name || elem.node.core.text,
+                nodeId: elem.node.core.nodeId,
+            };
+        }
+        // Get current URL from CDP
+        let currentUrl = '';
+        try {
+            const cdpClient = new CDPClient({
+                timeout: 5000,
+                commandTimeout: 5000,
+            });
+            const wsUrl = await CDPClient.getWebSocketDebuggerUrl(this.host, this.port);
+            await cdpClient.connect(wsUrl);
+            const target = await cdpClient.send('Target.getTargetInfo');
+            currentUrl = target.targetInfo?.url || '';
+            await cdpClient.close();
+        }
+        catch {
+            // Ignore errors, URL is optional
+        }
+        return {
+            tree: textTree,
+            refs,
+            dualModeTree: tree,
+            metadata: {
+                engine: 'wootzapp',
+                timestamp: Date.now(),
+                url: currentUrl,
+                nodeCount: tree.nodeMap.size,
+                interactiveCount: tree.interactiveElements.length,
+            },
+        };
+    }
+}
+//# sourceMappingURL=dualmode-fetcher.js.map

package/dist/dualmode-fetcher.js.map

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

package/dist/dualmode-types.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Type definitions for DualMode Accessibility Tree
+ *
+ * DualMode AXTree combines Android-like semantics with web accessibility,
+ * providing rich context for AI agents.
+ */
+/**
+ * Core accessibility node properties (Android-like structure)
+ */
+export interface DualModeAXNodeCore {
+    /** Unique node identifier */
+    nodeId: number;
+    /** Backend DOM node ID (links to browser DOM) */
+    backendNodeId?: number;
+    /** Android class name (e.g., "android.widget.Button", "android.view.View") */
+    className: string;
+    /** Array of child node IDs */
+    childrenIds: number[];
+    /** Parent node ID (null for root) */
+    parentId: number | null;
+    /** Text content of the node */
+    text?: string;
+    /** Content description (accessibility label) */
+    contentDescription?: string;
+    /** Whether the node is focusable */
+    focusable?: boolean;
+    /** Whether the node is clickable */
+    clickable?: boolean;
+    /** Whether the node is enabled */
+    enabled?: boolean;
+    /** Whether the node is checked (for checkboxes) */
+    checked?: boolean;
+    /** Whether the node is selected */
+    selected?: boolean;
+    /** Bounding box coordinates */
+    bounds?: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    /** Whether the node is visible to user */
+    visibleToUser?: boolean;
+}
+/**
+ * Enhanced semantic metadata for AI understanding
+ */
+export interface DualModeXRaySemantics {
+    /** Web accessibility role (button, link, textbox, etc.) */
+    role: string;
+    /** Computed accessible name */
+    name?: string;
+    /** Element description */
+    description?: string;
+    /** Intent tags for agent decision-making */
+    intentTags?: string[];
+    /** Semantic category (navigation, form, content, etc.) */
+    category?: string;
+    /** Interaction hints */
+    interactions?: string[];
+    /** Visual context */
+    visualContext?: {
+        isAboveFold?: boolean;
+        isPrimary?: boolean;
+        prominence?: 'high' | 'medium' | 'low';
+    };
+    /** Form context */
+    formContext?: {
+        fieldType?: string;
+        required?: boolean;
+        validation?: string;
+    };
+}
+/**
+ * XRayMode metadata - enhanced perception layer
+ */
+export interface DualModeXRayMode {
+    /** Enhanced semantics */
+    semantics?: DualModeXRaySemantics;
+    /** ML-generated insights */
+    insights?: {
+        /** Element importance score (0-1) */
+        importance?: number;
+        /** Predicted user intent */
+        predictedIntent?: string;
+        /** Task relevance tags */
+        taskTags?: string[];
+    };
+    /** Accessibility properties */
+    accessibility?: {
+        /** ARIA role */
+        ariaRole?: string;
+        /** ARIA attributes */
+        ariaAttributes?: Record<string, string>;
+        /** Landmark role */
+        landmark?: string;
+    };
+    /** DOM metadata */
+    dom?: {
+        /** HTML tag name */
+        tagName?: string;
+        /** ID attribute */
+        id?: string;
+        /** Class names */
+        classNames?: string[];
+        /** CSS selector path */
+        selector?: string;
+    };
+}
+/**
+ * Complete DualMode AX Node
+ */
+export interface DualModeAXNode {
+    /** Core Android-like properties */
+    core: DualModeAXNodeCore;
+    /** Enhanced XRayMode metadata */
+    xrayMode?: DualModeXRayMode;
+    /** Child nodes (populated when building tree) */
+    children?: DualModeAXNode[];
+}
+/**
+ * CDP response for getDualModeAXTree command
+ */
+export interface GetDualModeAXTreeResponse {
+    /** Flat array of nodes */
+    nodes: DualModeAXNode[];
+}
+/**
+ * Processed tree structure
+ */
+export interface DualModeTree {
+    /** Root node */
+    root: DualModeAXNode;
+    /** Flat node lookup by nodeId */
+    nodeMap: Map<number, DualModeAXNode>;
+    /** Interactive elements with refs */
+    interactiveElements: Array<{
+        node: DualModeAXNode;
+        ref: string;
+        selector?: string;
+    }>;
+}
+/**
+ * DualMode snapshot options
+ */
+export interface DualModeSnapshotOptions {
+    /** Only include interactive elements */
+    interactive?: boolean;
+    /** Maximum tree depth */
+    maxDepth?: number;
+    /** Include XRayMode metadata in output */
+    includeMetadata?: boolean;
+    /** Filter by intent tags */
+    intentFilter?: string[];
+    /** Minimum importance score (0-1) */
+    minImportance?: number;
+}
+/**
+ * Enhanced snapshot with DualMode tree
+ */
+export interface DualModeEnhancedSnapshot {
+    /** Text tree representation */
+    tree: string;
+    /** Reference map for element interaction */
+    refs: Record<string, {
+        selector: string;
+        role: string;
+        name?: string;
+        nth?: number;
+        nodeId?: number;
+    }>;
+    /** Full DualMode tree structure */
+    dualModeTree?: DualModeTree;
+    /** Metadata */
+    metadata?: {
+        engine: 'wootzapp' | 'playwright';
+        timestamp: number;
+        url: string;
+        nodeCount: number;
+        interactiveCount: number;
+    };
+}
+//# sourceMappingURL=dualmode-types.d.ts.map

package/dist/dualmode-types.d.ts.map

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

package/dist/dualmode-types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for DualMode Accessibility Tree
+ *
+ * DualMode AXTree combines Android-like semantics with web accessibility,
+ * providing rich context for AI agents.
+ */
+export {};
+//# sourceMappingURL=dualmode-types.js.map

package/dist/dualmode-types.js.map

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