@xgspz/cli-ui 0.6.15 → 0.6.16

package/src/operator/node/transcriptModel.ts

@@ -1,129 +0,0 @@
-// Pure helpers behind the live transcript (useTaskStream + SessionView), kept
-// free of React so they can be unit-tested. The rules they encode exist for
-// long tasks: thousands of messages, megabytes of tool output.
-
-import type { ToolData } from "./protocol/types";
-import type { Msg } from "./types";
-import { buildSessions } from "./format";
-
-/** Messages the live view's snapshot carries (GET /messages?tail=N). */
-export const SNAPSHOT_TAIL = 300;
-/** Older messages fetched per page from /history. */
-export const HISTORY_PAGE = 300;
-/** Transcript rows kept in the DOM while following the newest output. */
-export const RENDER_WINDOW = 120;
-/** Rows revealed per step when scrolling back (or forward again). */
-export const RENDER_STEP = 80;
-/** Most rows ever in the DOM at once; the far end is dropped beyond this. */
-export const RENDER_MAX = 360;
-/**
- * Transcripts one tab keeps in memory: the open task plus the most recently
- * left ones (switching back to those shows at once). Each kept one is trimmed
- * to a snapshot's size when left (trimToTail), so on real node data this is
- * ~10 MB typical, well under 100 MB at worst. Per tab: several tabs on the
- * same task each keep their own.
- */
-export const KEEP_TRANSCRIPTS = 30;
-
-/**
- * A transcript the tab is leaving, brought back to what a fresh snapshot holds
- * (the newest `tail` messages; `older` grows by what was dropped), so a task
- * read far back doesn't keep thousands of messages around in the background.
- * Returns the input untouched when it is already that small.
- */
-export function trimToTail(msgs: Msg[], older: number, tail = SNAPSHOT_TAIL): { msgs: Msg[]; older: number } {
-  const queued = msgs.filter((m) => m.role === "queued");
-  const rest = msgs.filter((m) => m.role !== "queued");
-  if (rest.length <= tail) return { msgs, older };
-  return { msgs: [...rest.slice(rest.length - tail), ...queued], older: older + rest.length - tail };
-}
-
-/** The tab's kept-transcript order after opening `id`, and which tasks fall out. */
-export function touchRecent(recent: string[], id: string, keep = KEEP_TRANSCRIPTS): { recent: string[]; evicted: string[] } {
-  const next = [id, ...recent.filter((t) => t !== id)];
-  return { recent: next.slice(0, keep), evicted: next.slice(keep) };
-}
-
-// Parsed tool payloads, cached per message object. Message objects are replaced
-// whenever their content changes, so a cached entry can never go stale, and the
-// transcript stops re-parsing every tool row's JSON on each live event.
-const toolCache = new WeakMap<Msg, ToolData>();
-/** The tool card behind a "tool" message. Read-only: never mutate the result. */
-export function toolDataOf(m: Msg): ToolData {
-  let data = toolCache.get(m);
-  if (!data) {
-    try { data = JSON.parse(m.content) as ToolData; } catch { data = { title: m.content }; }
-    toolCache.set(m, data);
-  }
-  return data;
-}
-
-/** Index of the message with this id, searching from the newest end (where live updates land). */
-export function indexFromEnd(arr: Msg[], id: string): number {
-  for (let i = arr.length - 1; i >= 0; i--) if (arr[i].id === id) return i;
-  return -1;
-}
-
-/** True when an AskUserQuestion card near the end is still unanswered. */
-export function hasOpenAsk(messages: Msg[], scan = 400): boolean {
-  for (let i = messages.length - 1, n = 0; i >= 0 && n < scan; i--, n++) {
-    const m = messages[i];
-    if (m.role !== "tool") continue;
-    const d = toolDataOf(m);
-    if (d.ask && !d.ask.answers) return true;
-  }
-  return false;
-}
-
-/**
- * Apply a (re)connect snapshot to what the tab already holds.
- *
- * - Unchanged messages keep their object identity, so memoized rows don't
- *   re-render (and re-parse their markdown) on every reconnect.
- * - Older pages the user already scrolled in are kept when the snapshot's tail
- *   still overlaps them; `older` is reduced by what was kept.
- */
-export function mergeSnapshot(prev: Msg[] | undefined, committed: Msg[], queued: Msg[], older: number): { msgs: Msg[]; older: number } {
-  const byId = new Map<string, Msg>();
-  for (const m of prev ?? []) byId.set(m.id, m);
-  const reuse = (m: Msg): Msg => {
-    const p = byId.get(m.id);
-    if (!p || p.role !== m.role || p.content !== m.content || p.generation !== m.generation) return m;
-    return p.ts === m.ts ? p : { ...p, ts: m.ts };
-  };
-  const fresh = committed.map(reuse);
-  let kept: Msg[] = [];
-  if (prev && fresh.length && older > 0) {
-    const at = prev.findIndex((m) => m.id === fresh[0].id);
-    // Only persisted rows (they carry ts) — local notices died with the old view.
-    if (at > 0) kept = prev.slice(0, at).filter((m) => m.role !== "queued" && m.ts != null);
-  }
-  return { msgs: [...kept, ...fresh, ...queued.map(reuse)], older: Math.max(0, older - kept.length) };
-}
-
-export type TranscriptItem =
-  | { kind: "label"; key: string; n: number; current: boolean }
-  | { kind: "break"; key: string; summary: string }
-  | { kind: "msg"; key: string; m: Msg; initial: boolean; hideWho: boolean };
-
-/**
- * The transcript as a flat row list (session labels, /clear breaks, messages),
- * so the view can render any window of it. `hasOlder`: earlier messages aren't
- * loaded yet, so the first loaded one is not necessarily its session's opener.
- */
-export function buildTranscriptItems(messages: Msg[], hasOlder: boolean): TranscriptItem[] {
-  const sessions = buildSessions(messages);
-  const items: TranscriptItem[] = [];
-  sessions.forEach((s, si) => {
-    if (si > 0 && s.summaryBefore) items.push({ kind: "break", key: `b-${s.n}`, summary: s.summaryBefore });
-    items.push({ kind: "label", key: `s-${s.n}`, n: s.n, current: si === sessions.length - 1 });
-    s.messages.forEach((m, mi) => {
-      const prev = s.messages[mi - 1];
-      // collapse the repeated agent header across an assistant run (text → tool → text)
-      const hideWho = m.role === "assistant" && !!prev && (prev.role === "assistant" || prev.role === "tool");
-      const initial = mi === 0 && m.role === "user" && !(si === 0 && hasOlder);
-      items.push({ kind: "msg", key: m.id, m, initial, hideWho });
-    });
-  });
-  return items;
-}