zcode-acp-server 0.2.0 → 0.3.0

package/dist/handlers/replay.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Tail replay kernel — slicing, cursor pagination, and the `session/load`
+ * replay/`session/load_earlier` handlers (Proposal 0001 / ADR-0003).
+ *
+ * session/load replays history as session/update notifications; for long
+ * sessions that cost is O(full history) on every attach and reconnect. The
+ * helpers here slice the fetched messages into turn-aligned batches and page
+ * backwards with an opaque cursor. Batches are sent under the per-session
+ * replay lock (`withReplayBatch` in io.ts) so a batch never interleaves with
+ * live-turn updates for the same session; `replayMessages` is the one sender
+ * that bypasses the per-message lock — it only runs inside a batch.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeMessage } from "../backend/types.js";
+import type { ZcodeAcpServer } from "../server.js";
+/** Upper bound for a requested tail/page size (values above clamp to this). */
+export declare const MAX_REPLAY_LIMIT = 500;
+/** Page size for `session/load_earlier` when the request omits `limit`. */
+export declare const DEFAULT_EARLIER_LIMIT = 50;
+/** Wire metadata describing one delivered batch (additive-only over time). */
+export interface ReplayMeta {
+    cursor: string;
+    hasMore: boolean;
+    replayedMessages: number;
+    replayedTurns: number;
+    totalMessages: number;
+    totalTurns: number;
+}
+export interface ReplaySlice {
+    batch: ZcodeMessage[];
+    meta: ReplayMeta;
+}
+/** `session/load_earlier` params (top-level — our parser, not an ACP spec method). */
+export interface LoadEarlierParams {
+    sessionId: string;
+    before?: string;
+    limit?: number;
+}
+/**
+ * Slice the last `limit` messages, aligned back to the start of the turn
+ * containing the oldest one — never a mid-turn cut. `limit: 0` attaches with
+ * metadata only (cursor anchors at the end of history).
+ */
+export declare function sliceTail(messages: ZcodeMessage[], limit: number): ReplaySlice;
+/** Full-history slice (no `_meta.zcode.limit` on session/load). */
+export declare function fullSlice(messages: ZcodeMessage[]): ReplaySlice;
+/**
+ * Slice up to `limit` messages strictly older than the `before` cursor.
+ * The cursor points into a prefix of history, so turns appended after it was
+ * minted keep it valid; only a history that shrank (compaction/truncation)
+ * throws `cursor expired` — clients map that to a full re-`session/load`.
+ */
+export declare function sliceBefore(messages: ZcodeMessage[], before: string, limit: number): ReplaySlice;
+/**
+ * Read the tail limit from `session/load`'s `_meta.zcode.limit`. The SDK's
+ * zod params schema strips unknown top-level keys, so bridge extensions ride
+ * in `_meta` (ADR-0003). Returns null when absent/non-finite = full replay.
+ */
+export declare function readTailLimit(params: acp.LoadSessionRequest): number | null;
+/** Fetch session/messages from zcode (the bridge's only history source). */
+export declare function fetchMessages(server: ZcodeAcpServer, zcodeSid: string): Promise<ZcodeMessage[]>;
+/**
+ * Replay messages as session/update notifications, oldest → newest.
+ *
+ * MUST run inside `withReplayBatch` for the session: this is the one sender
+ * that bypasses the per-message lock in sendSessionUpdate (the batch already
+ * holds it), which is what makes the batch atomic against live dispatch.
+ */
+export declare function replayMessages(cx: acp.AgentContext, acpSid: string, messages: ZcodeMessage[]): Promise<number>;
+/**
+ * `session/load_earlier` — deliver one page of history strictly older than
+ * the `before` cursor, oldest → newest (clients prepend). Requires the
+ * session to already be attached in this bridge; pagination never triggers
+ * an implicit backend resume.
+ */
+export declare function loadEarlier(server: ZcodeAcpServer, params: LoadEarlierParams, cx: acp.AgentContext): Promise<{
+    replayMeta: ReplayMeta;
+}>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/handlers/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/handlers/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqFD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAW9E;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAchG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAK3E;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAWzB;AAYD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,GAAG,CAAC,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CA+DjB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,iBAAiB,EACzB,EAAE,EAAE,GAAG,CAAC,YAAY,GACnB,OAAO,CAAC;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC,CAarC"}

package/dist/handlers/replay.js

@@ -0,0 +1,252 @@
+/**
+ * Tail replay kernel — slicing, cursor pagination, and the `session/load`
+ * replay/`session/load_earlier` handlers (Proposal 0001 / ADR-0003).
+ *
+ * session/load replays history as session/update notifications; for long
+ * sessions that cost is O(full history) on every attach and reconnect. The
+ * helpers here slice the fetched messages into turn-aligned batches and page
+ * backwards with an opaque cursor. Batches are sent under the per-session
+ * replay lock (`withReplayBatch` in io.ts) so a batch never interleaves with
+ * live-turn updates for the same session; `replayMessages` is the one sender
+ * that bypasses the per-message lock — it only runs inside a batch.
+ */
+import { randomUUID } from "node:crypto";
+import { log } from "../utils.js";
+import { throwError, withReplayBatch } from "./io.js";
+/** Upper bound for a requested tail/page size (values above clamp to this). */
+export const MAX_REPLAY_LIMIT = 500;
+/** Page size for `session/load_earlier` when the request omits `limit`. */
+export const DEFAULT_EARLIER_LIMIT = 50;
+/**
+ * Indices where a turn starts: every user message, plus 0 so leading
+ * non-user messages (system preambles) belong to the first turn.
+ */
+function turnStarts(messages) {
+    const starts = messages.length > 0 ? [0] : [];
+    messages.forEach((m, i) => {
+        if (m.info?.role === "user" && i > 0)
+            starts.push(i);
+    });
+    return starts;
+}
+/** Count of turn starts inside [start, end). */
+function turnsInRange(starts, start, end) {
+    return starts.filter((s) => s >= start && s < end).length;
+}
+function encodeCursor(messages, index, totalTurns) {
+    const anchor = messages[index]?.info?.id;
+    const payload = { v: 1, index, totalTurns };
+    if (anchor)
+        payload.id = anchor;
+    return Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
+}
+function decodeCursor(before) {
+    try {
+        const raw = JSON.parse(Buffer.from(before, "base64url").toString("utf8"));
+        if (raw?.v !== 1 ||
+            !Number.isInteger(raw.index) ||
+            raw.index < 0 ||
+            !Number.isInteger(raw.totalTurns)) {
+            throw new Error("bad shape");
+        }
+        return raw;
+    }
+    catch {
+        // Garbage or foreign cursors are indistinguishable from expired ones.
+        return throwError(-32602, "cursor expired");
+    }
+}
+function buildSlice(messages, starts, start, end) {
+    const totalTurns = starts.length;
+    return {
+        batch: messages.slice(start, end),
+        meta: {
+            cursor: encodeCursor(messages, start, totalTurns),
+            hasMore: start > 0,
+            replayedMessages: end - start,
+            replayedTurns: turnsInRange(starts, start, end),
+            totalMessages: messages.length,
+            totalTurns,
+        },
+    };
+}
+/** The greatest turn start at or before `pos` (0 when none — starts include 0). */
+function alignToTurnStart(starts, pos) {
+    let aligned = 0;
+    for (const s of starts) {
+        if (s <= pos)
+            aligned = s;
+        else
+            break;
+    }
+    return aligned;
+}
+function clampLimit(limit) {
+    return Math.max(0, Math.min(Math.floor(limit), MAX_REPLAY_LIMIT));
+}
+/**
+ * Slice the last `limit` messages, aligned back to the start of the turn
+ * containing the oldest one — never a mid-turn cut. `limit: 0` attaches with
+ * metadata only (cursor anchors at the end of history).
+ */
+export function sliceTail(messages, limit) {
+    const starts = turnStarts(messages);
+    const clamped = clampLimit(limit);
+    if (clamped === 0) {
+        // Metadata-only attach: an empty batch whose cursor anchors at the end of
+        // history, so load_earlier pages the whole tail.
+        return buildSlice(messages, starts, messages.length, messages.length);
+    }
+    if (clamped >= messages.length)
+        return buildSlice(messages, starts, 0, messages.length);
+    const start = alignToTurnStart(starts, messages.length - clamped);
+    return buildSlice(messages, starts, start, messages.length);
+}
+/** Full-history slice (no `_meta.zcode.limit` on session/load). */
+export function fullSlice(messages) {
+    return buildSlice(messages, turnStarts(messages), 0, messages.length);
+}
+/**
+ * Slice up to `limit` messages strictly older than the `before` cursor.
+ * The cursor points into a prefix of history, so turns appended after it was
+ * minted keep it valid; only a history that shrank (compaction/truncation)
+ * throws `cursor expired` — clients map that to a full re-`session/load`.
+ */
+export function sliceBefore(messages, before, limit) {
+    const starts = turnStarts(messages);
+    const cur = decodeCursor(before);
+    if (cur.index > messages.length || cur.totalTurns > starts.length) {
+        return throwError(-32602, "cursor expired");
+    }
+    if (cur.id != null && cur.index < messages.length && messages[cur.index].info?.id !== cur.id) {
+        return throwError(-32602, "cursor expired");
+    }
+    const end = cur.index;
+    if (end === 0)
+        return buildSlice(messages, starts, 0, 0);
+    const clamped = clampLimit(limit);
+    const start = clamped === 0 ? end : alignToTurnStart(starts, Math.max(0, end - clamped));
+    return buildSlice(messages, starts, start, end);
+}
+/**
+ * Read the tail limit from `session/load`'s `_meta.zcode.limit`. The SDK's
+ * zod params schema strips unknown top-level keys, so bridge extensions ride
+ * in `_meta` (ADR-0003). Returns null when absent/non-finite = full replay.
+ */
+export function readTailLimit(params) {
+    const zcode = params._meta?.zcode;
+    const raw = zcode?.limit;
+    if (typeof raw !== "number" || !Number.isFinite(raw))
+        return null;
+    return clampLimit(raw);
+}
+/** Fetch session/messages from zcode (the bridge's only history source). */
+export async function fetchMessages(server, zcodeSid) {
+    const backend = server.ensureBackend();
+    const resp = await backend.request(server.nextId(), "session/messages", { sessionId: zcodeSid }, 8000);
+    if (resp.error)
+        return [];
+    const result = (resp.result ?? {});
+    return result.messages ?? [];
+}
+/**
+ * Strip harness-injected reminder blocks from user text. The agent runtime
+ * appends `<system-reminder>…</system-reminder>` blocks (TodoWrite nudges,
+ * context handoffs) to user turns as context plumbing — they are not user
+ * speech, and replaying them verbatim makes clients render them as user input.
+ */
+function stripSystemReminders(text) {
+    return text.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, "").trim();
+}
+/**
+ * Replay messages as session/update notifications, oldest → newest.
+ *
+ * MUST run inside `withReplayBatch` for the session: this is the one sender
+ * that bypasses the per-message lock in sendSessionUpdate (the batch already
+ * holds it), which is what makes the batch atomic against live dispatch.
+ */
+export async function replayMessages(cx, acpSid, messages) {
+    let replayed = 0;
+    for (const m of messages) {
+        const info = m.info ?? {};
+        const role = info.role;
+        const mid = info.id ?? `hist_${randomUUID().slice(0, 12)}`;
+        for (const p of m.parts ?? []) {
+            if (!p || typeof p !== "object")
+                continue;
+            const ptype = p.type;
+            if (ptype === "text") {
+                let text = p.text ?? "";
+                if (!text)
+                    continue;
+                if (role === "user") {
+                    text = stripSystemReminders(text);
+                    if (!text)
+                        continue;
+                }
+                await cx.notify("session/update", {
+                    sessionId: acpSid,
+                    update: {
+                        sessionUpdate: role === "user" ? "user_message_chunk" : "agent_message_chunk",
+                        content: { type: "text", text },
+                        messageId: mid,
+                    },
+                });
+            }
+            else if (ptype === "reasoning") {
+                const rp = p;
+                const text = rp.text ?? rp.content ?? "";
+                if (text) {
+                    await cx.notify("session/update", {
+                        sessionId: acpSid,
+                        update: {
+                            sessionUpdate: "agent_thought_chunk",
+                            content: { type: "text", text },
+                            messageId: `thought_${mid}`,
+                        },
+                    });
+                }
+            }
+            else if (ptype === "tool") {
+                const tp = p;
+                const title = tp.title ?? tp.tool ?? "tool call";
+                const histToolName = tp.tool ?? "";
+                await cx.notify("session/update", {
+                    sessionId: acpSid,
+                    update: {
+                        sessionUpdate: "tool_call",
+                        toolCallId: tp.id ?? `histtool_${randomUUID().slice(0, 8)}`,
+                        title,
+                        kind: "other",
+                        status: tp.status ?? "completed",
+                        ...(histToolName ? { _meta: { claudeCode: { toolName: histToolName } } } : {}),
+                    },
+                });
+            }
+            // patch / step-start / other: skipped (history replay focuses on text + tool summary)
+        }
+        replayed += 1;
+    }
+    return replayed;
+}
+/**
+ * `session/load_earlier` — deliver one page of history strictly older than
+ * the `before` cursor, oldest → newest (clients prepend). Requires the
+ * session to already be attached in this bridge; pagination never triggers
+ * an implicit backend resume.
+ */
+export async function loadEarlier(server, params, cx) {
+    const acpSid = params.sessionId;
+    const zcodeSid = server.resolveSid(acpSid);
+    if (!zcodeSid) {
+        return throwError(-32602, "session not registered — attach via session/load first");
+    }
+    if (!params.before)
+        return throwError(-32602, "before (cursor) required");
+    const messages = await fetchMessages(server, zcodeSid);
+    const slice = sliceBefore(messages, params.before, params.limit ?? DEFAULT_EARLIER_LIMIT);
+    await withReplayBatch(acpSid, () => replayMessages(cx, acpSid, slice.batch));
+    log(`session/load_earlier: ${slice.meta.replayedMessages} messages before cursor`);
+    return { replayMeta: slice.meta };
+}
+//# sourceMappingURL=replay.js.map

package/dist/handlers/replay.js.map

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

package/dist/handlers/session.d.ts.map

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

package/dist/handlers/session.js

@@ -22,7 +22,8 @@ import { lookupLazySession, recordMaterializedSession, rememberLazySession, } fr
 import { buildDiffContent, EventTranslator, extractLocations, formatTurnError, isTransientTurnError, ProjectionDiffer, } from "../translators/index.js";
 import { log, warn } from "../utils.js";
 import { dispatchEvent } from "./dispatch.js";
-import { sendSessionUpdate, sendTextChunk } from "./io.js";
+import { sendSessionUpdate, sendTextChunk, withReplayBatch } from "./io.js";
+import { fetchMessages, fullSlice, readTailLimit, replayMessages, sliceTail } from "./replay.js";
 import { handleServerRequests } from "./server-requests.js";
 /** Workspace descriptor used in session create/resume calls. */
 function workspaceFor(cwd) {
@@ -70,6 +71,9 @@ export async function newSession(server, params) {
     // backend session materializes; never shown in session/list.
     const acpSid = randomUUID();
     server.pendingSessions.set(acpSid, { cwd, mcpServers: params.mcpServers });
+    // Persists past materialization (pendingSessions is cleared on first use) so
+    // the remote discovery payload can still label the workspace.
+    server.sessionCwds.set(acpSid, cwd);
     // Durable alias so the placeholder survives a bridge restart and session/
     // resume can still resolve it (best-effort; failures are swallowed inside
     // the store).
@@ -113,6 +117,7 @@ export async function ensureRealSession(server, acpSid) {
         if (record) {
             pending = { cwd: record.cwd };
             server.pendingSessions.set(acpSid, pending);
+            server.sessionCwds.set(acpSid, record.cwd);
         }
     }
     if (!pending)
@@ -201,6 +206,36 @@ export async function listSessions(server, params) {
     log(`session/list → ${sessions.length} sessions`);
     return { sessions };
 }
+/**
+ * Adopt the backend's stored title for a loaded/resumed session.
+ *
+ * The prompt loop's auto-title only fires for freshly created sessions
+ * (`titleEligibleSessions`), so a session resumed across a bridge restart
+ * would otherwise appear title-less in the hub's discovery API — remote
+ * clients have no editor-side session storage to fall back on. The backend's
+ * session/list is the only title source for sessions born in a previous
+ * bridge lifetime. Best-effort: failures log and leave the session untitled.
+ */
+async function adoptStoredTitle(server, acpSid, zcodeSid) {
+    if (server.sessionTitles.has(acpSid))
+        return;
+    try {
+        const backend = server.ensureBackend();
+        const resp = await backend.request(server.nextId(), "session/list", {}, 15000);
+        if (resp.error)
+            return;
+        const result = (resp.result ?? {});
+        const hit = (result.sessions ?? []).find((s) => s.sessionId === zcodeSid);
+        if (hit?.title) {
+            server.sessionTitles.set(acpSid, hit.title);
+            server.touchSessionSummary(acpSid, hit.title);
+            log(`adopted stored title for ${acpSid.slice(0, 8)}: ${hit.title}`);
+        }
+    }
+    catch (e) {
+        log(`stored title lookup failed (non-fatal): ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
 /**
  * Resolve the backend session id for `session/resume` / `session/load`.
  *
@@ -273,6 +308,7 @@ export async function resumeSession(server, params, cx) {
     server.registerSession(acpSid, zcodeSid);
     log(`session/resume -> ${zcodeSid}`);
     server.ensureBackgroundListener(zcodeSid);
+    await adoptStoredTitle(server, acpSid, zcodeSid);
     // Initial usage_update so the editor shows the context bar immediately for a
     // resumed session (mirrors Python _on_session_resume → _emit_initial_usage).
     await emitInitialUsage(server, cx, acpSid, zcodeSid, getOrCreateDiffer(server, zcodeSid));
@@ -312,57 +348,16 @@ export async function loadSession(server, params, cx) {
     server.registerSession(acpSid, zcodeSid);
     log(`session/load → ${zcodeSid}`);
     server.ensureBackgroundListener(zcodeSid);
+    await adoptStoredTitle(server, acpSid, zcodeSid);
     const messages = await fetchMessages(server, zcodeSid);
-    let replayed = 0;
-    for (const m of messages) {
-        const info = m.info ?? {};
-        const role = info.role;
-        const mid = info.id ?? `hist_${randomUUID().slice(0, 12)}`;
-        for (const p of m.parts ?? []) {
-            if (!p || typeof p !== "object")
-                continue;
-            const ptype = p.type;
-            if (ptype === "text") {
-                const text = p.text ?? "";
-                if (!text)
-                    continue;
-                const sessionUpdate = role === "user" ? "user_message_chunk" : "agent_message_chunk";
-                await sendSessionUpdate(cx, acpSid, {
-                    sessionUpdate,
-                    content: { type: "text", text },
-                    messageId: mid,
-                });
-            }
-            else if (ptype === "reasoning") {
-                const rp = p;
-                const text = rp.text ?? rp.content ?? "";
-                if (text) {
-                    await sendSessionUpdate(cx, acpSid, {
-                        sessionUpdate: "agent_thought_chunk",
-                        content: { type: "text", text },
-                        messageId: `thought_${mid}`,
-                    });
-                }
-            }
-            else if (ptype === "tool") {
-                const tp = p;
-                const title = tp.title ?? tp.tool ?? "tool call";
-                const histToolName = tp.tool ?? "";
-                const update = {
-                    sessionUpdate: "tool_call",
-                    toolCallId: tp.id ?? `histtool_${randomUUID().slice(0, 8)}`,
-                    title,
-                    kind: "other",
-                    status: tp.status ?? "completed",
-                    ...(histToolName ? { _meta: { claudeCode: { toolName: histToolName } } } : {}),
-                };
-                await sendSessionUpdate(cx, acpSid, update);
-            }
-            // patch / step-start / other: skipped (history replay focuses on text + tool summary)
-        }
-        replayed += 1;
-    }
-    log(`session/load: replayed ${replayed} messages`);
+    // Tail replay (Proposal 0001): a `_meta.zcode.limit` replays only the last
+    // N messages aligned to turn boundaries — the full replay stays the default
+    // for editors that send no `_meta` (Zed path unchanged).
+    const limit = readTailLimit(params);
+    const slice = limit === null ? fullSlice(messages) : sliceTail(messages, limit);
+    await withReplayBatch(acpSid, () => replayMessages(cx, acpSid, slice.batch));
+    log(`session/load: replayed ${slice.meta.replayedMessages} messages` +
+        `${limit === null ? "" : ` (tail limit ${limit}, total ${slice.meta.totalMessages})`}`);
     // Replay the existing todo list as an initial plan so a loaded session shows
     // its todos immediately (filter to PlanUpdate only — text/tools were already
     // replayed above and the differ hasn't mark_seen'd this history).
@@ -381,10 +376,13 @@ export async function loadSession(server, params, cx) {
     await emitInitialUsage(server, cx, acpSid, zcodeSid, getOrCreateDiffer(server, zcodeSid));
     const modes = await buildModes(server, zcodeSid);
     server.lastMode.set(acpSid, modes.currentModeId);
-    return {
+    const result = {
         modes,
         configOptions: await buildConfigOptions(server, zcodeSid),
+        // Additive replay metadata — the anchor for load_earlier pagination.
+        replayMeta: slice.meta,
     };
+    return result;
 }
 /** `session/prompt` → subscribe-before-send, run the event-driven turn loop. */
 export async function prompt(server, params, cx, requestId) {
@@ -400,11 +398,17 @@ export async function prompt(server, params, cx, requestId) {
     // empty-prompt check so an invalid request doesn't create a backend session.
     const zcodeSid = await ensureRealSession(server, params.sessionId);
     // Slash-command interception: dispatches directly to ZCode methods and
-    // returns end_turn without entering the turn loop. Unknown /x falls through.
-    const { handleSlashCommand } = await import("./slash.js");
+    // returns end_turn without entering the turn loop. Known passthrough
+    // commands and unknown /x both return null for the normal turn loop.
+    const { handleSlashCommand, neutralizeSlashText } = await import("./slash.js");
     const intercepted = await handleSlashCommand(server, cx, params.sessionId, zcodeSid, text);
     if (intercepted)
         return intercepted;
+    // Wire text for the backend: unknown `/x` prompts (not advertised commands)
+    // are neutralized so the backend's command resolver never sees them — an
+    // unresolvable name can hard-fail the turn. Known commands pass through
+    // unchanged. The title/auto-compact paths below keep using the raw `text`.
+    const sendText = neutralizeSlashText(text);
     // Register self + preempt others under a per-session lock. The lock
     // serializes the critical section so that two concurrent prompts (B, C) for
     // the same session can't both miss each other and register at once: C waits
@@ -491,8 +495,8 @@ export async function prompt(server, params, cx, requestId) {
             const SEND_RETRY_INTERVAL_MS = 500;
             const SEND_RETRY_TIMEOUT_MS = 30_000;
             const sendParams = attachments.length > 0
-                ? { sessionId: zcodeSid, content: text, attachments }
-                : { sessionId: zcodeSid, content: text };
+                ? { sessionId: zcodeSid, content: sendText, attachments }
+                : { sessionId: zcodeSid, content: sendText };
             const sendT0 = Date.now();
             let sendAttempt = 0;
             while (true) {
@@ -556,6 +560,7 @@ export async function prompt(server, params, cx, requestId) {
                         .find((l) => l.length > 0)
                         ?.slice(0, 80) ?? text.slice(0, 80);
                     server.sessionTitles.set(params.sessionId, title);
+                    server.touchSessionSummary(params.sessionId, title);
                     const { updateSessionTitle } = await import("../tasks-index.js");
                     void updateSessionTitle(zcodeSid, title, text);
                     await sendSessionUpdate(cx, params.sessionId, {
@@ -603,6 +608,9 @@ export async function prompt(server, params, cx, requestId) {
     finally {
         backend.unregisterEventListener(zcodeSid, listener);
         server.pendingTurns.delete(requestId);
+        // Turn end = session activity — refresh the discovery summary timestamp
+        // regardless of outcome (end_turn, cancelled, retries exhausted).
+        server.touchSessionSummary(params.sessionId);
     }
 }
 /**
@@ -914,15 +922,6 @@ async function resumeBackendSession(server, zcParams) {
         await sleep(1000);
     }
 }
-/** Fetch session/messages from zcode. */
-async function fetchMessages(server, zcodeSid) {
-    const backend = server.ensureBackend();
-    const resp = await backend.request(server.nextId(), "session/messages", { sessionId: zcodeSid }, 8000);
-    if (resp.error)
-        return [];
-    const result = (resp.result ?? {});
-    return result.messages ?? [];
-}
 /** Get or create the session-level ProjectionDiffer (persists across turns). */
 function getOrCreateDiffer(server, zcodeSid) {
     let d = server.differs.get(zcodeSid);