@wrongstack/tui 0.306.2 → 0.306.3

package/dist/hooks/use-file-search.d.ts

@@ -9,6 +9,11 @@
 import type { InputBuilder } from '@wrongstack/core/agent';
 import type { Action, State } from '../app-reducer.js';
 import { type TokenPreviewStore } from '../token-previews.js';
+/**
+ * Keystroke coalescing window for `@`-file search. Long enough to swallow a
+ * burst of typing, short enough that the results feel attached to the keys.
+ */
+export declare const FILE_SEARCH_DEBOUNCE_MS = 150;
 /**
  * Find an active `@<query>` token at the cursor. The token starts at the
  * last `@` not preceded by a non-whitespace char, and runs up to the cursor

package/dist/hooks/use-history-archive.d.ts

@@ -0,0 +1,30 @@
+/**
+ * use-history-archive — wires {@link HistoryArchive} into the scroll-back path.
+ *
+ * The reducer caps the in-memory window (`retainTuiHistory`), so entries that
+ * age out are gone from `state.entries`. This hook mirrors every entry to a
+ * disk-backed JSONL archive as it appears, and serves pages back when the user
+ * scrolls past the oldest in-memory entry. Without it `onRequestOlderEntries`
+ * resolves with zero entries and scroll-back silently dead-ends.
+ *
+ * Scope is one process run. The archive file is truncated at startup because
+ * entry ids restart at 1 on resume (`replaySessionMessages(..., 1)`) — keeping
+ * a previous run's lines would collide ids and duplicate rows in the view.
+ * Cross-run history is `/resume`'s job, not the scroll window's.
+ */
+import type { Action } from '../app-reducer.js';
+import type { HistoryEntry } from '../history-entry.js';
+export interface UseHistoryArchiveOptions {
+    entries: readonly HistoryEntry[];
+    dispatch: React.Dispatch<Action>;
+    /** Root of the session store. Absent for ephemeral (`--no-session`) runs. */
+    sessionsDir?: string | undefined;
+    /** Current session id; the archive lives beside the session's own files. */
+    sessionId?: string | undefined;
+}
+export interface HistoryArchiveResult {
+    /** Passed to <ScrollableHistory>; fires when the user reaches the oldest row. */
+    onRequestOlderEntries: () => void;
+}
+export declare function useHistoryArchive({ entries, dispatch, sessionsDir, sessionId, }: UseHistoryArchiveOptions): HistoryArchiveResult;
+//# sourceMappingURL=use-history-archive.d.ts.map