@prestyj/cli 4.3.210 → 4.3.238

package/dist/ui/hooks/useSessionPersistence.d.ts

@@ -0,0 +1,34 @@
+import { type MutableRefObject } from "react";
+import type { Message, Provider } from "@prestyj/ai";
+import type { SessionManager } from "../../core/session-manager.js";
+import type { SessionStats } from "../session-summary.js";
+/** Minimal session-store surface the persistence layer mirrors into. */
+interface PersistenceSessionStore {
+    messages: Message[];
+    sessionPath?: string;
+    sessionId?: string;
+}
+interface UseSessionPersistenceOptions {
+    sessionManagerRef: MutableRefObject<SessionManager | null>;
+    sessionPathRef: MutableRefObject<string | undefined>;
+    sessionStatsRef: MutableRefObject<SessionStats>;
+    persistedIndexRef: MutableRefObject<number>;
+    messagesRef: MutableRefObject<Message[]>;
+    cwdRef: MutableRefObject<string>;
+    currentProvider: Provider;
+    currentModel: string;
+    sessionStore?: PersistenceSessionStore;
+}
+export interface SessionPersistence {
+    appendMessagesToSession: (sessionPath: string, messages: readonly Message[], startIndex: number) => Promise<void>;
+    persistCompactedSession: (compactedMessages: readonly Message[]) => Promise<void>;
+    persistNewMessages: () => Promise<void>;
+}
+/**
+ * Owns session message persistence: appending new turn messages, persisting a
+ * compacted checkpoint, and keeping `persistedIndexRef`/`sessionStatsRef`/the
+ * session store in sync. Extracted verbatim from `App.tsx`.
+ */
+export declare function useSessionPersistence({ sessionManagerRef, sessionPathRef, sessionStatsRef, persistedIndexRef, messagesRef, cwdRef, currentProvider, currentModel, sessionStore, }: UseSessionPersistenceOptions): SessionPersistence;
+export {};
+//# sourceMappingURL=useSessionPersistence.d.ts.map

package/dist/ui/hooks/useSessionPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionPersistence.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useSessionPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,wEAAwE;AACxE,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,4BAA4B;IACpC,iBAAiB,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3D,cAAc,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrD,eAAe,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAChD,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5C,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,eAAe,EAAE,QAAQ,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,uBAAuB,EAAE,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,uBAAuB,EAAE,CAAC,iBAAiB,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,eAAe,EACf,YAAY,EACZ,YAAY,GACb,EAAE,4BAA4B,GAAG,kBAAkB,CA+DnD"}

package/dist/ui/hooks/useSessionPersistence.js

@@ -0,0 +1,67 @@
+import { useCallback } from "react";
+import { appendMessagesToSession as appendSessionMessages, createCompactedSessionCheckpoint, } from "../../core/session-compaction.js";
+import { log } from "../../core/logger.js";
+/**
+ * Owns session message persistence: appending new turn messages, persisting a
+ * compacted checkpoint, and keeping `persistedIndexRef`/`sessionStatsRef`/the
+ * session store in sync. Extracted verbatim from `App.tsx`.
+ */
+export function useSessionPersistence({ sessionManagerRef, sessionPathRef, sessionStatsRef, persistedIndexRef, messagesRef, cwdRef, currentProvider, currentModel, sessionStore, }) {
+    const appendMessagesToSession = useCallback(async (sessionPath, messages, startIndex) => {
+        const sm = sessionManagerRef.current;
+        if (!sm)
+            return;
+        await appendSessionMessages(sm, sessionPath, messages, startIndex);
+    }, [sessionManagerRef]);
+    const persistCompactedSession = useCallback(async (compactedMessages) => {
+        const sm = sessionManagerRef.current;
+        if (!sm)
+            return;
+        const session = await createCompactedSessionCheckpoint(sm, {
+            cwd: cwdRef.current,
+            provider: currentProvider,
+            model: currentModel,
+            messages: compactedMessages,
+        });
+        sessionPathRef.current = session.path;
+        sessionStatsRef.current.sessionId = session.id;
+        persistedIndexRef.current = compactedMessages.length;
+        if (sessionStore) {
+            sessionStore.sessionPath = session.path;
+            sessionStore.sessionId = session.id;
+            sessionStore.messages = [...compactedMessages];
+        }
+        log("INFO", "compaction", "Persisted compacted session checkpoint", { path: session.path });
+    }, [
+        currentModel,
+        currentProvider,
+        sessionStore,
+        sessionManagerRef,
+        sessionPathRef,
+        sessionStatsRef,
+        persistedIndexRef,
+        cwdRef,
+    ]);
+    const persistNewMessages = useCallback(async () => {
+        const sp = sessionPathRef.current;
+        if (!sp)
+            return;
+        const allMsgs = messagesRef.current;
+        await appendMessagesToSession(sp, allMsgs, persistedIndexRef.current);
+        persistedIndexRef.current = allMsgs.length;
+        if (sessionStore) {
+            sessionStore.messages = [...allMsgs];
+            sessionStore.sessionPath = sp;
+            sessionStore.sessionId = sessionStatsRef.current.sessionId;
+        }
+    }, [
+        appendMessagesToSession,
+        sessionStore,
+        sessionPathRef,
+        messagesRef,
+        persistedIndexRef,
+        sessionStatsRef,
+    ]);
+    return { appendMessagesToSession, persistCompactedSession, persistNewMessages };
+}
+//# sourceMappingURL=useSessionPersistence.js.map

package/dist/ui/hooks/useSessionPersistence.js.map

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

package/dist/ui/hooks/useTaskPickerController.d.ts

@@ -0,0 +1,19 @@
+import { type TaskListItem } from "../../core/task-store.js";
+interface UseTaskPickerControllerOptions {
+    displayedCwd: string;
+    onStartTask: (title: string, prompt: string, taskId: string) => void;
+    onRunAllTasksChange: (runAll: boolean) => void;
+}
+interface TaskPickerController {
+    open: boolean;
+    tasks: TaskListItem[];
+    close: () => void;
+    openPicker: () => void;
+    toggle: () => void;
+    start: (task: TaskListItem) => void;
+    runAll: (task?: TaskListItem) => void;
+    deleteTask: (task: TaskListItem) => void;
+}
+export declare function useTaskPickerController({ displayedCwd, onStartTask, onRunAllTasksChange, }: UseTaskPickerControllerOptions): TaskPickerController;
+export {};
+//# sourceMappingURL=useTaskPickerController.d.ts.map

package/dist/ui/hooks/useTaskPickerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTaskPickerController.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTaskPickerController.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAElC,UAAU,8BAA8B;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1C;AAED,wBAAgB,uBAAuB,CAAC,EACtC,YAAY,EACZ,WAAW,EACX,mBAAmB,GACpB,EAAE,8BAA8B,GAAG,oBAAoB,CAoDvD"}

package/dist/ui/hooks/useTaskPickerController.js

@@ -0,0 +1,41 @@
+import { useCallback, useState } from "react";
+import { getNextPendingTask, loadTasksSync, markTaskInProgress, saveTasksSync, } from "../../core/task-store.js";
+export function useTaskPickerController({ displayedCwd, onStartTask, onRunAllTasksChange, }) {
+    const [open, setOpen] = useState(false);
+    const [tasks, setTasks] = useState(() => loadTasksSync(displayedCwd));
+    const refresh = useCallback(() => setTasks(loadTasksSync(displayedCwd)), [displayedCwd]);
+    const close = useCallback(() => setOpen(false), []);
+    const openPicker = useCallback(() => {
+        setTasks(loadTasksSync(displayedCwd));
+        setOpen(true);
+    }, [displayedCwd]);
+    const toggle = useCallback(() => {
+        setTasks(loadTasksSync(displayedCwd));
+        setOpen((current) => !current);
+    }, [displayedCwd]);
+    const start = useCallback((task) => {
+        setOpen(false);
+        markTaskInProgress(displayedCwd, task.id);
+        refresh();
+        onStartTask(task.title, task.prompt, task.id);
+    }, [displayedCwd, onStartTask, refresh]);
+    const runAll = useCallback((task) => {
+        setOpen(false);
+        onRunAllTasksChange(true);
+        const selected = task
+            ? { id: task.id, title: task.title, prompt: task.prompt || task.text || task.title }
+            : getNextPendingTask(displayedCwd);
+        if (!selected)
+            return;
+        markTaskInProgress(displayedCwd, selected.id);
+        refresh();
+        onStartTask(selected.title, selected.prompt, selected.id);
+    }, [displayedCwd, onRunAllTasksChange, onStartTask, refresh]);
+    const deleteTask = useCallback((task) => {
+        const nextTasks = loadTasksSync(displayedCwd).filter((candidate) => candidate.id !== task.id);
+        saveTasksSync(displayedCwd, nextTasks);
+        setTasks(nextTasks);
+    }, [displayedCwd]);
+    return { open, tasks, close, openPicker, toggle, start, runAll, deleteTask };
+}
+//# sourceMappingURL=useTaskPickerController.js.map

package/dist/ui/hooks/useTaskPickerController.js.map

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

package/dist/ui/hooks/useTerminalSize.d.ts

@@ -12,17 +12,21 @@ interface TerminalSizeValue {
  * or App.tsx) to avoid the MaxListenersExceededWarning that occurs when
  * every component independently listens for resize events.
  */
-export declare function TerminalSizeProvider({ children, isAgentRunning, }: React.PropsWithChildren<{
+export declare function TerminalSizeProvider({ children, isAgentRunning, fullscreen, }: React.PropsWithChildren<{
     /**
      * Optional getter — when it returns true, the resize debounce skips its
-     * screen clear and resizeKey bump. The screen clear + remount would force
-     * <Static> to re-print every history item, which (combined with Ink's
-     * stale log-update line count) collides with the live area's erase step
-     * and produces duplicate/missing items. During an agent run, the deferred
-     * resetUI() in App.tsx cleans up reflow drift the moment the agent goes
-     * idle, so the visual cost of skipping here is minimal.
+     * resizeKey bump while the agent is running. The deferred resetUI() in
+     * App.tsx cleans up reflow drift the moment the agent goes idle, so the
+     * visual cost of skipping here is minimal.
      */
     isAgentRunning?: () => boolean;
+    /**
+     * Fullscreen alt-screen mode. Ink owns the whole screen and repaints the
+     * full-height frame in place, so on resize we only re-measure dimensions —
+     * no manual screen clear (which would flash) and no resizeKey bump (the
+     * full-height layout reflows on the dimension change alone).
+     */
+    fullscreen?: boolean;
 }>): React.FunctionComponentElement<React.ProviderProps<TerminalSizeValue | null>>;
 /**
  * Returns { columns, rows, resizeKey } from the nearest TerminalSizeProvider.
@@ -32,9 +36,8 @@ export declare function TerminalSizeProvider({ children, isAgentRunning, }: Reac
  * trigger React re-renders on every resize event while Ink's internal
  * line-tracking still assumes the old width, causing ghost/duplicate renders.
  *
- * `resizeKey` can be used as a React `key` to force a full remount — this
- * is the only reliable way to make Ink re-render <Static> content that was
- * already printed to scrollback and got corrupted by terminal text reflow.
+ * `resizeKey` can be used as a React `key` to force live-area remounts after
+ * terminal dimensions settle.
  */
 export declare function useTerminalSize(): TerminalSizeValue;
 export {};

package/dist/ui/hooks/useTerminalSize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTerminalSize.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminalSize.ts"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAC;AAGnG,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,cAAc,GACf,EAAE,KAAK,CAAC,iBAAiB,CAAC;IACzB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;CAChC,CAAC,iFA+DD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,sBAM9B"}
+{"version":3,"file":"useTerminalSize.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminalSize.ts"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAC;AAGnG,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,cAAc,EACd,UAAkB,GACnB,EAAE,KAAK,CAAC,iBAAiB,CAAC;IACzB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC,iFAmED;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,sBAM9B"}

package/dist/ui/hooks/useTerminalSize.js

@@ -15,7 +15,7 @@ const TerminalSizeContext = createContext(null);
  * or App.tsx) to avoid the MaxListenersExceededWarning that occurs when
  * every component independently listens for resize events.
  */
-export function TerminalSizeProvider({ children, isAgentRunning, }) {
+export function TerminalSizeProvider({ children, isAgentRunning, fullscreen = false, }) {
     const { stdout } = useStdout();
     const [size, setSize] = useState({
         columns: Math.max(MIN_COLUMNS, stdout?.columns ?? 80),
@@ -39,30 +39,36 @@ export function TerminalSizeProvider({ children, isAgentRunning, }) {
         debounceRef.current = setTimeout(() => {
             const running = isAgentRunningRef.current?.() ?? false;
             if (running) {
-                // Update dimensions only — skip the screen clear + resizeKey bump.
-                // Re-printing <Static> here collides with the live area's stale
-                // erase step and produces the duplicate/wiped items the user saw.
-                // render.ts flags pendingResetUI; App.tsx fires a clean resetUI()
-                // the moment the agent goes idle, fixing any reflow drift then.
+                // Update dimensions only — skip the resizeKey bump. render.ts flags
+                // pendingResetUI; App.tsx fires a clean resetUI() the moment the agent
+                // goes idle, fixing any reflow drift then.
                 setSize({
                     columns: Math.max(MIN_COLUMNS, stdout.columns ?? 80),
                     rows: Math.max(MIN_ROWS, stdout.rows ?? 24),
                 });
                 return;
             }
-            // Clear visible screen + scrollback to remove deformed ghost renders
-            // left behind by Ink re-rendering at different terminal widths during
-            // a resize drag.
-            stdout.write("\x1b[2J" + // clear visible screen
-                "\x1b[3J" + // clear scrollback buffer
-                "\x1b[H");
+            if (fullscreen) {
+                // Alt screen: re-measure only. The full-height frame reflows to the new
+                // dimensions on this state change; Ink repaints it in place with no
+                // native scrollback to disturb, so there's nothing to clear.
+                setSize({
+                    columns: Math.max(MIN_COLUMNS, stdout.columns ?? 80),
+                    rows: Math.max(MIN_ROWS, stdout.rows ?? 24),
+                });
+                return;
+            }
+            // Clear visible screen only. Completed chat rows are real terminal
+            // scrollback now; preserve them while dropping malformed live frames left
+            // behind by resize reflow.
+            stdout.write("\x1b[2J\x1b[H");
             setSize({
                 columns: Math.max(MIN_COLUMNS, stdout.columns ?? 80),
                 rows: Math.max(MIN_ROWS, stdout.rows ?? 24),
             });
             setResizeKey((k) => k + 1);
         }, 300);
-    }, [stdout]);
+    }, [stdout, fullscreen]);
     useEffect(() => {
         if (!stdout)
             return;
@@ -84,9 +90,8 @@ export function TerminalSizeProvider({ children, isAgentRunning, }) {
  * trigger React re-renders on every resize event while Ink's internal
  * line-tracking still assumes the old width, causing ghost/duplicate renders.
  *
- * `resizeKey` can be used as a React `key` to force a full remount — this
- * is the only reliable way to make Ink re-render <Static> content that was
- * already printed to scrollback and got corrupted by terminal text reflow.
+ * `resizeKey` can be used as a React `key` to force live-area remounts after
+ * terminal dimensions settle.
  */
 export function useTerminalSize() {
     const ctx = useContext(TerminalSizeContext);

package/dist/ui/hooks/useTerminalSize.js.map

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

package/dist/ui/hooks/useTranscriptHistory.d.ts

@@ -0,0 +1,48 @@
+import { type SessionManager } from "../../core/session-manager.js";
+import type { CompletedItem } from "../app-items.js";
+import type { TerminalHistoryContext } from "../terminal-history.js";
+interface TranscriptHistoryItem {
+    id: string;
+    kind: string;
+}
+interface SessionStoreLike<TItem extends TranscriptHistoryItem> {
+    history?: TItem[];
+    liveItems?: TItem[];
+}
+interface TranscriptHistoryPrinter<TItem extends TranscriptHistoryItem> {
+    print(items: readonly TItem[], context: TerminalHistoryContext, options?: {
+        force?: boolean;
+        write?: (data: string) => void;
+    }): void;
+    clear(): void;
+}
+interface UseTranscriptHistoryOptions<TItem extends TranscriptHistoryItem> {
+    terminalHistoryPrinter?: TranscriptHistoryPrinter<TItem>;
+    terminalHistoryContext: TerminalHistoryContext;
+    writeStdout: (data: string) => void;
+    sessionPathRef: React.RefObject<string | undefined>;
+    sessionManagerRef: React.RefObject<SessionManager | null>;
+    sessionStore?: SessionStoreLike<TItem>;
+    history: readonly TItem[];
+    setHistory: React.Dispatch<React.SetStateAction<TItem[]>>;
+    setLiveItems: React.Dispatch<React.SetStateAction<TItem[]>>;
+    compactHistoryItems?: (items: TItem[]) => TItem[];
+    persistDisplayItem?: (item: TItem) => unknown;
+    trimFlushItems?: (items: TItem[]) => TItem[];
+}
+export interface UseTranscriptHistoryResult<TItem extends TranscriptHistoryItem> {
+    pendingHistoryFlushRef: React.RefObject<TItem[]>;
+    streamedAssistantFlushRef: React.RefObject<{
+        flushedChars: number;
+        text: string;
+    }>;
+    printHistoryItems: (items: readonly TItem[], options?: {
+        force?: boolean;
+    }) => void;
+    queueFlush: (items: TItem[]) => void;
+    finalizeSubmittedUserItem: (item: TItem, deferredLiveItems?: readonly TItem[]) => void;
+    clearPendingHistory: () => void;
+}
+export declare function useTranscriptHistory<TItem extends TranscriptHistoryItem = CompletedItem>({ terminalHistoryPrinter, terminalHistoryContext, writeStdout, sessionPathRef, sessionManagerRef, sessionStore, history, setHistory, setLiveItems, compactHistoryItems, persistDisplayItem, trimFlushItems, }: UseTranscriptHistoryOptions<TItem>): UseTranscriptHistoryResult<TItem>;
+export {};
+//# sourceMappingURL=useTranscriptHistory.d.ts.map

package/dist/ui/hooks/useTranscriptHistory.d.ts.map

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

package/dist/ui/hooks/useTranscriptHistory.js

@@ -0,0 +1,113 @@
+import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
+import { DISPLAY_ITEM_CUSTOM_KIND } from "../../core/session-manager.js";
+import { compactHistory } from "../item-helpers.js";
+import { trimFlushedItems } from "../live-item-flush.js";
+export function useTranscriptHistory({ terminalHistoryPrinter, terminalHistoryContext, writeStdout, sessionPathRef, sessionManagerRef, sessionStore, history, setHistory, setLiveItems, compactHistoryItems = (items) => compactHistory(items), persistDisplayItem, trimFlushItems = (items) => trimFlushedItems(items), }) {
+    const terminalHistoryContextRef = useRef(terminalHistoryContext);
+    const pendingHistoryFlushRef = useRef([]);
+    const drainedHistoryFlushRef = useRef([]);
+    const persistedDisplayItemIdsRef = useRef(new Set());
+    const streamedAssistantFlushRef = useRef({
+        flushedChars: 0,
+        text: "",
+    });
+    const [historyFlushGeneration, setHistoryFlushGeneration] = useState(0);
+    useEffect(() => {
+        terminalHistoryContextRef.current = terminalHistoryContext;
+    }, [terminalHistoryContext]);
+    const printHistoryItems = useCallback((items, options) => {
+        if (!terminalHistoryPrinter || items.length === 0)
+            return;
+        terminalHistoryPrinter.print(items, terminalHistoryContextRef.current, {
+            ...options,
+            write: writeStdout,
+        });
+    }, [terminalHistoryPrinter, writeStdout]);
+    const queueFlush = useCallback((items) => {
+        const flushed = trimFlushItems(items);
+        if (flushed.length === 0)
+            return;
+        pendingHistoryFlushRef.current = [...pendingHistoryFlushRef.current, ...flushed];
+        const sessionPath = sessionPathRef.current;
+        const sessionManager = sessionManagerRef.current;
+        if (sessionPath && sessionManager) {
+            for (const item of flushed) {
+                if (persistedDisplayItemIdsRef.current.has(item.id))
+                    continue;
+                persistedDisplayItemIdsRef.current.add(item.id);
+                void sessionManager.appendEntry(sessionPath, {
+                    type: "custom",
+                    kind: DISPLAY_ITEM_CUSTOM_KIND,
+                    data: { version: 1, item: persistDisplayItem ? persistDisplayItem(item) : item },
+                    id: `display-${item.id}`,
+                    parentId: null,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+        if (sessionStore) {
+            const queuedIds = new Set(items.map((item) => item.id));
+            sessionStore.liveItems = (sessionStore.liveItems ?? []).filter((item) => !queuedIds.has(item.id));
+        }
+        setHistoryFlushGeneration((generation) => generation + 1);
+    }, [persistDisplayItem, sessionManagerRef, sessionPathRef, sessionStore, trimFlushItems]);
+    useEffect(() => {
+        printHistoryItems(history);
+    }, [history, printHistoryItems]);
+    useLayoutEffect(() => {
+        const flushed = pendingHistoryFlushRef.current;
+        if (flushed.length === 0)
+            return;
+        // Keep the visible row continuous during finalization: write the completed
+        // transcript into terminal history while Ink still knows about the current
+        // live frame, then remove those live rows. Doing this in the opposite order
+        // collapses the live frame to the controls first, so a large final history
+        // write scrolls underneath the footer/input and visibly pushes them upward.
+        pendingHistoryFlushRef.current = [];
+        drainedHistoryFlushRef.current = flushed;
+        printHistoryItems(flushed);
+        const flushedIds = new Set(flushed.map((item) => item.id));
+        setLiveItems((prev) => prev.filter((item) => !flushedIds.has(item.id)));
+    }, [historyFlushGeneration, printHistoryItems, setLiveItems]);
+    useEffect(() => {
+        const flushed = drainedHistoryFlushRef.current;
+        if (flushed.length === 0)
+            return;
+        drainedHistoryFlushRef.current = [];
+        setHistory((prev) => {
+            const existingIds = new Set(prev.map((item) => item.id));
+            const nextItems = flushed.filter((item) => !existingIds.has(item.id));
+            if (nextItems.length === 0)
+                return prev;
+            const next = compactHistoryItems([...prev, ...nextItems]);
+            if (sessionStore)
+                sessionStore.history = next;
+            return next;
+        });
+    }, [historyFlushGeneration, printHistoryItems, sessionStore, setHistory]);
+    const finalizeSubmittedUserItem = useCallback((item, deferredLiveItems = []) => {
+        streamedAssistantFlushRef.current = { flushedChars: 0, text: "" };
+        const priorLiveItems = trimFlushItems([...deferredLiveItems]);
+        const finalizedItems = [...priorLiveItems, item];
+        queueFlush(finalizedItems);
+        // Print synchronously so deferred final assistant output is anchored in
+        // scrollback before the next prompt clears the live frame. The queued flush
+        // still persists and updates React history; the printer dedupes by id when
+        // the effect drains the queue.
+        printHistoryItems(finalizedItems);
+        setLiveItems([]);
+    }, [printHistoryItems, queueFlush, setLiveItems, trimFlushItems]);
+    const clearPendingHistory = useCallback(() => {
+        pendingHistoryFlushRef.current = [];
+        terminalHistoryPrinter?.clear();
+    }, [terminalHistoryPrinter]);
+    return {
+        pendingHistoryFlushRef,
+        streamedAssistantFlushRef,
+        printHistoryItems,
+        queueFlush,
+        finalizeSubmittedUserItem,
+        clearPendingHistory,
+    };
+}
+//# sourceMappingURL=useTranscriptHistory.js.map

package/dist/ui/hooks/useTranscriptHistory.js.map

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

package/dist/ui/hooks/useTranscriptHistory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useTranscriptHistory.test.d.ts.map

package/dist/ui/hooks/useTranscriptHistory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranscriptHistory.test.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTranscriptHistory.test.tsx"],"names":[],"mappings":""}

package/dist/ui/hooks/useTranscriptHistory.test.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useEffect } from "react";
+import { render } from "ink";
+import { describe, expect, it } from "vitest";
+import { useTranscriptHistory } from "./useTranscriptHistory.js";
+import { loadTheme } from "../theme/theme.js";
+const context = {
+    theme: loadTheme("dark"),
+    columns: 80,
+    version: "test",
+    model: "test-model",
+    provider: "anthropic",
+    cwd: "/tmp/project",
+};
+function Harness({ onPrinted }) {
+    const [history, setHistory] = React.useState([]);
+    const [liveItems, setLiveItems] = React.useState([
+        { kind: "assistant", id: "assistant-live", text: "previous assistant reply" },
+    ]);
+    const printedRef = React.useRef("");
+    const submittedRef = React.useRef(false);
+    const { finalizeSubmittedUserItem } = useTranscriptHistory({
+        terminalHistoryPrinter: {
+            print(items, _context, options) {
+                for (const item of items) {
+                    options?.write?.(`${item.kind}:${"text" in item ? item.text : item.id}\n`);
+                }
+            },
+            clear() { },
+        },
+        terminalHistoryContext: context,
+        writeStdout(data) {
+            printedRef.current += data;
+        },
+        sessionPathRef: { current: undefined },
+        sessionManagerRef: { current: null },
+        history,
+        setHistory,
+        setLiveItems,
+    });
+    useEffect(() => {
+        if (submittedRef.current)
+            return;
+        submittedRef.current = true;
+        finalizeSubmittedUserItem({ kind: "user", id: "user-next", text: "follow up prompt" }, liveItems);
+        onPrinted(printedRef.current);
+    }, [finalizeSubmittedUserItem, liveItems, onPrinted]);
+    return null;
+}
+describe("useTranscriptHistory", () => {
+    it("prints deferred final assistant output before the next submitted user prompt", async () => {
+        let printed = "";
+        const mounted = render(_jsx(Harness, { onPrinted: (value) => (printed = value) }), {
+            patchConsole: false,
+        });
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        mounted.unmount();
+        expect(printed).toContain("assistant:previous assistant reply\nuser:follow up prompt\n");
+    });
+});
+//# sourceMappingURL=useTranscriptHistory.test.js.map

package/dist/ui/hooks/useTranscriptHistory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranscriptHistory.test.js","sourceRoot":"","sources":["../../../src/ui/hooks/useTranscriptHistory.test.tsx"],"names":[],"mappings":"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"}

package/dist/ui/hooks/useTranscriptScroll.d.ts

@@ -0,0 +1,30 @@
+interface UseTranscriptScrollOptions {
+    /** Total number of transcript lines available to scroll through. */
+    totalLines: number;
+    /** Height of the transcript viewport in rows. */
+    viewportRows: number;
+    /** Disable key handling (e.g. while an overlay owns the screen). */
+    active: boolean;
+    /**
+     * Bumped by the caller whenever a new prompt is submitted; resets scroll to
+     * the bottom so the user always sees their newest message + the response.
+     */
+    resetToken: number;
+}
+/**
+ * Keyboard + bounds controller for the fullscreen alt-screen transcript
+ * viewport. The offset itself lives in the external transcript-scroll store so
+ * that scrolling re-renders only the viewport, not the whole App (see
+ * stores/transcript-scroll-store.ts). This hook just:
+ *   - keeps the store's clamp bounds in sync with content/layout,
+ *   - resets to the bottom on a new prompt,
+ *   - maps keys to store actions.
+ *
+ * Mouse-wheel scrolling is routed straight into the store from the input
+ * handler (scrollTranscriptByLines), bypassing React state entirely.
+ *
+ * Keys: PageUp/PageDown (page), Shift+Up/Down (line), g/G (top/bottom).
+ */
+export declare function useTranscriptScroll({ totalLines, viewportRows, active, resetToken, }: UseTranscriptScrollOptions): void;
+export {};
+//# sourceMappingURL=useTranscriptScroll.d.ts.map

package/dist/ui/hooks/useTranscriptScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranscriptScroll.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTranscriptScroll.ts"],"names":[],"mappings":"AAUA,UAAU,0BAA0B;IAClC,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,YAAY,EACZ,MAAM,EACN,UAAU,GACX,EAAE,0BAA0B,GAAG,IAAI,CAyBnC"}