@synap-core/cli 1.11.0 → 1.13.0

package/dist/commands/session-feed-wait.js

@@ -0,0 +1,261 @@
+/**
+ * `synap session wait [sessionId] --events <kinds>` and `--hook`.
+ *
+ * `--events` waits on the session CHANGE FEED (`lib/session-feed.ts`) instead
+ * of answers only: answers, decided proposals, stage moves, the owner's room
+ * messages and — on pods that deliver them — messages from another session's
+ * agent (`session_message`). It prints each event's FENCED text, its intent
+ * and its sender session, and the exact reply (with `--cause`).
+ *
+ * `--hook` is the same wait shaped for a Claude Code `asyncRewake` Stop hook
+ * (installed by `synap hooks install-wake` / `synap init`): it blocks until a
+ * wake-worthy event, prints the message on stderr and exits 2 — the code
+ * Claude Code reads as "wake the model with this" — and exits 0 on everything
+ * else (timeout, no attached session, a newer waiter, a failure), so a hook
+ * can never wake an agent with an error and loop. The contract it relies on is
+ * documented in `lib/wake-hook-settings.ts`.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveActiveSessionId, renderHubError, } from "../lib/hub-client.js";
+import { getClaudeSessionId } from "../lib/session-lens.js";
+import { isUuid, requireFullId } from "../lib/id.js";
+import { parseDuration } from "./proposals-await.js";
+import { SESSION_MESSAGE_KIND, SessionMessagesUnsupportedError, WAKE_HOOK_DEFAULT_KINDS, isWakeEvent, parseEventKinds, renderFeedEvent, renderWakeMessage, waitForSessionFeed, } from "../lib/session-feed.js";
+import { claimWake, isWakeOwner, readWakeState, recordRead, takeDelivery, wakeStatePath, } from "../lib/wake-state.js";
+import { SESSION_WAIT_EXIT } from "./session-wait.js";
+/** What `--hook` exits with — Claude Code's asyncRewake reads 2 as "wake". */
+export const WAKE_HOOK_EXIT = { WAKE: 2, IDLE: 0 };
+const DEFAULT_TIMEOUT_MS = 30 * 60_000;
+function parseLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    return Number.isInteger(n) && n >= 1 && n <= 100 ? n : null;
+}
+// ─── --events ─────────────────────────────────────────────────────────────────
+export async function waitSessionFeedCommand(sessionIdArg, opts) {
+    const fail = (msg) => {
+        console.error(chalk.red(msg));
+        process.exit(SESSION_WAIT_EXIT.FAILURE);
+    };
+    let kinds;
+    try {
+        kinds = opts.events ? parseEventKinds(opts.events) : [...WAKE_HOOK_DEFAULT_KINDS];
+    }
+    catch (e) {
+        return fail(e.message);
+    }
+    const timeoutMs = parseDuration(opts.timeout, DEFAULT_TIMEOUT_MS);
+    if (timeoutMs === null) {
+        return fail("Unparseable duration. Use a number with a unit: 500ms, 30s, 15m, 2h (bare number = seconds).");
+    }
+    const limit = parseLimit(opts.limit);
+    if (limit === null)
+        return fail("--limit must be a whole number between 1 and 100.");
+    let cfg;
+    let sessionId;
+    let result;
+    try {
+        cfg = await resolveHubConfig(opts);
+        const resolved = sessionIdArg ?? resolveActiveSessionId(cfg.podUrl);
+        if (!resolved) {
+            return fail("No session given and none attached to this terminal. Pass one, or run: synap session attach <id>");
+        }
+        requireFullId(resolved, "session", chalk, log);
+        sessionId = resolved;
+        if (!opts.json) {
+            log.dim(`Waiting on session ${sessionId.slice(0, 8)} for ${kinds.join(", ")}${opts.wakeOnly ? " (wake-worthy only)" : ""} — up to ${timeoutMs < 120_000 ? `${Math.round(timeoutMs / 1000)}s` : `${Math.round(timeoutMs / 60_000)}m`}.`);
+        }
+        result = await waitForSessionFeed(sessionId, cfg, {
+            kinds,
+            // No --since: the pod's UNREAD mode — answers not picked up and mail not
+            // read yet, of any age, so a message that landed before this wait counts.
+            since: opts.since,
+            timeoutMs,
+            limit,
+            stamp: !opts.peek,
+            once: opts.once,
+            ...(opts.wakeOnly ? { accept: isWakeEvent } : {}),
+        });
+    }
+    catch (e) {
+        if (e instanceof SessionMessagesUnsupportedError)
+            return fail(e.message);
+        renderHubError(e);
+        process.exit(SESSION_WAIT_EXIT.FAILURE);
+        return;
+    }
+    const resume = `synap session wait ${sessionId} --events ${kinds.join(",")}${opts.wakeOnly ? " --wake-only" : ""} --since ${result.nextSince ?? "<cursor>"}`;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            sessionId,
+            since: result.nextSince,
+            events: result.events,
+            state: result.state,
+            hasMore: result.hasMore,
+            skipped: result.skipped,
+            ...(result.events.length === 0 ? { timedOut: true, elapsedMs: result.elapsedMs } : {}),
+        }, null, 2));
+    }
+    else if (result.events.length === 0) {
+        log.error(`Timed out after ${Math.round(result.elapsedMs / 1000)}s — nothing new.`);
+        if (result.skipped > 0)
+            log.hint(`${result.skipped} event(s) read that do not wake (--wake-only).`);
+        log.hint(`Resume  →  ${resume}`);
+    }
+    else {
+        for (const e of result.events) {
+            const [head, ...rest] = renderFeedEvent(e);
+            log.success(head ?? e.kind);
+            for (const line of rest)
+                console.log(line);
+        }
+        if (result.skipped > 0)
+            log.dim(`${result.skipped} other event(s) read that do not wake (--wake-only).`);
+        if (result.hasMore)
+            log.dim("More waiting: run the cursor line again.");
+        log.dim(`Cursor  →  ${resume}`);
+    }
+    process.exit(result.events.length > 0 ? SESSION_WAIT_EXIT.ANSWERED : SESSION_WAIT_EXIT.TIMEOUT);
+}
+// ─── --hook ───────────────────────────────────────────────────────────────────
+/** The Stop hook's stdin (`session_id`, `cwd`, …); `{}` when there is none. */
+async function readHookInput(timeoutMs = 1_000) {
+    if (process.stdin.isTTY)
+        return {};
+    return new Promise((resolve) => {
+        let raw = "";
+        const done = () => {
+            process.stdin.removeAllListeners();
+            process.stdin.pause();
+            try {
+                const v = JSON.parse(raw);
+                resolve(v && typeof v === "object" ? v : {});
+            }
+            catch {
+                resolve({});
+            }
+        };
+        const timer = setTimeout(done, timeoutMs);
+        timer.unref();
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (raw += chunk));
+        process.stdin.on("end", () => {
+            clearTimeout(timer);
+            done();
+        });
+        process.stdin.on("error", () => {
+            clearTimeout(timer);
+            done();
+        });
+    });
+}
+/** Write to stderr, THEN exit: a pipe write is async, and exit would cut it. */
+function finishHook(code, message = "") {
+    return new Promise(() => {
+        if (!message)
+            process.exit(code);
+        process.stderr.write(message, () => process.exit(code));
+    });
+}
+/**
+ * The hook's whole decision, without the process around it — what the tests
+ * drive. Returns the exit code and the stderr text.
+ */
+export async function runWakeHook(sessionId, cfg, p) {
+    const file = wakeStatePath(p.conversationId, sessionId);
+    const owner = claimWake(file);
+    let kinds = p.kinds;
+    let note = "";
+    const deadline = Date.now() + p.timeoutMs;
+    for (;;) {
+        let result;
+        try {
+            result = await waitForSessionFeed(sessionId, cfg, {
+                kinds,
+                since: readWakeState(file).since ?? undefined,
+                timeoutMs: Math.max(deadline - Date.now(), 1_000),
+                limit: p.limit,
+                pollSeconds: p.pollSeconds,
+                retryDelayMs: p.retryDelayMs,
+                accept: isWakeEvent,
+                onCursor: (since) => recordRead(file, { since }),
+                onSkipped: (carry) => recordRead(file, { since: null, carry }),
+                shouldStop: () => !isWakeOwner(file, owner),
+            });
+        }
+        catch (e) {
+            if (e instanceof SessionMessagesUnsupportedError && kinds.includes(SESSION_MESSAGE_KIND)) {
+                kinds = kinds.filter((k) => k !== SESSION_MESSAGE_KIND);
+                note = `[synap wake] ${e.message} Waiting on ${kinds.join(", ") || "nothing"} only.\n`;
+                if (kinds.length === 0)
+                    return { code: WAKE_HOOK_EXIT.IDLE, message: note };
+                continue;
+            }
+            // Never wake an agent with an error: a hook that exits 2 on a failure
+            // would wake it, stop, re-arm and fail again, forever.
+            return {
+                code: WAKE_HOOK_EXIT.IDLE,
+                message: `${note}[synap wake] not waiting: ${e.message}\n`,
+            };
+        }
+        if (result.stopped)
+            return { code: WAKE_HOOK_EXIT.IDLE, message: `${note}[synap wake] a newer wait took over.\n` };
+        if (result.events.length === 0)
+            return { code: WAKE_HOOK_EXIT.IDLE, message: `${note}[synap wake] timed out, nothing new.\n` };
+        const delivery = takeDelivery(file, { events: result.events, since: result.nextSince });
+        if (delivery.events.length === 0) {
+            return { code: WAKE_HOOK_EXIT.IDLE, message: `${note}[synap wake] already delivered by another wait.\n` };
+        }
+        return {
+            code: WAKE_HOOK_EXIT.WAKE,
+            message: note + renderWakeMessage(sessionId, delivery.events, delivery.carried),
+        };
+    }
+}
+export async function waitSessionHookCommand(sessionIdArg, opts) {
+    // `claude -p` (and the SDK without streaming input) runs an asyncRewake hook
+    // in the FOREGROUND (Claude Code 2.1.309: backgrounded only when interactive
+    // or with streaming input), so a wait here would hold the whole run open.
+    const entrypoint = process.env.CLAUDE_CODE_ENTRYPOINT;
+    if (entrypoint?.startsWith("sdk-")) {
+        return finishHook(WAKE_HOOK_EXIT.IDLE, `[synap wake] not waiting: a non-interactive run (${entrypoint}) would block on this hook.\n`);
+    }
+    const input = await readHookInput();
+    // The hook's stdin names the conversation; the lens and the conversation
+    // header read it from the same variable the statusline uses.
+    if (input.session_id && !getClaudeSessionId())
+        process.env.SYNAP_LENS_SESSION = input.session_id;
+    let kinds;
+    try {
+        kinds = opts.events ? parseEventKinds(opts.events) : [...WAKE_HOOK_DEFAULT_KINDS];
+    }
+    catch (e) {
+        return finishHook(WAKE_HOOK_EXIT.IDLE, `[synap wake] ${e.message}\n`);
+    }
+    const timeoutMs = parseDuration(opts.timeout, DEFAULT_TIMEOUT_MS);
+    const limit = parseLimit(opts.limit);
+    if (timeoutMs === null || limit === null) {
+        return finishHook(WAKE_HOOK_EXIT.IDLE, "[synap wake] bad --timeout or --limit.\n");
+    }
+    let cfg;
+    try {
+        cfg = await resolveHubConfig(opts);
+    }
+    catch (e) {
+        return finishHook(WAKE_HOOK_EXIT.IDLE, `[synap wake] no pod: ${e.message}\n`);
+    }
+    const sessionId = sessionIdArg ?? resolveActiveSessionId(cfg.podUrl);
+    if (!sessionId || !isUuid(sessionId)) {
+        return finishHook(WAKE_HOOK_EXIT.IDLE, "[synap wake] no session attached to this terminal (synap session attach <id>), nothing to wait on.\n");
+    }
+    const { code, message } = await runWakeHook(sessionId, cfg, {
+        kinds,
+        timeoutMs,
+        conversationId: getClaudeSessionId(),
+        limit,
+    });
+    return finishHook(code, message);
+}
+//# sourceMappingURL=session-feed-wait.js.map

package/dist/commands/session-feed-wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-feed-wait.js","sourceRoot":"","sources":["../../src/commands/session-feed-wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAwB,MAAM,mBAAmB,CAAC;AAU5E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAW,CAAC;AAE5D,MAAM,kBAAkB,GAAG,EAAE,GAAG,MAAM,CAAC;AAEvC,SAAS,UAAU,CAAC,GAAuB;IACzC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,YAAgC,EAChC,IAAyB;IAEzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAS,EAAE;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC;IACF,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAClE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,8FAA8F,CAAC,CAAC;IAC9G,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAErF,IAAI,GAAc,CAAC;IACnB,IAAI,SAAiB,CAAC;IACtB,IAAI,MAA6B,CAAC;IAClC,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,YAAY,IAAI,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,kGAAkG,CAAC,CAAC;QAClH,CAAC;QACD,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/C,SAAS,GAAG,QAAQ,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,GAAG,CACL,sBAAsB,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,YAAY,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,GAAG,CAC/N,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE;YAChD,KAAK;YACL,yEAAyE;YACzE,0EAA0E;YAC1E,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;YACT,KAAK;YACL,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,+BAA+B;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzE,cAAc,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,SAAS,aAAa,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,MAAM,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;IAC7J,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,SAAS;YACT,KAAK,EAAE,MAAM,CAAC,SAAS;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACpF,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,gDAAgD,CAAC,CAAC;QACpG,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YAC3C,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,sDAAsD,CAAC,CAAC;QACzG,IAAI,MAAM,CAAC,OAAO;YAAE,GAAG,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxE,GAAG,CAAC,GAAG,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC;AAED,iFAAiF;AAEjF,+EAA+E;AAC/E,KAAK,UAAU,aAAa,CAAC,SAAS,GAAG,KAAK;IAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;gBACrC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,EAAE,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC1C,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,SAAS,UAAU,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE;IAC5C,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACtB,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,GAAc,EACd,CAOC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACpB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;IAE1C,SAAS,CAAC;QACR,IAAI,MAA6B,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE;gBAChD,KAAK;gBACL,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,SAAS;gBAC7C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;gBACjD,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;gBAChD,SAAS,EAAE,CAAC,KAAyB,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;gBAClF,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,+BAA+B,IAAI,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACzF,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,oBAAoB,CAAC,CAAC;gBACxD,IAAI,GAAG,gBAAgB,CAAC,CAAC,OAAO,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,UAAU,CAAC;gBACvF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAC5E,SAAS;YACX,CAAC;YACD,sEAAsE;YACtE,uDAAuD;YACvD,OAAO;gBACL,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,OAAO,EAAE,GAAG,IAAI,6BAA8B,CAAW,CAAC,OAAO,IAAI;aACtE,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,wCAAwC,EAAE,CAAC;QACnH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,wCAAwC,EAAE,CAAC;QAE/H,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,mDAAmD,EAAE,CAAC;QAC5G,CAAC;QACD,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO,EAAE,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;SAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,YAAgC,EAChC,IAAyB;IAEzB,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACtD,IAAI,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,UAAU,CACf,cAAc,CAAC,IAAI,EACnB,oDAAoD,UAAU,+BAA+B,CAC9F,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;IACpC,yEAAyE;IACzE,6DAA6D;IAC7D,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,kBAAkB,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,KAAK,CAAC,UAAU,CAAC;IAEjG,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAiB,CAAW,CAAC,OAAO,IAAI,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,SAAS,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,0CAA0C,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,GAAc,CAAC;IACnB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAyB,CAAW,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,IAAI,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,UAAU,CACf,cAAc,CAAC,IAAI,EACnB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE;QAC1D,KAAK;QACL,SAAS;QACT,cAAc,EAAE,kBAAkB,EAAE;QACpC,KAAK;KACN,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/session-post.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `synap session post <toSessionId> <text>` — an agent's typed message to
+ * ANOTHER session (a coordination post): `--intent blocked_on_you | handoff |
+ * done | fyi`, the reply's `--cause`, `--ref` pointers to the state behind it.
+ *
+ * The CLI twin of MCP `synap_post_message` with `toSessionId`. It goes through
+ * the Hub door `POST /threads/<target room>/messages` with `intent`, so the
+ * pod's ONE codec (`session-post.ts` in synap-backend) decides the sender
+ * session (this terminal's bound session, or `--from`), the target and the
+ * wake — only blocked_on_you and handoff may wake the other agent, a reply
+ * chain wakes at most once, at most 3 wakes per session pair per 10 minutes.
+ * The CLI decides none of it and only reports what the pod stamped.
+ *
+ * `--cause` is how a reply made inside a wake turn names the message that
+ * woke it (the feed event id `synap session wait --hook` prints): the pod's
+ * hop guard counts on it to stop two agents waking each other forever.
+ *
+ * A pod that predates coordination posts drops `intent` without a word and
+ * stores a plain room post; the reply then carries no `sessionPost`, and this
+ * command says so (exit 1) instead of reporting a delivery that did not happen.
+ */
+import { type BaseOpts } from "./data.js";
+export interface SessionPostOpts extends BaseOpts {
+    intent?: string;
+    cause?: string;
+    from?: string;
+    ref?: string[];
+}
+/** `kind:id` or `kind:id:label` → the pod's ref shape. The pod validates kind and id. */
+export declare function parseRef(raw: string): {
+    kind: string;
+    id: string;
+    label?: string;
+};
+export declare const SESSION_POST_EXIT: {
+    readonly DELIVERED: 0;
+    readonly NOT_ADDRESSED: 1;
+    readonly FAILURE: 2;
+};
+export declare function sessionPostCommand(toSessionId: string, textParts: string[], opts: SessionPostOpts): Promise<void>;

package/dist/commands/session-post.js

@@ -0,0 +1,96 @@
+/**
+ * `synap session post <toSessionId> <text>` — an agent's typed message to
+ * ANOTHER session (a coordination post): `--intent blocked_on_you | handoff |
+ * done | fyi`, the reply's `--cause`, `--ref` pointers to the state behind it.
+ *
+ * The CLI twin of MCP `synap_post_message` with `toSessionId`. It goes through
+ * the Hub door `POST /threads/<target room>/messages` with `intent`, so the
+ * pod's ONE codec (`session-post.ts` in synap-backend) decides the sender
+ * session (this terminal's bound session, or `--from`), the target and the
+ * wake — only blocked_on_you and handoff may wake the other agent, a reply
+ * chain wakes at most once, at most 3 wakes per session pair per 10 minutes.
+ * The CLI decides none of it and only reports what the pod stamped.
+ *
+ * `--cause` is how a reply made inside a wake turn names the message that
+ * woke it (the feed event id `synap session wait --hook` prints): the pod's
+ * hop guard counts on it to stop two agents waking each other forever.
+ *
+ * A pod that predates coordination posts drops `intent` without a word and
+ * stores a plain room post; the reply then carries no `sessionPost`, and this
+ * command says so (exit 1) instead of reporting a delivery that did not happen.
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveUserId, hubGet, hubPost, renderHubError, } from "../lib/hub-client.js";
+import { requireFullId } from "../lib/id.js";
+/** `kind:id` or `kind:id:label` → the pod's ref shape. The pod validates kind and id. */
+export function parseRef(raw) {
+    const [kind, id, ...label] = raw.split(":");
+    if (!kind || !id)
+        throw new Error(`--ref ${JSON.stringify(raw)}: use kind:id or kind:id:label (e.g. session:<id>).`);
+    return label.length > 0 ? { kind, id, label: label.join(":") } : { kind, id };
+}
+export const SESSION_POST_EXIT = { DELIVERED: 0, NOT_ADDRESSED: 1, FAILURE: 2 };
+export async function sessionPostCommand(toSessionId, textParts, opts) {
+    requireFullId(toSessionId, "session", chalk, log);
+    const text = textParts.join(" ").trim();
+    if (!text) {
+        console.error(chalk.red("Say something: synap session post <sessionId> \"<text>\""));
+        process.exit(SESSION_POST_EXIT.FAILURE);
+    }
+    let refs;
+    try {
+        refs = opts.ref?.length ? opts.ref.map(parseRef) : undefined;
+    }
+    catch (e) {
+        console.error(chalk.red(e.message));
+        process.exit(SESSION_POST_EXIT.FAILURE);
+    }
+    let res;
+    try {
+        const cfg = await resolveHubConfig(opts);
+        // The target's room: every post to a session lands there.
+        const target = (await hubGet(`/focus-sessions/${toSessionId}`, {}, cfg));
+        if (!target?.channelId) {
+            console.error(chalk.red(`Session ${toSessionId} has no room yet, so it cannot receive a message.`));
+            process.exit(SESSION_POST_EXIT.FAILURE);
+        }
+        const userId = await resolveUserId(cfg);
+        res = (await hubPost(`/threads/${target.channelId}/messages`, {
+            role: "assistant",
+            content: text,
+            userId,
+            intent: opts.intent ?? "fyi",
+            ...(opts.from ? { fromSessionId: opts.from } : {}),
+            ...(refs ? { refs } : {}),
+            ...(opts.cause ? { cause: opts.cause } : {}),
+        }, cfg));
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(SESSION_POST_EXIT.FAILURE);
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(res, null, 2));
+        process.exit(res.sessionPost ? SESSION_POST_EXIT.DELIVERED : SESSION_POST_EXIT.NOT_ADDRESSED);
+    }
+    const sp = res.sessionPost;
+    if (!sp) {
+        log.warn("This pod does not deliver agent messages yet: the text landed in that session's room as a plain post, addressed to no one, waking no one.");
+        if (res.messageId)
+            log.hint(`Message ${res.messageId}`);
+        process.exit(SESSION_POST_EXIT.NOT_ADDRESSED);
+    }
+    log.success(`${sp.intent} sent to session ${sp.to.sessionId.slice(0, 8)}` +
+        (sp.wake ? " — it may wake that session's agent." : " — delivered without waking anyone."));
+    if (res.note)
+        log.dim(res.note);
+    if (!sp.from.sessionId) {
+        log.dim("No sender session: this terminal is bound to none, so the other agent cannot reply. Pass --from <your session id>.");
+    }
+    if (res.messageId)
+        log.dim(`Message ${res.messageId}`);
+    process.exit(SESSION_POST_EXIT.DELIVERED);
+}
+//# sourceMappingURL=session-post.js.map

package/dist/commands/session-post.js.map

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

package/dist/commands/session-wait.d.ts

@@ -0,0 +1,116 @@
+/**
+ * `synap session wait <sessionId>` — block until the session's human owner
+ * replies in the room.
+ *
+ * The loop-back half of the "ask, then wait" shape: an agent posts a question
+ * into the session room (`synap_post_message` / the room), then calls this
+ * command instead of a hand-rolled sleep loop or a blind re-invocation. It
+ * polls `GET /api/hub/focus-sessions/:id/answers` (owner-floored; `since`
+ * exclusive; contract in pod document
+ * `db390250-3a74-4707-bb29-5832a454d194`) and exits the moment a reply
+ * arrives, printing it so the calling agent (Claude Code or any shell agent)
+ * can read it back and continue.
+ *
+ * Reuses `pollForApproval` — the ONE poll loop already shared by CP login,
+ * agent-key provisioning, and `proposals await`. No second poller. The
+ * generic `onTick` hook (data:null on a network blip or non-2xx) is enough to
+ * add one behaviour pollForApproval doesn't have on its own: a FAILED read is
+ * not "no answer yet". A handful of transient blips are tolerated (the
+ * existing per-tick interval IS the backoff), but a run of them means the
+ * read is genuinely broken, not merely pending — so this throws out of the
+ * poll loop rather than silently accumulating toward a "timeout" verdict that
+ * would misreport a broken pod as "the human hasn't answered".
+ */
+import { type HubConfig } from "../lib/hub-client.js";
+import { type BaseOpts } from "./data.js";
+/**
+ * The TYPED half of an answer, when the slot carried an `ask` (the pod's
+ * `SlotAnswerValue`). `text` stays the readable summary either way; this is
+ * the machine-readable pick. Loose on purpose: a CLI older than a new arm
+ * still prints it rather than dropping it.
+ */
+export type SessionAnswerValue = {
+    type: string;
+} & Record<string, unknown>;
+export interface SessionAnswer {
+    id: string;
+    text: string;
+    /** Absent on pods that predate typed answers; `null` for a free-text one. */
+    value?: SessionAnswerValue | null;
+    answeredAt: string;
+    answeredBy: string;
+    messageId: string | null;
+    slot: {
+        label: string;
+        kind: string;
+        question: string | null;
+    } | null;
+    question: {
+        messageId: string;
+        text: string;
+        askedAt: string;
+        askedBy: string | null;
+    } | null;
+}
+export interface AnswersPage {
+    sessionId: string;
+    since: string | null;
+    answers: SessionAnswer[];
+    nextSince: string | null;
+    hasMore: boolean;
+}
+/**
+ * Thrown when a read FAILED (bad response shape, repeated non-2xx, or the
+ * network dropping) — never confused with "the human hasn't answered yet".
+ * Distinct from pollForApproval's own timeout error so the command can give
+ * each a different exit code.
+ */
+export declare class SessionWaitReadFailure extends Error {
+}
+export interface WaitForAnswersOptions {
+    /** Only answers strictly after this ISO timestamp. Omit for "everything so far". */
+    since?: string;
+    timeoutMs: number;
+    intervalMs: number;
+    limit?: number;
+}
+export interface WaitForAnswersResult {
+    answers: SessionAnswer[];
+    /** Cursor to pass as `--since` on the next call — advances even on a timeout. */
+    nextSince: string | null;
+    elapsedMs: number;
+}
+/**
+ * Wait for at least one answer to land, or the deadline to elapse.
+ *
+ * Two phases, both against the same door: an IMMEDIATE first check (so an
+ * already-waiting answer, or a broken/owner-mismatched session, surfaces
+ * without paying one poll interval — same shape as `awaitProposal`'s first
+ * check), then the shared poll loop for the pending case.
+ */
+export declare function waitForAnswers(sessionId: string, cfg: HubConfig, opts: WaitForAnswersOptions): Promise<WaitForAnswersResult>;
+/**
+ * The answer's typed value worth printing: a structured pick (confirm, chip,
+ * form, provide). A `{type:"text"}` value adds nothing to the text line, and a
+ * malformed one (no string `type`) is not printed as if it were an answer.
+ */
+export declare function typedValue(a: SessionAnswer): SessionAnswerValue | null;
+/** Exit codes — documented on the command's `--help` (see index.ts). */
+export declare const SESSION_WAIT_EXIT: {
+    readonly ANSWERED: 0;
+    readonly TIMEOUT: 1;
+    readonly FAILURE: 2;
+};
+export interface WaitSessionOpts extends BaseOpts {
+    since?: string;
+    timeout?: string;
+    interval?: string;
+    limit?: string;
+    /** The change feed instead of answers only (`session-feed-wait.ts`). */
+    events?: string;
+    once?: boolean;
+    wakeOnly?: boolean;
+    peek?: boolean;
+    hook?: boolean;
+}
+export declare function waitSessionCommand(sessionIdArg: string | undefined, opts: WaitSessionOpts): Promise<void>;