@descryy/runtime-browser 0.2.0 → 0.4.0

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"}