@huyuan-ai/cli 1.0.0 → 1.0.1

package/vendor/opencli/dist/browser/dom-snapshot.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for dom-snapshot.ts: DOM snapshot engine.
+ *
+ * Since the engine generates JavaScript strings for in-page evaluation,
+ * these tests validate:
+ * 1. The generated code is syntactically valid JS
+ * 2. Options are correctly embedded
+ * 3. The output structure matches expected format
+ * 4. All features are present (Shadow DOM, iframe, table, diff, etc.)
+ */
+export {};

package/vendor/opencli/dist/browser/dom-snapshot.test.js

@@ -0,0 +1,248 @@
+/**
+ * Tests for dom-snapshot.ts: DOM snapshot engine.
+ *
+ * Since the engine generates JavaScript strings for in-page evaluation,
+ * these tests validate:
+ * 1. The generated code is syntactically valid JS
+ * 2. Options are correctly embedded
+ * 3. The output structure matches expected format
+ * 4. All features are present (Shadow DOM, iframe, table, diff, etc.)
+ */
+import { describe, it, expect } from 'vitest';
+import { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';
+describe('generateSnapshotJs', () => {
+    it('returns a non-empty string', () => {
+        const js = generateSnapshotJs();
+        expect(typeof js).toBe('string');
+        expect(js.length).toBeGreaterThan(100);
+    });
+    it('generates syntactically valid JS (can be parsed)', () => {
+        const js = generateSnapshotJs();
+        expect(() => new Function(js)).not.toThrow();
+    });
+    it('embeds default options correctly', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('VIEWPORT_EXPAND = 800');
+        expect(js).toContain('MAX_DEPTH = 50');
+        expect(js).toContain('INTERACTIVE_ONLY = false');
+        expect(js).toContain('MAX_TEXT_LEN = 120');
+        expect(js).toContain('INCLUDE_SCROLL_INFO = true');
+        expect(js).toContain('BBOX_DEDUP = true');
+        expect(js).toContain('INCLUDE_SHADOW_DOM = true');
+        expect(js).toContain('INCLUDE_IFRAMES = true');
+        expect(js).toContain('PAINT_ORDER_CHECK = true');
+        expect(js).toContain('ANNOTATE_REFS = true');
+        expect(js).toContain('REPORT_HIDDEN = true');
+        expect(js).toContain('FILTER_ADS = true');
+        expect(js).toContain('MARKDOWN_TABLES = true');
+        expect(js).toContain('PREV_HASHES = null');
+    });
+    it('embeds custom options correctly', () => {
+        const js = generateSnapshotJs({
+            viewportExpand: 2000,
+            maxDepth: 30,
+            interactiveOnly: true,
+            maxTextLength: 200,
+            includeScrollInfo: false,
+            bboxDedup: false,
+            includeShadowDom: false,
+            includeIframes: false,
+            maxIframes: 3,
+            paintOrderCheck: false,
+            annotateRefs: false,
+            reportHidden: false,
+            filterAds: false,
+            markdownTables: false,
+        });
+        expect(js).toContain('VIEWPORT_EXPAND = 2000');
+        expect(js).toContain('MAX_DEPTH = 30');
+        expect(js).toContain('INTERACTIVE_ONLY = true');
+        expect(js).toContain('MAX_TEXT_LEN = 200');
+        expect(js).toContain('INCLUDE_SCROLL_INFO = false');
+        expect(js).toContain('BBOX_DEDUP = false');
+        expect(js).toContain('INCLUDE_SHADOW_DOM = false');
+        expect(js).toContain('INCLUDE_IFRAMES = false');
+        expect(js).toContain('MAX_IFRAMES = 3');
+        expect(js).toContain('PAINT_ORDER_CHECK = false');
+        expect(js).toContain('ANNOTATE_REFS = false');
+        expect(js).toContain('REPORT_HIDDEN = false');
+        expect(js).toContain('FILTER_ADS = false');
+        expect(js).toContain('MARKDOWN_TABLES = false');
+    });
+    it('clamps maxDepth between 1 and 200', () => {
+        expect(generateSnapshotJs({ maxDepth: -5 })).toContain('MAX_DEPTH = 1');
+        expect(generateSnapshotJs({ maxDepth: 999 })).toContain('MAX_DEPTH = 200');
+        expect(generateSnapshotJs({ maxDepth: 75 })).toContain('MAX_DEPTH = 75');
+    });
+    it('wraps output as an IIFE', () => {
+        const js = generateSnapshotJs();
+        expect(js.startsWith('(() =>')).toBe(true);
+        expect(js.trimEnd().endsWith(')()')).toBe(true);
+    });
+    it('embeds previousHashes for incremental diff', () => {
+        const hashes = JSON.stringify(['12345', '67890']);
+        const js = generateSnapshotJs({ previousHashes: hashes });
+        expect(js).toContain('new Set(["12345","67890"])');
+    });
+    it('includes all core features in generated code', () => {
+        const js = generateSnapshotJs();
+        // Tag filtering
+        expect(js).toContain('SKIP_TAGS');
+        expect(js).toContain("'script'");
+        expect(js).toContain("'style'");
+        // SVG collapsing
+        expect(js).toContain('SVG_CHILDREN');
+        // Interactive detection
+        expect(js).toContain('INTERACTIVE_TAGS');
+        expect(js).toContain('INTERACTIVE_ROLES');
+        expect(js).toContain('isInteractive');
+        // Visibility
+        expect(js).toContain('isVisibleByCSS');
+        expect(js).toContain('isInExpandedViewport');
+        // BBox dedup
+        expect(js).toContain('isContainedBy');
+        expect(js).toContain('PROPAGATING_TAGS');
+        // Shadow DOM
+        expect(js).toContain('shadowRoot');
+        expect(js).toContain('|shadow|');
+        // iframe
+        expect(js).toContain('walkIframe');
+        expect(js).toContain('|iframe|');
+        // Paint order
+        expect(js).toContain('isOccludedByOverlay');
+        expect(js).toContain('elementFromPoint');
+        // Ad filtering
+        expect(js).toContain('isAdElement');
+        expect(js).toContain('AD_PATTERNS');
+        // data-ref annotation
+        expect(js).toContain('data-opencli-ref');
+        // Hidden elements report
+        expect(js).toContain('hiddenInteractives');
+        expect(js).toContain('hidden_interactive');
+        // Incremental diff
+        expect(js).toContain('hashElement');
+        expect(js).toContain('currentHashes');
+        expect(js).toContain('__opencli_prev_hashes');
+        // Table serialization
+        expect(js).toContain('serializeTable');
+        expect(js).toContain('|table|');
+        // Synthetic attributes
+        expect(js).toContain("'YYYY-MM-DD'");
+        expect(js).toContain('value=••••');
+        // Page metadata
+        expect(js).toContain('location.href');
+        expect(js).toContain('document.title');
+    });
+    it('contains proper attribute whitelist', () => {
+        const js = generateSnapshotJs();
+        const expectedAttrs = [
+            'aria-label', 'aria-expanded', 'aria-checked', 'aria-selected',
+            'placeholder', 'href', 'role', 'data-testid', 'autocomplete',
+        ];
+        for (const attr of expectedAttrs) {
+            expect(js).toContain(`'${attr}'`);
+        }
+    });
+    it('includes scroll info formatting', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('scrollHeight');
+        expect(js).toContain('scrollTop');
+        expect(js).toContain('|scroll|');
+        expect(js).toContain('page_scroll');
+    });
+});
+describe('scrollToRefJs', () => {
+    it('generates valid JS', () => {
+        const js = scrollToRefJs('42');
+        expect(() => new Function(js)).not.toThrow();
+    });
+    it('targets data-opencli-ref', () => {
+        const js = scrollToRefJs('7');
+        expect(js).toContain('data-opencli-ref');
+        expect(js).toContain('scrollIntoView');
+        expect(js).toContain('"7"');
+    });
+    it('falls back to data-ref', () => {
+        const js = scrollToRefJs('3');
+        expect(js).toContain('data-ref');
+    });
+    it('returns scrolled info', () => {
+        const js = scrollToRefJs('1');
+        expect(js).toContain('scrolled: true');
+        expect(js).toContain('tag:');
+    });
+});
+describe('getFormStateJs', () => {
+    it('generates valid JS', () => {
+        const js = getFormStateJs();
+        expect(() => new Function(js)).not.toThrow();
+    });
+    it('collects form elements', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('document.forms');
+        expect(js).toContain('form.elements');
+    });
+    it('collects orphan fields', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('orphanFields');
+        expect(js).toContain('el.form');
+    });
+    it('handles different input types', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('checkbox');
+        expect(js).toContain('radio');
+        expect(js).toContain('password');
+        expect(js).toContain('contenteditable');
+    });
+    it('extracts labels', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('aria-label');
+        expect(js).toContain('label[for=');
+        expect(js).toContain('closest');
+        expect(js).toContain('placeholder');
+    });
+    it('masks passwords', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('••••');
+    });
+    it('includes data-opencli-ref in output', () => {
+        const js = getFormStateJs();
+        expect(js).toContain('data-opencli-ref');
+    });
+});
+describe('Search Element Detection', () => {
+    it('includes SEARCH_INDICATORS set', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('SEARCH_INDICATORS');
+        expect(js).toContain('search');
+        expect(js).toContain('magnify');
+        expect(js).toContain('glass');
+    });
+    it('includes hasFormControlDescendant function', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('hasFormControlDescendant');
+        expect(js).toContain('input');
+        expect(js).toContain('select');
+        expect(js).toContain('textarea');
+    });
+    it('includes isSearchElement function', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('isSearchElement');
+        expect(js).toContain('className');
+        expect(js).toContain('data-');
+    });
+    it('checks label wrapper detection in isInteractive', () => {
+        const js = generateSnapshotJs();
+        // Label elements without "for" attribute should check for form control descendants
+        expect(js).toContain('hasFormControlDescendant(el, 2)');
+    });
+    it('checks span wrapper detection in isInteractive', () => {
+        const js = generateSnapshotJs();
+        // Span elements should check for form control descendants
+        expect(js).toContain("tag === 'span'");
+    });
+    it('integrates search element detection into isInteractive', () => {
+        const js = generateSnapshotJs();
+        expect(js).toContain('isSearchElement(el)');
+    });
+});

package/vendor/opencli/dist/browser/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser connection error helpers.
+ *
+ * Simplified — no more token/extension/CDP classification.
+ * The daemon architecture has a single failure mode: daemon not reachable or extension not connected.
+ */
+import { BrowserConnectError, type BrowserConnectKind } from '../errors.js';
+/**
+ * Check if an error message indicates a transient browser error worth retrying.
+ */
+export declare function isTransientBrowserError(err: unknown): boolean;
+export type ConnectFailureKind = BrowserConnectKind;
+export declare function formatBrowserConnectError(kind: ConnectFailureKind, detail?: string): BrowserConnectError;

package/vendor/opencli/dist/browser/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Browser connection error helpers.
+ *
+ * Simplified — no more token/extension/CDP classification.
+ * The daemon architecture has a single failure mode: daemon not reachable or extension not connected.
+ */
+import { BrowserConnectError } from '../errors.js';
+import { DEFAULT_DAEMON_PORT } from '../constants.js';
+/**
+ * Transient browser error patterns — shared across daemon-client, pipeline executor,
+ * and page retry logic. These errors indicate temporary conditions (extension restart,
+ * service worker cycle, tab navigation) that are worth retrying.
+ */
+const TRANSIENT_ERROR_PATTERNS = [
+    'Extension disconnected',
+    'Extension not connected',
+    'attach failed',
+    'no longer exists',
+    'CDP connection',
+    'Daemon command failed',
+];
+/**
+ * Check if an error message indicates a transient browser error worth retrying.
+ */
+export function isTransientBrowserError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return TRANSIENT_ERROR_PATTERNS.some(pattern => msg.includes(pattern));
+}
+export function formatBrowserConnectError(kind, detail) {
+    switch (kind) {
+        case 'daemon-not-running':
+            return new BrowserConnectError('Cannot connect to opencli daemon.' + (detail ? `\n\n${detail}` : ''), `The daemon should auto-start. If it keeps failing, make sure port ${DEFAULT_DAEMON_PORT} is available.`, kind);
+        case 'extension-not-connected':
+            return new BrowserConnectError('Browser Bridge extension is not connected.' + (detail ? `\n\n${detail}` : ''), 'Install the extension from GitHub Releases, then reload.', kind);
+        case 'command-failed':
+            return new BrowserConnectError(`Browser command failed: ${detail ?? 'unknown error'}`, undefined, kind);
+        default:
+            return new BrowserConnectError(detail ?? 'Failed to connect to browser', undefined, kind);
+    }
+}

package/vendor/opencli/dist/browser/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser module — public API re-exports.
+ *
+ * This barrel replaces the former monolithic browser.ts.
+ * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
+ */
+export { Page } from './page.js';
+export { BrowserBridge } from './bridge.js';
+export { CDPBridge } from './cdp.js';
+export { isDaemonRunning } from './daemon-client.js';
+export { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';
+export { generateStealthJs } from './stealth.js';
+export type { DomSnapshotOptions } from './dom-snapshot.js';

package/vendor/opencli/dist/browser/index.js

@@ -0,0 +1,12 @@
+/**
+ * Browser module — public API re-exports.
+ *
+ * This barrel replaces the former monolithic browser.ts.
+ * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
+ */
+export { Page } from './page.js';
+export { BrowserBridge } from './bridge.js';
+export { CDPBridge } from './cdp.js';
+export { isDaemonRunning } from './daemon-client.js';
+export { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';
+export { generateStealthJs } from './stealth.js';

package/vendor/opencli/dist/browser/page.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Page abstraction — implements IPage by sending commands to the daemon.
+ *
+ * All browser operations are ultimately 'exec' (JS evaluation via CDP)
+ * plus a few native Chrome Extension APIs (tabs, cookies, navigate).
+ *
+ * IMPORTANT: After goto(), we remember the tabId returned by the navigate
+ * action and pass it to all subsequent commands. This avoids the issue
+ * where resolveTabId() in the extension picks a chrome:// or
+ * chrome-extension:// tab that can't be debugged.
+ */
+import type { BrowserCookie, ScreenshotOptions } from '../types.js';
+import { BasePage } from './base-page.js';
+export declare function isRetryableSettleError(err: unknown): boolean;
+/**
+ * Page — implements IPage by talking to the daemon via HTTP.
+ */
+export declare class Page extends BasePage {
+    private readonly workspace;
+    constructor(workspace?: string);
+    /** Active tab ID, set after navigate and used in all subsequent commands */
+    private _tabId;
+    /** Helper: spread workspace into command params */
+    private _wsOpt;
+    /** Helper: spread workspace + tabId into command params */
+    private _cmdOpts;
+    goto(url: string, options?: {
+        waitUntil?: 'load' | 'none';
+        settleMs?: number;
+    }): Promise<void>;
+    getActiveTabId(): number | undefined;
+    evaluate(js: string): Promise<unknown>;
+    getCookies(opts?: {
+        domain?: string;
+        url?: string;
+    }): Promise<BrowserCookie[]>;
+    /** Close the automation window in the extension */
+    closeWindow(): Promise<void>;
+    tabs(): Promise<unknown[]>;
+    selectTab(index: number): Promise<void>;
+    /**
+     * Capture a screenshot via CDP Page.captureScreenshot.
+     */
+    screenshot(options?: ScreenshotOptions): Promise<string>;
+    startNetworkCapture(pattern?: string): Promise<void>;
+    readNetworkCapture(): Promise<unknown[]>;
+    /**
+     * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
+     * Chrome reads the files directly from the local filesystem, avoiding the
+     * payload size limits of base64-in-evaluate.
+     */
+    setFileInput(files: string[], selector?: string): Promise<void>;
+    insertText(text: string): Promise<void>;
+    cdp(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** CDP native click fallback — called when JS el.click() fails */
+    protected tryNativeClick(x: number, y: number): Promise<boolean>;
+    /** Precise click using DOM.getContentQuads/getBoxModel for inline elements */
+    clickWithQuads(ref: string): Promise<void>;
+    nativeClick(x: number, y: number): Promise<void>;
+    nativeType(text: string): Promise<void>;
+    nativeKeyPress(key: string, modifiers?: string[]): Promise<void>;
+}