@wastedcode/claudemux 0.2.0

package/dist/cli/context.js

@@ -0,0 +1,82 @@
+import { claude } from "../agents/claude.js";
+import { adopt } from "../session/adopt.js";
+import { DEFAULT_NAMESPACE } from "../session/constants.js";
+import { backendWithSocket, resolveSocket, sharedDefaultBackend, } from "../session/default-backend.js";
+/**
+ * Resolve the agent by short name. Only `claude` is supported currently;
+ * any other value exits with a typed error message.
+ */
+export function resolveAgent(name) {
+    const key = name ?? "claude";
+    if (key !== "claude") {
+        process.stderr.write(`claudemux: unknown agent "${key}" — only "claude" is supported\n`);
+        process.exit(2);
+    }
+    return claude;
+}
+/** Resolve the namespace, applying the substrate's default. */
+export function resolveNamespace(name) {
+    return name ?? DEFAULT_NAMESPACE;
+}
+/**
+ * Resolve the backend for this CLI invocation. If `--socket` was passed
+ * (and is non-empty after trimming), builds a fresh backend on the
+ * resolved socket; otherwise returns the process-wide shared default
+ * (which itself honors `CLAUDEMUX_SOCKET`). The trim → gate-and-return
+ * consistency lives in `resolveSocket` so a padded `--socket ' x '` lands
+ * on the same server as `--socket x`.
+ */
+export function backend(opts = {}) {
+    if (opts.socket?.trim()) {
+        return backendWithSocket(resolveSocket(opts.socket));
+    }
+    return sharedDefaultBackend();
+}
+/**
+ * Attach a session handle for the CLI's per-invocation reattach. Delegates to
+ * the library {@link adopt} — the ONE owner of "re-attach to a running session"
+ * — so the CLI **recovers the agentSessionId** (and thus can locate the
+ * transcript + hook rendezvous) instead of reimplementing a weaker attach.
+ * Async because recovery reads session metadata.
+ *
+ * @throws `SessionGone` if the named session is not alive (adopt's contract) —
+ *   the CLI surfaces it as a typed, no-tmux-leak error.
+ */
+export function handleFor(o) {
+    return adopt({
+        backend: backend(o),
+        agent: resolveAgent(o.agent),
+        namespace: resolveNamespace(o.namespace),
+        name: o.name,
+    });
+}
+/** The CLI's own default wall-clock cap. */
+const CLI_DEFAULT_MAX_MS = 300_000;
+/**
+ * Build the library's {@link ReadyOpts} from CLI patience flags. The library
+ * imposes **no** default patience; the CLI is a *consumer* and supplies its own
+ * so a shell `wait`/`ask` can't hang forever: if neither bound is given it caps
+ * the wall-clock at {@link CLI_DEFAULT_MAX_MS}. `--timeout-ms` and `--idle-ms`
+ * override; passing `--idle-ms` alone opts out of the wall-clock default (the
+ * caller chose a no-progress bound deliberately).
+ */
+export function patienceOpts(o) {
+    const maxMs = o.timeoutMs ?? (o.idleMs === undefined ? CLI_DEFAULT_MAX_MS : undefined);
+    return {
+        ...(maxMs === undefined ? {} : { maxMs }),
+        ...(o.idleMs === undefined ? {} : { idleMs: o.idleMs }),
+    };
+}
+/** Read all of stdin as UTF-8 — the `<text>` = `"-"` piping convention. */
+export function readStdin() {
+    return new Promise((resolve, reject) => {
+        let buf = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            buf += chunk;
+        });
+        process.stdin.on("end", () => resolve(buf));
+        process.stdin.on("error", reject);
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAyBvC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,MAAM,GAAG,GAAG,IAAI,IAAI,QAAQ,CAAC;IAC7B,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,kCAAkC,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,OAAO,IAAI,IAAI,iBAAiB,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE;IACxC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,oBAAoB,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,CAAgC;IACxD,OAAO,KAAK,CAAC;QACX,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5B,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;QACxC,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC;AACL,CAAC;AAUD,4CAA4C;AAC5C,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,CAAkB;IAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,GAAG,IAAI,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/exists.d.ts

@@ -0,0 +1,7 @@
+import { type RefOpts } from "./context.js";
+/**
+ * `claudemux exists <name>` — print `true` / `false` and exit 0 / 1
+ * (matches POSIX shell convention: existence as success).
+ */
+export declare function existsCli(name: string, opts?: RefOpts): Promise<void>;
+//# sourceMappingURL=exists.d.ts.map

package/dist/cli/exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../src/cli/exists.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,cAAc,CAAC;AAEvE;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,OAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/E"}

package/dist/cli/exists.js

@@ -0,0 +1,16 @@
+import { exists } from "../session/registry.js";
+import { backend, resolveNamespace } from "./context.js";
+/**
+ * `claudemux exists <name>` — print `true` / `false` and exit 0 / 1
+ * (matches POSIX shell convention: existence as success).
+ */
+export async function existsCli(name, opts = {}) {
+    const ok = await exists({
+        name,
+        namespace: resolveNamespace(opts.namespace),
+        backend: backend(opts),
+    });
+    process.stdout.write(`${ok}\n`);
+    process.exit(ok ? 0 : 1);
+}
+//# sourceMappingURL=exists.js.map

package/dist/cli/exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../src/cli/exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAgB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAgB,EAAE;IAC9D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC;QACtB,IAAI;QACJ,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;KACvB,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cli/interrupt.d.ts

@@ -0,0 +1,10 @@
+import { type CommonOpts } from "./context.js";
+/**
+ * `claudemux interrupt <name>` — fire ESC at the session to stop a working
+ * agent. Mirrors the `interrupt()` library verb 1:1 (no body, unlike `send`).
+ *
+ * ESC is sent regardless of state; it is meaningful only when the agent is
+ * `working`. ESC on an idle claude is harmless (it clears the input box).
+ */
+export declare function interruptCli(name: string, opts?: CommonOpts): Promise<void>;
+//# sourceMappingURL=interrupt.d.ts.map

package/dist/cli/interrupt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../src/cli/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,cAAc,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrF"}

package/dist/cli/interrupt.js

@@ -0,0 +1,13 @@
+import { handleFor } from "./context.js";
+/**
+ * `claudemux interrupt <name>` — fire ESC at the session to stop a working
+ * agent. Mirrors the `interrupt()` library verb 1:1 (no body, unlike `send`).
+ *
+ * ESC is sent regardless of state; it is meaningful only when the agent is
+ * `working`. ESC on an idle claude is harmless (it clears the input box).
+ */
+export async function interruptCli(name, opts = {}) {
+    const handle = await handleFor({ ...opts, name });
+    await handle.interrupt();
+}
+//# sourceMappingURL=interrupt.js.map

package/dist/cli/interrupt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.js","sourceRoot":"","sources":["../../src/cli/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAmB,EAAE;IACpE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;AAC3B,CAAC"}

package/dist/cli/kill.d.ts

@@ -0,0 +1,7 @@
+import { type RefOpts } from "./context.js";
+/**
+ * `claudemux kill <name>` — kill exactly the named session. Idempotent:
+ * killing a session that's already gone exits 0.
+ */
+export declare function killCli(name: string, opts?: RefOpts): Promise<void>;
+//# sourceMappingURL=kill.d.ts.map

package/dist/cli/kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.d.ts","sourceRoot":"","sources":["../../src/cli/kill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,cAAc,CAAC;AAEvE;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,OAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E"}

package/dist/cli/kill.js

@@ -0,0 +1,14 @@
+import { kill } from "../session/registry.js";
+import { backend, resolveNamespace } from "./context.js";
+/**
+ * `claudemux kill <name>` — kill exactly the named session. Idempotent:
+ * killing a session that's already gone exits 0.
+ */
+export async function killCli(name, opts = {}) {
+    await kill({
+        name,
+        namespace: resolveNamespace(opts.namespace),
+        backend: backend(opts),
+    });
+}
+//# sourceMappingURL=kill.js.map

package/dist/cli/kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../src/cli/kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAgB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAAgB,EAAE;IAC5D,MAAM,IAAI,CAAC;QACT,IAAI;QACJ,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/list.d.ts

@@ -0,0 +1,10 @@
+import { type RefOpts } from "./context.js";
+/**
+ * `claudemux list [namespace]` — print short session names in `namespace`, one
+ * per line. The namespace may come from the positional OR `--namespace`; the
+ * flag wins when both are given (the CLI's cross-verb vocabulary uses the flag).
+ * That reconciliation is owned HERE, not in the command wiring — every other
+ * verb passes opts straight through, so this verb shouldn't be the exception.
+ */
+export declare function listCli(positionalNamespace: string | undefined, opts?: RefOpts): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/cli/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAA6B,MAAM,cAAc,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,IAAI,GAAE,OAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/cli/list.js

@@ -0,0 +1,19 @@
+import { list } from "../session/registry.js";
+import { backend, resolveNamespace } from "./context.js";
+/**
+ * `claudemux list [namespace]` — print short session names in `namespace`, one
+ * per line. The namespace may come from the positional OR `--namespace`; the
+ * flag wins when both are given (the CLI's cross-verb vocabulary uses the flag).
+ * That reconciliation is owned HERE, not in the command wiring — every other
+ * verb passes opts straight through, so this verb shouldn't be the exception.
+ */
+export async function listCli(positionalNamespace, opts = {}) {
+    const names = await list({
+        namespace: resolveNamespace(opts.namespace ?? positionalNamespace),
+        backend: backend(opts),
+    });
+    for (const name of names) {
+        process.stdout.write(`${name}\n`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/cli/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAgB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,mBAAuC,EACvC,OAAgB,EAAE;IAElB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC;QACvB,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC;QAClE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "commander";
+/**
+ * Build the `claudemux` commander entry. Exported separately from `bin/`
+ * so tests can drive it without spawning a subprocess.
+ *
+ * Verb names match the library 1:1 — `claudemux send name "..."` is
+ * `send(name, "...")` on the library side. Help strings carry zero
+ * references to any specific backend.
+ */
+export declare function buildProgram(): Command;
+/** Entry point — handles typed-error exit codes uniformly. */
+export declare function runCli(argv: string[]): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA2HtC;AAQD,8DAA8D;AAC9D,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5D"}

package/dist/cli/main.js

@@ -0,0 +1,143 @@
+import { Command } from "commander";
+import { ClaudemuxError } from "../errors.js";
+import { askCli } from "./ask.js";
+import { captureCli } from "./capture.js";
+import { existsCli } from "./exists.js";
+import { interruptCli } from "./interrupt.js";
+import { killCli } from "./kill.js";
+import { listCli } from "./list.js";
+import { messagesCli } from "./messages.js";
+import { respondCli } from "./respond.js";
+import { resumeCli } from "./resume.js";
+import { sendCli } from "./send.js";
+import { spawnCli } from "./spawn.js";
+import { stateCli } from "./state.js";
+import { turnCompleteCli } from "./turn-complete.js";
+import { waitCli } from "./wait.js";
+/**
+ * Build the `claudemux` commander entry. Exported separately from `bin/`
+ * so tests can drive it without spawning a subprocess.
+ *
+ * Verb names match the library 1:1 — `claudemux send name "..."` is
+ * `send(name, "...")` on the library side. Help strings carry zero
+ * references to any specific backend.
+ */
+export function buildProgram() {
+    const program = new Command();
+    program.name("claudemux").description("Drive long-lived Claude Code sessions from Node.");
+    // Every verb locates a session: namespace prefix + an explicit socket override
+    // (the latter for dev / debugging — most users share the default socket).
+    const common = (cmd) => cmd
+        .option("-n, --namespace <name>", 'session namespace (default: "claudemux")')
+        .option("-s, --socket <name>", 'explicit socket name (default: $CLAUDEMUX_SOCKET or "claudemux")');
+    // Verbs that resolve an AGENT (spawn/resume/send/ask/…) also take --agent.
+    // Registry verbs (kill/list/exists) don't — they query the backend by name,
+    // so --agent there would be dead. Keeping it off them is the coherent shape.
+    const withAgent = (cmd) => common(cmd).option("-a, --agent <name>", 'agent (default: "claude"; only "claude" supported currently)');
+    withAgent(program.command("spawn <name>"))
+        .description("start a session and wait for the REPL to be ready")
+        .requiredOption("--cwd <path>", "working directory for the session")
+        .option("--boot-timeout-ms <ms>", "boot timeout (default 60000)", parseIntOpt)
+        .option("--trust-workspace", "grant the agent read/edit/execute on --cwd (writes a persistent per-folder trust flag); without it, an untrusted folder fails closed")
+        .action(async (name, opts) => {
+        await spawnCli(name, opts);
+    });
+    withAgent(program.command("resume <name> <agentSessionId>"))
+        .description("continue an existing conversation in a fresh pane")
+        .requiredOption("--cwd <path>", "working directory for the session")
+        .option("--boot-timeout-ms <ms>", "boot timeout (default 60000)", parseIntOpt)
+        .option("--trust-workspace", "grant the agent read/edit/execute on --cwd (see spawn)")
+        .action(async (name, agentSessionId, opts) => {
+        await resumeCli(name, agentSessionId, opts);
+    });
+    withAgent(program.command("send <name> <text>"))
+        .description("deliver text as one logical user turn (use '-' to read from stdin)")
+        .action(async (name, text, opts) => {
+        await sendCli(name, text, opts);
+    });
+    withAgent(program.command("ask <name> <text>"))
+        .description("one Q&A round-trip: send, wait for the turn, print outcome + messages")
+        .option("--timeout-ms <ms>", "wall-clock cap in ms (CLI default 300000)", parseIntOpt)
+        .option("--idle-ms <ms>", "give up after this long with no progress", parseIntOpt)
+        .action(async (name, text, opts) => {
+        await askCli(name, text, opts);
+    });
+    withAgent(program.command("messages <name> <cursor>"))
+        .description("print the messages produced since <cursor> (from send/ask) as JSON")
+        .action(async (name, cursor, opts) => {
+        await messagesCli(name, cursor, opts);
+    });
+    withAgent(program.command("turn-complete <name> <cursor>"))
+        .description("print true/false (exit 0/1): did the turn at <cursor> produce a reply?")
+        .action(async (name, cursor, opts) => {
+        await turnCompleteCli(name, cursor, opts);
+    });
+    withAgent(program.command("interrupt <name>"))
+        .description("fire ESC at the session to stop a working agent (harmless when idle)")
+        .action(async (name, opts) => {
+        await interruptCli(name, opts);
+    });
+    withAgent(program.command("respond <name> <choice>"))
+        .description("answer a permission prompt: choice = approve | approve-for-session | deny")
+        .action(async (name, choice, opts) => {
+        await respondCli(name, choice, opts);
+    });
+    withAgent(program.command("wait <name>"))
+        .description("block until the turn reaches a terminal outcome; print it as JSON")
+        .option("--timeout-ms <ms>", "wall-clock cap in ms (CLI default 300000)", parseIntOpt)
+        .option("--idle-ms <ms>", "give up after this long with no progress", parseIntOpt)
+        .action(async (name, opts) => {
+        await waitCli(name, opts);
+    });
+    withAgent(program.command("state <name>"))
+        .description("print the current fused session state")
+        .action(async (name, opts) => {
+        await stateCli(name, opts);
+    });
+    withAgent(program.command("capture <name>"))
+        .description("print the pane text")
+        .option("--ansi", "preserve escape sequences")
+        .option("--lines <n>", "print only the bottom-N lines", parseIntOpt)
+        .action(async (name, opts) => {
+        await captureCli(name, opts);
+    });
+    common(program.command("kill <name>"))
+        .description("kill the named session (idempotent — kill of a missing session is success)")
+        .action(async (name, opts) => {
+        await killCli(name, opts);
+    });
+    common(program.command("list [namespace]"))
+        .description("print short session names in the namespace, one per line")
+        .action(async (positionalNs, opts) => {
+        await listCli(positionalNs, opts);
+    });
+    common(program.command("exists <name>"))
+        .description('print "true"/"false"; exit 0 if alive, 1 if not')
+        .action(async (name, opts) => {
+        await existsCli(name, opts);
+    });
+    return program;
+}
+function parseIntOpt(raw) {
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n))
+        throw new Error(`invalid integer: ${raw}`);
+    return n;
+}
+/** Entry point — handles typed-error exit codes uniformly. */
+export async function runCli(argv) {
+    const program = buildProgram();
+    try {
+        await program.parseAsync(argv);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof ClaudemuxError) {
+            process.stderr.write(`${err.message}\n`);
+            return 1;
+        }
+        process.stderr.write(`claudemux: ${err.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/messages.d.ts

@@ -0,0 +1,9 @@
+import { type CommonOpts } from "./context.js";
+/**
+ * `claudemux messages <name> <cursor>` — read the messages produced since the
+ * given cursor (the one `send`/`ask` emitted). Prints them as a JSON array.
+ * The CLI read face for the library's `messagesSince(cursor)` — without it,
+ * `send` would emit a cursor the CLI could never consume.
+ */
+export declare function messagesCli(name: string, cursor: string, opts?: CommonOpts): Promise<void>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/cli/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/cli/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,cAAc,CAAC;AAE1D;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/cli/messages.js

@@ -0,0 +1,13 @@
+import { handleFor } from "./context.js";
+/**
+ * `claudemux messages <name> <cursor>` — read the messages produced since the
+ * given cursor (the one `send`/`ask` emitted). Prints them as a JSON array.
+ * The CLI read face for the library's `messagesSince(cursor)` — without it,
+ * `send` would emit a cursor the CLI could never consume.
+ */
+export async function messagesCli(name, cursor, opts = {}) {
+    const handle = await handleFor({ ...opts, name });
+    const messages = await handle.messagesSince(cursor);
+    process.stdout.write(`${JSON.stringify(messages)}\n`);
+}
+//# sourceMappingURL=messages.js.map

package/dist/cli/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/cli/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,MAAc,EACd,OAAmB,EAAE;IAErB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/cli/respond.d.ts

@@ -0,0 +1,10 @@
+import { type CommonOpts } from "./context.js";
+/**
+ * `claudemux respond <name> <choice>` — answer the permission prompt the
+ * session is awaiting. Mirrors the `respond()` library verb 1:1. `<choice>` is
+ * one of `approve` / `approve-for-session` / `deny` (NOT a digit — the menu
+ * order is the agent's, not the caller's). Gate on `state <name>` reading
+ * `permission-prompt` first, in the same quick sequence.
+ */
+export declare function respondCli(name: string, choice: string, opts?: CommonOpts): Promise<void>;
+//# sourceMappingURL=respond.d.ts.map

package/dist/cli/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../src/cli/respond.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,cAAc,CAAC;AAS1D;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/cli/respond.js

@@ -0,0 +1,23 @@
+import { handleFor } from "./context.js";
+/** The CLI choice tokens, mapped 1:1 to the neutral {@link PromptChoice}. */
+const CHOICES = {
+    approve: "approve",
+    "approve-for-session": "approve-for-session",
+    deny: "deny",
+};
+/**
+ * `claudemux respond <name> <choice>` — answer the permission prompt the
+ * session is awaiting. Mirrors the `respond()` library verb 1:1. `<choice>` is
+ * one of `approve` / `approve-for-session` / `deny` (NOT a digit — the menu
+ * order is the agent's, not the caller's). Gate on `state <name>` reading
+ * `permission-prompt` first, in the same quick sequence.
+ */
+export async function respondCli(name, choice, opts = {}) {
+    const parsed = CHOICES[choice];
+    if (parsed === undefined) {
+        throw new Error(`unknown choice ${JSON.stringify(choice)}; expected one of: ${Object.keys(CHOICES).join(", ")}`);
+    }
+    const handle = await handleFor({ ...opts, name });
+    await handle.respond(parsed);
+}
+//# sourceMappingURL=respond.js.map

package/dist/cli/respond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.js","sourceRoot":"","sources":["../../src/cli/respond.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,6EAA6E;AAC7E,MAAM,OAAO,GAAiC;IAC5C,OAAO,EAAE,SAAS;IAClB,qBAAqB,EAAE,qBAAqB;IAC5C,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,MAAc,EACd,OAAmB,EAAE;IAErB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/cli/resume.d.ts

@@ -0,0 +1,12 @@
+import { type CommonOpts } from "./context.js";
+export interface ResumeCliOpts extends CommonOpts {
+    cwd: string;
+    bootTimeoutMs?: number;
+    trustWorkspace?: boolean;
+}
+/**
+ * `claudemux resume <name> <agentSessionId> --cwd <path>` — continue an existing
+ * conversation in a fresh pane. A thin face over the library {@link resume}.
+ */
+export declare function resumeCli(name: string, agentSessionId: string, opts: ResumeCliOpts): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/cli/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/cli/resume.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,cAAc,CAAC;AAExF,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/cli/resume.js

@@ -0,0 +1,21 @@
+import { resume } from "../session/resume.js";
+import { backend, resolveAgent, resolveNamespace } from "./context.js";
+/**
+ * `claudemux resume <name> <agentSessionId> --cwd <path>` — continue an existing
+ * conversation in a fresh pane. A thin face over the library {@link resume}.
+ */
+export async function resumeCli(name, agentSessionId, opts) {
+    const session = await resume({
+        name,
+        agentSessionId,
+        cwd: opts.cwd,
+        backend: backend(opts),
+        agent: resolveAgent(opts.agent),
+        namespace: resolveNamespace(opts.namespace),
+        ...(opts.bootTimeoutMs === undefined ? {} : { bootTimeoutMs: opts.bootTimeoutMs }),
+        ...(opts.trustWorkspace === undefined ? {} : { trustWorkspace: opts.trustWorkspace }),
+    });
+    // Same shape as spawn — the resumed conversation id, for the next hop.
+    process.stdout.write(`${JSON.stringify({ agentSessionId: session.agentSessionId ?? null })}\n`);
+}
+//# sourceMappingURL=resume.js.map

package/dist/cli/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/cli/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAmB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQxF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,cAAsB,EACtB,IAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAC3B,IAAI;QACJ,cAAc;QACd,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;KACtF,CAAC,CAAC;IACH,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC"}

package/dist/cli/send.d.ts

@@ -0,0 +1,9 @@
+import { type CommonOpts } from "./context.js";
+/**
+ * `claudemux send <name> <text>` — deliver text as one logical user turn.
+ *
+ * If `text` is `"-"`, the body is read from stdin (useful for piping in
+ * larger payloads or templated content).
+ */
+export declare function sendCli(name: string, text: string, opts?: CommonOpts): Promise<void>;
+//# sourceMappingURL=send.d.ts.map

package/dist/cli/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/cli/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,cAAc,CAAC;AAErE;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9F"}

package/dist/cli/send.js

@@ -0,0 +1,16 @@
+import { handleFor, readStdin } from "./context.js";
+/**
+ * `claudemux send <name> <text>` — deliver text as one logical user turn.
+ *
+ * If `text` is `"-"`, the body is read from stdin (useful for piping in
+ * larger payloads or templated content).
+ */
+export async function sendCli(name, text, opts = {}) {
+    const body = text === "-" ? await readStdin() : text;
+    const handle = await handleFor({ ...opts, name });
+    const cursor = await handle.send(body);
+    // Emit the cursor so `claudemux messages <name> <cursor>` can read this turn's
+    // output (CLI mirrors the library's send → cursor contract).
+    process.stdout.write(`${JSON.stringify({ cursor })}\n`);
+}
+//# sourceMappingURL=send.js.map

package/dist/cli/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/cli/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY,EAAE,OAAmB,EAAE;IAC7E,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,+EAA+E;IAC/E,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}

package/dist/cli/spawn.d.ts

@@ -0,0 +1,14 @@
+import { type CommonOpts } from "./context.js";
+export interface SpawnCliOpts extends CommonOpts {
+    cwd: string;
+    bootTimeoutMs?: number;
+    extraArgs?: string[];
+    trustWorkspace?: boolean;
+}
+/**
+ * `claudemux spawn <name> --cwd <path>` — start a session and wait for ready.
+ * Emits `{ "agentSessionId": "<id>" }` so a CLI user can persist the id and
+ * later `claudemux resume <name2> <id>` (mirrors `send` emitting its cursor).
+ */
+export declare function spawnCli(name: string, opts: SpawnCliOpts): Promise<void>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/cli/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/cli/spawn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,cAAc,CAAC;AAExF,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9E"}

package/dist/cli/spawn.js

@@ -0,0 +1,21 @@
+import { create } from "../session/create.js";
+import { backend, resolveAgent, resolveNamespace } from "./context.js";
+/**
+ * `claudemux spawn <name> --cwd <path>` — start a session and wait for ready.
+ * Emits `{ "agentSessionId": "<id>" }` so a CLI user can persist the id and
+ * later `claudemux resume <name2> <id>` (mirrors `send` emitting its cursor).
+ */
+export async function spawnCli(name, opts) {
+    const session = await create({
+        name,
+        cwd: opts.cwd,
+        backend: backend(opts),
+        agent: resolveAgent(opts.agent),
+        namespace: resolveNamespace(opts.namespace),
+        ...(opts.bootTimeoutMs === undefined ? {} : { bootTimeoutMs: opts.bootTimeoutMs }),
+        ...(opts.extraArgs === undefined ? {} : { extraArgs: opts.extraArgs }),
+        ...(opts.trustWorkspace === undefined ? {} : { trustWorkspace: opts.trustWorkspace }),
+    });
+    process.stdout.write(`${JSON.stringify({ agentSessionId: session.agentSessionId ?? null })}\n`);
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/cli/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAmB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AASxF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAkB;IAC7D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAC3B,IAAI;QACJ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;KACtF,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC"}

package/dist/cli/state.d.ts

@@ -0,0 +1,7 @@
+import { type CommonOpts } from "./context.js";
+/**
+ * `claudemux state <name>` — print the current pane state
+ * (`working` / `idle` / `permission-prompt` / `dialog` / `unknown`).
+ */
+export declare function stateCli(name: string, opts?: CommonOpts): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/cli/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/cli/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAa,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF"}