agent-web-interface 4.0.0

package/dist/src/cdp/puppeteer-cdp-client.js

@@ -0,0 +1,273 @@
+/**
+ * Puppeteer CDP Client
+ *
+ * CdpClient implementation wrapping Puppeteer's CDPSession.
+ * Provides a consistent interface for CDP communication regardless
+ * of the underlying browser automation framework.
+ */
+import { getLogger } from '../shared/services/logging.service.js';
+/**
+ * CdpClient implementation wrapping Puppeteer's CDPSession.
+ *
+ * @example
+ * ```typescript
+ * import puppeteer from 'puppeteer-core';
+ *
+ * const browser = await puppeteer.launch({ channel: 'chrome' });
+ * const [page] = await browser.pages();
+ *
+ * // Create CDP session from Puppeteer page
+ * const cdpSession = await page.createCDPSession();
+ * const cdp = new PuppeteerCdpClient(cdpSession);
+ *
+ * // Use CDP commands
+ * const doc = await cdp.send('DOM.getDocument', { depth: -1 });
+ * ```
+ */
+export class PuppeteerCdpClient {
+    session;
+    /** Default CDP domains that don't have .enable() methods */
+    static DEFAULT_DOMAINS_WITHOUT_ENABLE = new Set([
+        'Browser',
+        'Target',
+        'SystemInfo',
+        'Input',
+        'IO',
+        'DeviceAccess',
+        'Tethering',
+        'HeapProfiler',
+        'Schema',
+    ]);
+    active = true;
+    logger = getLogger();
+    timeout;
+    enabledDomains = new Set();
+    eventHandlers = new Map();
+    domainsWithoutEnable;
+    /** Last error message from CDP operations */
+    lastError;
+    /** Timestamp of last error */
+    lastErrorTime;
+    constructor(session, options = {}) {
+        this.session = session;
+        this.timeout = options.timeout ?? 30000;
+        this.domainsWithoutEnable = options.domainsWithoutEnable
+            ? new Set(options.domainsWithoutEnable)
+            : PuppeteerCdpClient.DEFAULT_DOMAINS_WITHOUT_ENABLE;
+        // Note: CDPSession doesn't expose lifecycle events.
+        // State is tracked via close() and error handling in send().
+    }
+    /**
+     * Send a CDP command and wait for response.
+     * Automatically enables required domains if not already enabled.
+     */
+    async send(method, params) {
+        if (!this.active) {
+            throw new Error('CDP session is closed');
+        }
+        // Validate method format (must be Domain.method)
+        if (!method.includes('.')) {
+            throw new Error(`Invalid CDP method format: "${method}". Expected "Domain.method" format.`);
+        }
+        // Extract domain from method (e.g., 'DOM' from 'DOM.getDocument')
+        const domain = method.split('.')[0];
+        // Auto-enable domain if needed (except for *.enable and *.disable methods)
+        if (!this.enabledDomains.has(domain) &&
+            !method.endsWith('.enable') &&
+            !method.endsWith('.disable')) {
+            await this.enableDomain(domain);
+        }
+        let timeoutId;
+        try {
+            // Puppeteer's CDPSession.send() accepts method as string and params as object
+            const result = await Promise.race([
+                this.session.send(method, params),
+                new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        reject(new Error(`CDP command timed out after ${this.timeout}ms: ${method}`));
+                    }, this.timeout);
+                }),
+            ]);
+            return result;
+        }
+        catch (error) {
+            // Detect session disconnection from error messages
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Track error for health diagnostics
+            this.lastError = errorMessage;
+            this.lastErrorTime = new Date();
+            // Check if this is an expected failure BEFORE evaluating session state
+            // Expected failures (like cross-origin frame access) shouldn't affect session health
+            const isExpectedFailure = this.isExpectedCdpFailure(method, errorMessage);
+            if (isExpectedFailure) {
+                this.logger.debug(`CDP command expected failure: ${method} - ${errorMessage}`);
+            }
+            else {
+                // Check for session-level failures that indicate CDP is no longer usable
+                // Be specific to avoid false positives from operation-level Protocol errors
+                const isSessionDead = errorMessage.includes('Target closed') ||
+                    errorMessage.includes('Session closed') ||
+                    errorMessage.includes('Session detached') ||
+                    errorMessage.includes('Target crashed') ||
+                    // Specific protocol errors that indicate session death
+                    (errorMessage.includes('Protocol error') &&
+                        (errorMessage.includes('Cannot find context') ||
+                            errorMessage.includes('Inspected target navigated') ||
+                            errorMessage.includes('No target with given id')));
+                if (isSessionDead) {
+                    this.active = false;
+                    this.enabledDomains.clear();
+                }
+                this.logger.error(`CDP command failed: ${method}`, error instanceof Error ? error : undefined);
+            }
+            throw error;
+        }
+        finally {
+            // Clear timeout to prevent memory leak
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    /**
+     * Subscribe to CDP events.
+     */
+    on(event, handler) {
+        // Track handler for cleanup on close()
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, new Set());
+        }
+        this.eventHandlers.get(event).add(handler);
+        // Puppeteer CDPSession uses typed events, but we need to handle any event name
+        this.session.on(event, handler);
+    }
+    /**
+     * Unsubscribe from CDP events.
+     */
+    off(event, handler) {
+        // Remove from tracking and clean up empty Sets
+        const handlers = this.eventHandlers.get(event);
+        handlers?.delete(handler);
+        if (handlers?.size === 0) {
+            this.eventHandlers.delete(event);
+        }
+        this.session.off(event, handler);
+    }
+    /**
+     * Subscribe to a CDP event once (auto-unsubscribes after first fire).
+     */
+    once(event, handler) {
+        const wrappedHandler = (params) => {
+            this.off(event, wrappedHandler);
+            handler(params);
+        };
+        this.on(event, wrappedHandler);
+    }
+    /**
+     * Close/detach the CDP session.
+     */
+    async close() {
+        if (this.active) {
+            try {
+                // Remove all tracked event handlers first
+                this.removeAllEventHandlers();
+                await this.session.detach();
+            }
+            catch (error) {
+                // Session may already be detached
+                this.logger.debug('Error detaching CDP session (may already be detached)', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            finally {
+                this.active = false;
+                this.enabledDomains.clear();
+                this.eventHandlers.clear();
+            }
+        }
+    }
+    /**
+     * Check if a CDP failure is expected (not worth logging as error).
+     * Some CDP commands fail for valid reasons (e.g., box model for hidden elements).
+     */
+    isExpectedCdpFailure(method, errorMessage) {
+        // DOM.getBoxModel fails for non-rendered elements
+        if (method === 'DOM.getBoxModel' && errorMessage.includes('Could not compute box model')) {
+            return true;
+        }
+        // CSS.getComputedStyleForNode may fail for detached nodes
+        if (method === 'CSS.getComputedStyleForNode' && errorMessage.includes('not found')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Remove all tracked event handlers from the session.
+     */
+    removeAllEventHandlers() {
+        for (const [event, handlers] of this.eventHandlers) {
+            for (const handler of handlers) {
+                try {
+                    this.session.off(event, handler);
+                }
+                catch (err) {
+                    // Handler may already be removed
+                    this.logger.debug('Failed to remove event handler during cleanup', {
+                        event,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Check if session is still active.
+     */
+    isActive() {
+        return this.active;
+    }
+    /**
+     * Get detailed health diagnostics for this CDP session.
+     *
+     * Includes:
+     * - active: Whether session is operational
+     * - lastError: Last error message if any
+     * - lastErrorTime: When the last error occurred
+     */
+    getHealth() {
+        return {
+            active: this.active,
+            lastError: this.lastError,
+            lastErrorTime: this.lastErrorTime,
+        };
+    }
+    /**
+     * Get the set of currently enabled CDP domains.
+     */
+    getEnabledDomains() {
+        return this.enabledDomains;
+    }
+    /**
+     * Enable a CDP domain (e.g., 'DOM', 'Page', 'Accessibility').
+     * Automatically called by send() when needed.
+     */
+    async enableDomain(domain) {
+        // Check if domain doesn't require enable
+        if (this.domainsWithoutEnable.has(domain)) {
+            this.enabledDomains.add(domain);
+            return;
+        }
+        try {
+            await this.session.send(`${domain}.enable`);
+            this.enabledDomains.add(domain);
+            this.logger.debug(`Enabled CDP domain: ${domain}`);
+        }
+        catch {
+            // Some domains may not support enable or may already be enabled
+            this.logger.debug(`Could not enable domain ${domain} (may not support enable or already enabled)`);
+            // Still mark as enabled to avoid repeated attempts
+            this.enabledDomains.add(domain);
+        }
+    }
+}
+//# sourceMappingURL=puppeteer-cdp-client.js.map

package/dist/src/cdp/puppeteer-cdp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer-cdp-client.js","sourceRoot":"","sources":["../../../src/cdp/puppeteer-cdp-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,kBAAkB;IA0BV;IAzBnB,4DAA4D;IACpD,MAAM,CAAU,8BAA8B,GAAG,IAAI,GAAG,CAAC;QAC/D,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,IAAI;QACJ,cAAc;QACd,WAAW;QACX,cAAc;QACd,QAAQ;KACT,CAAC,CAAC;IAEK,MAAM,GAAG,IAAI,CAAC;IACL,MAAM,GAAG,SAAS,EAAE,CAAC;IACrB,OAAO,CAAS;IAChB,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,aAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,oBAAoB,CAAc;IACnD,6CAA6C;IACrC,SAAS,CAAU;IAC3B,8BAA8B;IACtB,aAAa,CAAQ;IAE7B,YACmB,OAAmB,EACpC,UAA4B,EAAE;QADb,YAAO,GAAP,OAAO,CAAY;QAGpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB;YACtD,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACvC,CAAC,CAAC,kBAAkB,CAAC,8BAA8B,CAAC;QACtD,oDAAoD;QACpD,6DAA6D;IAC/D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAc,MAAc,EAAE,MAAgC;QACtE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,qCAAqC,CAAC,CAAC;QAC9F,CAAC;QAED,kEAAkE;QAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpC,2EAA2E;QAC3E,IACE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;YAChC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3B,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAC5B,CAAC;YACD,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,SAAqC,CAAC;QAE1C,IAAI,CAAC;YACH,8EAA8E;YAC9E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAA2C,EAAE,MAAM,CAAC;gBACtE,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/B,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,OAAO,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC;oBAChF,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,CAAC,CAAC;aACH,CAAC,CAAC;YAEH,OAAO,MAAW,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mDAAmD;YACnD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5E,qCAAqC;YACrC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;YAC9B,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;YAEhC,uEAAuE;YACvE,qFAAqF;YACrF,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAE1E,IAAI,iBAAiB,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,MAAM,MAAM,YAAY,EAAE,CAAC,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,yEAAyE;gBACzE,4EAA4E;gBAC5E,MAAM,aAAa,GACjB,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;oBACtC,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBACvC,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC;oBACzC,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBACvC,uDAAuD;oBACvD,CAAC,YAAY,CAAC,QAAQ,CAAC,gBAAgB,CAAC;wBACtC,CAAC,YAAY,CAAC,QAAQ,CAAC,qBAAqB,CAAC;4BAC3C,YAAY,CAAC,QAAQ,CAAC,4BAA4B,CAAC;4BACnD,YAAY,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;gBAEzD,IAAI,aAAa,EAAE,CAAC;oBAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;oBACpB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;gBAC9B,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,uBAAuB,MAAM,EAAE,EAC/B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,uCAAuC;YACvC,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,KAAa,EAAE,OAAwB;QACxC,uCAAuC;QACvC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE5C,+EAA+E;QAC/E,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAwC,EAAE,OAAqB,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,OAAwB;QACzC,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,QAAQ,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAyC,EAAE,OAAqB,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,OAAwB;QAC1C,MAAM,cAAc,GAAG,CAAC,MAA+B,EAAE,EAAE;YACzD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,0CAA0C;gBAC1C,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kCAAkC;gBAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE;oBACzE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;gBACpB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;gBAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,oBAAoB,CAAC,MAAc,EAAE,YAAoB;QAC/D,kDAAkD;QAClD,IAAI,MAAM,KAAK,iBAAiB,IAAI,YAAY,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACzF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,0DAA0D;QAC1D,IAAI,MAAM,KAAK,6BAA6B,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,sBAAsB;QAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAyC,EAAE,OAAqB,CAAC,CAAC;gBACrF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,iCAAiC;oBACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,EAAE;wBACjE,KAAK;wBACL,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,YAAY,CAAC,MAAc;QACvC,yCAAyC;QACzC,IAAI,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,SAA8C,CAAC,CAAC;YACjF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;YAChE,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,2BAA2B,MAAM,8CAA8C,CAChF,CAAC;YACF,mDAAmD;YACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC"}

package/dist/src/cli/args.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI Argument Parsing
+ *
+ * Parses command-line arguments for server configuration.
+ * All browser initialization is controlled via these arguments.
+ */
+/**
+ * Server configuration from CLI arguments
+ */
+export interface ServerArgs {
+    /** Run browser in headless mode (default: false) */
+    headless: boolean;
+    /** Use isolated temp profile instead of persistent (default: false) */
+    isolated: boolean;
+    /** HTTP endpoint URL for connecting to existing browser */
+    browserUrl?: string;
+    /** WebSocket endpoint URL for connecting to existing browser */
+    wsEndpoint?: string;
+    /** Auto-connect to Chrome 144+ via DevToolsActivePort */
+    autoConnect: boolean;
+    /** Chrome user data directory */
+    userDataDir?: string;
+    /** Chrome channel to use */
+    channel?: 'chrome' | 'chrome-canary' | 'chrome-beta' | 'chrome-dev';
+    /** Path to Chrome executable */
+    executablePath?: string;
+}
+/**
+ * Parse command-line arguments into ServerArgs.
+ *
+ * @param argv - Command line arguments (process.argv.slice(2))
+ * @returns Parsed server configuration
+ */
+export declare function parseArgs(argv: string[]): ServerArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/src/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAElB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAElB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IAErB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;IAEpE,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAwBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmCpD"}

package/dist/src/cli/args.js

@@ -0,0 +1,76 @@
+/**
+ * CLI Argument Parsing
+ *
+ * Parses command-line arguments for server configuration.
+ * All browser initialization is controlled via these arguments.
+ */
+/** Known CLI argument base names for validation */
+const KNOWN_ARG_NAMES = new Set([
+    'headless',
+    'isolated',
+    'autoConnect',
+    'browserUrl',
+    'wsEndpoint',
+    'userDataDir',
+    'channel',
+    'executablePath',
+]);
+/**
+ * Check if an argument is a known CLI flag (handles --arg and --arg=value forms).
+ */
+function isKnownArg(arg) {
+    if (!arg.startsWith('--'))
+        return true; // Not a flag, skip validation
+    const withoutDashes = arg.slice(2);
+    const baseName = withoutDashes.split('=')[0];
+    return KNOWN_ARG_NAMES.has(baseName);
+}
+/**
+ * Parse command-line arguments into ServerArgs.
+ *
+ * @param argv - Command line arguments (process.argv.slice(2))
+ * @returns Parsed server configuration
+ */
+export function parseArgs(argv) {
+    const args = {
+        headless: false,
+        isolated: false,
+        autoConnect: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--headless=false' || arg === '--headless=0') {
+            args.headless = false;
+        }
+        else if (arg === '--headless=true' || arg === '--headless=1' || arg === '--headless') {
+            args.headless = true;
+        }
+        else if (arg === '--isolated') {
+            args.isolated = true;
+        }
+        else if (arg === '--autoConnect') {
+            args.autoConnect = true;
+        }
+        else if (arg === '--browserUrl' && argv[i + 1]) {
+            args.browserUrl = argv[++i];
+        }
+        else if (arg === '--wsEndpoint' && argv[i + 1]) {
+            args.wsEndpoint = argv[++i];
+        }
+        else if (arg === '--userDataDir' && argv[i + 1]) {
+            args.userDataDir = argv[++i];
+        }
+        else if (arg === '--channel' && argv[i + 1]) {
+            args.channel = argv[++i];
+        }
+        else if (arg === '--executablePath' && argv[i + 1]) {
+            args.executablePath = argv[++i];
+        }
+        else if (!isKnownArg(arg)) {
+            // Warn about unknown arguments to catch typos like --hedless
+            console.warn(`Warning: Unknown argument "${arg}" - ignored`);
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=args.js.map

package/dist/src/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,mDAAmD;AACnD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,UAAU;IACV,UAAU;IACV,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,SAAS;IACT,gBAAgB;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;IACtE,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAe;QACvB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,kBAAkB,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACvF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAA0B,CAAC;QACpD,CAAC;aAAM,IAAI,GAAG,KAAK,kBAAkB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,6DAA6D;YAC7D,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,aAAa,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/delta/dom-stabilizer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * DOM Stabilizer
+ *
+ * Waits for DOM to stabilize after an action with guaranteed termination.
+ * Uses MutationObserver to detect when mutations settle.
+ */
+import type { Page } from 'puppeteer-core';
+/**
+ * Options for DOM stabilization.
+ */
+export interface StabilizationOptions {
+    /** Time window of no mutations to consider DOM stable (ms). Default: 100ms */
+    quietWindowMs?: number;
+    /** Maximum time to wait before timing out (ms). Default: 2000ms */
+    maxTimeoutMs?: number;
+}
+/**
+ * Result of DOM stabilization.
+ */
+export interface StabilizationResult {
+    /** Status of stabilization */
+    status: 'stable' | 'timeout' | 'error';
+    /** Time waited for stabilization (ms) */
+    waitTimeMs: number;
+    /** Number of mutations observed during stabilization */
+    mutationCount?: number;
+    /** Warning message if timeout or error */
+    warning?: string;
+}
+/** Type alias for compatibility */
+export type DomStability = StabilizationResult;
+/**
+ * Wait for DOM to stabilize with guaranteed termination.
+ *
+ * Uses MutationObserver in the browser to detect when mutations stop.
+ * Returns when either:
+ * - No mutations observed for quietWindowMs (stable)
+ * - maxTimeoutMs elapsed (timeout)
+ * - An error occurred (error)
+ *
+ * @param page - Puppeteer Page instance
+ * @param options - Stabilization options
+ * @returns StabilizationResult with status and timing info
+ */
+export declare function stabilizeDom(page: Page, options?: StabilizationOptions): Promise<StabilizationResult>;
+//# sourceMappingURL=dom-stabilizer.d.ts.map

package/dist/src/delta/dom-stabilizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-stabilizer.d.ts","sourceRoot":"","sources":["../../../src/delta/dom-stabilizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAmC/C;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAiH9B"}

package/dist/src/delta/dom-stabilizer.js

@@ -0,0 +1,121 @@
+/**
+ * DOM Stabilizer
+ *
+ * Waits for DOM to stabilize after an action with guaranteed termination.
+ * Uses MutationObserver to detect when mutations settle.
+ */
+/** Default quiet window in milliseconds */
+const DEFAULT_QUIET_WINDOW_MS = 100;
+/** Default hard timeout in milliseconds */
+const DEFAULT_MAX_TIMEOUT_MS = 2000;
+/**
+ * Wait for DOM to stabilize with guaranteed termination.
+ *
+ * Uses MutationObserver in the browser to detect when mutations stop.
+ * Returns when either:
+ * - No mutations observed for quietWindowMs (stable)
+ * - maxTimeoutMs elapsed (timeout)
+ * - An error occurred (error)
+ *
+ * @param page - Puppeteer Page instance
+ * @param options - Stabilization options
+ * @returns StabilizationResult with status and timing info
+ */
+export async function stabilizeDom(page, options = {}) {
+    const quietWindowMs = options.quietWindowMs ?? DEFAULT_QUIET_WINDOW_MS;
+    const maxTimeoutMs = options.maxTimeoutMs ?? DEFAULT_MAX_TIMEOUT_MS;
+    const startTime = Date.now();
+    try {
+        const result = await page.evaluate(({ quietWindowMs, maxTimeoutMs }) => {
+            return new Promise((resolve) => {
+                // Guard: document.body may not exist during navigation
+                if (!document.body) {
+                    resolve({ stable: false, elapsed: 0, mutationCount: 0 });
+                    return;
+                }
+                let quietTimer = null;
+                let mutationCount = 0;
+                const start = performance.now();
+                // Hard timeout - always resolves
+                const hardTimeout = window.setTimeout(() => {
+                    cleanup();
+                    resolve({
+                        stable: false,
+                        elapsed: performance.now() - start,
+                        mutationCount,
+                    });
+                }, maxTimeoutMs);
+                const observer = new MutationObserver(() => {
+                    mutationCount++;
+                    // Reset quiet timer on each mutation
+                    if (quietTimer !== null) {
+                        clearTimeout(quietTimer);
+                    }
+                    quietTimer = window.setTimeout(() => {
+                        cleanup();
+                        resolve({
+                            stable: true,
+                            elapsed: performance.now() - start,
+                            mutationCount,
+                        });
+                    }, quietWindowMs);
+                });
+                function cleanup() {
+                    if (quietTimer !== null)
+                        clearTimeout(quietTimer);
+                    clearTimeout(hardTimeout);
+                    observer.disconnect();
+                }
+                // Start observing
+                try {
+                    observer.observe(document.body, {
+                        childList: true,
+                        subtree: true,
+                        attributes: true,
+                        characterData: true,
+                    });
+                }
+                catch {
+                    // Observer failed (rare edge case)
+                    cleanup();
+                    resolve({ stable: false, elapsed: 0, mutationCount: 0 });
+                    return;
+                }
+                // Initial quiet timer (page may already be stable)
+                quietTimer = window.setTimeout(() => {
+                    cleanup();
+                    resolve({
+                        stable: true,
+                        elapsed: performance.now() - start,
+                        mutationCount,
+                    });
+                }, quietWindowMs);
+            });
+        }, { quietWindowMs, maxTimeoutMs });
+        const waitTimeMs = Date.now() - startTime;
+        if (result.stable) {
+            return {
+                status: 'stable',
+                waitTimeMs,
+                mutationCount: result.mutationCount,
+            };
+        }
+        return {
+            status: 'timeout',
+            waitTimeMs,
+            mutationCount: result.mutationCount,
+            warning: `DOM still mutating after ${maxTimeoutMs}ms (${result.mutationCount} mutations observed). Snapshot may be incomplete.`,
+        };
+    }
+    catch (error) {
+        // page.evaluate failed - likely navigation occurred
+        const waitTimeMs = Date.now() - startTime;
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            status: 'error',
+            waitTimeMs,
+            warning: `Stabilization interrupted: ${message}. Page may have navigated.`,
+        };
+    }
+}
+//# sourceMappingURL=dom-stabilizer.js.map

package/dist/src/delta/dom-stabilizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-stabilizer.js","sourceRoot":"","sources":["../../../src/delta/dom-stabilizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0DH,2CAA2C;AAC3C,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,2CAA2C;AAC3C,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAU,EACV,UAAgC,EAAE;IAElC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACvE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,EAAE;YAClC,OAAO,IAAI,OAAO,CAIf,CAAC,OAAO,EAAE,EAAE;gBACb,uDAAuD;gBACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnB,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;oBACzD,OAAO;gBACT,CAAC;gBAED,IAAI,UAAU,GAAkB,IAAI,CAAC;gBACrC,IAAI,aAAa,GAAG,CAAC,CAAC;gBACtB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAEhC,iCAAiC;gBACjC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBACzC,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC;wBACN,MAAM,EAAE,KAAK;wBACb,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;wBAClC,aAAa;qBACd,CAAC,CAAC;gBACL,CAAC,EAAE,YAAY,CAAC,CAAC;gBAEjB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;oBACzC,aAAa,EAAE,CAAC;oBAEhB,qCAAqC;oBACrC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;wBACxB,YAAY,CAAC,UAAU,CAAC,CAAC;oBAC3B,CAAC;oBAED,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;wBAClC,OAAO,EAAE,CAAC;wBACV,OAAO,CAAC;4BACN,MAAM,EAAE,IAAI;4BACZ,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;4BAClC,aAAa;yBACd,CAAC,CAAC;oBACL,CAAC,EAAE,aAAa,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC;gBAEH,SAAS,OAAO;oBACd,IAAI,UAAU,KAAK,IAAI;wBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;oBAClD,YAAY,CAAC,WAAW,CAAC,CAAC;oBAC1B,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACxB,CAAC;gBAED,kBAAkB;gBAClB,IAAI,CAAC;oBACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;wBAC9B,SAAS,EAAE,IAAI;wBACf,OAAO,EAAE,IAAI;wBACb,UAAU,EAAE,IAAI;wBAChB,aAAa,EAAE,IAAI;qBACpB,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,mCAAmC;oBACnC,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;oBACzD,OAAO;gBACT,CAAC;gBAED,mDAAmD;gBACnD,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;oBAClC,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC;wBACN,MAAM,EAAE,IAAI;wBACZ,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK;wBAClC,aAAa;qBACd,CAAC,CAAC;gBACL,CAAC,EAAE,aAAa,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,aAAa,EAAE,YAAY,EAAE,CAChC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE1C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,UAAU;gBACV,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,UAAU;YACV,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,4BAA4B,YAAY,OAAO,MAAM,CAAC,aAAa,mDAAmD;SAChI,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oDAAoD;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAC1C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO;YACL,MAAM,EAAE,OAAO;YACf,UAAU;YACV,OAAO,EAAE,8BAA8B,OAAO,4BAA4B;SAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/delta/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Delta System Exports
+ *
+ * Only DOM stabilizer remains - all other delta functionality removed.
+ */
+export { stabilizeDom } from './dom-stabilizer.js';
+export type { DomStability } from './dom-stabilizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/delta/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/delta/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/delta/index.js

@@ -0,0 +1,7 @@
+/**
+ * Delta System Exports
+ *
+ * Only DOM stabilizer remains - all other delta functionality removed.
+ */
+export { stabilizeDom } from './dom-stabilizer.js';
+//# sourceMappingURL=index.js.map

package/dist/src/delta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/delta/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/factpack/action-selector.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Action Selector
+ *
+ * Selects and scores key actions from a BaseSnapshot.
+ *
+ * Design: Generic First, Specific Second
+ * 1. Score ALL interactive elements generically (works on any page)
+ * 2. Optionally categorize actions (may return 'generic')
+ * 3. Select top actions above threshold
+ */
+import type { BaseSnapshot } from '../snapshot/snapshot.types.js';
+import type { ActionSelectionResult, DialogDetectionResult, FormDetectionResult, PageClassification } from './types.js';
+/**
+ * Options for action selection.
+ */
+export interface ActionSelectionOptions {
+    /** Max actions to return (default: 12) */
+    max_actions?: number;
+    /** Min score threshold (default: 0.2) */
+    min_action_score?: number;
+    /** Form detection result for context */
+    forms?: FormDetectionResult;
+    /** Dialog detection result for context */
+    dialogs?: DialogDetectionResult;
+    /** Page classification for context */
+    pageType?: PageClassification;
+}
+/**
+ * Select key actions from a BaseSnapshot.
+ *
+ * @param snapshot - The snapshot to analyze
+ * @param options - Selection options
+ * @returns Selection result with top actions and metadata
+ */
+export declare function selectKeyActions(snapshot: BaseSnapshot, options?: ActionSelectionOptions): ActionSelectionResult;
+//# sourceMappingURL=action-selector.d.ts.map

package/dist/src/factpack/action-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-selector.d.ts","sourceRoot":"","sources":["../../../src/factpack/action-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,+BAA+B,CAAC;AAGpG,OAAO,KAAK,EACV,qBAAqB,EAIrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAyTpB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,wCAAwC;IACxC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAE5B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAyHvB"}