@sagmans/dsh-tui 0.6.0 → 0.8.0

package/lib/surface/prompt-memory.d.ts

@@ -0,0 +1,76 @@
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { Keymap } from '../input/actions.ts';
+import { PromptStash } from '../stash.ts';
+import type { TuiTheme } from '../theme.ts';
+import type { GhostBrush } from '../ui/editor.ts';
+import type { PickerAction, PickerCard } from '../ui/picker.ts';
+/**
+ * What a list has to answer to be driven by whoever owns the keyboard.
+ *
+ * This owner raises the lists and hands them over; the overlay they are drawn
+ * in, the vetting of a pick, and how long a list may hold the keyboard stay
+ * with the modal owner, which is why they arrive as a port.
+ */
+export interface MemoryPicker {
+    handleKey(data: string): PickerAction | undefined;
+    card(window?: number): PickerCard;
+    setNote(text: string | undefined): void;
+}
+/**
+ * What the prompt's memory needs from the surface that composes it.
+ *
+ * The history switches are read at call time rather than captured: the
+ * settings document is hot-reloaded, and a copy taken here would pin this
+ * surface to the settings of the day it loaded. The theme is read through its
+ * delegate for the same reason, and the editor and the picker are ports
+ * because the widget and the keyboard lifetime are the surface's own.
+ */
+export interface PromptMemoryPorts {
+    readonly historyEnabled: () => boolean;
+    readonly historyGhost: () => boolean;
+    readonly historyMaxEntries: () => number;
+    readonly theme: TuiTheme;
+    readonly keymap: () => Keymap;
+    readonly notice: (message: string) => void;
+    readonly render: () => void;
+    /** The draft as written, with a pasted block expanded back to its text. */
+    readonly editorText: () => string;
+    readonly setEditorText: (text: string) => void;
+    /** Whether the prompt bar belongs to the reader rather than to a question. */
+    readonly editorAvailable: () => boolean;
+    /** The session this surface drives, which is the one its drafts belong to. */
+    readonly activeSession: () => SessionId;
+    readonly openPicker: (picker: MemoryPicker) => Promise<string | undefined>;
+}
+/** The prompt's memory of itself, and the operations the surface routes to it. */
+export interface PromptMemory {
+    /** The dimmed completion the editor draws from recorded prompts. */
+    readonly ghostBrush: GhostBrush;
+    /** Reverse search over recorded prompts, seeded with whatever is in the bar. */
+    readonly openHistoryPicker: () => Promise<void>;
+    /** Record a submitted line; the setting decides whether any of it is kept. */
+    readonly record: (text: string) => void;
+    /** Show where history is kept, or forget it; the file is global to this machine. */
+    readonly runHistoryCommand: (argument: string) => void;
+    /**
+     * Build the bank for the session this surface drives, and hand it back.
+     *
+     * Handed back rather than kept here alone: the surface's status count and the
+     * parked-draft commands it routes read the same instance, and both exist
+     * before a pick could reach a picker — which is why the bank cannot be built
+     * with the rest of this owner.
+     */
+    readonly buildStash: () => PromptStash;
+    /** Follow the session just opened, so the footer counts that session's drafts. */
+    readonly sessionOpened: () => void;
+}
+/**
+ * The memory the prompt keeps of what was typed, and what it offers back.
+ *
+ * Two stores, one subject: the prompt history is global and written from every
+ * submitted line, while the stash parks a draft for the session in force. Both
+ * are read through the same editor and both answer in a list, so they share the
+ * one owner that knows what the reader is looking at.
+ */
+export declare function createPromptMemory(ports: PromptMemoryPorts): PromptMemory;
+//# sourceMappingURL=prompt-memory.d.ts.map

package/lib/surface/prompt-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-memory.d.ts","sourceRoot":"","sources":["../../src/surface/prompt-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAM/D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IACjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;CACxC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAA;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,CAAA;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,MAAM,SAAS,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAC3E;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,oFAAoF;IACpF,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACtD;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,WAAW,CAAA;IACtC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA0JzE"}

package/lib/surface/prompt-memory.js

@@ -0,0 +1,167 @@
+import { createPromptHistory } from "../agent/prompt-history.js";
+import { ghostSuffix } from "../input/ghost.js";
+import { PromptStash } from "../stash.js";
+import { resetSequence } from "../theme-resolver.js";
+import { TUI_SETTINGS_NAMESPACE } from "../theme-settings.js";
+import { HistoryPicker } from "../ui/history-picker.js";
+import { confirmedClear, StashConfirmPicker, StashPicker } from "../ui/stash-picker.js";
+/** Reverse video for the cell the cursor occupies, so a ghost keeps the cursor visible. */
+const GHOST_CURSOR_PREFIX = '\u001b[7m';
+/**
+ * The memory the prompt keeps of what was typed, and what it offers back.
+ *
+ * Two stores, one subject: the prompt history is global and written from every
+ * submitted line, while the stash parks a draft for the session in force. Both
+ * are read through the same editor and both answer in a list, so they share the
+ * one owner that knows what the reader is looking at.
+ */
+export function createPromptMemory(ports) {
+    /**
+     * The reader's prompt history: global across projects, recorded from every
+     * submitted line, and offered back as they type. Built before the bar exists
+     * so its first load cannot race the first suggestion.
+     */
+    const promptHistory = createPromptHistory({
+        cap: () => ports.historyMaxEntries(),
+        warn: message => {
+            ports.notice(message);
+            ports.render();
+        },
+    });
+    /**
+     * The dimmed completion drawn from recorded prompts.
+     *
+     * Colour is the affordance: with styling off the suggestion would be
+     * unreadable text the reader could still accept, which is worse than none.
+     * The cursor cell is also reversed so the cursor stays visible on the ghost.
+     */
+    const ghostBrush = {
+        enabled: () => ports.historyEnabled() && ports.historyGhost() && ports.theme.color && ports.theme.visible('editor.ghost'),
+        suggestion: input => ghostSuffix({ entries: promptHistory.entries(), ...input }),
+        paint: (text, cell) => {
+            const styled = ports.theme.style('editor.ghost', text);
+            return cell === 'cursor' ? GHOST_CURSOR_PREFIX + styled + resetSequence() : styled;
+        },
+    };
+    /**
+     * The bank the surface asked for, as this owner's own reference to it.
+     *
+     * Late-bound because the surface builds it where a pick can reach a picker:
+     * this reference exists before the bank does, and a session opened before
+     * then has none to follow.
+     */
+    let stash;
+    /**
+     * Reverse search over recorded prompts, seeded with whatever is in the bar.
+     *
+     * A pick replaces the draft; a cancel leaves it exactly as it was, because the
+     * list was opened to look rather than to lose what is already typed.
+     */
+    const openHistoryPicker = async () => {
+        if (!ports.historyEnabled()) {
+            ports.notice('prompt history is disabled in ' + TUI_SETTINGS_NAMESPACE + ' settings');
+            ports.render();
+            return;
+        }
+        if (promptHistory.entries().length === 0) {
+            const blocked = promptHistory.blockedReason();
+            ports.notice(blocked === undefined ? 'no prompt history yet' : 'prompt history is unavailable: ' + blocked);
+            ports.render();
+            return;
+        }
+        // The expanded text is what the reader wrote; a large paste sits in the bar
+        // as a marker, and seeding with it would filter out the prompt it came from.
+        const picked = await ports.openPicker(new HistoryPicker(() => promptHistory.entries(), ports.editorText(), () => ports.keymap()));
+        if (picked === undefined)
+            return;
+        ports.setEditorText(picked);
+        ports.render();
+    };
+    /** Show where history is kept, or forget it; the file is global to this machine. */
+    const runHistoryCommand = (argument) => {
+        // The line that asked for this is recorded before the command runs, but that
+        // write rides the store's queue; waiting for it lets the count describe the
+        // file the reader has, not the state before their own line landed.
+        void promptHistory.flush().then(() => {
+            if (argument === '') {
+                const count = promptHistory.entries().length;
+                const blocked = promptHistory.blockedReason();
+                ports.notice([
+                    count + (count === 1 ? ' prompt recorded' : ' prompts recorded'),
+                    promptHistory.path(),
+                    blocked === undefined ? undefined : 'writes disabled: ' + blocked,
+                ].filter(part => part !== undefined).join(' · '));
+                ports.render();
+                return;
+            }
+            if (argument !== 'clear') {
+                ports.notice('usage: /history shows where history is kept · /history clear forgets every prompt');
+                ports.render();
+                return;
+            }
+            // A refused write cannot remove anything, so saying "forgot 0 prompts"
+            // would describe a successful clear the file never had.
+            const blocked = promptHistory.blockedReason();
+            if (blocked !== undefined) {
+                ports.notice('prompt history is unavailable: ' + blocked);
+                ports.render();
+                return;
+            }
+            return promptHistory.clear().then(removed => {
+                ports.notice('forgot ' + removed + (removed === 1 ? ' prompt' : ' prompts'));
+                ports.render();
+            });
+        }).catch(error => {
+            // The store keeps what the file still holds, so the reader is told the
+            // clear failed rather than being shown a count that never landed.
+            ports.notice('could not clear prompt history: ' + (error instanceof Error ? error.message : String(error)));
+            ports.render();
+        });
+    };
+    /**
+     * The prompt bank for the session this surface drives.
+     *
+     * The surface owns the editor, the picker, and the notices, so the bank is
+     * handed the few things it needs to reach them and nothing else: the commands
+     * stay free of terminal state and are exercised without one in the tests.
+     */
+    const buildStash = () => {
+        stash = new PromptStash({
+            getEditorText: () => ports.editorText(),
+            setEditorText: text => ports.setEditorText(text),
+            editorIsAvailable: () => ports.editorAvailable(),
+            notice: message => ports.notice(message),
+            pick: (entries, label) => ports.openPicker(new StashPicker(entries, label, () => ports.keymap())),
+            confirm: async (count) => confirmedClear(await ports.openPicker(new StashConfirmPicker(count, () => ports.keymap()))),
+            render: () => ports.render(),
+        }, 
+        // The bank follows the session this surface drives, not the directory it
+        // runs in: two terminals in one checkout keep separate drafts, and a resume
+        // finds the ones it parked. Read per command so a switch retargets it.
+        { sessionId: () => String(ports.activeSession()) });
+        return stash;
+    };
+    /**
+     * Follow the session the surface has just opened.
+     *
+     * The bank follows the session, so the footer stops counting the drafts of
+     * the session just left and the next command reads this session's file.
+     */
+    const sessionOpened = () => {
+        void stash?.open();
+    };
+    /** Record a submitted line, when the reader has recording on at all. */
+    const record = (text) => {
+        if (ports.historyEnabled())
+            promptHistory.record(text);
+    };
+    return {
+        ghostBrush,
+        openHistoryPicker,
+        record,
+        runHistoryCommand,
+        buildStash,
+        sessionOpened,
+    };
+}
+//# sourceMappingURL=prompt-memory.js.map

package/lib/surface/prompt-memory.js.map

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

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

@@ -0,0 +1,120 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { type ForkEvent } from '../agent/fork.ts';
+import { type ForkInheritance, type TuiAgent } from '../agent/host.ts';
+import type { HerdrReporter } from '../herdr/reporter.ts';
+/** The session this process runs, as much of it as a driven read needs. */
+export interface LiveSession {
+    /** The events this process holds unflushed, which storage alone does not. */
+    readonly snapshotEvents?: () => readonly ForkEvent[];
+}
+/**
+ * What the session's lifecycle owner needs from the surface that composes it.
+ *
+ * Every read is taken at call time: the session, the scrollback and the queue
+ * all move while a transition settles, and a captured copy would name the
+ * session this terminal drove before the reader moved.
+ */
+export interface SessionLifecyclePorts {
+    /** The session this run was launched for; another is reached only by switching. */
+    readonly initialSession: SessionId;
+    /** The route this run was launched with: the model, and the provider it names. */
+    readonly model: string | undefined;
+    readonly provider: string | undefined;
+    /** Whether this run rings for a turn that ran long enough. */
+    readonly bell: boolean;
+    /** The mode a session takes, settled before the transcript is touched. */
+    readonly presetFor: (id: SessionId, resume: boolean, fork: ForkInheritance | undefined) => Promise<string | undefined>;
+    /** Install the session's own route; the world the preset mounts reads it back. */
+    readonly installModelChoice: (agentCtx: Context) => void;
+    /** Mount the mode a new session runs into the agent's own scope. */
+    readonly mountPreset: (agentCtx: Context, preset: string) => Promise<void>;
+    /** The live session this process runs, which is the only source holding the queue. */
+    readonly liveSession: (id: SessionId) => LiveSession | undefined;
+    /** Re-arm the bar's completion against the world the new agent mounted. */
+    readonly installCompletion: () => void;
+    /** Every event of a session, which a fork cut is derived from. */
+    readonly sessionEvents: (id: SessionId) => Promise<readonly ForkEvent[]>;
+    /** Show a session without folding it; the open owns the fold that follows. */
+    readonly setViewed: (id: SessionId) => void;
+    /** The scope a folded card reads its tool through. */
+    readonly setPresentScope: (scope: Agent | undefined) => void;
+    /** Drop that scope; the outgoing agent is torn down after it. */
+    readonly clearPresentScope: () => void;
+    readonly resetTranscript: () => void;
+    readonly replay: (id: SessionId) => Promise<void>;
+    readonly fold: (id: SessionId) => Promise<number>;
+    readonly notice: (message: string) => void;
+    readonly render: () => void;
+    /** The prompt memory's per-session reset, taken when a session is really opened. */
+    readonly promptMemorySessionOpened: () => void;
+    /** The staged owner's fresh cursor for the session just opened. */
+    readonly stagedSessionOpened: (id: SessionId) => void;
+    /** The turn/end an undo may be parked waiting for. */
+    readonly turnSettled: () => void;
+    /** The parent's catalog names the child; lifecycle events carry only its id. */
+    readonly acceptCatalog: (info: unknown) => void;
+    /** Drop the roster of the session a transition lets go of. */
+    readonly resetRoster: () => void;
+    /** A job the turn started may have settled while the reader watched elsewhere. */
+    readonly refreshJobs: () => void;
+    /** The pane's agent row, which hears the driver rather than each turn. */
+    readonly herdr: HerdrReporter;
+    /** Write to the tty, but only while this surface owns it. */
+    readonly writeTerminal: (text: string) => void;
+    /** Whether the exit has begun, which mutes the bell. */
+    readonly exiting: () => boolean;
+    /** The surface's teardowns, in the order they are registered. */
+    readonly disposers: Array<() => void>;
+}
+/** The agent this terminal drives, and every read or operation the composer takes from it. */
+export interface SessionLifecycle {
+    /** The session this surface drives: commands, approvals, and the bell belong to it. */
+    readonly activeSession: () => SessionId;
+    /** The agent in service, or undefined while a transition creates the next one. */
+    readonly drivingAgent: () => TuiAgent | undefined;
+    /** Whether a turn is open, which the clock, the title and the bell read. */
+    readonly turnRunning: () => boolean;
+    /** What the running-state clock reports: a turn, and when it started. */
+    readonly activity: () => {
+        readonly running: boolean;
+        readonly startedAt: number | undefined;
+    };
+    /** Whether a session was really opened, which is what an exit hint can name. */
+    readonly sessionOpened: () => boolean;
+    /** The prompts queued on the driven agent, which an interrupt would drop. */
+    readonly queuedPrompts: () => readonly string[];
+    /** Stop the clock that repaints a running turn; an exit does not wait for it. */
+    readonly stopClock: () => void;
+    /**
+     * Stop the agent in service and let go of what it projected: the handle and its
+     * projections go before the world they name is torn down, and the stop is
+     * awaited so the next agent joins a surface nothing is still writing to.
+     */
+    readonly disposeOutgoing: () => Promise<void>;
+    /** Start the agent for a session, which is what a replacement joins. */
+    readonly openAgent: (id: SessionId, resume: boolean, fork?: ForkInheritance) => Promise<TuiAgent>;
+    /** Move the surface to another stored session without leaving the terminal. */
+    readonly switchSession: (id: SessionId) => Promise<void>;
+    /** Start a fresh session without leaving the terminal. */
+    readonly runNewCommand: (title: string) => void;
+    /** Compose this session's agent again without leaving the conversation. */
+    readonly runReloadCommand: () => void;
+    /**
+     * Branch this conversation and continue in the branch: a real session that
+     * inherits a prefix of this one, cut at the last completed turn because half an
+     * exchange is not a state to hand a model.
+     */
+    readonly runForkCommand: (title: string) => void;
+    /** Give this session a title. */
+    readonly runRenameCommand: (title: string) => void;
+    /** The driven half of one durable event; the caller folds the viewed half. */
+    readonly observe: (session: {
+        readonly id: SessionId;
+    }, event: ForkEvent) => void;
+    /** The listeners that follow the driver rather than each turn. */
+    readonly driverListeners: () => readonly (() => void)[];
+}
+export declare function createSessionLifecycle(ctx: Context, ports: SessionLifecyclePorts): SessionLifecycle;
+//# sourceMappingURL=session-lifecycle.d.ts.map

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

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