@nodetool-ai/reliability-harness 0.8.1

package/dist/drivers/fixture-nodes.js

@@ -0,0 +1,189 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * Hermetic fixture nodes for journeys the real node registry has no node
+ * for: a controllable long-running actor (mid-run cancellation while a node
+ * is `running`) and an externally-fed streaming input (mid-run cancellation
+ * while a node is mid-stream). Every other C2 journey uses real registered
+ * `nodetool.*` node classes from `@nodetool-ai/base-nodes` (§5: "prefer core
+ * nodes... so the kernel driver can run them too") — these three fill the
+ * one gap: no shipped node exposes a controllable busy-loop or a
+ * `pushInput`-fed external stream.
+ *
+ * Registered identically into both drivers' registries (`registry.ts` for
+ * the kernel driver, `configureRegistry` for the ws-server driver) so their
+ * behavior is byte-identical on both surfaces — modeled on the equivalent
+ * fixtures in `packages/execution/tests/fixtures.ts`.
+ */
+import { BaseNode, prop } from "@nodetool-ai/node-sdk";
+/**
+ * External input node whose output is structurally streaming (the trivial
+ * `genProcess` override flips `hasStreamingOutput()`), so the kernel keeps
+ * its downstream inbox open for `pushInput`/`finishInputStream` (and the
+ * ws-server's `stream_input`/`end_input_stream` commands) instead of
+ * dispatching a one-shot default. The generator itself is never invoked when
+ * the node has no incoming edges — the kernel dispatches it as an external
+ * input, not a spawned actor.
+ *
+ * The `nodetool.input.` prefix is load-bearing, not cosmetic: the kernel's
+ * `_isExternalInputNode`/`_dispatchInputs` (`runner.ts`) recognize external
+ * inputs by type-prefix, not by the `genProcess` override alone. A type
+ * outside that prefix (e.g. an early `test.reliability.*` draft of this
+ * fixture) gets spawned as an ordinary zero-input actor instead — it runs
+ * `genProcess` once to completion immediately, which defeats the whole
+ * point of a `pushInput`-fed external stream.
+ */
+export class ReliabilityStreamingInputNode extends BaseNode {
+    static nodeType = "nodetool.input.ReliabilityStreamingInput";
+    static title = "Reliability Streaming Input";
+    static description = "Test fixture: external input fed by pushInput/stream_input.";
+    async process() {
+        return { output: this.value };
+    }
+    async *genProcess() {
+        yield { output: this.value };
+    }
+}
+__decorate([
+    prop({ type: "any", default: null })
+], ReliabilityStreamingInputNode.prototype, "value", void 0);
+/** Collects every value streamed on its `value` input into one terminal array. */
+export class ReliabilityStreamSinkNode extends BaseNode {
+    static nodeType = "test.reliability.StreamSink";
+    static title = "Reliability Stream Sink";
+    static description = "Test fixture: collects streamed values.";
+    static isStreamingInput = true;
+    /** Never invoked directly — the kernel dispatches streaming-input nodes
+     * through `run()`. Required only to satisfy `BaseNode`'s abstract member. */
+    async process() {
+        return { output: [] };
+    }
+    async run(inputs, outputs) {
+        const collected = [];
+        for await (const value of inputs.stream("value")) {
+            collected.push(value);
+        }
+        // A cancellation is exactly what closes the loop above without a
+        // natural EOS. Skipping the final emit in that case is deliberate, not
+        // just tidy: `WorkflowRunner._sendMessages` (the code path an
+        // `outputs.emit()` call after the loop would reach) gates on
+        // `this._cancelled` and no-ops once it's set — but the kernel driver's
+        // in-process `cancel()` and the ws-server driver's networked
+        // `cancel_job` command reach that flag at genuinely different wall-clock
+        // offsets from this actor's own scheduling, so whether the runner's own
+        // gate has already flipped by the time this line would run is a race
+        // between the two surfaces, not just within one. Checking the signal
+        // here makes the "no output_update after a cancellation" outcome this
+        // fixture's own deterministic behavior instead of an incidental timing
+        // race the recorded stream would otherwise expose.
+        if (inputs.signal.aborted)
+            return;
+        await outputs.emit("output", collected);
+    }
+}
+/**
+ * A busy node with no incoming edges: parked on the run's own
+ * `AbortSignal` — busy from the graph's perspective, distinct from journey
+ * 6b's `nodetool.input.*`-fed streaming node — until the run is cancelled.
+ *
+ * Two earlier designs both raced:
+ *   - Polling `inputs.signal.aborted` in a `setTimeout`-paced loop raced the
+ *     runner's own cancel bookkeeping — whether this actor's `run()`
+ *     returned before or after `WorkflowRunner` finished processing
+ *     `cancel()` depended on `setTimeout` scheduling granularity, so the
+ *     exact frame sequence differed from run to run *on the same driver*,
+ *     not just across drivers (§6: "two runs ... produce identical
+ *     normalized streams").
+ *   - Blocking on `inputs.stream()` for a handle no edge ever targets
+ *     doesn't block at all: the inbox has zero registered writers for it
+ *     from the start, so `stream()` resolves as an immediate EOS and the
+ *     actor "completes" before any cancel command can possibly land.
+ *
+ * Listening for the signal's `abort` event is neither: it makes no progress
+ * of its own to race, and resolves only once, however long that takes.
+ */
+export class ReliabilityCancelProbeNode extends BaseNode {
+    static nodeType = "test.reliability.CancelProbe";
+    static title = "Reliability Cancel Probe";
+    static description = "Test fixture: blocks until cancelled.";
+    static isStreamingInput = true;
+    /** Never invoked directly — see {@link ReliabilityStreamSinkNode.process}. */
+    async process() {
+        return {};
+    }
+    async run(inputs) {
+        if (inputs.signal.aborted)
+            return;
+        await new Promise((resolve) => {
+            inputs.signal.addEventListener("abort", () => resolve(), { once: true });
+        });
+    }
+}
+/**
+ * Writes bytes through `context.storage` — the one write op every real
+ * asset-producing node eventually calls. Exists purely as a deterministic,
+ * hermetic target for task D3's `host-disk-full` fault: no shipped node
+ * writes an asset without also touching media-ref plumbing this fixture
+ * doesn't need to exercise. A missing `context.storage` (the normal
+ * fault-free hermetic default — `ExecutionSession`'s own minimal context
+ * wires none) is a configuration error for a journey using this node, not a
+ * silent no-op, so it throws rather than skipping the write.
+ */
+export class ReliabilityStorageWriteNode extends BaseNode {
+    static nodeType = "test.reliability.StorageWrite";
+    static title = "Reliability Storage Write";
+    static description = "Test fixture: writes bytes through context.storage (task D3's host-disk-full fault).";
+    async process(context) {
+        if (!context?.storage) {
+            throw new Error("ReliabilityStorageWriteNode requires a ProcessingContext with storage wired");
+        }
+        const uri = await context.storage.store(`${this.key}.bin`, new Uint8Array([1, 2, 3]), "application/octet-stream");
+        return { output: uri };
+    }
+}
+__decorate([
+    prop({ type: "str", default: "reliability-fixture" })
+], ReliabilityStorageWriteNode.prototype, "key", void 0);
+/**
+ * Joins a `list[str]` property — the shared-list-handle multi-edge fan-in
+ * target for the `fan-in-shared-list-handle` journey (A5,
+ * docs/RELIABILITY_TASKS.md Track A). Unlike `fan-out-fan-in-dag`'s `join`
+ * node (two edges into two *distinct* handles, a workaround for the
+ * hydration gap where a hydration path without `propertyTypes` couldn't
+ * distinguish a genuine list fan-in from an invalid one), this node takes
+ * two edges into the SAME `items` handle — the case that gap used to reject
+ * outright on any surface hydrating without a metadata resolver.
+ */
+export class ReliabilityListJoinNode extends BaseNode {
+    static nodeType = "test.reliability.ListJoin";
+    static title = "Reliability List Join";
+    static description = "Test fixture: joins a list[str] input fed by a shared multi-edge handle.";
+    async process() {
+        const list = Array.isArray(this.items) ? this.items : [this.items];
+        return { output: [...list].map((v) => String(v ?? "")).sort().join(",") };
+    }
+}
+__decorate([
+    prop({ type: "list[str]", default: [] })
+], ReliabilityListJoinNode.prototype, "items", void 0);
+export const RELIABILITY_FIXTURE_NODES = [
+    ReliabilityStreamingInputNode,
+    ReliabilityStreamSinkNode,
+    ReliabilityCancelProbeNode,
+    ReliabilityStorageWriteNode,
+    ReliabilityListJoinNode
+];
+/** Registers the harness's own fixture nodes into a live registry. Idempotent
+ * (last-write-wins, matching `NodeRegistry.register`), so it's safe to call
+ * on both a fresh kernel-driver registry and a shared ws-server registry via
+ * `configureRegistry`. */
+export function registerFixtureNodes(registry) {
+    for (const nodeClass of RELIABILITY_FIXTURE_NODES) {
+        registry.register(nodeClass);
+    }
+}
+//# sourceMappingURL=fixture-nodes.js.map

package/dist/drivers/fixture-nodes.js.map

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

package/dist/drivers/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Driver entry point (C2/C4, docs/RELIABILITY_TASKS.md Track C). Now also
+ * re-exported from `../index.ts` (C4 item 7 lifts the "kept out of the main
+ * barrel" constraint C2/C3 deliberately left in place).
+ */
+export type { RunDriver } from "./types.js";
+export { matchesAnchor, AnchorWaiter, type AnchoredMessage } from "./anchors.js";
+export { RELIABILITY_FIXTURE_NODES, registerFixtureNodes, ReliabilityStreamingInputNode, ReliabilityStreamSinkNode, ReliabilityCancelProbeNode } from "./fixture-nodes.js";
+export { buildJourneyRegistry } from "./registry.js";
+export { KernelDriver } from "./kernel.js";
+export { WsServerDriver } from "./ws-server.js";
+export { findRepoRoot, resolveTsxBin } from "./repo-root.js";
+export { spawnNodetoolCli, type CliRunResult } from "./spawn-cli.js";
+export { CliDriver, cliDriverSupports } from "./cli.js";
+export { AppHeadlessDriver, journeyHasAppDoc, runRecordFromAppDebugReport, type AppDebugReportLike } from "./app-headless.js";
+export { BrowserDriver, runRecordFromBrowserRecord, type BrowserRunRecordLike } from "./browser.js";
+export { PackagedDriver, stageBackendBundle, type PackagedDriverOptions } from "./packaged.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,2BAA2B,EAC3B,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC"}

package/dist/drivers/index.js

@@ -0,0 +1,12 @@
+export { matchesAnchor, AnchorWaiter } from "./anchors.js";
+export { RELIABILITY_FIXTURE_NODES, registerFixtureNodes, ReliabilityStreamingInputNode, ReliabilityStreamSinkNode, ReliabilityCancelProbeNode } from "./fixture-nodes.js";
+export { buildJourneyRegistry } from "./registry.js";
+export { KernelDriver } from "./kernel.js";
+export { WsServerDriver } from "./ws-server.js";
+export { findRepoRoot, resolveTsxBin } from "./repo-root.js";
+export { spawnNodetoolCli } from "./spawn-cli.js";
+export { CliDriver, cliDriverSupports } from "./cli.js";
+export { AppHeadlessDriver, journeyHasAppDoc, runRecordFromAppDebugReport } from "./app-headless.js";
+export { BrowserDriver, runRecordFromBrowserRecord } from "./browser.js";
+export { PackagedDriver, stageBackendBundle } from "./packaged.js";
+//# sourceMappingURL=index.js.map

package/dist/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAwB,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,2BAA2B,EAE5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,0BAA0B,EAE3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAEnB,MAAM,eAAe,CAAC"}

package/dist/drivers/kernel.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 KernelDriver implements RunDriver {
+    readonly name = "kernel";
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=kernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/drivers/kernel.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqB5C,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,IAAI,YAAY;IAEnB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAwO9C;CACF"}

package/dist/drivers/kernel.js

@@ -0,0 +1,247 @@
+/**
+ * Kernel driver (§12) — the ONLY driver allowed to touch `ExecutionSession`;
+ * its recorded stream is the oracle every other surface's driver diffs
+ * against (§7, §12).
+ *
+ * Runs a journey's scripted `interactions` against a real `ExecutionSession`
+ * over a fresh, fully-hermetic registry (`registry.ts`: real base nodes +
+ * the harness's own fixture nodes). The bridge factory is
+ * `journeyPythonBridgeFactory` (`python-bridge.ts`, task D3) — a real Python
+ * worker is never spawned; a graph with an unresolved node type (journey 7,
+ * `python-node-workflow`) gets E2's faithful stdio fake instead, everything
+ * else gets no bridge at all (`connectPythonBridgeForGraph` only spawns when
+ * the graph actually needs one), so this driver stays hermetic either way.
+ * Every emitted
+ * `ProcessingMessage` is recorded as a `server_to_client` frame. The kernel
+ * has no wire, so `pushInput`/`cancel` are in-process method calls, not real
+ * frames — but this driver still records a synthetic `client_to_server`
+ * envelope (same `{command, data}` shape the ws-server/packaged drivers send
+ * over the wire) for each one, purely so surface-agnostic invariant checks
+ * that key off command intent (e.g. `terminal-uniqueness`'s
+ * `hasCancelRequest`, which looks for a `cancel_job` command frame) see the
+ * same evidence on every surface. `compareJourney`'s cross-surface diff
+ * ignores this direction entirely (`onlyServerToClient` in `compare.ts`), so
+ * these synthetic frames can never cause a false divergence.
+ */
+import { randomUUID } from "node:crypto";
+import { ExecutionSession } from "@nodetool-ai/execution";
+import { createGraphNodeTypeResolver } from "@nodetool-ai/node-sdk";
+import { ProcessingContext, listRegisteredProviderIds } from "@nodetool-ai/runtime";
+import { InMemoryStorageAdapter } from "@nodetool-ai/storage";
+import { makeFrame } from "../core/record.js";
+import { AnchorWaiter } from "./anchors.js";
+import { buildJourneyRegistry } from "./registry.js";
+import { journeyPythonBridgeFactory } from "./python-bridge.js";
+import { getInjectedHostStorage } from "../faults/host-faults.js";
+import { RELIABILITY_FAULT_PROVIDER_ID } from "../faults/provider-faults.js";
+async function pumpMessages(session, frames, waiter, nextSeq) {
+    for await (const message of session.messages) {
+        frames.push(makeFrame(nextSeq(), "kernel", "server_to_client", message));
+        waiter.notify(message);
+    }
+}
+export class KernelDriver {
+    name = "kernel";
+    async run(journey) {
+        const registry = buildJourneyRegistry();
+        const frames = [];
+        let seq = 0;
+        const waiter = new AnchorWaiter();
+        let session = null;
+        let pump = null;
+        const interactions = journey.interactions.length > 0 ? journey.interactions : [{ action: "run" }];
+        for (const interaction of interactions) {
+            if (interaction.at) {
+                // Registering the waiter here — synchronously, with no `await`
+                // between a prior "run"'s `pump = pumpMessages(...)` call and this
+                // line — is what keeps this race-free (see anchors.ts's doc comment).
+                await waiter.wait(interaction.at);
+            }
+            switch (interaction.action) {
+                case "run": {
+                    // A5 hydration-gap fix (docs/RELIABILITY_TASKS.md Track A):
+                    // connect the bridge here (not inside `ExecutionSession.create`)
+                    // so its discovered metadata can back a `resolveNodeType` fallback
+                    // — the same shape `websocket-client-session.ts`'s ws-server driver
+                    // gets via `createTestUiServer`'s `resolveUnknownNodeType`. Without
+                    // `propertyTypes`/`outputs` resolved, the oracle surface can't tell
+                    // a genuine multi-edge list-typed fan-in from an invalid non-list
+                    // one (correlation analysis rejects both identically when
+                    // `propertyTypes` is absent) — a real cross-surface divergence this
+                    // journey manifest used to work around with distinct handles
+                    // instead of a shared list handle. `ExecutionSession` still owns
+                    // closing this bridge (its `bridgeFactory` just hands back the
+                    // instance already connected here, never reconnecting).
+                    const workflowNodes = (journey.workflow
+                        .nodes ?? []);
+                    const bridge = await journeyPythonBridgeFactory(workflowNodes, (t) => registry.has(t));
+                    const baseResolver = createGraphNodeTypeResolver(registry);
+                    const resolveNodeType = async (nodeType) => {
+                        const resolved = await baseResolver.resolveNodeType(nodeType);
+                        if (resolved)
+                            return resolved;
+                        // Mirrors the ws-server driver's `resolveUnknownNodeType`
+                        // exactly: real bridge metadata when the bridge knows the type,
+                        // else a permissive generic descriptor — never `null`. Returning
+                        // `null` here would make `Graph.loadFromDict` silently DROP the
+                        // node (its default `skipErrors: true`) instead of letting it
+                        // reach `resolveExecutor`/execution, where an unresolvable or
+                        // fault-injected bridge node is actually supposed to fail.
+                        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: {}
+                        };
+                    };
+                    const sessionOptions = {
+                        graph: journey.workflow,
+                        registry,
+                        bridgeFactory: async () => bridge,
+                        workflowId: journey.manifest.name,
+                        params: journey.manifest.params,
+                        resolveNodeType,
+                        // §12: "strict mode is a kernel flag... the harness always sets
+                        // it" — the kernel driver is the oracle surface, so its advisory
+                        // checks (pending inbox work, pending control responses) are
+                        // always thrown violations, not log warnings.
+                        strict: true,
+                        // This driver is a custom-provider host: journeys wire an LLM
+                        // node to `reliability-fault-llm`, which `provider-faults.ts`
+                        // registers process-wide only while a provider fault is active.
+                        // The run preflight would otherwise refuse every journey that
+                        // names it with no fault applied — which is how the
+                        // unregistered-fault-name case reports, so the harness could no
+                        // longer report it. Declaring the catalog keeps a typo'd provider
+                        // an error while letting the fault id through; model ids are
+                        // fixtures with no offline catalog, so they stay unchecked.
+                        catalogs: {
+                            listProviderIds: () => [
+                                ...listRegisteredProviderIds(),
+                                RELIABILITY_FAULT_PROVIDER_ID
+                            ],
+                            listModelIds: () => undefined
+                        },
+                        // Journeys are hermetic: the fault provider needs no credential,
+                        // and no journey may depend on a real key being present.
+                        providerConfiguration: () => [],
+                        // This driver records the message stream frame by frame
+                        // (`pumpMessages` below), so it's one of the few callers that
+                        // actually drains `session.messages` — capture is opt-in exactly
+                        // so hosts that only await `result` don't queue messages unread.
+                        captureMessages: true
+                    };
+                    // Every kernel run gets a working (in-memory, hermetic) storage
+                    // adapter — `ExecutionSession`'s own default context wires none at
+                    // all, but a journey like `host-disk-full-write` (task D3) needs
+                    // one to write through on its happy-path run before the fault
+                    // matrix below swaps it for an ENOSPC-throwing one
+                    // (`faults/host-faults.ts`'s `host-disk-full`,
+                    // {@link getInjectedHostStorage}). No shipped journey before this
+                    // one wrote an asset, so giving every run a real (if unused)
+                    // adapter instead of `null` changes nothing else.
+                    const jobId = randomUUID();
+                    sessionOptions.jobId = jobId;
+                    sessionOptions.context = new ProcessingContext({
+                        jobId,
+                        workflowId: journey.manifest.name,
+                        userId: "1",
+                        storage: getInjectedHostStorage() ?? new InMemoryStorageAdapter()
+                    });
+                    session = await ExecutionSession.create(sessionOptions);
+                    pump = pumpMessages(session, frames, waiter, () => seq++);
+                    break;
+                }
+                case "cancel": {
+                    if (!session) {
+                        throw new Error(`journey "${journey.manifest.name}": "cancel" interaction before "run"`);
+                    }
+                    const reason = typeof interaction.value === "string" ? interaction.value : "journey-cancel";
+                    frames.push(makeFrame(seq++, "kernel", "client_to_server", {
+                        command: "cancel_job",
+                        data: { job_id: session.jobId, reason }
+                    }));
+                    session.cancel(reason);
+                    break;
+                }
+                case "stream_input": {
+                    if (!session) {
+                        throw new Error(`journey "${journey.manifest.name}": "stream_input" interaction before "run"`);
+                    }
+                    if (!interaction.nodeId) {
+                        throw new Error(`journey "${journey.manifest.name}": "stream_input" interaction needs nodeId`);
+                    }
+                    frames.push(makeFrame(seq++, "kernel", "client_to_server", {
+                        command: "stream_input",
+                        data: { job_id: session.jobId, input: interaction.nodeId, value: interaction.value }
+                    }));
+                    await session.pushInput(interaction.nodeId, interaction.value);
+                    break;
+                }
+                case "end_input_stream": {
+                    if (!session) {
+                        throw new Error(`journey "${journey.manifest.name}": "end_input_stream" interaction before "run"`);
+                    }
+                    if (!interaction.nodeId) {
+                        throw new Error(`journey "${journey.manifest.name}": "end_input_stream" interaction needs nodeId`);
+                    }
+                    frames.push(makeFrame(seq++, "kernel", "client_to_server", {
+                        command: "end_input_stream",
+                        data: { job_id: session.jobId, input: interaction.nodeId }
+                    }));
+                    session.finishInputStream(interaction.nodeId);
+                    break;
+                }
+                case "reconnect":
+                    // The kernel has no transport to drop/reconnect — this surface has
+                    // nothing to exercise for a reconnect interaction.
+                    throw new Error(`journey "${journey.manifest.name}": kernel driver does not support ` +
+                        `the "reconnect" interaction (no transport)`);
+            }
+        }
+        if (!session) {
+            throw new Error(`journey "${journey.manifest.name}" has no "run" interaction`);
+        }
+        const result = await session.result;
+        if (pump)
+            await pump;
+        // §6 "Cleanup and leaks": measured from the session itself
+        // (`ExecutionSession.resourceCounters`), not inferred. The kernel driver
+        // owns no WS slots, so those two are structurally zero here — the
+        // ws-server driver is where they carry information.
+        const counters = {
+            at: "after",
+            ...session.resourceCounters(),
+            activeJobs: 0,
+            startingJobs: 0
+        };
+        return {
+            journeyId: journey.manifest.name,
+            surface: this.name,
+            jobId: session.jobId,
+            workflowId: session.workflowId,
+            startedAt: frames.length > 0 ? frames[0].ts : null,
+            finishedAt: frames.length > 0 ? frames[frames.length - 1].ts : null,
+            durationMs: null,
+            status: result.status,
+            error: result.error ?? null,
+            params: journey.manifest.params,
+            frames,
+            resourceCounters: [counters]
+        };
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/drivers/kernel.js.map

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

package/dist/drivers/packaged.d.ts

@@ -0,0 +1,28 @@
+import type { Journey } from "../core/journey.js";
+import { type RunRecord } from "../core/record.js";
+import type { RunDriver } from "./types.js";
+/**
+ * Stages the backend bundle via the exact entry point `npm run backend:smoke`
+ * uses (`npm run prepare-backend --workspace=electron`, i.e.
+ * `scripts/bundle-backend.mjs`). Expensive (minutes) — call once per journey
+ * session, not per journey.
+ */
+export declare function stageBackendBundle(repoRoot?: string): Promise<string>;
+export interface PackagedDriverOptions {
+    /** Staged bundle dir; defaults to `<repoRoot>/electron/backend-bundle`. */
+    bundleDir?: string;
+    /** Node binary to boot `server.mjs` with; defaults to the bundle's own
+     * staged `runtime/node` when present, else the current interpreter. */
+    nodeBinary?: string;
+    /** How long to wait for `/health` before giving up, ms. */
+    healthTimeoutMs?: number;
+}
+export declare class PackagedDriver implements RunDriver {
+    private readonly options;
+    readonly name = "packaged";
+    constructor(options?: PackagedDriverOptions);
+    /** True when a bundle is staged at the configured (or default) location. */
+    isStaged(): boolean;
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=packaged.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packaged.d.ts","sourceRoot":"","sources":["../../src/drivers/packaged.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmB5C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,GAAE,MAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa3F;AAuHD,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;2EACuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAe,YAAW,SAAS;IAGlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,cAAc;IAE3B,YAA6B,OAAO,GAAE,qBAA0B,EAAI;IAEpE,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAGlB;IAEK,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA0J9C;CACF"}