@descryy/runtime-browser 0.3.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/browser-console-collector.d.ts

@@ -1,18 +1,12 @@
 /**
- * §8's console evidence bucket (level · message · stack if present ·
- * timestamp) plus page errors -- uncaught exceptions in the page's own JS,
- * captured via Playwright's `pageerror` event. Both ride the same
- * `EvidenceSource: "browser-console"` bucket the contracts already name.
+ * §8 console evidence (level/message/stack/timestamp) plus page errors --
+ * uncaught JS exceptions via Playwright's `pageerror` event. Both use the
+ * `EvidenceSource: "browser-console"` bucket.
  *
- * Page-error stack text is preserved verbatim in `payload.stack` (plan §9:
- * "the runtime must preserve the original observation") but NOT
- * structurally parsed into `StackTrace` frames with resolved
- * `SourceLocation`s in V1 -- reflected honestly in `capabilities()`
- * (`stackCapture`/`sourceMapping`: unavailable), not silently produced as
- * a lesser version. Doing that for real would need mapping the browser's
- * `http://` script URLs back to on-disk files via the frontend's static
- * file server root, which this collector has no way to know -- a real,
- * separate feature, not built here.
+ * Page-error stack text is preserved verbatim (§9: preserve the original
+ * observation) but without a parser is not structurally parsed into
+ * `StackTrace` frames -- reflected honestly in `capabilities()`
+ * (`stackCapture`/`sourceMapping`: unavailable), not silently downgraded.
  */
 import type { Collector } from "@descryy/runtime-contracts";
 import type { StackTraceParser } from "@descryy/runtime-backend-observation";
@@ -21,11 +15,9 @@ export interface BrowserConsoleCollectorOptions {
     readonly session: BrowserSession;
     readonly service?: string;
     /**
-     * Injected, never constructed here — a browser page runs JavaScript, but
-     * this package stays language-neutral the same way `LogCollector` does:
-     * whoever wires the collector supplies the parser for the runtime it is
-     * actually watching. Omit it and page-error stacks are preserved as text
-     * exactly as before, with `capabilities()` saying so.
+     * Injected, never constructed here -- stays language-neutral like
+     * `LogCollector`. Omit it and stacks are preserved as text, with
+     * `capabilities()` saying so.
      */
     readonly stackTraceParser?: StackTraceParser;
 }

package/dist/browser-console-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-console-collector.d.ts","sourceRoot":"","sources":["../src/browser-console-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAqF,MAAM,4BAA4B,CAAC;AAG/I,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAmDD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,CA8HhG"}
+{"version":3,"file":"browser-console-collector.d.ts","sourceRoot":"","sources":["../src/browser-console-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAqF,MAAM,4BAA4B,CAAC;AAG/I,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAgDD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,CAgHhG"}

package/dist/browser-console-collector.js

@@ -1,18 +1,12 @@
 /**
- * §8's console evidence bucket (level · message · stack if present ·
- * timestamp) plus page errors -- uncaught exceptions in the page's own JS,
- * captured via Playwright's `pageerror` event. Both ride the same
- * `EvidenceSource: "browser-console"` bucket the contracts already name.
+ * §8 console evidence (level/message/stack/timestamp) plus page errors --
+ * uncaught JS exceptions via Playwright's `pageerror` event. Both use the
+ * `EvidenceSource: "browser-console"` bucket.
  *
- * Page-error stack text is preserved verbatim in `payload.stack` (plan §9:
- * "the runtime must preserve the original observation") but NOT
- * structurally parsed into `StackTrace` frames with resolved
- * `SourceLocation`s in V1 -- reflected honestly in `capabilities()`
- * (`stackCapture`/`sourceMapping`: unavailable), not silently produced as
- * a lesser version. Doing that for real would need mapping the browser's
- * `http://` script URLs back to on-disk files via the frontend's static
- * file server root, which this collector has no way to know -- a real,
- * separate feature, not built here.
+ * Page-error stack text is preserved verbatim (§9: preserve the original
+ * observation) but without a parser is not structurally parsed into
+ * `StackTrace` frames -- reflected honestly in `capabilities()`
+ * (`stackCapture`/`sourceMapping`: unavailable), not silently downgraded.
  */
 import { primaryFrameLocation } from "@descryy/runtime-contracts";
 import { extractCorrelationIds } from "@descryy/runtime-backend-observation";
@@ -43,15 +37,12 @@ const CAPABILITIES = {
     externalServiceObservation: notThisCollectorsJob("external service observation"),
 };
 /**
- * RT-023 landed: with a parser injected and `CollectorContext.resolveSourceRoot`
- * present, page-error stacks are parsed and their `http://` script URLs are
- * rewritten to on-disk paths.
+ * RT-023: with a parser injected and `resolveSourceRoot` present,
+ * page-error stacks are parsed and script URLs rewritten to on-disk paths.
  *
- * `sourceMapping` stays **degraded**, not available, and the distinction is
- * load-bearing: the origin-to-root lookup proves the origin maps to a
- * configured directory, not that the file the browser executed came from
- * the checkout in it (`declaredCwd` is named for exactly that). A script
- * this execution did not serve — a CDN, an extension — is left as a URL.
+ * `sourceMapping` stays degraded, not available: the lookup proves the
+ * origin maps to a configured directory, not that the executed file came
+ * from that checkout. A script this execution didn't serve is left as URL.
  */
 const CAPABILITIES_WITH_STACKS = {
     ...CAPABILITIES,
@@ -73,15 +64,11 @@ export function createBrowserConsoleCollector(options) {
     /**
      * In-flight `onPageError` handlers.
      *
-     * Parsing a stack is asynchronous, and Playwright's `pageerror` listener
-     * is not — so the handler starts work and returns, and `stop()` used to
-     * clear `emit` out from under it. Any page error whose parse had not
-     * finished was **silently deleted**: `emit?.()` on an undefined `emit` is
-     * a no-op, and nothing recorded that an observation had been dropped.
-     * `stop()` is called at the end of every execution, which is precisely
-     * when a page's last error arrives, so this was not a rare window.
-     *
-     * `stop()` now drains this set before clearing `emit`.
+     * Parsing is async but Playwright's `pageerror` listener isn't, so
+     * `stop()` used to clear `emit` while a parse was still running --
+     * `emit?.()` on undefined is a silent no-op, dropping the page's last
+     * error every time (stop() runs right when it arrives). `stop()` now
+     * drains this set first.
      */
     const inFlight = new Set();
     function onConsole(msg) {
@@ -122,23 +109,18 @@ export function createBrowserConsoleCollector(options) {
                 eventType: "EXCEPTION",
                 payload: {
                     message: error.message,
-                    // The browser's own text, always, whatever the mapping did to it
-                    // (plan §9: preserve the original observation).
+                    // raw browser text, unchanged by the mapping (§9: preserve the original observation).
                     stack: rawStack,
                     browserSessionId: session.sessionId,
-                    // Per-URL outcomes rather than a boolean: "three scripts, two
-                    // mapped, one is a CDN" is a coverage statement, and collapsing
-                    // it would imply the unmapped one simply was not there.
+                    // per-URL outcomes, not a boolean -- collapsing would hide the partially-mapped case.
                     ...(mapping !== null ? { scriptUrlMapping: mapping.outcomes } : {}),
                 },
                 traceId: null,
                 requestId: null,
                 correlationId: null,
                 graphNodeId: null,
-                // Was its own `frames[0]` copy of a rule `backend-observation` had
-                // already moved onto `primaryFrameIndex` (RT-083). The two agreed
-                // only because V8 reports index 0 — a coincidence, not a shared
-                // rule. The full chain is in stackTrace either way.
+                // backend-observation moved to primaryFrameIndex (RT-083); frames[0] agreement was
+                // coincidence (V8 reports index 0), not a shared rule. Full chain is in stackTrace either way.
                 sourceLocation: primaryFrameLocation(stackTrace),
                 stackTrace,
                 confidence: 1,
@@ -157,9 +139,7 @@ export function createBrowserConsoleCollector(options) {
             }
             emit = context.emit;
             resolveSourceRoot = context.resolveSourceRoot;
-            // Both halves or neither: a parser with no way to map URLs would
-            // produce frames pointing at http:// locations nothing can open, and
-            // a mapper with no parser has nothing to map.
+            // both halves or neither: a parser without a mapper points at http:// nothing can open, and a mapper without a parser has nothing to map.
             stacksParsed = options.stackTraceParser !== undefined && context.resolveSourceRoot !== undefined;
             page.on("console", onConsole);
             page.on("pageerror", onPageError);
@@ -169,11 +149,8 @@ export function createBrowserConsoleCollector(options) {
             // Listeners off first, so nothing new joins the set while it drains.
             page.off("console", onConsole);
             page.off("pageerror", onPageError);
-            // Then drain, THEN clear `emit` — in that order. Clearing first is
-            // what silently deleted the last page error of every execution.
-            // `allSettled`: a handler that threw has already failed on its own
-            // terms, and stop() refusing to complete because of it would take the
-            // rest of the run's evidence down with it.
+            // drain then clear emit -- clearing first silently dropped the last page error.
+            // allSettled: a handler that threw already failed on its own terms and shouldn't block the rest.
             await Promise.allSettled([...inFlight]);
             emit = undefined;
         },

package/dist/browser-console-collector.js.map

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

package/dist/browser-session.d.ts

@@ -1,35 +1,21 @@
 /**
- * §7's launch / isolated context / page creation, as a thin wrapper over
- * Playwright (see `documents/decisions-inbox/PROPOSAL-B-playwright-for-
- * browser-runtime.md` for why Playwright over raw CDP). One
- * `BrowserSession` = one Playwright `BrowserContext` (Playwright's own
- * isolation unit -- separate cookies/storage/cache per context) plus its
- * one page, which is what plan §7's "isolated context/session · page
- * creation" already asks for; nothing here re-derives isolation Playwright
- * already gives structurally.
+ * §7 launch/isolated-context/page creation, a thin wrapper over Playwright
+ * (see PROPOSAL-B-playwright-for-browser-runtime.md for why Playwright over
+ * raw CDP). One `BrowserSession` = one Playwright `BrowserContext` (its own
+ * isolation unit) plus its one page.
  *
- * Deliberately does NOT itself turn browser-session launch into Evidence.
- * `BrowserSessionHandle` (`execution.ts`) already carries `sessionId` /
- * `targetUrl` / `startedAt` / `endedAt` structurally on `Execution`, the
- * same relationship `ProcessHandle` has to process lifecycle --
- * `backend-observation/collector.ts` declared that an equivalent non-goal
- * for `ProcessCollector`, for the identical reason: whether session
- * lifecycle becomes Evidence at all is an orchestration-layer question,
- * not this seam's. Both non-goals now have an answer, in each package's
- * own collector — `createProcessCollector` (`@descryy/runtime-controller`)
- * and `BrowserActionCollector.start()` (`browser-action-collector.ts`,
- * PAGE_CREATED) — never here. `startedAt` is captured below only so that
- * answer has a real creation timestamp to report rather than "whenever a
- * collector got around to starting."
+ * Deliberately does NOT turn session launch into Evidence -- that's a
+ * collector's job (`createProcessCollector` for process lifecycle;
+ * `BrowserActionCollector.start()`'s PAGE_CREATED for this), never this
+ * module's. `startedAt` is captured below only so that answer has a real
+ * creation timestamp to report.
  */
 import { type Page } from "playwright-core";
 import type { BrowserConfiguration } from "@descryy/runtime-contracts";
 /**
- * RT-068: this used to be its own interface, declared independently of
- * `ExecutionConfiguration.browser`. Two shapes with the same one field would
- * have been exactly the "parallel copy that could drift" this codebase
- * already refuses elsewhere (see `InstrumentedExecutionInput.execution`'s
- * own comment) -- so this is the contracts type, not a look-alike of it.
+ * RT-068: this is the contracts type (`BrowserConfiguration`), not a
+ * look-alike declared independently of `ExecutionConfiguration.browser` --
+ * two shapes with the same field would drift.
  */
 export type BrowserSessionOptions = BrowserConfiguration;
 export interface BrowserSession {
@@ -39,64 +25,47 @@ export interface BrowserSession {
     readonly startedAt: string;
     /**
      * False once the page has crashed or closed. Every collector's `start()`
-     * consults this before reporting `{available: true}` -- `page.isClosed()`
-     * alone is not sufficient: verified directly that it still reports
-     * `false` after a real `chrome://crash`, so a collector checking only
-     * `isClosed()` would report itself available against a page that can no
-     * longer run a single action. The `'crash'` event is the only signal
-     * that actually fires for that case, so it's tracked here once, for
-     * every collector sharing this session, rather than each collector
-     * re-attaching its own listener.
+     * checks this before reporting available -- `page.isClosed()` alone
+     * isn't enough: verified that it still returns false after a real
+     * `chrome://crash`. Tracked once here via the `'crash'` event, shared
+     * across every collector on this session.
      */
     isUsable(): boolean;
     close(): Promise<void>;
     /**
-     * The finished `recordVideo` file's bytes, or `null` when this session was
-     * never launched with `recordVideo: true`.
+     * The finished `recordVideo` file's bytes, or `null` if this session
+     * wasn't launched with `recordVideo: true`.
      *
-     * **Still deliberately not Evidence** -- same non-goal this file's own
-     * header already states for session launch, applied to session teardown:
-     * turning a raw fact into Evidence is a collector's job
-     * (`BrowserActionCollector.captureVideo()`), never this module's.
+     * Not Evidence -- same non-goal as session launch above; that's a
+     * collector's job (`BrowserActionCollector.captureVideo()`).
      *
-     * **Must be called after `close()` has resolved.** Playwright's own
-     * contract for `Video.path()` is that it does not resolve until the
-     * browser context that recorded it has closed -- calling this first would
-     * hang waiting for a close that this method does not itself trigger, so it
-     * throws immediately instead of hanging on a caller's mistake.
+     * Must be called after `close()` resolves: `Video.path()` doesn't
+     * resolve until the context has closed, and this method doesn't trigger
+     * that close itself, so it throws immediately rather than hanging.
      *
-     * Reads the file fully into memory and removes the temp directory it was
-     * written to -- the same "whole file in memory" tradeoff `screenshot()`
-     * already makes at a smaller scale (this module's sibling,
-     * `browser-action-collector.ts`), and once the bytes are safely returned
-     * here the on-disk copy has no further purpose.
+     * Reads the whole file into memory and removes the temp dir -- same
+     * tradeoff `screenshot()` makes at a smaller scale.
      */
     finishedVideo(): Promise<Uint8Array | null>;
 }
 /**
- * Why this exists, and why it is not a `throw`.
+ * Why this exists, and why it's not a throw.
  *
- * This package depends on `playwright-core`, not `playwright`. The two ship
- * the same driver; only `playwright` carries a postinstall that downloads
- * Chromium. That postinstall is transitive, so every install of a package
- * that has this one anywhere in its closure -- `@descryy/mcp`, whose users
- * overwhelmingly never call a browser tool -- paid several hundred megabytes
- * for a browser it would never launch. `playwright-core` removes the download
- * and, with it, the guarantee that a browser is present at all.
+ * This package depends on `playwright-core`, not `playwright` -- only
+ * `playwright`'s postinstall downloads Chromium, and that cost is
+ * transitive to everything depending on this package (e.g. `@descryy/mcp`,
+ * whose users mostly never call a browser tool): several hundred megabytes
+ * for a browser never launched. `playwright-core` drops the download and
+ * the guarantee a browser is present.
  *
- * So absence is now a normal, expected state rather than a broken install,
- * and it gets the shape this codebase already gives an expected inability:
- * `ServiceRootLookup`'s `{ found: false, refusal, message }` (contracts,
- * `source-root.ts`). One field is added to it -- `remedy` -- because the
- * caller mapping this onto a user-visible refusal must be able to print the
- * exact command rather than paraphrase it, and a remedy buried in prose is a
- * remedy the caller has to parse back out.
+ * So absence is a normal state, shaped like this codebase's other expected
+ * inabilities (`ServiceRootLookup`'s `{ found: false, refusal, message }`),
+ * plus a `remedy` field so a caller can print the exact fix rather than
+ * paraphrase it.
  *
- * The check is `existsSync` on the path `playwright-core` itself computes.
- * `chromium.executablePath()` does not verify existence -- it returns the
- * path this build *would* use, resolved against `PLAYWRIGHT_BROWSERS_PATH`
- * when that is set -- so the check and the launch below are handed the same
- * string, and cannot disagree about which binary was meant.
+ * Checked via `existsSync` on the path `playwright-core` itself computes --
+ * `chromium.executablePath()` doesn't verify existence, it returns the path
+ * this build would use, so the check and the launch below can't disagree.
  */
 export interface ChromiumUnavailable {
     readonly refusal: "chromiumNotInstalled";
@@ -120,10 +89,9 @@ export type BrowserSessionLaunch = {
 } & ChromiumUnavailable);
 export declare const CHROMIUM_INSTALL_REMEDY = "npx playwright install chromium";
 /**
- * Resolved at launch time, deliberately not at import time. A module-level
- * check would make merely importing this package fail on a machine with no
- * browser -- including for a consumer that imports it only to read a type,
- * which is the exact cost `playwright-core` was adopted to remove.
+ * Resolved at launch time, not import time -- a module-level check would
+ * fail merely importing this package on a machine with no browser, the
+ * exact cost `playwright-core` was adopted to remove.
  */
 export declare function resolveChromiumExecutable(): ChromiumAvailability;
 /** Thrown by `launchBrowserSession` when `resolveChromiumExecutable()` refuses. Carries the refusal whole, so a caller that catches rather than branching still gets the remedy. */
@@ -134,10 +102,10 @@ export declare class BrowserUnavailableError extends Error {
     constructor(unavailable: ChromiumUnavailable);
 }
 /**
- * The refusal-returning launch. Prefer this wherever a missing browser is a
- * reportable outcome rather than a bug -- an MCP tool mapping it onto its own
- * `refused` state, for instance. `launchBrowserSession` below is the same
- * call for callers that would only rethrow.
+ * Refusal-returning launch. Prefer this where a missing browser is a
+ * reportable outcome, not a bug (e.g. an MCP tool's `refused` state).
+ * `launchBrowserSession` below is the same call for callers that would
+ * only rethrow.
  */
 export declare function launchBrowserSessionOrRefuse(options?: BrowserSessionOptions): Promise<BrowserSessionLaunch>;
 export declare function launchBrowserSession(options?: BrowserSessionOptions): Promise<BrowserSession>;

package/dist/browser-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../src/browser-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA+C,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,2JAA2J;IAC3J,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,IAAI,OAAO,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gIAAgI;IAChI,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC7D,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GAAG,mBAAmB,CAAC,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC7D,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,GAAG,mBAAmB,CAAC,CAAC;AAEzD,eAAO,MAAM,uBAAuB,oCAAoC,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,CAYhE;AAED,oLAAoL;AACpL,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;gBAE5B,WAAW,EAAE,mBAAmB;CAO7C;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOrH;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,cAAc,CAAC,CAOvG"}
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../src/browser-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA+C,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,2JAA2J;IAC3J,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;;;;;;;;OAaG;IACH,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gIAAgI;IAChI,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC7D,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GAAG,mBAAmB,CAAC,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC7D,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,GAAG,mBAAmB,CAAC,CAAC;AAEzD,eAAO,MAAM,uBAAuB,oCAAoC,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,CAYhE;AAED,oLAAoL;AACpL,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;gBAE5B,WAAW,EAAE,mBAAmB;CAO7C;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOrH;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,cAAc,CAAC,CAOvG"}

package/dist/browser-session.js

@@ -1,26 +1,14 @@
 /**
- * §7's launch / isolated context / page creation, as a thin wrapper over
- * Playwright (see `documents/decisions-inbox/PROPOSAL-B-playwright-for-
- * browser-runtime.md` for why Playwright over raw CDP). One
- * `BrowserSession` = one Playwright `BrowserContext` (Playwright's own
- * isolation unit -- separate cookies/storage/cache per context) plus its
- * one page, which is what plan §7's "isolated context/session · page
- * creation" already asks for; nothing here re-derives isolation Playwright
- * already gives structurally.
+ * §7 launch/isolated-context/page creation, a thin wrapper over Playwright
+ * (see PROPOSAL-B-playwright-for-browser-runtime.md for why Playwright over
+ * raw CDP). One `BrowserSession` = one Playwright `BrowserContext` (its own
+ * isolation unit) plus its one page.
  *
- * Deliberately does NOT itself turn browser-session launch into Evidence.
- * `BrowserSessionHandle` (`execution.ts`) already carries `sessionId` /
- * `targetUrl` / `startedAt` / `endedAt` structurally on `Execution`, the
- * same relationship `ProcessHandle` has to process lifecycle --
- * `backend-observation/collector.ts` declared that an equivalent non-goal
- * for `ProcessCollector`, for the identical reason: whether session
- * lifecycle becomes Evidence at all is an orchestration-layer question,
- * not this seam's. Both non-goals now have an answer, in each package's
- * own collector — `createProcessCollector` (`@descryy/runtime-controller`)
- * and `BrowserActionCollector.start()` (`browser-action-collector.ts`,
- * PAGE_CREATED) — never here. `startedAt` is captured below only so that
- * answer has a real creation timestamp to report rather than "whenever a
- * collector got around to starting."
+ * Deliberately does NOT turn session launch into Evidence -- that's a
+ * collector's job (`createProcessCollector` for process lifecycle;
+ * `BrowserActionCollector.start()`'s PAGE_CREATED for this), never this
+ * module's. `startedAt` is captured below only so that answer has a real
+ * creation timestamp to report.
  */
 import { chromium } from "playwright-core";
 import { randomUUID } from "node:crypto";
@@ -30,10 +18,9 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 export const CHROMIUM_INSTALL_REMEDY = "npx playwright install chromium";
 /**
- * Resolved at launch time, deliberately not at import time. A module-level
- * check would make merely importing this package fail on a machine with no
- * browser -- including for a consumer that imports it only to read a type,
- * which is the exact cost `playwright-core` was adopted to remove.
+ * Resolved at launch time, not import time -- a module-level check would
+ * fail merely importing this package on a machine with no browser, the
+ * exact cost `playwright-core` was adopted to remove.
  */
 export function resolveChromiumExecutable() {
     const executablePath = chromium.executablePath();
@@ -62,10 +49,10 @@ export class BrowserUnavailableError extends Error {
     }
 }
 /**
- * The refusal-returning launch. Prefer this wherever a missing browser is a
- * reportable outcome rather than a bug -- an MCP tool mapping it onto its own
- * `refused` state, for instance. `launchBrowserSession` below is the same
- * call for callers that would only rethrow.
+ * Refusal-returning launch. Prefer this where a missing browser is a
+ * reportable outcome, not a bug (e.g. an MCP tool's `refused` state).
+ * `launchBrowserSession` below is the same call for callers that would
+ * only rethrow.
  */
 export async function launchBrowserSessionOrRefuse(options = {}) {
     const chromiumBinary = resolveChromiumExecutable();
@@ -86,11 +73,8 @@ export async function launchBrowserSession(options = {}) {
 async function launchWithExecutable(options, executablePath) {
     const browser = await chromium.launch({ headless: options.headless ?? true, executablePath });
     const sessionId = randomUUID();
-    // A session-scoped temp dir, never a caller-supplied path -- see
-    // `BrowserConfiguration.recordVideo`'s own comment on why only the toggle
-    // is exposed. Created before newContext() because Playwright's
-    // `recordVideo.dir` must already exist and be known at context-creation
-    // time; there is no way to attach recording after the fact.
+    // session-scoped temp dir, never caller-supplied (see BrowserConfiguration.recordVideo).
+    // created before newContext(): Playwright's recordVideo.dir must exist and be known at context-creation time.
     const videoDir = options.recordVideo === true ? await mkdtemp(join(tmpdir(), `descry-video-${sessionId}-`)) : null;
     const context = await browser.newContext(videoDir !== null ? { recordVideo: { dir: videoDir } } : {});
     const page = await context.newPage();
@@ -117,17 +101,13 @@ async function launchWithExecutable(options, executablePath) {
                     "method does not itself perform). Call session.close() first.");
             }
             const video = page.video();
-            // Should not happen given videoDir !== null above (recordVideo was
-            // requested, so Playwright always attaches a Video to a page created
-            // under that context) -- guarded rather than asserted with `!`,
-            // because a null here would otherwise surface as a confusing crash
-            // inside readFile(undefined) instead of a clear "nothing to return."
+            // shouldn't happen (recordVideo requested implies Playwright attaches a Video) -- guarded rather
+            // than asserted with `!`, since a null here would otherwise surface as a confusing crash.
             if (video === null)
                 return null;
             const videoFilePath = await video.path();
             const bytes = await readFile(videoFilePath);
-            // Best-effort: the bytes are already safely captured above, so a
-            // cleanup failure here (e.g. already removed) must not fail the call.
+            // best-effort: bytes are already captured, so a cleanup failure here must not fail the call.
             await rm(videoDir, { recursive: true, force: true }).catch(() => { });
             return bytes;
         },

package/dist/browser-session.js.map

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

package/dist/collector-version.d.ts

@@ -1,10 +1,7 @@
 /**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
+ * `Evidence.collectorVersion` source: reads this package's own package.json
+ * "version" instead of a hand-duplicated string that can drift. Same idea
+ * as `nodeVersion` using `process.version`.
  */
 export declare const COLLECTOR_VERSION: string;
 //# sourceMappingURL=collector-version.d.ts.map

package/dist/collector-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}
+{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}

package/dist/collector-version.js

@@ -1,10 +1,7 @@
 /**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
+ * `Evidence.collectorVersion` source: reads this package's own package.json
+ * "version" instead of a hand-duplicated string that can drift. Same idea
+ * as `nodeVersion` using `process.version`.
  */
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);

package/dist/collector-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}
+{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}

package/dist/dom-evidence.d.ts

@@ -1,10 +1,7 @@
 /**
- * §8's DOM evidence bucket: "relevant element · selector/locator · text/
- * value when safe · accessibility information when useful." Captured
- * alongside an action (click/type/wait) rather than as its own streamed
- * event type -- the frozen `RuntimeEventType` vocabulary has no dedicated
- * DOM-snapshot type, and a DOM fact is naturally "what did the element
- * this action touched look like," not an independent stream.
+ * DOM evidence for an action (§8): element/selector/text/value/a11y info.
+ * Captured alongside the action, not as its own event type -- no dedicated
+ * DOM-snapshot type exists in `RuntimeEventType`.
  */
 import type { Page } from "playwright-core";
 export interface DomElementSnapshot {

package/dist/dom-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-evidence.d.ts","sourceRoot":"","sources":["../src/dom-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAWD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAetG"}
+{"version":3,"file":"dom-evidence.d.ts","sourceRoot":"","sources":["../src/dom-evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAWD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAetG"}

package/dist/dom-evidence.js

@@ -1,10 +1,7 @@
 /**
- * §8's DOM evidence bucket: "relevant element · selector/locator · text/
- * value when safe · accessibility information when useful." Captured
- * alongside an action (click/type/wait) rather than as its own streamed
- * event type -- the frozen `RuntimeEventType` vocabulary has no dedicated
- * DOM-snapshot type, and a DOM fact is naturally "what did the element
- * this action touched look like," not an independent stream.
+ * DOM evidence for an action (§8): element/selector/text/value/a11y info.
+ * Captured alongside the action, not as its own event type -- no dedicated
+ * DOM-snapshot type exists in `RuntimeEventType`.
  */
 const VALUE_BEARING_TAGS = new Set(["input", "textarea", "select"]);
 async function safeValue(locator, tagName) {

package/dist/dom-evidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom-evidence.js","sourceRoot":"","sources":["../src/dom-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEpE,KAAK,UAAU,SAAS,CAAC,OAAgB,EAAE,OAAsB;IAC/D,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAU,EAAE,QAAgB;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,qBAAqB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7D,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QACvC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;AACnE,CAAC"}
+{"version":3,"file":"dom-evidence.js","sourceRoot":"","sources":["../src/dom-evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEpE,KAAK,UAAU,SAAS,CAAC,OAAgB,EAAE,OAAsB;IAC/D,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAU,EAAE,QAAgB;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,qBAAqB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7D,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QACvC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;AACnE,CAAC"}

package/dist/frontend-initiator-capture.d.ts

@@ -1,87 +1,52 @@
 /**
- * Fetch-initiator capture — the page-side half of resolving *which*
- * frontend function issued an observed request, not merely which functions
- * the graph says are capable of it (`resolveFrontendCallers`'s own
- * structural limit, `@descryy/runtime-graph-correlator`).
+ * Fetch-initiator capture: page-side half of resolving which frontend
+ * function issued an observed request (structural capability alone is
+ * `resolveFrontendCallers`'s job, in `@descryy/runtime-graph-correlator`).
  *
- * **This is a write, not a read**, in the sense
- * `PROPOSAL-code-injection-into-observed-processes.md` asks every injection
- * mechanism to state for itself: the wrapped `fetch()` adds a real header
- * (`x-descry-initiator-id`) to a real outgoing request. That line does not
- * run when Descry is not attached — a same-origin request can pick up a
- * fresh CORS preflight it would not otherwise have had. That side effect is
- * the one `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md`
- * asked a human to sign off on before this was built; nothing here reopens
- * that call.
+ * This is a write, not a read: the wrapped fetch() adds a real header
+ * (`x-descry-initiator-id`) to a real outgoing request, which can trigger a
+ * fresh CORS preflight on a same-origin request. Signed off in
+ * `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md`.
  *
- * The call-site stack itself never travels over the wire that carries the
- * application's own traffic — only a short, opaque per-call id does, as the
- * header value. The stack text instead travels over Playwright's own CDP
- * binding channel (`page.exposeFunction`), straight to `take()` below,
- * keyed by that same id.
+ * The call-site stack never travels with application traffic -- only an
+ * opaque per-call id does, as the header value. The stack text travels
+ * over Playwright's CDP binding (`page.exposeFunction`) to `take()` below.
  *
- * **Why the real `fetch()` is held until the exposed call returns.** Firing
- * the buffering call and the real request concurrently would make
- * correctness depend on which of two independent async channels — the CDP
- * binding call, and Chromium's own network stack — happens to land at this
- * process first. That is exactly the kind of timing assumption §27's
- * "similarity must never be treated as causality" rules out. Awaiting the
- * binding call before dispatching `fetch` makes the ordering true by
- * construction instead: the real request cannot be sent until this module
- * has already buffered the stack it will be looked up by.
+ * The real fetch() is held until the exposed call returns, so ordering is
+ * true by construction rather than a race between the CDP binding and
+ * Chromium's network stack (§27: never treat timing as causality).
  *
- * Chromium only — `page.addInitScript` + `page.exposeFunction` is the
- * mechanism, and no non-CDP-based engine here exposes an equivalent pair.
- * `fetch()` only, not `XMLHttpRequest`. Both boundaries are the scope
- * `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md` drew, not
- * an oversight of this module.
+ * Chromium only (`page.addInitScript`/`page.exposeFunction`), fetch() only
+ * (not XMLHttpRequest) -- scope drawn by the proposal above, not an
+ * oversight.
  */
 import type { Page } from "playwright-core";
 export declare const INITIATOR_HEADER_NAME = "x-descry-initiator-id";
 export interface FrontendInitiatorCapture {
     /**
-     * Wraps `window.fetch` in every document this page loads from this point
-     * forward — `page.addInitScript`'s own contract: it does not retroactively
-     * reach a document already loaded. Call before navigating to whatever the
-     * caller wants covered, exactly like `BrowserConsoleCollector`'s own
-     * `page.on(...)` registration ordering.
+     * Wraps window.fetch in every document from this point forward --
+     * addInitScript doesn't reach an already-loaded document. Call before
+     * navigating, same ordering as BrowserConsoleCollector's page.on(...).
      */
     install(page: Page): Promise<void>;
     /**
-     * Pops the buffered raw `Error.stack` text captured for `id`, or
-     * `undefined` — the header never reached this collector, the id was never
-     * issued by this capture (a stale id, a different page), or the buffer
-     * evicted it under `MAX_BUFFERED_STACKS`. Popped rather than peeked: a
-     * captured stack is consumed by the one request it was captured for, and
-     * leaving it behind would let a second, unrelated lookup of a reused id
-     * (impossible by construction here, but not worth relying on) read
-     * another request's call site.
+     * Pops the buffered stack for `id`, or undefined if never captured or
+     * evicted. Popped not peeked: a captured stack belongs to one request.
      */
     take(id: string): string | undefined;
 }
 export declare function createFrontendInitiatorCapture(): FrontendInitiatorCapture;
 /**
- * Strips `descryFetch`'s own frame from a raw V8 stack, so the remaining
- * text's first frame is the real call site rather than this module's own
- * wrapper.
+ * Strips descryFetch's own frame from a raw V8 stack so the first
+ * remaining frame is the real call site.
  *
- * **Why this can be a fixed "drop the first frame line" rule rather than a
- * search for a named function.** `new Error().stack` is captured
- * synchronously, as the wrapper's first statement — before the `await`-
- * shaped `.then(dispatch)` chain below it ever runs. V8's stack is built
- * from the synchronous call chain live at capture time, so the innermost
- * frame is deterministically `descryFetch` itself, every time, regardless
- * of what called it. Stripping by *position* (first frame line) rather than
- * by *name* also survives minification of this wrapper's own name, which a
- * name-based strip would not.
+ * Works as a fixed "drop first line" rule rather than a name search:
+ * Error().stack is captured synchronously as the wrapper's first statement,
+ * so the innermost frame is always descryFetch regardless of caller --
+ * stripping by position also survives minification of the wrapper's name.
  *
- * Applied to raw text, before parsing — same reasoning
- * `rewriteScriptUrls`'s own doc gives for rewriting before rather than
- * after: `createV8StackTraceParser` already treats frame 0 of whatever it
- * receives as `primaryFrameIndex`, so removing the wrapper's line here
- * means the parser's existing, already-tested convention does the right
- * thing unmodified, instead of teaching every consumer a second index to
- * skip.
+ * Applied to raw text before parsing, so createV8StackTraceParser's
+ * existing primaryFrameIndex convention (frame 0) just works.
  */
 export declare function stripInitiatorWrapperFrame(rawStackText: string): string;
 //# sourceMappingURL=frontend-initiator-capture.d.ts.map

package/dist/frontend-initiator-capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-initiator-capture.d.ts","sourceRoot":"","sources":["../src/frontend-initiator-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAc7D,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,8BAA8B,IAAI,wBAAwB,CAsBzE;AA4CD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKvE"}
+{"version":3,"file":"frontend-initiator-capture.d.ts","sourceRoot":"","sources":["../src/frontend-initiator-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAW7D,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,8BAA8B,IAAI,wBAAwB,CAsBzE;AAsCD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKvE"}

package/dist/frontend-initiator-capture.js

@@ -1,49 +1,30 @@
 /**
- * Fetch-initiator capture — the page-side half of resolving *which*
- * frontend function issued an observed request, not merely which functions
- * the graph says are capable of it (`resolveFrontendCallers`'s own
- * structural limit, `@descryy/runtime-graph-correlator`).
+ * Fetch-initiator capture: page-side half of resolving which frontend
+ * function issued an observed request (structural capability alone is
+ * `resolveFrontendCallers`'s job, in `@descryy/runtime-graph-correlator`).
  *
- * **This is a write, not a read**, in the sense
- * `PROPOSAL-code-injection-into-observed-processes.md` asks every injection
- * mechanism to state for itself: the wrapped `fetch()` adds a real header
- * (`x-descry-initiator-id`) to a real outgoing request. That line does not
- * run when Descry is not attached — a same-origin request can pick up a
- * fresh CORS preflight it would not otherwise have had. That side effect is
- * the one `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md`
- * asked a human to sign off on before this was built; nothing here reopens
- * that call.
+ * This is a write, not a read: the wrapped fetch() adds a real header
+ * (`x-descry-initiator-id`) to a real outgoing request, which can trigger a
+ * fresh CORS preflight on a same-origin request. Signed off in
+ * `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md`.
  *
- * The call-site stack itself never travels over the wire that carries the
- * application's own traffic — only a short, opaque per-call id does, as the
- * header value. The stack text instead travels over Playwright's own CDP
- * binding channel (`page.exposeFunction`), straight to `take()` below,
- * keyed by that same id.
+ * The call-site stack never travels with application traffic -- only an
+ * opaque per-call id does, as the header value. The stack text travels
+ * over Playwright's CDP binding (`page.exposeFunction`) to `take()` below.
  *
- * **Why the real `fetch()` is held until the exposed call returns.** Firing
- * the buffering call and the real request concurrently would make
- * correctness depend on which of two independent async channels — the CDP
- * binding call, and Chromium's own network stack — happens to land at this
- * process first. That is exactly the kind of timing assumption §27's
- * "similarity must never be treated as causality" rules out. Awaiting the
- * binding call before dispatching `fetch` makes the ordering true by
- * construction instead: the real request cannot be sent until this module
- * has already buffered the stack it will be looked up by.
+ * The real fetch() is held until the exposed call returns, so ordering is
+ * true by construction rather than a race between the CDP binding and
+ * Chromium's network stack (§27: never treat timing as causality).
  *
- * Chromium only — `page.addInitScript` + `page.exposeFunction` is the
- * mechanism, and no non-CDP-based engine here exposes an equivalent pair.
- * `fetch()` only, not `XMLHttpRequest`. Both boundaries are the scope
- * `PROPOSAL-observed-frontend-caller-needs-initiator-capture.md` drew, not
- * an oversight of this module.
+ * Chromium only (`page.addInitScript`/`page.exposeFunction`), fetch() only
+ * (not XMLHttpRequest) -- scope drawn by the proposal above, not an
+ * oversight.
  */
 export const INITIATOR_HEADER_NAME = "x-descry-initiator-id";
 /**
- * Bound on stacks buffered but never claimed. Without it, every request
- * whose id is never looked up — the header stripped in transit, a page that
- * never triggers a matching `onRequest` at all — would grow this map for
- * the entire life of the page. FIFO eviction via `Map`'s own insertion
- * order; a stack this old was never going to be claimed by the time
- * something newer needs the room.
+ * Cap on stacks buffered but never claimed (stripped header, no matching
+ * request) -- otherwise this map grows for the page's whole life. FIFO
+ * eviction via Map's own insertion order.
  */
 const MAX_BUFFERED_STACKS = 2000;
 const CAPTURE_BINDING_NAME = "__descryCaptureInitiatorStack";
@@ -70,16 +51,10 @@ export function createFrontendInitiatorCapture() {
     };
 }
 /**
- * The injected wrapper, as a plain string — `page.addInitScript`'s
- * string form, so this never needs its own transpilation step and runs
- * exactly as written in the page's own JS engine, not this process's.
- *
- * Every call site outcome degrades to "no id header" or "no functionName"
- * rather than throwing: `bind(...)` is wrapped in its own `.catch`, and a
- * `fetch()` whose `input` is neither a string, `URL`, nor `Request` still
- * reaches `originalFetch` unmodified so the native `TypeError` a caller
- * would have gotten anyway is the one they still get — this wrapper adds a
- * header, it does not change what counts as a valid `fetch()` call.
+ * Injected wrapper as a plain string (addInitScript's string form; runs
+ * unmodified in the page's own JS engine). Failures degrade silently:
+ * bind() is wrapped in .catch, and a non-string/URL/Request fetch input
+ * still reaches originalFetch unmodified, so callers get their normal error.
  */
 function initScriptSource() {
     return `(() => {
@@ -110,27 +85,16 @@ function initScriptSource() {
 }
 const FRAME_LINE = /^\s*at\s/;
 /**
- * Strips `descryFetch`'s own frame from a raw V8 stack, so the remaining
- * text's first frame is the real call site rather than this module's own
- * wrapper.
+ * Strips descryFetch's own frame from a raw V8 stack so the first
+ * remaining frame is the real call site.
  *
- * **Why this can be a fixed "drop the first frame line" rule rather than a
- * search for a named function.** `new Error().stack` is captured
- * synchronously, as the wrapper's first statement — before the `await`-
- * shaped `.then(dispatch)` chain below it ever runs. V8's stack is built
- * from the synchronous call chain live at capture time, so the innermost
- * frame is deterministically `descryFetch` itself, every time, regardless
- * of what called it. Stripping by *position* (first frame line) rather than
- * by *name* also survives minification of this wrapper's own name, which a
- * name-based strip would not.
+ * Works as a fixed "drop first line" rule rather than a name search:
+ * Error().stack is captured synchronously as the wrapper's first statement,
+ * so the innermost frame is always descryFetch regardless of caller --
+ * stripping by position also survives minification of the wrapper's name.
  *
- * Applied to raw text, before parsing — same reasoning
- * `rewriteScriptUrls`'s own doc gives for rewriting before rather than
- * after: `createV8StackTraceParser` already treats frame 0 of whatever it
- * receives as `primaryFrameIndex`, so removing the wrapper's line here
- * means the parser's existing, already-tested convention does the right
- * thing unmodified, instead of teaching every consumer a second index to
- * skip.
+ * Applied to raw text before parsing, so createV8StackTraceParser's
+ * existing primaryFrameIndex convention (frame 0) just works.
  */
 export function stripInitiatorWrapperFrame(rawStackText) {
     const lines = rawStackText.split(/\r\n|\r|\n/);

package/dist/frontend-initiator-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-initiator-capture.js","sourceRoot":"","sources":["../src/frontend-initiator-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAwB7D,MAAM,UAAU,8BAA8B;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,SAAS,MAAM,CAAC,EAAU,EAAE,SAAiB;QAC3C,IAAI,QAAQ,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC5C,IAAI,MAAM,KAAK,SAAS;gBAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAU;YACtB,MAAM,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YACxD,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,EAAU;YACb,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB;IACvB,OAAO;;;0BAGiB,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;sBAaxC,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;;;;;;;;QAQnD,CAAC;AACT,CAAC;AAED,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC;IAC3C,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC"}
+{"version":3,"file":"frontend-initiator-capture.js","sourceRoot":"","sources":["../src/frontend-initiator-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAgB7D,MAAM,UAAU,8BAA8B;IAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,SAAS,MAAM,CAAC,EAAU,EAAE,SAAiB;QAC3C,IAAI,QAAQ,CAAC,IAAI,IAAI,mBAAmB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC5C,IAAI,MAAM,KAAK,SAAS;gBAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAU;YACtB,MAAM,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YACxD,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,EAAU;YACb,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB;IACvB,OAAO;;;0BAGiB,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;sBAaxC,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;;;;;;;;QAQnD,CAAC;AACT,CAAC;AAED,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC;IAC3C,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC"}

package/dist/network-correlation.d.ts

@@ -1,11 +1,8 @@
 /**
- * Correlation-id extraction from real HTTP headers (structured access, not
- * text regex) -- covers the top three levels of plan §10's six-level
- * preference order: trace ID, request ID, W3C trace context. Direct header
- * access makes the W3C case cheap here in a way it wasn't for
- * `backend-observation`'s `extractCorrelationIds`, which only ever sees
- * unstructured log text and explicitly cuts W3C parsing as a documented
- * V1 gap -- this collector doesn't need that same cut.
+ * Correlation-id extraction from HTTP headers -- top three of §10's six
+ * levels (trace ID, request ID, W3C trace context). Structured header
+ * access makes W3C parsing cheap here, unlike `backend-observation`'s
+ * `extractCorrelationIds` (log-text only, documents W3C as a V1 gap).
  */
 export interface HeaderCorrelationIds {
     readonly traceId: string | null;

package/dist/network-correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-correlation.d.ts","sourceRoot":"","sources":["../src/network-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}
+{"version":3,"file":"network-correlation.d.ts","sourceRoot":"","sources":["../src/network-correlation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}

package/dist/network-correlation.js

@@ -1,11 +1,8 @@
 /**
- * Correlation-id extraction from real HTTP headers (structured access, not
- * text regex) -- covers the top three levels of plan §10's six-level
- * preference order: trace ID, request ID, W3C trace context. Direct header
- * access makes the W3C case cheap here in a way it wasn't for
- * `backend-observation`'s `extractCorrelationIds`, which only ever sees
- * unstructured log text and explicitly cuts W3C parsing as a documented
- * V1 gap -- this collector doesn't need that same cut.
+ * Correlation-id extraction from HTTP headers -- top three of §10's six
+ * levels (trace ID, request ID, W3C trace context). Structured header
+ * access makes W3C parsing cheap here, unlike `backend-observation`'s
+ * `extractCorrelationIds` (log-text only, documents W3C as a V1 gap).
  */
 // W3C Trace Context: "00-<32 hex trace-id>-<16 hex parent-id>-<2 hex flags>".
 const TRACEPARENT_PATTERN = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;

package/dist/network-correlation.js.map

@@ -1 +1 @@
-{"version":3,"file":"network-correlation.js","sourceRoot":"","sources":["../src/network-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"network-correlation.js","sourceRoot":"","sources":["../src/network-correlation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/script-url-mapping.d.ts

@@ -1,29 +1,18 @@
 /**
- * RT-023's collector half: rewriting a browser script URL to the on-disk
- * file it was served from, so a page-error stack can be parsed into real
- * `SourceLocation`s instead of preserved as text.
+ * RT-023 collector half: rewrites a script URL to its on-disk file so a
+ * page-error stack parses into real `SourceLocation`s instead of text.
  *
- * **The rewrite happens on the stack text, before parsing, deliberately.**
- * A `StackTraceParser` and its `SourceLocationResolver` already know how to
- * turn `at f (/abs/path.js:12:5)` into a resolved location — including
- * source-map handling and staleness detection, which took real work to get
- * right. Rewriting the URL first lets all of that apply unchanged, where
- * post-processing parsed frames would mean reimplementing it here and
- * keeping two copies honest.
+ * Rewrite happens on the stack text before parsing, so the existing
+ * `StackTraceParser`/`SourceLocationResolver` (source maps, staleness)
+ * apply unchanged rather than being reimplemented here.
  *
- * **What this can and cannot claim.** `CollectorContext.resolveSourceRoot`
- * answers "which service's declared root does this origin belong to", and
- * `ConfiguredServiceRoot.declaredCwd` is named for what it is: configured,
- * not verified. So a successful rewrite proves the origin maps to a
- * directory — **not** that the file the browser executed came from the
- * checkout in it. The downstream resolver's own existence check is the real
- * refusal point, and an unmapped or non-existent path degrades to the URL
- * itself rather than to a fabricated file. That is RT-031's class again:
- * a match on an observable proxy is not proof of the underlying identity.
+ * A successful rewrite proves the origin maps to a directory, not that the
+ * executed file came from that checkout (`declaredCwd` is configured, not
+ * verified) -- the downstream resolver's existence check is the real
+ * refusal point. RT-031's class: a match on a proxy isn't proof of identity.
  *
- * Nothing is rewritten when the resolver refuses, when it is absent, or
- * when the URL is not one this execution spawned — a CDN script, a browser
- * extension, `about:blank`. Those are routine, not failures.
+ * Nothing is rewritten when the resolver refuses, is absent, or the URL
+ * wasn't spawned by this execution (CDN script, extension, `about:blank`).
  */
 import type { ServiceRootLookup } from "@descryy/runtime-contracts";
 export type SourceRootResolver = (origin: string) => ServiceRootLookup;

package/dist/script-url-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-url-mapping.d.ts","sourceRoot":"","sources":["../src/script-url-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,iBAAiB,CAAC;AAKvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4GAA4G;IAC5G,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CACxH;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAAG,gBAAgB,CAoExH"}
+{"version":3,"file":"script-url-mapping.d.ts","sourceRoot":"","sources":["../src/script-url-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,iBAAiB,CAAC;AAKvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4GAA4G;IAC5G,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CACxH;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAAG,gBAAgB,CAkDxH"}

package/dist/script-url-mapping.js

@@ -1,29 +1,18 @@
 /**
- * RT-023's collector half: rewriting a browser script URL to the on-disk
- * file it was served from, so a page-error stack can be parsed into real
- * `SourceLocation`s instead of preserved as text.
+ * RT-023 collector half: rewrites a script URL to its on-disk file so a
+ * page-error stack parses into real `SourceLocation`s instead of text.
  *
- * **The rewrite happens on the stack text, before parsing, deliberately.**
- * A `StackTraceParser` and its `SourceLocationResolver` already know how to
- * turn `at f (/abs/path.js:12:5)` into a resolved location — including
- * source-map handling and staleness detection, which took real work to get
- * right. Rewriting the URL first lets all of that apply unchanged, where
- * post-processing parsed frames would mean reimplementing it here and
- * keeping two copies honest.
+ * Rewrite happens on the stack text before parsing, so the existing
+ * `StackTraceParser`/`SourceLocationResolver` (source maps, staleness)
+ * apply unchanged rather than being reimplemented here.
  *
- * **What this can and cannot claim.** `CollectorContext.resolveSourceRoot`
- * answers "which service's declared root does this origin belong to", and
- * `ConfiguredServiceRoot.declaredCwd` is named for what it is: configured,
- * not verified. So a successful rewrite proves the origin maps to a
- * directory — **not** that the file the browser executed came from the
- * checkout in it. The downstream resolver's own existence check is the real
- * refusal point, and an unmapped or non-existent path degrades to the URL
- * itself rather than to a fabricated file. That is RT-031's class again:
- * a match on an observable proxy is not proof of the underlying identity.
+ * A successful rewrite proves the origin maps to a directory, not that the
+ * executed file came from that checkout (`declaredCwd` is configured, not
+ * verified) -- the downstream resolver's existence check is the real
+ * refusal point. RT-031's class: a match on a proxy isn't proof of identity.
  *
- * Nothing is rewritten when the resolver refuses, when it is absent, or
- * when the URL is not one this execution spawned — a CDN script, a browser
- * extension, `about:blank`. Those are routine, not failures.
+ * Nothing is rewritten when the resolver refuses, is absent, or the URL
+ * wasn't spawned by this execution (CDN script, extension, `about:blank`).
  */
 import { statSync } from "node:fs";
 import { join } from "node:path";
@@ -35,9 +24,7 @@ export function rewriteScriptUrls(stackText, resolveSourceRoot) {
     }
     const outcomes = [];
     const text = stackText.replace(SCRIPT_URL, (match) => {
-        // Strip the stack's own `:line:column` suffix before treating the rest
-        // as a URL — `new URL()` would otherwise parse `:12` as part of the
-        // path and produce a file that never existed.
+        // strip the stack's ":line:column" suffix first -- new URL() would parse ":12" as part of the path.
         const suffix = /:(\d+):(\d+)$/.exec(match);
         const urlText = suffix === null ? match : match.slice(0, match.length - suffix[0].length);
         let url;
@@ -53,24 +40,12 @@ export function rewriteScriptUrls(stackText, resolveSourceRoot) {
             outcomes.push({ url: match, mapped: null, reason: lookup.message });
             return match;
         }
-        // `url.pathname` is always absolute; `join` would otherwise treat a
-        // leading slash as a fresh root and discard the service's own cwd.
+        // url.pathname is always absolute; join would otherwise treat the leading slash as a fresh root and drop declaredCwd.
         const candidate = join(lookup.root.declaredCwd, url.pathname.replace(/^\/+/, ""));
-        // **`isFile()`, not `existsSync` — and the difference is not pedantry.**
-        // An inline `<script>` on a page served at `/` produces frames V8 names
-        // after the *document* URL, whose pathname is `/` and nothing else. That
-        // joins to `declaredCwd` itself: a real directory, so `existsSync` said
-        // yes and this function rewrote a stack frame to a directory no browser
-        // ever executed. The downstream `SourceLocationResolver` then reached
-        // `readFileSync(directory)`, threw `EISDIR`, and the whole
-        // `NETWORK_REQUEST` row was lost with it — an observation discarded to
-        // protect a nullable field. `statSync` answers the question that was
-        // always being asked (is there a FILE here?) rather than the weaker one
-        // that happened to be cheap.
-        //
-        // `statSync` throws on a missing path where `existsSync` returned false,
-        // so the absence case is caught rather than propagated: both branches end
-        // in the same refusal, with the reason naming which one it was.
+        // isFile(), not existsSync: an inline <script> on a page served at "/" resolves to declaredCwd
+        // itself -- a real directory, so existsSync said yes and readFileSync(directory) threw EISDIR,
+        // dropping the whole NETWORK_REQUEST row. statSync also catches the missing-path case, so both
+        // branches end in the same refusal, with the reason naming which one it was.
         let isFile;
         try {
             isFile = statSync(candidate).isFile();
@@ -80,11 +55,7 @@ export function rewriteScriptUrls(stackText, resolveSourceRoot) {
             return match;
         }
         if (!isFile) {
-            // The origin maps to a root and the pathname points at something that
-            // is not a file in it — a directory (the `/` case above), a socket, a
-            // device. Reported rather than rewritten: a path that is not a source
-            // file is worse than the URL, which at least says truthfully where the
-            // browser got it.
+            // not a file (dir/socket/device) -- reported rather than rewritten, since that's worse than the honest URL.
             outcomes.push({ url: match, mapped: null, reason: `resolved to "${candidate}", which is not a file on disk` });
             return match;
         }

package/dist/script-url-mapping.js.map

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

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@descryy/runtime-browser",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Browser runtime: launch, isolated context, navigation, click/type/wait, DOM inspection, screenshots, console/page-error/network capture, all through the Collector contract (plan \u00a77/\u00a78). See documents/decisions-inbox/PROPOSAL-B-playwright-for-browser-runtime.md for the Playwright-vs-CDP call.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-runtime.git",
+    "directory": "packages/browser"
+  },
   "engines": {
     "node": ">=22.5"
   },
@@ -24,10 +29,10 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.2.0",
-    "@descryy/runtime-backend-observation": "0.2.0",
+    "@descryy/runtime-contracts": "0.3.0",
+    "@descryy/runtime-backend-observation": "0.3.0",
     "playwright-core": "^1.62.1",
-    "@descryy/runtime-adapter-typescript": "0.2.0"
+    "@descryy/runtime-adapter-typescript": "0.3.0"
   },
   "devDependencies": {
     "@descryy/runtime-controller": "*",