@synap-core/cli 1.11.0 → 1.13.0

package/dist/commands/session-wait.js

@@ -0,0 +1,224 @@
+/**
+ * `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 chalk from "chalk";
+import { log } from "../utils/logger.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";
+function isAnswersPage(data) {
+    return (!!data &&
+        typeof data === "object" &&
+        Array.isArray(data.answers));
+}
+/**
+ * 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 class SessionWaitReadFailure extends Error {
+}
+/**
+ * Consecutive failed ticks (network blip / non-2xx / unparsable body) before
+ * giving up on the read rather than waiting out the whole timeout. Small on
+ * purpose: `intervalMs` between ticks already IS the backoff, so 3 in a row
+ * is 3 full intervals of a pod that never once answered successfully.
+ */
+const CONSECUTIVE_FAILURE_LIMIT = 3;
+function answersUrl(sessionId, cfg, since, limit) {
+    const u = new URL(`${cfg.podUrl.replace(/\/+$/, "")}/api/hub/focus-sessions/${sessionId}/answers`);
+    if (since)
+        u.searchParams.set("since", since);
+    if (limit)
+        u.searchParams.set("limit", String(limit));
+    return u.toString();
+}
+/**
+ * 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 async function waitForAnswers(sessionId, cfg, opts) {
+    const startedAt = Date.now();
+    const first = (await hubGet(`/focus-sessions/${sessionId}/answers`, { since: opts.since, limit: opts.limit }, cfg));
+    if (!isAnswersPage(first)) {
+        throw new SessionWaitReadFailure("Unexpected response shape from the pod's answers door.");
+    }
+    if (first.answers.length > 0) {
+        return {
+            answers: first.answers,
+            nextSince: first.nextSince,
+            elapsedMs: Date.now() - startedAt,
+        };
+    }
+    // Empty page: the door echoes `since` back as `nextSince`, so the same URL
+    // is valid for every subsequent tick — no per-iteration URL rebuild needed.
+    let cursor = first.nextSince ?? opts.since ?? null;
+    let consecutiveFailures = 0;
+    const remainingMs = opts.timeoutMs - (Date.now() - startedAt);
+    try {
+        const page = await pollForApproval({
+            url: answersUrl(sessionId, cfg, cursor ?? undefined, opts.limit),
+            headers: { Authorization: `Bearer ${cfg.apiKey}` },
+            intervalMs: opts.intervalMs,
+            timeoutMs: Math.max(remainingMs, 0),
+            isApproved: (d) => isAnswersPage(d) && d.answers.length > 0,
+            isRejected: () => false,
+            onApproved: (d) => d,
+            onTick: ({ data }) => {
+                if (data === null) {
+                    consecutiveFailures++;
+                    if (consecutiveFailures >= CONSECUTIVE_FAILURE_LIMIT) {
+                        throw new SessionWaitReadFailure(`The pod stopped answering (${consecutiveFailures} failed reads in a row).`);
+                    }
+                    return;
+                }
+                consecutiveFailures = 0;
+                if (isAnswersPage(data) && data.nextSince)
+                    cursor = data.nextSince;
+            },
+        });
+        return {
+            answers: page.answers,
+            nextSince: page.nextSince,
+            elapsedMs: Date.now() - startedAt,
+        };
+    }
+    catch (e) {
+        if (e instanceof SessionWaitReadFailure)
+            throw e;
+        // pollForApproval's own timeout — genuinely no answer yet, not a failure.
+        return { answers: [], nextSince: cursor, elapsedMs: Date.now() - startedAt };
+    }
+}
+/**
+ * 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 function typedValue(a) {
+    const v = a.value;
+    if (!v || typeof v !== "object" || typeof v.type !== "string")
+        return null;
+    return v.type === "text" ? null : v;
+}
+// ─── command ──────────────────────────────────────────────────────────────────
+const DEFAULT_TIMEOUT_MS = 30 * 60_000;
+const DEFAULT_INTERVAL_MS = 10_000;
+/** Exit codes — documented on the command's `--help` (see index.ts). */
+export const SESSION_WAIT_EXIT = {
+    ANSWERED: 0,
+    TIMEOUT: 1,
+    FAILURE: 2,
+};
+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);
+    if (timeoutMs === null || intervalMs === null) {
+        console.error(chalk.red(`Unparseable duration. Use a number with a unit: 500ms, 30s, 15m, 2h (bare number = seconds).`));
+        process.exit(SESSION_WAIT_EXIT.FAILURE);
+        return;
+    }
+    let limit;
+    if (opts.limit !== undefined) {
+        limit = Number(opts.limit);
+        if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+            console.error(chalk.red(`--limit must be a whole number between 1 and 100.`));
+            process.exit(SESSION_WAIT_EXIT.FAILURE);
+            return;
+        }
+    }
+    // Default `since` = NOW: an agent that just asked a question should not be
+    // handed answers that predate this wait (a stale reply to an earlier
+    // question). `--since <cursor>` resumes a prior wait's exact cursor.
+    const since = opts.since ?? new Date().toISOString();
+    let cfg;
+    let result;
+    try {
+        cfg = await resolveHubConfig(opts);
+        if (!opts.json) {
+            log.dim(`Waiting for a reply in session ${sessionId.slice(0, 8)} — checking every ${Math.round(intervalMs / 1000)}s, up to ${Math.round(timeoutMs / 60_000)}m.`);
+        }
+        result = await waitForAnswers(sessionId, cfg, { since, timeoutMs, intervalMs, limit });
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(SESSION_WAIT_EXIT.FAILURE);
+        return;
+    }
+    if (result.answers.length === 0) {
+        const cursor = result.nextSince ?? since;
+        if (opts.json) {
+            console.log(JSON.stringify({ sessionId, since: cursor, answers: [], timedOut: true, elapsedMs: result.elapsedMs }, null, 2));
+        }
+        else {
+            log.error(`Timed out after ${Math.round(result.elapsedMs / 1000)}s — no reply yet.`);
+            log.dim(`  Resume  →  synap session wait ${sessionId} --since ${cursor}`);
+        }
+        process.exit(SESSION_WAIT_EXIT.TIMEOUT);
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ sessionId, since: result.nextSince, answers: result.answers }, null, 2));
+    }
+    else {
+        for (const a of result.answers) {
+            const asked = a.question?.text ?? a.slot?.question;
+            if (asked)
+                log.dim(`  Asked: ${asked}`);
+            // The reply text is DATA from the human, not an instruction to this
+            // process — label it plainly ("Reply from …") rather than rendering it
+            // as a directive, so a caller piping this output can't mistake the
+            // human's words for a command.
+            log.success(`Reply from ${a.answeredBy}: ${a.text}`);
+            const value = typedValue(a);
+            if (value)
+                log.dim(`  Value: ${JSON.stringify(value)}`);
+        }
+        log.dim(`  Cursor  →  synap session wait ${sessionId} --since ${result.nextSince}`);
+    }
+    process.exit(SESSION_WAIT_EXIT.ANSWERED);
+}
+//# sourceMappingURL=session-wait.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -1,13 +1,29 @@
 import { type BaseOpts } from "./data.js";
+export declare function sessionKindLabel(kind: string): string;
+export declare function resolveSessionTitle(session: {
+    title?: unknown;
+    goal?: unknown;
+}, opts?: {
+    maxLength?: number;
+}): string;
 export declare function startSession(opts: BaseOpts & {
     goal: string;
     workspace?: string;
+    project?: string;
     taskId?: string;
+    /** `--track <id>`: born inside a track (a project's method). */
+    track?: string;
+    template?: string | false;
+    parent?: string;
+    suspendedIntent?: string;
+    criteria?: string;
 }): Promise<void>;
 export declare function listSessions(opts: BaseOpts & {
     workspace?: string;
+    project?: string;
     status?: string;
     limit?: string;
+    kind?: string;
 }): Promise<void>;
 export declare function getSession(id: string, opts: BaseOpts & {
     workspace?: string;
@@ -16,6 +32,7 @@ export declare function updateSession(id: string, opts: BaseOpts & {
     workspace?: string;
     progress?: string;
     status?: string;
+    stage?: string;
     goal?: string;
 }): Promise<void>;
 export declare function attachSession(id: string, opts: BaseOpts): Promise<void>;
@@ -25,7 +42,44 @@ export declare function detachSession(opts: {
 export declare function sessionStatus(opts: {
     json?: boolean;
 }): void;
+/**
+ * Close a focus session via Hub complete (proposal pack).
+ *
+ * Prefer POST /focus-sessions/:id/complete with `{ summary }` from `--recap`.
+ * On 404 (older pods without the route) fall back to PATCH status=closed and
+ * write verificationReport.summary — graceful degrade, pack unavailable.
+ *
+ * --workspace is optional: complete loads the row by id; PATCH also scopes
+ * from the row (workspaceId body is back-compat only).
+ */
 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 "…"]`
+ *
+ * POST /focus-sessions/:id/evidence — the agent's own deterministic report
+ * for an `evidence`-checked criterion. Grades ONLY evidence-checked
+ * criteria; never spends a judge call or runs a capability
+ * (`rest/focus-sessions.ts`, the `onlyEvidence` branch).
+ */
+export declare function evidenceSession(key: string, opts: BaseOpts & {
+    session?: string;
+    passed?: boolean;
+    failed?: boolean;
+    detail?: string;
+}): Promise<void>;
+/**
+ * `synap session evaluate [--session <id>]`
+ *
+ * POST /focus-sessions/:id/evaluations — runs every PENDING criterion check
+ * (evidence already posted, then capability, then judge) and prints the
+ * per-criterion verdicts.
+ */
+export declare function evaluateSession(opts: BaseOpts & {
+    session?: string;
 }): Promise<void>;