@vostride/agent-qa-web 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Page, LaunchOptions, BrowserContextOptions, Locator } from 'playwright-core';
-import { PlatformAdapter, OperationCaptureSupport, PlatformConfig, LiveStreamCapability, RecordingCapability, ObserveOptions, ActionsFor, ExecuteOptions, ActionResult, ConsoleLogEntry, NetworkLogEntry, InterimNode, Action, AccessibilityViolation } from '@vostride/agent-qa-runner';
+import { Page, Locator } from 'playwright-core';
+import { PlatformAdapter, OperationCaptureSupport, PlatformConfig, LiveStreamCapability, RecordingCapability, ActionsFor, ExecuteOptions, ActionResult, ConsoleLogEntry, NetworkLogEntry, InterimNode, Action, AccessibilityViolation } from '@vostride/agent-qa-runner';
 import { ScreenState } from '@vostride/agent-qa-schema';
 
 interface WebPlatformAdapterOptions {
@@ -16,6 +16,7 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private epoch;
     private pageLogBuffers;
     private logCaptureConfig;
+    private navigationTimeoutMs;
     private disconnected;
     private intentionalClose;
     private armedRoutes;
@@ -38,34 +39,13 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private operationCapture;
     operationCaptureSupport: OperationCaptureSupport | undefined;
     setup(config: PlatformConfig): Promise<void>;
-    /**
-     * 403 D-05/LIVE-01: the Chromium screencast producer, or ABSENT when this adapter cannot stream.
-     *
-     * Absence means "no continuous stream", not "no preview": since 428-05 the composition's
-     * `liveStreamFor` wraps this adapter's `screenshot()` in the labelled 1 s snapshot producer, both
-     * as the fallback behind a screencast that fails to start and as the whole preview on a
-     * non-Chromium target. The two gates here (Chromium only, and a page to stream) stay exactly as
-     * they are, so the absence stays honest.
-     *
-     * SCOPE (428 D-18, closes WIN #273): the screencast shows the page the test is acting on. Both
-     * page-switch sites (`tab new`, `tab switch`) go through `setActivePage`, which re-binds the
-     * running screencast to the new page INSIDE this same capability object: no stop, no re-register,
-     * no stream end, so a subscriber only sees the picture change. Start, stop and re-bind run on one
-     * serialised chain. A popup or a closing tab never changes `this.page` in this adapter, so the
-     * preview already shows the acting page in those cases.
-     */
     get liveStream(): LiveStreamCapability | undefined;
-    /** Run `step` after every earlier start, stop and re-bind has settled (428 D-18). */
+    /** Run `step` after every earlier start, stop and re-bind has settled. */
     private onScreencastChain;
     /** Stop and detach the current CDP session, best-effort, and forget its tokens and keepalive. */
     private detachScreencast;
     /** Wire `cdp`'s screencast frames to `onFrame`; shared by `start` and `rebindScreencast`. */
     private attachScreencast;
-    /**
-     * The one place the page the test acts on changes (428 D-18). Recording keeps following its
-     * starting page through the revision counter (424 reconciliation 25(d)); the live screencast,
-     * when running, re-binds to the new page on the serialised chain.
-     */
     private setActivePage;
     /**
      * Move the running screencast onto `this.page` without its subscribers noticing: the old session
@@ -74,16 +54,7 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
      * unknown. Best-effort throughout; it never throws into a step.
      */
     private rebindScreencast;
-    /**
-     * 428 D-12's second half: the screencast was withdrawn while the browser is still up (its CDP
-     * session detached or unusable), which only this capability can see. Detected when a keepalive
-     * capture or a re-bind's start rejects on the active session; the capability then serves the
-     * labelled 1 s snapshot preview of the current page through the same `onFrame`, until `stop()`,
-     * `cleanup()` or a successful re-bind. The declared kind stays `cdp-screencast`; the frames carry
-     * `kind: 'snapshot'`, which is what labels the preview. Runs on the serialised chain.
-     */
     private handleScreencastWithdrawn;
-    /** While the snapshot fallback runs, try the screencast again every SCREENCAST_RECOVERY_MS (428 WR-08). */
     private armScreencastRecovery;
     private clearScreencastRecovery;
     private browserIsLive;
@@ -91,29 +62,21 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private clearKeepalive;
     /** (Re-)arm the quiet-page keepalive for `cdp`; every screencast frame pushes it back. */
     private armKeepalive;
-    /**
-     * 428 D-15: a fresh capture on the same CDP session, emitted as a frame with no ack token (the ack
-     * path drops ids it never minted a token for). A capture that rejects emits nothing. While the
-     * capability is started under a live browser, a session that then fails a trivial probe too is a
-     * withdrawn screencast (D-12, see `handleScreencastWithdrawn`); one that still answers only had a
-     * bad moment, such as a cross-process navigation, and re-arms (428 WR-08). One that never settles
-     * emits nothing and arms nothing, which is the honest amber.
-     */
     private fireKeepalive;
     /** Whether `cdp` still answers a command that cannot fail on a usable session. */
     private sessionAnswers;
     get recording(): RecordingCapability | undefined;
     cleanup(): Promise<void>;
     get isBrowserDisconnected(): boolean;
-    observe(options?: ObserveOptions): Promise<ScreenState>;
+    observe(): Promise<ScreenState>;
     private observeDocument;
     execute(action: ActionsFor<'web'>, options?: ExecuteOptions): Promise<ActionResult>;
+    private stopLoading;
     private executeWithErrorResult;
     screenshot(): Promise<Buffer | undefined>;
     getPage(): Page | null;
     drainConsoleLogs(level?: string): ConsoleLogEntry[];
     drainNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    /** 439 D-04: a completed download's bytes held in memory, by its sha256. */
     readDownloadBytes(sha256: string): Uint8Array | undefined;
     peekNetworkLogs(urlPattern?: string): NetworkLogEntry[];
     private attachLogListeners;
@@ -121,67 +84,10 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private executeAction;
 }
 
-declare class FarmWebAdapter implements PlatformAdapter<'web'> {
-    readonly platform: "web";
-    private browser;
-    private context;
-    private page;
-    private lastRefs;
-    private epoch;
-    private sessionUrl;
-    private sessionId;
-    private testFailed;
-    private exitHandler;
-    private credentials;
-    private pageLogBuffers;
-    private logCaptureConfig;
-    private armedRoutes;
-    private pendingDialogArm;
-    private recordingCapability;
-    private recordingConfig;
-    setup(config: PlatformConfig): Promise<void>;
-    get recording(): RecordingCapability | undefined;
-    cleanup(): Promise<void>;
-    observe(options?: ObserveOptions): Promise<ScreenState>;
-    private observeDocument;
-    execute(action: ActionsFor<'web'>): Promise<ActionResult>;
-    screenshot(): Promise<Buffer | undefined>;
-    getPage(): Page | null;
-    markFailed(): void;
-    getSessionUrl(): string | undefined;
-    getSessionId(): string | undefined;
-    drainConsoleLogs(level?: string): ConsoleLogEntry[];
-    drainNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    peekNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    private attachLogListeners;
-    private resolveTabTargetAsync;
-    private executeAction;
-}
-
-/**
- * Parse a Playwright ARIA snapshot into platform-neutral runner interim nodes.
- *
- * Emits nodes in document order with role/name/attributes and a `parentIndex`
- * derived from indentation depth: the nearest kept entry among the line's true
- * ancestors; a dropped line still bounds its subtree (438 gap round, CR-02). A line
- * whose role is not kept never becomes a node: its quoted name and inline text fold
- * into the nearest kept entry among the line's true ancestors (438 D-02, the row
- * text), and a kept content line's own inline text becomes its `text`. Playwright
- * ai-mode `[ref=eN]` annotations are captured into an index-aligned `nativeRefs`
- * array (adapter-private native handles) and are never written into the node. Accepts both ai-mode (annotated) and default-mode
- * (unannotated) snapshot text.
- *
- * No ref minting and no tree rendering happen here — the shared runner builder
- * owns both (D-01/D-02/D-03).
- */
 declare function parseAriaSnapshot(ariaTree: string): {
     nodes: InterimNode[];
     nativeRefs: (string | undefined)[];
 };
-declare function observePage(page: Page, options?: {
-    filterSelector?: string;
-    extractDom?: boolean;
-}): Promise<ScreenState>;
 
 type RefMap = Record<string, {
     nativeRef: string;
@@ -195,16 +101,6 @@ type RefMap = Record<string, {
         height: number;
     };
 }>;
-interface WebAdapterConfig extends PlatformConfig {
-    launchOptions?: LaunchOptions;
-    contextOptions?: BrowserContextOptions;
-    filterSelector?: string;
-}
-interface SnapshotResult {
-    tree: string;
-    refs: RefMap;
-    elementCount: number;
-}
 
 /** Resolves a ref to the aria-ref locator of the element observed under it; never by position. */
 declare class ElementResolver {
@@ -246,10 +142,4 @@ interface AccessibilityOptions {
 }
 declare function runAccessibilityCheck(page: Page, options?: AccessibilityOptions): Promise<AccessibilityViolation[]>;
 
-interface ExtractDomOptions {
-    maxDepth?: number;
-    maxTextLen?: number;
-}
-declare function extractDom(page: Page, opts?: ExtractDomOptions): Promise<string | undefined>;
-
-export { type AccessibilityOptions, ActionValidationError, ElementResolver, type ExtractDomOptions, FarmWebAdapter, type RefMap, type SmartWaitOptions, type SnapshotResult, type ValidationResult, type WebAdapterConfig, WebPlatformAdapter, extractDom, observePage, parseAriaSnapshot, runAccessibilityCheck, validateAction, waitForPageReady };
+export { type AccessibilityOptions, ActionValidationError, ElementResolver, type RefMap, type SmartWaitOptions, type ValidationResult, WebPlatformAdapter, parseAriaSnapshot, runAccessibilityCheck, validateAction, waitForPageReady };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Page, LaunchOptions, BrowserContextOptions, Locator } from 'playwright-core';
-import { PlatformAdapter, OperationCaptureSupport, PlatformConfig, LiveStreamCapability, RecordingCapability, ObserveOptions, ActionsFor, ExecuteOptions, ActionResult, ConsoleLogEntry, NetworkLogEntry, InterimNode, Action, AccessibilityViolation } from '@vostride/agent-qa-runner';
+import { Page, Locator } from 'playwright-core';
+import { PlatformAdapter, OperationCaptureSupport, PlatformConfig, LiveStreamCapability, RecordingCapability, ActionsFor, ExecuteOptions, ActionResult, ConsoleLogEntry, NetworkLogEntry, InterimNode, Action, AccessibilityViolation } from '@vostride/agent-qa-runner';
 import { ScreenState } from '@vostride/agent-qa-schema';
 
 interface WebPlatformAdapterOptions {
@@ -16,6 +16,7 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private epoch;
     private pageLogBuffers;
     private logCaptureConfig;
+    private navigationTimeoutMs;
     private disconnected;
     private intentionalClose;
     private armedRoutes;
@@ -38,34 +39,13 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private operationCapture;
     operationCaptureSupport: OperationCaptureSupport | undefined;
     setup(config: PlatformConfig): Promise<void>;
-    /**
-     * 403 D-05/LIVE-01: the Chromium screencast producer, or ABSENT when this adapter cannot stream.
-     *
-     * Absence means "no continuous stream", not "no preview": since 428-05 the composition's
-     * `liveStreamFor` wraps this adapter's `screenshot()` in the labelled 1 s snapshot producer, both
-     * as the fallback behind a screencast that fails to start and as the whole preview on a
-     * non-Chromium target. The two gates here (Chromium only, and a page to stream) stay exactly as
-     * they are, so the absence stays honest.
-     *
-     * SCOPE (428 D-18, closes WIN #273): the screencast shows the page the test is acting on. Both
-     * page-switch sites (`tab new`, `tab switch`) go through `setActivePage`, which re-binds the
-     * running screencast to the new page INSIDE this same capability object: no stop, no re-register,
-     * no stream end, so a subscriber only sees the picture change. Start, stop and re-bind run on one
-     * serialised chain. A popup or a closing tab never changes `this.page` in this adapter, so the
-     * preview already shows the acting page in those cases.
-     */
     get liveStream(): LiveStreamCapability | undefined;
-    /** Run `step` after every earlier start, stop and re-bind has settled (428 D-18). */
+    /** Run `step` after every earlier start, stop and re-bind has settled. */
     private onScreencastChain;
     /** Stop and detach the current CDP session, best-effort, and forget its tokens and keepalive. */
     private detachScreencast;
     /** Wire `cdp`'s screencast frames to `onFrame`; shared by `start` and `rebindScreencast`. */
     private attachScreencast;
-    /**
-     * The one place the page the test acts on changes (428 D-18). Recording keeps following its
-     * starting page through the revision counter (424 reconciliation 25(d)); the live screencast,
-     * when running, re-binds to the new page on the serialised chain.
-     */
     private setActivePage;
     /**
      * Move the running screencast onto `this.page` without its subscribers noticing: the old session
@@ -74,16 +54,7 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
      * unknown. Best-effort throughout; it never throws into a step.
      */
     private rebindScreencast;
-    /**
-     * 428 D-12's second half: the screencast was withdrawn while the browser is still up (its CDP
-     * session detached or unusable), which only this capability can see. Detected when a keepalive
-     * capture or a re-bind's start rejects on the active session; the capability then serves the
-     * labelled 1 s snapshot preview of the current page through the same `onFrame`, until `stop()`,
-     * `cleanup()` or a successful re-bind. The declared kind stays `cdp-screencast`; the frames carry
-     * `kind: 'snapshot'`, which is what labels the preview. Runs on the serialised chain.
-     */
     private handleScreencastWithdrawn;
-    /** While the snapshot fallback runs, try the screencast again every SCREENCAST_RECOVERY_MS (428 WR-08). */
     private armScreencastRecovery;
     private clearScreencastRecovery;
     private browserIsLive;
@@ -91,29 +62,21 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private clearKeepalive;
     /** (Re-)arm the quiet-page keepalive for `cdp`; every screencast frame pushes it back. */
     private armKeepalive;
-    /**
-     * 428 D-15: a fresh capture on the same CDP session, emitted as a frame with no ack token (the ack
-     * path drops ids it never minted a token for). A capture that rejects emits nothing. While the
-     * capability is started under a live browser, a session that then fails a trivial probe too is a
-     * withdrawn screencast (D-12, see `handleScreencastWithdrawn`); one that still answers only had a
-     * bad moment, such as a cross-process navigation, and re-arms (428 WR-08). One that never settles
-     * emits nothing and arms nothing, which is the honest amber.
-     */
     private fireKeepalive;
     /** Whether `cdp` still answers a command that cannot fail on a usable session. */
     private sessionAnswers;
     get recording(): RecordingCapability | undefined;
     cleanup(): Promise<void>;
     get isBrowserDisconnected(): boolean;
-    observe(options?: ObserveOptions): Promise<ScreenState>;
+    observe(): Promise<ScreenState>;
     private observeDocument;
     execute(action: ActionsFor<'web'>, options?: ExecuteOptions): Promise<ActionResult>;
+    private stopLoading;
     private executeWithErrorResult;
     screenshot(): Promise<Buffer | undefined>;
     getPage(): Page | null;
     drainConsoleLogs(level?: string): ConsoleLogEntry[];
     drainNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    /** 439 D-04: a completed download's bytes held in memory, by its sha256. */
     readDownloadBytes(sha256: string): Uint8Array | undefined;
     peekNetworkLogs(urlPattern?: string): NetworkLogEntry[];
     private attachLogListeners;
@@ -121,67 +84,10 @@ declare class WebPlatformAdapter implements PlatformAdapter<'web'> {
     private executeAction;
 }
 
-declare class FarmWebAdapter implements PlatformAdapter<'web'> {
-    readonly platform: "web";
-    private browser;
-    private context;
-    private page;
-    private lastRefs;
-    private epoch;
-    private sessionUrl;
-    private sessionId;
-    private testFailed;
-    private exitHandler;
-    private credentials;
-    private pageLogBuffers;
-    private logCaptureConfig;
-    private armedRoutes;
-    private pendingDialogArm;
-    private recordingCapability;
-    private recordingConfig;
-    setup(config: PlatformConfig): Promise<void>;
-    get recording(): RecordingCapability | undefined;
-    cleanup(): Promise<void>;
-    observe(options?: ObserveOptions): Promise<ScreenState>;
-    private observeDocument;
-    execute(action: ActionsFor<'web'>): Promise<ActionResult>;
-    screenshot(): Promise<Buffer | undefined>;
-    getPage(): Page | null;
-    markFailed(): void;
-    getSessionUrl(): string | undefined;
-    getSessionId(): string | undefined;
-    drainConsoleLogs(level?: string): ConsoleLogEntry[];
-    drainNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    peekNetworkLogs(urlPattern?: string): NetworkLogEntry[];
-    private attachLogListeners;
-    private resolveTabTargetAsync;
-    private executeAction;
-}
-
-/**
- * Parse a Playwright ARIA snapshot into platform-neutral runner interim nodes.
- *
- * Emits nodes in document order with role/name/attributes and a `parentIndex`
- * derived from indentation depth: the nearest kept entry among the line's true
- * ancestors; a dropped line still bounds its subtree (438 gap round, CR-02). A line
- * whose role is not kept never becomes a node: its quoted name and inline text fold
- * into the nearest kept entry among the line's true ancestors (438 D-02, the row
- * text), and a kept content line's own inline text becomes its `text`. Playwright
- * ai-mode `[ref=eN]` annotations are captured into an index-aligned `nativeRefs`
- * array (adapter-private native handles) and are never written into the node. Accepts both ai-mode (annotated) and default-mode
- * (unannotated) snapshot text.
- *
- * No ref minting and no tree rendering happen here — the shared runner builder
- * owns both (D-01/D-02/D-03).
- */
 declare function parseAriaSnapshot(ariaTree: string): {
     nodes: InterimNode[];
     nativeRefs: (string | undefined)[];
 };
-declare function observePage(page: Page, options?: {
-    filterSelector?: string;
-    extractDom?: boolean;
-}): Promise<ScreenState>;
 
 type RefMap = Record<string, {
     nativeRef: string;
@@ -195,16 +101,6 @@ type RefMap = Record<string, {
         height: number;
     };
 }>;
-interface WebAdapterConfig extends PlatformConfig {
-    launchOptions?: LaunchOptions;
-    contextOptions?: BrowserContextOptions;
-    filterSelector?: string;
-}
-interface SnapshotResult {
-    tree: string;
-    refs: RefMap;
-    elementCount: number;
-}
 
 /** Resolves a ref to the aria-ref locator of the element observed under it; never by position. */
 declare class ElementResolver {
@@ -246,10 +142,4 @@ interface AccessibilityOptions {
 }
 declare function runAccessibilityCheck(page: Page, options?: AccessibilityOptions): Promise<AccessibilityViolation[]>;
 
-interface ExtractDomOptions {
-    maxDepth?: number;
-    maxTextLen?: number;
-}
-declare function extractDom(page: Page, opts?: ExtractDomOptions): Promise<string | undefined>;
-
-export { type AccessibilityOptions, ActionValidationError, ElementResolver, type ExtractDomOptions, FarmWebAdapter, type RefMap, type SmartWaitOptions, type SnapshotResult, type ValidationResult, type WebAdapterConfig, WebPlatformAdapter, extractDom, observePage, parseAriaSnapshot, runAccessibilityCheck, validateAction, waitForPageReady };
+export { type AccessibilityOptions, ActionValidationError, ElementResolver, type RefMap, type SmartWaitOptions, type ValidationResult, WebPlatformAdapter, parseAriaSnapshot, runAccessibilityCheck, validateAction, waitForPageReady };