agent-web-interface 4.3.0 → 4.5.0

package/dist/src/shared/services/dom-transformer.service.js

@@ -1,190 +0,0 @@
-/**
- * DOM Transformer Service
- *
- * Transforms CDP DOM.getDocument responses into our DomTreeNode format
- *
- * FIXES: The stub implementation in browser-automation-mcp-server.ts:731-736
- * that returned { nodes: [] } without transforming the CDP response
- */
-export class DomTransformerService {
-    /**
-     * Transform CDP DOM.getDocument response into our DomTreeNode format
-     */
-    transform(cdpResponse, params) {
-        const nodes = [];
-        const maxDepth = params.depth ?? -1; // -1 means infinite depth
-        this.transformNode(cdpResponse.root, 0, maxDepth, nodes, params.visibleOnly ?? false);
-        return { nodes };
-    }
-    /**
-     * Recursively transform a CDP node and its children
-     */
-    transformNode(cdpNode, currentDepth, maxDepth, nodes, visibleOnly) {
-        // For document nodes (nodeType === 9), just process children
-        if (cdpNode.nodeType === 9) {
-            if (cdpNode.children && cdpNode.children.length > 0) {
-                for (const child of cdpNode.children) {
-                    this.transformNode(child, currentDepth, maxDepth, nodes, visibleOnly);
-                }
-            }
-            return;
-        }
-        // Skip non-element nodes unless they're text nodes
-        if (cdpNode.nodeType !== 1 && cdpNode.nodeType !== 3) {
-            return;
-        }
-        // Check depth limit
-        if (maxDepth >= 0 && currentDepth > maxDepth) {
-            return;
-        }
-        // For element nodes (nodeType === 1)
-        if (cdpNode.nodeType === 1) {
-            const attributesArray = cdpNode.attributes ?? [];
-            const attributesMap = this.parseAttributes(attributesArray);
-            // Skip if visibleOnly is true and element has display:none or visibility:hidden
-            if (visibleOnly && this.isHiddenByStyle(attributesMap)) {
-                return;
-            }
-            const node = {
-                id: `node-${cdpNode.nodeId}`,
-                nodeId: cdpNode.nodeId,
-                tag: cdpNode.localName && cdpNode.localName.length > 0
-                    ? cdpNode.localName
-                    : cdpNode.nodeName.toLowerCase(),
-                attrs: attributesArray,
-                children: [],
-            };
-            // Add text content if this is a leaf node with text
-            const textContent = this.extractTextContent(cdpNode);
-            if (textContent) {
-                node.text = textContent;
-            }
-            // Recursively process children
-            if (cdpNode.children && cdpNode.children.length > 0) {
-                for (const child of cdpNode.children) {
-                    const childNodes = [];
-                    this.transformNode(child, currentDepth + 1, maxDepth, childNodes, visibleOnly);
-                    if (node.children) {
-                        node.children.push(...childNodes);
-                    }
-                }
-            }
-            nodes.push(node);
-        }
-        // For text nodes (nodeType === 3)
-        else if (cdpNode.nodeType === 3 && cdpNode.nodeValue) {
-            const trimmedText = cdpNode.nodeValue.trim();
-            if (trimmedText) {
-                // Text nodes are represented as special nodes
-                const textNode = {
-                    id: `text-${cdpNode.nodeId}`,
-                    tag: '#text',
-                    attrs: [],
-                    text: trimmedText,
-                    children: [],
-                };
-                nodes.push(textNode);
-            }
-        }
-    }
-    /**
-     * Parse CDP attributes array [key1, value1, key2, value2, ...] to object
-     */
-    parseAttributes(attrs) {
-        const result = {};
-        for (let i = 0; i < attrs.length; i += 2) {
-            result[attrs[i]] = attrs[i + 1];
-        }
-        return result;
-    }
-    /**
-     * Check if element is hidden by inline style
-     */
-    isHiddenByStyle(attributes) {
-        const style = attributes.style || '';
-        return (style.includes('display:none') ||
-            style.includes('display: none') ||
-            style.includes('visibility:hidden') ||
-            style.includes('visibility: hidden'));
-    }
-    /**
-     * Extract text content from immediate text children
-     */
-    extractTextContent(cdpNode) {
-        if (!cdpNode.children || cdpNode.children.length === 0) {
-            return undefined;
-        }
-        const textParts = [];
-        for (const child of cdpNode.children) {
-            if (child.nodeType === 3 && child.nodeValue) {
-                const trimmed = child.nodeValue.trim();
-                if (trimmed) {
-                    textParts.push(trimmed);
-                }
-            }
-        }
-        if (textParts.length === 0) {
-            return undefined;
-        }
-        return textParts.join(' ');
-    }
-    /**
-     * Flatten tree structure into array (breadth-first traversal)
-     */
-    flattenTree(nodes) {
-        const flattened = [];
-        const queue = [...nodes];
-        while (queue.length > 0) {
-            const node = queue.shift();
-            flattened.push(node);
-            if (node.children && node.children.length > 0) {
-                queue.push(...node.children);
-            }
-        }
-        return flattened;
-    }
-    /**
-     * Filter nodes by tag name
-     */
-    filterByTag(nodes, tag) {
-        const results = [];
-        for (const node of nodes) {
-            if (node.tag === tag) {
-                results.push(node);
-            }
-            if (node.children && node.children.length > 0) {
-                results.push(...this.filterByTag(node.children, tag));
-            }
-        }
-        return results;
-    }
-    /**
-     * Find nodes by attribute
-     */
-    findByAttribute(nodes, attrName, attrValue) {
-        const results = [];
-        for (const node of nodes) {
-            // attrs is an array like [key1, value1, key2, value2, ...]
-            if (node.attrs) {
-                const index = node.attrs.indexOf(attrName);
-                if (index !== -1) {
-                    if (attrValue !== undefined) {
-                        // Check if the value matches
-                        if (index + 1 < node.attrs.length && node.attrs[index + 1] === attrValue) {
-                            results.push(node);
-                        }
-                    }
-                    else {
-                        // Just checking if attribute exists
-                        results.push(node);
-                    }
-                }
-            }
-            if (node.children && node.children.length > 0) {
-                results.push(...this.findByAttribute(node.children, attrName, attrValue));
-            }
-        }
-        return results;
-    }
-}
-//# sourceMappingURL=dom-transformer.service.js.map

package/dist/src/shared/services/dom-transformer.service.js.map

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

package/dist/src/shared/services/selector-builder.service.d.ts

@@ -1,53 +0,0 @@
-/**
- * Selector Builder Service
- *
- * Generates CSS, XPath, and accessibility selectors for DOM elements
- */
-import type { CdpClient } from '../../cdp/cdp-client.interface.js';
-import type { Selectors } from '../types/index.js';
-export declare class SelectorBuilderService {
-    private readonly cdpClient;
-    constructor(cdpClient: CdpClient);
-    /**
-     * Build comprehensive selectors for a given node
-     */
-    buildSelectors(nodeId: number, _frameId: string): Promise<Selectors>;
-    /**
-     * Build a CSS selector for an element
-     * Strategy: Use ID if available, otherwise build a path using classes/nth-child
-     */
-    private buildCssSelector;
-    /**
-     * Build a CSS path using tag names and nth-child
-     */
-    private buildCssPath;
-    /**
-     * Build an XPath selector for an element
-     */
-    private buildXPathSelector;
-    /**
-     * Build an accessibility selector (role-based)
-     */
-    private buildAccessibilitySelector;
-    /**
-     * Get node description from CDP
-     */
-    private getNodeDescription;
-    /**
-     * Get parent node ID
-     */
-    private getParentNode;
-    /**
-     * Get the nth-child position of a node among its siblings
-     */
-    private getNthChildPosition;
-    /**
-     * Check if a CSS selector uniquely identifies a single element
-     */
-    private isSelectorUnique;
-    /**
-     * Parse CDP attributes array to key-value pairs
-     */
-    private parseAttributes;
-}
-//# sourceMappingURL=selector-builder.service.d.ts.map

package/dist/src/shared/services/selector-builder.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selector-builder.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/services/selector-builder.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAWnD,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAU1E;;;OAGG;YACW,gBAAgB;IA8B9B;;OAEG;YACW,YAAY;IAmC1B;;OAEG;YACW,kBAAkB;IAsChC;;OAEG;YACW,0BAA0B;IAyBxC;;OAEG;YACW,kBAAkB;IAMhC;;OAEG;YACW,aAAa;IAmC3B;;OAEG;YACW,mBAAmB;IAiCjC;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;IACH,OAAO,CAAC,eAAe;CAOxB"}

package/dist/src/shared/services/selector-builder.service.js

@@ -1,240 +0,0 @@
-/**
- * Selector Builder Service
- *
- * Generates CSS, XPath, and accessibility selectors for DOM elements
- */
-export class SelectorBuilderService {
-    cdpClient;
-    constructor(cdpClient) {
-        this.cdpClient = cdpClient;
-    }
-    /**
-     * Build comprehensive selectors for a given node
-     */
-    async buildSelectors(nodeId, _frameId) {
-        const [css, xpath, ax] = await Promise.all([
-            this.buildCssSelector(nodeId),
-            this.buildXPathSelector(nodeId),
-            this.buildAccessibilitySelector(nodeId),
-        ]);
-        return { css, xpath, ax };
-    }
-    /**
-     * Build a CSS selector for an element
-     * Strategy: Use ID if available, otherwise build a path using classes/nth-child
-     */
-    async buildCssSelector(nodeId) {
-        try {
-            const nodeInfo = await this.getNodeDescription(nodeId);
-            const attributes = this.parseAttributes(nodeInfo.node.attributes ?? []);
-            // Strategy 1: Use ID (most specific)
-            if (attributes.id) {
-                return `#${attributes.id}`;
-            }
-            // Strategy 2: Use unique class combination
-            if (attributes.class) {
-                const classes = attributes.class.split(/\s+/).filter(Boolean);
-                if (classes.length > 0) {
-                    const classSelector = `.${classes.join('.')}`;
-                    const isUnique = await this.isSelectorUnique(classSelector);
-                    if (isUnique) {
-                        return classSelector;
-                    }
-                }
-            }
-            // Strategy 3: Build a path using tag names and nth-child
-            const path = await this.buildCssPath(nodeId);
-            return path;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    /**
-     * Build a CSS path using tag names and nth-child
-     */
-    async buildCssPath(nodeId) {
-        const segments = [];
-        let currentNodeId = nodeId;
-        try {
-            while (currentNodeId) {
-                const nodeInfo = await this.getNodeDescription(currentNodeId);
-                const tagName = nodeInfo.node.localName.toLowerCase();
-                // Get the nth-child position
-                const position = await this.getNthChildPosition(currentNodeId);
-                if (tagName === 'html') {
-                    segments.unshift('html');
-                    break;
-                }
-                if (position > 1) {
-                    segments.unshift(`${tagName}:nth-child(${position})`);
-                }
-                else {
-                    segments.unshift(tagName);
-                }
-                // Get parent node
-                const parent = await this.getParentNode(currentNodeId);
-                if (!parent)
-                    break;
-                currentNodeId = parent;
-            }
-            return segments.join(' > ');
-        }
-        catch {
-            return 'body';
-        }
-    }
-    /**
-     * Build an XPath selector for an element
-     */
-    async buildXPathSelector(nodeId) {
-        try {
-            const segments = [];
-            let currentNodeId = nodeId;
-            while (currentNodeId) {
-                const nodeInfo = await this.getNodeDescription(currentNodeId);
-                const tagName = nodeInfo.node.localName.toLowerCase();
-                const attributes = this.parseAttributes(nodeInfo.node.attributes ?? []);
-                // Use ID if available
-                if (attributes.id) {
-                    segments.unshift(`//*[@id="${attributes.id}"]`);
-                    break;
-                }
-                // Get position among siblings
-                const position = await this.getNthChildPosition(currentNodeId);
-                if (tagName === 'html') {
-                    segments.unshift('/html');
-                    break;
-                }
-                segments.unshift(`/${tagName}[${position}]`);
-                // Get parent node
-                const parent = await this.getParentNode(currentNodeId);
-                if (!parent)
-                    break;
-                currentNodeId = parent;
-            }
-            return segments.join('');
-        }
-        catch {
-            return undefined;
-        }
-    }
-    /**
-     * Build an accessibility selector (role-based)
-     */
-    async buildAccessibilitySelector(nodeId) {
-        try {
-            const nodeInfo = await this.getNodeDescription(nodeId);
-            const attributes = this.parseAttributes(nodeInfo.node.attributes ?? []);
-            const role = attributes.role ?? attributes['aria-role'];
-            const label = attributes['aria-label'];
-            const name = attributes.name;
-            if (role && label) {
-                return `role=${role}[label="${label}"]`;
-            }
-            if (role && name) {
-                return `role=${role}[name="${name}"]`;
-            }
-            if (role) {
-                return `role=${role}`;
-            }
-            return undefined;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    /**
-     * Get node description from CDP
-     */
-    async getNodeDescription(nodeId) {
-        return this.cdpClient.send('DOM.describeNode', {
-            nodeId,
-        });
-    }
-    /**
-     * Get parent node ID
-     */
-    async getParentNode(nodeId) {
-        try {
-            const resolved = await this.cdpClient.send('DOM.resolveNode', { nodeId });
-            const objectId = resolved.object?.objectId;
-            if (!objectId) {
-                return null;
-            }
-            const parentResult = await this.cdpClient.send('Runtime.callFunctionOn', {
-                objectId,
-                functionDeclaration: 'function() { return this.parentElement; }',
-                returnByValue: false,
-            });
-            const parentObjectId = parentResult.result.objectId;
-            if (!parentObjectId) {
-                return null;
-            }
-            const parentNode = await this.cdpClient.send('DOM.describeNode', {
-                objectId: parentObjectId,
-            });
-            return parentNode.node.nodeId;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Get the nth-child position of a node among its siblings
-     */
-    async getNthChildPosition(nodeId) {
-        try {
-            const resolved = await this.cdpClient.send('DOM.resolveNode', { nodeId });
-            const objectId = resolved.object?.objectId;
-            if (!objectId)
-                return 1;
-            const result = await this.cdpClient.send('Runtime.callFunctionOn', {
-                objectId,
-                functionDeclaration: `
-          function() {
-            if (!this.parentElement) {
-              return 1;
-            }
-            const siblings = Array.from(this.parentElement.children).filter(
-              (child) => child.tagName === this.tagName
-            );
-            const index = siblings.indexOf(this);
-            return index === -1 ? 1 : index + 1;
-          }
-        `,
-                returnByValue: true,
-            });
-            return result.result.value ?? 1;
-        }
-        catch {
-            return 1;
-        }
-    }
-    /**
-     * Check if a CSS selector uniquely identifies a single element
-     */
-    async isSelectorUnique(selector) {
-        try {
-            const result = await this.cdpClient.send('Runtime.evaluate', {
-                expression: `document.querySelectorAll(${JSON.stringify(selector)}).length`,
-                returnByValue: true,
-            });
-            return result.result.value === 1;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Parse CDP attributes array to key-value pairs
-     */
-    parseAttributes(attrs) {
-        const result = {};
-        for (let i = 0; i < attrs.length; i += 2) {
-            result[attrs[i]] = attrs[i + 1];
-        }
-        return result;
-    }
-}
-//# sourceMappingURL=selector-builder.service.js.map

package/dist/src/shared/services/selector-builder.service.js.map

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

package/dist/src/state/constants.d.ts

@@ -1,125 +0,0 @@
-/**
- * State System Constants
- *
- * Centralized configuration for magic numbers used across the state system.
- * Each constant includes rationale for its value.
- */
-/**
- * Viewport thresholds for quadrant computation.
- * Used to compute coarse position hints for element disambiguation.
- */
-export declare const VIEWPORT: {
-    /**
-     * Horizontal midpoint for quadrant detection.
-     * Assumes common viewport width ~1000px (iPad, small desktop).
-     * Elements left of this are 'L', right are 'R'.
-     */
-    readonly MIDPOINT_X: 500;
-    /**
-     * Vertical midpoint for quadrant detection.
-     * Assumes common viewport height ~800px or fold line at 50%.
-     * Elements above this are 'T', below are 'B'.
-     */
-    readonly MIDPOINT_Y: 400;
-};
-/**
- * Accessible name normalization limits.
- */
-export declare const ACCESSIBLE_NAME: {
-    /**
-     * Maximum length for normalized accessible names.
-     * Truncated to prevent excessively long EID inputs.
-     */
-    readonly MAX_LENGTH: 100;
-};
-/**
- * Layer detection confidence thresholds.
- */
-export declare const LAYER_CONFIDENCE: {
-    /**
-     * Minimum confidence score to include layer in stack.
-     * Candidates below this are filtered out.
-     * Value chosen empirically: modal detection is high confidence (0.95+),
-     * while class-based detection is lower (0.65-0.75).
-     * 0.6 threshold excludes weak class matches while keeping strong patterns.
-     */
-    readonly MIN_THRESHOLD: 0.6;
-};
-/**
- * Z-index thresholds for layer type detection.
- * Modern UI libraries typically use z-index ranges:
- * - Base content: 0-50
- * - Fixed headers/footers: 50-100
- * - Drawers/sidebars: 100-500
- * - Modals: 500-1000+
- * - Tooltips/popovers: 100-500
- */
-export declare const Z_INDEX: {
-    /**
-     * Z-index threshold for high-confidence modal detection.
-     * Dialogs with z-index > 1000 are almost certainly modals.
-     */
-    readonly MODAL_HIGH: 1000;
-    /**
-     * Minimum z-index for portal container detection.
-     * React/Vue portals typically render at z-index >= 100.
-     */
-    readonly PORTAL_MIN: 100;
-    /**
-     * Z-index threshold for portal area coverage check.
-     * Large elements at this z-index likely cover significant viewport.
-     */
-    readonly PORTAL_HIGH: 500;
-    /**
-     * Minimum z-index for drawer overlay detection.
-     * Below this, element is likely inline nav, not overlay drawer.
-     */
-    readonly DRAWER_MIN: 50;
-    /**
-     * Z-index threshold for confident drawer detection.
-     * Drawers with z-index > 100 are likely overlay panels.
-     */
-    readonly DRAWER_HIGH: 100;
-    /**
-     * Minimum z-index for popover detection.
-     * Standard popovers (menus, tooltips) render above this.
-     */
-    readonly POPOVER_MIN: 100;
-};
-/**
- * Size thresholds for element detection.
- */
-export declare const ELEMENT_SIZE: {
-    /**
-     * Minimum width for portal container detection.
-     * Portals typically have meaningful content size.
-     */
-    readonly PORTAL_MIN_WIDTH: 200;
-    /**
-     * Minimum height for portal container detection.
-     */
-    readonly PORTAL_MIN_HEIGHT: 200;
-};
-/**
- * Edge position detection thresholds.
- * Used to identify drawers positioned at viewport edges.
- */
-export declare const EDGE_DETECTION: {
-    /**
-     * Maximum x-coordinate for left edge detection.
-     * Elements with x < 10 are considered left-edge positioned.
-     */
-    readonly LEFT_MAX_X: 10;
-    /**
-     * Minimum right edge position.
-     * rightEdge (x + width) must exceed this to be right-edge positioned.
-     * Assumes typical viewport width ~1366px (common laptop).
-     */
-    readonly RIGHT_MIN: 1200;
-    /**
-     * Minimum x-coordinate for right edge detection.
-     * Prevents false positives from wide centered elements.
-     */
-    readonly RIGHT_MIN_X: 800;
-};
-//# sourceMappingURL=constants.d.ts.map

package/dist/src/state/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/state/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;;IAGH;;;;OAIG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;CAEK,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;;;OAMG;;CAEK,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;OAGG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc;IACzB;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;CAEK,CAAC"}