agent-web-interface 4.4.0 → 4.5.1

package/dist/src/session/session-controller.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Session Controller
+ *
+ * Per-tenant state container that implements ToolContext.
+ * Each agent/session gets its own SessionController instance
+ * with isolated pages, snapshots, state managers, and registries.
+ *
+ * Each session owns its own SessionManager and browser lifecycle,
+ * configured independently via BrowserSessionConfig.
+ *
+ * @module session/session-controller
+ */
+import type { BaseSnapshot, ReadableNode } from '../snapshot/snapshot.types.js';
+import { SessionManager } from '../browser/session-manager.js';
+import { SnapshotStore } from '../snapshot/snapshot-store.js';
+import { StateManager } from '../state/state-manager.js';
+import { DependencyTracker } from '../form/dependency-tracker.js';
+import { ObservationAccumulator } from '../observation/observation-accumulator.js';
+import type { ToolContext, CdpSessionResult, SnapshotCaptureResult } from '../tools/tool-context.types.js';
+import { type BrowserSessionConfig } from '../browser/browser-session-config.js';
+import type { PageHandle } from '../browser/page-registry.js';
+/**
+ * Session state machine.
+ */
+export type SessionState = 'initializing' | 'active' | 'closing' | 'closed';
+/**
+ * SessionController configuration.
+ */
+export interface SessionControllerOptions {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Optional browser configuration for this session */
+    browserConfig?: BrowserSessionConfig;
+}
+/**
+ * Per-tenant session controller implementing ToolContext.
+ *
+ * Owns all per-session state:
+ * - SessionManager (per-session browser lifecycle)
+ * - SnapshotStore (per-session snapshot cache)
+ * - StateManagers (one per page)
+ * - DependencyTracker (per-session form dependencies)
+ * - ObservationAccumulator (per-session DOM mutation tracking)
+ */
+export declare class SessionController implements ToolContext {
+    readonly sessionId: string;
+    private _sessionManager;
+    private _browserConfig;
+    private readonly _snapshotStore;
+    private readonly _stateManagers;
+    private readonly _dependencyTracker;
+    private readonly _observationAccumulator;
+    /** Deduplication promise for concurrent ensureBrowser() calls */
+    private _ensureBrowserPromise;
+    /** Unsubscribe from SessionManager state changes (cleanup in close()) */
+    private _unsubStateChange;
+    private _state;
+    private _lastActivity;
+    constructor(options: SessionControllerOptions);
+    /** Get the current session state. */
+    get state(): SessionState;
+    /** Touch the session to update last activity timestamp. */
+    touch(): void;
+    /** Get the time of last activity. */
+    get lastActivity(): number;
+    /**
+     * Close the session and clean up all resources, including the owned browser.
+     */
+    close(): Promise<void>;
+    /**
+     * Check if browser configuration can be changed.
+     * Returns true when no browser is running (before first launch or after crash).
+     */
+    canReconfigure(): boolean;
+    /**
+     * Shut down the current browser and clear session state so the browser
+     * can be reconfigured (e.g., switch from a launched browser to auto_connect).
+     */
+    resetBrowser(): Promise<void>;
+    /**
+     * Set the browser configuration for this session.
+     *
+     * Must be called before the browser is launched/connected (i.e., before
+     * the first browser-touching tool call). Throws if browser is already running.
+     */
+    setBrowserConfig(config: BrowserSessionConfig): void;
+    getBrowserConfig(): BrowserSessionConfig;
+    /**
+     * Ensure the session's browser is ready.
+     *
+     * Lazily creates a SessionManager and launches/connects based on
+     * the session's BrowserSessionConfig. Idempotent — returns immediately
+     * if the browser is already running. Concurrent calls are deduplicated.
+     */
+    ensureBrowser(): Promise<void>;
+    resolvePage(pageId?: string): PageHandle | undefined;
+    resolvePageOrCreate(pageId?: string): Promise<PageHandle>;
+    resolveExistingPage(pageId?: string): PageHandle;
+    touchPage(pageId: string): void;
+    closePage(pageId: string): Promise<boolean>;
+    syncPages(): Promise<PageHandle[]>;
+    navigateTo(pageId: string, url: string): Promise<void>;
+    getSessionManager(): SessionManager;
+    getSnapshotStore(): SnapshotStore;
+    getStateManager(pageId: string): StateManager;
+    removeStateManager(pageId: string): void;
+    clearAllStateManagers(): void;
+    getDependencyTracker(): DependencyTracker;
+    getObservationAccumulator(): ObservationAccumulator;
+    ensureCdpSession(handle: PageHandle): Promise<CdpSessionResult>;
+    captureSnapshotWithRecovery(handle: PageHandle, pageId: string): Promise<SnapshotCaptureResult>;
+    requireSnapshot(pageId: string): BaseSnapshot;
+    resolveElementByEid(pageId: string, eid: string, snapshot: BaseSnapshot): ReadableNode;
+    /**
+     * Get or lazily create the session's own SessionManager.
+     */
+    private getOrCreateSessionManager;
+    /**
+     * Clear stale per-page state (snapshots, state managers, dependencies).
+     * Called when the browser crashes or disconnects unexpectedly.
+     */
+    private clearSessionState;
+}
+//# sourceMappingURL=session-controller.d.ts.map

package/dist/src/session/session-controller.d.ts.map

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

package/dist/src/session/session-controller.js

@@ -0,0 +1,276 @@
+/**
+ * Session Controller
+ *
+ * Per-tenant state container that implements ToolContext.
+ * Each agent/session gets its own SessionController instance
+ * with isolated pages, snapshots, state managers, and registries.
+ *
+ * Each session owns its own SessionManager and browser lifecycle,
+ * configured independently via BrowserSessionConfig.
+ *
+ * @module session/session-controller
+ */
+import { SessionManager } from '../browser/session-manager.js';
+import { SnapshotStore } from '../snapshot/snapshot-store.js';
+import { StateManager } from '../state/state-manager.js';
+import { DependencyTracker } from '../form/dependency-tracker.js';
+import { ObservationAccumulator } from '../observation/observation-accumulator.js';
+import { ensureCdpSession as ensureCdpSessionImpl, resolveExistingPage as resolveExistingPageImpl, } from '../tools/tool-context.js';
+import { captureSnapshotWithRecovery as captureSnapshotWithRecoveryImpl } from '../tools/action-context.js';
+import { ElementNotFoundError, StaleElementError, SnapshotRequiredError } from '../tools/errors.js';
+import { defaultBrowserConfig, } from '../browser/browser-session-config.js';
+import { ensureBrowserReady } from '../browser/ensure-browser.js';
+import { getLogger } from '../shared/services/logging.service.js';
+const logger = getLogger();
+/**
+ * Per-tenant session controller implementing ToolContext.
+ *
+ * Owns all per-session state:
+ * - SessionManager (per-session browser lifecycle)
+ * - SnapshotStore (per-session snapshot cache)
+ * - StateManagers (one per page)
+ * - DependencyTracker (per-session form dependencies)
+ * - ObservationAccumulator (per-session DOM mutation tracking)
+ */
+export class SessionController {
+    sessionId;
+    _sessionManager = null;
+    _browserConfig;
+    _snapshotStore;
+    _stateManagers = new Map();
+    _dependencyTracker;
+    _observationAccumulator;
+    /** Deduplication promise for concurrent ensureBrowser() calls */
+    _ensureBrowserPromise = null;
+    /** Unsubscribe from SessionManager state changes (cleanup in close()) */
+    _unsubStateChange = null;
+    _state = 'initializing';
+    _lastActivity = Date.now();
+    constructor(options) {
+        this.sessionId = options.sessionId;
+        this._browserConfig = options.browserConfig ?? defaultBrowserConfig();
+        this._snapshotStore = new SnapshotStore();
+        this._dependencyTracker = new DependencyTracker();
+        this._observationAccumulator = new ObservationAccumulator();
+        this._state = 'active';
+    }
+    // ---------------------------------------------------------------------------
+    // Session lifecycle
+    // ---------------------------------------------------------------------------
+    /** Get the current session state. */
+    get state() {
+        return this._state;
+    }
+    /** Touch the session to update last activity timestamp. */
+    touch() {
+        this._lastActivity = Date.now();
+    }
+    /** Get the time of last activity. */
+    get lastActivity() {
+        return this._lastActivity;
+    }
+    /**
+     * Close the session and clean up all resources, including the owned browser.
+     */
+    async close() {
+        if (this._state === 'closing' || this._state === 'closed')
+            return;
+        this._state = 'closing';
+        this._unsubStateChange?.();
+        this._unsubStateChange = null;
+        this._snapshotStore.destroy();
+        this._stateManagers.clear();
+        this._dependencyTracker.clearAll();
+        // Shut down the owned browser
+        if (this._sessionManager) {
+            try {
+                await this._sessionManager.shutdown();
+            }
+            catch (err) {
+                logger.error('Error shutting down session browser', err instanceof Error ? err : undefined, { sessionId: this.sessionId });
+            }
+            this._sessionManager = null;
+        }
+        this._state = 'closed';
+    }
+    // ---------------------------------------------------------------------------
+    // Browser lifecycle (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    /**
+     * Check if browser configuration can be changed.
+     * Returns true when no browser is running (before first launch or after crash).
+     */
+    canReconfigure() {
+        if (this._ensureBrowserPromise)
+            return false;
+        return !(this._sessionManager?.isRunning() ?? false);
+    }
+    /**
+     * Shut down the current browser and clear session state so the browser
+     * can be reconfigured (e.g., switch from a launched browser to auto_connect).
+     */
+    async resetBrowser() {
+        if (this._sessionManager) {
+            await this._sessionManager.shutdown();
+        }
+        this.clearSessionState();
+    }
+    /**
+     * Set the browser configuration for this session.
+     *
+     * Must be called before the browser is launched/connected (i.e., before
+     * the first browser-touching tool call). Throws if browser is already running.
+     */
+    setBrowserConfig(config) {
+        if (!this.canReconfigure()) {
+            throw new Error('Cannot change browser configuration while the browser is running.');
+        }
+        const overrides = Object.fromEntries(Object.entries(config).filter(([, v]) => v !== undefined));
+        this._browserConfig = { ...this._browserConfig, ...overrides };
+    }
+    getBrowserConfig() {
+        return { ...this._browserConfig };
+    }
+    /**
+     * Ensure the session's browser is ready.
+     *
+     * Lazily creates a SessionManager and launches/connects based on
+     * the session's BrowserSessionConfig. Idempotent — returns immediately
+     * if the browser is already running. Concurrent calls are deduplicated.
+     */
+    async ensureBrowser() {
+        // Deduplicate concurrent calls — all callers await the same promise
+        if (this._ensureBrowserPromise) {
+            await this._ensureBrowserPromise;
+            return;
+        }
+        const session = this.getOrCreateSessionManager();
+        // ensureBrowserReady handles the isRunning() fast-path internally
+        this._ensureBrowserPromise = ensureBrowserReady(session, this._browserConfig);
+        try {
+            await this._ensureBrowserPromise;
+        }
+        finally {
+            this._ensureBrowserPromise = null;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Page lifecycle (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    resolvePage(pageId) {
+        this.touch();
+        return this.getSessionManager().resolvePage(pageId);
+    }
+    async resolvePageOrCreate(pageId) {
+        this.touch();
+        return this.getSessionManager().resolvePageOrCreate(pageId);
+    }
+    resolveExistingPage(pageId) {
+        this.touch();
+        return resolveExistingPageImpl(this.getSessionManager(), pageId);
+    }
+    touchPage(pageId) {
+        this.getSessionManager().touchPage(pageId);
+    }
+    async closePage(pageId) {
+        return this.getSessionManager().closePage(pageId);
+    }
+    async syncPages() {
+        return this.getSessionManager().syncPages();
+    }
+    async navigateTo(pageId, url) {
+        await this.getSessionManager().navigateTo(pageId, url);
+    }
+    // ---------------------------------------------------------------------------
+    // State access (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    getSessionManager() {
+        return this.getOrCreateSessionManager();
+    }
+    getSnapshotStore() {
+        return this._snapshotStore;
+    }
+    getStateManager(pageId) {
+        if (!this._stateManagers.has(pageId)) {
+            this._stateManagers.set(pageId, new StateManager({ pageId }));
+        }
+        return this._stateManagers.get(pageId);
+    }
+    removeStateManager(pageId) {
+        this._stateManagers.delete(pageId);
+    }
+    clearAllStateManagers() {
+        this._stateManagers.clear();
+    }
+    getDependencyTracker() {
+        return this._dependencyTracker;
+    }
+    getObservationAccumulator() {
+        return this._observationAccumulator;
+    }
+    // ---------------------------------------------------------------------------
+    // CDP health (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    async ensureCdpSession(handle) {
+        return ensureCdpSessionImpl(this.getSessionManager(), handle);
+    }
+    // ---------------------------------------------------------------------------
+    // Snapshot capture (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    async captureSnapshotWithRecovery(handle, pageId) {
+        return captureSnapshotWithRecoveryImpl(this, handle, pageId);
+    }
+    // ---------------------------------------------------------------------------
+    // Element resolution (ToolContext implementation)
+    // ---------------------------------------------------------------------------
+    requireSnapshot(pageId) {
+        const snap = this._snapshotStore.getByPageId(pageId);
+        if (!snap) {
+            throw new SnapshotRequiredError(pageId);
+        }
+        return snap;
+    }
+    resolveElementByEid(pageId, eid, snapshot) {
+        const stateManager = this.getStateManager(pageId);
+        const registry = stateManager.getElementRegistry();
+        const elementRef = registry.getByEid(eid);
+        if (!elementRef) {
+            throw new ElementNotFoundError(eid);
+        }
+        if (registry.isStale(eid)) {
+            throw new StaleElementError(eid);
+        }
+        const node = snapshot.nodes.find((n) => n.backend_node_id === elementRef.ref.backend_node_id);
+        if (!node) {
+            throw new StaleElementError(eid);
+        }
+        return node;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Get or lazily create the session's own SessionManager.
+     */
+    getOrCreateSessionManager() {
+        if (!this._sessionManager) {
+            this._sessionManager = new SessionManager();
+            this._unsubStateChange = this._sessionManager.onStateChange((event) => {
+                if (event.currentState === 'failed') {
+                    this.clearSessionState();
+                }
+            });
+        }
+        return this._sessionManager;
+    }
+    /**
+     * Clear stale per-page state (snapshots, state managers, dependencies).
+     * Called when the browser crashes or disconnects unexpectedly.
+     */
+    clearSessionState() {
+        this._snapshotStore.clear();
+        this._stateManagers.clear();
+        this._dependencyTracker.clearAll();
+    }
+}
+//# sourceMappingURL=session-controller.js.map

package/dist/src/session/session-controller.js.map

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

package/dist/src/shared/services/index.d.ts

@@ -1,7 +1,5 @@
 /**
  * Shared services re-exports
  */
-export * from './selector-builder.service.js';
-export * from './dom-transformer.service.js';
 export * from './logging.service.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/shared/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC"}

package/dist/src/shared/services/index.js

@@ -1,7 +1,5 @@
 /**
  * Shared services re-exports
  */
-export * from './selector-builder.service.js';
-export * from './dom-transformer.service.js';
 export * from './logging.service.js';
 //# sourceMappingURL=index.js.map

package/dist/src/shared/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC"}

package/dist/src/shared/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Package version constant.
+ *
+ * Reads the version from package.json at build time via createRequire,
+ * providing a single source of truth for all entry points.
+ *
+ * @module shared/version
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/src/shared/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/shared/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,eAAO,MAAM,OAAO,QAAuB,CAAC"}

package/dist/src/shared/version.js

@@ -0,0 +1,32 @@
+/**
+ * Package version constant.
+ *
+ * Reads the version from package.json at build time via createRequire,
+ * providing a single source of truth for all entry points.
+ *
+ * @module shared/version
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Walk up from the current file to find package.json.
+ * Works from both src/ (dev) and dist/src/ (built) locations.
+ */
+function findPackageVersion() {
+    let dir = __dirname;
+    for (let i = 0; i < 5; i++) {
+        try {
+            const pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf-8'));
+            return pkg.version;
+        }
+        catch {
+            dir = dirname(dir);
+        }
+    }
+    console.warn('Warning: Could not find package.json to read version — defaulting to 0.0.0');
+    return '0.0.0';
+}
+export const VERSION = findPackageVersion();
+//# sourceMappingURL=version.js.map

package/dist/src/shared/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/shared/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,SAAS,kBAAkB;IACzB,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAEzE,CAAC;YACF,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/src/snapshot/element-resolver.d.ts

@@ -24,8 +24,9 @@ export declare function getElementTopLeft(cdp: CdpClient, backendNodeId: number)
 /**
  * Click an element at its center using CDP's backendNodeId.
  *
- * Bypasses Playwright's locator system to avoid strict mode violations
- * when multiple elements match the same selector.
+ * If the element is tiny (< 5x5 px), searches for a larger clickable
+ * ancestor (label, parent wrapper) to click instead — common for hidden
+ * radio/checkbox inputs with custom visual wrappers.
  */
 export declare function clickByBackendNodeId(cdp: CdpClient, backendNodeId: number, modifiers?: string[]): Promise<void>;
 /**

package/dist/src/snapshot/element-resolver.d.ts.map

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

package/dist/src/snapshot/element-resolver.js

@@ -109,11 +109,9 @@ export async function getElementTopLeft(cdp, backendNodeId) {
     return { x: content[0], y: content[1] };
 }
 /**
- * Get the center coordinates of an element by its backendNodeId.
- * Scrolls the element into view first.
+ * Compute center point from a content quad, with validation.
  */
-async function getElementCenter(cdp, backendNodeId) {
-    const content = await scrollAndGetContentQuad(cdp, backendNodeId);
+function centerFromContentQuad(content, backendNodeId) {
     const [x1, y1, x2, , , y3] = content;
     const x = x1 + (x2 - x1) / 2;
     const y = y1 + (y3 - y1) / 2;
@@ -123,17 +121,86 @@ async function getElementCenter(cdp, backendNodeId) {
     }
     return { x, y };
 }
+/**
+ * Get the center coordinates of an element by its backendNodeId.
+ * Scrolls the element into view first.
+ */
+async function getElementCenter(cdp, backendNodeId) {
+    const content = await scrollAndGetContentQuad(cdp, backendNodeId);
+    return centerFromContentQuad(content, backendNodeId);
+}
 // ============================================================================
 // Click Operations
 // ============================================================================
+/**
+ * Minimum element dimension (px) below which we search for a larger clickable ancestor.
+ * Hidden radio/checkbox inputs are commonly 1x1 or 0x0 with a visible label wrapper.
+ */
+const MIN_CLICKABLE_SIZE = 5;
+/**
+ * Find a clickable ancestor when the target element is too small to reliably click.
+ * Walks up the DOM looking for a parent/label with a reasonable bounding box.
+ *
+ * @returns backendNodeId of a better click target, or the original if none found
+ */
+async function findClickableAncestor(cdp, backendNodeId) {
+    try {
+        const { object } = await cdp.send('DOM.resolveNode', { backendNodeId });
+        if (!object.objectId)
+            return backendNodeId;
+        const result = await cdp.send('Runtime.callFunctionOn', {
+            objectId: object.objectId,
+            functionDeclaration: `function() {
+        var MIN = ${MIN_CLICKABLE_SIZE};
+        var el = this;
+        if (el.id) {
+          var label = document.querySelector('label[for="' + CSS.escape(el.id) + '"]');
+          if (label && label.offsetWidth > MIN && label.offsetHeight > MIN) return label;
+        }
+        var current = el.parentElement;
+        for (var i = 0; i < 5 && current; i++) {
+          if (current.offsetWidth > MIN && current.offsetHeight > MIN) return current;
+          current = current.parentElement;
+        }
+        return null;
+      }`,
+            returnByValue: false,
+        });
+        if (result.result?.objectId) {
+            const desc = await cdp.send('DOM.describeNode', {
+                objectId: result.result.objectId,
+            });
+            if (desc.node?.backendNodeId) {
+                return desc.node.backendNodeId;
+            }
+        }
+    }
+    catch {
+        // Non-critical — ancestor lookup can fail for detached nodes
+    }
+    return backendNodeId;
+}
 /**
  * Click an element at its center using CDP's backendNodeId.
  *
- * Bypasses Playwright's locator system to avoid strict mode violations
- * when multiple elements match the same selector.
+ * If the element is tiny (< 5x5 px), searches for a larger clickable
+ * ancestor (label, parent wrapper) to click instead — common for hidden
+ * radio/checkbox inputs with custom visual wrappers.
  */
 export async function clickByBackendNodeId(cdp, backendNodeId, modifiers) {
-    const { x, y } = await getElementCenter(cdp, backendNodeId);
+    const content = await scrollAndGetContentQuad(cdp, backendNodeId);
+    const [x1, y1, x2, , , y3] = content;
+    const width = x2 - x1;
+    const height = y3 - y1;
+    if (width < MIN_CLICKABLE_SIZE && height < MIN_CLICKABLE_SIZE) {
+        const ancestor = await findClickableAncestor(cdp, backendNodeId);
+        if (ancestor !== backendNodeId) {
+            const center = await getElementCenter(cdp, ancestor);
+            await clickAtCoordinates(cdp, center.x, center.y, modifiers);
+            return;
+        }
+    }
+    const { x, y } = centerFromContentQuad(content, backendNodeId);
     await clickAtCoordinates(cdp, x, y, modifiers);
 }
 /**
@@ -144,6 +211,12 @@ export async function clickAtCoordinates(cdp, x, y, modifiers) {
         throw new Error(`Invalid click coordinates (x: ${x}, y: ${y}). Coordinates must be non-negative finite numbers.`);
     }
     const modifierBits = computeModifiers(modifiers);
+    await cdp.send('Input.dispatchMouseEvent', {
+        type: 'mouseMoved',
+        x,
+        y,
+        modifiers: modifierBits,
+    });
     await cdp.send('Input.dispatchMouseEvent', {
         type: 'mousePressed',
         x,
@@ -304,7 +377,9 @@ export async function selectOption(cdp, backendNodeId, value) {
         const available = options.map(o => o.text || o.value).join(', ');
         throw new Error('Option not found: "' + targetValue + '". Available: ' + available);
       }
-      this.value = option.value;
+      var nativeSetter = Object.getOwnPropertyDescriptor(HTMLSelectElement.prototype, 'value').set;
+      nativeSetter.call(this, option.value);
+      this.dispatchEvent(new Event('input', { bubbles: true }));
       this.dispatchEvent(new Event('change', { bubbles: true }));
       return option.text;
     }`,