@moltzap/client 2026.414.0 → 2026.425.1

package/dist/cli/transport.js

@@ -0,0 +1,324 @@
+/**
+ * CLI transport layer — the single seam between the command handlers and
+ * the wire. Decides between the singleton daemon (Unix socket) and a
+ * direct WebSocket per invocation.
+ *
+ * This file is the `--as <apiKey>` branch point (spec sbd#177 rev 3 §5.1,
+ * Invariant §4.2). Command handlers pull `Transport` from Effect context;
+ * they do NOT open sockets or construct clients themselves. The kind of
+ * transport in effect is decided once at CLI boot by {@link makeTransportLayer}
+ * and is immutable for the lifetime of the process.
+ *
+ * Test seam: integration tests swap {@link makeTransportLayer} for a layer
+ * that provides a recording `Transport`; unit tests provide `Transport`
+ * directly via `Effect.provideService`.
+ */
+import * as net from "node:net";
+import { Context, Data, Effect, Layer, Scope } from "effect";
+import { MoltZapService } from "../service.js";
+import { MoltZapWsClient } from "../ws-client.js";
+import { request as daemonRequest } from "./socket-client.js";
+import { loadLayeredConfig, parseProfileName, resolveProfileAuth, } from "./profile.js";
+/**
+ * The daemon socket path did not exist or refused connection. Only raised
+ * by the daemon branch; the direct branch never raises this.
+ */
+export class ServiceUnreachableError extends Data.TaggedError("ServiceUnreachableError") {
+}
+/** RPC exceeded the per-call deadline without a response frame. */
+export class TransportTimeoutError extends Data.TaggedError("TransportTimeoutError") {
+}
+/**
+ * Server returned a structured error response frame. `code` matches the
+ * JSON-RPC-style error code emitted by `packages/server`.
+ */
+export class TransportRpcError extends Data.TaggedError("TransportRpcError") {
+}
+/** Response frame failed to parse or did not match the expected RPC result shape. */
+export class TransportDecodeError extends Data.TaggedError("TransportDecodeError") {
+}
+/**
+ * Transport inputs were self-inconsistent (e.g., `--as` set with no
+ * `serverUrl` resolvable). Surfaces at Layer construction, not at RPC time.
+ */
+export class TransportConfigError extends Data.TaggedError("TransportConfigError") {
+}
+export const Transport = Context.GenericTag("moltzap/cli/Transport");
+const DEFAULT_SERVER_URL = "wss://api.moltzap.xyz";
+/**
+ * Decision function — Effect-returning because the env-fallback branch
+ * may invoke the `probeDaemon` thunk. The as-flag branch short-circuits
+ * BEFORE any probe: `impersonateKey` present ⇒ returns
+ * `UseDirect{as-flag}` without calling `probeDaemon`, without reading
+ * env, without any side effect (Invariant §4.2).
+ */
+export const decideTransport = (options) => Effect.gen(function* () {
+    if (options.impersonateKey !== undefined) {
+        return { _tag: "UseDirect", reason: "as-flag" };
+    }
+    if (options.profileKey !== undefined) {
+        return { _tag: "UseDirect", reason: "profile" };
+    }
+    // Env-fallback branch: MOLTZAP_API_KEY is set AND daemon is unreachable.
+    const hasEnvKey = process.env.MOLTZAP_API_KEY !== undefined;
+    if (hasEnvKey && options.probeDaemon !== undefined) {
+        const reachable = yield* options.probeDaemon();
+        if (!reachable) {
+            return { _tag: "UseDirect", reason: "env-fallback" };
+        }
+    }
+    // Default: daemon branch.
+    const socketPath = options.socketPath ?? MoltZapService.SOCKET_PATH;
+    return { _tag: "UseDaemon", socketPath };
+});
+// Map daemon-branch Error to TransportError tags. The daemon socket client
+// surfaces a generic Error; we re-tag at the boundary so command handlers
+// can discriminate.
+const tagDaemonError = (method, err) => {
+    const msg = err.message;
+    if (msg.includes("not running") ||
+        msg.includes("ENOENT") ||
+        msg.includes("ECONNREFUSED")) {
+        return new ServiceUnreachableError({
+            socketPath: MoltZapService.SOCKET_PATH,
+            cause: err,
+        });
+    }
+    if (msg.includes("timed out") || msg.includes("aborted")) {
+        return new TransportTimeoutError({ method, timeoutMs: 10_000 });
+    }
+    if (msg.startsWith("Malformed")) {
+        return new TransportDecodeError({ method, cause: err });
+    }
+    // Remote error surfaces as a bare message from the service.
+    return new TransportRpcError({
+        method,
+        code: -32000,
+        message: msg,
+    });
+};
+const makeDaemonTransport = (socketPath) => ({
+    kind: "daemon",
+    rpc: (method, params) => daemonRequest(method, params, socketPath).pipe(Effect.map((v) => v), Effect.mapError((err) => tagDaemonError(method, err))),
+});
+// Map ws-client errors (NotConnectedError | RpcTimeoutError | RpcServerError)
+// to TransportError tags. Names are matched via _tag rather than instanceof
+// to avoid a circular import chain through runtime/errors.
+/** @internal exported for decoder-fixture tests only (sbd#198). */
+export const tagWsError = (method, err) => {
+    switch (err._tag) {
+        case "NotConnectedError":
+            return new ServiceUnreachableError({
+                socketPath: "(direct-ws)",
+                cause: err,
+            });
+        case "RpcTimeoutError":
+            return new TransportTimeoutError({
+                method,
+                timeoutMs: err.timeoutMs ?? 30_000,
+            });
+        case "RpcServerError":
+            return new TransportRpcError({
+                method,
+                code: err.code ?? -32000,
+                message: err.message ?? "RPC error",
+                data: err.data,
+            });
+        default:
+            return new TransportDecodeError({ method, cause: err });
+    }
+};
+/**
+ * Build a direct-WebSocket transport. Requires `Scope` so `Layer.scoped`
+ * can install a finalizer via `Effect.addFinalizer`. The finalizer fires on
+ * fiber interruption (SIGINT/SIGTERM) — closing the ws-client and its internal
+ * ManagedRuntime — and also runs on normal completion so the event loop drains
+ * naturally without a forced `process.exit`. This replaces the fragile
+ * `process.once("beforeExit", ...)` hook that never fired because the reader
+ * fiber kept the event loop non-empty (sbd#198 Bug-2 / moltzap#228).
+ *
+ * `MoltZapWsClient` is constructed lazily inside `Effect.cached` so commands
+ * that never reach the wire (e.g. help-text display, input validation failure)
+ * do not pay for a ManagedRuntime spin-up.
+ *
+ * `sendRpc` is composed entirely in Effect-land — no `Effect.runPromise`
+ * bridge — so typed errors (`NotConnectedError`, `RpcTimeoutError`,
+ * `RpcServerError`) flow through `tagWsError` with their `_tag` intact.
+ */
+const makeDirectTransport = (serverUrl, agentKey) => Effect.gen(function* () {
+    if (!serverUrl) {
+        return yield* Effect.fail(new TransportConfigError({
+            reason: "direct transport requires a serverUrl",
+        }));
+    }
+    if (!agentKey) {
+        return yield* Effect.fail(new TransportConfigError({
+            reason: "direct transport requires an agentKey",
+        }));
+    }
+    // Lazily-created client: null until the first rpc() call fires connectOnce.
+    // The finalizer checks the current value at scope-close time so help/
+    // validation paths that never open a socket incur no cleanup cost.
+    let client = null;
+    yield* Effect.addFinalizer(() => client !== null ? client.close() : Effect.void);
+    // Memoize the connect handshake: only one round-trip per invocation,
+    // cached for the lifetime of this scope.
+    const connectOnce = yield* Effect.cached(Effect.gen(function* () {
+        const c = new MoltZapWsClient({ serverUrl, agentKey });
+        client = c;
+        yield* c
+            .connect()
+            .pipe(Effect.mapError((e) => tagWsError("connect", e)));
+        return c;
+    }));
+    return {
+        kind: "direct",
+        rpc: (method, params) => connectOnce.pipe(Effect.flatMap((c) => c
+            .sendRpc(method, params)
+            .pipe(Effect.mapError((e) => tagWsError(method, e)))), Effect.map((v) => v)),
+    };
+});
+/**
+ * Build the Layer that provides {@link Transport} for the current invocation.
+ *
+ * Branch points (in priority order):
+ *   1. `options.impersonateKey` → direct WS, Invariant §4.2 isolation guaranteed.
+ *   2. `process.env.MOLTZAP_API_KEY` present AND daemon unreachable → direct WS.
+ *   3. `options.profileKey` set → direct WS with that key.
+ *   4. otherwise → daemon transport over `options.socketPath`.
+ *
+ * The direct branch must NOT open the daemon socket, mutate
+ * `~/.moltzap/config.json`, or share any Effect fiber with the daemon.
+ * Integration test §7 of the design doc verifies this with a two-agent
+ * concurrent roster.
+ */
+export const makeTransportLayer = (options) => Layer.scoped(Transport, Effect.gen(function* () {
+    const decision = yield* decideTransport(options);
+    switch (decision._tag) {
+        case "UseDaemon":
+            return makeDaemonTransport(decision.socketPath);
+        case "UseDirect": {
+            let key;
+            switch (decision.reason) {
+                case "as-flag":
+                    key = options.impersonateKey;
+                    break;
+                case "profile":
+                    key = options.profileKey;
+                    break;
+                case "env-fallback":
+                    key = process.env.MOLTZAP_API_KEY;
+                    break;
+            }
+            if (key === undefined) {
+                return yield* Effect.fail(new TransportConfigError({
+                    reason: `direct transport (${decision.reason}) requires an apiKey`,
+                }));
+            }
+            return yield* makeDirectTransport(options.serverUrl, key);
+        }
+        case "UseTest":
+            return yield* Effect.fail(new TransportConfigError({
+                reason: "UseTest is a test-only branch; provide Transport via Effect.provideService",
+            }));
+        default:
+            return absurd(decision);
+    }
+}));
+/**
+ * Convenience for command handlers: pull the Transport tag and call rpc.
+ * Every new subcommand routes through this helper; raw `socket-client.request`
+ * imports in new commands are a lint-level violation (see design doc §3).
+ */
+export const rpc = (method, params) => Effect.flatMap(Transport, (t) => t.rpc(method, params));
+/**
+ * Uniform error-to-exit adapter for subcommand handlers. Catches every error
+ * channel, prints `Failed: <msg>` to stderr, and exits non-zero. Uses the
+ * tagged-error `message` field if present, otherwise the `_tag`, otherwise
+ * a generic fallback. Shared across every v2 subcommand wrapper so the
+ * exit-code contract (Invariant §4.6) has a single implementation.
+ *
+ * On success, this returns normally and relies on the `Layer.scoped`
+ * finalizer in `makeDirectTransport` to close the ws-client and drain
+ * the event loop (sbd#198 / moltzap#228 Bug-2 fix). No forced
+ * `process.exit(0)` — that would truncate piped stdout on large payloads.
+ */
+export const runHandler = (effect) => effect.pipe(Effect.catchAll((err) => Effect.sync(() => {
+    const msg = err.message !== undefined && err.message !== ""
+        ? err.message
+        : (err._tag ?? "unknown error");
+    console.error(`Failed: ${msg}`);
+    process.exit(1);
+})));
+/**
+ * Lazy resolver invoked by the CLI entrypoint BEFORE constructing the
+ * transport layer. Closes the composition-boundary leak (architect design
+ * doc rev 4 finding 1): with `impersonateKey` set, this function does NOT
+ * call `cli/config.ts:loadConfig`, does NOT read `MOLTZAP_API_KEY` env,
+ * does NOT open `~/.moltzap/config.json`. The only resolution performed on
+ * the as-flag branch is `MOLTZAP_SERVER_URL` (or the hard-coded default).
+ *
+ * This function is the true CLI-boundary gate on Invariant §4.2 — without
+ * it, eager config-read side effects leak even when `decideTransport` is
+ * later short-circuited. Unit tests assert on `fs.open` and `env` read
+ * spies that zero calls happen on the `impersonateKey` branch.
+ */
+export const resolveTransportInputs = (parsed) => Effect.gen(function* () {
+    // ─── Branch A: impersonate (--as) ──────────────────────────────────────
+    // Invariant §4.2: no loadConfig, no MOLTZAP_API_KEY read, no config.json open.
+    if (parsed.impersonateKey !== undefined) {
+        const serverUrl = process.env.MOLTZAP_SERVER_URL ?? DEFAULT_SERVER_URL;
+        return {
+            impersonateKey: parsed.impersonateKey,
+            serverUrl,
+        };
+    }
+    // ─── Branch B: profile ─────────────────────────────────────────────────
+    if (parsed.profileName !== undefined) {
+        const name = yield* parseProfileName(parsed.profileName);
+        const layered = yield* loadLayeredConfig;
+        const record = yield* resolveProfileAuth(name);
+        const serverUrl = process.env.MOLTZAP_SERVER_URL ?? record.serverUrl ?? layered.serverUrl;
+        return {
+            profileKey: record.apiKey,
+            serverUrl,
+            socketPath: MoltZapService.SOCKET_PATH,
+            probeDaemon: probeDaemonDefault,
+        };
+    }
+    // ─── Branch C: legacy daemon / env fallback ────────────────────────────
+    const serverUrl = process.env.MOLTZAP_SERVER_URL ?? DEFAULT_SERVER_URL;
+    return {
+        serverUrl,
+        socketPath: MoltZapService.SOCKET_PATH,
+        probeDaemon: probeDaemonDefault,
+    };
+});
+/**
+ * Default daemon reachability probe: attempt a real connect to the daemon
+ * socket and resolve on `connect`. A bare `fs.existsSync` would mis-report
+ * a stale socket file as "reachable" and route env-fallback callers into
+ * a broken daemon branch; a real connect is the only honest reachability
+ * check. 250ms cap keeps boot latency invisible on the common fast-local
+ * path and still fails fast when the socket refuses or hangs.
+ */
+const probeDaemonDefault = () => Effect.async((resume) => {
+    let settled = false;
+    const done = (reachable) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        conn.removeAllListeners();
+        conn.destroy();
+        resume(Effect.succeed(reachable));
+    };
+    const conn = net.createConnection(MoltZapService.SOCKET_PATH);
+    const timer = setTimeout(() => done(false), 250);
+    conn.once("connect", () => done(true));
+    conn.once("error", () => done(false));
+});
+function absurd(x) {
+    throw new Error(`unreachable: ${String(x)}`);
+}
+//# sourceMappingURL=transport.js.map

package/dist/cli/transport.js.map

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

package/dist/cli/transport.test.d.ts

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

package/dist/cli/transport.test.d.ts.map

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

package/dist/cli/transport.test.js

@@ -0,0 +1,197 @@
+/**
+ * Unit tests for the transport layer — pure decision table + composition-
+ * boundary checks. Integration coverage of the direct-WS branch lives in
+ * the E2E fixture (`__tests__/cli-multi-agent.int.test.ts`).
+ */
+import { Cause, Effect, Exit, Option } from "effect";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { RpcServerError } from "../runtime/errors.js";
+import { decideTransport, makeTransportLayer, resolveTransportInputs, tagWsError, Transport, TransportDecodeError, TransportRpcError, ServiceUnreachableError, TransportTimeoutError, } from "./transport.js";
+/**
+ * Module-level mock so transport.ts's `new MoltZapWsClient(...)` call is
+ * intercepted for the composed-rpc test below. Existing tests (decideTransport,
+ * tagWsError, resolveTransportInputs) do not exercise the ws-client path, so
+ * the mock is a no-op for them.
+ */
+vi.mock("../ws-client.js", async () => {
+    const effect = await import("effect");
+    const errors = await import("../runtime/errors.js");
+    return {
+        MoltZapWsClient: vi.fn().mockImplementation(() => ({
+            connect: () => effect.Effect.void,
+            sendRpc: (_method, _params) => effect.Effect.fail(new errors.RpcServerError({
+                code: -32001,
+                message: "item not found",
+            })),
+            close: () => effect.Effect.void,
+        })),
+    };
+});
+const makeOpts = (over = {}) => ({
+    serverUrl: "wss://example.test",
+    ...over,
+});
+describe("decideTransport", () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+        delete process.env.MOLTZAP_API_KEY;
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    it("returns UseDirect{as-flag} when impersonateKey is set", async () => {
+        const probe = { invoked: 0 };
+        const decision = await Effect.runPromise(decideTransport(makeOpts({
+            impersonateKey: "key-1",
+            probeDaemon: () => Effect.sync(() => {
+                probe.invoked++;
+                return true;
+            }),
+        })));
+        expect(decision).toEqual({ _tag: "UseDirect", reason: "as-flag" });
+        expect(probe.invoked).toBe(0);
+    });
+    it("returns UseDirect{profile} when profileKey set and no --as", async () => {
+        const decision = await Effect.runPromise(decideTransport(makeOpts({ profileKey: "pk-1" })));
+        expect(decision).toEqual({ _tag: "UseDirect", reason: "profile" });
+    });
+    it("returns UseDirect{env-fallback} when MOLTZAP_API_KEY env + daemonReachable=false", async () => {
+        process.env.MOLTZAP_API_KEY = "env-key";
+        const decision = await Effect.runPromise(decideTransport(makeOpts({ probeDaemon: () => Effect.succeed(false) })));
+        expect(decision).toEqual({ _tag: "UseDirect", reason: "env-fallback" });
+    });
+    it("returns UseDaemon when MOLTZAP_API_KEY env + daemonReachable=true", async () => {
+        process.env.MOLTZAP_API_KEY = "env-key";
+        const decision = await Effect.runPromise(decideTransport(makeOpts({
+            socketPath: "/tmp/sock",
+            probeDaemon: () => Effect.succeed(true),
+        })));
+        expect(decision._tag).toBe("UseDaemon");
+    });
+    it("returns UseDaemon when neither as-flag nor env-fallback nor profile", async () => {
+        const decision = await Effect.runPromise(decideTransport(makeOpts({ socketPath: "/tmp/sock" })));
+        expect(decision).toEqual({ _tag: "UseDaemon", socketPath: "/tmp/sock" });
+    });
+    it("never invokes probeDaemon when impersonateKey is set (Invariant §4.2)", async () => {
+        let invocations = 0;
+        await Effect.runPromise(decideTransport(makeOpts({
+            impersonateKey: "key-1",
+            probeDaemon: () => Effect.sync(() => {
+                invocations++;
+                return true;
+            }),
+        })));
+        expect(invocations).toBe(0);
+    });
+});
+/**
+ * Regression guard for sbd#198: the original v2 implementation at 069135d
+ * used `Effect.runPromise(sendRpc)` inside `Effect.tryPromise`. In Effect 3.21,
+ * `runPromise` wraps typed failures in `FiberFailureImpl` (no `_tag`), so
+ * `tagWsError`'s switch hit the default branch and emitted `TransportDecodeError`
+ * for every ws error. Fixed by code-guard commit ff2de0d; these tests guard
+ * against regression to that pattern.
+ *
+ * `tagWsError` is `@internal`-exported so this suite can reach it directly
+ * without a mock WS server.
+ */
+describe("tagWsError — maps ws-client error tags to TransportError variants", () => {
+    it("RpcServerError maps to TransportRpcError (not TransportDecodeError)", () => {
+        const err = tagWsError("apps/listSessions", {
+            _tag: "RpcServerError",
+            code: -32001,
+            message: "session not found",
+        });
+        expect(err).toBeInstanceOf(TransportRpcError);
+        expect(err._tag).toBe("TransportRpcError");
+        if (err instanceof TransportRpcError) {
+            expect(err.code).toBe(-32001);
+            expect(err.message).toBe("session not found");
+        }
+    });
+    it("NotConnectedError maps to ServiceUnreachableError", () => {
+        const err = tagWsError("apps/listSessions", { _tag: "NotConnectedError" });
+        expect(err).toBeInstanceOf(ServiceUnreachableError);
+        expect(err._tag).toBe("ServiceUnreachableError");
+    });
+    it("RpcTimeoutError maps to TransportTimeoutError with timeoutMs forwarded", () => {
+        const err = tagWsError("apps/listSessions", {
+            _tag: "RpcTimeoutError",
+            timeoutMs: 15_000,
+        });
+        expect(err).toBeInstanceOf(TransportTimeoutError);
+        if (err instanceof TransportTimeoutError) {
+            expect(err.timeoutMs).toBe(15_000);
+        }
+    });
+    it("FiberFailureImpl-shaped error (no _tag) maps to TransportDecodeError — not to TransportRpcError", () => {
+        // Guards the regression: a future runPromise bridge would produce an object
+        // with no _tag (FiberFailureImpl shape). This pins the default branch to
+        // TransportDecodeError so the error is observable, not silently swallowed.
+        const err = tagWsError("apps/listSessions", {
+            message: "some unknown error",
+        });
+        expect(err).toBeInstanceOf(TransportDecodeError);
+        expect(err._tag).toBe("TransportDecodeError");
+    });
+});
+describe("resolveTransportInputs (composition-boundary gate)", () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+        delete process.env.MOLTZAP_API_KEY;
+        delete process.env.MOLTZAP_SERVER_URL;
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    it("impersonateKey branch does NOT read MOLTZAP_API_KEY env", async () => {
+        process.env.MOLTZAP_API_KEY = "leaked-key";
+        const opts = await Effect.runPromise(resolveTransportInputs({ impersonateKey: "explicit-key" }));
+        expect(opts.impersonateKey).toBe("explicit-key");
+        // The returned TransportOptions does NOT expose MOLTZAP_API_KEY as profileKey.
+        expect(opts.profileKey).toBeUndefined();
+    });
+    it("impersonateKey branch uses MOLTZAP_SERVER_URL if present, else default", async () => {
+        process.env.MOLTZAP_SERVER_URL = "wss://override.test";
+        const opts = await Effect.runPromise(resolveTransportInputs({ impersonateKey: "k" }));
+        expect(opts.serverUrl).toBe("wss://override.test");
+    });
+    it("empty input falls through to legacy daemon path (no impersonate, no profile)", async () => {
+        const opts = await Effect.runPromise(resolveTransportInputs({}));
+        expect(opts.impersonateKey).toBeUndefined();
+        expect(opts.profileKey).toBeUndefined();
+        expect(opts.socketPath).toBeDefined();
+    });
+});
+/**
+ * Composed rpc() failure path — pins the full call chain so a future
+ * regression to `Effect.runPromise(sendRpc)` inside `Effect.tryPromise`
+ * is caught here, not just in the isolated `tagWsError` suite above.
+ *
+ * The ws-client mock (module-level `vi.mock("../ws-client.js")`) makes
+ * `sendRpc` return `Effect.fail(new RpcServerError(...))` so the test
+ * exercises: connect (success) → sendRpc (RpcServerError) → tagWsError
+ * → TransportRpcError. A runPromise bridge would wrap RpcServerError in
+ * FiberFailureImpl (no _tag) and the result would be TransportDecodeError.
+ */
+describe("makeDirectTransport — composed rpc() failure path", () => {
+    it("RpcServerError from sendRpc propagates as TransportRpcError through tagWsError", async () => {
+        const opts = {
+            impersonateKey: "test-key",
+            serverUrl: "wss://test.example",
+        };
+        const exit = await Effect.runPromise(Transport.pipe(Effect.flatMap((t) => t.rpc("apps/listSessions", {})), Effect.exit, Effect.provide(makeTransportLayer(opts))));
+        expect(Exit.isFailure(exit)).toBe(true);
+        if (Exit.isFailure(exit)) {
+            const failure = Cause.failureOption(exit.cause);
+            expect(Option.isSome(failure)).toBe(true);
+            if (Option.isSome(failure)) {
+                expect(failure.value).toBeInstanceOf(TransportRpcError);
+                expect(failure.value._tag).toBe("TransportRpcError");
+            }
+        }
+    });
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/cli/transport.test.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,8 @@
-export { MoltZapService, formatCrossConversationBlock, sanitizeForSystemReminder, type ConversationMeta, type ContextOptions, type CrossConvMessage, type CrossConversationEntry, type ServiceOptions, } from "./service.js";
+export { MoltZapService, formatCrossConversationBlock, sanitizeForSystemReminder, type ConversationMeta, type ContextOptions, type CrossConvMessage, type CrossConversationEntry, type ServiceOptions, type ServiceRpcError, } from "./service.js";
+export type { PermissionsRequiredEvent } from "@moltzap/protocol";
+export { AgentNotFoundError, NotConnectedError, RpcServerError, RpcTimeoutError, MalformedFrameError, } from "./runtime/errors.js";
 export { MoltZapChannelCore, type ChannelCoreOptions, type ChannelService, type ContextBlocks, type EnrichedConversationMeta, type EnrichedInboundMessage, type EnrichedSender, type InboundHandler, } from "./channel-core.js";
-export { MoltZapWsClient, type WsClientLogger, type MoltZapWsClientOptions, } from "./ws-client.js";
+export { MoltZapWsClient, type WsClientLogger, type MoltZapWsClientOptions, type TrackedRpcResponse, } from "./ws-client.js";
+export type { SubscriptionFilter, SubscriptionId, EventSubscription, SubscriberHandler, } from "./runtime/subscribers.js";
+export type { CloseInfo } from "./runtime/close-info.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { MoltZapService, formatCrossConversationBlock, sanitizeForSystemReminder, } from "./service.js";
+export { AgentNotFoundError, NotConnectedError, RpcServerError, RpcTimeoutError, MalformedFrameError, } from "./runtime/errors.js";
 export { MoltZapChannelCore, } from "./channel-core.js";
 export { MoltZapWsClient, } from "./ws-client.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,yBAAyB,GAM1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,GAQnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,GAGhB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,yBAAyB,GAO1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,GAQnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,GAIhB,MAAM,gBAAgB,CAAC"}