@moltzap/client 2026.414.0 → 2026.425.0

package/dist/runtime/close-info.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Close-metadata extraction for the WebSocket reader fiber.
+ *
+ * Responsibility: inspect an `Exit.Exit<void, Socket.SocketError>` produced by
+ * `Socket.runRaw(...)` and project it onto a caller-facing `CloseInfo`
+ * (WebSocket `{code, reason}`). Spec #222 AC 5.4 requires the real close
+ * metadata, not hardcoded constants, when upstream surfaces it; OQ-5 names
+ * the defaults to synthesize when it does not.
+ *
+ * Pure module: no I/O, no Refs, no fibers. Called exactly once per socket
+ * lifetime from `MoltZapWsClient`'s reader-fiber `Effect.onExit` hook
+ * (`ws-client.ts:386-411` today — post-impl the extraction happens at that
+ * same point before calling `onDisconnect(close)`).
+ *
+ * Error channel: `extractCloseInfo` is total — every possible `Exit` maps to
+ * a `CloseInfo`. The defaults below are the resolution of OQ-5 (A). No
+ * typed error surface on this module.
+ */
+import { Cause, Exit } from "effect";
+import * as Socket from "@effect/platform/Socket";
+/**
+ * WebSocket close metadata surfaced to `MoltZapWsClientOptions.onDisconnect`
+ * (required arg post-migration — see design doc §Deletions, OQ-6) and to
+ * the conformance-adapter's `RealClientCloseEvent`. Mirrors the WHATWG
+ * WebSocket `CloseEvent` fields restricted to `{code, reason}` — `wasClean`
+ * is derivable from `code` and not worth its own field.
+ */
+export interface CloseInfo {
+    readonly code: number;
+    readonly reason: string;
+}
+/**
+ * Discriminated shape the reader-fiber exit falls into. Implementation's
+ * `extractCloseInfo` pattern-matches this union and returns the `{code,
+ * reason}` projection. Named here so downstream review can check that
+ * every branch has an assigned close pair.
+ *
+ * Exhaustiveness (Principle 4): the `Unknown` branch is the residual for
+ * any `SocketError` variant @effect/platform adds in the future. The
+ * implementation's pattern-match ends in `default: return absurd(kind)`.
+ */
+export type CloseKind = {
+    /** Graceful `SocketCloseError` — upstream code + reason round-tripped. */
+    readonly _tag: "Clean";
+    readonly code: number;
+    readonly reason: string;
+} | {
+    /** `Exit.Success` with no close frame observed — socket ended cleanly. */
+    readonly _tag: "EndOfStream";
+} | {
+    /** `SocketGenericError` with reason "Open" / "OpenTimeout". */
+    readonly _tag: "HandshakeFailure";
+    readonly underlying: "Open" | "OpenTimeout";
+} | {
+    /** `SocketGenericError` with reason "Read" / "Write" — transport broke. */
+    readonly _tag: "TransportFailure";
+    readonly underlying: "Read" | "Write";
+} | {
+    /** Cause did not match any known `SocketError` shape. */
+    readonly _tag: "Unknown";
+};
+/**
+ * OQ-5 resolution defaults. Exported so the implementation, tests, and
+ * the conformance-adapter's V7 proof share one source of truth.
+ */
+export declare const DEFAULT_GRACEFUL_CLOSE: CloseInfo;
+export declare const DEFAULT_ABNORMAL_CLOSE: CloseInfo;
+/**
+ * Classify a reader-fiber exit cause into `CloseKind`. Total; the
+ * `Unknown` branch is the residual for future `SocketError` variants.
+ *
+ * Logic:
+ *   1. If the cause carries a `SocketCloseError` failure (reason ===
+ *      "Close"), surface its `code` + `closeReason` as `Clean`.
+ *   2. If it carries a `SocketGenericError`, branch on `reason`:
+ *        - "Open" / "OpenTimeout" → `HandshakeFailure`
+ *        - "Read" / "Write" → `TransportFailure`
+ *   3. Anything else (interrupt, unknown defect, no failure) →
+ *      `Unknown`. The caller (`extractCloseInfo`) maps this to the
+ *      OQ-5 abnormal default.
+ */
+export declare function classifyCloseCause(cause: Cause.Cause<Socket.SocketError>): CloseKind;
+/**
+ * Project an `Exit` onto `CloseInfo`. Composition of `classifyCloseCause`
+ * plus the OQ-5 default map:
+ *
+ *   Clean              -> { code, reason } from SocketCloseError
+ *   EndOfStream        -> DEFAULT_GRACEFUL_CLOSE
+ *   HandshakeFailure   -> DEFAULT_ABNORMAL_CLOSE
+ *   TransportFailure   -> DEFAULT_ABNORMAL_CLOSE
+ *   Unknown            -> DEFAULT_ABNORMAL_CLOSE
+ */
+export declare function extractCloseInfo(exit: Exit.Exit<void, Socket.SocketError>): CloseInfo;
+//# sourceMappingURL=close-info.d.ts.map

package/dist/runtime/close-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-info.d.ts","sourceRoot":"","sources":["../../src/runtime/close-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B,GACD;IACE,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;CAC7C,GACD;IACE,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC,GACD;IACE,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAGpC,CAAC;AACF,eAAO,MAAM,sBAAsB,EAAE,SAGpC,CAAC;AAOF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GACrC,SAAS,CA6BX;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,GACxC,SAAS,CAiBX"}

package/dist/runtime/close-info.js

@@ -0,0 +1,109 @@
+/**
+ * Close-metadata extraction for the WebSocket reader fiber.
+ *
+ * Responsibility: inspect an `Exit.Exit<void, Socket.SocketError>` produced by
+ * `Socket.runRaw(...)` and project it onto a caller-facing `CloseInfo`
+ * (WebSocket `{code, reason}`). Spec #222 AC 5.4 requires the real close
+ * metadata, not hardcoded constants, when upstream surfaces it; OQ-5 names
+ * the defaults to synthesize when it does not.
+ *
+ * Pure module: no I/O, no Refs, no fibers. Called exactly once per socket
+ * lifetime from `MoltZapWsClient`'s reader-fiber `Effect.onExit` hook
+ * (`ws-client.ts:386-411` today — post-impl the extraction happens at that
+ * same point before calling `onDisconnect(close)`).
+ *
+ * Error channel: `extractCloseInfo` is total — every possible `Exit` maps to
+ * a `CloseInfo`. The defaults below are the resolution of OQ-5 (A). No
+ * typed error surface on this module.
+ */
+import { Cause, Exit } from "effect";
+import * as Socket from "@effect/platform/Socket";
+/**
+ * OQ-5 resolution defaults. Exported so the implementation, tests, and
+ * the conformance-adapter's V7 proof share one source of truth.
+ */
+export const DEFAULT_GRACEFUL_CLOSE = {
+    code: 1000,
+    reason: "normal",
+};
+export const DEFAULT_ABNORMAL_CLOSE = {
+    code: 1006,
+    reason: "abnormal",
+};
+/** Exhaustiveness sentinel for `CloseKind` switches (Principle 4). */
+function absurd(x) {
+    throw new Error(`unreachable CloseKind branch: ${JSON.stringify(x)}`);
+}
+/**
+ * Classify a reader-fiber exit cause into `CloseKind`. Total; the
+ * `Unknown` branch is the residual for future `SocketError` variants.
+ *
+ * Logic:
+ *   1. If the cause carries a `SocketCloseError` failure (reason ===
+ *      "Close"), surface its `code` + `closeReason` as `Clean`.
+ *   2. If it carries a `SocketGenericError`, branch on `reason`:
+ *        - "Open" / "OpenTimeout" → `HandshakeFailure`
+ *        - "Read" / "Write" → `TransportFailure`
+ *   3. Anything else (interrupt, unknown defect, no failure) →
+ *      `Unknown`. The caller (`extractCloseInfo`) maps this to the
+ *      OQ-5 abnormal default.
+ */
+export function classifyCloseCause(cause) {
+    // The reader fiber emits at most one SocketError-shaped failure on
+    // close; iterate the `Cause.failures` chunk and route on the first
+    // match. `Chunk` is iterable, so a `for…of` walk is sufficient.
+    for (const failure of Cause.failures(cause)) {
+        if (Socket.SocketCloseError.is(failure)) {
+            return {
+                _tag: "Clean",
+                code: failure.code,
+                reason: failure.closeReason ?? "",
+            };
+        }
+        if (Socket.isSocketError(failure)) {
+            // SocketGenericError — branch on the four documented reasons and
+            // let any future variant fall through to `Unknown`.
+            const generic = failure;
+            switch (generic.reason) {
+                case "Open":
+                case "OpenTimeout":
+                    return { _tag: "HandshakeFailure", underlying: generic.reason };
+                case "Read":
+                case "Write":
+                    return { _tag: "TransportFailure", underlying: generic.reason };
+                default:
+                    return { _tag: "Unknown" };
+            }
+        }
+    }
+    return { _tag: "Unknown" };
+}
+/**
+ * Project an `Exit` onto `CloseInfo`. Composition of `classifyCloseCause`
+ * plus the OQ-5 default map:
+ *
+ *   Clean              -> { code, reason } from SocketCloseError
+ *   EndOfStream        -> DEFAULT_GRACEFUL_CLOSE
+ *   HandshakeFailure   -> DEFAULT_ABNORMAL_CLOSE
+ *   TransportFailure   -> DEFAULT_ABNORMAL_CLOSE
+ *   Unknown            -> DEFAULT_ABNORMAL_CLOSE
+ */
+export function extractCloseInfo(exit) {
+    if (Exit.isSuccess(exit)) {
+        return DEFAULT_GRACEFUL_CLOSE;
+    }
+    const kind = classifyCloseCause(exit.cause);
+    switch (kind._tag) {
+        case "Clean":
+            return { code: kind.code, reason: kind.reason };
+        case "EndOfStream":
+            return DEFAULT_GRACEFUL_CLOSE;
+        case "HandshakeFailure":
+        case "TransportFailure":
+        case "Unknown":
+            return DEFAULT_ABNORMAL_CLOSE;
+        default:
+            return absurd(kind);
+    }
+}
+//# sourceMappingURL=close-info.js.map

package/dist/runtime/close-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-info.js","sourceRoot":"","sources":["../../src/runtime/close-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAkDlD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAc;IAC/C,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,QAAQ;CACjB,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAc;IAC/C,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF,sEAAsE;AACtE,SAAS,MAAM,CAAC,CAAQ;IACtB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsC;IAEtC,mEAAmE;IACnE,mEAAmE;IACnE,gEAAgE;IAChE,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;aAClC,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,iEAAiE;YACjE,oDAAoD;YACpD,MAAM,OAAO,GAAG,OAAoC,CAAC;YACrD,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,MAAM,CAAC;gBACZ,KAAK,aAAa;oBAChB,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBAClE,KAAK,MAAM,CAAC;gBACZ,KAAK,OAAO;oBACV,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBAClE;oBACE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAyC;IAEzC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,KAAK,aAAa;YAChB,OAAO,sBAAsB,CAAC;QAChC,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB,CAAC;QACxB,KAAK,SAAS;YACZ,OAAO,sBAAsB,CAAC;QAChC;YACE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/runtime/close-info.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=close-info.test.d.ts.map

package/dist/runtime/close-info.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-info.test.d.ts","sourceRoot":"","sources":["../../src/runtime/close-info.test.ts"],"names":[],"mappings":""}

package/dist/runtime/close-info.test.js

@@ -0,0 +1,102 @@
+/**
+ * Unit tests for the close-metadata classifier.
+ *
+ * Spec #222 §5.4 (V7): the reader-fiber `onExit` path projects an
+ * `Exit.Exit<void, Socket.SocketError>` onto a `CloseInfo`. The OQ-5
+ * default map fans across five `CloseKind` branches; the live
+ * integration tests in `ws-client.test.ts` cover the `Clean` branch
+ * via real WebSocket close frames. This file covers the remaining
+ * branches by feeding synthetic `Exit` values directly to
+ * `extractCloseInfo`, with no transport in play.
+ *
+ * The five branches map onto two `CloseInfo` constants —
+ * `DEFAULT_GRACEFUL_CLOSE` for `EndOfStream` and `DEFAULT_ABNORMAL_CLOSE`
+ * for the three failure branches — plus the round-tripped `{code,
+ * reason}` from `Clean`. Each branch gets a separate test so a
+ * mutation that collapses the map (e.g. always returns
+ * `DEFAULT_GRACEFUL_CLOSE`) trips a specific assertion.
+ */
+import { describe, expect, it } from "vitest";
+import { Cause, Exit } from "effect";
+import * as Socket from "@effect/platform/Socket";
+import { classifyCloseCause, DEFAULT_ABNORMAL_CLOSE, DEFAULT_GRACEFUL_CLOSE, extractCloseInfo, } from "./close-info.js";
+describe("extractCloseInfo — OQ-5 default map", () => {
+    it("EndOfStream (Exit.Success) → DEFAULT_GRACEFUL_CLOSE", () => {
+        const exit = Exit.succeed(undefined);
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_GRACEFUL_CLOSE);
+    });
+    it("Clean (SocketCloseError) → {code, reason} round-tripped", () => {
+        const err = new Socket.SocketCloseError({
+            reason: "Close",
+            code: 1001,
+            closeReason: "going away",
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual({
+            code: 1001,
+            reason: "going away",
+        });
+    });
+    it("Clean with no closeReason → empty-string reason (no synthesized text)", () => {
+        const err = new Socket.SocketCloseError({
+            reason: "Close",
+            code: 1000,
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual({ code: 1000, reason: "" });
+    });
+    it("HandshakeFailure (Open) → DEFAULT_ABNORMAL_CLOSE", () => {
+        const err = new Socket.SocketGenericError({
+            reason: "Open",
+            cause: new Error("boom"),
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_ABNORMAL_CLOSE);
+    });
+    it("HandshakeFailure (OpenTimeout) → DEFAULT_ABNORMAL_CLOSE", () => {
+        const err = new Socket.SocketGenericError({
+            reason: "OpenTimeout",
+            cause: new Error("timeout"),
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_ABNORMAL_CLOSE);
+    });
+    it("TransportFailure (Read) → DEFAULT_ABNORMAL_CLOSE", () => {
+        const err = new Socket.SocketGenericError({
+            reason: "Read",
+            cause: new Error("ECONNRESET"),
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_ABNORMAL_CLOSE);
+    });
+    it("TransportFailure (Write) → DEFAULT_ABNORMAL_CLOSE", () => {
+        const err = new Socket.SocketGenericError({
+            reason: "Write",
+            cause: new Error("EPIPE"),
+        });
+        const exit = Exit.fail(err);
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_ABNORMAL_CLOSE);
+    });
+    it("Unknown (interrupt with no SocketError failure) → DEFAULT_ABNORMAL_CLOSE", () => {
+        // An interrupted reader fiber emits a Cause with no failure; the
+        // classifier must route it to `Unknown`, not collapse to graceful.
+        const exit = Exit.failCause(Cause.interrupt(0));
+        expect(extractCloseInfo(exit)).toEqual(DEFAULT_ABNORMAL_CLOSE);
+    });
+});
+describe("classifyCloseCause", () => {
+    it("Clean preserves the upstream code + closeReason", () => {
+        const err = new Socket.SocketCloseError({
+            reason: "Close",
+            code: 4321,
+            closeReason: "custom",
+        });
+        const cause = Cause.fail(err);
+        expect(classifyCloseCause(cause)).toEqual({
+            _tag: "Clean",
+            code: 4321,
+            reason: "custom",
+        });
+    });
+});
+//# sourceMappingURL=close-info.test.js.map

package/dist/runtime/close-info.test.js.map

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

package/dist/runtime/errors.d.ts

@@ -0,0 +1,47 @@
+declare const NotConnectedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "NotConnectedError";
+} & Readonly<A>;
+/** The socket is not in the OPEN state when an RPC was attempted. */
+export declare class NotConnectedError extends NotConnectedError_base<{
+    readonly message: string;
+}> {
+}
+declare const RpcTimeoutError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RpcTimeoutError";
+} & Readonly<A>;
+/** The RPC exceeded the per-call timeout without a response frame. */
+export declare class RpcTimeoutError extends RpcTimeoutError_base<{
+    readonly method: string;
+    readonly timeoutMs: number;
+}> {
+}
+declare const RpcServerError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RpcServerError";
+} & Readonly<A>;
+/** The server returned an `error` response frame. */
+export declare class RpcServerError extends RpcServerError_base<{
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}> {
+}
+declare const MalformedFrameError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "MalformedFrameError";
+} & Readonly<A>;
+/** Inbound frame failed to parse as JSON or did not match the expected shape. */
+export declare class MalformedFrameError extends MalformedFrameError_base<{
+    readonly raw: string;
+    readonly cause?: unknown;
+}> {
+}
+declare const AgentNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AgentNotFoundError";
+} & Readonly<A>;
+/** A name→agent lookup returned no results. */
+export declare class AgentNotFoundError extends AgentNotFoundError_base<{
+    readonly agentName: string;
+}> {
+    get message(): string;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/runtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":";;;AAEA,qEAAqE;AACrE,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,sEAAsE;AACtE,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;;;;AAEL,qDAAqD;AACrD,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL,iFAAiF;AACjF,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,+CAA+C;AAC/C,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF"}

package/dist/runtime/errors.js

@@ -0,0 +1,20 @@
+import { Data } from "effect";
+/** The socket is not in the OPEN state when an RPC was attempted. */
+export class NotConnectedError extends Data.TaggedError("NotConnectedError") {
+}
+/** The RPC exceeded the per-call timeout without a response frame. */
+export class RpcTimeoutError extends Data.TaggedError("RpcTimeoutError") {
+}
+/** The server returned an `error` response frame. */
+export class RpcServerError extends Data.TaggedError("RpcServerError") {
+}
+/** Inbound frame failed to parse as JSON or did not match the expected shape. */
+export class MalformedFrameError extends Data.TaggedError("MalformedFrameError") {
+}
+/** A name→agent lookup returned no results. */
+export class AgentNotFoundError extends Data.TaggedError("AgentNotFoundError") {
+    get message() {
+        return `Agent not found: ${this.agentName}`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/runtime/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qEAAqE;AACrE,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAEzE;CAAG;AAEL,sEAAsE;AACtE,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;CAAG;AAEL,qDAAqD;AACrD,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAInE;CAAG;AAEL,iFAAiF;AACjF,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CACvD,qBAAqB,CAIrB;CAAG;AAEL,+CAA+C;AAC/C,MAAM,OAAO,kBAAmB,SAAQ,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAE3E;IACA,IAAa,OAAO;QAClB,OAAO,oBAAoB,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/runtime/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/runtime/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.test.ts"],"names":[],"mappings":""}

package/dist/runtime/errors.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "vitest";
+import { AgentNotFoundError, MalformedFrameError, NotConnectedError, RpcServerError, RpcTimeoutError, } from "./errors.js";
+describe("AgentNotFoundError", () => {
+    it("carries agentName and derives a `_tag` + `message`", () => {
+        const err = new AgentNotFoundError({ agentName: "foo" });
+        expect(err._tag).toBe("AgentNotFoundError");
+        expect(err.agentName).toBe("foo");
+        expect(err.message).toBe("Agent not found: foo");
+    });
+    it("tag discriminates at the type level against sibling tagged errors", () => {
+        const err = new AgentNotFoundError({
+            agentName: "bar",
+        });
+        // Purely a runtime sanity check that the switch on _tag narrows.
+        // #ignore-sloppy-code-next-line[tag-discriminant]: this test's entire purpose is to verify the _tag discriminant narrows correctly
+        if (err._tag === "AgentNotFoundError") {
+            expect(err.agentName).toBe("bar");
+        }
+        else {
+            throw new Error("expected AgentNotFoundError");
+        }
+    });
+});
+describe("NotConnectedError", () => {
+    it("carries message field and `_tag === 'NotConnectedError'`", () => {
+        const err = new NotConnectedError({ message: "socket closed" });
+        expect(err._tag).toBe("NotConnectedError");
+        expect(err.message).toBe("socket closed");
+    });
+});
+describe("RpcTimeoutError", () => {
+    it("carries method + timeoutMs and `_tag === 'RpcTimeoutError'`", () => {
+        const err = new RpcTimeoutError({
+            method: "messages/send",
+            timeoutMs: 30_000,
+        });
+        expect(err._tag).toBe("RpcTimeoutError");
+        expect(err.method).toBe("messages/send");
+        expect(err.timeoutMs).toBe(30_000);
+    });
+});
+describe("RpcServerError", () => {
+    it("carries code, message, and optional data", () => {
+        const err = new RpcServerError({
+            code: -32601,
+            message: "method not found",
+            data: { hint: "check spelling" },
+        });
+        expect(err._tag).toBe("RpcServerError");
+        expect(err.code).toBe(-32601);
+        expect(err.message).toBe("method not found");
+        expect(err.data).toEqual({ hint: "check spelling" });
+    });
+    it("treats `data` as optional (undefined when omitted)", () => {
+        const err = new RpcServerError({ code: -32603, message: "oops" });
+        expect(err.data).toBeUndefined();
+    });
+});
+describe("MalformedFrameError", () => {
+    it("carries the raw payload and `_tag === 'MalformedFrameError'`", () => {
+        const err = new MalformedFrameError({ raw: "not json" });
+        expect(err._tag).toBe("MalformedFrameError");
+        expect(err.raw).toBe("not json");
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/runtime/errors.test.js.map

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

package/dist/runtime/frame.d.ts

@@ -0,0 +1,25 @@
+import { Effect } from "effect";
+import { type EventFrame, type ResponseFrame } from "@moltzap/protocol";
+import { MalformedFrameError } from "./errors.js";
+/** Decoded response frame — narrowed from the protocol's `ResponseFrame`. */
+export interface DecodedResponse {
+    readonly _tag: "Response";
+    readonly id: string;
+    readonly result?: unknown;
+    readonly error?: ResponseFrame["error"];
+}
+/** Decoded event frame — forwarded to the service's onEvent callback. */
+export interface DecodedEvent {
+    readonly _tag: "Event";
+    readonly frame: EventFrame;
+}
+export type DecodedFrame = DecodedResponse | DecodedEvent;
+export declare const splitRawFrames: (raw: string) => Effect.Effect<ReadonlyArray<string>, MalformedFrameError>;
+/**
+ * Central typed inbound frame decoder. JSON.parse + shape validation via the
+ * protocol's pre-compiled AJV validators. The raw socket chunk may contain
+ * padding bytes or more than one JSON object; split and validate each object
+ * before handing frames to the client runtime.
+ */
+export declare const decodeFrames: (raw: string) => Effect.Effect<ReadonlyArray<DecodedFrame>, MalformedFrameError>;
+//# sourceMappingURL=frame.d.ts.map

package/dist/runtime/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/runtime/frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,YAAY,CAAC;AAyB1D,eAAO,MAAM,cAAc,GACzB,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAsEvD,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAuB7D,CAAC"}

package/dist/runtime/frame.js

@@ -0,0 +1,106 @@
+import { Effect } from "effect";
+import { validators, } from "@moltzap/protocol";
+import { MalformedFrameError } from "./errors.js";
+const isFramePadding = (char) => char === "\u0000" || char === "\ufeff" || /\s/u.test(char);
+const toDecodedFrame = (parsed) => {
+    if (validators.responseFrame(parsed)) {
+        const frame = parsed;
+        return {
+            _tag: "Response",
+            id: frame.id,
+            result: frame.result,
+            error: frame.error,
+        };
+    }
+    if (validators.eventFrame(parsed)) {
+        return { _tag: "Event", frame: parsed };
+    }
+    return new MalformedFrameError({ raw: JSON.stringify(parsed) });
+};
+export const splitRawFrames = (raw) => Effect.try({
+    try: () => {
+        const frames = [];
+        let start = -1;
+        let depth = 0;
+        let inString = false;
+        let escaped = false;
+        for (let index = 0; index < raw.length; index += 1) {
+            const char = raw[index];
+            if (start === -1) {
+                if (isFramePadding(char)) {
+                    continue;
+                }
+                if (char !== "{") {
+                    throw new MalformedFrameError({ raw });
+                }
+                start = index;
+                depth = 1;
+                continue;
+            }
+            if (inString) {
+                if (escaped) {
+                    escaped = false;
+                    continue;
+                }
+                if (char === "\\") {
+                    escaped = true;
+                    continue;
+                }
+                if (char === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (char === '"') {
+                inString = true;
+                continue;
+            }
+            if (char === "{") {
+                depth += 1;
+                continue;
+            }
+            if (char !== "}") {
+                continue;
+            }
+            depth -= 1;
+            if (depth !== 0) {
+                continue;
+            }
+            frames.push(raw.slice(start, index + 1));
+            start = -1;
+        }
+        if (start !== -1 || frames.length === 0) {
+            throw new MalformedFrameError({ raw });
+        }
+        return frames;
+    },
+    catch: (cause) => cause instanceof MalformedFrameError
+        ? cause
+        : new MalformedFrameError({ raw, cause }),
+});
+/**
+ * Central typed inbound frame decoder. JSON.parse + shape validation via the
+ * protocol's pre-compiled AJV validators. The raw socket chunk may contain
+ * padding bytes or more than one JSON object; split and validate each object
+ * before handing frames to the client runtime.
+ */
+export const decodeFrames = (raw) => Effect.gen(function* () {
+    const frameTexts = yield* splitRawFrames(raw);
+    const decodedFrames = [];
+    for (const frameText of frameTexts) {
+        let parsed;
+        try {
+            parsed = JSON.parse(frameText);
+        }
+        catch (err) {
+            return yield* Effect.fail(new MalformedFrameError({ raw: frameText, cause: err }));
+        }
+        const decoded = toDecodedFrame(parsed);
+        if (decoded instanceof MalformedFrameError) {
+            return yield* Effect.fail(new MalformedFrameError({ raw: frameText }));
+        }
+        decodedFrames.push(decoded);
+    }
+    return decodedFrames;
+});
+//# sourceMappingURL=frame.js.map

package/dist/runtime/frame.js.map

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

package/dist/runtime/frame.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frame.test.d.ts.map

package/dist/runtime/frame.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.test.d.ts","sourceRoot":"","sources":["../../src/runtime/frame.test.ts"],"names":[],"mappings":""}