@nodetool-ai/reliability-harness 0.8.1

package/dist/drivers/app-headless.js

@@ -0,0 +1,123 @@
+/**
+ * Headless-app driver (§12) — wraps `nodetool app debug` (packages/cli's
+ * app-debug runtime, `packages/cli/src/app-debug/`) for journeys whose
+ * workflow carries an app document. Spawns the real CLI (`spawn-cli.ts`)
+ * rather than importing the app-debug runtime directly: `@nodetool-ai/cli`'s
+ * own `reliability` command (item 6) depends on this package, so a static
+ * import the other way would be a circular workspace dependency — and
+ * spawning the entry point is what every non-oracle driver does anyway
+ * (§12: "drivers speak entry points, never internals").
+ *
+ * A journey "carries an app" when its workflow JSON has a top-level
+ * `app_doc` field — the same shape `nodetool debug`/`workflows run` read
+ * (`packages/cli/src/debug/target.ts`). None of the seed journeys (§5) do
+ * yet, so `supports()` reports `false` for all of them today and the driver
+ * is skipped as not-applicable — the "headless-app or n/a-clean" leg of C4's
+ * done-when (item 8). The conversion half (`runRecordFromAppDebugReport`) is
+ * still fully implemented and unit-tested against a fabricated report, so a
+ * future app-carrying journey exercises real, proven code — not a stub.
+ */
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { makeFrame } from "../core/record.js";
+import { spawnNodetoolCli } from "./spawn-cli.js";
+/** True when a journey's workflow carries an `app_doc` the app-headless
+ * driver can run — pure, no IO, so `compare.ts` and tests can check
+ * applicability without spawning a process. */
+export function journeyHasAppDoc(journey) {
+    return journey.workflow["app_doc"] != null;
+}
+/**
+ * Folds a decoded `AppDebugReport` (`report.json`) plus each triggered run's
+ * own `server/run-N.messages.jsonl` lines (already read, in `runs[]` order)
+ * into one `RunRecord`. Pure — mirrors `record.ts`'s
+ * `runRecordFromDebugBundle` split between the pure conversion and the IO
+ * that reads the bundle off disk, so this half is unit-testable without a
+ * real app document or a spawned process.
+ */
+export function runRecordFromAppDebugReport(report, runMessages, options = {}) {
+    const startedAt = options.startedAt ?? 0;
+    const frames = [];
+    let seq = 0;
+    for (const messages of runMessages) {
+        for (const message of messages) {
+            frames.push(makeFrame(seq, "app-headless", "server_to_client", message, startedAt + seq));
+            seq++;
+        }
+    }
+    const runs = report.runs ?? [];
+    const firstFailure = runs.find((r) => r.status && r.status !== "completed");
+    const status = runs.length === 0 ? "unknown" : firstFailure?.status ?? "completed";
+    const lastRun = runs[runs.length - 1];
+    return {
+        journeyId: options.journeyId,
+        surface: "app-headless",
+        jobId: null,
+        workflowId: report.target?.workflowId ?? null,
+        startedAt: frames.length > 0 ? startedAt : null,
+        finishedAt: frames.length > 0 ? startedAt + Math.max(frames.length - 1, 0) : null,
+        durationMs: lastRun?.durationMs ?? null,
+        status,
+        error: firstFailure?.error ?? runs.find((r) => r.error)?.error ?? null,
+        params: {},
+        frames
+    };
+}
+export class AppHeadlessDriver {
+    name = "app-headless";
+    supports(journey) {
+        return journeyHasAppDoc(journey);
+    }
+    async run(journey) {
+        if (!this.supports(journey)) {
+            throw new Error(`journey "${journey.manifest.name}": app-headless driver only runs ` +
+                `journeys whose workflow carries an "app_doc" — this journey has none (n/a)`);
+        }
+        const bundleDir = await mkdtemp(join(tmpdir(), "nodetool-reliability-app-"));
+        try {
+            const workflowPath = join(bundleDir, "workflow.json");
+            await writeFile(workflowPath, JSON.stringify(journey.workflow), "utf8");
+            const timeoutMs = journey.manifest.timeoutMs + 30_000;
+            const { code, stdout, stderr } = await spawnNodetoolCli([
+                "app",
+                "debug",
+                workflowPath,
+                "--params",
+                JSON.stringify(journey.manifest.params ?? {}),
+                "--out",
+                bundleDir,
+                "--json"
+            ], timeoutMs);
+            let report;
+            try {
+                report = JSON.parse(await readFile(join(bundleDir, "report.json"), "utf8"));
+            }
+            catch (err) {
+                throw new Error(`journey "${journey.manifest.name}": app-headless driver produced no ` +
+                    `readable report (exit ${code})\n--- stdout ---\n${stdout}\n` +
+                    `--- stderr ---\n${stderr}\noriginal error: ${String(err)}`);
+            }
+            const runMessages = [];
+            for (const run of report.runs ?? []) {
+                if (!run.messagesFile) {
+                    runMessages.push([]);
+                    continue;
+                }
+                const raw = await readFile(join(bundleDir, run.messagesFile), "utf8").catch(() => "");
+                runMessages.push(raw
+                    .split("\n")
+                    .map((line) => line.trim())
+                    .filter((line) => line.length > 0)
+                    .map((line) => JSON.parse(line)));
+            }
+            return runRecordFromAppDebugReport(report, runMessages, {
+                journeyId: journey.manifest.name
+            });
+        }
+        finally {
+            await rm(bundleDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=app-headless.js.map

package/dist/drivers/app-headless.js.map

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

package/dist/drivers/browser.d.ts

@@ -0,0 +1,34 @@
+import type { Journey } from "../core/journey.js";
+import { type RunRecord } from "../core/record.js";
+import type { RunDriver } from "./types.js";
+/** Minimal shape this driver needs from a decoded `browser/record.json`
+ * (`web/src/e2e_runner/types.ts`'s `RunRecord`). */
+export interface BrowserRunRecordLike {
+    status?: string;
+    error?: string | null;
+    durationMs?: number | null;
+    jobId?: string | null;
+    events?: Array<Record<string, unknown>>;
+}
+/** Folds a decoded `browser/record.json` into a `RunRecord`. Pure — the IO
+ * (spawning Playwright, reading the file back) lives in {@link BrowserDriver},
+ * so a captured fixture round-trips through this without a browser. */
+export declare function runRecordFromBrowserRecord(record: BrowserRunRecordLike, options?: {
+    journeyId?: string;
+    startedAt?: number;
+}): RunRecord;
+export declare class BrowserDriver implements RunDriver {
+    readonly name = "browser";
+    /** A single, unscripted `run` (see the module doc comment) AND Playwright
+     * actually available in this environment. Folding `isAvailable()` in here
+     * — rather than leaving it a separate check `run()` fails on — is what lets
+     * `compare.ts` report a sandbox without a matching Chromium build as "not
+     * applicable" instead of a false "diverges from the oracle" failure. */
+    supports(journey: Journey): boolean;
+    /** True when Playwright and its Chromium binary are actually available in
+     * this environment — lets callers (`compare.ts`, tests) skip cleanly
+     * instead of failing the whole run. */
+    isAvailable(): boolean;
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/drivers/browser.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;oDACoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzC;AAoCD;;uEAEuE;AACvE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,SAAS,CAoBX;AAED,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAE1B;;;;4EAIwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAKlC;IAED;;2CAEuC;IACvC,WAAW,IAAI,OAAO,CAOrB;IAEK,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA4E9C;CACF"}

package/dist/drivers/browser.js

@@ -0,0 +1,176 @@
+/**
+ * Browser driver (§12) — wraps the existing `e2e_runner` Playwright harness
+ * (`web/tests/debug-harness/debug.spec.ts`, the same spec `nodetool debug
+ * --browser` and `npm run test:debug-harness` drive) to run a journey's
+ * workflow through the real web stack: real ReactFlow canvas, real
+ * `GlobalWebSocketManager`, real WS protocol, hermetic backend
+ * (`packages/websocket/src/e2e-server.ts`, spawned by the spec's
+ * `globalSetup`).
+ *
+ * Spawns Playwright directly (root `node_modules/.bin/playwright`, `cwd:
+ * web/`) rather than importing `packages/cli/src/debug/browser-runner.ts`:
+ * that module lives in `@nodetool-ai/cli`, which depends on this package for
+ * the `reliability` command (item 6), so importing it here would be a
+ * circular workspace dependency — and going through the real Playwright
+ * binary is what "drivers speak entry points, never internals" (§12) means
+ * for a non-oracle surface anyway.
+ *
+ * Scripted interactions (`cancel`/`stream_input`/`end_input_stream`) are not
+ * yet wired through `NODETOOL_DEBUG_*` env — the spec runs one `runGraph`
+ * call start-to-finish, same limitation as the CLI driver. `supports()`
+ * reflects that.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { makeFrame } from "../core/record.js";
+import { findRepoRoot } from "./repo-root.js";
+const CONFIG_REL = "playwright.debug-harness.config.ts";
+const DEFAULT_TIMEOUT_MS = 6 * 60_000;
+const GROUP_KILL_GRACE_MS = 5_000;
+/** Locates the workspace-hoisted Playwright binary a fresh `web/`
+ * `node_modules/.bin` doesn't necessarily carry (root `npm install` hoists
+ * it), falling back to `web`'s own copy when present. */
+function resolvePlaywrightBin(repoRoot, webDir) {
+    const local = join(webDir, "node_modules", ".bin", "playwright");
+    if (existsSync(local))
+        return local;
+    const hoisted = join(repoRoot, "node_modules", ".bin", "playwright");
+    return existsSync(hoisted) ? hoisted : null;
+}
+function killChild(child) {
+    if (process.platform !== "win32" && child.pid !== undefined) {
+        const pgid = child.pid;
+        try {
+            process.kill(-pgid, "SIGTERM");
+        }
+        catch {
+            // Process group may already be gone.
+        }
+        setTimeout(() => {
+            try {
+                process.kill(-pgid, "SIGKILL");
+            }
+            catch {
+                // Process group may already be gone.
+            }
+        }, GROUP_KILL_GRACE_MS).unref();
+        return;
+    }
+    try {
+        child.kill("SIGKILL");
+    }
+    catch {
+        // Already exited.
+    }
+}
+/** Folds a decoded `browser/record.json` into a `RunRecord`. Pure — the IO
+ * (spawning Playwright, reading the file back) lives in {@link BrowserDriver},
+ * so a captured fixture round-trips through this without a browser. */
+export function runRecordFromBrowserRecord(record, options = {}) {
+    const startedAt = options.startedAt ?? 0;
+    const events = record.events ?? [];
+    const frames = events.map((message, index) => makeFrame(index, "browser", "server_to_client", message, startedAt + index));
+    return {
+        journeyId: options.journeyId,
+        surface: "browser",
+        jobId: record.jobId ?? null,
+        workflowId: null,
+        startedAt: frames.length > 0 ? startedAt : null,
+        finishedAt: frames.length > 0 ? startedAt + (frames.length - 1) : null,
+        durationMs: record.durationMs ?? null,
+        status: record.status ?? "unknown",
+        error: record.error ?? null,
+        params: {},
+        frames
+    };
+}
+export class BrowserDriver {
+    name = "browser";
+    /** A single, unscripted `run` (see the module doc comment) AND Playwright
+     * actually available in this environment. Folding `isAvailable()` in here
+     * — rather than leaving it a separate check `run()` fails on — is what lets
+     * `compare.ts` report a sandbox without a matching Chromium build as "not
+     * applicable" instead of a false "diverges from the oracle" failure. */
+    supports(journey) {
+        const interactions = journey.interactions.length > 0 ? journey.interactions : [{ action: "run" }];
+        const shapeOk = interactions.length === 1 && interactions[0].action === "run";
+        return shapeOk && this.isAvailable();
+    }
+    /** True when Playwright and its Chromium binary are actually available in
+     * this environment — lets callers (`compare.ts`, tests) skip cleanly
+     * instead of failing the whole run. */
+    isAvailable() {
+        const repoRoot = findRepoRoot();
+        const webDir = join(repoRoot, "web");
+        return (existsSync(join(webDir, CONFIG_REL)) &&
+            resolvePlaywrightBin(repoRoot, webDir) !== null);
+    }
+    async run(journey) {
+        if (!this.supports(journey)) {
+            throw new Error(`journey "${journey.manifest.name}": browser driver only supports a ` +
+                `single, unscripted "run" interaction`);
+        }
+        const repoRoot = findRepoRoot();
+        const webDir = join(repoRoot, "web");
+        const playwrightBin = resolvePlaywrightBin(repoRoot, webDir);
+        if (!playwrightBin || !existsSync(join(webDir, CONFIG_REL))) {
+            throw new Error(`journey "${journey.manifest.name}": browser driver unavailable — ` +
+                `Playwright is not installed (root and web node_modules/.bin both ` +
+                `missing "playwright") or ${CONFIG_REL} is missing from web/`);
+        }
+        const outDir = await mkdtemp(join(tmpdir(), "nodetool-reliability-browser-"));
+        try {
+            const graphPath = join(outDir, "_graph.json");
+            await writeFile(graphPath, JSON.stringify({ graph: journey.workflow }), "utf8");
+            const timeoutMs = journey.manifest.timeoutMs;
+            const env = {
+                ...process.env,
+                NODETOOL_DEBUG_GRAPH: graphPath,
+                NODETOOL_DEBUG_OUT: outDir,
+                NODETOOL_DEBUG_PARAMS: JSON.stringify(journey.manifest.params ?? {}),
+                NODETOOL_DEBUG_TIMEOUT: String(timeoutMs)
+            };
+            const killTimeoutMs = Math.max(timeoutMs + 60_000, DEFAULT_TIMEOUT_MS);
+            const isWindows = process.platform === "win32";
+            let output = "";
+            await new Promise((resolvePromise) => {
+                const child = spawn(playwrightBin, ["test", "-c", CONFIG_REL], {
+                    cwd: webDir,
+                    env,
+                    stdio: ["ignore", "pipe", "pipe"],
+                    ...(isWindows ? { shell: true } : { detached: true })
+                });
+                const onChunk = (buf) => (output += buf.toString());
+                child.stdout?.on("data", onChunk);
+                child.stderr?.on("data", onChunk);
+                const timer = setTimeout(() => {
+                    killChild(child);
+                    resolvePromise();
+                }, killTimeoutMs);
+                child.on("error", () => {
+                    clearTimeout(timer);
+                    resolvePromise();
+                });
+                child.on("exit", () => {
+                    clearTimeout(timer);
+                    resolvePromise();
+                });
+            });
+            const recordPath = join(outDir, "record.json");
+            if (!existsSync(recordPath)) {
+                throw new Error(`journey "${journey.manifest.name}": browser driver produced no ` +
+                    `record.json — check that the web app builds and Chromium is ` +
+                    `installed\n--- playwright output ---\n${output.trimEnd()}`);
+            }
+            const record = JSON.parse(await readFile(recordPath, "utf8"));
+            return runRecordFromBrowserRecord(record, { journeyId: journey.manifest.name });
+        }
+        finally {
+            await rm(outDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/drivers/browser.js.map

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

package/dist/drivers/cli.d.ts

@@ -0,0 +1,13 @@
+import type { Journey } from "../core/journey.js";
+import { type RunRecord } from "../core/record.js";
+import type { RunDriver } from "./types.js";
+/** True when a journey is a single, unscripted `run` — the only shape
+ * `nodetool debug` (and so this driver) can execute. Exported for `compare.ts`
+ * and tests to check without constructing a driver. */
+export declare function cliDriverSupports(journey: Journey): boolean;
+export declare class CliDriver implements RunDriver {
+    readonly name = "cli";
+    supports(journey: Journey): boolean;
+    run(journey: Journey): Promise<RunRecord>;
+}
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/drivers/cli.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;uDAEuD;AACvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,qBAAa,SAAU,YAAW,SAAS;IACzC,QAAQ,CAAC,IAAI,SAAS;IAEtB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAElC;IAEK,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAsD9C;CACF"}

package/dist/drivers/cli.js

@@ -0,0 +1,82 @@
+/**
+ * CLI driver (§12) — spawns the real `nodetool debug` command (via `tsx`,
+ * `spawn-cli.ts`) against the journey's workflow, then converts the debug
+ * bundle it writes (`report.json` + `server/messages.jsonl`) into a
+ * `RunRecord` with `loadRunRecordFromDebugBundle` (`core/record.ts`, grown by
+ * C1 for exactly this "debug bundle round-trips into a RunRecord" purpose).
+ *
+ * `nodetool debug` has no scripted-interaction surface of its own — it runs a
+ * workflow once, start to finish, with a fixed params bag. `supports()`
+ * reflects that: only journeys whose interactions are a single `"run"` (or
+ * the implicit one every driver assumes when a journey declares none) can
+ * run on this surface; `cancel`/`stream_input`/`reconnect` journeys report
+ * "not applicable" instead of erroring.
+ */
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { loadRunRecordFromDebugBundle } from "../core/record.js";
+import { spawnNodetoolCli } from "./spawn-cli.js";
+function effectiveInteractions(journey) {
+    return journey.interactions.length > 0 ? journey.interactions : [{ action: "run" }];
+}
+/** True when a journey is a single, unscripted `run` — the only shape
+ * `nodetool debug` (and so this driver) can execute. Exported for `compare.ts`
+ * and tests to check without constructing a driver. */
+export function cliDriverSupports(journey) {
+    const interactions = effectiveInteractions(journey);
+    return interactions.length === 1 && interactions[0].action === "run";
+}
+export class CliDriver {
+    name = "cli";
+    supports(journey) {
+        return cliDriverSupports(journey);
+    }
+    async run(journey) {
+        if (!this.supports(journey)) {
+            throw new Error(`journey "${journey.manifest.name}": cli driver only supports a single, ` +
+                `unscripted "run" interaction — "nodetool debug" has no cancel/` +
+                `stream_input/reconnect surface`);
+        }
+        const bundleDir = await mkdtemp(join(tmpdir(), "nodetool-reliability-cli-"));
+        try {
+            const workflowPath = join(bundleDir, "workflow.json");
+            await writeFile(workflowPath, JSON.stringify(journey.workflow), "utf8");
+            const timeoutMs = journey.manifest.timeoutMs + 30_000;
+            const { code, stdout, stderr } = await spawnNodetoolCli([
+                "debug",
+                workflowPath,
+                "--params",
+                JSON.stringify(journey.manifest.params ?? {}),
+                "--out",
+                bundleDir,
+                "--json"
+            ], timeoutMs);
+            // `nodetool debug` exits non-zero on a failed/cancelled *journey*
+            // outcome too (e.g. error-in-one-branch legitimately expects "failed")
+            // — that isn't a driver failure. Only a bundle the harness can't read
+            // back is fatal here.
+            let record;
+            try {
+                record = await loadRunRecordFromDebugBundle(bundleDir, {
+                    journeyId: journey.manifest.name
+                });
+            }
+            catch (err) {
+                throw new Error(`journey "${journey.manifest.name}": cli driver produced no readable ` +
+                    `debug bundle (exit ${code})\n--- stdout ---\n${stdout}\n` +
+                    `--- stderr ---\n${stderr}\noriginal error: ${String(err)}`);
+            }
+            return {
+                ...record,
+                surface: this.name,
+                params: journey.manifest.params,
+                frames: record.frames.map((frame) => ({ ...frame, surface: this.name }))
+            };
+        }
+        finally {
+            await rm(bundleDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/drivers/cli.js.map

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

package/dist/drivers/fixture-nodes.d.ts

@@ -0,0 +1,124 @@
+/**
+ * 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, type NodeRegistry, type StreamingInputs, type StreamingOutputs } from "@nodetool-ai/node-sdk";
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+/**
+ * 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 declare class ReliabilityStreamingInputNode extends BaseNode {
+    static readonly nodeType = "nodetool.input.ReliabilityStreamingInput";
+    static readonly title = "Reliability Streaming Input";
+    static readonly description = "Test fixture: external input fed by pushInput/stream_input.";
+    value: unknown;
+    process(): Promise<Record<string, unknown>>;
+    genProcess(): AsyncGenerator<Record<string, unknown>>;
+}
+/** Collects every value streamed on its `value` input into one terminal array. */
+export declare class ReliabilityStreamSinkNode extends BaseNode {
+    static readonly nodeType = "test.reliability.StreamSink";
+    static readonly title = "Reliability Stream Sink";
+    static readonly description = "Test fixture: collects streamed values.";
+    static readonly isStreamingInput = true;
+    /** Never invoked directly — the kernel dispatches streaming-input nodes
+     * through `run()`. Required only to satisfy `BaseNode`'s abstract member. */
+    process(): Promise<Record<string, unknown>>;
+    run(inputs: StreamingInputs, outputs: StreamingOutputs): Promise<void>;
+}
+/**
+ * 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 declare class ReliabilityCancelProbeNode extends BaseNode {
+    static readonly nodeType = "test.reliability.CancelProbe";
+    static readonly title = "Reliability Cancel Probe";
+    static readonly description = "Test fixture: blocks until cancelled.";
+    static readonly isStreamingInput = true;
+    /** Never invoked directly — see {@link ReliabilityStreamSinkNode.process}. */
+    process(): Promise<Record<string, unknown>>;
+    run(inputs: StreamingInputs): Promise<void>;
+}
+/**
+ * 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 declare class ReliabilityStorageWriteNode extends BaseNode {
+    static readonly nodeType = "test.reliability.StorageWrite";
+    static readonly title = "Reliability Storage Write";
+    static readonly description = "Test fixture: writes bytes through context.storage (task D3's host-disk-full fault).";
+    key: string;
+    process(context?: ProcessingContext): Promise<Record<string, unknown>>;
+}
+/**
+ * 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 declare class ReliabilityListJoinNode extends BaseNode {
+    static readonly nodeType = "test.reliability.ListJoin";
+    static readonly title = "Reliability List Join";
+    static readonly description = "Test fixture: joins a list[str] input fed by a shared multi-edge handle.";
+    items: unknown;
+    process(): Promise<Record<string, unknown>>;
+}
+export declare const RELIABILITY_FIXTURE_NODES: readonly [typeof ReliabilityStreamingInputNode, typeof ReliabilityStreamSinkNode, typeof ReliabilityCancelProbeNode, typeof ReliabilityStorageWriteNode, typeof 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 declare function registerFixtureNodes(registry: NodeRegistry): void;
+//# sourceMappingURL=fixture-nodes.d.ts.map

package/dist/drivers/fixture-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-nodes.d.ts","sourceRoot":"","sources":["../../src/drivers/fixture-nodes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,QAAQ,EAER,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA8B,SAAQ,QAAQ;IACzD,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA8C;IACtE,MAAM,CAAC,QAAQ,CAAC,KAAK,iCAAiC;IACtD,MAAM,CAAC,QAAQ,CAAC,WAAW,iEACqC;IAGxD,KAAK,EAAE,OAAO,CAAC;IAEjB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhD;IAEM,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE3D;CACF;AAED,kFAAkF;AAClF,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,MAAM,CAAC,QAAQ,CAAC,QAAQ,iCAAiC;IACzD,MAAM,CAAC,QAAQ,CAAC,KAAK,6BAA6B;IAClD,MAAM,CAAC,QAAQ,CAAC,WAAW,6CAA6C;IACxE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,QAAQ;IAExC;iFAC6E;IACvE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhD;IAEK,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E;CACF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,0BAA2B,SAAQ,QAAQ;IACtD,MAAM,CAAC,QAAQ,CAAC,QAAQ,kCAAkC;IAC1D,MAAM,CAAC,QAAQ,CAAC,KAAK,8BAA8B;IACnD,MAAM,CAAC,QAAQ,CAAC,WAAW,2CAA2C;IACtE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,QAAQ;IAExC,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhD;IAEK,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhD;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,SAAQ,QAAQ;IACvD,MAAM,CAAC,QAAQ,CAAC,QAAQ,mCAAmC;IAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,+BAA+B;IACpD,MAAM,CAAC,QAAQ,CAAC,WAAW,0FAC8D;IAGjF,GAAG,EAAE,MAAM,CAAC;IAEd,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAY3E;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,+BAA+B;IACvD,MAAM,CAAC,QAAQ,CAAC,KAAK,2BAA2B;IAChD,MAAM,CAAC,QAAQ,CAAC,WAAW,8EACkD;IAGrE,KAAK,EAAE,OAAO,CAAC;IAEjB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGhD;CACF;AAED,eAAO,MAAM,yBAAyB,0LAM5B,CAAC;AAEX;;;0BAG0B;AAC1B,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAIjE"}