@vforsh/argus-core 0.1.7 → 0.1.9

package/dist/protocol/http/domInteraction.d.ts

@@ -0,0 +1,109 @@
+import type { DomElementTarget, ElementRef } from './dom.js';
+/** Viewport coordinate or delta used by pointer/mouse interaction commands. */
+export type DomPoint = {
+    /** CSS pixel x-coordinate or horizontal delta. */
+    x: number;
+    /** CSS pixel y-coordinate or vertical delta. */
+    y: number;
+};
+/**
+ * Request payload for POST /dom/hover.
+ */
+export type DomHoverRequest = DomElementTarget & {
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+};
+/**
+ * Response payload for POST /dom/hover.
+ */
+export type DomHoverResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements hovered. */
+    hovered: number;
+};
+/** Mouse button for pointer-style interaction commands. Default: 'left'. */
+export type MouseButton = 'left' | 'middle' | 'right';
+/** Runtime list of mouse buttons accepted by pointer-style interaction commands. */
+export declare const MOUSE_BUTTONS: readonly ["left", "middle", "right"];
+/**
+ * Request payload for POST /dom/click.
+ */
+export type DomClickRequest = {
+    /** CSS selector to match element(s). */
+    selector?: string;
+    /** Stable element ref to click. Mutually exclusive with selector. */
+    ref?: ElementRef;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Viewport x-coordinate, or x-offset from element top-left when selector is set. */
+    x?: number;
+    /** Viewport y-coordinate, or y-offset from element top-left when selector is set. */
+    y?: number;
+    /** Mouse button to click. Default: 'left'. */
+    button?: MouseButton;
+    /** Filter elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Wait up to this many ms for selector to appear before executing. */
+    wait?: number;
+};
+/** Schema for POST /dom/click request payloads. */
+export declare const domClickRequestSchema: import("../schema.js").ProtocolSchema<DomClickRequest>;
+/**
+ * Response payload for POST /dom/click.
+ */
+export type DomClickResponse = {
+    ok: true;
+    /** Number of elements matched by selector. */
+    matches: number;
+    /** Number of elements clicked. */
+    clicked: number;
+};
+/**
+ * Request payload for POST /dom/drag.
+ *
+ * When selector/ref is present, x/y is an optional offset from the element's
+ * top-left corner. Without selector/ref, x/y is the required viewport start.
+ */
+export type DomDragRequest = {
+    /** CSS selector to match element(s). */
+    selector?: string;
+    /** Stable element ref to drag from. Mutually exclusive with selector. */
+    ref?: ElementRef;
+    /** Allow multiple matches. If false and >1 match, error. Default: false. */
+    all?: boolean;
+    /** Viewport x-coordinate, or x-offset from element top-left when selector/ref is set. */
+    x?: number;
+    /** Viewport y-coordinate, or y-offset from element top-left when selector/ref is set. */
+    y?: number;
+    /** Absolute viewport destination. Mutually exclusive with delta. */
+    to?: DomPoint;
+    /** Destination delta from the resolved start point. Mutually exclusive with to. */
+    delta?: DomPoint;
+    /** Mouse button to hold during the drag. Default: 'left'. */
+    button?: MouseButton;
+    /** Filter start elements by trimmed textContent. Plain string = exact match. /regex/flags = regex test. */
+    text?: string;
+    /** Wait up to this many ms for selector to appear before executing. */
+    wait?: number;
+    /** Total drag duration in ms. Default: 250. */
+    duration?: number;
+    /** Number of mouseMoved events between press and release. Default: 12. */
+    steps?: number;
+};
+/** Schema for POST /dom/drag request payloads. */
+export declare const domDragRequestSchema: import("../schema.js").ProtocolSchema<DomDragRequest>;
+/**
+ * Response payload for POST /dom/drag.
+ */
+export type DomDragResponse = {
+    ok: true;
+    /** Number of elements matched by selector/ref. Zero for coordinate-only drags. */
+    matches: number;
+    /** Number of drag gestures completed. */
+    dragged: number;
+};
+//# sourceMappingURL=domInteraction.d.ts.map

package/dist/protocol/http/domInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domInteraction.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/domInteraction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG;IACtB,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAA;IACT,gDAAgD;IAChD,CAAC,EAAE,MAAM,CAAA;CACT,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAChD,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAErD,oFAAoF;AACpF,eAAO,MAAM,aAAa,sCAAuC,CAAA;AAEjE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,qFAAqF;IACrF,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,qFAAqF;IACrF,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,wDAiDhC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yEAAyE;IACzE,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,yFAAyF;IACzF,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,yFAAyF;IACzF,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,oEAAoE;IACpE,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,mFAAmF;IACnF,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,2GAA2G;IAC3G,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,uDAsE/B,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,IAAI,CAAA;IACR,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAA;CACf,CAAA"}

package/dist/protocol/http/domInteraction.js

@@ -0,0 +1,146 @@
+import { defineProtocolSchema, invalidProtocolPayload, isProtocolObject, validProtocolPayload } from '../schema.js';
+/** Runtime list of mouse buttons accepted by pointer-style interaction commands. */
+export const MOUSE_BUTTONS = ['left', 'middle', 'right'];
+/** Schema for POST /dom/click request payloads. */
+export const domClickRequestSchema = defineProtocolSchema((value) => {
+    if (!isProtocolObject(value)) {
+        return invalidProtocolPayload('request body must be an object');
+    }
+    const selector = optionalString(value, 'selector');
+    const ref = optionalString(value, 'ref');
+    const hasSelector = selector != null && selector.length > 0;
+    const hasRef = ref != null && ref.length > 0;
+    const hasCoords = value.x != null || value.y != null;
+    if (!hasSelector && !hasRef && !hasCoords) {
+        return invalidProtocolPayload('selector, ref, or x,y coordinates are required');
+    }
+    if (hasSelector && hasRef) {
+        return invalidProtocolPayload('selector and ref are mutually exclusive');
+    }
+    if (hasCoords && (!isFiniteNumber(value.x) || !isFiniteNumber(value.y))) {
+        return invalidProtocolPayload('both x and y must be finite numbers');
+    }
+    if (value.all != null && typeof value.all !== 'boolean') {
+        return invalidProtocolPayload('all must be a boolean');
+    }
+    if (value.button != null && !isMouseButton(value.button)) {
+        return invalidProtocolPayload(`button must be one of: ${MOUSE_BUTTONS.join(', ')}`);
+    }
+    if (value.wait != null && (!isFiniteNumber(value.wait) || value.wait < 0)) {
+        return invalidProtocolPayload('wait must be a non-negative number (ms)');
+    }
+    if (value.text != null && typeof value.text !== 'string') {
+        return invalidProtocolPayload('text must be a string');
+    }
+    const request = {
+        all: value.all ?? false,
+        button: value.button ?? 'left',
+        wait: value.wait ?? 0,
+    };
+    if (hasSelector)
+        request.selector = selector;
+    if (hasRef)
+        request.ref = ref;
+    if (hasCoords) {
+        request.x = value.x;
+        request.y = value.y;
+    }
+    if (typeof value.text === 'string') {
+        request.text = value.text;
+    }
+    return validProtocolPayload(request);
+});
+/** Schema for POST /dom/drag request payloads. */
+export const domDragRequestSchema = defineProtocolSchema((value) => {
+    if (!isProtocolObject(value)) {
+        return invalidProtocolPayload('request body must be an object');
+    }
+    const selector = optionalString(value, 'selector');
+    const ref = optionalString(value, 'ref');
+    const hasSelector = selector != null && selector.length > 0;
+    const hasRef = ref != null && ref.length > 0;
+    const hasCoords = value.x != null || value.y != null;
+    const hasTo = value.to != null;
+    const hasDelta = value.delta != null;
+    const to = optionalPoint(value, 'to');
+    const delta = optionalPoint(value, 'delta');
+    if (!hasSelector && !hasRef && !hasCoords) {
+        return invalidProtocolPayload('selector, ref, or x,y start coordinates are required');
+    }
+    if (hasSelector && hasRef) {
+        return invalidProtocolPayload('selector and ref are mutually exclusive');
+    }
+    if (hasCoords && (!isFiniteNumber(value.x) || !isFiniteNumber(value.y))) {
+        return invalidProtocolPayload('both x and y must be finite numbers');
+    }
+    if (hasTo === hasDelta) {
+        return invalidProtocolPayload('exactly one of to or delta is required');
+    }
+    if (!to.ok) {
+        return invalidProtocolPayload(to.message);
+    }
+    if (!delta.ok) {
+        return invalidProtocolPayload(delta.message);
+    }
+    if (value.all != null && typeof value.all !== 'boolean') {
+        return invalidProtocolPayload('all must be a boolean');
+    }
+    if (value.button != null && !isMouseButton(value.button)) {
+        return invalidProtocolPayload(`button must be one of: ${MOUSE_BUTTONS.join(', ')}`);
+    }
+    if (value.wait != null && (!isFiniteNumber(value.wait) || value.wait < 0)) {
+        return invalidProtocolPayload('wait must be a non-negative number (ms)');
+    }
+    if (value.duration != null && (!isFiniteNumber(value.duration) || value.duration < 0)) {
+        return invalidProtocolPayload('duration must be a non-negative number (ms)');
+    }
+    if (value.steps != null && !isPositiveInteger(value.steps)) {
+        return invalidProtocolPayload('steps must be a positive integer');
+    }
+    if (value.text != null && typeof value.text !== 'string') {
+        return invalidProtocolPayload('text must be a string');
+    }
+    const request = {
+        all: value.all ?? false,
+        button: value.button ?? 'left',
+        wait: value.wait ?? 0,
+        duration: value.duration ?? 250,
+        steps: value.steps ?? 12,
+    };
+    if (hasSelector)
+        request.selector = selector;
+    if (hasRef)
+        request.ref = ref;
+    if (hasCoords) {
+        request.x = value.x;
+        request.y = value.y;
+    }
+    if (to.ok && to.point)
+        request.to = to.point;
+    if (delta.ok && delta.point)
+        request.delta = delta.point;
+    if (typeof value.text === 'string')
+        request.text = value.text;
+    return validProtocolPayload(request);
+});
+const optionalString = (value, key) => {
+    const field = value[key];
+    return typeof field === 'string' ? field : undefined;
+};
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+const isPositiveInteger = (value) => isFiniteNumber(value) && Number.isInteger(value) && value >= 1;
+const isMouseButton = (value) => typeof value === 'string' && MOUSE_BUTTONS.includes(value);
+const optionalPoint = (value, key) => {
+    const field = value[key];
+    if (field == null) {
+        return { ok: true };
+    }
+    if (!isProtocolObject(field)) {
+        return { ok: false, message: `${key} must be an object with finite x and y numbers` };
+    }
+    if (!isFiniteNumber(field.x) || !isFiniteNumber(field.y)) {
+        return { ok: false, message: `${key}.x and ${key}.y must be finite numbers` };
+    }
+    return { ok: true, point: { x: field.x, y: field.y } };
+};
+//# sourceMappingURL=domInteraction.js.map

package/dist/protocol/http/domInteraction.js.map

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

package/dist/protocol/http/extension.d.ts

@@ -4,9 +4,57 @@ export type ExtensionBrowserTab = {
     title: string;
     faviconUrl?: string;
     attached: boolean;
+    watcherId?: string;
 };
 export type ExtensionTabsResponse = {
     ok: true;
     tabs: ExtensionBrowserTab[];
 };
+/** Result of an extension-control attach/detach request after the extension has applied it. */
+export type ExtensionTabActionResponse = {
+    ok: true;
+    tab: ExtensionBrowserTab;
+    watcherId?: string;
+};
+/** Runtime state for the extension-control native messaging bridge. */
+export type ExtensionControlBridgeStatus = {
+    connected: boolean;
+    watcherId: string | null;
+    watcherHost: string | null;
+    watcherPort: number | null;
+    pid: number | null;
+    lastMessageAt: number | null;
+};
+/** Runtime state for one tab-scoped extension watcher bridge. */
+export type ExtensionTabBridgeStatus = {
+    tabId: number;
+    connected: boolean;
+    watcherId: string | null;
+    watcherHost: string | null;
+    watcherPort: number | null;
+    pid: number | null;
+    targetId: string | null;
+    targetTitle: string | null;
+    targetUrl: string | null;
+    targetReady: boolean | null;
+    lastMessageAt: number | null;
+};
+/** Recent extension-side event surfaced for diagnostics. */
+export type ExtensionRecentEvent = {
+    ts: number;
+    level: 'info' | 'error';
+    source: 'popup' | 'bridge' | 'debugger';
+    message: string;
+};
+/** Live diagnostics from the extension-control watcher and connected browser extension. */
+export type ExtensionDiagnosticsResponse = {
+    ok: true;
+    extension: {
+        id: string | null;
+        version: string | null;
+    };
+    control: ExtensionControlBridgeStatus;
+    tabWatchers: ExtensionTabBridgeStatus[];
+    recentEvents: ExtensionRecentEvent[];
+};
 //# sourceMappingURL=extension.d.ts.map

package/dist/protocol/http/extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/extension.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,mBAAmB,EAAE,CAAA;CAC3B,CAAA"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/extension.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,mBAAmB,EAAE,CAAA;CAC3B,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,0BAA0B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAA;IACR,GAAG,EAAE,mBAAmB,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAED,iEAAiE;AACjE,MAAM,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IACvC,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2FAA2F;AAC3F,MAAM,MAAM,4BAA4B,GAAG;IAC1C,EAAE,EAAE,IAAI,CAAA;IACR,SAAS,EAAE;QACV,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;QACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,CAAA;IACD,OAAO,EAAE,4BAA4B,CAAA;IACrC,WAAW,EAAE,wBAAwB,EAAE,CAAA;IACvC,YAAY,EAAE,oBAAoB,EAAE,CAAA;CACpC,CAAA"}

package/dist/protocol/http/netMock.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Network request mocking protocol (`/net/mock*` endpoints).
+ *
+ * Rules intercept live requests via the CDP `Fetch` domain. Each rule pairs a
+ * match (URL pattern + optional method/resource-type) with an action:
+ * block, fail with a network error, fulfill with a stubbed response, or
+ * continue with rewrites. Rules persist in the watcher until removed and are
+ * re-armed when the watcher reattaches.
+ */
+/**
+ * Match criteria for a mock rule.
+ *
+ * `url` is matched against the full request URL, case-insensitively.
+ * `*` matches any run of characters; a pattern without `*` is treated as a
+ * substring match (equivalent to `*pattern*`).
+ */
+export type NetMockMatch = {
+    /** URL wildcard pattern (substring match when it contains no `*`). */
+    url: string;
+    /** Optional HTTP method filter (case-insensitive, e.g. "POST"). */
+    method?: string;
+    /** Optional CDP resource type filter (case-insensitive, e.g. "Fetch", "XHR", "Document"). */
+    resourceType?: string;
+};
+/** One HTTP header entry used in fulfill/continue actions. */
+export type NetMockHeader = {
+    name: string;
+    value: string;
+};
+/** CDP network error reasons accepted by `fail` actions. */
+export declare const NET_MOCK_FAIL_REASONS: readonly ["Failed", "Aborted", "TimedOut", "AccessDenied", "ConnectionClosed", "ConnectionReset", "ConnectionRefused", "ConnectionAborted", "ConnectionFailed", "NameNotResolved", "InternetDisconnected", "AddressUnreachable", "BlockedByClient", "BlockedByResponse"];
+/** Network error reason for `fail` actions. */
+export type NetMockFailReason = (typeof NET_MOCK_FAIL_REASONS)[number];
+/**
+ * Action applied when a rule matches.
+ *
+ * - `block` aborts the request as `BlockedByClient`.
+ * - `fail` aborts with the given network error reason, so page `fetch()` calls reject.
+ * - `fulfill` answers with a synthetic response; the request never reaches the network.
+ * - `continue` forwards the request, optionally overriding headers or the URL host/origin.
+ */
+export type NetMockAction = {
+    kind: 'block';
+} | {
+    kind: 'fail';
+    reason: NetMockFailReason;
+} | {
+    kind: 'fulfill';
+    status: number;
+    headers?: NetMockHeader[];
+    bodyBase64?: string;
+} | {
+    kind: 'continue';
+    setHeaders?: NetMockHeader[];
+    rewriteHost?: string;
+};
+/** One installed mock rule, including hit accounting. */
+export type NetMockRule = {
+    /** Watcher-local rule id, unique for the watcher lifetime. */
+    id: number;
+    match: NetMockMatch;
+    action: NetMockAction;
+    /** Delay before the action executes, in milliseconds. */
+    delayMs?: number;
+    /** Maximum number of applications; the rule stops matching after `hits` reaches this. Undefined = unlimited. */
+    times?: number;
+    /** How many requests this rule has been applied to. */
+    hits: number;
+    /** Epoch ms when the rule was added. */
+    createdAt: number;
+};
+/** POST /net/mock/add request payload. */
+export type NetMockAddRequest = {
+    match: NetMockMatch;
+    action: NetMockAction;
+    /** Delay before the action executes, in milliseconds. Must be a finite number >= 0. */
+    delayMs?: number;
+    /** Maximum number of applications. Must be an integer >= 1. */
+    times?: number;
+};
+/** POST /net/mock/add response. */
+export type NetMockAddResponse = {
+    ok: true;
+    /** Whether the watcher is currently attached to a CDP target. */
+    attached: boolean;
+    /** Whether Fetch interception is active on the attached target. False when detached (rule is queued). */
+    enabled: boolean;
+    /** The installed rule. */
+    rule: NetMockRule;
+    /** Optional error details when interception could not be enabled. */
+    error?: {
+        message: string;
+        code?: string;
+    } | null;
+};
+/** POST /net/mock/remove request payload. */
+export type NetMockRemoveRequest = {
+    /** Rule id to remove. */
+    id: number;
+};
+/** POST /net/mock/remove response. */
+export type NetMockRemoveResponse = {
+    ok: true;
+    /** True when a rule with the given id existed and was removed. */
+    removed: boolean;
+    /** Whether Fetch interception remains active after the removal. */
+    enabled: boolean;
+};
+/** POST /net/mock/clear response. */
+export type NetMockClearResponse = {
+    ok: true;
+    /** Number of rules removed. */
+    removed: number;
+    /** Whether Fetch interception remains active (always false after clear unless disable failed). */
+    enabled: boolean;
+};
+/** GET /net/mock response. */
+export type NetMockStatusResponse = {
+    ok: true;
+    /** Whether the watcher is currently attached to a CDP target. */
+    attached: boolean;
+    /** Whether Fetch interception is active on the attached target. */
+    enabled: boolean;
+    /** Installed rules in match order (first match wins). */
+    rules: NetMockRule[];
+    /** Last interception error (enable/disable or action failure), if any. */
+    lastError?: {
+        message: string;
+        code?: string;
+    } | null;
+};
+//# sourceMappingURL=netMock.d.ts.map

package/dist/protocol/http/netMock.d.ts.map

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

package/dist/protocol/http/netMock.js

@@ -0,0 +1,27 @@
+/**
+ * Network request mocking protocol (`/net/mock*` endpoints).
+ *
+ * Rules intercept live requests via the CDP `Fetch` domain. Each rule pairs a
+ * match (URL pattern + optional method/resource-type) with an action:
+ * block, fail with a network error, fulfill with a stubbed response, or
+ * continue with rewrites. Rules persist in the watcher until removed and are
+ * re-armed when the watcher reattaches.
+ */
+/** CDP network error reasons accepted by `fail` actions. */
+export const NET_MOCK_FAIL_REASONS = [
+    'Failed',
+    'Aborted',
+    'TimedOut',
+    'AccessDenied',
+    'ConnectionClosed',
+    'ConnectionReset',
+    'ConnectionRefused',
+    'ConnectionAborted',
+    'ConnectionFailed',
+    'NameNotResolved',
+    'InternetDisconnected',
+    'AddressUnreachable',
+    'BlockedByClient',
+    'BlockedByResponse',
+];
+//# sourceMappingURL=netMock.js.map

package/dist/protocol/http/netMock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netMock.js","sourceRoot":"","sources":["../../../src/protocol/http/netMock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,QAAQ;IACR,SAAS;IACT,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,sBAAsB;IACtB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;CACV,CAAA"}

package/dist/protocol/http/record.d.ts

@@ -0,0 +1,54 @@
+import type { ScreenshotClipRegion } from './screenshot.js';
+/** Viewport-relative crop rectangle in CSS pixels. */
+export type RecordClipRegion = ScreenshotClipRegion;
+/** Supported recording containers/codecs. */
+export declare const RECORD_FORMATS: readonly ["mp4", "webm"];
+/** Recording container/codec preset. */
+export type RecordFormat = (typeof RECORD_FORMATS)[number];
+/** Shared options for video recording requests. */
+export type RecordOptions = {
+    outFile?: string;
+    selector?: string;
+    /** Viewport-relative crop rectangle in CSS pixels. Mutually exclusive with `selector`. */
+    clip?: RecordClipRegion;
+    /** Output frames per second. Defaults to 30. */
+    fps?: number;
+    /** Output format. Defaults to mp4 unless inferred from outFile extension. */
+    format?: RecordFormat;
+};
+/** Request payload for POST /record. */
+export type RecordRequest = RecordOptions & {
+    /** Capture duration in milliseconds. */
+    durationMs: number;
+};
+/** Request payload for POST /record/start. */
+export type RecordStartRequest = RecordOptions;
+/** Response payload for POST /record/start. */
+export type RecordStartResponse = {
+    ok: true;
+    recordId: string;
+    sessionName: string;
+    outFile: string;
+    format: RecordFormat;
+    fps: number;
+    clipped: boolean;
+};
+/** Request payload for POST /record/stop. */
+export type RecordStopRequest = {
+    recordId?: string;
+    outFile?: string;
+};
+/** Response payload for POST /record and POST /record/stop. */
+export type RecordStopResponse = {
+    ok: true;
+    recordId: string;
+    sessionName: string;
+    outFile: string;
+    format: RecordFormat;
+    frameCount: number;
+    durationMs: number;
+    fps: number;
+    clipped: boolean;
+};
+export type RecordResponse = RecordStopResponse;
+//# sourceMappingURL=record.d.ts.map

package/dist/protocol/http/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAA;AAEnD,6CAA6C;AAC7C,eAAO,MAAM,cAAc,0BAA2B,CAAA;AAEtD,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,MAAM,CAAC,EAAE,YAAY,CAAA;CACrB,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC3C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAA;AAE9C,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,YAAY,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAA"}

package/dist/protocol/http/record.js

@@ -0,0 +1,3 @@
+/** Supported recording containers/codecs. */
+export const RECORD_FORMATS = ['mp4', 'webm'];
+//# sourceMappingURL=record.js.map

package/dist/protocol/http/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/protocol/http/record.ts"],"names":[],"mappings":"AAKA,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAA"}

package/dist/protocol/http/status.d.ts

@@ -12,6 +12,10 @@ export type StatusResponse = {
     target: {
         title: string | null;
         url: string | null;
+        /** Target type, such as `page` or `iframe`, when the source can report it. */
+        type?: string | null;
+        /** Parent target id for nested targets, e.g. `tab:<tabId>` for extension iframes. */
+        parentId?: string | null;
     } | null;
     dialog?: DialogStatus | null;
     buffer: {

package/dist/protocol/http/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;IACR,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAClB,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB,CAAA;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;IACR,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;QAClB,8EAA8E;QAC9E,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,qFAAqF;QACrF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACxB,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB,CAAA;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA"}

package/dist/protocol/http.d.ts

@@ -2,13 +2,16 @@ export * from './schema.js';
 export type * from './http/status.js';
 export type * from './http/logs.js';
 export type * from './http/net.js';
+export * from './http/netMock.js';
 export type * from './http/eval.js';
 export type * from './http/trace.js';
+export * from './http/record.js';
 export type * from './http/screenshot.js';
 export type * from './http/snapshot.js';
 export type * from './http/locate.js';
 export type * from './http/code.js';
 export * from './http/dom.js';
+export * from './http/domInteraction.js';
 export type * from './http/storage.js';
 export type * from './http/auth.js';
 export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './http/auth.js';

package/dist/protocol/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gBAAgB,CAAA;AACnC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA;AACnE,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,iBAAiB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gBAAgB,CAAA;AACnC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA;AACnE,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA"}

package/dist/protocol/http.js

@@ -1,5 +1,8 @@
 // Barrel re-exports — keeps existing import paths working.
 export * from './schema.js';
+export * from './http/netMock.js';
+export * from './http/record.js';
 export * from './http/dom.js';
+export * from './http/domInteraction.js';
 export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './http/auth.js';
 //# sourceMappingURL=http.js.map

package/dist/protocol/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,aAAa,CAAA;AAU3B,cAAc,eAAe,CAAA;AAG7B,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,aAAa,CAAA;AAI3B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,kBAAkB,CAAA;AAKhC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AAGxC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA"}