@ap3x/browser 0.1.0

package/dist/dom/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/dom/node.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,mBAAmB,EAAY,MAAM,SAAS,CAAC;AAE3E,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAEzD;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAEzE;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAIvF;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAwBvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAQvE;AAED,UAAU,UAAU;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAID,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,UAAU,GAAG,SAAS,CAqC5E;AAYD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAuBnE;AAcD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAkBvD;AAED,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAE7E"}

package/dist/dom/overlay.d.ts

@@ -0,0 +1,11 @@
+import type { CdpTransport } from "../types";
+import type { EnhancedDOMTreeNode } from "./types";
+export declare class ElementOverlay {
+    private readonly transport;
+    constructor(transport: CdpTransport);
+    /** Draw (or move) the overlay onto `node`. No-op if its bounds are unknown. */
+    show(node: EnhancedDOMTreeNode, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<void>;
+    /** Remove the overlay if present. Always safe to call, even if never shown. */
+    clear(sessionId: string | undefined, signal: AbortSignal | undefined): Promise<void>;
+}
+//# sourceMappingURL=overlay.d.ts.map

package/dist/dom/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/dom/overlay.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAW,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAI5D,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,YAAY;IAEpD,+EAA+E;IACzE,IAAI,CACR,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC;IAchB,+EAA+E;IACzE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAc3F"}

package/dist/dom/paint-order.d.ts

@@ -0,0 +1,25 @@
+import type { SimplifiedNode } from "./types";
+/** Closed axis-aligned rectangle: (x1,y1) bottom-left, (x2,y2) top-right. */
+interface Rect {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/**
+ * A disjoint set of rectangles. `MAX_RECTS` caps fragmentation on pages with
+ * many translucent overlapping layers; once hit, `contains` conservatively
+ * returns false (less filtering, never wrong removal).
+ */
+export declare class RectUnion {
+    private static readonly MAX_RECTS;
+    private readonly rects;
+    /** True iff `r` is fully covered by the union. */
+    contains(r: Rect): boolean;
+    /** Insert `r` unless already covered, keeping the set disjoint. */
+    add(r: Rect): void;
+}
+/** Mark occluded nodes across the tree. Mutates `ignoredByPaintOrder`. */
+export declare function calculatePaintOrder(root: SimplifiedNode): void;
+export {};
+//# sourceMappingURL=paint-order.d.ts.map

package/dist/dom/paint-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-order.d.ts","sourceRoot":"","sources":["../../src/dom/paint-order.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,SAAS,CAAC;AAEvD,6EAA6E;AAC7E,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAoBD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,kDAAkD;IAClD,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO;IAgB1B,mEAAmE;IACnE,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI;CAcnB;AAmBD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA2C9D"}

package/dist/dom/serialize-text.d.ts

@@ -0,0 +1,16 @@
+import { type EnhancedDOMTreeNode, type SimplifiedNode } from "./types";
+/** Cap a display value, appending "..." when truncated. */
+export declare function capTextLength(text: string, maxLength: number): string;
+/**
+ * Build the attribute string for one element. Applies date/time hints, password
+ * safety, AX-property merge, current-value overwrite, duplicate/redundancy
+ * pruning, and per-value truncation (cap 100). Faithful to design/04a §4.28.
+ */
+export declare function buildAttributesString(node: EnhancedDOMTreeNode, includeAttributes: readonly string[], text: string): string;
+/**
+ * Render the optimized SimplifiedNode tree to the tab-indented LLM string. The
+ * interactive `[backendNodeId]` marker, `*` new-prefix, shadow/scroll/iframe
+ * prefixes, and hidden-content hints all follow design/04a §4.28.
+ */
+export declare function serializeTree(node: SimplifiedNode | undefined, includeAttributes: readonly string[], depth?: number): string;
+//# sourceMappingURL=serialize-text.d.ts.map

package/dist/dom/serialize-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-text.d.ts","sourceRoot":"","sources":["../../src/dom/serialize-text.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,mBAAmB,EAExB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAEjB,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAsCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EACzB,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,IAAI,EAAE,MAAM,GACX,MAAM,CAgJR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,KAAK,SAAI,GACR,MAAM,CA2HR"}

package/dist/dom/serializer.d.ts

@@ -0,0 +1,33 @@
+import { type DomSelectorMap, type EnhancedDOMTreeNode, type SerializedDOMState } from "./types";
+export interface SerializerOptions {
+    previousSelectorMap?: DomSelectorMap;
+    enableBboxFiltering?: boolean;
+    containmentThreshold?: number;
+    paintOrderFiltering?: boolean;
+    /** Session id for the session-scoped exclude attribute variant. */
+    sessionId?: string;
+}
+export declare class DomSerializer {
+    private readonly root;
+    private readonly selectorMap;
+    private readonly clickableCache;
+    private readonly previousBackendIds;
+    private readonly enableBboxFiltering;
+    private readonly containmentThreshold;
+    private readonly paintOrderFiltering;
+    private readonly sessionId?;
+    constructor(root: EnhancedDOMTreeNode, opts?: SerializerOptions);
+    /** Run all five stages and return the serialized state (root + selector map). */
+    serialize(): SerializedDOMState;
+    private isInteractiveCached;
+    private createSimplifiedTree;
+    private optimizeTree;
+    private filterTreeRecursive;
+    private shouldExcludeChild;
+    private isContained;
+    private isPropagatingElement;
+    private assignInteractiveIndices;
+    private hasInteractiveDescendants;
+    private isInsideShadowDom;
+}
+//# sourceMappingURL=serializer.d.ts.map

package/dist/dom/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/dom/serializer.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAGxB,KAAK,kBAAkB,EAExB,MAAM,SAAS,CAAC;AAiBjB,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,CAAC,EAAE,cAAc,CAAC;IACrC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwBD,qBAAa,aAAa;IAYtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAGzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAGjB,IAAI,EAAE,mBAAmB,EAC1C,IAAI,GAAE,iBAAsB;IAa9B,iFAAiF;IACjF,SAAS,IAAI,kBAAkB;IAa/B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,oBAAoB;IAgF5B,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,wBAAwB;IAmDhC,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/dom/snapshot.d.ts

@@ -0,0 +1,37 @@
+import type { Protocol } from "devtools-protocol";
+import type { CdpTransport } from "../types";
+import type { TargetId } from "../types";
+import type { EnhancedSnapshotNode, TargetAllTrees } from "./types";
+/** Options for a live capture. */
+export interface CaptureOptions {
+    sessionId?: string;
+    jsClickListenerBackendIds?: Set<number>;
+    /** Caller abort, threaded into every CDP send (composes with per-request timeout). */
+    signal?: AbortSignal;
+}
+/**
+ * Run the CDP capture for one target and bundle the four data sources. Used by
+ * the live path; the integration tier and unit tests build {@link TargetAllTrees}
+ * directly and hand it to the pure serializer.
+ */
+export declare function captureAllTrees(transport: CdpTransport, targetId: TargetId, opts?: CaptureOptions): Promise<TargetAllTrees>;
+/**
+ * device_pixel_ratio = visualViewport.clientWidth / cssVisualViewport.clientWidth.
+ * CSS px is what JS/layout sees; using device px caused HiDPI coordinate
+ * mismatches. Falls back to 1.0.
+ */
+export declare function getViewportRatio(transport: CdpTransport, sessionId?: string, signal?: AbortSignal): Promise<number>;
+export interface SnapshotLookupOptions {
+    /** Max frame documents to process; the rest are truncated. Default 100. */
+    maxIframes?: number;
+    /** Warning sink; defaults to `console.warn` (matches NavigationPolicy's seam). */
+    warn?: (message: string) => void;
+}
+/**
+ * Decode the flat CDP snapshot into `backendNodeId → EnhancedSnapshotNode`. One
+ * entry per node; layout data attached where the node has a layout box. FIRST
+ * layout occurrence wins for duplicate node indices. Frame documents beyond
+ * `maxIframes` are truncated with a warning (design/04a §4.24 explosion guard).
+ */
+export declare function buildSnapshotLookup(snapshot: Protocol.DOMSnapshot.CaptureSnapshotResponse, devicePixelRatio?: number, opts?: SnapshotLookupOptions): Map<number, EnhancedSnapshotNode>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/dom/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/dom/snapshot.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAW,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE7E,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,sFAAsF;IACtF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,YAAY,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAkCD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,uBAAuB,EACtD,gBAAgB,SAAM,EACtB,IAAI,GAAE,qBAA0B,GAC/B,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAyDnC"}

package/dist/dom/types.d.ts

@@ -0,0 +1,178 @@
+import type { BackendNodeId, TargetId } from "../types";
+/** DOM node types, per the DOM spec. Shadow roots present as DocumentFragment. */
+export declare enum NodeType {
+    Element = 1,
+    Attribute = 2,
+    Text = 3,
+    CDataSection = 4,
+    ProcessingInstruction = 7,
+    Comment = 8,
+    Document = 9,
+    DocumentType = 10,
+    DocumentFragment = 11
+}
+/** CDP shadow-root kind. */
+export type ShadowRootType = "open" | "closed" | "user-agent";
+/** A plain rectangle, in CSS pixels unless noted. */
+export interface DOMRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** One accessibility property (CDP AXPropertyName → value). */
+export interface EnhancedAXProperty {
+    name: string;
+    value: string | boolean | null;
+}
+/** Condensed accessibility node. `name` is the accessible name. */
+export interface EnhancedAXNode {
+    axNodeId: string;
+    ignored: boolean;
+    role?: string;
+    name?: string;
+    description?: string;
+    properties?: EnhancedAXProperty[];
+    childIds?: string[];
+}
+/** Layout/snapshot data for one node, decoded from DOMSnapshot. */
+export interface EnhancedSnapshotNode {
+    isClickable?: boolean;
+    cursorStyle?: string;
+    /** Document coordinates (ignores scroll), already device→CSS px. */
+    bounds?: DOMRect;
+    /** Viewport coordinates (scroll-aware). NOT divided by device pixel ratio. */
+    clientRects?: DOMRect;
+    /** Scrollable area of the element. NOT divided by device pixel ratio. */
+    scrollRects?: DOMRect;
+    computedStyles?: Record<string, string>;
+    paintOrder?: number;
+    stackingContexts?: number;
+}
+/** A synthetic sub-component of a compound control (date picker, select, …). */
+export interface CompoundChild {
+    role: string;
+    name: string;
+    valuemin: number | null;
+    valuemax: number | null;
+    valuenow: number | string | null;
+    optionsCount?: number;
+    firstOptions?: string[];
+    formatHint?: string;
+}
+/**
+ * The central merged node: DOM identity + AX enrichment + snapshot layout,
+ * wired into a tree with a `parentNode` back-pointer (excluded from any JSON).
+ */
+export interface EnhancedDOMTreeNode {
+    nodeId: number;
+    backendNodeId: BackendNodeId;
+    nodeType: NodeType;
+    /** Tag name for elements (as CDP returns it, usually upper-case). */
+    nodeName: string;
+    /** Text content for text nodes. */
+    nodeValue: string;
+    attributes: Record<string, string>;
+    isScrollable?: boolean;
+    /** Computed visibility per the top-most frame. Filled during tree build. */
+    isVisible?: boolean;
+    /** Position in top-level page coordinates. */
+    absolutePosition?: DOMRect;
+    targetId: TargetId;
+    frameId?: string;
+    sessionId?: string;
+    contentDocument?: EnhancedDOMTreeNode;
+    shadowRootType?: ShadowRootType;
+    shadowRoots?: EnhancedDOMTreeNode[];
+    parentNode?: EnhancedDOMTreeNode;
+    childrenNodes?: EnhancedDOMTreeNode[];
+    axNode?: EnhancedAXNode;
+    snapshotNode?: EnhancedSnapshotNode;
+    /** Virtual components of compound controls (mutated by the serializer). */
+    compoundChildren: CompoundChild[];
+    hasJsClickListener: boolean;
+    /** Interactive elements in an iframe below the viewport threshold. */
+    hiddenElementsInfo: Array<{
+        tag: string;
+        text: string;
+        pages: number;
+    }>;
+    hasHiddenContent: boolean;
+}
+/** The serializer's lightweight working wrapper around an EnhancedDOMTreeNode. */
+export interface SimplifiedNode {
+    originalNode: EnhancedDOMTreeNode;
+    children: SimplifiedNode[];
+    /** Dormant hook; never set false today (design/10 gap §4.34 OQ#3). */
+    shouldDisplay: boolean;
+    /** True iff the element made it into the selector map. */
+    isInteractive: boolean;
+    isNew: boolean;
+    ignoredByPaintOrder: boolean;
+    excludedByParent: boolean;
+    isShadowHost: boolean;
+    isCompoundComponent: boolean;
+}
+/** Bounds a link/button propagates down to suppress nested interactivity. */
+export interface PropagatingBounds {
+    tag: string;
+    bounds: DOMRect;
+    nodeId: number;
+    depth: number;
+}
+/**
+ * The interactive-element map. Keyed by CDP **backendNodeId** — the same integer
+ * the LLM sees as `[N]`, that `getElementByIndex(N)` resolves, and that pagination
+ * / highlight labels use (design/10 gap #1). There is NO sequential renumbering.
+ */
+export type DomSelectorMap = Map<BackendNodeId, EnhancedDOMTreeNode>;
+/** The serialized page state: the working tree root + the selector map. */
+export interface SerializedDOMState {
+    root: SimplifiedNode | undefined;
+    selectorMap: DomSelectorMap;
+}
+/** Element-matching strictness ladder for history replay (design/05). */
+export declare enum MatchLevel {
+    Exact = 1,
+    Stable = 2,
+    Xpath = 3,
+    AxName = 4,
+    Attribute = 5,
+    /** Last-resort: tag-only parent-branch path (W13c). Coarsest level — declines
+     * rather than guesses when more than one fresh candidate shares the path. */
+    Structural = 6
+}
+/** A persisted record of a clicked/typed element, for history replay. */
+export interface DOMInteractedElement {
+    nodeId: number;
+    backendNodeId: BackendNodeId;
+    frameId?: string;
+    nodeType: NodeType;
+    nodeValue: string;
+    nodeName: string;
+    attributes: Record<string, string>;
+    bounds?: DOMRect;
+    xpath: string;
+    /** Exact hash (MatchLevel.Exact). */
+    elementHash: string;
+    /** Dynamic-class-filtered hash (MatchLevel.Stable). */
+    stableHash: string;
+    axName?: string;
+    /** Structural tag-chain hash (MatchLevel.Structural). Optional: absent on
+     * history files recorded before W13c — those simply can't fall back to it. */
+    parentBranchHash?: string;
+}
+/**
+ * The four raw captures for one target/frame, merged by the tree builder. This
+ * is the seam the browser-gated integration tier feeds real Chromium captures
+ * into (via `serializeFromSnapshot`).
+ */
+export interface TargetAllTrees {
+    snapshot: import("devtools-protocol").Protocol.DOMSnapshot.CaptureSnapshotResponse;
+    domTree: import("devtools-protocol").Protocol.DOM.GetDocumentResponse;
+    axTree: import("devtools-protocol").Protocol.Accessibility.GetFullAXTreeResponse;
+    devicePixelRatio: number;
+    /** backendNodeIds carrying JS click/mouse listeners (CDP getEventListeners). */
+    jsClickListenerBackendIds?: Set<number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/dom/types.d.ts.map

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

package/dist/downloads/sanitize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reduce a page-controlled download name to a safe basename. Never returns a name
+ * with a path separator; a name that is pure traversal (or empty) becomes
+ * `"download"`. Unicode and leading-dot names are preserved.
+ */
+export declare function sanitizeDownloadFilename(name: string | undefined | null): string;
+/**
+ * True iff `candidate` resolves to `directory` itself or something beneath it,
+ * comparing REAL (symlink-resolved) paths. Either path failing to resolve (e.g.
+ * it does not exist) yields `false` — fail closed.
+ */
+export declare function isPathContained(candidate: string, directory: string): Promise<boolean>;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/downloads/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/downloads/sanitize.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAQhF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5F"}

package/dist/driver.d.ts

@@ -0,0 +1,88 @@
+import type { ClickResult } from "./input/dispatcher";
+import type { NavigateResult } from "./navigation/navigator";
+import type { BrowserSession } from "./session";
+import type { BrowserStateSummary, ElementIndex, TabId, TabInfo } from "./types";
+/** A click target: an element index (the `[N]`) or a raw viewport point. */
+export type ClickTarget = ElementIndex | number | {
+    x: number;
+    y: number;
+};
+/** A scroll request: a direction (one page) or a signed pixel amount. */
+export type ScrollTarget = "up" | "down" | number;
+export interface GetStateOptions {
+    /** Include a base64 screenshot in the returned state. */
+    screenshot?: boolean;
+    /** Caller abort, threaded down to the CDP layer (§6.8). */
+    signal?: AbortSignal;
+}
+export interface TypeOptions {
+    /** Clear the field before typing (default true — matches the MCP `type` tool). */
+    clear?: boolean;
+    /** Value being typed is a secret — suppress read-back so it never round-trips out. */
+    sensitive?: boolean;
+    /** Caller abort, threaded down to the CDP layer (§6.8). */
+    signal?: AbortSignal;
+}
+export interface ScreenshotOptions {
+    /** Capture the full scrollable page rather than just the viewport. */
+    fullPage?: boolean;
+    /** Caller abort, threaded down to the CDP layer (§6.8). */
+    signal?: AbortSignal;
+}
+/** Options carrying only a caller abort (navigate / click / scroll / extract). */
+export interface SignalOptions {
+    signal?: AbortSignal;
+}
+/** ponytail: one page ≈ 720px until we thread the live viewport height through. */
+export declare const PAGE_SCROLL_PX = 720;
+export declare class BrowserDriver {
+    private readonly session;
+    constructor(session: BrowserSession);
+    /**
+     * Read the current page state: url, title, tabs, the serialized numbered
+     * element text the LLM reads, and the selector map keyed by backendNodeId.
+     * The returned indices are exactly what {@link click} / {@link type} accept.
+     */
+    getState(options?: GetStateOptions): Promise<BrowserStateSummary>;
+    /**
+     * Click an element by its index (the `[N]` from the last {@link getState}) or a
+     * raw viewport point. A missing index throws {@link ElementNotFoundError} —
+     * re-read the page to re-index before retrying.
+     */
+    click(target: ClickTarget, options?: SignalOptions): Promise<ClickResult>;
+    /**
+     * Type text into an element by its index. `clear` (default true) wipes the
+     * field first; pass `clear: false` to append. A missing index throws
+     * {@link ElementNotFoundError}.
+     */
+    type(index: ElementIndex | number, text: string, options?: TypeOptions): Promise<void>;
+    /** Capture a base64 screenshot of the focused tab. */
+    screenshot(options?: ScreenshotOptions): Promise<string>;
+    /** Navigate the focused tab (policy-checked before any CDP navigate — A3). */
+    navigate(url: string, options?: SignalOptions): Promise<NavigateResult>;
+    /** Scroll the page one page in a direction, or by a signed pixel amount. */
+    scroll(target: ScrollTarget, options?: SignalOptions): Promise<void>;
+    /** The open tabs (4-char ids). */
+    tabs(): TabInfo[];
+    /** Focus another tab by its 4-char id. */
+    switchTab(id: TabId | string): Promise<void>;
+    /** Close a tab by its 4-char id (a stale id is a no-op, not an error). */
+    closeTab(id: TabId | string): Promise<void>;
+    /**
+     * Return the page's readable text (the serialized numbered element map). LLM-
+     * backed structured extraction lives in the agent/tools layer (M4/M5); here
+     * `query` is accepted for signature stability but not yet applied.
+     */
+    extract(_query?: string, options?: SignalOptions): Promise<string>;
+    /**
+     * Demo-mode: draw a short-lived highlight around the element at `index` (the
+     * one about to be acted on). Fire-and-forget — never throws; a stale index
+     * or an inject failure just means no highlight is shown, not a driver error.
+     */
+    highlightElement(index: number, options?: SignalOptions): Promise<void>;
+    /** Remove the demo-mode highlight, if one is showing. Always safe to call. */
+    clearHighlight(options?: SignalOptions): Promise<void>;
+    /** Resolve an index to its node, or throw the re-index error. */
+    private resolve;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

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

package/dist/errors.d.ts

@@ -0,0 +1,71 @@
+/** Base for every `@ap3x/browser` error. Stable `code` + structured `data`. */
+export declare abstract class BrowserError<TCode extends string = string> extends Error {
+    readonly code: TCode;
+    readonly data?: Readonly<Record<string, unknown>>;
+    readonly cause?: unknown;
+    constructor(code: TCode, message: string, options?: {
+        data?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/** Why a CDP connection failed. */
+export type CdpConnectionErrorCode = "closed" | "timeout" | "aborted" | "protocol" | "connect_failed" | "reconnect_failed";
+/**
+ * A CDP transport failure. Notably: closing the socket rejects every pending
+ * request with `code: "closed"` — that rejection is the reconnect trigger.
+ */
+export declare class CdpConnectionError extends BrowserError<CdpConnectionErrorCode> {
+}
+/** Why a URL was refused by {@link NavigationPolicy}. */
+export type UrlNotAllowedReason = "not_in_allowed_domains" | "in_prohibited_domains" | "ip_blocked" | "invalid_url";
+/** Navigation to a URL was blocked by policy (A3 — thrown before CDP navigate). */
+export declare class UrlNotAllowedError extends BrowserError<"url_not_allowed"> {
+    readonly url: string;
+    readonly reason: UrlNotAllowedReason;
+    constructor(url: string, reason: UrlNotAllowedReason, message?: string);
+}
+/** Classifies a {@link NavigationError}. */
+export type NavigationErrorCode = "no_focus" | "timeout" | "failed";
+/** A navigation could not be issued or the page failed to load. */
+export declare class NavigationError extends BrowserError<NavigationErrorCode> {
+    readonly url?: string;
+    constructor(code: NavigationErrorCode, message: string, options?: {
+        url?: string;
+        data?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * An indexed element the caller asked to interact with is not in the current
+ * page map. The selector map is rebuilt on every state read, so a missing index
+ * almost always means the page changed since it was read. The message names the
+ * fix on purpose — a consumer (or an LLM reading it back) must re-read the page
+ * to re-index before retrying. (design/07 §stale-element contract.)
+ */
+export declare class ElementNotFoundError extends BrowserError<"element_not_found"> {
+    readonly index: number;
+    constructor(index: number, message?: string);
+}
+/**
+ * A low-level interaction (click/type/scroll/select/upload) could not be
+ * carried out, or the target element rejects the requested action (e.g. clicking
+ * a `<select>` — see {@link SELECT_ELEMENT_CLICK_MESSAGE}). `reason` classifies it.
+ */
+export type InteractionReason = "select_element" | "file_input" | "no_geometry" | "not_a_file_input" | "text_not_found" | "dispatch_failed";
+export declare class InteractionError extends BrowserError<"interaction_failed"> {
+    readonly reason: InteractionReason;
+    constructor(reason: InteractionReason, message: string, options?: {
+        data?: Record<string, unknown>;
+        cause?: unknown;
+    });
+}
+/**
+ * [EXACT-TEXT] Clicking a native `<select>` is redirected to the dropdown tool.
+ * The leading sentence `Cannot click on <select> elements.` is a string-match
+ * contract (design/07 §7.9): callers match on it to auto-attach the dropdown
+ * options, so the sentence must not be reworded.
+ */
+export declare const SELECT_ELEMENT_CLICK_MESSAGE = "Cannot click on <select> elements. Use the dropdown-options / select-dropdown action instead.";
+/** File inputs must not be clicked — they need the file-upload path. */
+export declare const FILE_INPUT_CLICK_MESSAGE = "Cannot click on a file input. Use the upload-file action to set its file instead.";
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,8BAAsB,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAC7E,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGhC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQhE;AAED,mCAAmC;AACnC,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;CAAG;AAE/E,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAC3B,wBAAwB,GACxB,uBAAuB,GACvB,YAAY,GACZ,aAAa,CAAC;AAElB,mFAAmF;AACnF,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;gBAEzB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM;CAOvE;AAED,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,mEAAmE;AACnE,qBAAa,eAAgB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAGpB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ9E;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS5C;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAGjC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQhE;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,kGACwD,CAAC;AAElG,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,sFACgD,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,8 @@
+/** Minimal typed pub/sub. Listener errors are isolated so one bad handler
+ * cannot break delivery to the others. `T` maps event name → payload type. */
+export declare class TypedEmitter<T> {
+    private readonly listeners;
+    on<K extends keyof T>(event: K, listener: (payload: T[K]) => void): () => void;
+    emit<K extends keyof T>(event: K, payload: T[K]): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA;8EAC8E;AAC9E,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0D;IAEpF,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAY9E,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAWvD"}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @ap3x/browser — CDP browser control primitives.
+ *
+ * Foundation for driving a Chromium browser over the Chrome DevTools Protocol:
+ * the typed CDP transport, target registry, navigation policy, navigator, local
+ * browser launch/connect, DOM extraction + serialization, input dispatch,
+ * screenshots, dialogs, downloads, and recording. The agent that drives these
+ * lives in `@ap3x/browser-agent`.
+ *
+ * **Entry point:** hosts should obtain a session via `openBrowserSession(config)`
+ * (see `providers/factory.ts`) rather than calling `BrowserSession.launch`/
+ * `connect` directly — it honours `config.provider` ('local' spawn-or-connect via
+ * `AP3X_BROWSER_CDP_URL`, or 'cloak' for a stealth CloakBrowser/cloakserve
+ * endpoint via `AP3X_BROWSER_CLOAK_*`), so the same call works across providers.
+ * `BrowserSession.launch`/`connect` remain the low-level primitives it's built on.
+ */
+export declare const PACKAGE = "@ap3x/browser";
+export declare const VERSION = "0.1.0";
+export * from "./types";
+export * from "./errors";
+export * from "./events";
+export * from "./cdp/connection";
+export * from "./cdp/endpoint";
+export * from "./cdp/reconnect";
+export * from "./targets/registry";
+export * from "./navigation/policy";
+export * from "./navigation/navigator";
+export * from "./launch/discovery";
+export * from "./launch/local-browser";
+export * from "./dom/types";
+export * from "./dom/constants";
+export * from "./dom/node";
+export * from "./dom/hashing";
+export * from "./dom/clickability";
+export * from "./dom/paint-order";
+export * from "./dom/snapshot";
+export * from "./dom/enhanced-tree";
+export * from "./dom/compound";
+export * from "./dom/serialize-text";
+export * from "./dom/serializer";
+export * from "./dom/dom-service";
+export * from "./dom/overlay";
+export * from "./input/keys";
+export * from "./input/dispatcher";
+export * from "./dialogs/handler";
+export * from "./downloads/sanitize";
+export * from "./screenshot/service";
+export * from "./recording/har";
+export * from "./recording/screencast";
+export * from "./config";
+export * from "./session";
+export * from "./driver";
+export * from "./providers";
+export * from "./testing";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,kBAAkB,CAAC;AACvC,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAE9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}