@gtc6244/immediacy-daemon 0.2.5 → 0.2.7

package/dist/src/transport.js

@@ -91,6 +91,8 @@ export class Mux {
     highWaterMark;
     reassembler = new Reassembler();
     seqs = new Map();
+    /** Tail of the per-channel send chain — serializes concurrent sends. */
+    sendChains = new Map();
     onMsg = null;
     constructor(transport, opts) {
         this.transport = transport;
@@ -119,18 +121,45 @@ export class Mux {
      * Send a logical message on `channelId`, chunked as needed. Resolves once all
      * chunks are handed to the transport; awaits drain between chunks so a large
      * message (or a terminal firehose) can't grow the queue without bound.
+     *
+     * Sends on the same channel are SERIALIZED: `send` awaits `whenWritable`
+     * mid-message, so a second concurrent `send` (e.g. a heartbeat pong while a
+     * large response is still draining) would otherwise interleave its frames and
+     * reuse the shared `seq` counter — the peer's reassembler mixes the two
+     * messages and its SecureChannel receive counter desyncs, breaking the session.
+     * The per-channel promise chain guarantees one message's frames are fully
+     * written (and `seq` advanced) before the next message on that channel starts.
      */
-    async send(channelId, message) {
+    send(channelId, message) {
+        const prev = this.sendChains.get(channelId) ?? Promise.resolve();
+        // `prev.catch` so one failed send never poisons the ones queued behind it.
+        const next = prev.catch(() => { }).then(() => this.sendChunks(channelId, message));
+        this.sendChains.set(channelId, next);
+        // Drop the chain entry once it drains to the tail, so an idle channel's map
+        // entry doesn't pin the last message's promise forever.
+        void next.catch(() => { }).finally(() => {
+            if (this.sendChains.get(channelId) === next)
+                this.sendChains.delete(channelId);
+        });
+        return next;
+    }
+    async sendChunks(channelId, message) {
         let seq = this.seqs.get(channelId) ?? 0;
-        const frames = splitMessage(channelId, seq, message);
-        for (const frame of frames) {
-            this.transport.send(encodeFrame(frame));
-            seq = (frame.seq + 1) >>> 0;
-            if (this.transport.bufferedAmount() >= this.highWaterMark) {
-                await this.transport.whenWritable(this.highWaterMark);
+        try {
+            for (const frame of splitMessage(channelId, seq, message)) {
+                this.transport.send(encodeFrame(frame));
+                seq = (frame.seq + 1) >>> 0;
+                if (this.transport.bufferedAmount() >= this.highWaterMark) {
+                    await this.transport.whenWritable(this.highWaterMark);
+                }
             }
         }
-        this.seqs.set(channelId, seq);
+        finally {
+            // Persist progress even on a mid-message throw, so the next queued message
+            // never reuses seq numbers already emitted on the wire (which would collide
+            // at the peer's reassembler).
+            this.seqs.set(channelId, seq);
+        }
     }
 }
 //# sourceMappingURL=transport.js.map

package/dist/src/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,cAAc,CAAC;AAmBtB,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAqB;IACzB,OAAO,GAAqC,IAAI,CAAC;IACjD,OAAO,GAAwB,IAAI,CAAC;IACpC,QAAQ,GAAG,CAAC,CAAC;IACb,MAAM,GAAG,KAAK,CAAC;IACf,YAAY,GAA+C,EAAE,CAAC;IAEtE,MAAM,CAAC,IAAI;QACT,MAAM,CAAC,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAClC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACX,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACX,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;QAC7B,4EAA4E;QAC5E,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,EAA2B;QACjC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,EAAc;QACpB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,YAAY,CAAC,aAAqB;QAChC,IAAI,IAAI,CAAC,QAAQ,GAAG,aAAa;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB;QACtB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3C,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE;gBAAE,CAAC,CAAC,OAAO,EAAE,CAAC;;gBACjC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY;YAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,GAAG;IASK;IARF,aAAa,CAAS;IACtB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,wEAAwE;IACvD,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IACvD,KAAK,GAA0D,IAAI,CAAC;IAE5E,YACmB,SAAoB,EACrC,IAAiC;QADhB,cAAS,GAAT,SAAS,CAAW;QAGrC,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,kBAAkB,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,IAAI,GAAkD,CAAC;YACvD,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,uDAAuD;YACjE,CAAC;YACD,IAAI,GAAG;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,EAAgD;QACxD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,oEAAoE;IACpE,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,SAAiB,EAAE,OAAe;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACjE,2EAA2E;QAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrC,4EAA4E;QAC5E,wDAAwD;QACxD,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,OAAe;QACzD,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBAC1D,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACxD,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,2EAA2E;YAC3E,4EAA4E;YAC5E,8BAA8B;YAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF"}

package/dist/src/turn-summarizer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Turn summarizer — condenses one agent turn (everything since the last user
+ * prompt) into a few markdown bullet points via a single cheap LLM call.
+ *
+ * Powers the condensed chat view: when the agent stops (done / awaiting a
+ * permission / asking a question), the workspace manager builds the turn slice
+ * and calls {@link generateTurnSummary}, persists the result as a `summary`
+ * ChatEntry, and broadcasts `event.turn_summary`. Clients in condensed view
+ * collapse the turn to these bullets with a button to expand back to full detail.
+ *
+ * Mirrors `titler.ts`: same vendored Claude Agent SDK, same cheap pinned model,
+ * tools disabled (a pure completion), best-effort with a null fallback so a slow
+ * or failing model call never wedges a turn. The pure helpers
+ * (`buildTurnSlice` / `renderSummaryPrompt` / `hasSummarizableContent`) are
+ * separated out so they are unit-testable without the LLM.
+ */
+import type { ChatEntry } from "./protocol.js";
+/** Cheapest current model — a handful of bullets needs nothing larger. */
+export declare const SUMMARY_MODEL = "claude-haiku-4-5";
+/** The `seq` of the most recent `user` prompt (the start of the latest turn). */
+export declare function lastUserSeq(entries: ChatEntry[]): number | null;
+/**
+ * The entries that make up one turn: everything AFTER the `user` prompt with
+ * `seq === turnStartSeq`, up to (but not including) the next `user` prompt.
+ * Prior summaries and hidden rename records are dropped. Empty if the start
+ * prompt isn't found.
+ */
+export declare function buildTurnSlice(entries: ChatEntry[], turnStartSeq: number): ChatEntry[];
+/** Highest `seq` present in a slice (−1 if none) — the turn's content watermark. */
+export declare function sliceContentSeq(slice: ChatEntry[]): number;
+/** True when a slice has any agent output worth summarizing. */
+export declare function hasSummarizableContent(slice: ChatEntry[]): boolean;
+/** Render a turn slice into the model prompt (pure — no I/O). */
+export declare function renderSummaryPrompt(slice: ChatEntry[]): string;
+/**
+ * Produce a markdown bullet summary for one turn. Returns null on an empty
+ * slice, an empty result, or any error, so callers leave the turn un-condensed
+ * (shown in full) rather than blocking.
+ */
+export declare function generateTurnSummary(slice: ChatEntry[], sdkEnv?: Record<string, string | undefined>): Promise<string | null>;

package/dist/src/turn-summarizer.js

@@ -0,0 +1,168 @@
+/**
+ * Turn summarizer — condenses one agent turn (everything since the last user
+ * prompt) into a few markdown bullet points via a single cheap LLM call.
+ *
+ * Powers the condensed chat view: when the agent stops (done / awaiting a
+ * permission / asking a question), the workspace manager builds the turn slice
+ * and calls {@link generateTurnSummary}, persists the result as a `summary`
+ * ChatEntry, and broadcasts `event.turn_summary`. Clients in condensed view
+ * collapse the turn to these bullets with a button to expand back to full detail.
+ *
+ * Mirrors `titler.ts`: same vendored Claude Agent SDK, same cheap pinned model,
+ * tools disabled (a pure completion), best-effort with a null fallback so a slow
+ * or failing model call never wedges a turn. The pure helpers
+ * (`buildTurnSlice` / `renderSummaryPrompt` / `hasSummarizableContent`) are
+ * separated out so they are unit-testable without the LLM.
+ */
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { logger } from "./log.js";
+/** Cheapest current model — a handful of bullets needs nothing larger. */
+export const SUMMARY_MODEL = "claude-haiku-4-5";
+const INSTRUCTION = "You are summarizing one turn of an AI coding agent's work for a compact " +
+    "mobile chat view. Given the turn transcript below, write 2-5 short markdown " +
+    'bullet points (each line starting with "- ") describing what the agent ' +
+    "actually did this turn: concrete actions, files changed, commands run, " +
+    "decisions made, and — if it stopped — what it is now waiting on (a " +
+    "permission or a question). Be terse and specific. Output ONLY the bullet " +
+    "list: no preamble, no headings, no closing remarks.\n\nTurn transcript:\n\n";
+/** Per-entry and whole-prompt caps — a longer paste doesn't make better bullets. */
+const MAX_ENTRY_CHARS = 600;
+const MAX_PROMPT_CHARS = 8000;
+/** The `seq` of the most recent `user` prompt (the start of the latest turn). */
+export function lastUserSeq(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const e = entries[i];
+        if (e.role === "user" && typeof e.seq === "number")
+            return e.seq;
+    }
+    return null;
+}
+/**
+ * The entries that make up one turn: everything AFTER the `user` prompt with
+ * `seq === turnStartSeq`, up to (but not including) the next `user` prompt.
+ * Prior summaries and hidden rename records are dropped. Empty if the start
+ * prompt isn't found.
+ */
+export function buildTurnSlice(entries, turnStartSeq) {
+    const start = entries.findIndex((e) => e.role === "user" && e.seq === turnStartSeq);
+    if (start < 0)
+        return [];
+    const slice = [];
+    for (let i = start + 1; i < entries.length; i++) {
+        const e = entries[i];
+        if (e.role === "user")
+            break; // next turn begins
+        if (e.role === "summary" || e.role === "rename")
+            continue; // not agent output
+        slice.push(e);
+    }
+    return slice;
+}
+/** Highest `seq` present in a slice (−1 if none) — the turn's content watermark. */
+export function sliceContentSeq(slice) {
+    let max = -1;
+    for (const e of slice) {
+        if (typeof e.seq === "number" && e.seq > max)
+            max = e.seq;
+    }
+    return max;
+}
+/** True when a slice has any agent output worth summarizing. */
+export function hasSummarizableContent(slice) {
+    return slice.some((e) => e.role === "assistant" ||
+        e.role === "tool" ||
+        e.role === "assistant_image" ||
+        e.role === "permission" ||
+        e.role === "question");
+}
+function truncate(s, n) {
+    const t = s.trim();
+    return t.length > n ? `${t.slice(0, n)}…` : t;
+}
+/** Render a turn slice into the model prompt (pure — no I/O). */
+export function renderSummaryPrompt(slice) {
+    const lines = [];
+    for (const e of slice) {
+        switch (e.role) {
+            case "assistant":
+                lines.push(`Assistant: ${truncate(e.text, MAX_ENTRY_CHARS)}`);
+                break;
+            case "tool":
+                lines.push(`Tool: ${truncate(e.text, MAX_ENTRY_CHARS)}`);
+                break;
+            case "assistant_image":
+                lines.push("Assistant: [produced an image]");
+                break;
+            case "permission":
+                lines.push(`Permission ${e.resolved ? `(${e.resolved})` : "(pending)"}: ${truncate(e.text, MAX_ENTRY_CHARS)}`);
+                break;
+            case "question":
+                lines.push(`Question ${e.answers || e.response ? "(answered)" : "(pending)"}: ${truncate(e.text, MAX_ENTRY_CHARS)}`);
+                break;
+            case "limit":
+                lines.push("Notice: usage limit reached");
+                break;
+            case "system":
+                lines.push(`System: ${truncate(e.text, MAX_ENTRY_CHARS)}`);
+                break;
+            default:
+                break; // rename/summary/user never appear in a slice
+        }
+    }
+    let body = lines.join("\n");
+    if (body.length > MAX_PROMPT_CHARS)
+        body = `${body.slice(0, MAX_PROMPT_CHARS)}\n…`;
+    return INSTRUCTION + body;
+}
+/** Trim and strip a wrapping code fence the model may have added. */
+function clean(raw) {
+    return raw
+        .trim()
+        .replace(/^```[a-zA-Z]*\n?/, "")
+        .replace(/\n?```$/, "")
+        .trim();
+}
+/**
+ * Produce a markdown bullet summary for one turn. Returns null on an empty
+ * slice, an empty result, or any error, so callers leave the turn un-condensed
+ * (shown in full) rather than blocking.
+ */
+export async function generateTurnSummary(slice, sdkEnv) {
+    if (!hasSummarizableContent(slice))
+        return null;
+    try {
+        const response = query({
+            prompt: renderSummaryPrompt(slice),
+            options: {
+                model: SUMMARY_MODEL,
+                // No worktree work, no tools — this is a pure completion.
+                allowedTools: [],
+                maxTurns: 1,
+                ...(sdkEnv ? { env: { ...process.env, ...sdkEnv } } : {}),
+            },
+        });
+        let text = "";
+        for await (const msg of response) {
+            const m = msg;
+            if (m.type === "assistant") {
+                const content = m.message?.content;
+                if (Array.isArray(content)) {
+                    for (const b of content) {
+                        if (b && typeof b === "object" && b.type === "text") {
+                            text += b.text ?? "";
+                        }
+                    }
+                }
+            }
+        }
+        const out = clean(text);
+        return out || null;
+    }
+    catch (err) {
+        logger.warn("model", "turn summary generation failed", {
+            data: { message: err instanceof Error ? err.message : String(err) },
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=turn-summarizer.js.map

package/dist/src/turn-summarizer.js.map

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

package/dist/src/workspace.d.ts

@@ -61,6 +61,17 @@ export declare class WorkspaceManager {
      * `broadcastWorkspaceList` can no-op when a recompute yields identical rows.
      */
     private lastListJson;
+    /**
+     * Per-workspace debounce timer coalescing a stop's burst of events into one
+     * turn-summary generation (see TURN_SUMMARY_DEBOUNCE_MS).
+     */
+    private summaryTimers;
+    /**
+     * Guard against re-summarizing a turn whose content hasn't changed. Keyed by
+     * `${ws}:${turnStartSeq}` → the highest slice `seq` already summarized, so a
+     * later stop with no new entries (or the debounce firing twice) is a no-op.
+     */
+    private summarizedUpTo;
     constructor(hub: Hub, 
     /** Durable per-workspace transcript, so history survives phone reboots. */
     chatlog?: ChatLog, 
@@ -397,6 +408,40 @@ export declare class WorkspaceManager {
     mediaStore(): MediaStore;
     /** Ids of all currently-live workspaces (for the media orphan sweep). */
     liveWorkspaceIds(): Set<string>;
+    /**
+     * A streamed work event (assistant text, a tool call, or an image) means the
+     * agent is actively coding *right now*. Backends emit their own `running` only
+     * once at spawn and a `done` at end-of-turn, so a work chunk that arrives after
+     * a premature or out-of-order `done` would otherwise leave the list/project
+     * badge stuck at `done` while the turn is still going — the exact symptom where
+     * the working indicator reads "done" mid-work. The client chat spinner already
+     * re-arms on these events (its `busySince` timer); this mirrors that on the
+     * wire status every list view binds to, so all clients stay accurate from one
+     * fix. Only lift the "not working" states (`done`/`idle`); never clobber an
+     * open permission gate or a surfaced error (a real work event never precedes
+     * those, and stomping them would hide an actionable card).
+     */
+    private markWorking;
     private setStatus;
+    /**
+     * Debounced turn-summary trigger. A single stop can emit several events (a
+     * question fires both `ask_question` and `status: awaiting_permission`); this
+     * collapses them into one generation and lets same-tick chatlog appends land
+     * before we read the transcript.
+     */
+    private scheduleTurnSummary;
+    /**
+     * Generate + persist + broadcast the summary for a turn. Defaults to the latest
+     * turn (the one that just stopped); `turnStartSeq` targets a specific turn for
+     * on-demand backfill. `force` bypasses the "no new content" guard (used by the
+     * explicit backfill path). Best-effort: a null/failed generation is a no-op and
+     * leaves the turn shown in full.
+     */
+    private runTurnSummary;
+    /**
+     * On-demand backfill for a specific turn (client `turn.summarize`). Re-broadcasts
+     * a cached summary if one exists; otherwise generates one. Idempotent.
+     */
+    requestTurnSummary(id: string, turnStartSeq: number): Promise<void>;
     shutdown(): Promise<void>;
 }

package/dist/src/workspace.js

@@ -32,6 +32,7 @@ import { maybeSyncRepo } from "./repo-sync.js";
 import { listPullRequests, prHeadRef, listIssues, createIssue } from "./github.js";
 import { composeActionPrompt } from "./actions.js";
 import { generateChatTitle } from "./titler.js";
+import { buildTurnSlice, generateTurnSummary, hasSummarizableContent, lastUserSeq, sliceContentSeq, } from "./turn-summarizer.js";
 const STATE_FILE = process.env.STATE_FILE ?? join(homedir(), ".immediacy", "state.json");
 /** Root for repo-less chat workspaces' scratch dirs (one per chat). */
 const CHATS_DIR = process.env.CHATS_DIR ?? join(homedir(), ".immediacy", "chats");
@@ -74,6 +75,17 @@ function modelSwitchNotice(prevModel, nextModel, nextEffort) {
  * this only bites on a hang.
  */
 const NAME_FROM_PROMPT_TIMEOUT_MS = 6000;
+/**
+ * Coalesce the burst of stop-like events a single stop produces (e.g. a question
+ * emits both `ask_question` and a `status: awaiting_permission`) into one turn
+ * summary, and let same-tick chatlog appends land first. Short — this only debounces.
+ */
+const TURN_SUMMARY_DEBOUNCE_MS = 250;
+/**
+ * Hard deadline for the turn-summary model call. Fire-and-forget (it never blocks
+ * the turn), but bounded so a hung API can't leave a generation dangling.
+ */
+const TURN_SUMMARY_TIMEOUT_MS = 20000;
 export class WorkspaceManager {
     hub;
     chatlog;
@@ -90,6 +102,17 @@ export class WorkspaceManager {
      * `broadcastWorkspaceList` can no-op when a recompute yields identical rows.
      */
     lastListJson = "";
+    /**
+     * Per-workspace debounce timer coalescing a stop's burst of events into one
+     * turn-summary generation (see TURN_SUMMARY_DEBOUNCE_MS).
+     */
+    summaryTimers = new Map();
+    /**
+     * Guard against re-summarizing a turn whose content hasn't changed. Keyed by
+     * `${ws}:${turnStartSeq}` → the highest slice `seq` already summarized, so a
+     * later stop with no new entries (or the debounce firing twice) is a no-op.
+     */
+    summarizedUpTo = new Map();
     constructor(hub, 
     /** Durable per-workspace transcript, so history survives phone reboots. */
     chatlog = new ChatLog(), 
@@ -1235,14 +1258,17 @@ export class WorkspaceManager {
         const id = live.record.id;
         switch (e.kind) {
             case "assistant":
+                this.markWorking(live);
                 this.hub.broadcast("event.assistant_message", id, { ws: id, text: e.text });
                 void this.chatlog.append(id, { ts: Date.now(), role: "assistant", text: e.text });
                 break;
             case "image":
                 // Tool-result / assistant-content image — persist + broadcast metadata.
+                this.markWorking(live);
                 void this.surfaceImage(live, e);
                 break;
             case "tool_use":
+                this.markWorking(live);
                 this.hub.broadcast("event.tool_use", id, {
                     ws: id,
                     tool: e.tool,
@@ -1301,6 +1327,8 @@ export class WorkspaceManager {
                     requestId: e.requestId,
                     questions: e.questions,
                 });
+                // The agent stopped to ask a question — a turn stop; summarize it.
+                this.scheduleTurnSummary(live);
                 break;
             case "session":
                 // Attribute the id to the backend that minted it, so a later switch back
@@ -1317,6 +1345,10 @@ export class WorkspaceManager {
                 break;
             case "status":
                 this.setStatus(live, e.status);
+                // The agent paused for a permission — a turn stop. Summarize it for the
+                // condensed view (debounced; the paired `permission` event lands too).
+                if (e.status === "awaiting_permission")
+                    this.scheduleTurnSummary(live);
                 break;
             case "done": {
                 // Surface any screenshots the agent wrote to disk this turn (the
@@ -1356,6 +1388,8 @@ export class WorkspaceManager {
                     ws: id,
                     context: e.summary ? { summary: e.summary } : undefined,
                 });
+                // The turn is done — condense it for the condensed chat view.
+                this.scheduleTurnSummary(live);
                 break;
             }
             case "limit":
@@ -1502,6 +1536,24 @@ export class WorkspaceManager {
     liveWorkspaceIds() {
         return new Set(this.workspaces.keys());
     }
+    /**
+     * A streamed work event (assistant text, a tool call, or an image) means the
+     * agent is actively coding *right now*. Backends emit their own `running` only
+     * once at spawn and a `done` at end-of-turn, so a work chunk that arrives after
+     * a premature or out-of-order `done` would otherwise leave the list/project
+     * badge stuck at `done` while the turn is still going — the exact symptom where
+     * the working indicator reads "done" mid-work. The client chat spinner already
+     * re-arms on these events (its `busySince` timer); this mirrors that on the
+     * wire status every list view binds to, so all clients stay accurate from one
+     * fix. Only lift the "not working" states (`done`/`idle`); never clobber an
+     * open permission gate or a surfaced error (a real work event never precedes
+     * those, and stomping them would hide an actionable card).
+     */
+    markWorking(live) {
+        const s = live.record.status;
+        if (s === "done" || s === "idle")
+            this.setStatus(live, "running");
+    }
     setStatus(live, status) {
         live.record.status = status;
         const id = live.record.id;
@@ -1512,6 +1564,95 @@ export class WorkspaceManager {
             status,
         });
     }
+    /**
+     * Debounced turn-summary trigger. A single stop can emit several events (a
+     * question fires both `ask_question` and `status: awaiting_permission`); this
+     * collapses them into one generation and lets same-tick chatlog appends land
+     * before we read the transcript.
+     */
+    scheduleTurnSummary(live) {
+        const id = live.record.id;
+        const existing = this.summaryTimers.get(id);
+        if (existing)
+            clearTimeout(existing);
+        const t = setTimeout(() => {
+            this.summaryTimers.delete(id);
+            void this.runTurnSummary(id);
+        }, TURN_SUMMARY_DEBOUNCE_MS);
+        // Don't keep the event loop alive just for a best-effort summary.
+        t.unref?.();
+        this.summaryTimers.set(id, t);
+    }
+    /**
+     * Generate + persist + broadcast the summary for a turn. Defaults to the latest
+     * turn (the one that just stopped); `turnStartSeq` targets a specific turn for
+     * on-demand backfill. `force` bypasses the "no new content" guard (used by the
+     * explicit backfill path). Best-effort: a null/failed generation is a no-op and
+     * leaves the turn shown in full.
+     */
+    async runTurnSummary(id, opts = {}) {
+        const entries = this.chatlog.entries(id);
+        const turnStartSeq = opts.turnStartSeq ?? lastUserSeq(entries);
+        if (turnStartSeq === null || turnStartSeq === undefined)
+            return;
+        const slice = buildTurnSlice(entries, turnStartSeq);
+        if (!hasSummarizableContent(slice))
+            return;
+        const key = `${id}:${turnStartSeq}`;
+        const contentSeq = sliceContentSeq(slice);
+        // Skip if this turn was already summarized at the same content watermark
+        // (the debounce firing twice, or a later stop that added nothing new).
+        if (!opts.force && this.summarizedUpTo.get(key) === contentSeq)
+            return;
+        // Claim the watermark before the await so a concurrent trigger doesn't
+        // double-generate; release it on failure so a retry can happen later.
+        const prevWatermark = this.summarizedUpTo.get(key);
+        this.summarizedUpTo.set(key, contentSeq);
+        const sdkEnv = claudeSdkEnv(this.appConfig.get(), this.credentials.getKey("anthropic"));
+        const timeout = new Promise((resolve) => {
+            const t = setTimeout(() => resolve(null), TURN_SUMMARY_TIMEOUT_MS);
+            t.unref?.();
+        });
+        const text = await Promise.race([generateTurnSummary(slice, sdkEnv), timeout]);
+        if (!text) {
+            // Generation failed/timed out — un-claim so a future stop retries.
+            if (this.summarizedUpTo.get(key) === contentSeq) {
+                if (prevWatermark === undefined)
+                    this.summarizedUpTo.delete(key);
+                else
+                    this.summarizedUpTo.set(key, prevWatermark);
+            }
+            return;
+        }
+        // Append first so the entry gets its `seq`, then broadcast with it.
+        const entry = { ts: Date.now(), role: "summary", text, turnStartSeq };
+        await this.chatlog.append(id, entry);
+        this.hub.broadcast("event.turn_summary", id, {
+            ws: id,
+            turnStartSeq,
+            text,
+            seq: entry.seq,
+        });
+    }
+    /**
+     * On-demand backfill for a specific turn (client `turn.summarize`). Re-broadcasts
+     * a cached summary if one exists; otherwise generates one. Idempotent.
+     */
+    async requestTurnSummary(id, turnStartSeq) {
+        const existing = this.chatlog
+            .entries(id)
+            .find((e) => e.role === "summary" && e.turnStartSeq === turnStartSeq);
+        if (existing) {
+            this.hub.broadcast("event.turn_summary", id, {
+                ws: id,
+                turnStartSeq,
+                text: existing.text,
+                seq: existing.seq,
+            });
+            return;
+        }
+        await this.runTurnSummary(id, { turnStartSeq, force: true });
+    }
     async shutdown() {
         for (const live of this.workspaces.values()) {
             await live.agent?.stop();