@nodetool-ai/reliability-harness 0.8.1

package/dist/faults/net-proxy.js.map

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

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

@@ -0,0 +1,12 @@
+import type { FaultModule } from "./types.js";
+/** Provider id journeys wire an LLM node's `model.provider` to in order to
+ * exercise a provider fault (kernel + ws-server share this process-wide
+ * registration). Overridable per-fault via `fault.params.providerId`. */
+export declare const RELIABILITY_FAULT_PROVIDER_ID = "reliability-fault-llm";
+export declare const PROVIDER_FAULT_MODULES: readonly FaultModule[];
+/** Registers every provider-seam fault module. Called once from
+ * `faults/index.ts`'s module-load side effect (mirrors `registerBaseNodes`'
+ * "call once, own module state" shape) — safe to call again (registration is
+ * last-write-wins, same as `NodeRegistry.register`). */
+export declare function registerProviderFaultModules(): void;
+//# sourceMappingURL=provider-faults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-faults.d.ts","sourceRoot":"","sources":["../../src/faults/provider-faults.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAgB,WAAW,EAAiB,MAAM,YAAY,CAAC;AAE3E;;yEAEyE;AACzE,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AAsGrE,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAEG,CAAC;AAE7D;;;wDAGwD;AACxD,wBAAgB,4BAA4B,IAAI,IAAI,CAInD"}

package/dist/faults/provider-faults.js

@@ -0,0 +1,110 @@
+/**
+ * Provider-seam fault modules (docs/RELIABILITY_ARCHITECTURE.md §9; task D1).
+ *
+ * Each of the seven `provider-*` fault names in `cli.ts`'s `KNOWN_FAULT_TYPES`
+ * maps to one `ProviderFault` kind the fault-capable `CassetteProvider`
+ * (`@nodetool-ai/runtime`) understands. `configure()` registers a
+ * `FaultCassetteProvider` under a fixed provider id
+ * ({@link RELIABILITY_FAULT_PROVIDER_ID}) into the process-wide provider
+ * registry (`@nodetool-ai/runtime`'s `registerProvider` — shared by the
+ * kernel driver's in-process session and the ws-server driver's in-process
+ * test server alike, since both run in this same Node process), and the
+ * teardown restores whatever was registered there before (or unregisters it
+ * if nothing was).
+ *
+ * A journey exercises this fault by giving an LLM node's `model.provider`
+ * the value {@link RELIABILITY_FAULT_PROVIDER_ID} (see
+ * `reliability/journeys/provider-failure-mid-stream/workflow.json`).
+ */
+import { CassetteProvider, FakeProvider, getRegisteredProvider, registerProvider, unregisterProvider } from "@nodetool-ai/runtime";
+import { registerFaultModule } from "./registry.js";
+/** Provider id journeys wire an LLM node's `model.provider` to in order to
+ * exercise a provider fault (kernel + ws-server share this process-wide
+ * registration). Overridable per-fault via `fault.params.providerId`. */
+export const RELIABILITY_FAULT_PROVIDER_ID = "reliability-fault-llm";
+/** `cli.ts`'s `KNOWN_FAULT_TYPES` `provider-*` entries, mapped to the
+ * `ProviderFault.kind` the cassette provider understands. */
+const FAULT_KIND_BY_NAME = {
+    "provider-429": "http-429",
+    "provider-500": "http-500",
+    "provider-timeout": "timeout",
+    "provider-truncated-stream": "truncated-stream",
+    "provider-malformed-sse": "malformed-chunk",
+    "provider-slow-drip": "slow-drip",
+    "provider-cost-omission": "cost-omission"
+};
+const FAULT_FIXTURE_TEXT = "This is a deterministic reliability-harness fixture response used to " +
+    "exercise provider fault injection end to end.";
+/** A `new (kwargs) => BaseProvider` shape (`registerProvider`'s contract) that
+ * wraps a fresh `FakeProvider` in a fault-scripted `CassetteProvider`. Kwargs
+ * carry the `ProviderFault` a given `getProvider()` call should apply — set
+ * per-registration by `configureProviderFault`, not per-instance by a caller. */
+class FaultCassetteProvider extends CassetteProvider {
+    constructor(kwargs = {}) {
+        super(new FakeProvider({
+            textResponse: FAULT_FIXTURE_TEXT,
+            shouldStream: true,
+            chunkSize: 6
+        }), { mode: "auto", fault: kwargs.fault });
+    }
+}
+function faultParams(fault) {
+    return fault.params ?? {};
+}
+function providerIdFor(fault) {
+    const configured = faultParams(fault)["providerId"];
+    return typeof configured === "string" && configured.length > 0
+        ? configured
+        : RELIABILITY_FAULT_PROVIDER_ID;
+}
+/** Builds the `ProviderFault` a fault module's `configure()` registers, from
+ * the fixed `kind` plus whatever numeric knobs the journey/`--faults` call
+ * supplied in `fault.params` (`afterChunks`, `delayMs`, `timeoutMs`,
+ * `retryAfterSeconds` — see `ProviderFault` in `cassette-provider.ts`). */
+function buildProviderFault(kind, fault) {
+    const params = faultParams(fault);
+    const numeric = (key) => {
+        const value = params[key];
+        return typeof value === "number" ? value : undefined;
+    };
+    return {
+        kind,
+        afterChunks: numeric("afterChunks"),
+        delayMs: numeric("delayMs"),
+        timeoutMs: numeric("timeoutMs"),
+        retryAfterSeconds: numeric("retryAfterSeconds")
+    };
+}
+function configureProviderFault(kind, ctx) {
+    const providerId = providerIdFor(ctx.fault);
+    const previous = getRegisteredProvider(providerId);
+    registerProvider(providerId, FaultCassetteProvider, {
+        fault: buildProviderFault(kind, ctx.fault)
+    });
+    return () => {
+        if (previous) {
+            registerProvider(providerId, previous.cls, previous.kwargs, previous.optionalKwargs);
+        }
+        else {
+            unregisterProvider(providerId);
+        }
+    };
+}
+function makeProviderFaultModule(name, kind) {
+    return {
+        name,
+        seam: "provider",
+        configure: (ctx) => configureProviderFault(kind, ctx)
+    };
+}
+export const PROVIDER_FAULT_MODULES = Object.entries(FAULT_KIND_BY_NAME).map(([name, kind]) => makeProviderFaultModule(name, kind));
+/** Registers every provider-seam fault module. Called once from
+ * `faults/index.ts`'s module-load side effect (mirrors `registerBaseNodes`'
+ * "call once, own module state" shape) — safe to call again (registration is
+ * last-write-wins, same as `NodeRegistry.register`). */
+export function registerProviderFaultModules() {
+    for (const module of PROVIDER_FAULT_MODULES) {
+        registerFaultModule(module);
+    }
+}
+//# sourceMappingURL=provider-faults.js.map

package/dist/faults/provider-faults.js.map

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

package/dist/faults/registry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Fault module registry (task D1) — name -> {@link FaultModule} lookup.
+ * `compare.ts` resolves a journey's declared (or `--faults`-selected) fault
+ * names against this map; a name with no registered module is reported as
+ * "unknown" the same way `compare.ts` already reports unknown invariants,
+ * rather than silently no-oping.
+ *
+ * D2/D3 add their own module files and call {@link registerFaultModule} from
+ * them (see `index.ts`'s barrel) — no edits needed here.
+ */
+import type { FaultModule } from "./types.js";
+export declare function registerFaultModule(module: FaultModule): void;
+export declare function getFaultModule(name: string): FaultModule | undefined;
+export declare function listFaultModuleNames(): string[];
+/** Test-only escape hatch: clears every registered module. */
+export declare function clearFaultModulesForTests(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/faults/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/faults/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAE7D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/faults/registry.js

@@ -0,0 +1,15 @@
+const FAULT_MODULES = new Map();
+export function registerFaultModule(module) {
+    FAULT_MODULES.set(module.name, module);
+}
+export function getFaultModule(name) {
+    return FAULT_MODULES.get(name);
+}
+export function listFaultModuleNames() {
+    return Array.from(FAULT_MODULES.keys()).sort();
+}
+/** Test-only escape hatch: clears every registered module. */
+export function clearFaultModulesForTests() {
+    FAULT_MODULES.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/faults/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/faults/registry.ts"],"names":[],"mappings":"AAYA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,yBAAyB;IACvC,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/faults/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Fault module plumbing (docs/RELIABILITY_ARCHITECTURE.md §9; task D1).
+ *
+ * A `FaultModule` is the harness's one extension point for fault injection:
+ * one module per named fault (matching `cli.ts`'s `KNOWN_FAULT_TYPES` and a
+ * journey's `faults` block entries, `core/journey.ts`'s `JourneyFault`),
+ * registered by name in `registry.ts`. `compare.ts` looks a fault up by name
+ * and calls `configure()` immediately before the driver run it applies to,
+ * then calls the returned teardown immediately after — so a fault's
+ * process-global side effects (today: the provider registry) never leak
+ * across surfaces or across journeys.
+ *
+ * D1 ships the "provider" seam (`provider-faults.ts`). D2 (WS proxy) and D3
+ * (bridge/host) add their own module files + `registerFaultModule` calls
+ * without touching this file, `registry.ts`, or `compare.ts`'s wiring.
+ */
+import type { Journey, JourneyFault, JourneySurface } from "../core/journey.js";
+/** The five fault seams §9 names. */
+export type FaultSeam = "provider" | "ws" | "bridge" | "host" | "client";
+/** What a `FaultModule.configure()` call is being asked to apply. */
+export interface FaultContext {
+    journey: Journey;
+    /** The surface about to run (or that just ran) with this fault applied. */
+    surface: JourneySurface | string;
+    /** The journey-declared (or `--faults`-synthesized) fault entry itself —
+     * carries `type`, the optional `surface` restriction, and `params`. */
+    fault: JourneyFault;
+}
+/** Undoes whatever `configure()` did. Always called once per `configure()`
+ * call, even when the driver run it wrapped threw. */
+export type FaultTeardown = () => void | Promise<void>;
+export interface FaultModule {
+    /** Matches a `JourneyFault.type` / `KNOWN_FAULT_TYPES` entry exactly. */
+    readonly name: string;
+    readonly seam: FaultSeam;
+    /** Applies the fault for the duration of one driver run. May be called
+     * many times concurrently-in-sequence (once per applicable surface) across
+     * one `compareJourney` call — implementations must not assume they're only
+     * ever configured once per process. */
+    configure(ctx: FaultContext): FaultTeardown | Promise<FaultTeardown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/faults/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhF,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzE,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC;IACjC;2EACuE;IACvE,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;sDACsD;AACtD,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB;;;2CAGuC;IACvC,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACtE"}

package/dist/faults/types.js

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

package/dist/faults/types.js.map

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

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

@@ -0,0 +1,6 @@
+import type { FaultModule } from "./types.js";
+export declare const WS_FAULT_MODULES: readonly FaultModule[];
+/** Registers every ws-seam fault module. Called once from `faults/index.ts`'s
+ * module-load side effect (mirrors `registerProviderFaultModules`). */
+export declare function registerWsFaultModules(): void;
+//# sourceMappingURL=ws-faults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ws-faults.d.ts","sourceRoot":"","sources":["../../src/faults/ws-faults.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAgB,WAAW,EAAiB,MAAM,YAAY,CAAC;AA+C3E,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAEG,CAAC;AAEvD;uEACuE;AACvE,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C"}

package/dist/faults/ws-faults.js

@@ -0,0 +1,48 @@
+import { getActiveWsProxyFault, setActiveWsProxyFault } from "./ws-proxy.js";
+import { registerFaultModule } from "./registry.js";
+/** `cli.ts`'s `KNOWN_FAULT_TYPES` `ws-*` entries, mapped to the
+ * `WsProxyFaultKind` `net-proxy.ts`'s proxy understands. */
+const FAULT_KIND_BY_NAME = {
+    "ws-drop-no-fin": "drop-no-fin",
+    "ws-delay": "delay",
+    "ws-reorder": "reorder",
+    "ws-fragment": "fragment",
+    "ws-stall-reads": "stall-reads",
+    "ws-abrupt-close": "abrupt-close"
+};
+function faultParams(fault) {
+    return fault.params ?? {};
+}
+function numericParam(params, key) {
+    const value = params[key];
+    return typeof value === "number" ? value : undefined;
+}
+function configureWsFault(kind, ctx) {
+    const params = faultParams(ctx.fault);
+    const previous = getActiveWsProxyFault();
+    setActiveWsProxyFault({
+        kind,
+        afterFrames: numericParam(params, "afterFrames"),
+        delayMs: numericParam(params, "delayMs"),
+        chunkBytes: numericParam(params, "chunkBytes")
+    });
+    return () => {
+        setActiveWsProxyFault(previous);
+    };
+}
+function makeWsFaultModule(name, kind) {
+    return {
+        name,
+        seam: "ws",
+        configure: (ctx) => configureWsFault(kind, ctx)
+    };
+}
+export const WS_FAULT_MODULES = Object.entries(FAULT_KIND_BY_NAME).map(([name, kind]) => makeWsFaultModule(name, kind));
+/** Registers every ws-seam fault module. Called once from `faults/index.ts`'s
+ * module-load side effect (mirrors `registerProviderFaultModules`). */
+export function registerWsFaultModules() {
+    for (const module of WS_FAULT_MODULES) {
+        registerFaultModule(module);
+    }
+}
+//# sourceMappingURL=ws-faults.js.map

package/dist/faults/ws-faults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-faults.js","sourceRoot":"","sources":["../../src/faults/ws-faults.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD;4DAC4D;AAC5D,MAAM,kBAAkB,GAA+C;IACrE,gBAAgB,EAAE,aAAa;IAC/B,UAAU,EAAE,OAAO;IACnB,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;IACzB,gBAAgB,EAAE,aAAa;IAC/B,iBAAiB,EAAE,cAAc;CAClC,CAAC;AAEF,SAAS,WAAW,CAAC,KAA4B;IAC/C,OAAO,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CACnB,MAA+B,EAC/B,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAsB,EAAE,GAAiB;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,qBAAqB,CAAC;QACpB,IAAI;QACJ,WAAW,EAAE,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC;QAChD,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QACxC,UAAU,EAAE,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC;KAC/C,CAAC,CAAC;IACH,OAAO,GAAG,EAAE;QACV,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,IAAsB;IAC7D,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA2B,MAAM,CAAC,OAAO,CACpE,kBAAkB,CACnB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvD;uEACuE;AACvE,MAAM,UAAU,sBAAsB;IACpC,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/faults/ws-proxy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WS-seam fault wiring (docs/RELIABILITY_ARCHITECTURE.md §9 "WS transport"
+ * row; task D2). `ws-faults.ts`'s `FaultModule.configure()` calls only know
+ * a `FaultContext` (journey/surface/fault) — never a driver instance
+ * (`faults/types.ts`'s contract, which D2 doesn't touch) — so, exactly like
+ * `provider-faults.ts` registers a fault-scripted provider into a
+ * process-wide registry the driver already consults by provider id, this
+ * module holds one process-wide "is a ws fault active right now" slot that
+ * `drivers/ws-server.ts` consults on every run. Nothing here talks to a
+ * socket directly; `net-proxy.ts` is the mechanism, this is the seam.
+ */
+import { WsFaultProxy, type WsProxyFaultConfig } from "./net-proxy.js";
+/** Set by a `ws-faults.ts` module's `configure()`; cleared by its teardown. */
+export declare function setActiveWsProxyFault(config: WsProxyFaultConfig | null): void;
+export declare function getActiveWsProxyFault(): WsProxyFaultConfig | null;
+/** A running proxy front-end plus enough to tear it down and (for the
+ * client-reconnect-mid-run journey, outside the declarative fault matrix)
+ * sever its connections on demand. */
+export interface WsProxyFrontEnd {
+    port: number;
+    proxy: WsFaultProxy;
+    close: () => Promise<void>;
+}
+/**
+ * Called by `WsServerDriver.run()` right after it starts the real hermetic
+ * server: when a ws-seam fault is currently active, spins up a
+ * {@link WsFaultProxy} in front of `targetPort` and returns its listening
+ * port — the driver connects its client there instead of straight to the
+ * server, so every ws-* fault applies transparently to the existing driver
+ * without the driver knowing which fault kind it is. Returns `null` when no
+ * ws fault is active (the overwhelming majority of runs), in which case the
+ * driver connects directly exactly as it did before D2 — this function is a
+ * no-op on the hot path.
+ */
+export declare function maybeFrontWithProxy(targetHost: string, targetPort: number): Promise<WsProxyFrontEnd | null>;
+//# sourceMappingURL=ws-proxy.d.ts.map

package/dist/faults/ws-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-proxy.d.ts","sourceRoot":"","sources":["../../src/faults/ws-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIvE,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE7E;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED;;sCAEsC;AACtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAMjC"}

package/dist/faults/ws-proxy.js

@@ -0,0 +1,40 @@
+/**
+ * WS-seam fault wiring (docs/RELIABILITY_ARCHITECTURE.md §9 "WS transport"
+ * row; task D2). `ws-faults.ts`'s `FaultModule.configure()` calls only know
+ * a `FaultContext` (journey/surface/fault) — never a driver instance
+ * (`faults/types.ts`'s contract, which D2 doesn't touch) — so, exactly like
+ * `provider-faults.ts` registers a fault-scripted provider into a
+ * process-wide registry the driver already consults by provider id, this
+ * module holds one process-wide "is a ws fault active right now" slot that
+ * `drivers/ws-server.ts` consults on every run. Nothing here talks to a
+ * socket directly; `net-proxy.ts` is the mechanism, this is the seam.
+ */
+import { WsFaultProxy } from "./net-proxy.js";
+let activeFault = null;
+/** Set by a `ws-faults.ts` module's `configure()`; cleared by its teardown. */
+export function setActiveWsProxyFault(config) {
+    activeFault = config;
+}
+export function getActiveWsProxyFault() {
+    return activeFault;
+}
+/**
+ * Called by `WsServerDriver.run()` right after it starts the real hermetic
+ * server: when a ws-seam fault is currently active, spins up a
+ * {@link WsFaultProxy} in front of `targetPort` and returns its listening
+ * port — the driver connects its client there instead of straight to the
+ * server, so every ws-* fault applies transparently to the existing driver
+ * without the driver knowing which fault kind it is. Returns `null` when no
+ * ws fault is active (the overwhelming majority of runs), in which case the
+ * driver connects directly exactly as it did before D2 — this function is a
+ * no-op on the hot path.
+ */
+export async function maybeFrontWithProxy(targetHost, targetPort) {
+    const config = activeFault;
+    if (!config)
+        return null;
+    const proxy = new WsFaultProxy(targetHost, targetPort, config);
+    const port = await proxy.listen();
+    return { port, proxy, close: () => proxy.close() };
+}
+//# sourceMappingURL=ws-proxy.js.map

package/dist/faults/ws-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-proxy.js","sourceRoot":"","sources":["../../src/faults/ws-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAA2B,MAAM,gBAAgB,CAAC;AAEvE,IAAI,WAAW,GAA8B,IAAI,CAAC;AAElD,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,MAAiC;IACrE,WAAW,GAAG,MAAM,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,WAAW,CAAC;AACrB,CAAC;AAWD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./core/journey.js";
+export * from "./core/record.js";
+export * from "./core/normalize.js";
+export * from "./core/diff.js";
+export * from "./core/stable-json.js";
+export * from "./core/golden.js";
+export * from "./core/invariants/index.js";
+export * from "./drivers/index.js";
+export * from "./faults/index.js";
+export * from "./compare.js";
+export * from "./cli.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./core/journey.js";
+export * from "./core/record.js";
+export * from "./core/normalize.js";
+export * from "./core/diff.js";
+export * from "./core/stable-json.js";
+export * from "./core/golden.js";
+export * from "./core/invariants/index.js";
+export * from "./drivers/index.js";
+export * from "./faults/index.js";
+export * from "./compare.js";
+export * from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@nodetool-ai/reliability-harness",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "version": "0.8.1",
+  "description": "Reliability harness core: journey manifests, RunRecord, normalization, and per-channel stream diff (docs/RELIABILITY_ARCHITECTURE.md §12)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "test:watch": "node ../../scripts/run-vitest.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/base-nodes": "^0.8.1",
+    "@nodetool-ai/execution": "^0.8.1",
+    "@nodetool-ai/node-sdk": "^0.8.1",
+    "@nodetool-ai/protocol": "^0.8.1",
+    "@nodetool-ai/runtime": "^0.8.1",
+    "@nodetool-ai/storage": "^0.8.1",
+    "@nodetool-ai/websocket": "^0.8.1",
+    "ws": "^8.18.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@nodetool-ai/config": "*",
+    "@nodetool-ai/models": "*",
+    "@nodetool-ai/security": "*",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./drivers": {
+      "nodetool-dev": "./src/drivers/index.ts",
+      "types": "./dist/drivers/index.d.ts",
+      "import": "./dist/drivers/index.js",
+      "default": "./dist/drivers/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "reliability/harness"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "nodetool",
+    "reliability",
+    "harness",
+    "journey",
+    "run-record"
+  ]
+}