@synap-core/cli 1.12.2 → 1.13.1-next.20261102.246dc73

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

@@ -0,0 +1,48 @@
+/**
+ * `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 { type HubConfig } from "../lib/hub-client.js";
+import { type WaitSessionOpts } from "./session-wait.js";
+export interface WaitSessionFeedOpts extends WaitSessionOpts {
+    events?: string;
+    once?: boolean;
+    wakeOnly?: boolean;
+    peek?: boolean;
+    hook?: boolean;
+}
+/** What `--hook` exits with — Claude Code's asyncRewake reads 2 as "wake". */
+export declare const WAKE_HOOK_EXIT: {
+    readonly WAKE: 2;
+    readonly IDLE: 0;
+};
+export declare function waitSessionFeedCommand(sessionIdArg: string | undefined, opts: WaitSessionFeedOpts): Promise<void>;
+/**
+ * The hook's whole decision, without the process around it — what the tests
+ * drive. Returns the exit code and the stderr text.
+ */
+export declare function runWakeHook(sessionId: string, cfg: HubConfig, p: {
+    kinds: string[];
+    timeoutMs: number;
+    conversationId: string | undefined;
+    limit?: number;
+    pollSeconds?: number;
+    retryDelayMs?: number;
+}): Promise<{
+    code: number;
+    message: string;
+}>;
+export declare function waitSessionHookCommand(sessionIdArg: string | undefined, opts: WaitSessionFeedOpts): Promise<void>;

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":"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"}

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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,MAAM,EACN,OAAO,EACP,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAwB7C,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrH,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,SAAmB,EACnB,IAAqB;IAErB,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,IAAqE,CAAC;IAC1E,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,GAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,0DAA0D;QAC1D,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAkC,CAAC;QAC1G,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,WAAW,mDAAmD,CAAC,CAAC,CAAC;YACpG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QACxC,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,MAAM,CAAC,SAAS,WAAW,EAAE;YAC5D,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,IAAI;YACb,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,EAAE,GAAG,CAAC,CAAiB,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,cAAc,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,IAAI,CACN,2IAA2I,CAC5I,CAAC;QACF,IAAI,GAAG,CAAC,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IACD,GAAG,CAAC,OAAO,CACT,GAAG,EAAE,CAAC,MAAM,oBAAoB,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC3D,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAC7F,CAAC;IACF,IAAI,GAAG,CAAC,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,oHAAoH,CAAC,CAAC;IAChI,CAAC;IACD,IAAI,GAAG,CAAC,SAAS;QAAE,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -6,9 +6,8 @@
  * 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
- * `~/.claude/projects/-Users-antoine-Documents-Code-synap/memory/
- * scratch-lane-answer-loop-2026-09-25.md`) and exits the moment a reply
+ * 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.
  *
@@ -107,5 +106,11 @@ export interface WaitSessionOpts extends BaseOpts {
     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(sessionId: string, opts: WaitSessionOpts): Promise<void>;
+export declare function waitSessionCommand(sessionIdArg: string | undefined, opts: WaitSessionOpts): Promise<void>;

package/dist/commands/session-wait.js

@@ -6,9 +6,8 @@
  * 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
- * `~/.claude/projects/-Users-antoine-Documents-Code-synap/memory/
- * scratch-lane-answer-loop-2026-09-25.md`) and exits the moment a reply
+ * 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.
  *
@@ -24,7 +23,7 @@
  */
 import chalk from "chalk";
 import { log } from "../utils/logger.js";
-import { resolveHubConfig, hubGet, renderHubError, } from "../lib/hub-client.js";
+import { resolveHubConfig, resolveActiveSessionId, hubGet, renderHubError, } from "../lib/hub-client.js";
 import { requireFullId } from "../lib/id.js";
 import { pollForApproval } from "../lib/approval-poll.js";
 import { parseDuration } from "./proposals-await.js";
@@ -137,7 +136,23 @@ export const SESSION_WAIT_EXIT = {
     TIMEOUT: 1,
     FAILURE: 2,
 };
-export async function waitSessionCommand(sessionId, opts) {
+export async function waitSessionCommand(sessionIdArg, opts) {
+    // The change feed and the Claude Code hook ride the long-poll feed door;
+    // the answer-only wait below keeps its own poll, unchanged.
+    if (opts.hook) {
+        const { waitSessionHookCommand } = await import("./session-feed-wait.js");
+        return waitSessionHookCommand(sessionIdArg, opts);
+    }
+    if (opts.events || opts.wakeOnly || opts.once || opts.peek) {
+        const { waitSessionFeedCommand } = await import("./session-feed-wait.js");
+        return waitSessionFeedCommand(sessionIdArg, opts);
+    }
+    const sessionId = sessionIdArg ?? resolveActiveSessionId();
+    if (!sessionId) {
+        console.error(chalk.red("No session given and none attached to this terminal. Pass one, or run: synap session attach <id>"));
+        process.exit(SESSION_WAIT_EXIT.FAILURE);
+        return;
+    }
     requireFullId(sessionId, "session", chalk, log);
     const timeoutMs = parseDuration(opts.timeout, DEFAULT_TIMEOUT_MS);
     const intervalMs = parseDuration(opts.interval, DEFAULT_INTERVAL_MS);

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

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

package/dist/commands/sessions.d.ts

@@ -56,6 +56,8 @@ export declare function closeSession(id: string, opts: BaseOpts & {
     workspace?: string;
     recap?: string;
     as?: string;
+    withdraw?: string[];
+    keepOwed?: string[];
 }): Promise<void>;
 /**
  * `synap session evidence <key> --passed|--failed [--detail "…"]`

package/dist/commands/sessions.js

@@ -1,6 +1,7 @@
 import chalk from "chalk";
 import { log } from "../utils/logger.js";
 import { resolveHubConfig, hubGet, hubPatch, hubPost, attachActiveSessionId, detachActiveSessionId, resolveActiveSessionId, renderHubError, HubError, } from "../lib/hub-client.js";
+import { closeQuestionDispositions, openQuestionsRefusal, } from "./close-questions.js";
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
 /**
@@ -484,6 +485,11 @@ export function sessionStatus(opts) {
  * from the row (workspaceId body is back-compat only).
  */
 export async function closeSession(id, opts) {
+    const settled = closeQuestionDispositions(opts);
+    if (!settled.ok) {
+        console.error(chalk.red(`Error: ${settled.error}`));
+        process.exit(1);
+    }
     try {
         const cfg = await resolveHubConfig(opts);
         const wsId = opts.workspace || cfg.workspaceId;
@@ -500,6 +506,8 @@ export async function closeSession(id, opts) {
             // and being rejected by a zod enum the user cannot see.
             if (opts.as)
                 body.terminalStatus = opts.as;
+            if (settled.dispositions.length > 0)
+                body.questionDispositions = settled.dispositions;
             pack = (await hubPost(`/focus-sessions/${id}/complete`, body, cfg));
             usedPack = true;
         }
@@ -568,6 +576,21 @@ export async function closeSession(id, opts) {
         }
     }
     catch (e) {
+        const refusal = openQuestionsRefusal(e);
+        if (refusal) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, status: "refused", ...refusal }, null, 2));
+            }
+            else {
+                log.error("Not closed: questions you asked in this session are still open.");
+                for (const q of refusal.openQuestions) {
+                    console.log(`  ${chalk.white(q.shortId ?? q.messageId.slice(0, 8))}  ${q.text}  ${chalk.dim(q.messageId)}`);
+                }
+                log.dim("  Relay the person's chat answer first (relay_answer), or close again with " +
+                    "--withdraw <messageId>=<why> or --keep-owed <messageId> for each.");
+            }
+            process.exit(1);
+        }
         renderHubError(e);
         process.exit(1);
     }