@sagmans/dsh-tui 0.5.2 → 0.7.0

package/lib/surface/session-lifecycle.js

@@ -0,0 +1,321 @@
+import { randomUUID } from 'node:crypto';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { forkPoint } from "../agent/fork.js";
+import { startAgent } from "../agent/host.js";
+import { driverReportFor, sessionStartReason } from "../herdr/state.js";
+import { pendingPrompts } from "../queue.js";
+import { BELL, shouldRingBell } from "../terminal/bell.js";
+import { windowTitle } from "../terminal/title.js";
+/**
+ * The agent this terminal drives: its identity, its activity, and every
+ * transition that replaces it. One owner, because a replacement is one thing:
+ * the handle, the turn it ran, the scope its cards read through, the transcript
+ * folded from it, and its roster all move together.
+ */
+/** How often the running-state clock repaints while a turn is open. */
+const STATUS_TICK_MS = 1000;
+export function createSessionLifecycle(ctx, ports) {
+    /** The session this surface drives: commands, approvals, and the bell belong to it. */
+    let activeSession = ports.initialSession;
+    /** The agent in service, or undefined while a transition creates the next one. */
+    let agent;
+    /** Whether a turn is open, which is what the clock repaints for. */
+    let turnOpen = false;
+    /** When the open turn started, which the status facts time it from. */
+    let turnStartedAt;
+    /** Whether a session was really opened, which is what an exit hint can name. */
+    let sessionOpened = false;
+    // The queue is read from the agent this terminal drives rather than from the
+    // session on screen, because it sits on the editor that submits to that agent.
+    const queuedPrompts = () => pendingPrompts(ctx, ports.liveSession(activeSession));
+    // Only a running turn has anything to say over time, so the clock stops with it.
+    const statusTicker = setInterval(() => {
+        if (turnOpen)
+            ports.render();
+    }, STATUS_TICK_MS);
+    ports.disposers.push(() => clearInterval(statusTicker));
+    const stopClock = () => clearInterval(statusTicker);
+    /**
+     * Let go of the agent in service and everything projected from it, handing the
+     * handle back to be stopped.
+     *
+     * `clearScope` is the path's, not this helper's: a replacement drops the
+     * outgoing scope before stopping its agent, and an open that folds history of
+     * its own relies on the scope it installs.
+     */
+    const letGoOfOutgoing = (clearScope) => {
+        const previous = agent;
+        agent = undefined;
+        turnOpen = false;
+        // The outgoing turn's clock dies with its agent; leaving it set would time
+        // the session being joined by work it never ran.
+        turnStartedAt = undefined;
+        if (clearScope)
+            ports.clearPresentScope();
+        ports.resetTranscript();
+        ports.resetRoster();
+        return previous;
+    };
+    const disposeOutgoing = async () => {
+        const previous = letGoOfOutgoing(true);
+        if (previous !== undefined)
+            await previous.dispose();
+    };
+    const openAgent = async (id, resume, fork) => {
+        // Settled before the transcript is touched, so a refusal leaves neither a
+        // half-replayed session nor a half-composed agent behind.
+        const preset = await ports.presetFor(id, resume, fork);
+        const handle = await startAgent(ctx, {
+            sessionId: id,
+            resume,
+            model: ports.model,
+            provider: ports.provider,
+            cwd: process.cwd(),
+            preset,
+            setup: async (agentCtx) => {
+                ports.installModelChoice(agentCtx);
+                if (preset !== undefined)
+                    await ports.mountPreset(agentCtx, preset);
+            },
+            ...(fork === undefined ? {} : { fork }),
+        });
+        sessionOpened = true;
+        activeSession = id;
+        ports.setViewed(id);
+        agent = handle;
+        // A cursor counts the turns of one log; the session just opened has its own.
+        ports.stagedSessionOpened(id);
+        ports.promptMemorySessionOpened();
+        // agent/status is emitted on transitions only, so a driver that was
+        // already running when this surface attached — a resume that wakes
+        // straight away — would otherwise stay unreported until it stops. The
+        // status is read once here and settled before the session identity, so the
+        // report that carries the new session id states the driver's real phase
+        // rather than the one the previous session left behind.
+        ports.herdr.driver(handle.agent.status);
+        // The agent's own id is reported rather than the requested one: a resume can
+        // be answered by the session the log actually holds.
+        ports.herdr.session({
+            id: String(handle.sessionId),
+            cwd: process.cwd(),
+            reason: sessionStartReason({ forked: fork !== undefined, resumed: resume }),
+        });
+        // A session with no history to fold still has to present its first live
+        // card through the right scope, so the scope is set before any event can.
+        ports.setPresentScope(handle.agent);
+        // Replayed only once the agent exists, because the fold reads every card
+        // through the scope the preset mounted; a fold before that scope existed
+        // degraded each replayed card to a bare generic row. The agent's loop is
+        // live by now, so the fold and the stream race over the same events; the
+        // durable sequence number is what keeps one event from landing twice.
+        if (resume)
+            await ports.replay(id);
+        // A branch inherits the conversation the reader was already reading, so it
+        // opens on that history rather than on an empty screen.
+        if (fork !== undefined)
+            await ports.fold(id);
+        ports.disposers.push(() => {
+            void handle.dispose();
+        });
+        ports.installCompletion();
+        ports.notice(`session ${handle.sessionId}${resume ? ' (resumed)' : ''}`);
+        ports.render();
+        // Returned so a caller that replaced the handle can send through the new
+        // one without a fresh read of state TypeScript can no longer widen.
+        return handle;
+    };
+    const switchSession = async (id) => {
+        await disposeOutgoing();
+        await openAgent(id, true);
+    };
+    const runNewCommand = (title) => {
+        if (agent === undefined) {
+            ports.notice('the agent is still starting; try again in a moment');
+            ports.render();
+            return;
+        }
+        void (async () => {
+            const previous = letGoOfOutgoing(false);
+            if (previous !== undefined)
+                await previous.dispose();
+            await openAgent(SessionId(`tui-session-${randomUUID()}`), false);
+            if (title !== '')
+                runRenameCommand(title);
+            ports.notice('started a new session');
+            ports.render();
+        })().catch((error) => {
+            ports.notice(`could not start a session: ${error instanceof Error ? error.message : String(error)}`);
+            ports.render();
+        });
+    };
+    /**
+     * Compose this session's agent again without leaving the conversation: a
+     * preset's standing mount only re-reads its composition file for an agent that
+     * joins after the file changed, and the durable log is replayed afterwards, so
+     * the reader keeps the conversation they were reading.
+     */
+    const runReloadCommand = () => {
+        // A failed reload leaves no agent behind, so the command has to be usable
+        // again: the retry is what makes a broken composition file recoverable,
+        // while a surface that has opened no session yet is still starting.
+        if (agent === undefined && !sessionOpened) {
+            ports.notice('the agent is still starting; try again in a moment');
+            ports.render();
+            return;
+        }
+        const queued = queuedPrompts();
+        // Work the reader would lose is a decision, and the interrupt key already
+        // owns that decision: it stops the turn and hands queued words back to the
+        // bar. Reopening the session drops the inbox, so a reload that would take
+        // those words asks for the key instead of asking a question of its own.
+        if (turnOpen || queued.length > 0) {
+            ports.notice(queued.length > 0
+                ? `${queued.length} queued ${queued.length === 1 ? 'prompt' : 'prompts'} would be dropped — ctrl+c hands them back to the bar, then /reload`
+                : 'a turn is running — ctrl+c interrupts it first (delivered text is kept), then /reload');
+            ports.render();
+            return;
+        }
+        const id = activeSession;
+        void (async () => {
+            // The same transition a session switch takes, aimed at the session
+            // already open: dispose, then join its preset generation anew.
+            await switchSession(id);
+            ports.notice("reloaded this session's composition; the transcript was replayed");
+            ports.render();
+        })().catch((error) => {
+            const reason = error instanceof Error ? error.message : String(error);
+            ports.notice(`could not reload: ${reason} — fix the composition and /reload again`);
+            ports.render();
+        });
+    };
+    const runForkCommand = (title) => {
+        if (agent === undefined) {
+            ports.notice('the agent is still starting; try again in a moment');
+            ports.render();
+            return;
+        }
+        void (async () => {
+            const source = activeSession;
+            const events = await ports.sessionEvents(source);
+            const point = forkPoint(events);
+            if (point === undefined) {
+                ports.notice('nothing to fork yet: this session has no completed turn');
+                ports.render();
+                return;
+            }
+            const childId = SessionId(`tui-session-${randomUUID()}`);
+            const previous = letGoOfOutgoing(false);
+            if (previous !== undefined)
+                await previous.dispose();
+            await openAgent(childId, false, { from: source, events: events.slice(0, point.inheritedEvents) });
+            if (title !== '')
+                runRenameCommand(title);
+            ports.notice(`forked from ${source} at event ${point.boundarySeq} — ${point.inheritedEvents} inherited`);
+            ports.render();
+        })().catch((error) => {
+            ports.notice(`could not fork: ${error instanceof Error ? error.message : String(error)}`);
+            ports.render();
+        });
+    };
+    /**
+     * Give this session a title: it is what the resume picker shows, so a reader
+     * who has several sessions can name the one they are in.
+     */
+    const runRenameCommand = (title) => {
+        if (title === '') {
+            ports.notice('use /rename <title>; the title is what the resume picker shows');
+            ports.render();
+            return;
+        }
+        const session = ctx.get('sessions')?.get?.(activeSession);
+        const titles = ctx.get('sessionTitle');
+        if (session === undefined || typeof titles?.rename !== 'function') {
+            ports.notice('this profile has no session-title service, so this session cannot be renamed');
+            ports.render();
+            return;
+        }
+        try {
+            const accepted = titles.rename(session, title);
+            ports.notice(`session renamed to "${typeof accepted?.title === 'string' ? accepted.title : title}"`);
+        }
+        catch (error) {
+            ports.notice(`could not rename: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        ports.render();
+    };
+    /**
+     * The driven half of one durable event.
+     *
+     * The surface state — activity, timer, title, bell, job board — belongs to the
+     * agent this terminal drives, even while a child is on screen.
+     */
+    const observe = (session, event) => {
+        if (session.id !== activeSession)
+            return;
+        // The parent's catalog names the child; lifecycle events carry only its id.
+        if (event.type === 'subagent/catalog') {
+            ports.acceptCatalog(event.data);
+            ports.render();
+        }
+        if (event.type === 'turn/start') {
+            turnOpen = true;
+            turnStartedAt = Date.now();
+            ports.writeTerminal(windowTitle(process.cwd(), 'working'));
+        }
+        if (event.type === 'turn/end') {
+            const ranFor = turnStartedAt === undefined ? 0 : Date.now() - turnStartedAt;
+            turnOpen = false;
+            turnStartedAt = undefined;
+            // An undo may be parked waiting for exactly this boundary.
+            ports.turnSettled();
+            ports.writeTerminal(windowTitle(process.cwd(), 'ready'));
+            if (shouldRingBell({ bell: ports.bell, ranForMs: ranFor, exiting: ports.exiting() }))
+                ports.writeTerminal(BELL);
+            // A job the turn started may have settled while the reader was watching
+            // something else, and nothing else refreshes a live board.
+            ports.refreshJobs();
+        }
+        // A claim or a discard changes what is queued, and that belongs to this
+        // session even while the transcript shows a child's conversation.
+        if (event.type === 'agent/inbox/spliced')
+            ports.render();
+    };
+    /** The name is cast so a rename in the harness cannot break this compilation. */
+    const listenFor = (name, handler) => ctx.on(name, handler);
+    /**
+     * The listeners that follow the driver rather than each turn: a run chaining
+     * turns through a pending inbox is one stretch of work, and a turn boundary
+     * inside it would read as done while the agent is still working; the turn
+     * events keep the title and the bell, the reader's own conversation.
+     */
+    const driverListeners = () => [
+        listenFor('agent/status', payload => {
+            // Read against the driven session at delivery time: the reader can switch
+            // sessions between two transitions, and the row must follow the one this
+            // terminal now drives.
+            const status = driverReportFor(payload, activeSession);
+            if (status === undefined)
+                return;
+            ports.herdr.driver(status);
+        }),
+    ];
+    return {
+        activeSession: () => activeSession,
+        drivingAgent: () => agent,
+        turnRunning: () => turnOpen,
+        activity: () => ({ running: turnOpen, startedAt: turnStartedAt }),
+        sessionOpened: () => sessionOpened,
+        queuedPrompts,
+        stopClock,
+        disposeOutgoing,
+        openAgent,
+        switchSession,
+        runNewCommand,
+        runReloadCommand,
+        runForkCommand,
+        runRenameCommand,
+        observe,
+        driverListeners,
+    };
+}
+//# sourceMappingURL=session-lifecycle.js.map

package/lib/surface/session-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lifecycle.js","sourceRoot":"","sources":["../../src/surface/session-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAuC,MAAM,kBAAkB,CAAA;AAElF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;;GAKG;AAEH,uEAAuE;AACvE,MAAM,cAAc,GAAG,IAAI,CAAA;AAgH3B,MAAM,UAAU,sBAAsB,CAAC,GAAY,EAAE,KAA4B;IAC/E,uFAAuF;IACvF,IAAI,aAAa,GAAG,KAAK,CAAC,cAAc,CAAA;IACxC,kFAAkF;IAClF,IAAI,KAA2B,CAAA;IAC/B,oEAAoE;IACpE,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,uEAAuE;IACvE,IAAI,aAAiC,CAAA;IACrC,gFAAgF;IAChF,IAAI,aAAa,GAAG,KAAK,CAAA;IAEzB,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,aAAa,GAAG,GAAsB,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;IAEpG,iFAAiF;IACjF,MAAM,YAAY,GAAmC,WAAW,CAAC,GAAG,EAAE;QACpE,IAAI,QAAQ;YAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC9B,CAAC,EAAE,cAAc,CAAC,CAAA;IAClB,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAA;IAEvD,MAAM,SAAS,GAAG,GAAS,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAEzD;;;;;;;OAOG;IACH,MAAM,eAAe,GAAG,CAAC,UAAmB,EAAwB,EAAE;QACpE,MAAM,QAAQ,GAAG,KAAK,CAAA;QACtB,KAAK,GAAG,SAAS,CAAA;QACjB,QAAQ,GAAG,KAAK,CAAA;QAChB,2EAA2E;QAC3E,iDAAiD;QACjD,aAAa,GAAG,SAAS,CAAA;QACzB,IAAI,UAAU;YAAE,KAAK,CAAC,iBAAiB,EAAE,CAAA;QACzC,KAAK,CAAC,eAAe,EAAE,CAAA;QACvB,KAAK,CAAC,WAAW,EAAE,CAAA;QACnB,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;IAED,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;QAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;IACtD,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,KAAK,EAAE,EAAa,EAAE,MAAe,EAAE,IAAsB,EAAqB,EAAE;QACpG,0EAA0E;QAC1E,0DAA0D;QAC1D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE;YACnC,SAAS,EAAE,EAAE;YACb,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM;YACN,KAAK,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;gBACtB,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;gBAClC,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YACrE,CAAC;YACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;SACxC,CAAC,CAAA;QACF,aAAa,GAAG,IAAI,CAAA;QACpB,aAAa,GAAG,EAAE,CAAA;QAClB,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QACnB,KAAK,GAAG,MAAM,CAAA;QACd,6EAA6E;QAC7E,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC7B,KAAK,CAAC,yBAAyB,EAAE,CAAA;QACjC,oEAAoE;QACpE,mEAAmE;QACnE,sEAAsE;QACtE,2EAA2E;QAC3E,wEAAwE;QACxE,wDAAwD;QACxD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACvC,6EAA6E;QAC7E,qDAAqD;QACrD,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;YAClB,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC5E,CAAC,CAAA;QACF,wEAAwE;QACxE,0EAA0E;QAC1E,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACnC,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,MAAM;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClC,2EAA2E;QAC3E,wDAAwD;QACxD,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5C,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;YACxB,KAAK,MAAM,CAAC,OAAO,EAAE,CAAA;QACvB,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,iBAAiB,EAAE,CAAA;QACzB,KAAK,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACxE,KAAK,CAAC,MAAM,EAAE,CAAA;QACd,yEAAyE;QACzE,oEAAoE;QACpE,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,KAAK,EAAE,EAAa,EAAiB,EAAE;QAC3D,MAAM,eAAe,EAAE,CAAA;QACvB,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,CAAC,KAAa,EAAQ,EAAE;QAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,MAAM,CAAC,oDAAoD,CAAC,CAAA;YAClE,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;YACvC,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;YACpD,MAAM,SAAS,CAAC,SAAS,CAAC,eAAe,UAAU,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;YAChE,IAAI,KAAK,KAAK,EAAE;gBAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACzC,KAAK,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAA;YACrC,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5B,KAAK,CAAC,MAAM,CAAC,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACpG,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED;;;;;OAKG;IACH,MAAM,gBAAgB,GAAG,GAAS,EAAE;QAClC,0EAA0E;QAC1E,wEAAwE;QACxE,oEAAoE;QACpE,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,KAAK,CAAC,MAAM,CAAC,oDAAoD,CAAC,CAAA;YAClE,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,0EAA0E;QAC1E,2EAA2E;QAC3E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,MAAM,GAAG,CAAC;gBACf,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,qEAAqE;gBAC5I,CAAC,CAAC,uFAAuF,CAC5F,CAAA;YACD,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,MAAM,EAAE,GAAG,aAAa,CAAA;QACxB,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,mEAAmE;YACnE,+DAA+D;YAC/D,MAAM,aAAa,CAAC,EAAE,CAAC,CAAA;YACvB,KAAK,CAAC,MAAM,CAAC,kEAAkE,CAAC,CAAA;YAChF,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACrE,KAAK,CAAC,MAAM,CAAC,qBAAqB,MAAM,0CAA0C,CAAC,CAAA;YACnF,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,CAAC,KAAa,EAAQ,EAAE;QAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,MAAM,CAAC,oDAAoD,CAAC,CAAA;YAClE,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,GAAG,aAAa,CAAA;YAC5B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;YAChD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;YAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,MAAM,CAAC,yDAAyD,CAAC,CAAA;gBACvE,KAAK,CAAC,MAAM,EAAE,CAAA;gBACd,OAAM;YACR,CAAC;YACD,MAAM,OAAO,GAAG,SAAS,CAAC,eAAe,UAAU,EAAE,EAAE,CAAC,CAAA;YACxD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;YACvC,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;YACpD,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;YACjG,IAAI,KAAK,KAAK,EAAE;gBAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACzC,KAAK,CAAC,MAAM,CAAC,eAAe,MAAM,aAAa,KAAK,CAAC,WAAW,MAAM,KAAK,CAAC,eAAe,YAAY,CAAC,CAAA;YACxG,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC5B,KAAK,CAAC,MAAM,CAAC,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACzF,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED;;;OAGG;IACH,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAQ,EAAE;QAC/C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,KAAK,CAAC,MAAM,CAAC,gEAAgE,CAAC,CAAA;YAC9E,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAsD,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,CAAA;QAC/G,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAA8F,CAAA;QACnI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,MAAM,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;YAClE,KAAK,CAAC,MAAM,CAAC,8EAA8E,CAAC,CAAA;YAC5F,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,OAAM;QACR,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC9C,KAAK,CAAC,MAAM,CAAC,uBAAuB,OAAO,QAAQ,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;QACtG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC7F,CAAC;QACD,KAAK,CAAC,MAAM,EAAE,CAAA;IAChB,CAAC,CAAA;IAED;;;;;OAKG;IACH,MAAM,OAAO,GAAG,CAAC,OAAmC,EAAE,KAAgB,EAAQ,EAAE;QAC9E,IAAI,OAAO,CAAC,EAAE,KAAK,aAAa;YAAE,OAAM;QACxC,4EAA4E;QAC5E,IAAK,KAA0B,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAC5D,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC/B,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,QAAQ,GAAG,IAAI,CAAA;YACf,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAA;QAC5D,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAA;YAC3E,QAAQ,GAAG,KAAK,CAAA;YAChB,aAAa,GAAG,SAAS,CAAA;YACzB,2DAA2D;YAC3D,KAAK,CAAC,WAAW,EAAE,CAAA;YACnB,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YACxD,IAAI,cAAc,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAAE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;YAC/G,wEAAwE;YACxE,2DAA2D;YAC3D,KAAK,CAAC,WAAW,EAAE,CAAA;QACrB,CAAC;QACD,wEAAwE;QACxE,kEAAkE;QAClE,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB;YAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC1D,CAAC,CAAA;IAED,iFAAiF;IACjF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,OAA8C,EAAgB,EAAE,CAC9F,GAAG,CAAC,EAAgG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEtH;;;;;OAKG;IACH,MAAM,eAAe,GAAG,GAA4B,EAAE,CAAC;QACrD,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE;YAClC,0EAA0E;YAC1E,yEAAyE;YACzE,uBAAuB;YACvB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;YACtD,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAM;YAChC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC5B,CAAC,CAAC;KACH,CAAA;IAED,OAAO;QACL,aAAa,EAAE,GAAG,EAAE,CAAC,aAAa;QAClC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;QACzB,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ;QAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QACjE,aAAa,EAAE,GAAG,EAAE,CAAC,aAAa;QAClC,aAAa;QACb,SAAS;QACT,eAAe;QACf,SAAS;QACT,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,cAAc;QACd,gBAAgB;QAChB,OAAO;QACP,eAAe;KAChB,CAAA;AACH,CAAC"}

package/lib/surface/session-picker.d.ts

@@ -0,0 +1,39 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import type { Keymap } from '../input/actions.ts';
+import { SessionPicker } from '../ui/picker.ts';
+/**
+ * What the stored-session owner needs from the surface that composes it.
+ *
+ * The keys are read at call time, because a settings edit while the list is
+ * open moves the chords its hints name; the picker operation is a port rather
+ * than an import, because the keyboard's lifetime belongs to the surface.
+ */
+export interface SessionPickerPorts {
+    readonly keymap: () => Keymap;
+    readonly notice: (text: string) => void;
+    readonly render: () => void;
+    /**
+     * Reject when this run cannot open that session under the mode it named.
+     *
+     * The composing surface owns what a mode is and which one this run named, so
+     * it decides when there is a disagreement to look for at all.
+     */
+    readonly validateStoredPreset: (id: string) => Promise<void>;
+    /** Take the keyboard for the list and answer with the id it settled on. */
+    readonly openPicker: (picker: SessionPicker, vet?: (id: string) => Promise<string | undefined>) => Promise<string | undefined>;
+}
+/** The one read the composing surface routes to this owner. */
+export interface SessionPickerChoice {
+    /** Which stored session to open, or undefined when the reader asked for none. */
+    readonly chooseSession: () => Promise<SessionId | undefined>;
+}
+/**
+ * The stored sessions a bare `--resume` asks the reader to choose between.
+ *
+ * The list is drawn by id before any log is opened: reading every title first
+ * would make the picker as slow as the slowest session, and a session whose
+ * log this build cannot read is still one the reader may want back.
+ */
+export declare function createSessionPicker(ctx: Context, ports: SessionPickerPorts): SessionPickerChoice;
+//# sourceMappingURL=session-picker.d.ts.map

package/lib/surface/session-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker.d.ts","sourceRoot":"","sources":["../../src/surface/session-picker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAQpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAY/C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,CACnB,MAAM,EAAE,aAAa,EACrB,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,KAC9C,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACjC;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAA;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA0FhG"}

package/lib/surface/session-picker.js

@@ -0,0 +1,107 @@
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { PICKER_LIMIT, createSessionHistory, readSessionTitle, } from "../agent/history.js";
+import { SessionPicker } from "../ui/picker.js";
+/**
+ * Titles read at once.
+ *
+ * Every title costs a log read, and the list is already on screen without them,
+ * so they are pipelined to keep the wait near the slowest log rather than the
+ * sum of them — bounded, because a hundred parallel reads is a disk storm the
+ * reader would feel elsewhere.
+ */
+const TITLE_CONCURRENCY = 4;
+/**
+ * The stored sessions a bare `--resume` asks the reader to choose between.
+ *
+ * The list is drawn by id before any log is opened: reading every title first
+ * would make the picker as slow as the slowest session, and a session whose
+ * log this build cannot read is still one the reader may want back.
+ */
+export function createSessionPicker(ctx, ports) {
+    /** Title the listed sessions without making the reader wait for the slowest log. */
+    const loadTitles = async (history, sessions, titles) => {
+        const queue = [...sessions];
+        const worker = async () => {
+            for (;;) {
+                const next = queue.shift();
+                if (next === undefined)
+                    return;
+                try {
+                    const title = await readSessionTitle(history, next);
+                    if (title === undefined)
+                        continue;
+                    titles.set(next.id, title);
+                    ports.render();
+                }
+                catch {
+                    // A log this build cannot read stays listed by id; the picker is not
+                    // the place to explain storage, and one bad session is not the list.
+                }
+            }
+        };
+        await Promise.all(Array.from({ length: TITLE_CONCURRENCY }, worker));
+    };
+    /**
+     * The stored list, or undefined after telling the reader why there is none.
+     *
+     * No storage, an empty history, and a listing that throws all end the same way
+     * — there is nothing to pick from — and none of them is worth ending the run
+     * over, so each is a notice rather than a failure.
+     */
+    const storedSessions = async () => {
+        const history = createSessionHistory(ctx);
+        if (history === undefined) {
+            ports.notice('this profile has no session storage, so there is nothing to resume');
+            ports.render();
+            return undefined;
+        }
+        try {
+            const sessions = await history.list(PICKER_LIMIT);
+            if (sessions.length === 0) {
+                ports.notice('no stored sessions to resume');
+                ports.render();
+                return undefined;
+            }
+            return { history, sessions };
+        }
+        catch (error) {
+            ports.notice(`could not list stored sessions: ${error instanceof Error ? error.message : String(error)}`);
+            ports.render();
+            return undefined;
+        }
+    };
+    /**
+     * Why this run cannot open a stored session, or undefined when it can.
+     *
+     * A session runs the mode its own log recorded, so a `--preset` that
+     * disagrees with it can only be refused: the picker asks first so the refusal
+     * lands in the list rather than after the terminal has been handed back.
+     */
+    const refuseReason = async (id) => {
+        try {
+            await ports.validateStoredPreset(id);
+            return undefined;
+        }
+        catch (error) {
+            return error instanceof Error ? error.message : String(error);
+        }
+    };
+    /**
+     * Take the keyboard for a picker.
+     *
+     * The list is already in hand, so the picker is interactive immediately while
+     * the titles that make its rows recognizable stream in behind it.
+     */
+    const askForSession = async (history, sessions) => {
+        const titles = new Map();
+        void loadTitles(history, sessions, titles);
+        const picked = await ports.openPicker(new SessionPicker(sessions, () => titles, undefined, ports.keymap), refuseReason);
+        return picked === undefined ? undefined : SessionId(picked);
+    };
+    const chooseSession = async () => {
+        const listed = await storedSessions();
+        return listed === undefined ? undefined : askForSession(listed.history, listed.sessions);
+    };
+    return { chooseSession };
+}
+//# sourceMappingURL=session-picker.js.map

package/lib/surface/session-picker.js.map

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

package/lib/surface/session-view.d.ts

@@ -0,0 +1,86 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { ForkEvent } from '../agent/fork.ts';
+import { type Keymap } from '../input/actions.ts';
+import { TranscriptModel } from '../transcript.ts';
+import { type WorkState } from '../work.ts';
+/** What the reader presses to leave a view they did not open. */
+export declare const backHint: (map: Keymap) => string;
+/**
+ * What the transcript owner needs from the surface that composes it.
+ *
+ * The identity, the cutoff and the scope are read at call time: all three can
+ * change between two folds, and a captured copy would fold — or degrade a card
+ * through — the session this terminal drove before the reader moved.
+ */
+export interface SessionViewPorts {
+    /** The session the transcript opens on, named by the run that launched this surface. */
+    readonly initialSession: SessionId;
+    /** The session this terminal drives: commands, approvals, and the bell belong to it. */
+    readonly drivenSession: () => SessionId;
+    /** Event index the transcript must not fold past while turns are hidden. */
+    readonly stagedCutoff: () => number | undefined;
+    /** The world a folded card reads its tool through; a stored session has none. */
+    readonly agentScope: (id: SessionId) => Agent | undefined;
+    /** A live session's own events, or undefined when this process does not run it. */
+    readonly liveEvents: (id: SessionId) => readonly ForkEvent[] | undefined;
+    readonly render: () => void;
+}
+/** The transcript on screen, and every read and operation the composing surface takes from it. */
+export interface SessionView {
+    /** The session the transcript is showing, which can be one of its children. */
+    readonly viewed: () => SessionId;
+    readonly viewingChild: () => boolean;
+    readonly notice: (message: string) => void;
+    readonly marker: (text: string) => void;
+    readonly reportError: (error: unknown) => void;
+    /** The model the transcript is drawn from, and what an export writes out. */
+    readonly model: TranscriptModel;
+    /** What the transcript folded: todos, the goal, and plan mode. */
+    readonly workState: () => WorkState;
+    /** Every event of a session, from memory when this process runs it. */
+    readonly sessionEvents: (id: SessionId) => Promise<readonly ForkEvent[]>;
+    /** The scope a folded card reads through. */
+    readonly setPresentScope: (scope: Agent | undefined) => void;
+    /**
+     * Drop that scope. Also the teardown disposer the composition root pushes.
+     *
+     * The presenter closure outlives the composition's own teardown, so it must
+     * not keep an agent alive after its world unwinds.
+     */
+    readonly clearPresentScope: () => void;
+    /** Start a fresh transcript: every reset revokes reads started for the previous view. */
+    readonly reset: () => () => boolean;
+    /** Show a session without folding it; the caller owns the fold that follows. */
+    readonly setViewed: (id: SessionId) => void;
+    /** Fold one session's history, or the driven one's through a staged cutoff. */
+    readonly fold: (id: SessionId, through?: number, current?: () => boolean) => Promise<number>;
+    /** Fold a stored log as a replay, which reports its own failure in a notice. */
+    readonly replay: (id: SessionId) => Promise<void>;
+    /** Show another session in the transcript without leaving the one this terminal drives. */
+    readonly show: (id: SessionId) => Promise<void>;
+    /** Come back to the transcript of the session this terminal drives. */
+    readonly showDriven: () => Promise<void>;
+    /** The viewed half of one durable event: the fold and the repaint it earns. */
+    readonly observe: (id: SessionId, event: ForkEvent) => void;
+    /**
+     * Register the two listeners that follow the viewed agent's own stream.
+     *
+     * They are returned rather than pushed here so the composition root keeps one
+     * ordered list of teardowns, which is unwound in reverse registration order.
+     */
+    readonly agentListeners: () => readonly (() => void)[];
+}
+/**
+ * The transcript on screen: what is drawn, and never which agent is driven.
+ *
+ * The model, the work fold and the identity they are folded for are one owner
+ * because the reader's view is one thing: a durable event reaches both folds,
+ * and a switch of identity resets both. What this owner drives — the agent, its
+ * staged cutoff, and the terminal it paints — stays with the surface that
+ * composes it, so a reader can watch a child's conversation without moving the
+ * commands, the approvals, or the bell.
+ */
+export declare function createSessionView(ctx: Context, ports: SessionViewPorts): SessionView;
+//# sourceMappingURL=session-view.d.ts.map

package/lib/surface/session-view.d.ts.map

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