@ap3x/browser 0.1.0

package/dist/recording/screencast.d.ts

@@ -0,0 +1,40 @@
+import type { TargetRegistry } from "../targets/registry";
+import type { CdpTransport } from "../types";
+export interface ScreencastFrame {
+    /** Base64 PNG data, as CDP delivers it. */
+    data: string;
+    timestamp: number;
+}
+export interface ScreencastRecorderOptions {
+    format?: "png" | "jpeg";
+    quality?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    everyNthFrame?: number;
+    /** Defensive cap on buffered frames (default 600 — e.g. 10min @ 1fps). */
+    maxFrames?: number;
+}
+export declare class ScreencastRecorder {
+    private readonly transport;
+    private readonly registry;
+    private readonly options;
+    private frames;
+    private frameListener?;
+    private focusListener?;
+    private currentSessionId?;
+    private recording;
+    private droppedFrames;
+    constructor(transport: CdpTransport, registry: TargetRegistry, options?: ScreencastRecorderOptions);
+    get isRecording(): boolean;
+    /** Frames captured so far (or, after {@link stop}, the final buffer). */
+    get capturedFrames(): readonly ScreencastFrame[];
+    /** How many frames were dropped after hitting `maxFrames` (observability). */
+    get dropped(): number;
+    /** Begin capturing frames from the focused target, following focus changes. Idempotent. */
+    start(): void;
+    /** Stop capturing and return every buffered frame. */
+    stop(): ScreencastFrame[];
+    private onFrame;
+    private followFocus;
+}
+//# sourceMappingURL=screencast.d.ts.map

package/dist/recording/screencast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencast.d.ts","sourceRoot":"","sources":["../../src/recording/screencast.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,kBAAkB;IAc3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAd3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGoC;IAE5D,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAK;gBAGP,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,cAAc,EACzC,OAAO,GAAE,yBAA8B;IAYzC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,yEAAyE;IACzE,IAAI,cAAc,IAAI,SAAS,eAAe,EAAE,CAE/C;IAED,8EAA8E;IAC9E,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,2FAA2F;IAC3F,KAAK,IAAI,IAAI;IAeb,sDAAsD;IACtD,IAAI,IAAI,eAAe,EAAE;IAezB,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,WAAW;CAwBpB"}

package/dist/screenshot/service.d.ts

@@ -0,0 +1,34 @@
+import type { DomSelectorMap } from "../dom/types";
+import type { CdpTransport } from "../types";
+/**
+ * A 4×4 transparent PNG, returned when no real screenshot is available. A
+ * non-empty base64 sentinel keeps downstream image handling total (design's
+ * placeholder semantics).
+ */
+export declare const PLACEHOLDER_SCREENSHOT = "iVBORw0KGgoAAAANSUhEUgAAAAQAAAAECAYAAACp8Z5+AAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==";
+export interface ScreenshotCaptureOptions {
+    /** Capture beyond the viewport (the full scrollable page). */
+    fullPage?: boolean;
+    /** Draw numbered boxes over the interactive elements before capturing. */
+    highlight?: boolean;
+    /** Required when `highlight` is set — the map whose elements get boxed. */
+    selectorMap?: DomSelectorMap;
+    /** Session of the page being captured (the focused page). */
+    sessionId?: string;
+    /** `"png"` (default) or `"jpeg"`. */
+    format?: "png" | "jpeg";
+    /** JPEG quality 0–100. */
+    quality?: number;
+    /** Caller abort, threaded into the CDP sends (composes with per-request timeout). */
+    signal?: AbortSignal;
+}
+export declare class ScreenshotService {
+    private readonly transport;
+    constructor(transport: CdpTransport);
+    /** Capture a screenshot (base64), optionally with a highlight overlay. */
+    capture(options?: ScreenshotCaptureOptions): Promise<string>;
+    /** Draw the overlay. Returns whether an inject was attempted; never throws. */
+    private injectHighlights;
+    private removeHighlights;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/screenshot/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/screenshot/service.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,qGACiE,CAAC;AAIrG,MAAM,WAAW,wBAAwB;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,YAAY;IAEpD,0EAA0E;IACpE,OAAO,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCtE,+EAA+E;YACjE,gBAAgB;YAkChB,gBAAgB;CAmB/B"}

package/dist/session.d.ts

@@ -0,0 +1,130 @@
+import { type BrowserConfigOverrides, type ResolvedBrowserConfig } from "./config";
+import { DialogHandler } from "./dialogs/handler";
+import { DomService } from "./dom/dom-service";
+import { ElementOverlay } from "./dom/overlay";
+import type { DomSelectorMap, EnhancedDOMTreeNode } from "./dom/types";
+import { type CdpConnectionError } from "./errors";
+import { InputDispatcher } from "./input/dispatcher";
+import { type LaunchedBrowser } from "./launch/local-browser";
+import { type NavigateOptions, type NavigateResult, Navigator } from "./navigation/navigator";
+import { NavigationPolicy } from "./navigation/policy";
+import { HarRecorder } from "./recording/har";
+import { ScreencastRecorder } from "./recording/screencast";
+import { ScreenshotService } from "./screenshot/service";
+import { TargetRegistry } from "./targets/registry";
+import { type BackendNodeId, type BrowserStateSummary, type CdpTransport, type TabId, type TabInfo } from "./types";
+export interface BrowserSessionOptions {
+    /** A launched browser to close when the session stops (launch path only). */
+    ownedBrowser?: LaunchedBrowser;
+}
+/** Injectable seams for {@link BrowserSession.connect} (tests / alt providers). */
+export interface BrowserConnectOptions {
+    /** fetch used for http→ws resolution (defaults to the global fetch). */
+    fetch?: typeof fetch;
+    /** Build the transport from the resolved ws url (defaults to a real socket). */
+    openTransport?: (wsUrl: string) => Promise<CdpTransport>;
+}
+export interface BrowserStateOptions {
+    /** Include a base64 screenshot in the summary. */
+    screenshot?: boolean;
+    /** Caller abort, threaded into the DOM capture + screenshot CDP sends (§6.8). */
+    signal?: AbortSignal;
+}
+export declare class BrowserSession {
+    private readonly transport;
+    readonly config: ResolvedBrowserConfig;
+    readonly registry: TargetRegistry;
+    readonly policy: NavigationPolicy;
+    readonly navigator: Navigator;
+    readonly dom: DomService;
+    readonly input: InputDispatcher;
+    readonly dialogs: DialogHandler;
+    readonly screenshots: ScreenshotService;
+    /** Demo-mode single-element highlight (IMPROVEMENTS overlay). */
+    readonly overlay: ElementOverlay;
+    /** Network traffic -> HAR capture (M11). Off until `.start()` is called — never active by default. */
+    readonly har: HarRecorder;
+    /** CDP screencast frame capture, tab-follow (M11). Off until `.start()` is called. */
+    readonly screencast: ScreencastRecorder;
+    private lastSelectorMap;
+    private readonly ownedBrowser?;
+    private started;
+    constructor(transport: CdpTransport, config: ResolvedBrowserConfig, options?: BrowserSessionOptions);
+    /**
+     * {@link FrameTargetResolver} for OOPIF descent (W3/W3b). The registry
+     * already auto-attaches every target's session via `Target.setAutoAttach`
+     * (`TargetRegistry.handleAttached`), including cross-origin iframe targets —
+     * this only READS that bookkeeping, it never issues its own attach.
+     *
+     * Primary path: for OOPIF targets CDP guarantees `targetId == frameId` — an
+     * exact match against the surfaced node's own `frameId` is unambiguous by
+     * construction and needs no URL comparison at all.
+     *
+     * Fallback: match by url (ignoring query/hash and a trailing slash) when no
+     * exact frameId match is found (the same fallback design/04a documents for
+     * frames whose frameId can't be resolved directly). If MORE THAN ONE
+     * attached iframe target shares the same url key, the match is ambiguous —
+     * decline (`undefined`) rather than guess via first-attach order. An empty
+     * iframe is strictly better than grafting the wrong sibling frame's content.
+     */
+    private resolveFrameTarget;
+    /** Launch a local Chromium subprocess and open a session against it. */
+    static launch(overrides?: BrowserConfigOverrides): Promise<BrowserSession>;
+    /**
+     * Attach to an existing CDP endpoint (`ws://…` or an `http://…/json/version`
+     * base). This is the first-class connect path — the same one a remote/cloud
+     * provider drives.
+     */
+    static connect(cdpUrl: string, overrides?: BrowserConfigOverrides, options?: BrowserConnectOptions): Promise<BrowserSession>;
+    /** Discover targets, pick a focus, and begin auto-answering dialogs. Idempotent. */
+    start(): Promise<void>;
+    /** Tear down: stop dialogs, detach registry, close the socket and (if owned) the browser. */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to the underlying CDP socket dropping unexpectedly (not on
+     * {@link stop}). Surfaces `CdpConnection.onDisconnect` at the session level so
+     * a host/provider can react — the seam to build a reconnect policy on
+     * (`reconnectWithBackoff` is the building block). The library takes NO reconnect
+     * action itself: on the `launch()` path a drop means the Chromium subprocess
+     * died (nothing to reconnect to), and on the `connect()` path the reconnect
+     * policy belongs to the provider that owns the endpoint. Returns an unsubscribe
+     * fn; a no-op if the transport doesn't surface disconnects.
+     */
+    onDisconnect(cb: (err: CdpConnectionError) => void): () => void;
+    /** The open tabs (4-char ids). */
+    get tabs(): TabInfo[];
+    /** The selector map from the most recent {@link getBrowserStateSummary}. */
+    get selectorMap(): DomSelectorMap;
+    /** Resolve an element by its map key — the backendNodeId the LLM saw as `[N]`. */
+    getElementByIndex(index: number): EnhancedDOMTreeNode | undefined;
+    /** Navigate the focused tab (policy-checked before any CDP navigate — A3). */
+    navigate(url: string, options?: NavigateOptions): Promise<NavigateResult>;
+    /**
+     * Assemble a full state summary for the focused tab: url + title + tabs +
+     * serialized numbered DOM text + selector map (+ optional screenshot). The
+     * selector map is cached so subsequent index-based actions resolve.
+     */
+    getBrowserStateSummary(options?: BrowserStateOptions): Promise<BrowserStateSummary>;
+    /**
+     * Navigate the focused tab back one history entry (CDP navigation history).
+     * A no-op when there is nothing to go back to.
+     */
+    goBack(): Promise<void>;
+    /**
+     * Evaluate a JS expression in the focused page and return the JSON value
+     * (`returnByValue`, promises awaited). Throws on a page-side exception
+     * instead of resolving to `undefined` — the seam {@link groundTruth}
+     * (`testing.ts`) builds on to assert real DOM effects (PRP T1) rather than
+     * a tool's self-report.
+     */
+    evaluate<T = unknown>(expression: string): Promise<T>;
+    /** Open a new tab (browser-level Target.createTarget). Returns its 4-char id. */
+    openTab(url?: string): Promise<TabId>;
+    /** Focus another tab by its 4-char id, bringing it to the foreground. */
+    switchTab(tabId: TabId): Promise<void>;
+    /** Close a tab by its 4-char id (best-effort — a stale id is not an error). */
+    closeTab(tabId: TabId): Promise<void>;
+    /** Get the element by its backendNodeId key (branded overload of index access). */
+    nodeForKey(index: BackendNodeId): EnhancedDOMTreeNode | undefined;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAE3B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAA4B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,KAAK,kBAAkB,EAAmB,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAW,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,OAAO,EAGb,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,gFAAgF;IAChF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1D;AASD,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,cAAc;IAqBvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IApB5B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,sGAAsG;IACtG,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAExC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAkB;IAChD,OAAO,CAAC,OAAO,CAAS;gBAGL,SAAS,EAAE,YAAY,EACxC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,qBAA0B;IAmCrC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,kBAAkB;IAmB1B,wEAAwE;WAC3D,MAAM,CAAC,SAAS,GAAE,sBAA2B,GAAG,OAAO,CAAC,cAAc,CAAC;IAUpF;;;;OAIG;WACU,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,sBAA2B,EACtC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC;IAa1B,oFAAoF;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,6FAA6F;IACvF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI/D,kCAAkC;IAClC,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED,4EAA4E;IAC5E,IAAI,WAAW,IAAI,cAAc,CAEhC;IAED,kFAAkF;IAClF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIjE,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzE;;;;OAIG;IACG,sBAAsB,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiD7F;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB7B;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB3D,iFAAiF;IAC3E,OAAO,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOlD,yEAAyE;IACnE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,+EAA+E;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,mFAAmF;IACnF,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS;CAGlE"}

package/dist/targets/registry.d.ts

@@ -0,0 +1,99 @@
+import { TypedEmitter } from "../events";
+import { type TabId, type TargetId } from "../types";
+import type { CdpTransport } from "../types";
+/** A recent Page lifecycle event kept in the per-target ring buffer. */
+export interface LifecycleRecord {
+    name: string;
+    loaderId: string;
+    timestamp: number;
+}
+interface TargetRecord {
+    targetId: TargetId;
+    type: string;
+    url: string;
+    title: string;
+}
+/** Genuine target notifications (A1). */
+export interface TargetRegistryEvents {
+    tabCreated: {
+        targetId: TargetId;
+        tabId: TabId;
+        url: string;
+    };
+    tabClosed: {
+        targetId: TargetId;
+        tabId: TabId;
+    };
+    focusChanged: {
+        targetId: TargetId;
+        url: string;
+    };
+    targetCrashed: {
+        targetId: TargetId;
+    };
+}
+/** The last 4 chars of a target id — the only id the LLM ever sees (design/05). */
+export declare const toTabId: (targetId: TargetId) => TabId;
+export declare class TargetRegistry {
+    private readonly transport;
+    readonly events: TypedEmitter<TargetRegistryEvents>;
+    private readonly targets;
+    private readonly sessions;
+    private readonly targetSessions;
+    private readonly sessionToTarget;
+    private readonly lifecycleEvents;
+    private focusTargetId;
+    private recoveryInProgress;
+    private readonly unsubscribes;
+    constructor(transport: CdpTransport);
+    /** Register handlers and discover existing targets. */
+    start(): Promise<void>;
+    dispose(): void;
+    private handleAttached;
+    private handleDetached;
+    private handleInfoChanged;
+    private handleCrashed;
+    private handleLifecycle;
+    private enablePageMonitoring;
+    get focusedTargetId(): TargetId | undefined;
+    /** Focus a target. Only page-type targets may become the focus. */
+    setFocus(targetId: TargetId): boolean;
+    private recoverFocus;
+    getPageTargets(): TargetRecord[];
+    /** TabInfo-ready view of the page targets (4-char ids). */
+    getTabs(): Array<{
+        id: TabId;
+        url: string;
+        title: string;
+    }>;
+    getTargetIdFromTabId(tabId: TabId): TargetId | undefined;
+    getSessionIdForTarget(targetId: TargetId): string | undefined;
+    /**
+     * Attached targets of CDP type `"iframe"` (out-of-process/cross-origin
+     * iframes), with their url + session id. `Target.setAutoAttach` (called for
+     * every attached session in {@link handleAttached}) already cascades to these
+     * automatically — nothing here issues a new `attachToTarget`, so a caller
+     * matching a frame by url gets an existing session, never a fresh attach.
+     * Used by `BrowserSession`'s `FrameTargetResolver` (W3/W3b): for OOPIF
+     * targets CDP guarantees `targetId == frameId`, so the resolver's primary
+     * path matches `targetId` directly against the surfaced node's frameId.
+     * The `targetId` returned here is what makes that possible — url-matching
+     * (also exposed here) is only the fallback for when that invariant doesn't
+     * resolve a match; it is NOT the only resolution signal the registry offers.
+     */
+    getIframeTargets(): Array<{
+        targetId: TargetId;
+        url: string;
+        sessionId: string;
+    }>;
+    getCurrentUrl(targetId: TargetId): string | undefined;
+    getLifecycleEvents(targetId: TargetId): LifecycleRecord[];
+    /** For the Navigator's focus provider. */
+    getFocusedSession(): {
+        targetId: TargetId;
+        sessionId: string;
+    } | undefined;
+    private getLifecycleBuffer;
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/targets/registry.d.ts.map

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

package/dist/testing.d.ts

@@ -0,0 +1,53 @@
+import type { CdpConnectionError } from "./errors";
+import type { CdpCommand, CdpCommandParams, CdpCommandReturn, CdpEventListener, CdpEventName, CdpEventParams, CdpSendOptions, CdpTransport } from "./types";
+/** A scripted response: a fixed value, or a fn of the call's params/sessionId. */
+export type FakeResponder = unknown | ((params: unknown, sessionId?: string) => unknown);
+/**
+ * A {@link CdpTransport} backed by a scripted `method -> response` map, with a
+ * multi-listener event registry and an {@link emitEvent} to push canned events.
+ * Every `send` is recorded in {@link calls} so tests can assert what was (or was
+ * NOT) sent. Unknown methods resolve to `{}`.
+ */
+export declare class FakeCdpTransport implements CdpTransport {
+    private readonly responses;
+    /** Every `send` in order, for assertions. */
+    readonly calls: Array<{
+        method: string;
+        params?: unknown;
+        sessionId?: string;
+    }>;
+    private readonly registrations;
+    private readonly disconnectListeners;
+    constructor(responses?: Map<string, FakeResponder>);
+    send<T extends CdpCommand>(method: T, params?: CdpCommandParams<T>, options?: CdpSendOptions): Promise<CdpCommandReturn<T>>;
+    on<M extends CdpEventName>(method: M, listener: CdpEventListener<M>, sessionId?: string): () => void;
+    /** Push a canned CDP event to matching subscribers. */
+    emitEvent<M extends CdpEventName>(method: M, params: CdpEventParams<M>, sessionId?: string): void;
+    onDisconnect(cb: (err: CdpConnectionError) => void): () => void;
+    /** Simulate an unexpected socket drop for tests. */
+    emitDisconnect(err: CdpConnectionError): void;
+    /** Number of `send`s recorded for a method. */
+    sendCount(method: string): number;
+    close(): Promise<void>;
+}
+/** The minimal session surface {@link groundTruth} needs — real `BrowserSession` satisfies it. */
+export interface EvaluableSession {
+    evaluate<T = unknown>(expression: string): Promise<T>;
+}
+/**
+ * Ground-truth assertions for interaction tests (PRP T1): reads the real DOM
+ * effect via CDP `Runtime.evaluate`, not the tool's self-report. Backed by
+ * `session.evaluate()`; unit-tested here against {@link FakeCdpTransport},
+ * driven against real Chromium once the W9(c) browser-gated tier exists.
+ */
+export declare function groundTruth(session: EvaluableSession): {
+    /** Evaluate an arbitrary expression in the page and return the JSON value. */
+    evalInPage: <T = unknown>(expression: string) => Promise<T>;
+    /** `window.getClickCount()` — the golden-fixture click-counter contract (design/08-09 §9.3). */
+    clickCount: () => Promise<number>;
+    /** The live `.value` of the element matched by `selector`. */
+    inputValue: (selector: string) => Promise<string>;
+    /** The live `.checked` of the element matched by `selector`. */
+    checked: (selector: string) => Promise<boolean>;
+};
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAOzF;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IAMvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IALtC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IACrF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgD;gBAEvD,SAAS,GAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAa;IAExE,IAAI,CAAC,CAAC,SAAS,UAAU,EAC7B,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAU/B,EAAE,CAAC,CAAC,SAAS,YAAY,EACvB,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,IAAI;IAiBb,uDAAuD;IACvD,SAAS,CAAC,CAAC,SAAS,YAAY,EAC9B,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAUP,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAO/D,oDAAoD;IACpD,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAI7C,+CAA+C;IAC/C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB;IAEjD,8EAA8E;iBACjE,CAAC,wBAAwB,MAAM,KAAG,OAAO,CAAC,CAAC,CAAC;IACzD,gGAAgG;sBAChF,OAAO,CAAC,MAAM,CAAC;IAC/B,8DAA8D;2BACvC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;IAE/C,gEAAgE;wBAC5C,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;EAGhD"}

package/dist/testing.js

@@ -0,0 +1,8 @@
+import {
+  FakeCdpTransport,
+  groundTruth
+} from "./chunk-DXCP25KX.js";
+export {
+  FakeCdpTransport,
+  groundTruth
+};

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+import type { ProtocolMapping } from "devtools-protocol/types/protocol-mapping";
+import type { CdpConnectionError } from "./errors";
+/** A stable index into the interactive-element selector map. */
+export type ElementIndex = number & {
+    readonly __brand: "ElementIndex";
+};
+/** A CDP backend node id (`DOM.BackendNodeId`). */
+export type BackendNodeId = number & {
+    readonly __brand: "BackendNodeId";
+};
+/** A CDP target id (`Target.TargetID`). */
+export type TargetId = string & {
+    readonly __brand: "TargetId";
+};
+/** An AP3X-side tab identifier (the 4-char id the LLM sees). */
+export type TabId = string & {
+    readonly __brand: "TabId";
+};
+export declare const asElementIndex: (n: number) => ElementIndex;
+export declare const asBackendNodeId: (n: number) => BackendNodeId;
+export declare const asTargetId: (s: string) => TargetId;
+export declare const asTabId: (s: string) => TabId;
+/** A CDP command method name (e.g. `"Page.navigate"`). */
+export type CdpCommand = keyof ProtocolMapping.Commands;
+/** A CDP event method name (e.g. `"Page.lifecycleEvent"`). */
+export type CdpEventName = keyof ProtocolMapping.Events;
+/**
+ * The params object for a CDP command. No-param commands resolve to `never`,
+ * so combined with an optional `params?` they simply take no argument.
+ */
+export type CdpCommandParams<T extends CdpCommand> = ProtocolMapping.Commands[T]["paramsType"][number];
+/** The response object for a CDP command. */
+export type CdpCommandReturn<T extends CdpCommand> = ProtocolMapping.Commands[T]["returnType"];
+/** The params object carried by a CDP event. */
+export type CdpEventParams<M extends CdpEventName> = ProtocolMapping.Events[M][number];
+/** Per-request send options. */
+export interface CdpSendOptions {
+    /** Route to a specific target session (flatten mode). */
+    sessionId?: string;
+    /** Caller abort; merged with the per-request timeout. */
+    signal?: AbortSignal;
+    /** Override the default per-request timeout (ms). */
+    timeoutMs?: number;
+}
+/** A CDP event listener; receives typed params and the originating sessionId. */
+export type CdpEventListener<M extends CdpEventName> = (params: CdpEventParams<M>, sessionId: string | undefined) => void;
+/**
+ * Typed Chrome DevTools Protocol transport. `send` is request/response-typed by
+ * the protocol; `on` is a multi-listener registry keyed on (method, sessionId?)
+ * — a listener with no `sessionId` sees every session's events for that method.
+ */
+export interface CdpTransport {
+    send<T extends CdpCommand>(method: T, params?: CdpCommandParams<T>, options?: CdpSendOptions): Promise<CdpCommandReturn<T>>;
+    /** Subscribe to a CDP event. Returns an unsubscribe fn. */
+    on<M extends CdpEventName>(method: M, listener: CdpEventListener<M>, sessionId?: string): () => void;
+    close(): Promise<void>;
+    /**
+     * Subscribe to the socket dropping unexpectedly (NOT on {@link close}). Returns
+     * an unsubscribe fn. Optional — a transport with no live socket (a bridge, a
+     * fake) may omit it. This is the seam a host/provider builds a reconnect policy
+     * on (see `reconnectWithBackoff`); the library takes no reconnect action itself.
+     */
+    onDisconnect?(cb: (err: CdpConnectionError) => void): () => void;
+}
+/** One open tab in the controlled browser. `id` is the 4-char {@link TabId}. */
+export interface TabInfo {
+    id: TabId;
+    url: string;
+    title: string;
+    /** Parent page for popups / OOPIFs, if any. */
+    parentId?: TabId;
+}
+/**
+ * A snapshot of browser state handed to the agent — the @ap3x/browser ↔
+ * browser-agent seam (PRP A6). `serializedText` is the numbered/indented text
+ * projection the consumer reads; `selectorMap` is keyed by CDP backendNodeId
+ * (the `[N]` in the text == the key == what getElementByIndex resolves). No
+ * LLM-memory vocabulary lives here.
+ */
+export interface BrowserStateSummary {
+    url: string;
+    title: string;
+    tabs: TabInfo[];
+    screenshot?: string;
+    serializedText: string;
+    selectorMap: import("./dom/types").DomSelectorMap;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@ap3x/browser",
+  "version": "0.1.0",
+  "description": "Chrome DevTools Protocol browser control primitives",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AP3X-Dev/AP3X.git",
+    "directory": "packages/browser"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts src/testing.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json",
+    "prepublishOnly": "node ../../scripts/publish-gate.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.49",
+    "devtools-protocol": "^0.0.1464554",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.0",
+    "fast-check": "^4.8.0"
+  }
+}