@moltzap/client 2026.414.0 → 2026.425.0

package/dist/cli/commands/permissions.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `moltzap permissions <subcommand>` — handlers for spec sbd#177 rev 3 §5.4.
+ *
+ * Three subcommands, one RPC each:
+ *
+ *   permissions grant   → permissions/grant
+ *   permissions list    → permissions/list
+ *   permissions revoke  → permissions/revoke
+ *
+ * Auth model: Assumption §6.2 — agent-scoped (not admin-only). Architect
+ * verified against the server handler during impl (Q-PG-1 RESOLVED HIGH).
+ */
+import { Command } from "@effect/cli";
+import { Effect, Option } from "effect";
+import { type Transport, type TransportError } from "../transport.js";
+/** Exhaustive error union for the permissions surface. */
+export type PermissionsCommandError = TransportError | PermissionsInputError;
+export declare class PermissionsInputError extends Error {
+    readonly reason: string;
+    readonly _tag: "PermissionsInputError";
+    constructor(reason: string);
+}
+/**
+ * `moltzap permissions grant --session <id> --agent <id> --resource <r>
+ * --access <a>...` — spec §5.4 bullet 1. `access` is `--access` repeated
+ * per Assumption §6.4.
+ */
+export interface PermissionsGrantArgs {
+    readonly sessionId: string;
+    readonly agentId: string;
+    readonly resource: string;
+    readonly access: ReadonlyArray<string>;
+}
+/** `moltzap permissions list [--app <id>]` — spec §5.4 bullet 2. */
+export interface PermissionsListArgs {
+    readonly appId?: string;
+}
+/** `moltzap permissions revoke --app <id> --resource <r>` — spec §5.4 bullet 3. */
+export interface PermissionsRevokeArgs {
+    readonly appId: string;
+    readonly resource: string;
+}
+/** Wraps `permissions/grant`. Emits a success marker to stdout. */
+export declare const permissionsGrantHandler: (args: PermissionsGrantArgs) => Effect.Effect<void, PermissionsCommandError, Transport>;
+/**
+ * Wraps `permissions/list`. Emits one grant per line (appId, resource,
+ * access[], grantedAt).
+ */
+export declare const permissionsListHandler: (args: PermissionsListArgs) => Effect.Effect<void, PermissionsCommandError, Transport>;
+/** Wraps `permissions/revoke`. Emits a success marker to stdout. */
+export declare const permissionsRevokeHandler: (args: PermissionsRevokeArgs) => Effect.Effect<void, PermissionsCommandError, Transport>;
+/** `moltzap permissions [grant|list|revoke]` subcommand group. */
+export declare const permissionsCommand: Command.Command<"permissions", Transport, never, {
+    readonly subcommand: Option.Option<{
+        readonly session: string;
+        readonly agent: string;
+        readonly resource: string;
+        readonly access: string[];
+    } | {
+        readonly app: Option.Option<string>;
+    } | {
+        readonly app: string;
+        readonly resource: string;
+    }>;
+}>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/cli/commands/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAW,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAIzB,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAE7E,qBAAa,qBAAsB,SAAQ,KAAK;IAElC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADnC,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;gBAC5B,MAAM,EAAE,MAAM;CAGpC;AAID;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAID,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,GAClC,MAAM,oBAAoB,KACzB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,EAAE,SAAS,CAoBrD,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,mBAAmB,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,EAAE,SAAS,CAmBrD,CAAC;AAEL,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,GACnC,MAAM,qBAAqB,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,EAAE,SAAS,CASrD,CAAC;AAmEL,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAe9B,CAAC"}

package/dist/cli/commands/permissions.js

@@ -0,0 +1,101 @@
+/**
+ * `moltzap permissions <subcommand>` — handlers for spec sbd#177 rev 3 §5.4.
+ *
+ * Three subcommands, one RPC each:
+ *
+ *   permissions grant   → permissions/grant
+ *   permissions list    → permissions/list
+ *   permissions revoke  → permissions/revoke
+ *
+ * Auth model: Assumption §6.2 — agent-scoped (not admin-only). Architect
+ * verified against the server handler during impl (Q-PG-1 RESOLVED HIGH).
+ */
+import { Command, Options } from "@effect/cli";
+import { Effect, Option } from "effect";
+import { rpc, runHandler, } from "../transport.js";
+export class PermissionsInputError extends Error {
+    reason;
+    _tag = "PermissionsInputError";
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+    }
+}
+// ─── Handlers ──────────────────────────────────────────────────────────────
+/** Wraps `permissions/grant`. Emits a success marker to stdout. */
+export const permissionsGrantHandler = (args) => Effect.gen(function* () {
+    if (args.access.length === 0) {
+        return yield* Effect.fail(new PermissionsInputError("--access requires at least one value (e.g. --access read)"));
+    }
+    yield* rpc("permissions/grant", {
+        sessionId: args.sessionId,
+        agentId: args.agentId,
+        resource: args.resource,
+        access: [...args.access],
+    });
+    yield* Effect.sync(() => {
+        console.log(`granted: agent=${args.agentId} resource=${args.resource} access=${args.access.join(",")}`);
+    });
+});
+/**
+ * Wraps `permissions/list`. Emits one grant per line (appId, resource,
+ * access[], grantedAt).
+ */
+export const permissionsListHandler = (args) => Effect.gen(function* () {
+    const params = {};
+    if (args.appId !== undefined)
+        params.appId = args.appId;
+    const result = yield* rpc("permissions/list", params);
+    yield* Effect.sync(() => {
+        for (const g of result.grants) {
+            console.log(`${g.appId}\t${g.resource}\t${g.access.join(",")}\t${g.grantedAt}`);
+        }
+    });
+});
+/** Wraps `permissions/revoke`. Emits a success marker to stdout. */
+export const permissionsRevokeHandler = (args) => Effect.gen(function* () {
+    yield* rpc("permissions/revoke", {
+        appId: args.appId,
+        resource: args.resource,
+    });
+    yield* Effect.sync(() => {
+        console.log(`revoked: app=${args.appId} resource=${args.resource}`);
+    });
+});
+// ─── CLI commands ──────────────────────────────────────────────────────────
+const sessionOption = Options.text("session").pipe(Options.withDescription("Session id"));
+const agentOption = Options.text("agent").pipe(Options.withDescription("Agent id"));
+const resourceOption = Options.text("resource").pipe(Options.withDescription("Resource identifier"));
+const accessOption = Options.text("access").pipe(Options.withDescription("Access kind (repeatable)"), Options.repeated);
+const permissionsGrantCommand = Command.make("grant", {
+    session: sessionOption,
+    agent: agentOption,
+    resource: resourceOption,
+    access: accessOption,
+}, ({ session, agent, resource, access }) => runHandler(permissionsGrantHandler({
+    sessionId: session,
+    agentId: agent,
+    resource,
+    access,
+}))).pipe(Command.withDescription("Grant permissions on a session resource"));
+const permAppOption = Options.text("app").pipe(Options.withDescription("Filter by app id"), Options.optional);
+const permissionsListCommand = Command.make("list", { app: permAppOption }, ({ app }) => {
+    const args = Option.isSome(app)
+        ? { appId: app.value }
+        : {};
+    return runHandler(permissionsListHandler(args));
+}).pipe(Command.withDescription("List active permission grants"));
+const revokeAppOption = Options.text("app").pipe(Options.withDescription("App id"));
+const revokeResourceOption = Options.text("resource").pipe(Options.withDescription("Resource identifier"));
+const permissionsRevokeCommand = Command.make("revoke", { app: revokeAppOption, resource: revokeResourceOption }, ({ app, resource }) => runHandler(permissionsRevokeHandler({ appId: app, resource }))).pipe(Command.withDescription("Revoke a permission"));
+/** `moltzap permissions [grant|list|revoke]` subcommand group. */
+export const permissionsCommand = Command.make("permissions", {}, () => Effect.sync(() => {
+    console.log("Usage: moltzap permissions <grant|list|revoke> [options]");
+})).pipe(Command.withDescription("Manage session permissions. Runs as the identity selected by the " +
+    "global --as / --profile flags (see `moltzap --help`); grants/revokes " +
+    "are scoped to that caller's owner id."), Command.withSubcommands([
+    permissionsGrantCommand,
+    permissionsListCommand,
+    permissionsRevokeCommand,
+]));
+//# sourceMappingURL=permissions.js.map

package/dist/cli/commands/permissions.js.map

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

package/dist/cli/commands/permissions.test.d.ts

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

package/dist/cli/commands/permissions.test.d.ts.map

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

package/dist/cli/commands/permissions.test.js

@@ -0,0 +1,126 @@
+/**
+ * Unit tests for `moltzap permissions <subcommand>` handlers. Spec
+ * test-coverage floor: one success + one RPC-failure per handler.
+ */
+import { Effect } from "effect";
+import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
+import { permissionsGrantHandler, permissionsListHandler, permissionsRevokeHandler, } from "./permissions.js";
+import { Transport, TransportRpcError, } from "../transport.js";
+const makeFakeTransport = (respond) => {
+    const calls = [];
+    const transport = {
+        kind: "test",
+        rpc: (method, params) => {
+            calls.push({ method, params });
+            const out = respond({ method, params });
+            if (out instanceof Error) {
+                return Effect.fail(new TransportRpcError({ method, code: -32000, message: out.message }));
+            }
+            return Effect.succeed(out);
+        },
+    };
+    return { calls, transport };
+};
+describe("permissions grant", () => {
+    let stdout;
+    beforeEach(() => {
+        stdout = vi.spyOn(console, "log").mockImplementation(() => { });
+    });
+    afterEach(() => stdout.mockRestore());
+    it("calls permissions/grant with { sessionId, agentId, resource, access[] }", async () => {
+        const { calls, transport } = makeFakeTransport(() => ({}));
+        await Effect.runPromise(permissionsGrantHandler({
+            sessionId: "sess-1",
+            agentId: "agent-a",
+            resource: "res-1",
+            access: ["read", "write"],
+        }).pipe(Effect.provideService(Transport, transport)));
+        expect(calls).toEqual([
+            {
+                method: "permissions/grant",
+                params: {
+                    sessionId: "sess-1",
+                    agentId: "agent-a",
+                    resource: "res-1",
+                    access: ["read", "write"],
+                },
+            },
+        ]);
+    });
+    it("rejects empty access with PermissionsInputError", async () => {
+        const { transport } = makeFakeTransport(() => ({}));
+        const result = await Effect.runPromiseExit(permissionsGrantHandler({
+            sessionId: "s",
+            agentId: "a",
+            resource: "r",
+            access: [],
+        }).pipe(Effect.provideService(Transport, transport)));
+        expect(result._tag).toBe("Failure");
+    });
+    it("surfaces TransportRpcError", async () => {
+        const { transport } = makeFakeTransport(() => new Error("denied"));
+        const result = await Effect.runPromiseExit(permissionsGrantHandler({
+            sessionId: "s",
+            agentId: "a",
+            resource: "r",
+            access: ["read"],
+        }).pipe(Effect.provideService(Transport, transport)));
+        expect(result._tag).toBe("Failure");
+    });
+});
+describe("permissions list", () => {
+    let stdout;
+    beforeEach(() => {
+        stdout = vi.spyOn(console, "log").mockImplementation(() => { });
+    });
+    afterEach(() => stdout.mockRestore());
+    it("calls permissions/list with optional appId filter and prints one grant per line", async () => {
+        const { calls, transport } = makeFakeTransport(() => ({
+            grants: [
+                {
+                    appId: "app-1",
+                    resource: "r1",
+                    access: ["read"],
+                    grantedAt: "2026-01-01T00:00:00Z",
+                },
+            ],
+        }));
+        await Effect.runPromise(permissionsListHandler({ appId: "app-1" }).pipe(Effect.provideService(Transport, transport)));
+        expect(calls[0]).toEqual({
+            method: "permissions/list",
+            params: { appId: "app-1" },
+        });
+        expect(stdout).toHaveBeenCalledTimes(1);
+    });
+    it("omits appId when absent", async () => {
+        const { calls, transport } = makeFakeTransport(() => ({ grants: [] }));
+        await Effect.runPromise(permissionsListHandler({}).pipe(Effect.provideService(Transport, transport)));
+        expect(calls[0]?.params).toEqual({});
+    });
+    it("surfaces TransportRpcError", async () => {
+        const { transport } = makeFakeTransport(() => new Error("fail"));
+        const result = await Effect.runPromiseExit(permissionsListHandler({}).pipe(Effect.provideService(Transport, transport)));
+        expect(result._tag).toBe("Failure");
+    });
+});
+describe("permissions revoke", () => {
+    let stdout;
+    beforeEach(() => {
+        stdout = vi.spyOn(console, "log").mockImplementation(() => { });
+    });
+    afterEach(() => stdout.mockRestore());
+    it("calls permissions/revoke with { appId, resource }", async () => {
+        const { calls, transport } = makeFakeTransport(() => ({}));
+        await Effect.runPromise(permissionsRevokeHandler({ appId: "app-1", resource: "r1" }).pipe(Effect.provideService(Transport, transport)));
+        expect(calls[0]).toEqual({
+            method: "permissions/revoke",
+            params: { appId: "app-1", resource: "r1" },
+        });
+    });
+    it("surfaces TransportRpcError", async () => {
+        const { transport } = makeFakeTransport(() => new Error("fail"));
+        const result = await Effect.runPromiseExit(permissionsRevokeHandler({ appId: "a", resource: "r" }).pipe(Effect.provideService(Transport, transport)));
+        expect(result._tag).toBe("Failure");
+    });
+});
+//# sourceMappingURL=permissions.test.js.map

package/dist/cli/commands/permissions.test.js.map

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

package/dist/cli/commands/ping.d.ts

@@ -1,3 +1,7 @@
-import { Command } from "commander";
-export declare const pingCommand: Command;
+import { Command } from "@effect/cli";
+/**
+ * `moltzap ping` — hit /health on the configured server URL. Exit 0 on
+ * 2xx, 1 otherwise (message to stderr via the caught Error surface).
+ */
+export declare const pingCommand: Command.Command<"ping", never, never, {}>;
 //# sourceMappingURL=ping.d.ts.map

package/dist/cli/commands/ping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,WAAW,SAmBpB,CAAC"}
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAyBtC;;;GAGG;AACH,eAAO,MAAM,WAAW,2CAcmD,CAAC"}

package/dist/cli/commands/ping.js

@@ -1,23 +1,24 @@
-import { Command } from "commander";
+import { Command } from "@effect/cli";
+import { HttpClient, HttpClientRequest } from "@effect/platform";
+import { NodeHttpClient } from "@effect/platform-node";
+import { Effect } from "effect";
 import { getHttpUrl } from "../config.js";
-export const pingCommand = new Command("ping")
-    .description("Check if the MoltZap server is reachable")
-    .action(async () => {
-    const url = `${getHttpUrl()}/health`;
-    try {
-        const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
-        if (res.ok) {
-            console.log("Server reachable");
-            process.exit(0);
-        }
-        else {
-            console.error(`Server unreachable: HTTP ${res.status}`);
-            process.exit(1);
-        }
+const pingEffect = Effect.gen(function* () {
+    const baseUrl = yield* getHttpUrl;
+    const client = yield* HttpClient.HttpClient;
+    const response = yield* client.execute(HttpClientRequest.get(`${baseUrl}/health`));
+    if (response.status < 200 || response.status >= 300) {
+        return yield* Effect.fail(new Error(`Server unreachable: HTTP ${response.status}`));
     }
-    catch (err) {
-        console.error(`Server unreachable: ${err instanceof Error ? err.message : String(err)}`);
-        process.exit(1);
-    }
-});
+}).pipe(Effect.timeout("5 seconds"), Effect.provide(NodeHttpClient.layer), Effect.catchAll((err) => Effect.fail(err instanceof Error ? err : new Error(String(err)))));
+/**
+ * `moltzap ping` — hit /health on the configured server URL. Exit 0 on
+ * 2xx, 1 otherwise (message to stderr via the caught Error surface).
+ */
+export const pingCommand = Command.make("ping", {}, () => pingEffect.pipe(Effect.tap(() => Effect.sync(() => {
+    console.log("Server reachable");
+})), Effect.catchAll((err) => Effect.sync(() => {
+    console.error(`Server unreachable: ${err.message}`);
+    process.exit(1);
+})))).pipe(Command.withDescription("Check if the MoltZap server is reachable"));
 //# sourceMappingURL=ping.js.map

package/dist/cli/commands/ping.js.map

@@ -1 +1 @@
-{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../src/cli/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,GAAG,GAAG,GAAG,UAAU,EAAE,SAAS,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../src/cli/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,UAAU,GAA+B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACpC,iBAAiB,CAAC,GAAG,CAAC,GAAG,OAAO,SAAS,CAAC,CAC3C,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CACzD,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CACjE,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,CACvD,UAAU,CAAC,IAAI,CACb,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CACd,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAClC,CAAC,CAAC,CACH,EACD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CACH,CACF,CACF,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,0CAA0C,CAAC,CAAC,CAAC"}

package/dist/cli/commands/presence.d.ts

@@ -1,3 +1,11 @@
-import { Command } from "commander";
-export declare const presenceCommand: Command;
+import { Command } from "@effect/cli";
+import { Option } from "effect";
+/**
+ * `moltzap presence <status>` — pushes a presence update through the local
+ * Unix socket. Status argument is optional; missing → prints usage. Unknown
+ * values exit 1 after a stderr message.
+ */
+export declare const presenceCommand: Command.Command<"presence", never, never, {
+    readonly status: Option.Option<string>;
+}>;
 //# sourceMappingURL=presence.d.ts.map

package/dist/cli/commands/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,eAAe,SAqBzB,CAAC"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQxC;;;;GAIG;AACH,eAAO,MAAM,eAAe;;EAsC3B,CAAC"}

package/dist/cli/commands/presence.js

@@ -1,19 +1,31 @@
-import { Command } from "commander";
-import { request, action } from "../socket-client.js";
-export const presenceCommand = new Command("presence")
-    .description("Update or show presence status (online, offline, away)")
-    .argument("[status]", "Status to set: online, offline, or away")
-    .action(action(async (status) => {
-    if (!status) {
-        console.log("Usage: moltzap presence <online|offline|away>");
-        return;
+import { Args, Command } from "@effect/cli";
+import { Effect, Option } from "effect";
+import { request } from "../socket-client.js";
+const statusArg = Args.text({ name: "status" }).pipe(Args.withDescription("Status to set: online, offline, or away"), Args.optional);
+/**
+ * `moltzap presence <status>` — pushes a presence update through the local
+ * Unix socket. Status argument is optional; missing → prints usage. Unknown
+ * values exit 1 after a stderr message.
+ */
+export const presenceCommand = Command.make("presence", { status: statusArg }, ({ status }) => {
+    if (Option.isNone(status)) {
+        return Effect.sync(() => {
+            console.log("Usage: moltzap presence <online|offline|away>");
+        });
     }
+    const value = status.value;
     const valid = ["online", "offline", "away"];
-    if (!valid.includes(status)) {
-        console.error(`Invalid status "${status}". Must be one of: ${valid.join(", ")}`);
-        process.exit(1);
+    if (!valid.includes(value)) {
+        return Effect.sync(() => {
+            console.error(`Invalid status "${value}". Must be one of: ${valid.join(", ")}`);
+            process.exit(1);
+        });
     }
-    await request("presence/update", { status });
-    console.log(`Presence set to ${status}.`);
-}));
+    return request("presence/update", { status: value }).pipe(Effect.tap(() => Effect.sync(() => {
+        console.log(`Presence set to ${value}.`);
+    })), Effect.asVoid, Effect.catchAll((err) => Effect.sync(() => {
+        console.error(`Failed: ${err.message}`);
+        process.exit(1);
+    })));
+}).pipe(Command.withDescription("Update or show presence status (online, offline, away)"));
 //# sourceMappingURL=presence.js.map

package/dist/cli/commands/presence.js.map

@@ -1 +1 @@
-{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../src/cli/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACnD,WAAW,CAAC,wDAAwD,CAAC;KACrE,QAAQ,CAAC,UAAU,EAAE,yCAAyC,CAAC;KAC/D,MAAM,CACL,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,EAAE;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CACX,mBAAmB,MAAM,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,GAAG,CAAC,CAAC;AAC5C,CAAC,CAAC,CACH,CAAC"}
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../src/cli/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAClD,IAAI,CAAC,eAAe,CAAC,yCAAyC,CAAC,EAC/D,IAAI,CAAC,QAAQ,CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CACzC,UAAU,EACV,EAAE,MAAM,EAAE,SAAS,EAAE,EACrB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACb,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACtB,OAAO,CAAC,KAAK,CACX,mBAAmB,KAAK,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CACvD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CACd,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC,CACH,EACD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CACH,CACF,CAAC;AACJ,CAAC,CACF,CAAC,IAAI,CACJ,OAAO,CAAC,eAAe,CACrB,wDAAwD,CACzD,CACF,CAAC"}

package/dist/cli/commands/register.d.ts

@@ -1,3 +1,25 @@
-import { Command } from "commander";
-export declare const registerCommand: Command;
+import { Command } from "@effect/cli";
+import { Option } from "effect";
+/**
+ * `moltzap register <name> <invite-code> [-d description] [--profile <name>] [--no-persist]`
+ *
+ * POST /api/v1/auth/register, then (by default) persist the result into
+ * both `~/.moltzap/config.json` and the OpenClaw channel config so the
+ * channel picks it up on its next file-watcher cycle.
+ *
+ * Spec §5.2 extensions:
+ *   --profile <name>  write under `profiles.<name>` instead of legacy top-level
+ *   --no-persist      print result to stdout only; NO writes to either tree
+ *
+ * `--no-persist` gates BOTH the `~/.moltzap/config.json` write AND the
+ * `~/.openclaw/openclaw.json` write (Invariant §4.4 as revised in architect
+ * design doc rev 4 finding 2).
+ */
+export declare const registerCommand: Command.Command<"register", never, never, {
+    readonly name: string;
+    readonly inviteCode: string;
+    readonly description: Option.Option<string>;
+    readonly profile: Option.Option<string>;
+    readonly noPersist: boolean;
+}>;
 //# sourceMappingURL=register.d.ts.map

package/dist/cli/commands/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,eAAO,MAAM,eAAe,SAmDzB,CAAC"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"AAGA,OAAO,EAAQ,OAAO,EAAW,MAAM,aAAa,CAAC;AACrD,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAsHxC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;;;;;EAoF3B,CAAC"}