@descryy/mcp 0.9.1 → 0.11.0

package/dist/browser/fake-driver.d.ts

@@ -2,18 +2,61 @@
  *  issuance/invalidation, drain-not-peek, crash invalidation, flushing close), and
  *  `browser-driver-contract.test.ts` runs the same assertions against it as the real driver.
  *  Non-goals: no simulated DOM (pages are declared via `setPage`), no classification. */
-import { type BrowserDriver, type BrowserStorageState, type ObservedRequest } from "./driver.ts";
-/** A page as a test declares it. `ref` is issued by the fake, not written here. `selector` may be
- *  `null` — a test simulating an element with no stable hook (id/test attribute/name), the case
- *  `browser_save_scenario`'s B1 check refuses regardless of provenance. */
+import { type BrowserDriver, type BrowserStorageState, type StorageStateInjectionResult, type ObservedRequest, type FrameRef, type ElementComponentIdentity } from "./driver.ts";
+import type { PageFingerprint } from "./capability-probe.ts";
+/** An element as a test declares it. `ref` is issued by the fake, not written here. `selector`
+ *  may be `null` — a test simulating an element with no stable hook (id/test attribute/name), the
+ *  case `browser_save_scenario`'s B1 check refuses regardless of provenance. */
+export interface FakeElement {
+    readonly role: string;
+    readonly name: string;
+    readonly selector: string | null;
+    /** Put this element inside an iframe. The fake enforces the port's own rule rather than
+     *  trusting the test: a framed element's `selector` comes back null however it was declared,
+     *  because the scenario format has no field to name a frame. */
+    readonly frame?: FrameRef;
+    /** Put this element inside an open shadow root. */
+    readonly inShadowRoot?: boolean;
+    /** This element does not exist until a reveal pass scrolls to it — a lazily-rendered row. */
+    readonly revealedByScroll?: boolean;
+    /** This element exists now and is destroyed by a reveal pass — a virtualized row recycled
+     *  out of the DOM as the list scrolls past it. */
+    readonly recycledByScroll?: boolean;
+    /** The option values this element offers, in order. Present makes it a chooser — what
+     *  `select` tests against. The real driver reads the equivalent off the DOM. */
+    readonly options?: readonly string[];
+    /** True when submitting this element is a real thing the page would do. Absent means it
+     *  submits nothing, which is what most elements are. */
+    readonly submits?: boolean;
+    /** What a configured grounder would say about this element's producing component. Absent
+     *  (not merely `undefined`) means no grounder was configured for this session and the
+     *  snapshot must report `identity: null` — same distinction the real driver makes between
+     *  "did not run" and "ran and refused". */
+    readonly identity?: ElementComponentIdentity;
+}
+/** A page as a test declares it. */
 export interface FakePage {
     readonly url: string;
     readonly title: string;
-    readonly elements: readonly {
-        readonly role: string;
-        readonly name: string;
-        readonly selector: string | null;
+    readonly elements: readonly FakeElement[];
+    /** Frames the page holds that cannot be read, each with the reason — a snapshot must report
+     *  them rather than drop them, and this is how a test declares one. */
+    readonly unreachableFrames?: readonly {
+        readonly frame: FrameRef;
+        readonly reason: string;
     }[];
+    /** Custom elements whose shadow root is closed. No API confirms one, so this is what the
+     *  real driver can only *suspect*; the fake lets a test declare the number it should report. */
+    readonly suspectedClosedHosts?: number;
+    /**
+     * What the session-start capability probe should find here. **Absent means the
+     * session has no `fingerprint` method at all**, which is the port's own way of
+     * saying "this driver cannot probe" — a fake that always answered with a
+     * fingerprint of zeroes would make an unexamined page indistinguishable from a
+     * clean one, which is the exact confusion the optional method exists to
+     * prevent. Only the fields a test cares about are written; the rest read zero.
+     */
+    readonly fingerprint?: Partial<PageFingerprint>;
 }
 export interface FakeBrowserDriver extends BrowserDriver {
     /** Declare what is served at `url`. Navigating anywhere undeclared yields an empty page, not an error — an empty page is a real thing a URL can serve. */
@@ -54,6 +97,20 @@ export interface FakeBrowserDriver extends BrowserDriver {
     /** The storageState a launch actually received, or undefined if none was given —
      *  what 11.4-b's tests assert reached the driver rather than being dropped en route. */
     storageStateReceivedFor(sessionId: string): BrowserStorageState | undefined;
+    /** The extra headers a launch actually received, or undefined if none — B1's plumbing assertion, for the same reason `storageStateReceivedFor` exists. */
+    extraHttpHeadersReceivedFor(sessionId: string): Readonly<Record<string, string>> | undefined;
+    /** Where a launch was asked to save its state, or undefined. */
+    saveStorageStateToFor(sessionId: string): string | undefined;
+    /** Every `injectStorageState()` call a session actually received, in order — the mid-session
+     *  sign-in primitive's own plumbing assertion, same reasoning `storageStateReceivedFor` gives
+     *  for the launch-time seed. */
+    injectStorageStateCallsFor(sessionId: string): readonly InjectStorageStateCall[] | undefined;
+}
+/** One `injectStorageState()` call as the fake recorded it, alongside what the fake decided about it — the same shape a caller sees back as `StorageStateInjectionResult`, plus the inputs, so a test can assert both what was asked for and what happened. */
+export interface InjectStorageStateCall {
+    readonly origin: string;
+    readonly state: BrowserStorageState;
+    readonly result: StorageStateInjectionResult;
 }
 export declare function createFakeBrowserDriver(): FakeBrowserDriver;
 //# sourceMappingURL=fake-driver.d.ts.map

package/dist/browser/fake-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake-driver.d.ts","sourceRoot":"","sources":["../../src/browser/fake-driver.ts"],"names":[],"mappings":"AAAA;;;yFAGyF;AAIzF,OAAO,EAGL,KAAK,aAAa,EAKlB,KAAK,mBAAmB,EAGxB,KAAK,eAAe,EAIrB,MAAM,aAAa,CAAC;AAErB;;2EAE2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CAClH;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,0JAA0J;IAC1J,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3C,kFAAkF;IAClF,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/G,iGAAiG;IACjG,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;QACpD,sGAAsG;QACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;KAC/C,GACA,IAAI,CAAC;IACR,qDAAqD;IACrD,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5H,IAAI,CAAC;IACR,6GAA6G;IAC7G,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3I,8GAA8G;IAC9G,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oHAAoH;IACpH,cAAc,IAAI,SAAS,MAAM,EAAE,CAAC;IACpC;4FACwF;IACxF,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CAC7E;AAeD,wBAAgB,uBAAuB,IAAI,iBAAiB,CAoM3D"}
+{"version":3,"file":"fake-driver.d.ts","sourceRoot":"","sources":["../../src/browser/fake-driver.ts"],"names":[],"mappings":"AAAA;;;yFAGyF;AAIzF,OAAO,EAOL,KAAK,aAAa,EAKlB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAGhC,KAAK,eAAe,EACpB,KAAK,QAAQ,EAOb,KAAK,wBAAwB,EAI9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAU7D;;gFAEgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;oEAEgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;sDACkD;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;oFACgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;4DACwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;+CAG2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CAC9C;AAED,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C;2EACuE;IACvE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9F;oGACgG;IAChG,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACjD;AAuBD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,0JAA0J;IAC1J,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3C,kFAAkF;IAClF,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/G,iGAAiG;IACjG,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;QACpD,sGAAsG;QACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;KAC/C,GACA,IAAI,CAAC;IACR,qDAAqD;IACrD,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5H,IAAI,CAAC;IACR,6GAA6G;IAC7G,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3I,8GAA8G;IAC9G,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oHAAoH;IACpH,cAAc,IAAI,SAAS,MAAM,EAAE,CAAC;IACpC;4FACwF;IACxF,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC5E,0JAA0J;IAC1J,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7F,gEAAgE;IAChE,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7D;;oCAEgC;IAChC,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;CAC9F;AAED,+PAA+P;AAC/P,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAuED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAkW3D"}

package/dist/browser/fake-driver.js

@@ -3,12 +3,88 @@
  *  `browser-driver-contract.test.ts` runs the same assertions against it as the real driver.
  *  Non-goals: no simulated DOM (pages are declared via `setPage`), no classification. */
 import { randomUUID } from "node:crypto";
-import { BrowserSessionCrashedError, UnknownElementRefError, } from "./driver.js";
+import { BrowserSessionCrashedError, NO_HIDDEN_REACH, NoSuchOptionError, NotSelectableError, NotSubmittableError, UnknownElementRefError, } from "./driver.js";
+import { clampWaitTimeout, describeWaitTarget, isEmptyWaitTarget, matchesWaitTarget, WAIT_POLL_INTERVAL_MS, } from "./wait-target.js";
+/** Everything a fingerprint counts, at zero. A declared fingerprint is merged over this. */
+const NO_RISKS = {
+    url: "",
+    interactiveElements: 0,
+    openShadowRoots: 0,
+    shadowInteractiveElements: 0,
+    childFrames: 0,
+    crossOriginChildFrames: 0,
+    scrollableRegions: 0,
+    canvasViewportShare: 0,
+    largestCanvasArea: 0,
+    fixedOverlays: 0,
+    inertSubtrees: 0,
+    openModalDialogs: 0,
+    passwordFields: 0,
+    oneTimeCodeFields: 0,
+    challengeMarkers: [],
+    clientSideRouting: null,
+    documentHeightRatio: 1,
+};
 const EMPTY_PAGE = (url) => ({ url, title: "", elements: [] });
+/** Main document first, then every frame the page presented, then every frame it could not read. */
+function fakeFrames(elements, page) {
+    const reach = [
+        { frame: null, enumerated: true, elements: elements.filter((e) => e.frame === null).length, reason: null },
+    ];
+    const seen = new Set();
+    for (const element of elements) {
+        if (element.frame === null || seen.has(element.frame.id))
+            continue;
+        seen.add(element.frame.id);
+        reach.push({
+            frame: element.frame,
+            enumerated: true,
+            elements: elements.filter((e) => e.frame?.id === element.frame?.id).length,
+            reason: null,
+        });
+    }
+    for (const unreachable of page.unreachableFrames ?? []) {
+        reach.push({ frame: unreachable.frame, enumerated: false, elements: 0, reason: unreachable.reason });
+    }
+    return reach;
+}
+function fakeShadow(elements, page) {
+    const pierced = elements.filter((e) => e.inShadowRoot);
+    return {
+        piercedElements: pierced.length,
+        ambiguousInDocument: pierced.filter((e) => e.selector === null && e.frame === null).length,
+        suspectedClosedHosts: page.suspectedClosedHosts ?? 0,
+        // The fake is told the number rather than probing for it, so it always "probed".
+        probed: true,
+    };
+}
+function fakeReveal(page) {
+    const frames = new Set();
+    for (const element of page.elements)
+        if (element.frame !== undefined)
+            frames.add(element.frame.name ?? element.frame.id);
+    return {
+        passes: 1,
+        revealedElements: page.elements.filter((e) => e.revealedByScroll === true).length,
+        recycledElements: page.elements.filter((e) => e.recycledByScroll === true).length,
+        stoppedAtCap: false,
+        // The fake has no DOM, so it has no containers to scroll and says so rather than guessing.
+        containersScrolled: 0,
+        // The fake has no viewport; a scroll position it invented would be a fact nothing produced.
+        finalScrollY: 0,
+        framesNotScrolled: [...frames],
+        reason: null,
+    };
+}
 export function createFakeBrowserDriver() {
     const pages = new Map();
     const states = new Map();
     const storageStateReceived = new Map();
+    const headersReceived = new Map();
+    const savePathReceived = new Map();
+    /** Every `injectStorageState()` call a session actually received, in order — what a
+     *  sign-in-step test asserts reached the driver rather than being dropped en route. */
+    const injectStorageStateCalls = new Map();
     let chromiumMissing = null;
     // Monotonic across the driver, so a ref from one session can never resolve
     // in another — the same property real refs have by being page-scoped.
@@ -26,6 +102,9 @@ export function createFakeBrowserDriver() {
             requests: state.buffer.requests,
             // The fake page has no network, so nothing can be left in flight.
             unsettled: [],
+            // The fake builds its own records directly; nothing crosses the untyped
+            // collector boundary that `evidenceWarnings` reports on.
+            evidenceWarnings: [],
         };
         state.buffer.actions = [];
         state.buffer.consoleErrors = [];
@@ -75,16 +154,60 @@ export function createFakeBrowserDriver() {
                 record("navigate", null);
                 recordPerformed("navigate", null, to, null);
             },
-            async snapshot() {
+            async snapshot(options) {
                 assertUsable();
                 const page = pages.get(url) ?? EMPTY_PAGE(url);
+                const revealing = options?.reveal === true;
+                // What the page presents *now*: without a reveal pass the lazily-rendered rows are not
+                // there yet; with one they are, and the virtualized rows it scrolled past are gone.
+                const present = page.elements.filter((e) => revealing ? e.recycledByScroll !== true : e.revealedByScroll !== true);
                 snapshotGeneration += 1;
-                refs = new Map(page.elements.map((element, index) => {
+                refs = new Map(present.map((element, index) => {
                     const ref = `ref-${snapshotGeneration}-${index}`;
-                    return [ref, { ref, role: element.role, name: element.name, selector: element.selector }];
+                    const frame = element.frame ?? null;
+                    return [
+                        ref,
+                        {
+                            ref,
+                            role: element.role,
+                            name: element.name,
+                            // The port's rule, enforced here so the contract test can assert it of both drivers.
+                            selector: frame === null ? element.selector : null,
+                            frame,
+                            inShadowRoot: element.inShadowRoot === true,
+                            // Grounding resolves a *document* selector; a framed element has none (same
+                            // reasoning as `selector` above), and an unconfigured session never attempted it.
+                            identity: frame === null ? (element.identity ?? null) : null,
+                            ...(element.options === undefined ? {} : { options: element.options }),
+                            ...(element.submits === undefined ? {} : { submits: element.submits }),
+                        },
+                    ];
+                }));
+                // Reach is computed off the full refs, which carry the fake's private declarations;
+                // what is returned is the port's own shape. `options`/`submits` are the fake's
+                // bookkeeping and must not leak into what a caller sees a snapshot return.
+                const held = [...refs.values()];
+                const elements = held.map((e) => ({
+                    ref: e.ref,
+                    role: e.role,
+                    name: e.name,
+                    selector: e.selector,
+                    identity: e.identity,
+                    frame: e.frame,
+                    inShadowRoot: e.inShadowRoot,
                 }));
-                const elements = [...refs.values()];
-                return { url, title: page.title, elements, totalElements: elements.length };
+                return {
+                    url,
+                    title: page.title,
+                    elements,
+                    totalElements: elements.length,
+                    frames: fakeFrames(held, page),
+                    shadow: fakeShadow(held, page),
+                    // The fake page is a list of elements, not a rendering of one: every element it holds
+                    // is one a test put there, so nothing is withheld and nothing went unanswered.
+                    hidden: NO_HIDDEN_REACH,
+                    reveal: revealing ? fakeReveal(page) : null,
+                };
             },
             async click(ref) {
                 assertUsable();
@@ -104,6 +227,85 @@ export function createFakeBrowserDriver() {
                 record("fill", ref, "replace");
                 recordPerformed("fill", { role: element.role, name: element.name, selector: element.selector }, null, text);
             },
+            async select(ref, value) {
+                assertUsable();
+                const element = resolve(ref);
+                if (element.options === undefined)
+                    throw new NotSelectableError(ref, element.role);
+                // Exact, and nothing else. A near match would choose an option the caller did not name.
+                if (!element.options.includes(value))
+                    throw new NoSuchOptionError(ref, value, element.options);
+                record("select", ref, "replace");
+                recordPerformed("select", { role: element.role, name: element.name, selector: element.selector }, null, value);
+            },
+            async submit(ref) {
+                assertUsable();
+                const element = resolve(ref);
+                // The fake has no DOM, so it cannot tell "no form" from "form with no control" —
+                // it declares one reason and the contract asserts only the error type. The real
+                // driver distinguishes them because it can.
+                if (element.submits !== true)
+                    throw new NotSubmittableError(ref, "noForm");
+                record("submit", ref, null);
+                recordPerformed("submit", { role: element.role, name: element.name, selector: element.selector }, null, null);
+            },
+            async waitFor(target, waitOptions = {}) {
+                assertUsable();
+                if (isEmptyWaitTarget(target)) {
+                    throw new Error("browser_wait_for needs a target: give a role, a name, or both. Waiting for nothing in particular " +
+                        `would return the first element on the page, which is not what any caller means. Got: ${describeWaitTarget(target)}.`);
+                }
+                const timeoutMs = clampWaitTimeout(waitOptions.timeoutMs);
+                const startedAt = Date.now();
+                for (;;) {
+                    assertUsable();
+                    // Re-snapshots each poll, so refs are re-issued — the same invalidation a real
+                    // page change forces, rather than a cheaper lie.
+                    const snapshot = await session.snapshot();
+                    const matches = snapshot.elements.filter((e) => matchesWaitTarget(e, target));
+                    const waitedMs = Date.now() - startedAt;
+                    if (matches.length > 0) {
+                        return { appeared: true, waitedMs, timeoutMs, matched: matches[0], matchCount: matches.length, snapshot };
+                    }
+                    if (waitedMs >= timeoutMs) {
+                        return { appeared: false, waitedMs, timeoutMs, matched: null, matchCount: 0, snapshot };
+                    }
+                    await new Promise((done) => setTimeout(done, WAIT_POLL_INTERVAL_MS));
+                }
+            },
+            async injectStorageState(origin, state) {
+                assertUsable();
+                const cookies = state.cookies ?? [];
+                const storedEntries = Object.entries(state.localStorage ?? {});
+                let localStorageInjected = 0;
+                let localStorageSkipped = null;
+                if (storedEntries.length > 0) {
+                    // Same honest degradation the real driver's runtime primitive
+                    // applies: localStorage can only be written for the origin the
+                    // page is actually on, and the fake's "page" is just `url`.
+                    let currentOrigin = null;
+                    try {
+                        currentOrigin = new URL(url).origin;
+                    }
+                    catch {
+                        currentOrigin = null;
+                    }
+                    if (currentOrigin === origin) {
+                        localStorageInjected = storedEntries.length;
+                    }
+                    else {
+                        localStorageSkipped =
+                            `the page is currently on ${currentOrigin ?? "an origin that could not be read from its URL"}, not ` +
+                                `${origin} -- localStorage can only be written for the origin a page is actually showing, so ` +
+                                `${storedEntries.length} ${storedEntries.length === 1 ? "entry was" : "entries were"} not injected. ` +
+                                "Navigate to that origin first, then call injectStorageState again.";
+                    }
+                }
+                const result = { cookiesInjected: cookies.length, localStorageInjected, localStorageSkipped };
+                const existing = injectStorageStateCalls.get(sessionId) ?? [];
+                injectStorageStateCalls.set(sessionId, [...existing, { origin, state, result }]);
+                return result;
+            },
             async drainEvidence() {
                 // Deliberately usable on a crashed session: the whole point of the
                 // flush-on-every-path rule is that a crash must not take the evidence
@@ -119,8 +321,22 @@ export function createFakeBrowserDriver() {
                 return drain(state);
             },
         };
-        states.set(sessionId, { session, buffer, crashed: false, closed: false });
-        return session;
+        // Spread in rather than declared inline: the port's `fingerprint` is optional
+        // *as a member*, and a page that declared none must leave a session on which
+        // `fingerprint === undefined`, not one whose method returns nothing.
+        // Whether the method *exists* is decided once, from the page this session
+        // opened on: a driver either probes or it does not, and that must not flicker
+        // mid-session. What it *answers* is read at call time from wherever the
+        // session currently is.
+        const probes = pages.get(targetUrl)?.fingerprint !== undefined;
+        const withProbe = probes
+            ? {
+                ...session,
+                fingerprint: async () => ({ ...NO_RISKS, ...(pages.get(url)?.fingerprint ?? {}), url }),
+            }
+            : session;
+        states.set(sessionId, { session: withProbe, buffer, crashed: false, closed: false });
+        return withProbe;
     }
     return {
         async launch(options) {
@@ -136,6 +352,8 @@ export function createFakeBrowserDriver() {
             }
             const session = openSession(options.targetUrl);
             storageStateReceived.set(session.sessionId, options.storageState);
+            headersReceived.set(session.sessionId, options.extraHttpHeaders);
+            savePathReceived.set(session.sessionId, options.saveStorageStateTo);
             return { launched: true, session };
         },
         setPage(url, page) {
@@ -184,6 +402,15 @@ export function createFakeBrowserDriver() {
         storageStateReceivedFor(sessionId) {
             return storageStateReceived.get(sessionId);
         },
+        extraHttpHeadersReceivedFor(sessionId) {
+            return headersReceived.get(sessionId);
+        },
+        saveStorageStateToFor(sessionId) {
+            return savePathReceived.get(sessionId);
+        },
+        injectStorageStateCallsFor(sessionId) {
+            return injectStorageStateCalls.get(sessionId);
+        },
     };
 }
 //# sourceMappingURL=fake-driver.js.map

package/dist/browser/fake-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"fake-driver.js","sourceRoot":"","sources":["../../src/browser/fake-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fake-driver.js","sourceRoot":"","sources":["../../src/browser/fake-driver.ts"],"names":[],"mappings":"AAAA;;;yFAGyF;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GAsBvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAC;AAuD1B,4FAA4F;AAC5F,MAAM,QAAQ,GAAoB;IAChC,GAAG,EAAE,EAAE;IACP,mBAAmB,EAAE,CAAC;IACtB,eAAe,EAAE,CAAC;IAClB,yBAAyB,EAAE,CAAC;IAC5B,WAAW,EAAE,CAAC;IACd,sBAAsB,EAAE,CAAC;IACzB,iBAAiB,EAAE,CAAC;IACpB,mBAAmB,EAAE,CAAC;IACtB,iBAAiB,EAAE,CAAC;IACpB,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,cAAc,EAAE,CAAC;IACjB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,EAAE;IACpB,iBAAiB,EAAE,IAAI;IACvB,mBAAmB,EAAE,CAAC;CACvB,CAAC;AA+DF,MAAM,UAAU,GAAG,CAAC,GAAW,EAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAEjF,oGAAoG;AACpG,SAAS,UAAU,CAAC,QAAoC,EAAE,IAAc;IACtE,MAAM,KAAK,GAAiB;QAC1B,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;KAC3G,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,SAAS;QACnE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM;YAC1E,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,QAAoC,EAAE,IAAc;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACvD,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,MAAM;QAC/B,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM;QAC1F,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,CAAC;QACpD,iFAAiF;QACjF,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzH,OAAO;QACL,MAAM,EAAE,CAAC;QACT,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,MAAM;QACjF,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,MAAM;QACjF,YAAY,EAAE,KAAK;QACnB,2FAA2F;QAC3F,kBAAkB,EAAE,CAAC;QACrB,4FAA4F;QAC5F,YAAY,EAAE,CAAC;QACf,iBAAiB,EAAE,CAAC,GAAG,MAAM,CAAC;QAC9B,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA2C,CAAC;IAChF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAwD,CAAC;IACxF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/D;2FACuF;IACvF,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC5E,IAAI,eAAe,GAA8B,IAAI,CAAC;IACtD,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,SAAS,OAAO,CAAC,SAAiB;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,KAAK,CAAC,KAAuB;QACpC,MAAM,WAAW,GAAuB;YACtC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa;YACzC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;YAC/B,kEAAkE;YAClE,SAAS,EAAE,EAAE;YACb,wEAAwE;YACxE,yDAAyD;YACzD,gBAAgB,EAAE,EAAE;SACrB,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;QAC1B,KAAK,CAAC,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;QAChC,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS,WAAW,CAAC,SAAiB;QACpC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,IAAI,GAAG,GAAG,SAAS,CAAC;QACpB,uEAAuE;QACvE,qEAAqE;QACrE,uDAAuD;QACvD,IAAI,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;QACtC,2FAA2F;QAC3F,kGAAkG;QAClG,MAAM,SAAS,GAAoB,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,EAAsB,EAAE,aAAa,EAAE,EAA4B,EAAE,QAAQ,EAAE,EAAuB,EAAE,CAAC;QAEnI,SAAS,YAAY;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAC9G,CAAC;QAED,SAAS,OAAO,CAAC,GAAW;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,SAAS,MAAM,CAAC,MAAgC,EAAE,GAAkB,EAAE,OAA+B,IAAI;YACvG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,SAAS,eAAe,CACtB,MAA+B,EAC/B,MAA+B,EAC/B,YAA2B,EAC3B,IAAmB;YAEnB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,OAAO,GAAuB;YAClC,SAAS;YACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;gBACN,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACpC,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAChE,CAAC;YACD,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG;YACrB,KAAK,CAAC,QAAQ,CAAC,EAAU;gBACvB,YAAY,EAAE,CAAC;gBACf,GAAG,GAAG,EAAE,CAAC;gBACT,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;gBACjB,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACzB,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;YACD,KAAK,CAAC,QAAQ,CAAC,OAAyB;gBACtC,YAAY,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC/C,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;gBAC3C,uFAAuF;gBACvF,oFAAoF;gBACpF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,KAAK,IAAI,CACtE,CAAC;gBACF,kBAAkB,IAAI,CAAC,CAAC;gBACxB,IAAI,GAAG,IAAI,GAAG,CACZ,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;oBAC7B,MAAM,GAAG,GAAG,OAAO,kBAAkB,IAAI,KAAK,EAAE,CAAC;oBACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;oBACpC,OAAO;wBACL,GAAG;wBACH;4BACE,GAAG;4BACH,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,qFAAqF;4BACrF,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;4BAClD,KAAK;4BACL,YAAY,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;4BAC3C,4EAA4E;4BAC5E,kFAAkF;4BAClF,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;4BAC5D,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;4BACtE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;yBACvE;qBACO,CAAC;gBACb,CAAC,CAAC,CACH,CAAC;gBACF,oFAAoF;gBACpF,+EAA+E;gBAC/E,2EAA2E;gBAC3E,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAChC,MAAM,QAAQ,GAAsB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnD,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,YAAY,EAAE,CAAC,CAAC,YAAY;iBAC7B,CAAC,CAAC,CAAC;gBACJ,OAAO;oBACL,GAAG;oBACH,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ;oBACR,aAAa,EAAE,QAAQ,CAAC,MAAM;oBAC9B,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;oBAC9B,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;oBAC9B,sFAAsF;oBACtF,+EAA+E;oBAC/E,MAAM,EAAE,eAAe;oBACvB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;iBAC5C,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,KAAK,CAAC,GAAW;gBACrB,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBACrB,eAAe,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/G,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAY;gBAClC,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC9B,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9G,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAY;gBAClC,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC/B,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9G,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAa;gBACrC,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;oBAAE,MAAM,IAAI,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnF,wFAAwF;gBACxF,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC/F,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;gBACjC,eAAe,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACjH,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,GAAW;gBACtB,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,iFAAiF;gBACjF,gFAAgF;gBAChF,4CAA4C;gBAC5C,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;oBAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC3E,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC5B,eAAe,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChH,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,MAAqB,EAAE,cAA8B,EAAE;gBACnE,YAAY,EAAE,CAAC;gBACf,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CACb,mGAAmG;wBACjG,wFAAwF,kBAAkB,CAAC,MAAM,CAAC,GAAG,CACxH,CAAC;gBACJ,CAAC;gBACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,SAAS,CAAC;oBACR,YAAY,EAAE,CAAC;oBACf,+EAA+E;oBAC/E,iDAAiD;oBACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;oBAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;oBAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBAExC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACvB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;oBAC7G,CAAC;oBACD,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;wBAC1B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;oBAC1F,CAAC;oBACD,MAAM,IAAI,OAAO,CAAO,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YACD,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,KAA0B;gBACjE,YAAY,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;gBACpC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;gBAC/D,IAAI,oBAAoB,GAAG,CAAC,CAAC;gBAC7B,IAAI,mBAAmB,GAAkB,IAAI,CAAC;gBAC9C,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7B,8DAA8D;oBAC9D,+DAA+D;oBAC/D,4DAA4D;oBAC5D,IAAI,aAAa,GAAkB,IAAI,CAAC;oBACxC,IAAI,CAAC;wBACH,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;oBACtC,CAAC;oBAAC,MAAM,CAAC;wBACP,aAAa,GAAG,IAAI,CAAC;oBACvB,CAAC;oBACD,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;wBAC7B,oBAAoB,GAAG,aAAa,CAAC,MAAM,CAAC;oBAC9C,CAAC;yBAAM,CAAC;wBACN,mBAAmB;4BACjB,4BAA4B,aAAa,IAAI,+CAA+C,QAAQ;gCACpG,GAAG,MAAM,qFAAqF;gCAC9F,GAAG,aAAa,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,iBAAiB;gCACrG,oEAAoE,CAAC;oBACzE,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAgC,EAAE,eAAe,EAAE,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;gBAC3H,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC9D,uBAAuB,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;gBACjF,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,CAAC,aAAa;gBACjB,mEAAmE;gBACnE,sEAAsE;gBACtE,oBAAoB;gBACpB,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,cAAc;gBACZ,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;YACxB,CAAC;YACD,KAAK,CAAC,KAAK;gBACT,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;gBACjC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;gBACpB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;SACF,CAAC;QAEF,8EAA8E;QAC9E,6EAA6E;QAC7E,qEAAqE;QACrE,0EAA0E;QAC1E,8EAA8E;QAC9E,wEAAwE;QACxE,wBAAwB;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,KAAK,SAAS,CAAC;QAC/D,MAAM,SAAS,GAAuB,MAAM;YAC1C,CAAC,CAAC;gBACE,GAAG,OAAO;gBACV,WAAW,EAAE,KAAK,IAA8B,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;aAClH;YACH,CAAC,CAAC,OAAO,CAAC;QAEZ,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAA6B;YACxC,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;gBAC7B,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,sBAAsB;oBAC/B,OAAO,EACL,mGAAmG;wBACnG,yGAAyG;oBAC3G,MAAM,EAAE,eAAe,CAAC,MAAM;oBAC9B,sBAAsB,EAAE,mBAAmB;iBAC5C,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YAClE,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;YACjE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACpE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,GAAW,EAAE,IAAc;YACjC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,kBAAkB,CAAC,MAAM,GAAG,iCAAiC;YAC3D,kEAAkE;YAClE,qEAAqE;YACrE,8DAA8D;YAC9D,eAAe,GAAG,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC;QACD,gBAAgB,CAAC,SAAS,EAAE,KAAK;YAC/B,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjH,CAAC;QACD,WAAW,CAAC,SAAS,EAAE,OAAO;YAC5B,2FAA2F;YAC3F,wDAAwD;YACxD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACrC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,UAAU,EAAE,IAAI;gBAChB,gBAAgB,EAAE,EAAE;gBACpB,GAAG,IAAI;gBACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;gBAC7C,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,iBAAiB,CAAC,SAAS,EAAE,OAAO;YAClC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChI,CAAC;QACD,kBAAkB,CAAC,SAAS,EAAE,OAAO;YACnC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACtC,gBAAgB,EAAE,EAAE;gBACpB,UAAU,EAAE,IAAI;gBAChB,GAAG,OAAO;gBACV,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,SAAS;gBAClB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,SAAS;YACb,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;QACpC,CAAC;QACD,cAAc;YACZ,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,uBAAuB,CAAC,SAAiB;YACvC,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,2BAA2B,CAAC,SAAiB;YAC3C,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QACD,qBAAqB,CAAC,SAAiB;YACrC,OAAO,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QACD,0BAA0B,CAAC,SAAiB;YAC1C,OAAO,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/browser/fault-attribution.d.ts

@@ -0,0 +1,178 @@
+/**
+ * When a browser action fails: whose fault was it?
+ *
+ * ## This concept did not already exist
+ *
+ * `browser-reliability.md` §4.5 says "the product already carries this
+ * concept". Checked before building: it does not. `descry-runtime` has four
+ * incidental uses of the word "attributable" — a log envelope naming its
+ * unwrapper, evidence carrying a process id, a correlator comment about not
+ * blaming a producer, a test runner locating a fact — and no fault-domain type,
+ * no owner vocabulary and nothing that decides between them. The nearest real
+ * neighbours are `@descryy/ir`'s five **result states** and five **report
+ * categories**, and both answer a different question: they say how much Descry
+ * can claim, never who broke it. So this is new, and it is deliberately shaped
+ * like its neighbours — a small closed vocabulary, one function that decides,
+ * and an explicit value for "do not know".
+ *
+ * ## The one rule everything else serves
+ *
+ * **A timeout with nothing corroborating it is never the application's fault.**
+ * A wait that expired is a fact about Descry: the page did not reach a state
+ * Descry was waiting for, within a budget Descry chose. It is equally
+ * consistent with a broken button, a slow one, an overlay, and an animation.
+ * Reporting it as the user's bug is the single fastest way to make a testing
+ * tool untrusted, and the cost of being wrong is asymmetric — an
+ * `undetermined` that was really a bug costs one missed finding, and an
+ * `application` that was really our timeout costs the tool's credibility.
+ * That is rule 2 (precision over recall) applied to blame rather than to edges.
+ *
+ * So `application` is only ever named with a **first-party corroborating
+ * signal** in the same window: the page threw, or a request to the
+ * application's own origin failed. Never on the timeout alone.
+ *
+ * ## Where the corroborating signal comes from (C3)
+ *
+ * It does not exist yet when the failure happens. The recording decorator sees
+ * the throw and must not drain evidence to enrich it — evidence is drained, not
+ * peeked, and reading it there would steal what the calling tool is about to
+ * report. So `attributeActionFailure` runs on the error and the clock alone and
+ * most real failures start `undetermined`, which is the honest answer to what
+ * it was given. `evidenceInWindow` and `refineAttribution` below are the second
+ * half: the next drain of that session hands over what the page actually
+ * produced, the counts are narrowed to the failed action's own window, and the
+ * attribution is re-decided once. Wired at the two places a drain happens —
+ * `observeAndCorrelate` for every evidence-bearing tool call, and the
+ * registry's `reap` for the tail no tool call ever returns.
+ */
+import { type BrowserObservation } from "./driver.ts";
+/**
+ * The four fault domains, plus the fifth value that keeps the other four
+ * honest. `undetermined` is not a failure to classify — it is the correct
+ * answer whenever the evidence does not reach one of the four, and a
+ * vocabulary without it would force every case into a guess.
+ */
+export declare const FAULT_OWNERS: readonly ["application", "automation", "environment", "dependency", "undetermined"];
+export type FaultOwner = (typeof FAULT_OWNERS)[number];
+export interface FaultAttribution {
+    readonly owner: FaultOwner;
+    /** What happened, in the report's voice. Never an accusation. */
+    readonly reason: string;
+    /** What was observed that led here. Deliberately distinct from `reason`: a
+     *  reader who disagrees with the attribution must be able to see the input
+     *  that produced it without re-running anything. */
+    readonly evidence: string;
+}
+/** Everything known about one failed action at the moment it failed. */
+export interface ActionFailure {
+    readonly verb: string;
+    readonly error: unknown;
+    /** How long the action ran before throwing. */
+    readonly elapsedMs: number;
+    /** Console errors the page produced in the same window. */
+    readonly pageErrors: number;
+    /** Requests that failed in the same window. */
+    readonly failedRequests: number;
+    /** How many of those were to an origin other than the application's own. */
+    readonly thirdPartyFailedRequests: number;
+}
+export declare function attributeActionFailure(failure: ActionFailure): FaultAttribution;
+/** The bounds of one failed action, in epoch milliseconds: when the verb was
+ *  called and when it threw. Evidence outside them is about something else. */
+export interface ActionWindow {
+    readonly from: number;
+    readonly to: number;
+}
+/** What `evidenceInWindow` found — the three counts `ActionFailure` could not
+ *  carry at the moment of failure. */
+export interface LaterEvidence {
+    readonly pageErrors: number;
+    readonly failedRequests: number;
+    readonly thirdPartyFailedRequests: number;
+}
+/**
+ * Counts, out of one drained observation, only what happened **inside a failed
+ * action's own window**.
+ *
+ * ## Why the window, and not the drain
+ *
+ * A drain is not a window. A drained observation covers everything since the
+ * last drain, which — because a failed verb throws and the tool never gets to
+ * drain — routinely includes a later, unrelated action. Counting the whole
+ * drain would let a console error caused by the *next* click decide who broke
+ * the previous one, and it would say so in the report's voice. The action's own
+ * start and end are recorded by the decorator for exactly this, and everything
+ * outside them is discarded rather than discounted.
+ *
+ * ## What is excluded, and why each exclusion goes the same way
+ *
+ * A timestamp that will not parse, a request URL that will not parse, and an
+ * `unattributed` request all resolve *away* from `application`. That is not
+ * symmetry for its own sake: the asymmetric cost this module was built around
+ * says an `undetermined` that was really a bug costs one finding, and an
+ * `application` that was really Descry's own timeout costs the tool. So an
+ * unreadable URL is counted as third-party (it cannot name the application), an
+ * unreadable timestamp is counted as outside the window, and a request whose
+ * terminal event could not be assigned to it is not counted as a failure at
+ * all — otherwise C3's own refusal to guess a join would come straight back as
+ * a guess about blame.
+ */
+export declare function evidenceInWindow(observation: Pick<BrowserObservation, "consoleErrors" | "requests">, window: ActionWindow, applicationOrigin: string): LaterEvidence;
+/**
+ * Re-decide an attribution once evidence that was not available at the moment
+ * of failure has arrived. Only ever called on `undetermined`: an attribution
+ * that already reached one of the four rested on a signal this later evidence
+ * cannot withdraw, and silently rewriting it would make the same failure read
+ * two ways in two replies.
+ */
+export declare function refineAttribution(attribution: FaultAttribution, failure: ActionFailure, later: LaterEvidence): FaultAttribution;
+export declare function faultNote(attribution: FaultAttribution): string;
+/**
+ * RG-12(b): the vocabulary reconciliation. The site names three layers to a
+ * user — "your product", "your environment", "a dependency" — and this
+ * module's own five values are `application`, `automation`, `environment`,
+ * `dependency`, `undetermined`. Two real gaps, not one:
+ *
+ * 1. `automation` (Descry's *own* fault — a bad ref, a stale handle, a
+ *    harness bug) has nowhere to go in the site's three layers, and it is
+ *    the one value that most protects a user's trust: folding it into
+ *    "your environment" would let Descry's own mistake read as the user's
+ *    infrastructure being at fault, which is backwards.
+ * 2. `undetermined` has nowhere to go either, and collapsing it into any of
+ *    the three would state a layer the evidence did not actually reach.
+ *
+ * **Recommendation (implemented here, not on the site — that copy is a
+ * different lane's to change): the site gains a fourth and fifth category
+ * rather than losing this module's granularity.** "Descry itself" for
+ * `automation` (visible, not hidden — this is the layer that most needs to
+ * be named when the tool is the one that got it wrong) and "not
+ * determined" for `undetermined` (an honest refusal is not a hidden
+ * failure). No code value is deleted to fit the narrower copy; this
+ * function is the one place that maps the closed five-value set onto
+ * display text, so a copy change only ever touches this map.
+ */
+export declare const FAULT_OWNER_DISPLAY_LABELS: Readonly<Record<FaultOwner, string>>;
+/**
+ * RG-12(c): the type-level half of "every failure carries a layer, by
+ * construction, not by convention." A `switch` with no `default` fails to
+ * compile the moment `FAULT_OWNERS` gains or loses a value without this
+ * function being updated to match — the same guarantee `ActionRecord`'s
+ * discriminated union (`reachability.ts`) gives the *presence* of an
+ * attribution; this is what gives the *display* side the same guarantee.
+ */
+export declare function faultOwnerDisplayLabel(owner: FaultOwner): string;
+/**
+ * RG-12(c): the run-level half. Not a convention check — `ActionRecord`'s
+ * discriminated union already makes `{ succeeded: false, attribution: null }`
+ * uncoinstructable inside this module. This is the belt for a caller
+ * reaching in from outside the type system (a cast, a deserialised record,
+ * a future refactor that widens the type back out) — the same "trust but
+ * verify" `report()`'s own filter used to need before the union made it
+ * unnecessary there. Throws by name rather than silently dropping the
+ * finding, which is the failure mode this whole item exists to close.
+ */
+export declare function assertEveryFailureAttributed(actions: readonly {
+    readonly succeeded: boolean;
+    readonly attribution?: FaultAttribution | null;
+}[]): void;
+//# sourceMappingURL=fault-attribution.d.ts.map

package/dist/browser/fault-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-attribution.d.ts","sourceRoot":"","sources":["../../src/browser/fault-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAuE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE3H;;;;;GAKG;AACH,eAAO,MAAM,YAAY,qFAAsF,CAAC;AAEhH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;wDAEoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AAWD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CA4D/E;AAED;+EAC+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;sCACsC;AACtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,UAAU,CAAC,EACnE,MAAM,EAAE,YAAY,EACpB,iBAAiB,EAAE,MAAM,GACxB,aAAa,CAsBf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,aAAa,GACnB,gBAAgB,CAUlB;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAM3E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAoBhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,IAAI,CAStJ"}