@sapiom/harness 0.1.6 → 0.2.1

package/dist/core/rolling-summary.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Rolling session summary — the thing that makes rehydration good rather than
+ * merely possible.
+ *
+ * A resume brief built from the last N turns alone tells a fresh session what
+ * just happened; it cannot tell it what the session was *for*. So, opt-in, we
+ * periodically fold the whole record down to a ≤500-word summary and cache it
+ * at `<generated>/<harnessSessionId>/summary.md`. The brief
+ * (core/resume-brief.ts) picks it up when it's there and degrades cleanly to
+ * last-N-turns when it isn't — which is the default, since this is
+ * setting-gated (`HarnessSettings.rollingSummary`).
+ *
+ * NEVER BLOCKS A TURN. Everything here is fire-and-forget off the ingest path:
+ * `noteEvent` returns synchronously, the fold runs as a headless one-shot
+ * `TaskManager` job (a separate process, a cheap model, `--max-turns 1` — the
+ * bounded shape `HarnessAdapter.launchTask` exists for), and every failure
+ * mode short-circuits to "no summary". A user's session must never be slower,
+ * or fail, because a summary didn't happen.
+ *
+ * The task does not write the file itself. It is asked for the summary text
+ * and nothing else; we write `summary.md` from its `resultText` when it
+ * completes. Two reasons: the target lives under `<generated>/`, outside the
+ * session's cwd — which codex's `workspace-write` sandbox forbids and
+ * claude-code's `acceptEdits` shouldn't be asked to reach — and a task that
+ * writes its own output can half-write it, where a task that returns text
+ * either produces a whole summary or none.
+ *
+ * WHERE IT DOESN'T WORK: `launchTask` is optional on the adapter contract and
+ * codex has no non-interactive mode wired for it, so a codex session simply
+ * never produces a summary and its briefs are last-N-turns. That is a real
+ * gap, stated rather than papered over; the brief is honest either way.
+ */
+import type { AnalyticsEvent, BackgroundTask, HarnessKind, SessionRecord } from "../shared/types.js";
+/** Filename under `<generated>/<harnessSessionId>/`. */
+export declare const ROLLING_SUMMARY_FILE = "summary.md";
+/** Completed turns that must accumulate before a re-fold is worth its cost. */
+export declare const ROLLING_SUMMARY_TURN_INTERVAL = 10;
+/** The contract stated in the prompt, and the clamp applied to what comes back. */
+export declare const ROLLING_SUMMARY_MAX_WORDS = 500;
+/**
+ * Model alias for the fold. A summary of text we already hold is the cheapest
+ * possible LLM job — pinning a small model here keeps an opt-in background
+ * feature from quietly costing what the user's own session does.
+ */
+export declare const ROLLING_SUMMARY_MODEL = "haiku";
+/** Hard turn cap: one turn in, one summary out. */
+export declare const ROLLING_SUMMARY_MAX_TURNS = 1;
+/** Macro id the task is registered under — also TaskManager's dedupe key, so
+ *  a session can never have two folds in flight at once. */
+export declare const ROLLING_SUMMARY_MACRO_ID = "rolling-summary";
+/**
+ * Token budget for the material handed to the fold. Larger than a brief's
+ * (this is throwaway input to a cheap model, not a system prompt competing
+ * with the user's own context) but still bounded, so a marathon session can't
+ * turn one fold into a huge request.
+ */
+export declare const ROLLING_SUMMARY_INPUT_MAX_TOKENS = 20000;
+/** Absolute path of a session's cached summary. */
+export declare function rollingSummaryPath(generatedRoot: string, harnessSessionId: string): string;
+/**
+ * The cached summary for a session, or null when there is none — never throws.
+ * A brief that fails to find a summary is a brief without one, not an error.
+ */
+export declare function readRollingSummary(generatedRoot: string, harnessSessionId: string): Promise<string | null>;
+/** Trim `text` to at most `maxWords` words, marking the cut. */
+export declare function clampToWords(text: string, maxWords?: number): string;
+/**
+ * The one-shot prompt handed to `launchTask`. The material is the record
+ * rendered by {@link buildResumeBrief} at a larger budget — deliberately the
+ * same renderer the brief uses, so the fold reads exactly the shape a future
+ * brief will present, and there is one place where "what a record looks like
+ * as text" is defined.
+ *
+ * `previous` is folded back in rather than discarded: the record itself is
+ * capped at the input budget, so on a long session the earliest turns are
+ * already gone from the material, and the last summary is the only surviving
+ * account of them.
+ */
+export declare function buildRollingSummaryPrompt(record: SessionRecord, previous: string | null): string;
+/** What the summarizer needs from the outside world. All injectable, so the
+ *  unit tests drive it without a filesystem or a spawned process. */
+export interface RollingSummarizerDeps {
+    /** Root the per-session generated dirs live under. */
+    generatedRoot: string;
+    /** The `HarnessSettings.rollingSummary` gate, re-read per fold so toggling
+     *  the setting takes effect without a restart. Never throws. */
+    enabled: () => Promise<boolean>;
+    /** Reads the reconstructed record for a session (SessionRecordReader.read). */
+    readRecord: (harnessSessionId: string) => Promise<SessionRecord | null>;
+    /** The live session, for the harness kind and cwd the task runs as. Returns
+     *  undefined once the session is gone from the registry. */
+    getSession: (harnessSessionId: string) => {
+        harness: HarnessKind;
+        cwd: string;
+    } | undefined;
+    /** TaskManager.run, narrowed to what this needs. */
+    runTask: (req: {
+        macroId: string;
+        label: string;
+        harnessSessionId: string;
+        harness: HarnessKind;
+        cwd: string;
+        prompt: string;
+        model: string;
+        maxTurns: number;
+    }) => Promise<BackgroundTask>;
+    /** Completed turns between folds. Default {@link ROLLING_SUMMARY_TURN_INTERVAL}. */
+    turnInterval?: number;
+    /** Diagnostics sink. Defaults to console.error — a fold failing is worth a
+     *  log line and nothing more. */
+    onError?: (err: unknown) => void;
+}
+export interface RollingSummarizer {
+    /**
+     * Feed one normalized analytics event. Synchronous and total: it counts
+     * `turn.completed`, triggers a fold on the interval and on `session.end`,
+     * and ignores everything else. Any work it starts is detached.
+     */
+    noteEvent(event: AnalyticsEvent): void;
+    /**
+     * Feed a task status change (TaskManager.onStatusChange). A completed fold
+     * task's `resultText` is what becomes `summary.md`.
+     */
+    noteTaskStatus(task: BackgroundTask): void;
+    /** Resolves when no fold this summarizer started is still in flight. For
+     *  tests and for shutdown; production callers never need to await it. */
+    idle(): Promise<void>;
+}
+export declare function createRollingSummarizer(deps: RollingSummarizerDeps): RollingSummarizer;
+//# sourceMappingURL=rolling-summary.d.ts.map

package/dist/core/rolling-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolling-summary.d.ts","sourceRoot":"","sources":["../../src/core/rolling-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGrG,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C;4DAC4D;AAC5D,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkC,GAAG,MAAM,CAI/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA+BhG;AAED;qEACqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB;oEACgE;IAChE,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+EAA+E;IAC/E,UAAU,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACxE;gEAC4D;IAC5D,UAAU,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5F,oDAAoD;IACpD,OAAO,EAAE,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,WAAW,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9B,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;qCACiC;IACjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C;6EACyE;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAgGtF"}

package/dist/core/rolling-summary.js

@@ -0,0 +1,227 @@
+/**
+ * Rolling session summary — the thing that makes rehydration good rather than
+ * merely possible.
+ *
+ * A resume brief built from the last N turns alone tells a fresh session what
+ * just happened; it cannot tell it what the session was *for*. So, opt-in, we
+ * periodically fold the whole record down to a ≤500-word summary and cache it
+ * at `<generated>/<harnessSessionId>/summary.md`. The brief
+ * (core/resume-brief.ts) picks it up when it's there and degrades cleanly to
+ * last-N-turns when it isn't — which is the default, since this is
+ * setting-gated (`HarnessSettings.rollingSummary`).
+ *
+ * NEVER BLOCKS A TURN. Everything here is fire-and-forget off the ingest path:
+ * `noteEvent` returns synchronously, the fold runs as a headless one-shot
+ * `TaskManager` job (a separate process, a cheap model, `--max-turns 1` — the
+ * bounded shape `HarnessAdapter.launchTask` exists for), and every failure
+ * mode short-circuits to "no summary". A user's session must never be slower,
+ * or fail, because a summary didn't happen.
+ *
+ * The task does not write the file itself. It is asked for the summary text
+ * and nothing else; we write `summary.md` from its `resultText` when it
+ * completes. Two reasons: the target lives under `<generated>/`, outside the
+ * session's cwd — which codex's `workspace-write` sandbox forbids and
+ * claude-code's `acceptEdits` shouldn't be asked to reach — and a task that
+ * writes its own output can half-write it, where a task that returns text
+ * either produces a whole summary or none.
+ *
+ * WHERE IT DOESN'T WORK: `launchTask` is optional on the adapter contract and
+ * codex has no non-interactive mode wired for it, so a codex session simply
+ * never produces a summary and its briefs are last-N-turns. That is a real
+ * gap, stated rather than papered over; the brief is honest either way.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { buildResumeBrief } from "./resume-brief.js";
+/** Filename under `<generated>/<harnessSessionId>/`. */
+export const ROLLING_SUMMARY_FILE = "summary.md";
+/** Completed turns that must accumulate before a re-fold is worth its cost. */
+export const ROLLING_SUMMARY_TURN_INTERVAL = 10;
+/** The contract stated in the prompt, and the clamp applied to what comes back. */
+export const ROLLING_SUMMARY_MAX_WORDS = 500;
+/**
+ * Model alias for the fold. A summary of text we already hold is the cheapest
+ * possible LLM job — pinning a small model here keeps an opt-in background
+ * feature from quietly costing what the user's own session does.
+ */
+export const ROLLING_SUMMARY_MODEL = "haiku";
+/** Hard turn cap: one turn in, one summary out. */
+export const ROLLING_SUMMARY_MAX_TURNS = 1;
+/** Macro id the task is registered under — also TaskManager's dedupe key, so
+ *  a session can never have two folds in flight at once. */
+export const ROLLING_SUMMARY_MACRO_ID = "rolling-summary";
+/**
+ * Token budget for the material handed to the fold. Larger than a brief's
+ * (this is throwaway input to a cheap model, not a system prompt competing
+ * with the user's own context) but still bounded, so a marathon session can't
+ * turn one fold into a huge request.
+ */
+export const ROLLING_SUMMARY_INPUT_MAX_TOKENS = 20000;
+/** Absolute path of a session's cached summary. */
+export function rollingSummaryPath(generatedRoot, harnessSessionId) {
+    return path.join(generatedRoot, harnessSessionId, ROLLING_SUMMARY_FILE);
+}
+/**
+ * The cached summary for a session, or null when there is none — never throws.
+ * A brief that fails to find a summary is a brief without one, not an error.
+ */
+export async function readRollingSummary(generatedRoot, harnessSessionId) {
+    try {
+        const text = await fs.readFile(rollingSummaryPath(generatedRoot, harnessSessionId), "utf8");
+        const trimmed = text.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Trim `text` to at most `maxWords` words, marking the cut. */
+export function clampToWords(text, maxWords = ROLLING_SUMMARY_MAX_WORDS) {
+    const words = text.trim().split(/\s+/);
+    if (words.length <= maxWords)
+        return text.trim();
+    return `${words.slice(0, maxWords).join(" ")} …[summary truncated]`;
+}
+/**
+ * The one-shot prompt handed to `launchTask`. The material is the record
+ * rendered by {@link buildResumeBrief} at a larger budget — deliberately the
+ * same renderer the brief uses, so the fold reads exactly the shape a future
+ * brief will present, and there is one place where "what a record looks like
+ * as text" is defined.
+ *
+ * `previous` is folded back in rather than discarded: the record itself is
+ * capped at the input budget, so on a long session the earliest turns are
+ * already gone from the material, and the last summary is the only surviving
+ * account of them.
+ */
+export function buildRollingSummaryPrompt(record, previous) {
+    const material = buildResumeBrief(record, {
+        summary: previous,
+        maxTokens: ROLLING_SUMMARY_INPUT_MAX_TOKENS,
+        maxTurns: Number.MAX_SAFE_INTEGER,
+    });
+    return [
+        `Summarize the coding session described below in at most ${ROLLING_SUMMARY_MAX_WORDS} words.`,
+        "",
+        "The summary is read by a FRESH agent session that has none of this context,",
+        "so write for someone picking the work up cold. Cover, in this order and only",
+        "where the material actually supports it:",
+        "",
+        "1. What the session was trying to accomplish.",
+        "2. What was decided, and why — decisions are the part a transcript replay",
+        "   cannot reconstruct.",
+        "3. What was actually changed (files, behaviour).",
+        "4. What is unfinished, blocked, or known-broken.",
+        "",
+        "Rules:",
+        "- Output ONLY the summary as markdown prose. No preamble, no sign-off, no",
+        "  code fences around the whole thing.",
+        "- Do not invent anything the material does not state. If something is",
+        "  unclear or was never recorded, say so or leave it out — a confident",
+        "  summary of a gap is the single worst outcome here.",
+        "- Do not use any tools. Everything you need is in this prompt.",
+        "",
+        "--- SESSION MATERIAL ---",
+        "",
+        material,
+    ].join("\n");
+}
+export function createRollingSummarizer(deps) {
+    const turnInterval = deps.turnInterval ?? ROLLING_SUMMARY_TURN_INTERVAL;
+    const onError = deps.onError ?? ((err) => console.error("[harness] rolling summary failed:", err));
+    /** Completed turns seen for a session since its last fold was *started*. */
+    const turnsSinceFold = new Map();
+    /** Fold task id → the session it summarizes, so a completion can be routed
+     *  back. Only ids this summarizer started are ever in here, which is what
+     *  keeps it from writing summary.md for some other background task. */
+    const foldTargets = new Map();
+    /** In-flight promises, awaited by `idle()`. */
+    const pending = new Set();
+    const track = (work) => {
+        const tracked = work.catch(onError).finally(() => pending.delete(tracked));
+        pending.add(tracked);
+    };
+    async function fold(harnessSessionId) {
+        if (!(await deps.enabled()))
+            return;
+        const session = deps.getSession(harnessSessionId);
+        // Gone from the registry (swept, or a task's own id leaking through the
+        // ingest path) — there is nothing to run the fold as.
+        if (!session)
+            return;
+        const record = await deps.readRecord(harnessSessionId);
+        if (!record || record.turns.length === 0)
+            return;
+        const previous = await readRollingSummary(deps.generatedRoot, harnessSessionId);
+        const task = await deps.runTask({
+            macroId: ROLLING_SUMMARY_MACRO_ID,
+            label: "Session summary",
+            harnessSessionId,
+            harness: session.harness,
+            cwd: session.cwd,
+            prompt: buildRollingSummaryPrompt(record, previous),
+            model: ROLLING_SUMMARY_MODEL,
+            maxTurns: ROLLING_SUMMARY_MAX_TURNS,
+        });
+        foldTargets.set(task.id, harnessSessionId);
+    }
+    async function writeSummary(harnessSessionId, text) {
+        const clamped = clampToWords(text.trim());
+        if (clamped.length === 0)
+            return;
+        const filePath = rollingSummaryPath(deps.generatedRoot, harnessSessionId);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, `${clamped}\n`, "utf8");
+    }
+    return {
+        noteEvent(event) {
+            const sessionId = event.harnessSessionId;
+            if (event.type === "turn.completed") {
+                const count = (turnsSinceFold.get(sessionId) ?? 0) + 1;
+                if (count < turnInterval) {
+                    turnsSinceFold.set(sessionId, count);
+                    return;
+                }
+                // Reset BEFORE the fold rather than after it completes: the counter
+                // paces how often folds are *started*, and resetting on completion
+                // would let a slow fold queue up a second one the moment it lands.
+                turnsSinceFold.set(sessionId, 0);
+                track(fold(sessionId));
+                return;
+            }
+            if (event.type === "session.end") {
+                // Always fold at session end when anything at all happened since the
+                // last one — this is the summary a future rehydration will actually
+                // read, so it must not be `turnInterval - 1` turns stale.
+                const pendingTurns = turnsSinceFold.get(sessionId) ?? 0;
+                turnsSinceFold.delete(sessionId);
+                if (pendingTurns > 0)
+                    track(fold(sessionId));
+            }
+        },
+        noteTaskStatus(task) {
+            const harnessSessionId = foldTargets.get(task.id);
+            if (harnessSessionId === undefined)
+                return;
+            if (task.status === "running")
+                return;
+            foldTargets.delete(task.id);
+            if (task.status === "failed" || !task.resultText) {
+                // A failed fold leaves the previous summary in place — a stale summary
+                // is strictly better than none, and the brief labels its own age via
+                // the record's own timestamps either way.
+                if (task.status === "failed")
+                    onError(new Error(task.errorTail ?? "rolling summary task failed"));
+                return;
+            }
+            track(writeSummary(harnessSessionId, task.resultText));
+        },
+        async idle() {
+            // Re-read the set each pass: writing a summary is itself tracked work
+            // started by an earlier tracked promise.
+            while (pending.size > 0)
+                await Promise.all([...pending]);
+        },
+    };
+}
+//# sourceMappingURL=rolling-summary.js.map

package/dist/core/rolling-summary.js.map

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

package/dist/core/session-manager.d.ts

@@ -35,7 +35,7 @@ export type SessionActivityListener = (harnessSessionId: string) => void;
  * whichever shape is handed in; existing sync test doubles keep working
  * unchanged (`await` on a plain value just resolves immediately).
  */
-export type LaunchOptsBuilder = (harnessSessionId: string, req: Pick<CreateSessionRequest, "cwd" | "harness" | "profile">) => Omit<LaunchOpts, "harnessSessionId" | "cwd"> | Promise<Omit<LaunchOpts, "harnessSessionId" | "cwd">>;
+export type LaunchOptsBuilder = (harnessSessionId: string, req: Pick<CreateSessionRequest, "cwd" | "harness" | "profile" | "rehydrateFrom">) => Omit<LaunchOpts, "harnessSessionId" | "cwd"> | Promise<Omit<LaunchOpts, "harnessSessionId" | "cwd">>;
 export interface SessionManagerOptions {
     adapters: Partial<Record<HarnessKind, HarnessAdapter>>;
     /** Base URL the harness server is reachable at, e.g. http://127.0.0.1:4100. */
@@ -125,8 +125,16 @@ export declare class SessionManager {
     create(req: CreateSessionRequest): Promise<HarnessSession>;
     /**
      * Registers a purely historical (never-launched-by-this-harness) session so
-     * it can subsequently be resumed via `resume()`. Used by the server layer
-     * when a user picks a past session out of transcript-scanned history.
+     * it can subsequently be resumed via `resume()`. Called by
+     * `POST /api/sessions/adopt` when a user opens a transcript-only history row
+     * whose transcript the agent genuinely still holds — that row then resumes
+     * for real instead of silently starting a fresh session in the directory,
+     * which is what happened for as long as nothing called this.
+     *
+     * The record is born `exited` with `createdAt === lastActiveAt` (nothing has
+     * run under our management yet). `resume()` is what gives it a pty, and the
+     * adopt route pre-verifies resumability before registering, so this never
+     * mints a record that can't be resumed.
      */
     registerHistorical(input: {
         agentSessionId: string;

package/dist/core/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAKrB,KAAK,IAAI,GAAG,OAAO,UAAU,EAAE,IAAI,CAAC;AACpC,KAAK,cAAc,GAAG,OAAO,UAAU,EAAE,eAAe,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAKzF;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAcjE;AA8FD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAC1D,0BAA0B;AAC1B,MAAM,MAAM,uBAAuB,GAAG,CAAC,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC,KAC7E,IAAI,CAAC,UAAU,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC;AAI1G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IACvD,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAyBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA6C;IACnF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAC3E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAiC;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAEtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA6B;IACnE,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,qBAAqB;IAmB1C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,IAAI,IAAI,cAAc,EAAE;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C,OAAO,CAAC,UAAU;IAgBZ,MAAM,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAiDhE;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,KAAK,EAAE;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,WAAW,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,cAAc;IAoBZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuEjD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+ClC;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;;;;;OAWG;IACH,iBAAiB,IAAI,IAAI;IAqBzB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAYxC;;;;;;;;;;;;;;OAcG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAuC5E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAOvD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAQ3E,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO3D;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAOzD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAQtB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAQ3D;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;;;OAMG;YACW,cAAc;IAY5B;2EACuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzC;;;;iFAI6E;IAC7E,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;YAQrD,KAAK;IA8DnB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,UAAU;IAIlB;8EAC0E;IAC1E,OAAO,CAAC,OAAO;CAYhB"}

package/dist/core/session-manager.js

@@ -11,6 +11,7 @@ import { basename, dirname, join, resolve, sep } from "node:path";
 import { createRequire } from "node:module";
 import { ENV, HARNESS_PATHS, } from "../shared/types.js";
 import { expandHome } from "./paths.js";
+import { resolveSpawnTarget } from "./spawn-target.js";
 import { AdapterNotFoundError, ExternalHarnessError, SessionAlreadyLiveError, SessionNotReadyError, SessionNotResumeableError, UnknownSessionError, } from "./errors.js";
 import { listHarnessAdapters } from "./adapters/registry.js";
 export { AdapterNotFoundError, ExternalHarnessError, SessionAlreadyLiveError, SessionNotReadyError, SessionNotResumeableError, UnknownSessionError, } from "./errors.js";
@@ -245,6 +246,11 @@ export class SessionManager {
             lastActiveAt: this.now(),
             exitCode: null,
             boundWorkflowPath: null,
+            // What the builder actually managed to assemble, not what the caller
+            // asked for: `req.rehydrateFrom` naming a session our event log holds
+            // nothing for yields no brief, and this stays null so nothing downstream
+            // presents an empty-handed fresh session as a continuation.
+            rehydratedFrom: opts.rehydratedFrom ?? null,
             ready: false,
         };
         this.sessions.set(id, session);
@@ -271,8 +277,16 @@ export class SessionManager {
     }
     /**
      * Registers a purely historical (never-launched-by-this-harness) session so
-     * it can subsequently be resumed via `resume()`. Used by the server layer
-     * when a user picks a past session out of transcript-scanned history.
+     * it can subsequently be resumed via `resume()`. Called by
+     * `POST /api/sessions/adopt` when a user opens a transcript-only history row
+     * whose transcript the agent genuinely still holds — that row then resumes
+     * for real instead of silently starting a fresh session in the directory,
+     * which is what happened for as long as nothing called this.
+     *
+     * The record is born `exited` with `createdAt === lastActiveAt` (nothing has
+     * run under our management yet). `resume()` is what gives it a pty, and the
+     * adopt route pre-verifies resumability before registering, so this never
+     * mints a record that can't be resumed.
      */
     registerHistorical(input) {
         const id = this.generateId();
@@ -304,12 +318,32 @@ export class SessionManager {
             throw new SessionAlreadyLiveError(id);
         }
         const adapter = this.getAdapter(session.harness);
+        // Pre-flight against the agent's OWN store before touching the record.
+        // Holding an agentSessionId only means our SessionStart hook fired once;
+        // an agent that never received a prompt writes no transcript, so
+        // `--resume` would exit 1 with "No conversation found with session ID"
+        // and leave the user on a dead pane offering Resume all over again.
+        // Failing here instead keeps the record exactly as it was — unspawned,
+        // and (see below) with its real lastActiveAt intact.
+        if (!(await adapter.canResume(session.agentSessionId, session.cwd))) {
+            const label = listHarnessAdapters().find((a) => a.id === session.harness)?.label ?? session.harness;
+            throw new SessionNotResumeableError(id, `${label} no longer has the conversation for this session (${session.agentSessionId}) in ${session.cwd}. ` +
+                `Sessions that ended before their first prompt are never written to the agent's history, so there is nothing to resume — start a new session in this directory instead.`);
+        }
         const opts = {
             harnessSessionId: id,
             cwd: session.cwd,
             ...(await this.buildLaunchOpts(id, session)),
         };
         const spec = adapter.resume(session.agentSessionId, opts);
+        // Kept so the failure path below can put it back: `lastActiveAt` is
+        // stamped here only to keep sweepDeadSessions() from reaping this record
+        // during the pre-pty window (it reaps non-exited records with no pty once
+        // they're older than the grace period). If the resume never produces a
+        // pty, that stamp is not activity and must not survive — otherwise a
+        // session idle since last night reports "Ran for 6h 25m" purely because
+        // someone clicked Resume.
+        const lastActiveBeforeResume = session.lastActiveAt;
         session.status = "starting";
         session.exitCode = null;
         session.lastActiveAt = this.now();
@@ -332,8 +366,12 @@ export class SessionManager {
         catch (err) {
             // Same reconciliation as create(): the record just went back to
             // "starting" and was persisted — a failure before the new pty is live
-            // must not leave it stranded there with nothing behind it.
-            await this.transitionExited(session, null);
+            // must not leave it stranded there with nothing behind it. Roll the
+            // pre-pty `lastActiveAt` stamp back at the same time: no pty ever ran,
+            // so the session's last real activity is still where it was, and the
+            // dead pane's "Ran for" stays truthful.
+            session.lastActiveAt = lastActiveBeforeResume;
+            await this.transitionExited(session, null, { stampLastActive: false });
             throw err;
         }
         return session;
@@ -701,11 +739,18 @@ export class SessionManager {
         env[ENV.sessionId] = session.id;
         if (this.collectorUrl)
             env[ENV.collectorUrl] = this.collectorUrl;
+        // On Windows a bare command name (or a .cmd shim, which is what npm installs
+        // for `claude`) cannot be spawned: node-pty uses CreateProcess, which does no
+        // PATHEXT resolution and can't execute a .cmd. resolveSpawnTarget RESOLVES the
+        // shim to its real target — deliberately NOT via cmd.exe, which would expose
+        // these arguments to shell parsing (command injection; see that module).
+        // No-op on POSIX.
+        const target = resolveSpawnTarget(spec.command, spec.args);
         // A throw here — spawnFn itself, or loadDefaultSpawn() above (a broken
         // node-pty prebuild surfaces there, not at import time) — propagates to
         // create()/resume(), which own reconciling the session record to
         // "exited" for every pre-pty failure, not just this one.
-        const pty = spawnFn(spec.command, spec.args, {
+        const pty = spawnFn(target.command, target.args, {
             name: "xterm-256color",
             cols: DEFAULT_COLS,
             rows: DEFAULT_ROWS,
@@ -765,10 +810,14 @@ export class SessionManager {
      * the registry durably updated before rethrowing (create/resume) can
      * await it; event-driven callers fire-and-forget it like any other write.
      */
-    transitionExited(session, exitCode) {
+    transitionExited(session, exitCode, { stampLastActive = true } = {}) {
         session.status = "exited";
         session.exitCode = exitCode;
-        session.lastActiveAt = this.now();
+        // `stampLastActive: false` is for reconciling a resume that never got a
+        // pty: "we noticed it's dead" is not activity, and stamping it there is
+        // what made an untouched session's duration grow on every failed Resume.
+        if (stampLastActive)
+            session.lastActiveAt = this.now();
         const persisted = this.persist();
         this.emitStatus(session);
         return persisted;