@miller-tech/uap 1.170.0 → 1.172.0

package/dist/delivery/interaction/watchdog.js

@@ -0,0 +1,210 @@
+/**
+ * Interaction watchdog — invariants that hold for EVERY probe, checked
+ * independently of what any individual probe asserts.
+ *
+ * Probes prove the promised behaviour. The watchdog catches the failures nobody
+ * thought to write a probe for: the loop stops ticking, an uncaught error fires,
+ * a tracked number goes NaN, a collection grows without bound. Tonight's fatal
+ * defect (`player.takeDamage is not a function`) is exactly the first class —
+ * one uncaught throw, the rAF loop never rescheduled, and every later frame was
+ * a frozen copy of the last good one, which no screenshot can distinguish from a
+ * paused game.
+ */
+/**
+ * Injected before any page script runs. Wraps requestAnimationFrame to count
+ * ticks and records uncaught errors. Deliberately defensive: a page that
+ * replaces rAF or throws during setup must not break the watchdog itself.
+ *
+ * SELF-INVOKED — `addInitScript` evaluates the string as source, so a bare
+ * function expression would construct a function and discard it. That mistake
+ * is invisible at runtime: the counters simply never appear, every sample falls
+ * back to `ticks: 0`, `everTicked` stays false and `loopAlive` is unconditionally
+ * true — the frozen-loop detection this gate exists for silently never fires.
+ * Matches RAF_INSTRUMENT in execution-gate.ts, which is self-invoked for the
+ * same reason.
+ */
+export const DEFAULT_WATCH_GLOBAL = '__uapWatch';
+/**
+ * Build the init script under a caller-chosen global name.
+ *
+ * The name is randomised per run because the page can otherwise DEFEAT its own
+ * watchdog: `window.__uapWatch = {ticks: 1e9, errors: []}` forges liveness and
+ * empties the error list, and the `if (already defined) return` guard means a
+ * page that predefines the global blocks instrumentation outright. Randomising
+ * is not a security boundary — it raises the cost of a targeted forge, while
+ * the authoritative error channel remains Playwright-side, out of page reach.
+ */
+export function buildWatchdogInitScript(globalName = DEFAULT_WATCH_GLOBAL) {
+    return WATCHDOG_INIT_SCRIPT.split(DEFAULT_WATCH_GLOBAL).join(globalName);
+}
+export const WATCHDOG_INIT_SCRIPT = `(function () {
+  try {
+    if (window.__uapWatch) return;
+    var w = { ticks: 0, errors: [], startedAt: Date.now() };
+    window.__uapWatch = w;
+    var raf = window.requestAnimationFrame;
+    if (typeof raf === 'function') {
+      window.requestAnimationFrame = function (cb) {
+        return raf.call(window, function (t) {
+          w.ticks++;
+          return cb(t);
+        });
+      };
+    }
+    window.addEventListener('error', function (e) {
+      try { w.errors.push('uncaught: ' + (e && e.message ? e.message : String(e))); } catch (x) {}
+    });
+    window.addEventListener('unhandledrejection', function (e) {
+      try { w.errors.push('unhandledrejection: ' + String(e && e.reason)); } catch (x) {}
+    });
+  } catch (x) {
+    /* the watchdog must never break the page it observes */
+  }
+})()`;
+/**
+ * Read one watchdog sample. `watchExprs` are artifact expressions yielding
+ * numbers (collection sizes, key state fields) — the miner supplies them, and
+ * each one that goes NaN or grows without bound becomes a defect.
+ */
+/**
+ * NaN cannot survive the JSON transport — `JSON.stringify(NaN)` is `null`, so a
+ * corrupted field arrives indistinguishable from "not present" and the NaN check
+ * can never fire in production. Encode it explicitly and decode on the way back.
+ */
+export const NAN_SENTINEL = '__uap_NaN__';
+export function watchdogSampleScript(watchExprs, globalName = DEFAULT_WATCH_GLOBAL) {
+    const entries = watchExprs
+        .map((e) => {
+        const key = JSON.stringify(e);
+        return `    try { var v = (${e}); vals[${key}] = (typeof v === 'number' && v !== v) ? ${JSON.stringify(NAN_SENTINEL)} : v; } catch (x) { vals[${key}] = null; }`;
+    })
+        .join('\n');
+    return `(function () {
+  var w = window[${JSON.stringify(globalName)}] || { ticks: 0, errors: [] };
+  var vals = {};
+${entries}
+  return JSON.stringify({ ticks: w.ticks, errors: w.errors.slice(0, 20), values: vals });
+})`;
+}
+export function parseWatchdogSample(raw) {
+    try {
+        const text = typeof raw === 'string' ? raw : JSON.stringify(raw);
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        const values = {};
+        for (const [k, v] of Object.entries(parsed.values ?? {})) {
+            values[k] = v === NAN_SENTINEL ? Number.NaN : v;
+        }
+        return {
+            ticks: Number(parsed.ticks) || 0,
+            errors: Array.isArray(parsed.errors) ? parsed.errors.map(String) : [],
+            values,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Does this expression observe the SIZE of a collection (vs a counter)? */
+export function isCollectionSize(expr) {
+    return /\.(length|size)\s*$/.test(expr) || /\.(length|size)\b/.test(expr);
+}
+/**
+ * Pure verdict from the observed samples. Kept free of IO so the interesting
+ * judgements are unit-testable without a browser.
+ */
+export function judgeWatchdog(samples, driverErrors = [], opts = {}) {
+    const minTicks = opts.minTicks ?? 1;
+    const growthFactor = opts.growthFactor ?? 20;
+    const growthFloor = opts.growthFloor ?? 500;
+    const errors = [...new Set([...samples.flatMap((s) => s.errors), ...driverErrors])];
+    const first = samples[0];
+    const last = samples[samples.length - 1];
+    const prev = samples.length >= 2 ? samples[samples.length - 2] : first;
+    // Ticks in the FINAL window: a loop that ran for two seconds and then died
+    // still has a large cumulative count, so only the last interval is evidence
+    // that it is alive NOW.
+    const ticksObserved = last && prev ? Math.max(0, last.ticks - prev.ticks) : 0;
+    // A page with no rAF at all (a form, a static doc) legitimately never ticks.
+    // Only claim the loop is dead when it demonstrably ticked earlier.
+    const everTicked = (last?.ticks ?? 0) > 0;
+    // TWO samples minimum. With one, `prev === last`, the delta is 0 by
+    // construction, and any artifact that ever ticked is declared dead — so a
+    // single dropped watchdog read would fail a perfectly healthy build. Liveness
+    // is a claim about change over time and needs two points to make.
+    const loopAlive = samples.length < 2 || !everTicked || ticksObserved >= minTicks;
+    // NaN over EVERY sample, not just the last. Judging only the final sample
+    // meant a field corrupted during any earlier probe was wiped by the next
+    // page reload and never seen — the check silently became "did the LAST probe
+    // produce NaN".
+    const nanSet = new Set();
+    for (const s of samples) {
+        for (const [key, v] of Object.entries(s.values)) {
+            if (typeof v === 'number' && Number.isNaN(v))
+                nanSet.add(key);
+        }
+    }
+    const nanFields = [...nanSet];
+    // Growth compared only WITHIN a contiguous segment: across a reload the
+    // start and end points belong to different runs of the artifact, so the
+    // comparison is meaningless (and a real leak measured over one short probe
+    // never crosses the floor).
+    const growth = new Map();
+    const bySegment = new Map();
+    for (const s of samples) {
+        const seg = s.segment ?? 0;
+        if (!bySegment.has(seg))
+            bySegment.set(seg, []);
+        bySegment.get(seg).push(s);
+    }
+    for (const group of bySegment.values()) {
+        const a = group[0];
+        const b = group[group.length - 1];
+        if (!a || !b || a === b)
+            continue;
+        for (const key of Object.keys(b.values)) {
+            // Growth means "a COLLECTION grew without bound". An ordinary counter —
+            // a score, a frame number, elapsed time — is supposed to climb, and
+            // flagging it reports a leak in a working game (observed: score 0 →
+            // 38 060 reported as unbounded growth). Only size-like observations
+            // qualify; every watched value is still checked for NaN.
+            if (!isCollectionSize(key))
+                continue;
+            const start = a.values[key];
+            const end = b.values[key];
+            if (typeof start === 'number' &&
+                typeof end === 'number' &&
+                !Number.isNaN(end) &&
+                end > growthFloor &&
+                end > Math.max(1, start) * growthFactor) {
+                growth.set(key, `${key}: ${start} → ${end}`);
+            }
+        }
+    }
+    const unboundedGrowth = [...growth.values()];
+    return { errors, loopAlive, ticksObserved, nanFields, unboundedGrowth };
+}
+/** True when the watchdog saw something that should fail the gate. */
+export function watchdogFailed(r) {
+    return r.errors.length > 0 || !r.loopAlive || r.nanFields.length > 0 || r.unboundedGrowth.length > 0;
+}
+export function watchdogSummary(r) {
+    const lines = [];
+    if (r.errors.length > 0) {
+        lines.push(`✗ runtime errors (${r.errors.length}): ${r.errors.slice(0, 5).join(' | ')}`);
+    }
+    if (!r.loopAlive) {
+        lines.push(`✗ the main loop STOPPED — ${r.ticksObserved} frame(s) in the final sampling window. ` +
+            `An uncaught error inside a requestAnimationFrame callback stops the loop being ` +
+            `rescheduled; every later frame is a frozen copy of the last good one, which looks ` +
+            `identical to a working paused screen in a screenshot.`);
+    }
+    if (r.nanFields.length > 0)
+        lines.push(`✗ NaN in tracked state: ${r.nanFields.join(', ')}`);
+    if (r.unboundedGrowth.length > 0) {
+        lines.push(`✗ unbounded growth (leak): ${r.unboundedGrowth.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=watchdog.js.map

package/dist/delivery/interaction/watchdog.js.map

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

package/dist/delivery/interaction/web-driver.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Web driver — drives a real headless browser with real pointer and key input.
+ *
+ * Deliberately uses coordinate-level mouse control rather than selector clicks:
+ * inside a <canvas> there are no elements to target, so aiming and firing only
+ * exist as pointer positions. A gate that can only click selectors cannot play a
+ * game, and "cannot play it" is indistinguishable from "it works".
+ */
+import { type InteractionDriver, type ReadResult } from './driver.js';
+import type { Step } from './types.js';
+/** The subset of WebBrowser the driver needs — keeps tests free of a browser. */
+export interface PointerBrowser {
+    launch(opts?: Record<string, unknown>): Promise<unknown>;
+    goto(url: string): Promise<string>;
+    waitForLoadState(state?: 'load' | 'domcontentloaded' | 'networkidle'): Promise<void>;
+    addInitScript(script: string): Promise<void>;
+    evaluate<T>(script: string): Promise<T>;
+    screenshot(path: string): Promise<void>;
+    getErrors(): Array<{
+        kind: string;
+        message: string;
+    }>;
+    mouseMove(x: number, y: number): Promise<void>;
+    mouseDown(): Promise<void>;
+    mouseUp(): Promise<void>;
+    mouseClick(x: number, y: number): Promise<void>;
+    press(key: string): Promise<void>;
+    viewportSize(): Promise<{
+        width: number;
+        height: number;
+    }>;
+    close(): Promise<void>;
+}
+export interface WebDriverOptions {
+    projectRoot: string;
+    /** Entry html path relative to the served root (default index.html). */
+    entry?: string;
+    /** Directory that becomes the server root (default: the project root). */
+    webRoot?: string;
+    browserFactory?: () => Promise<PointerBrowser>;
+    serverFactory?: (dir: string, entry: string) => Promise<{
+        url: string;
+        close: () => void;
+    }>;
+}
+export declare class WebInteractionDriver implements InteractionDriver {
+    private browser;
+    private server;
+    private readonly opts;
+    /** Last pointer position, so `down`/`up` act where the pointer actually is. */
+    private pointer;
+    private launched;
+    /** Per-run instrumentation global — see buildWatchdogInitScript. */
+    private readonly watchGlobal;
+    constructor(opts: WebDriverOptions);
+    start(): Promise<void>;
+    /**
+     * Reload the entry page. Init scripts are registered on the CONTEXT, so the
+     * watchdog re-installs automatically on the fresh document.
+     */
+    reset(): Promise<void>;
+    /** True once the browser is up — distinguishes infra failure from load failure. */
+    didLaunch(): boolean;
+    /** A probe may only navigate within the artifact's own served origin. */
+    private sameOrigin;
+    runStep(step: Step): Promise<void>;
+    /**
+     * Evaluate an observation. Wrapped in a function so `const`/`let` declared at
+     * the top level of a classic script — which live in the global LEXICAL scope
+     * and are NOT properties of `window` — are still readable. Reading these
+     * through `window.X` returns undefined, which silently turns every assertion
+     * into "undefined", so the wrapper matters.
+     */
+    read(expr: string): Promise<unknown>;
+    /**
+     * `ok: false` means the expression THREW or named something undefined — a
+     * broken probe, reported as such rather than as a behavioural failure.
+     * `undefined` reached by a resolving expression stays `ok: true`.
+     */
+    readDetailed(expr: string): Promise<ReadResult>;
+    inject(expr: string): Promise<void>;
+    /**
+     * GATING errors only: uncaught page exceptions.
+     *
+     * `console.error` output and failed sub-resource requests are common in
+     * working apps — a missing decorative asset or a handled-and-logged warning
+     * would otherwise hard-fail the behavioural gate. Both sibling gates already
+     * refuse to gate on them (execution-gate treats them as advisory;
+     * visual-gate filters to `pageerror`), and a gate that false-fails working
+     * builds gets switched off.
+     */
+    errors(): string[];
+    /** Sample the watchdog under this run's private global name. */
+    watchdogSample(watchExprs: string[]): Promise<unknown>;
+    /** Non-gating observations, surfaced in the report as context. */
+    advisoryErrors(): string[];
+    capture(path: string): Promise<void>;
+    stop(): Promise<void>;
+}
+/** Where probe evidence (screenshots) is written. */
+export declare function evidenceDir(projectRoot: string): string;
+//# sourceMappingURL=web-driver.d.ts.map

package/dist/delivery/interaction/web-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-driver.d.ts","sourceRoot":"","sources":["../../../src/delivery/interaction/web-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAS,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;CAC7F;AAOD,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,MAAM,CAAmD;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,+EAA+E;IAC/E,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2D;gBAE3E,IAAI,EAAE,gBAAgB;IAI5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B,mFAAmF;IACnF,SAAS,IAAI,OAAO;IAIpB,yEAAyE;IACzE,OAAO,CAAC,UAAU;IASZ,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FxC;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;;;OAIG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;;;;;OASG;IACH,MAAM,IAAI,MAAM,EAAE;IAUlB,gEAAgE;IAC1D,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,kEAAkE;IAClE,cAAc,IAAI,MAAM,EAAE;IAUpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB5B;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/delivery/interaction/web-driver.js

@@ -0,0 +1,306 @@
+/**
+ * Web driver — drives a real headless browser with real pointer and key input.
+ *
+ * Deliberately uses coordinate-level mouse control rather than selector clicks:
+ * inside a <canvas> there are no elements to target, so aiming and firing only
+ * exist as pointer positions. A gate that can only click selectors cannot play a
+ * game, and "cannot play it" is indistinguishable from "it works".
+ */
+import { join } from 'node:path';
+import { startStaticServer } from '../execution-gate.js';
+import { buildWatchdogInitScript, watchdogSampleScript } from './watchdog.js';
+import { delay } from './driver.js';
+async function loadRealBrowser() {
+    const mod = await import('../../browser/web-browser.js');
+    return new mod.WebBrowser();
+}
+export class WebInteractionDriver {
+    browser = null;
+    server = null;
+    opts;
+    /** Last pointer position, so `down`/`up` act where the pointer actually is. */
+    pointer = { x: 0, y: 0 };
+    launched = false;
+    /** Per-run instrumentation global — see buildWatchdogInitScript. */
+    watchGlobal = `__uapWatch_${Math.random().toString(36).slice(2, 10)}`;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async start() {
+        const entry = this.opts.entry ?? 'index.html';
+        const root = this.opts.webRoot ?? this.opts.projectRoot;
+        const startServer = this.opts.serverFactory ?? startStaticServer;
+        this.server = await startServer(root, entry);
+        this.browser = this.opts.browserFactory
+            ? await this.opts.browserFactory()
+            : await loadRealBrowser();
+        await this.browser.launch({ headless: true });
+        // MUST precede goto: the watchdog wraps requestAnimationFrame before the
+        // page's own scripts capture a reference to it.
+        await this.browser.addInitScript(buildWatchdogInitScript(this.watchGlobal));
+        // Everything above is INFRASTRUCTURE — if it fails the gate has no opinion
+        // about the artifact. Everything below is the ARTIFACT failing to load,
+        // which is a real defect and must not be laundered into "no browser
+        // available, skipping".
+        this.launched = true;
+        await this.browser.goto(this.server.url);
+        await this.browser.waitForLoadState('load');
+        const size = await this.browser.viewportSize();
+        this.pointer = { x: Math.round(size.width / 2), y: Math.round(size.height / 2) };
+    }
+    /**
+     * Reload the entry page. Init scripts are registered on the CONTEXT, so the
+     * watchdog re-installs automatically on the fresh document.
+     */
+    async reset() {
+        const b = this.browser;
+        if (!b || !this.server)
+            throw new Error('cannot reset: driver not started');
+        // Release a button a previous probe left held: Playwright's mouse state is
+        // browser-level and survives navigation, so a probe ending on `down`
+        // otherwise keeps firing into the next one.
+        try {
+            await b.mouseUp();
+        }
+        catch {
+            /* nothing was held */
+        }
+        await b.goto(this.server.url);
+        await b.waitForLoadState('load');
+        // Persisted storage survives a reload, so a save-state or "seen the
+        // tutorial" flag would carry the previous probe's writes across — exactly
+        // the leak the reload is meant to close.
+        try {
+            await b.evaluate('(function(){try{localStorage.clear();sessionStorage.clear();}catch(e){}return true;})');
+        }
+        catch {
+            /* storage may be unavailable (file://, blocked) */
+        }
+        const size = await b.viewportSize();
+        const cx = Math.round(size.width / 2);
+        const cy = Math.round(size.height / 2);
+        this.pointer = { x: cx, y: cy };
+        // Move the REAL cursor too — otherwise the driver believes the pointer is
+        // centred while it sits wherever the last probe left it, and coordinate-free
+        // `down`/`up` fire at the wrong place.
+        await b.mouseMove(cx, cy);
+    }
+    /** True once the browser is up — distinguishes infra failure from load failure. */
+    didLaunch() {
+        return this.launched;
+    }
+    /** A probe may only navigate within the artifact's own served origin. */
+    sameOrigin(url) {
+        if (!this.server)
+            return false;
+        try {
+            return new URL(url, this.server.url).origin === new URL(this.server.url).origin;
+        }
+        catch {
+            return false;
+        }
+    }
+    async runStep(step) {
+        const b = this.browser;
+        if (!b)
+            throw new Error('web driver not started');
+        switch (step.do) {
+            case 'goto':
+                if (step.url) {
+                    // SAME-ORIGIN ONLY. The manifest is model-authored, and an unrestricted
+                    // goto lets it navigate to `file:///…/.uap/proxy.env` or an attacker
+                    // host — after which every `read` expression executes in THAT origin
+                    // and its values flow out through the verdict feedback.
+                    if (!this.sameOrigin(step.url)) {
+                        throw new Error(`probe tried to navigate off-origin (${step.url}); interaction probes may only drive the artifact under test`);
+                    }
+                    await b.goto(step.url);
+                    await b.waitForLoadState('load');
+                }
+                return;
+            case 'wait':
+                await delay(step.ms);
+                return;
+            case 'move':
+                this.pointer = { x: step.x, y: step.y };
+                await b.mouseMove(step.x, step.y);
+                return;
+            case 'down':
+                await b.mouseDown();
+                return;
+            case 'up':
+                await b.mouseUp();
+                return;
+            case 'click':
+                if (typeof step.x === 'number' && typeof step.y === 'number') {
+                    this.pointer = { x: step.x, y: step.y };
+                    await b.mouseClick(step.x, step.y);
+                }
+                else if (step.selector) {
+                    // Selector clicks stay available for DOM UIs (menus, forms).
+                    await b.evaluate(`(function(){var el=document.querySelector(${JSON.stringify(step.selector)});if(el)el.click();return true;})`);
+                }
+                else {
+                    await b.mouseClick(this.pointer.x, this.pointer.y);
+                }
+                return;
+            case 'aimAt': {
+                // Read-only: the same evaluation path as any observation, so the
+                // mutation guard covers it.
+                const at = await this.read(step.expr);
+                let x;
+                let y;
+                if (typeof at === 'number')
+                    x = at;
+                else if (at && typeof at === 'object') {
+                    const o = at;
+                    if (typeof o.x === 'number')
+                        x = o.x;
+                    if (typeof o.y === 'number')
+                        y = o.y;
+                }
+                // An expression that resolves to nothing (no target on screen) leaves
+                // the pointer where it is rather than throwing — "nothing to aim at"
+                // is a normal moment in play, not a probe failure.
+                if (typeof x !== 'number' || !Number.isFinite(x))
+                    return;
+                const ty = typeof step.y === 'number' ? step.y : (y ?? this.pointer.y);
+                this.pointer = { x, y: ty };
+                await b.mouseMove(x, ty);
+                return;
+            }
+            case 'key':
+                await b.press(step.key);
+                return;
+            case 'eval':
+                await this.read(step.expr);
+                return;
+            case 'inject':
+                await this.inject(step.expr);
+                return;
+            case 'repeat': {
+                // The RUNNER expands repeat blocks so every adapter gets them; this is a
+                // fallback for callers driving the driver directly (e.g. the operator).
+                const times = Math.max(0, Math.min(step.times, 10_000));
+                for (let i = 0; i < times; i++) {
+                    for (const inner of step.steps)
+                        await this.runStep(inner);
+                }
+                return;
+            }
+            default:
+                // Unknown step kinds are ignored rather than thrown: a manifest mined by
+                // a newer version must not hard-fail an older gate.
+                return;
+        }
+    }
+    /**
+     * Evaluate an observation. Wrapped in a function so `const`/`let` declared at
+     * the top level of a classic script — which live in the global LEXICAL scope
+     * and are NOT properties of `window` — are still readable. Reading these
+     * through `window.X` returns undefined, which silently turns every assertion
+     * into "undefined", so the wrapper matters.
+     */
+    async read(expr) {
+        return (await this.readDetailed(expr)).value;
+    }
+    /**
+     * `ok: false` means the expression THREW or named something undefined — a
+     * broken probe, reported as such rather than as a behavioural failure.
+     * `undefined` reached by a resolving expression stays `ok: true`.
+     */
+    async readDetailed(expr) {
+        const b = this.browser;
+        if (!b)
+            throw new Error('web driver not started');
+        const script = `(function(){try{var v=(${expr});return JSON.stringify({ok:true,v:v===undefined?null:v,u:v===undefined});}catch(e){return JSON.stringify({ok:false,e:String(e)});}})`;
+        const raw = await b.evaluate(script);
+        try {
+            const parsed = JSON.parse(typeof raw === 'string' ? raw : JSON.stringify(raw));
+            if (!parsed.ok)
+                return { ok: false, error: parsed.e ?? 'expression threw' };
+            // An expression that resolves to `undefined` is almost always a probe
+            // naming a member the artifact does not expose (`Particles.particles`
+            // against a module that only exports functions), not a real observation.
+            if (parsed.u)
+                return { ok: false, error: `${expr} is undefined — the artifact does not expose it` };
+            return { ok: true, value: parsed.v };
+        }
+        catch {
+            return { ok: false, error: 'observation could not be serialised' };
+        }
+    }
+    async inject(expr) {
+        const b = this.browser;
+        if (!b)
+            throw new Error('web driver not started');
+        await b.evaluate(`(function(){try{${expr};}catch(e){}return true;})`);
+    }
+    /**
+     * GATING errors only: uncaught page exceptions.
+     *
+     * `console.error` output and failed sub-resource requests are common in
+     * working apps — a missing decorative asset or a handled-and-logged warning
+     * would otherwise hard-fail the behavioural gate. Both sibling gates already
+     * refuse to gate on them (execution-gate treats them as advisory;
+     * visual-gate filters to `pageerror`), and a gate that false-fails working
+     * builds gets switched off.
+     */
+    errors() {
+        try {
+            return (this.browser?.getErrors() ?? [])
+                .filter((e) => e.kind === 'pageerror')
+                .map((e) => `${e.kind}: ${e.message}`);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Sample the watchdog under this run's private global name. */
+    async watchdogSample(watchExprs) {
+        return this.read(`(${watchdogSampleScript(watchExprs, this.watchGlobal)})()`);
+    }
+    /** Non-gating observations, surfaced in the report as context. */
+    advisoryErrors() {
+        try {
+            return (this.browser?.getErrors() ?? [])
+                .filter((e) => e.kind !== 'pageerror')
+                .map((e) => `${e.kind}: ${e.message}`);
+        }
+        catch {
+            return [];
+        }
+    }
+    async capture(path) {
+        try {
+            await this.browser?.screenshot(path);
+        }
+        catch {
+            /* evidence capture is best-effort */
+        }
+    }
+    async stop() {
+        // Each teardown independently guarded: a browser left alive leaks a Chromium
+        // process per gate pass, which has previously held SIGTERM'd deliver runs
+        // open for hours.
+        try {
+            await this.browser?.close();
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            this.server?.close();
+        }
+        catch {
+            /* ignore */
+        }
+        this.browser = null;
+        this.server = null;
+    }
+}
+/** Where probe evidence (screenshots) is written. */
+export function evidenceDir(projectRoot) {
+    return join(projectRoot, '.uap', 'interaction', 'evidence');
+}
+//# sourceMappingURL=web-driver.js.map

package/dist/delivery/interaction/web-driver.js.map

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