@moltzap/protocol 2026.401.0 → 2026.425.0

package/dist/testing/test-client.js

@@ -0,0 +1,266 @@
+/**
+ * TestClient — connects to a REAL MoltZap server URL and drives the wire.
+ *
+ * Per D1 (WS-only) and Invariant I1 (primitives never bypass the wire),
+ * every request is serialized and pushed through a real WebSocket transport
+ * — `@effect/platform/Socket.makeWebSocket` backed by
+ * `@effect/platform-node/NodeSocket.layerWebSocketConstructor` so the wire
+ * bytes match `packages/client`'s real production path.
+ *
+ * Satisfies AC2. Consumed by Tier A / B / C / D / E properties.
+ */
+import { Chunk, Context, Deferred, Duration, Effect, Exit, Ref, Scope, Stream, } from "effect";
+import * as Socket from "@effect/platform/Socket";
+import * as NodeSocket from "@effect/platform-node/NodeSocket";
+import { PROTOCOL_VERSION } from "../version.js";
+import { makeCaptureBuffer, recordFrame, recordMalformed, } from "./captures.js";
+import { decodeFrame, encodeFrame, malformFrame, } from "./codec.js";
+import { FrameSchemaError, RpcResponseError, RpcTimeoutError, TransportClosedError, TransportIoError, } from "./errors.js";
+/** Context tag so property code can `Effect.serviceWith(TestClient, …)`. */
+export const TestClient = Context.GenericTag("@moltzap/protocol/testing/TestClient");
+let requestIdCounter = 0;
+function nextRequestId() {
+    requestIdCounter += 1;
+    return `tc-${Date.now().toString(36)}-${requestIdCounter.toString(36)}`;
+}
+/**
+ * Open a real WS connection to `config.serverUrl`, complete the `connect`
+ * handshake, and yield a `TestClient`. The surrounding `Scope` owns the
+ * socket; releasing it closes the WS and drains captures.
+ */
+export function makeTestClient(config) {
+    return Effect.gen(function* () {
+        const captures = yield* makeCaptureBuffer({
+            capacity: config.captureCapacity,
+        });
+        const pending = new Map();
+        const closeRef = yield* Ref.make({
+            closed: false,
+            code: 0,
+            reason: "",
+        });
+        const eventQueue = yield* Ref.make([]);
+        // Acquire the WS socket via @effect/platform. The Node WebSocket
+        // constructor layer is provided via `Effect.provide` at each use site
+        // so the test harness stays self-contained.
+        const socket = yield* Socket.makeWebSocket(config.serverUrl, {
+            openTimeout: Duration.millis(config.defaultTimeoutMs),
+        }).pipe(Effect.provide(NodeSocket.layerWebSocketConstructor), Effect.mapError((err) => new TransportIoError({ direction: "outbound", cause: err })));
+        const writer = yield* socket.writer.pipe(Effect.mapError((err) => new TransportIoError({ direction: "outbound", cause: err })));
+        const handleInbound = (raw) => Effect.gen(function* () {
+            const decoded = yield* Effect.either(decodeFrame(raw, "inbound"));
+            if (decoded._tag === "Left") {
+                yield* recordMalformed(captures, raw, "bit-flip");
+                return;
+            }
+            const frame = decoded.right;
+            yield* recordFrame(captures, "inbound", raw, frame);
+            if (frame.type === "response") {
+                const def = pending.get(frame.id);
+                if (def !== undefined) {
+                    pending.delete(frame.id);
+                    if (frame.error !== undefined) {
+                        yield* Deferred.fail(def, new RpcResponseError({
+                            method: "",
+                            requestId: frame.id,
+                            code: frame.error.code,
+                            message: frame.error.message,
+                            data: frame.error.data,
+                        }));
+                    }
+                    else {
+                        yield* Deferred.succeed(def, frame);
+                    }
+                }
+                return;
+            }
+            if (frame.type === "event") {
+                yield* Ref.update(eventQueue, (q) => [...q, frame]);
+            }
+        });
+        // Fork the reader fiber into the ambient scope. `socket.runRaw` yields
+        // every received string/bytes chunk; teardown is on scope close.
+        yield* Effect.forkScoped(socket
+            .runRaw((data) => {
+            const raw = typeof data === "string"
+                ? data
+                : new TextDecoder("utf-8").decode(data);
+            return handleInbound(raw);
+        })
+            .pipe(Effect.catchAllCause((cause) => Effect.gen(function* () {
+            const failure = cause.toString();
+            yield* Ref.set(closeRef, {
+                closed: true,
+                code: 1006,
+                reason: failure,
+            });
+            const closedErr = new TransportClosedError({
+                direction: "inbound",
+                code: 1006,
+                reason: failure,
+            });
+            for (const [id, def] of pending) {
+                pending.delete(id);
+                yield* Deferred.fail(def, closedErr);
+            }
+        }))));
+        const writeFrame = (raw) => Effect.gen(function* () {
+            const state = yield* Ref.get(closeRef);
+            if (state.closed) {
+                return yield* Effect.fail(new TransportClosedError({
+                    direction: "outbound",
+                    code: state.code,
+                    reason: state.reason,
+                }));
+            }
+            yield* writer(raw).pipe(Effect.mapError((err) => new TransportIoError({ direction: "outbound", cause: err })));
+        });
+        const sendRpc = (method, params, opts) => Effect.gen(function* () {
+            const id = nextRequestId();
+            const timeoutMs = opts?.timeoutMs ?? config.defaultTimeoutMs;
+            const request = {
+                type: "request",
+                jsonrpc: "2.0",
+                id,
+                method,
+                params,
+            };
+            const raw = encodeFrame(request);
+            const deferred = yield* Deferred.make();
+            pending.set(id, deferred);
+            yield* recordFrame(captures, "outbound", raw, request);
+            yield* writeFrame(raw);
+            const result = yield* Deferred.await(deferred).pipe(Effect.timeoutFail({
+                duration: Duration.millis(timeoutMs),
+                onTimeout: () => new RpcTimeoutError({ method, requestId: id, timeoutMs }),
+            }), Effect.ensuring(Effect.sync(() => {
+                pending.delete(id);
+            })));
+            if (result.type !== "response") {
+                return yield* Effect.fail(new FrameSchemaError({
+                    direction: "inbound",
+                    expected: "response",
+                    raw: encodeFrame(result),
+                    reason: "expected response frame for rpc reply",
+                }));
+            }
+            return result.result;
+        });
+        const takeEvent = (eventName) => Ref.modify(eventQueue, (events) => {
+            const idx = events.findIndex((event) => event.event === eventName);
+            if (idx === -1)
+                return [null, events];
+            const event = events[idx];
+            return [event, [...events.slice(0, idx), ...events.slice(idx + 1)]];
+        });
+        const waitForEvent = (eventName, timeoutMs = 5000) => Effect.gen(function* () {
+            while (true) {
+                const event = yield* takeEvent(eventName);
+                if (event !== null)
+                    return event;
+                const state = yield* Ref.get(closeRef);
+                if (state.closed) {
+                    return yield* Effect.fail(new Error(`Connection closed while waiting for event: ${eventName}`));
+                }
+                yield* Effect.sleep(Duration.millis(10));
+            }
+        }).pipe(Effect.timeoutFail({
+            duration: Duration.millis(timeoutMs),
+            onTimeout: () => new Error(`Timeout waiting for event: ${eventName}`),
+        }));
+        /**
+         * Send malformed bytes and await the server's reaction. Registers the
+         * request id in `pending` so a typed `RpcResponseError` surfaces
+         * through the same path as valid RPCs; if the server drops the frame
+         * without responding, resolves `null` after the quiescence window.
+         *
+         * The distinction is observable: `null` means "drop" (the property
+         * should assert no state poisoning followed); a returned
+         * `RpcResponseError` means the server parsed enough to reply with a
+         * typed error. Either is acceptable per Tier A4's contract.
+         */
+        const sendMalformed = (opts) => Effect.gen(function* () {
+            const id = nextRequestId();
+            const baseFrame = {
+                type: "request",
+                jsonrpc: "2.0",
+                id,
+                method: opts.baseMethod,
+                params: {},
+            };
+            const raw = malformFrame(baseFrame, opts.kind, opts.seed);
+            const deferred = yield* Deferred.make();
+            pending.set(id, deferred);
+            yield* recordMalformed(captures, raw, opts.kind);
+            yield* writeFrame(raw);
+            const waitMs = config.malformedQuiescenceMs ?? 500;
+            // Race the pending Deferred against a quiescence timeout. Clean up
+            // the pending entry on both legs so no slot leaks when the server
+            // drops silently.
+            const outcome = yield* Effect.raceFirst(Deferred.await(deferred).pipe(Effect.matchEffect({
+                onSuccess: () => Effect.succeed(null),
+                onFailure: (err) => err._tag === "TestingRpcResponseError"
+                    ? Effect.succeed(err)
+                    : Effect.fail(err),
+            })), Effect.succeed(null).pipe(Effect.delay(Duration.millis(waitMs)))).pipe(Effect.ensuring(Effect.sync(() => {
+                pending.delete(id);
+            })));
+            return outcome;
+        });
+        // Event stream — repeatedly drain `eventQueue`, ending when the WS closes.
+        const events = Stream.unwrap(Effect.sync(() => {
+            const pullOne = Effect.gen(function* () {
+                while (true) {
+                    const state = yield* Ref.get(closeRef);
+                    if (state.closed) {
+                        return yield* Effect.fail(new TransportClosedError({
+                            direction: "inbound",
+                            code: state.code,
+                            reason: state.reason,
+                        }));
+                    }
+                    const q = yield* Ref.getAndSet(eventQueue, []);
+                    if (q.length > 0)
+                        return q;
+                    yield* Effect.sleep(Duration.millis(10));
+                }
+            });
+            return Stream.repeatEffectChunk(pullOne.pipe(Effect.map((arr) => Chunk.fromIterable(arr))));
+        }));
+        const client = {
+            sendRpc,
+            sendMalformed,
+            events,
+            captures,
+            snapshot: captures.snapshot,
+            waitForEvent,
+            drainEvents: Ref.getAndSet(eventQueue, []),
+        };
+        // Auto-connect handshake (auth/connect). Matches packages/client's
+        // real shape — `agentKey` + `minProtocol` + `maxProtocol`. Tolerant
+        // of typed rejections so properties that explicitly drive
+        // unauthenticated traffic (e.g., authority-negative) can skip
+        // autoConnect without the acquire path faulting.
+        if (config.autoConnect !== false) {
+            const handshakeParams = {
+                agentKey: config.agentKey,
+                minProtocol: PROTOCOL_VERSION,
+                maxProtocol: PROTOCOL_VERSION,
+            };
+            const handshake = sendRpc("auth/connect", handshakeParams).pipe(Effect.catchTag("TestingRpcTimeoutError", () => Effect.void), Effect.catchTag("TestingFrameSchemaError", () => Effect.void), Effect.catchTag("TestingRpcResponseError", () => Effect.void));
+            yield* handshake;
+        }
+        return client;
+    });
+}
+export function makeCloseableTestClient(config) {
+    return Effect.gen(function* () {
+        const scope = yield* Scope.make();
+        const client = yield* Scope.extend(makeTestClient(config), scope);
+        return {
+            ...client,
+            close: Scope.close(scope, Exit.void),
+        };
+    });
+}
+//# sourceMappingURL=test-client.js.map

package/dist/testing/test-client.js.map

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

package/dist/testing/test-server.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TestServer — accepts real client WebSocket connections and lets property
+ * code script arbitrary server-side traffic (valid events, malformed
+ * frames, delayed / out-of-order sequences).
+ *
+ * Per D1 (WS-only) and Invariant I1, TestServer binds a real
+ * `@effect/platform-node/NodeSocketServer.makeWebSocket` so the wire bytes
+ * match `packages/server`'s real production path. TestServer is *not* an
+ * in-process counterpart of TestClient; it exists to exercise real client
+ * code (`packages/client`, `openclaw-channel`, `nanoclaw-channel`, arena).
+ *
+ * Satisfies AC3. Consumed by Tier A (A2), Tier B (server-emitted event
+ * replay), and Tier E E2 (schema-exhaustive fuzz).
+ */
+import { Context, Effect, type Scope } from "effect";
+import type { EventFrame, ResponseFrame } from "../schema/frames.js";
+import { type CapturedFrame, type CaptureBuffer } from "./captures.js";
+import { type MalformedFrameKind } from "./codec.js";
+import { FrameSchemaError, TransportClosedError, TransportIoError } from "./errors.js";
+export interface TestServerConfig {
+    /** If 0, bind to an ephemeral port. */
+    readonly port: number;
+    /** Host string bound by the HTTP server; default `"127.0.0.1"`. */
+    readonly host: string;
+    readonly captureCapacity: number;
+}
+/**
+ * A single live client connection accepted by TestServer. Identity is by
+ * `connectionId` (monotonic), not by any agent-level claim — TestServer is
+ * below the identity layer.
+ */
+export interface TestServerConnection {
+    readonly connectionId: string;
+    readonly remoteAddr: string;
+    readonly inbound: CaptureBuffer;
+    readonly emitEvent: (event: EventFrame) => Effect.Effect<void, TransportIoError | FrameSchemaError>;
+    readonly emitResponse: (response: ResponseFrame) => Effect.Effect<void, TransportIoError | FrameSchemaError>;
+    readonly emitMalformed: (opts: {
+        readonly baseEvent: EventFrame;
+        readonly kind: MalformedFrameKind;
+        readonly seed: number;
+    }) => Effect.Effect<void, TransportIoError>;
+    readonly close: (opts: {
+        readonly code: number;
+        readonly reason: string;
+    }) => Effect.Effect<void, TransportClosedError>;
+}
+export interface TestServer {
+    readonly wsUrl: string;
+    readonly accept: Effect.Effect<TestServerConnection, TransportIoError>;
+    readonly connections: Effect.Effect<ReadonlyArray<TestServerConnection>>;
+    readonly allInbound: CaptureBuffer;
+    readonly snapshot: Effect.Effect<ReadonlyArray<CapturedFrame>>;
+}
+export declare const TestServer: Context.Tag<TestServer, TestServer>;
+/**
+ * Bind an `@effect/platform` WebSocket server. The surrounding `Scope` owns
+ * the listener; releasing it closes every open connection, drains captures,
+ * and awaits port release.
+ */
+export declare function makeTestServer(config: TestServerConfig): Effect.Effect<TestServer, TransportIoError, Scope.Scope>;
+//# sourceMappingURL=test-server.d.ts.map

package/dist/testing/test-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-server.d.ts","sourceRoot":"","sources":["../../src/testing/test-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAO,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,UAAU,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,CAAC;IAC9D,QAAQ,CAAC,YAAY,EAAE,CACrB,QAAQ,EAAE,aAAa,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,CAAC;IAC9D,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE;QAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;QAC/B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;CAChE;AAED,eAAO,MAAM,UAAU,qCAEtB,CAAC;AA2EF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAiG1D"}

package/dist/testing/test-server.js

@@ -0,0 +1,134 @@
+/**
+ * TestServer — accepts real client WebSocket connections and lets property
+ * code script arbitrary server-side traffic (valid events, malformed
+ * frames, delayed / out-of-order sequences).
+ *
+ * Per D1 (WS-only) and Invariant I1, TestServer binds a real
+ * `@effect/platform-node/NodeSocketServer.makeWebSocket` so the wire bytes
+ * match `packages/server`'s real production path. TestServer is *not* an
+ * in-process counterpart of TestClient; it exists to exercise real client
+ * code (`packages/client`, `openclaw-channel`, `nanoclaw-channel`, arena).
+ *
+ * Satisfies AC3. Consumed by Tier A (A2), Tier B (server-emitted event
+ * replay), and Tier E E2 (schema-exhaustive fuzz).
+ */
+import { Context, Effect, Ref } from "effect";
+import * as NodeSocketServer from "@effect/platform-node/NodeSocketServer";
+import * as Socket from "@effect/platform/Socket";
+import { makeCaptureBuffer, mergeCaptures, recordFrame, recordMalformed, } from "./captures.js";
+import { decodeFrame, encodeFrame, malformFrame, } from "./codec.js";
+import { FrameSchemaError, TransportClosedError, TransportIoError, } from "./errors.js";
+export const TestServer = Context.GenericTag("@moltzap/protocol/testing/TestServer");
+let connectionCounter = 0;
+/**
+ * Build a `TestServerConnection` for a freshly-accepted socket. `writer`
+ * is acquired by the caller; the per-connection receive loop is driven
+ * separately via `sock.runRaw`.
+ */
+function makeConnection(writer, captureCapacity, remoteAddr) {
+    return Effect.gen(function* () {
+        connectionCounter += 1;
+        const connectionId = `conn-${connectionCounter}`;
+        const inbound = yield* makeCaptureBuffer({ capacity: captureCapacity });
+        const emit = (frame) => Effect.gen(function* () {
+            const raw = encodeFrame(frame);
+            // Validate on the way out as well — Invariant I3.
+            const check = yield* Effect.either(decodeFrame(raw, "outbound"));
+            if (check._tag === "Left") {
+                return yield* Effect.fail(check.left);
+            }
+            yield* writer(raw).pipe(Effect.mapError((err) => new TransportIoError({ direction: "outbound", cause: err })));
+            yield* recordFrame(inbound, "outbound", raw, frame);
+        });
+        return {
+            connectionId,
+            remoteAddr,
+            inbound,
+            emitEvent: (event) => emit(event),
+            emitResponse: (response) => emit(response),
+            emitMalformed: (opts) => Effect.gen(function* () {
+                const base = opts.baseEvent;
+                const raw = malformFrame(base, opts.kind, opts.seed);
+                yield* writer(raw).pipe(Effect.mapError((err) => new TransportIoError({ direction: "outbound", cause: err })));
+                yield* recordMalformed(inbound, raw, opts.kind);
+            }),
+            close: (opts) => writer(new Socket.CloseEvent(opts.code, opts.reason)).pipe(Effect.mapError((err) => new TransportClosedError({
+                direction: "outbound",
+                code: opts.code,
+                reason: `${opts.reason}: ${String(err)}`,
+            }))),
+        };
+    });
+}
+/**
+ * Bind an `@effect/platform` WebSocket server. The surrounding `Scope` owns
+ * the listener; releasing it closes every open connection, drains captures,
+ * and awaits port release.
+ */
+export function makeTestServer(config) {
+    return Effect.gen(function* () {
+        const serverState = yield* Ref.make([]);
+        const acceptQueue = yield* Ref.make([]);
+        const server = yield* NodeSocketServer.makeWebSocket({
+            port: config.port,
+            host: config.host,
+        }).pipe(Effect.mapError((err) => new TransportIoError({ direction: "inbound", cause: err })));
+        // Fork the accept loop into the ambient scope; scope closure tears down
+        // the listener and every per-connection fiber.
+        yield* Effect.forkScoped(server
+            .run((sock) => Effect.gen(function* () {
+            const writer = yield* sock.writer;
+            const conn = yield* makeConnection(writer, config.captureCapacity, "");
+            yield* Ref.update(serverState, (s) => [...s, conn]);
+            yield* Ref.update(acceptQueue, (q) => [...q, conn]);
+            yield* sock.runRaw((data) => Effect.gen(function* () {
+                const raw = typeof data === "string"
+                    ? data
+                    : new TextDecoder("utf-8").decode(data);
+                const decoded = yield* Effect.either(decodeFrame(raw, "inbound"));
+                if (decoded._tag === "Left") {
+                    yield* recordMalformed(conn.inbound, raw, "bit-flip");
+                    return;
+                }
+                yield* recordFrame(conn.inbound, "inbound", raw, decoded.right);
+            }));
+        }))
+            .pipe(Effect.ignore));
+        const addr = server.address;
+        if (addr._tag !== "TcpAddress") {
+            return yield* Effect.fail(new TransportIoError({
+                direction: "inbound",
+                cause: new Error(`expected TcpAddress, got ${addr._tag}`),
+            }));
+        }
+        const wsUrl = `ws://${addr.hostname}:${addr.port}`;
+        const accept = Effect.gen(function* () {
+            while (true) {
+                const q = yield* Ref.get(acceptQueue);
+                if (q.length > 0) {
+                    const [next, ...rest] = q;
+                    yield* Ref.set(acceptQueue, rest);
+                    if (next !== undefined)
+                        return next;
+                }
+                yield* Effect.sleep("10 millis");
+            }
+        });
+        const allInbound = yield* mergeCaptures([]);
+        const snapshot = Effect.gen(function* () {
+            const conns = yield* Ref.get(serverState);
+            const snaps = yield* Effect.forEach(conns, (c) => c.inbound.snapshot, {
+                concurrency: "unbounded",
+            });
+            return snaps.flat();
+        });
+        return {
+            wsUrl,
+            accept,
+            connections: Ref.get(serverState),
+            allInbound,
+            snapshot,
+        };
+    });
+}
+//# sourceMappingURL=test-server.js.map

package/dist/testing/test-server.js.map

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

package/dist/testing/toxics/client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Toxiproxy control-plane client.
+ *
+ * Per design doc §5 "Dependency choices", we talk to Toxiproxy's HTTP
+ * control API directly (no `toxiproxy-node-client` dep). The API surface
+ * we need is small — create proxy, add toxic, remove toxic, delete proxy —
+ * and a thin Effect wrapper keeps us from taking a 4-year-stale MIT
+ * package.
+ *
+ * Satisfies Goal 5 + AC8. Consumed by the Tier D runner.
+ */
+import { Effect, Scope } from "effect";
+import { ToxicControlError } from "../errors.js";
+import type { ToxicProfile } from "./profile.js";
+export interface ToxiproxyConfig {
+    /** Control-plane URL, e.g. `http://localhost:8474`. */
+    readonly apiUrl: string;
+}
+/**
+ * A live toxic attachment. Scoped: acquiring adds the toxic to the proxy,
+ * releasing the scope removes it. Tier D properties acquire a
+ * `ToxicHandle` inside `Effect.scoped` so a crashed property still cleans
+ * up.
+ */
+export interface ToxicHandle {
+    readonly name: string;
+    readonly profile: ToxicProfile;
+}
+/**
+ * A live proxy that sits between TestClient and the real server (or
+ * between real client and TestServer). Acquiring the scope allocates an
+ * ephemeral port and registers the proxy; releasing deletes it.
+ */
+export interface Proxy {
+    /** Upstream (real server) address the proxy forwards to. */
+    readonly upstream: string;
+    /** Client-facing URL (`ws://127.0.0.1:<ephemeralPort>`). */
+    readonly listenUrl: string;
+    /** Attach a toxic inside a Scope; removed on release. */
+    readonly withToxic: (profile: ToxicProfile) => Effect.Effect<ToxicHandle, ToxicControlError, Scope.Scope>;
+}
+export interface ToxiproxyClient {
+    /** Create a scoped proxy; teardown on release. */
+    readonly proxy: (opts: {
+        readonly name: string;
+        readonly upstream: string;
+    }) => Effect.Effect<Proxy, ToxicControlError, Scope.Scope>;
+    /** Probe: control plane reachable. */
+    readonly ping: Effect.Effect<void, ToxicControlError>;
+}
+export declare function makeToxiproxyClient(config: ToxiproxyConfig): Effect.Effect<ToxiproxyClient, ToxicControlError>;
+//# sourceMappingURL=client.d.ts.map

package/dist/testing/toxics/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/testing/toxics/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,CAClB,OAAO,EAAE,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;CACvD;AAuFD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,GACtB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CA8EnD"}