@nodetool-ai/reliability-harness 0.8.1

package/dist/drivers/repo-root.js

@@ -0,0 +1,39 @@
+/**
+ * Repo-root resolution shared by every C4 driver that speaks a real entry
+ * point instead of touching internals (§12: "drivers speak entry points,
+ * never internals — the kernel driver is the only one allowed to touch
+ * `ExecutionSession` directly"). Spawning the real `nodetool` CLI (and, for
+ * `browser.ts`, the real Playwright harness) is what keeps `cli.ts` and
+ * `app-headless.ts` from taking a static import on `@nodetool-ai/cli` — that
+ * package's own `reliability` command (C4 item 6) imports *this* package, so
+ * a static import the other way would be a circular workspace dependency.
+ */
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Walks up from this module to the checked-out repo root (the directory
+ * whose `packages/cli/src/nodetool.ts` exists) — works from both `src/`
+ * (ts-node/tsx dev) and `dist/` (built) locations since it only depends on
+ * directory depth, not file extension. */
+export function findRepoRoot() {
+    const start = dirname(fileURLToPath(import.meta.url));
+    let dir = start;
+    for (let i = 0; i < 12; i++) {
+        if (existsSync(join(dir, "package.json")) &&
+            existsSync(join(dir, "packages", "cli", "src", "nodetool.ts"))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`could not locate the nodetool repo root above ${start}`);
+}
+/** The workspace-hoisted `tsx` binary, falling back to a bare `tsx` for a
+ * shell to resolve if the root install ever changes shape. */
+export function resolveTsxBin(repoRoot) {
+    const bin = join(repoRoot, "node_modules", ".bin", process.platform === "win32" ? "tsx.cmd" : "tsx");
+    return existsSync(bin) ? bin : "tsx";
+}
+//# sourceMappingURL=repo-root.js.map

package/dist/drivers/repo-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-root.js","sourceRoot":"","sources":["../../src/drivers/repo-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;0CAG0C;AAC1C,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IACE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAC9D,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;8DAC8D;AAC9D,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,CACd,QAAQ,EACR,cAAc,EACd,MAAM,EACN,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CACjD,CAAC;IACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACvC,CAAC"}

package/dist/drivers/spawn-cli.d.ts

@@ -0,0 +1,8 @@
+export interface CliRunResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    repoRoot: string;
+}
+export declare function spawnNodetoolCli(args: string[], timeoutMs: number): Promise<CliRunResult>;
+//# sourceMappingURL=spawn-cli.d.ts.map

package/dist/drivers/spawn-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-cli.d.ts","sourceRoot":"","sources":["../../src/drivers/spawn-cli.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAgCvB"}

package/dist/drivers/spawn-cli.js

@@ -0,0 +1,41 @@
+/**
+ * Spawns the real `nodetool` CLI against the checked-out source, via `tsx` —
+ * the same door a user gets (`npm run dev:nodetool -- <args>`), shared by
+ * `cli.ts` and `app-headless.ts`. No compiled `dist/` dependency, so it works
+ * in the same tree `npm run dev` does.
+ */
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { findRepoRoot, resolveTsxBin } from "./repo-root.js";
+export async function spawnNodetoolCli(args, timeoutMs) {
+    const repoRoot = findRepoRoot();
+    const tsxBin = resolveTsxBin(repoRoot);
+    const nodetoolEntry = join(repoRoot, "packages", "cli", "src", "nodetool.ts");
+    return new Promise((resolvePromise) => {
+        const child = spawn(tsxBin, [nodetoolEntry, ...args], {
+            cwd: repoRoot,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (buf) => (stdout += buf.toString()));
+        child.stderr.on("data", (buf) => (stderr += buf.toString()));
+        const timer = setTimeout(() => {
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                // Already exited.
+            }
+        }, timeoutMs);
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            resolvePromise({ code: code ?? 1, stdout, stderr, repoRoot });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolvePromise({ code: 127, stdout, stderr: stderr + String(err), repoRoot });
+        });
+    });
+}
+//# sourceMappingURL=spawn-cli.js.map

package/dist/drivers/spawn-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-cli.js","sourceRoot":"","sources":["../../src/drivers/spawn-cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS7D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAc,EACd,SAAiB;IAEjB,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IAE9E,OAAO,IAAI,OAAO,CAAe,CAAC,cAAc,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,EAAE;YACpD,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/drivers/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The driver contract every execution surface implements (§12).
+ *
+ * A driver runs one loaded {@link Journey} to completion on its surface and
+ * returns a {@link RunRecord} — every frame, both directions, surface-tagged
+ * — so the same journey compares cleanly across surfaces via `normalize.ts`
+ * + `diff.ts`. C2 ships `kernel` (the oracle) and `ws-server`; C4 adds
+ * `cli`/`browser`/`app-headless`/`packaged` behind this same interface.
+ */
+import type { Journey } from "../core/journey.js";
+import type { RunRecord } from "../core/record.js";
+export interface RunDriver {
+    /** Matches `JourneySurface` (`core/journey.ts`) — e.g. "kernel", "ws-server". */
+    readonly name: string;
+    /** Runs `journey` to a terminal state on this surface and records every frame. */
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/drivers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3C"}

package/dist/drivers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/drivers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":""}

package/dist/drivers/ws-server.d.ts

@@ -0,0 +1,8 @@
+import type { Journey } from "../core/journey.js";
+import { type RunRecord } from "../core/record.js";
+import type { RunDriver } from "./types.js";
+export declare class WsServerDriver implements RunDriver {
+    readonly name = "ws-server";
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=ws-server.d.ts.map

package/dist/drivers/ws-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.d.ts","sourceRoot":"","sources":["../../src/drivers/ws-server.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoE5C,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,IAAI,eAAe;IAEtB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAgV9C;CACF"}

package/dist/drivers/ws-server.js

@@ -0,0 +1,382 @@
+/**
+ * WS-server driver (§12) — starts the hermetic test backend
+ * (`createTestUiServer`, the helper `packages/websocket/src/e2e-server.ts`
+ * and the websocket test suite both build on) and drives it with a real
+ * msgpack `ws` client, exactly the wire protocol a real client speaks. Never
+ * constructs `ExecutionSession`/`WorkflowRunner` directly — the kernel
+ * driver (`kernel.ts`) is the only place allowed to do that (§12: "kernel
+ * surface is the oracle").
+ *
+ * Records both directions: outbound command envelopes as
+ * `client_to_server` frames, every inbound `ProcessingMessage` as
+ * `server_to_client` — the ws-server driver is the one surface where that
+ * distinction is real (the kernel driver has no wire).
+ */
+import { WebSocket } from "ws";
+import { createTestUiServer, packWebSocketMessage, unpackWebSocketMessage } from "@nodetool-ai/websocket";
+import { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { registerBaseNodes } from "@nodetool-ai/base-nodes";
+import { resolvePythonNodeExecutor } from "@nodetool-ai/runtime";
+import { makeFrame } from "../core/record.js";
+import { AnchorWaiter } from "./anchors.js";
+import { registerFixtureNodes } from "./fixture-nodes.js";
+import { journeyPythonBridgeFactory } from "./python-bridge.js";
+import { isConnectionControlMessage, stripRelayOnlyFields } from "./relay-fields.js";
+import { maybeFrontWithProxy } from "../faults/ws-proxy.js";
+const TERMINAL_JOB_STATUSES = new Set([
+    "completed",
+    "failed",
+    "cancelled",
+    "suspended"
+]);
+/** How long to let the server's post-disconnect cleanup settle before
+ * recording the slot counters as final. Cleanup is asynchronous (the runner
+ * finishes streaming, then frees the slot), so a snapshot taken the instant
+ * the socket closes would report a slot that is merely about to be freed. */
+const SLOT_SETTLE_TIMEOUT_MS = 2000;
+const SLOT_SETTLE_POLL_MS = 10;
+/**
+ * Post-run WS slot accounting (§6 "Cleanup and leaks"), summed over every
+ * connection this run opened. Polls until both counters reach zero or the
+ * settle window elapses, then reports whatever it measured — a genuine leak
+ * survives the wait and is recorded as non-zero.
+ */
+async function settledSlotCounters(runners) {
+    const total = () => runners.reduce((acc, runner) => {
+        const slots = runner.jobs.slotCounters;
+        return {
+            activeJobs: acc.activeJobs + slots.activeJobs,
+            startingJobs: acc.startingJobs + slots.startingJobs
+        };
+    }, { activeJobs: 0, startingJobs: 0 });
+    const deadline = Date.now() + SLOT_SETTLE_TIMEOUT_MS;
+    let slots = total();
+    while ((slots.activeJobs > 0 || slots.startingJobs > 0) && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, SLOT_SETTLE_POLL_MS));
+        slots = total();
+    }
+    return {
+        at: "after",
+        // Kernel-internal counters belong to the process the ws-server runs the
+        // kernel in; this driver reaches the server only over the wire, so it
+        // reports the accounting it can actually observe and leaves the rest at
+        // zero (the kernel driver is the surface that measures those).
+        liveActors: 0,
+        pendingControlResponses: 0,
+        pendingTimers: 0,
+        pythonBridgePendingRequests: 0,
+        ...slots
+    };
+}
+function requireJobId(jobId, journeyName, action) {
+    if (!jobId) {
+        throw new Error(`journey "${journeyName}": "${action}" interaction fired before a job_id was observed`);
+    }
+    return jobId;
+}
+export class WsServerDriver {
+    name = "ws-server";
+    async run(journey) {
+        // Task D3: mirror the kernel driver's Python-bridge wiring
+        // (`python-bridge.ts`) so journey 7 (`python-node-workflow`) behaves the
+        // same on both surfaces. `createTestUiServer`'s default `resolveExecutor`
+        // only ever calls `registry.resolve` — unlike `ExecutionSession`, it has
+        // no built-in bridge fallback — so this driver builds one itself: a
+        // throwaway registry (same real base nodes + harness fixtures the actual
+        // server registry ends up with, via `configureRegistry` below) just to
+        // answer "can the TS registry resolve this type", exactly the predicate
+        // `connectPythonBridgeForGraph` needs. A graph with no unresolved node
+        // type (every journey but #7) never spawns anything.
+        const bridgeCheckRegistry = new NodeRegistry();
+        registerBaseNodes(bridgeCheckRegistry);
+        registerFixtureNodes(bridgeCheckRegistry);
+        const workflowNodes = (journey.workflow.nodes ??
+            []);
+        const bridge = await journeyPythonBridgeFactory(workflowNodes, (t) => bridgeCheckRegistry.has(t));
+        let liveRegistry = null;
+        // §6 "Cleanup and leaks" needs the server's own WS slot accounting, which
+        // lives on the per-connection runner. `createTestUiServer` builds one per
+        // upgrade and keeps it private; this hook is the only way to read it.
+        const runners = [];
+        const srv = createTestUiServer({
+            host: "127.0.0.1",
+            port: 0,
+            onRunnerCreated: (runner) => runners.push(runner),
+            configureRegistry: (registry) => {
+                registerFixtureNodes(registry);
+                liveRegistry = registry;
+            },
+            resolveExecutor: (node) => {
+                const registry = liveRegistry;
+                if (registry?.has(node.type))
+                    return registry.resolve(node);
+                const pythonExecutor = resolvePythonNodeExecutor(bridge, node);
+                if (pythonExecutor)
+                    return pythonExecutor;
+                // Falls through to the registry's own "Unknown node type" error —
+                // same failure shape a bridge-less run would produce.
+                return registry.resolve(node);
+            },
+            // Without this, `Graph.loadFromDict` (node-sdk) silently drops a
+            // bridge-only node type (and its edges) during hydration — it never
+            // even reaches `resolveExecutor` above, so a bridge CONNECT failure
+            // (never-ready/epipe/version-mismatch: `bridge` ends up `null`) would
+            // otherwise make the node vanish from the graph entirely instead of
+            // failing at execution the way the kernel driver's
+            // `hydrateGraphNodeFlags` does (it defaults metadata for ANY
+            // class-less node rather than dropping it — see that function's own
+            // doc comment). Mirrors that: bridge metadata when connected, a
+            // generic pass-through shape when not, so either way the node stays in
+            // the graph and the real failure surfaces later, at
+            // `resolveExecutor`/`execute()` — the same failure shape on both
+            // surfaces, just like the kernel driver.
+            resolveUnknownNodeType: async (nodeType) => {
+                const meta = bridge?.hasNodeType(nodeType)
+                    ? bridge.getNodeMetadata().find((m) => m.node_type === nodeType)
+                    : undefined;
+                if (meta) {
+                    return {
+                        nodeType,
+                        propertyTypes: Object.fromEntries(meta.properties.map((p) => [p.name, p.type.type])),
+                        outputs: Object.fromEntries(meta.outputs.map((o) => [o.name, o.type.type])),
+                        supportsDynamicInputs: false,
+                        descriptorDefaults: {}
+                    };
+                }
+                return {
+                    nodeType,
+                    propertyTypes: { value: "any" },
+                    outputs: { out: "any" },
+                    supportsDynamicInputs: true,
+                    descriptorDefaults: {}
+                };
+            }
+        });
+        await srv.listen();
+        const address = srv.server.address();
+        const serverPort = typeof address === "object" && address !== null ? address.port : 7777;
+        // Task D2: when a ws-* fault (`faults/ws-faults.ts`) is currently active,
+        // front the real server with a `WsFaultProxy` and connect this driver's
+        // client to the proxy instead — every ws-* fault applies transparently
+        // to this one client-connection code path below. `wsFrontEnd` stays
+        // `null` (the overwhelming majority of runs) when no ws fault is
+        // configured, in which case this is exactly the pre-D2 direct connection.
+        const wsFrontEnd = await maybeFrontWithProxy("127.0.0.1", serverPort);
+        const port = wsFrontEnd ? wsFrontEnd.port : serverPort;
+        const frames = [];
+        let counters = null;
+        let seq = 0;
+        const waiter = new AnchorWaiter();
+        let jobId = null;
+        let terminalStatus = null;
+        let terminalError = null;
+        // ws-server relays two `job_update`s per status the kernel driver only
+        // ever sees once: an eager "running" ack sent before the kernel's own
+        // relayed `job_update running` ("Authoritative SDK runs can use [the
+        // kernel's] update and avoid an otherwise duplicate WebSocket frame.
+        // Legacy clients keep the eager acknowledgement" —
+        // `websocket-client-session.ts`), and, for any non-"completed" terminal
+        // status, an "authoritative terminal snapshot" appended after the
+        // relayed one because the kernel's own terminal frame never carries a
+        // `result` field.
+        //
+        // Both are recorded, tagged `redundant` (see `RunFrame.redundant`) rather
+        // than dropped: dropping every repeat, as this driver used to, also drops
+        // the duplicates that would be real bugs, leaving "exactly one terminal
+        // job_update" with nothing to detect on the one surface that has a wire.
+        // The tag is narrow — a repeat only earns it by matching the documented
+        // shape below — so any other duplicate stays visible to the invariants
+        // and to the cross-surface diff.
+        const jobUpdateStatusCounts = new Map();
+        const taggedReasons = new Set();
+        let cancelRequested = false;
+        /** The reason tag for a repeated `job_update`, or undefined when this
+         * surface has no documented reason to have sent it twice. */
+        const documentedRedundancy = (status, message) => {
+            const claim = (reason) => {
+                // One repeat per documented reason. A third frame is not something
+                // the protocol documents, so it stays visible.
+                if (taggedReasons.has(reason))
+                    return undefined;
+                taggedReasons.add(reason);
+                return reason;
+            };
+            if (status === "running")
+                return claim("ws-eager-running-ack");
+            if (TERMINAL_JOB_STATUSES.has(status) && "result" in message) {
+                return claim("ws-authoritative-terminal-snapshot");
+            }
+            // `cancel_job` is acknowledged with a `cancelled` job_update right away
+            // (`websocket-client-session.ts`'s cancel handler: "the runner's own
+            // cleanup can lag"), which the kernel's own relayed terminal then
+            // repeats. Only ever allowed for a cancel this driver actually asked
+            // for.
+            if (status === "cancelled" && cancelRequested) {
+                return claim("ws-eager-cancel-ack");
+            }
+            return undefined;
+        };
+        let resolveTerminal;
+        const terminalPromise = new Promise((resolve) => {
+            resolveTerminal = resolve;
+        });
+        const ws = new WebSocket(`ws://127.0.0.1:${port}/ws`);
+        ws.on("message", (data, isBinary) => {
+            const raw = (isBinary
+                ? unpackWebSocketMessage(data)
+                : JSON.parse(data.toString("utf8")));
+            // This surface runs the same relay as `packaged.ts`, so it receives the
+            // same connection-scoped control frames on the same wall-clock timers.
+            if (isConnectionControlMessage(raw))
+                return;
+            const message = stripRelayOnlyFields(raw);
+            waiter.notify(message);
+            if (typeof message["job_id"] === "string") {
+                jobId = message["job_id"];
+            }
+            // Command acks (`{message: "Job started", ...}` for run_job/cancel_job/
+            // stream_input/end_input_stream) carry no `type` at all — they are not
+            // `ProcessingMessage`s, just a reply to the command envelope this
+            // driver already recorded as its own `client_to_server` frame. Not
+            // recording them keeps this surface's `server_to_client` frames
+            // apples-to-apples with the kernel driver's raw message stream.
+            if (typeof message["type"] !== "string")
+                return;
+            if (message["type"] === "job_update") {
+                const status = String(message["status"]);
+                const seenBefore = (jobUpdateStatusCounts.get(status) ?? 0) > 0;
+                jobUpdateStatusCounts.set(status, (jobUpdateStatusCounts.get(status) ?? 0) + 1);
+                const redundant = seenBefore
+                    ? documentedRedundancy(status, message)
+                    : undefined;
+                const frame = makeFrame(seq++, "ws-server", "server_to_client", message);
+                frames.push(redundant === undefined ? frame : { ...frame, redundant });
+                if (!seenBefore && TERMINAL_JOB_STATUSES.has(status)) {
+                    terminalStatus = status;
+                    terminalError =
+                        typeof message["error"] === "string" ? message["error"] : null;
+                    resolveTerminal();
+                }
+                return;
+            }
+            frames.push(makeFrame(seq++, "ws-server", "server_to_client", message));
+        });
+        await new Promise((resolve, reject) => {
+            ws.once("open", () => resolve());
+            ws.once("error", reject);
+        });
+        const send = (command, data) => {
+            const envelope = { command, data };
+            frames.push(makeFrame(seq++, "ws-server", "client_to_server", envelope));
+            ws.send(packWebSocketMessage(envelope));
+        };
+        try {
+            const interactions = journey.interactions.length > 0 ? journey.interactions : [{ action: "run" }];
+            for (const interaction of interactions) {
+                if (interaction.at) {
+                    // Same race-free ordering rule as the kernel driver (anchors.ts):
+                    // no `await` happens between a "run"'s `send()` and this wait, so
+                    // the waiter is registered before the ws `message` handler (which
+                    // runs on Node's event loop, not inline) can deliver the frame.
+                    await waiter.wait(interaction.at);
+                }
+                switch (interaction.action) {
+                    case "run":
+                        send("run_job", {
+                            graph: journey.workflow,
+                            workflow_id: journey.manifest.name,
+                            params: journey.manifest.params,
+                            // Hermetic and driver-symmetric: the kernel driver never
+                            // touches the jobs DB either, so neither surface depends on
+                            // persistence to complete a journey. Deliberately NOT
+                            // `require_terminal_result` — that also renames Output nodes'
+                            // terminal keys to their public `properties.name`
+                            // (`rewriteOutputNames`), which the kernel driver doesn't do
+                            // either; every journey's `Output` nodes already carry an
+                            // explicit top-level `name` so both surfaces agree without it.
+                            execution_options: { persistence: "session" }
+                        });
+                        break;
+                    case "cancel":
+                        cancelRequested = true;
+                        send("cancel_job", {
+                            job_id: requireJobId(jobId, journey.manifest.name, "cancel")
+                        });
+                        break;
+                    case "stream_input":
+                        if (!interaction.nodeId) {
+                            throw new Error(`journey "${journey.manifest.name}": "stream_input" interaction needs nodeId`);
+                        }
+                        send("stream_input", {
+                            job_id: requireJobId(jobId, journey.manifest.name, "stream_input"),
+                            input: interaction.nodeId,
+                            value: interaction.value
+                        });
+                        break;
+                    case "end_input_stream":
+                        if (!interaction.nodeId) {
+                            throw new Error(`journey "${journey.manifest.name}": "end_input_stream" interaction needs nodeId`);
+                        }
+                        send("end_input_stream", {
+                            job_id: requireJobId(jobId, journey.manifest.name, "end_input_stream"),
+                            input: interaction.nodeId
+                        });
+                        break;
+                    case "reconnect":
+                        throw new Error(`journey "${journey.manifest.name}": ws-server driver does not yet ` +
+                            `support the "reconnect" interaction (C4)`);
+                }
+            }
+            // Task D2: a black-hole-style ws fault (`ws-drop-no-fin`,
+            // `ws-stall-reads`) can leave `terminalPromise` unresolved forever —
+            // the whole point of those faults is that no more frames arrive. §9's
+            // "no run hangs forever" applies to fault runs too, so race the wait
+            // against the journey's own declared timeout instead of adding one
+            // only for the happy path.
+            let timedOut = false;
+            let timeoutTimer;
+            await Promise.race([
+                terminalPromise,
+                new Promise((resolve) => {
+                    timeoutTimer = setTimeout(() => {
+                        timedOut = true;
+                        resolve();
+                    }, journey.manifest.timeoutMs);
+                })
+            ]);
+            clearTimeout(timeoutTimer);
+            if (timedOut && terminalStatus === null) {
+                terminalStatus = "timeout";
+                terminalError =
+                    `journey "${journey.manifest.name}": ws-server driver timed out after ` +
+                        `${journey.manifest.timeoutMs}ms waiting for a terminal job_update`;
+            }
+        }
+        finally {
+            // Leak accounting is measured after the connection is gone, not at the
+            // terminal frame: tearing the socket down is what ends a run whose
+            // client stopped hearing from the server at all (the black-hole ws
+            // faults), and the server's own cleanup runs on disconnect.
+            ws.close();
+            await wsFrontEnd?.close();
+            counters = await settledSlotCounters(runners);
+            await srv.close();
+            bridge?.close();
+        }
+        return {
+            journeyId: journey.manifest.name,
+            surface: this.name,
+            jobId,
+            workflowId: journey.manifest.name,
+            startedAt: frames.length > 0 ? frames[0].ts : null,
+            finishedAt: frames.length > 0 ? frames[frames.length - 1].ts : null,
+            durationMs: null,
+            status: terminalStatus ?? "unknown",
+            error: terminalError,
+            params: journey.manifest.params,
+            frames,
+            resourceCounters: counters ? [counters] : []
+        };
+    }
+}
+//# sourceMappingURL=ws-server.js.map

package/dist/drivers/ws-server.js.map

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

package/dist/faults/bridge-faults.d.ts

@@ -0,0 +1,7 @@
+import type { FaultModule } from "./types.js";
+export declare const BRIDGE_FAULT_MODULES: readonly FaultModule[];
+/** Registers every bridge-seam fault module. Called once from
+ * `faults/index.ts`'s module-load side effect (task D1's "call once, own
+ * module state" contract) — safe to call again, last-write-wins. */
+export declare function registerBridgeFaultModules(): void;
+//# sourceMappingURL=bridge-faults.d.ts.map

package/dist/faults/bridge-faults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-faults.d.ts","sourceRoot":"","sources":["../../src/faults/bridge-faults.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAgB,WAAW,EAAiB,MAAM,YAAY,CAAC;AAgE3E,eAAO,MAAM,oBAAoB,EAAE,SAAS,WAAW,EAE3B,CAAC;AAE7B;;oEAEoE;AACpE,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}