pum-agent 0.1.0-beta.3

package/src/login-popup.tsx

@@ -0,0 +1,154 @@
+import type { AuthEvent, AuthPrompt } from "@earendil-works/pi-ai";
+import type { Theme } from "./theme";
+import type { LoginMethod } from "./login-flow";
+
+export type LoginPage =
+  | { kind: "providers"; methods: readonly LoginMethod[]; cursor: number }
+  | { kind: "prompt"; providerName: string; prompt: AuthPrompt; cursor: number; value: string; secretLength: number }
+  | { kind: "working"; providerName: string; event?: AuthEvent }
+  | { kind: "custom-endpoint"; endpoint: string }
+  | { kind: "custom-key"; endpoint: string; secretLength: number }
+  | { kind: "custom-working"; endpoint: string; message: string }
+  | { kind: "error"; title: string; message: string }
+  | { kind: "success"; message: string };
+
+function popupGeometry(width: number, height: number) {
+  const narrow = width < 64;
+  const margin = narrow ? 1 : Math.max(2, Math.floor(width * 0.1));
+  return {
+    left: margin,
+    width: Math.max(24, width - margin * 2),
+    height: Math.max(10, Math.min(height - 2, 22)),
+  };
+}
+
+function InputRow({ theme, label, value, secret = false }: { theme: Theme; label: string; value: string; secret?: boolean }) {
+  return (
+    <box style={{ flexDirection: "row", height: 1, flexShrink: 0 }}>
+      <box style={{ width: 12, flexShrink: 0 }}><text content={label} fg={theme.dim} bg={theme.popupBg} /></box>
+      <text content={secret ? "•".repeat(value.length) : value} fg={theme.fg} bg={theme.popupBg} wrapMode="none" />
+      <text content="▌" fg={theme.accent} bg={theme.popupBg} />
+    </box>
+  );
+}
+
+function EventDetails({ theme, event }: { theme: Theme; event?: AuthEvent }) {
+  if (!event) return <text content="Starting authentication…" fg={theme.dim} bg={theme.popupBg} />;
+  if (event.type === "auth_url") {
+    return <>
+      <text content={event.instructions ?? "Open this URL in a browser:"} fg={theme.fg} bg={theme.popupBg} />
+      <text content={event.url} fg={theme.accent} bg={theme.popupBg} selectable wrapMode="word" />
+    </>;
+  }
+  if (event.type === "device_code") {
+    return <>
+      <text content="Open this URL and enter the code:" fg={theme.fg} bg={theme.popupBg} />
+      <text content={event.verificationUri} fg={theme.accent} bg={theme.popupBg} selectable wrapMode="word" />
+      <text content={event.userCode} fg={theme.accent} bg={theme.popupBg} selectable />
+    </>;
+  }
+  if (event.type === "info") {
+    return <>
+      <text content={event.message} fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+      {event.links?.map((link) => <text key={link.url} content={`${link.label ? `${link.label}: ` : ""}${link.url}`} fg={theme.accent} bg={theme.popupBg} selectable wrapMode="word" />)}
+    </>;
+  }
+  return <text content={event.message} fg={theme.dim} bg={theme.popupBg} wrapMode="word" />;
+}
+
+export function LoginPopup({ theme, page, terminalWidth, terminalHeight }: {
+  theme: Theme;
+  page: LoginPage;
+  terminalWidth: number;
+  terminalHeight: number;
+}) {
+  const geometry = popupGeometry(terminalWidth, terminalHeight);
+  const providerCursor = page.kind === "providers" ? page.cursor : null;
+  const title = page.kind === "providers" ? " Login " : page.kind.startsWith("custom") ? " Custom provider " : " Provider login ";
+
+  return (
+    <box
+      title={title}
+      style={{
+        position: "absolute",
+        top: Math.max(1, Math.floor((terminalHeight - geometry.height) / 2)),
+        left: geometry.left,
+        width: geometry.width,
+        height: geometry.height,
+        zIndex: 120,
+        border: true,
+        borderColor: theme.border,
+        backgroundColor: theme.popupBg,
+        flexDirection: "column",
+        padding: 1,
+      }}
+    >
+      {page.kind === "providers" ? <>
+        <text content="Select a provider login method" fg={theme.dim} bg={theme.popupBg} style={{ flexShrink: 0 }} />
+        <box style={{ height: 1, flexShrink: 0 }} />
+        <scrollbox
+          id="login-provider-list"
+          style={{ flexGrow: 1, minHeight: 1 }}
+          verticalScrollbarOptions={{ visible: true }}
+          renderBefore={function () {
+            if (providerCursor !== null) this.scrollChildIntoView(`login-provider-${providerCursor}`);
+          }}
+        >
+          <box style={{ flexDirection: "column", width: "100%", flexShrink: 0 }}>
+            {page.methods.map((method, index) => {
+              const selected = page.cursor === index;
+              const label = `${method.providerName} — ${method.authType === "oauth" ? method.loginLabel ?? method.methodName : method.methodName}`;
+              return <box id={`login-provider-${index}`} key={`${method.providerId}:${method.authType}`} style={{ height: 1, flexShrink: 0, backgroundColor: selected ? theme.selectionBg : theme.popupBg }}>
+                <text content={`${selected ? "› " : "  "}${label}${method.canLogin ? "" : " (external setup)"}`} fg={selected ? theme.accent : theme.fg} bg={selected ? theme.selectionBg : theme.popupBg} wrapMode="none" />
+              </box>;
+            })}
+            <box id={`login-provider-${page.methods.length}`} style={{ height: 1, flexShrink: 0, backgroundColor: page.cursor === page.methods.length ? theme.selectionBg : theme.popupBg }}>
+              <text content={`${page.cursor === page.methods.length ? "› " : "  "}Custom OpenAI-compatible provider`} fg={page.cursor === page.methods.length ? theme.accent : theme.fg} bg={page.cursor === page.methods.length ? theme.selectionBg : theme.popupBg} />
+            </box>
+          </box>
+        </scrollbox>
+        <text content="↑↓ move   enter select   esc close" fg={theme.dim} bg={theme.popupBg} style={{ height: 1, flexShrink: 0 }} />
+      </> : page.kind === "prompt" ? <>
+        <text content={page.providerName} fg={theme.accent} bg={theme.popupBg} />
+        <text content={page.prompt.message} fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+        <box style={{ height: 1, flexShrink: 0 }} />
+        {page.prompt.type === "select" ? page.prompt.options.map((option, index) => {
+          const selected = index === page.cursor;
+          return <box key={option.id} style={{ flexDirection: "column", flexShrink: 0, backgroundColor: selected ? theme.selectionBg : theme.popupBg }}>
+            <text content={`${selected ? "› " : "  "}${option.label}`} fg={selected ? theme.accent : theme.fg} bg={selected ? theme.selectionBg : theme.popupBg} />
+            {option.description ? <text content={`  ${option.description}`} fg={theme.dim} bg={selected ? theme.selectionBg : theme.popupBg} /> : null}
+          </box>;
+        }) : <InputRow theme={theme} label={page.prompt.type === "secret" ? "API key" : "Value"} value={page.prompt.type === "secret" ? "x".repeat(page.secretLength) : page.value} secret={page.prompt.type === "secret"} />}
+        <text content="enter continue   esc cancel" fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : page.kind === "working" ? <>
+        <text content={page.providerName} fg={theme.accent} bg={theme.popupBg} />
+        <box style={{ height: 1, flexShrink: 0 }} />
+        <EventDetails theme={theme} event={page.event} />
+        <text content="URLs and codes are selectable for copying. Esc cancels." fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : page.kind === "custom-endpoint" ? <>
+        <text content="Enter the server endpoint. PUM probes /models and configures OpenAI Chat Completions only after that probe succeeds." fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+        <box style={{ height: 1, flexShrink: 0 }} />
+        <InputRow theme={theme} label="Endpoint" value={page.endpoint} />
+        <text content="Example: http://localhost:11434/v1" fg={theme.dim} bg={theme.popupBg} />
+        <text content="enter continue   esc back" fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : page.kind === "custom-key" ? <>
+        <text content="Enter the API key. Leave the field empty for a keyless local server." fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+        <box style={{ height: 1, flexShrink: 0 }} />
+        <InputRow theme={theme} label="API key" value={"x".repeat(page.secretLength)} secret />
+        <text content="The key is stored in PUM auth.json. The key is not stored in models.json." fg={theme.dim} bg={theme.popupBg} wrapMode="word" />
+        <text content="enter discover   esc back" fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : page.kind === "custom-working" ? <>
+        <text content={page.message} fg={theme.dim} bg={theme.popupBg} wrapMode="word" />
+        <text content="Esc cancels." fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : page.kind === "error" ? <>
+        <text content={page.title} fg={theme.error} bg={theme.popupBg} />
+        <text content={page.message} fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+        <text content="enter retry   esc close" fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </> : <>
+        <text content="✓ Setup complete" fg={theme.success} bg={theme.popupBg} />
+        <text content={page.message} fg={theme.fg} bg={theme.popupBg} wrapMode="word" />
+        <text content="enter or esc close" fg={theme.dim} bg={theme.popupBg} style={{ marginTop: 1 }} />
+      </>}
+    </box>
+  );
+}

package/src/platform.ts

@@ -0,0 +1,94 @@
+import { createHash } from "node:crypto";
+import { realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { posix, win32 } from "node:path";
+
+export type RuntimePlatform = NodeJS.Platform;
+
+type Environment = Record<string, string | undefined>;
+
+function pathApi(platform: RuntimePlatform): typeof posix {
+  return platform === "win32" ? win32 : posix;
+}
+
+export function defaultAgentDir(
+  platform: RuntimePlatform = process.platform,
+  env: Environment = process.env,
+  home = homedir(),
+): string {
+  const paths = pathApi(platform);
+  if (env.PUM_DIR) return paths.resolve(env.PUM_DIR);
+  if (platform === "win32") {
+    const base = env.LOCALAPPDATA ?? env.APPDATA ?? paths.join(home, "AppData", "Local");
+    return paths.join(base, "pum");
+  }
+  if (platform === "darwin") return paths.join(home, "Library", "Application Support", "pum");
+  return paths.join(env.XDG_CONFIG_HOME ?? paths.join(home, ".config"), "pum");
+}
+
+export function projectStorageKey(
+  cwd: string,
+  platform: RuntimePlatform = process.platform,
+): string {
+  if (platform !== "win32") return cwd;
+  return win32.resolve(cwd).toLowerCase();
+}
+
+export function sessionDirectoryName(
+  cwd: string,
+  platform: RuntimePlatform = process.platform,
+): string {
+  if (platform !== "win32") {
+    return `--${posix.resolve(cwd).replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
+  }
+
+  const canonical = win32.resolve(cwd).toLowerCase();
+  const readable = canonical
+    .replace(/^\\\\/, "unc-")
+    .replace(/^[a-z]:\\/i, (prefix) => `${prefix[0]}-`)
+    .replace(/[^a-z0-9._-]+/gi, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "")
+    .slice(0, 72);
+  const digest = createHash("sha256").update(canonical).digest("hex").slice(0, 12);
+  return `--${readable || "root"}-${digest}--`;
+}
+
+export function isPathInside(
+  parent: string,
+  candidate: string,
+  platform: RuntimePlatform = process.platform,
+): boolean {
+  const paths = pathApi(platform);
+  const relative = paths.relative(paths.resolve(parent), paths.resolve(candidate));
+  return relative !== "" && relative !== ".." && !relative.startsWith(`..${paths.sep}`) && !paths.isAbsolute(relative);
+}
+
+export async function canonicalPathIdentity(
+  path: string,
+  platform: RuntimePlatform = process.platform,
+  resolvePath: (path: string) => Promise<string> = realpath,
+): Promise<string> {
+  const paths = pathApi(platform);
+  const canonical = paths.resolve(await resolvePath(path));
+  return platform === "win32" ? canonical.toLowerCase() : canonical;
+}
+
+export async function pathsHaveSameIdentity(
+  first: string,
+  second: string,
+  platform: RuntimePlatform = process.platform,
+  resolvePath: (path: string) => Promise<string> = realpath,
+): Promise<boolean> {
+  const [firstIdentity, secondIdentity] = await Promise.all([
+    canonicalPathIdentity(first, platform, resolvePath),
+    canonicalPathIdentity(second, platform, resolvePath),
+  ]);
+  return firstIdentity === secondIdentity;
+}
+
+export function shutdownSignals(
+  platform: RuntimePlatform = process.platform,
+): NodeJS.Signals[] {
+  return platform === "win32" ? ["SIGINT", "SIGBREAK"] : ["SIGINT", "SIGTERM", "SIGHUP"];
+}

package/src/prompt-stash.ts

@@ -0,0 +1,130 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { AGENT_DIR } from "./config";
+import { loadHistory } from "./history";
+import { projectStorageKey } from "./platform";
+
+export type StashedPrompt = {
+  text: string;
+  executed: boolean;
+};
+
+type StashFile = Record<string, (StashedPrompt | string)[]>;
+const STASH_PATH = join(AGENT_DIR, "prompt-stash.json");
+const MAX_ENTRIES = 200;
+
+function sortStash(list: StashedPrompt[]): StashedPrompt[] {
+  return list.sort((a, b) => Number(b.executed) - Number(a.executed));
+}
+
+function readFile(): StashFile {
+  try {
+    const parsed = JSON.parse(readFileSync(STASH_PATH, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+
+export function loadPromptStash(cwd: string): StashedPrompt[] {
+  const file = readFile();
+  const entries = file[projectStorageKey(cwd)] ?? file[cwd];
+  if (!Array.isArray(entries)) return [];
+  const executedPrompts = new Set(loadHistory(cwd));
+  return sortStash(
+    entries.flatMap((entry) => {
+      if (typeof entry === "string") {
+        return [{ text: entry, executed: executedPrompts.has(entry) }];
+      }
+      return entry && typeof entry.text === "string"
+        ? [{ text: entry.text, executed: entry.executed === true || executedPrompts.has(entry.text) }]
+        : [];
+    }),
+  );
+}
+
+/** Add a prompt to the stash and return the bounded list. */
+export function appendPromptStash(
+  cwd: string,
+  prompt: string,
+  executed = false,
+): StashedPrompt[] {
+  const file = readFile();
+  const key = projectStorageKey(cwd);
+  const list = loadPromptStash(cwd);
+  list.push({ text: prompt, executed });
+  const trimmed = sortStash(list).slice(-MAX_ENTRIES);
+  file[key] = trimmed;
+  if (key !== cwd) delete file[cwd];
+  try {
+    writeFileSync(STASH_PATH, JSON.stringify(file, null, 2));
+  } catch {
+    // The stash is a convenience; never break a prompt over persistence.
+  }
+  return trimmed;
+}
+
+/** Replace one stashed prompt and return the newly sorted list. */
+export function replacePromptStash(
+  cwd: string,
+  index: number,
+  prompt: string,
+  executed: boolean,
+): StashedPrompt[] {
+  const file = readFile();
+  const key = projectStorageKey(cwd);
+  const list = loadPromptStash(cwd);
+  if (list[index]) list[index] = { text: prompt, executed };
+  const sorted = sortStash(list);
+  file[key] = sorted;
+  if (key !== cwd) delete file[cwd];
+  try {
+    writeFileSync(STASH_PATH, JSON.stringify(file, null, 2));
+  } catch {
+    // The stash is a convenience; never break a turn over it.
+  }
+  return sorted;
+}
+
+/** Remove one prompt from the stash. */
+export function removePromptStash(cwd: string, index: number): StashedPrompt[] {
+  const file = readFile();
+  const key = projectStorageKey(cwd);
+  const list = loadPromptStash(cwd);
+  if (index >= 0 && index < list.length) list.splice(index, 1);
+  file[key] = list;
+  if (key !== cwd) delete file[cwd];
+  try {
+    writeFileSync(STASH_PATH, JSON.stringify(file, null, 2));
+  } catch {
+    // The stash is a convenience; never break input handling over it.
+  }
+  return list;
+}
+
+/** Mark selected stashed prompts as executed with one persistence update. */
+export function markPromptStashExecutedMany(
+  cwd: string,
+  indices: Iterable<number>,
+): StashedPrompt[] {
+  const file = readFile();
+  const key = projectStorageKey(cwd);
+  const selected = new Set(indices);
+  const list = loadPromptStash(cwd).map((prompt, index) =>
+    selected.has(index) ? { ...prompt, executed: true } : prompt,
+  );
+  const sorted = sortStash(list);
+  file[key] = sorted;
+  if (key !== cwd) delete file[cwd];
+  try {
+    writeFileSync(STASH_PATH, JSON.stringify(file, null, 2));
+  } catch {
+    // The stash is a convenience; never break a turn over persistence.
+  }
+  return sorted;
+}
+
+/** Mark a stashed prompt as executed without adding a duplicate row. */
+export function markPromptStashExecuted(cwd: string, index: number): StashedPrompt[] {
+  return markPromptStashExecutedMany(cwd, [index]);
+}

package/src/replay.ts

@@ -0,0 +1,188 @@
+import type { Line } from "./transcript";
+import { isRejectedToolResult } from "./check-mode";
+import { editCounts, toolArg, type ToolCall } from "./tool-line";
+import {
+  WEB_SEARCH_CUSTOM_TYPE,
+  type SearchCallRecord,
+} from "./web-search";
+import {
+  AGENT_MESSAGE_CUSTOM_TYPE,
+  AGENT_MESSAGE_DISPLAY_TYPE,
+  SUBAGENT_WAKE_PREFIX,
+  TOOL_EVENT_CUSTOM_TYPE,
+  type AgentMessageData,
+} from "./subagents/types";
+
+const textOf = (content: unknown): string => {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  const text = content
+    .filter((b: any) => b?.type === "text" && typeof b.text === "string")
+    .map((b: any) => b.text)
+    .join("")
+    .trim();
+  const markers = content
+    .filter((b: any) => b?.type === "image")
+    .map((_b: any, index: number) => `[Image #${index + 1}]`)
+    .join(" ");
+  return [text, markers].filter(Boolean).join(" ");
+};
+
+function agentMessageOf(entry: any): AgentMessageData | undefined {
+  const isDisplay = entry?.type === "custom" && entry.customType === AGENT_MESSAGE_DISPLAY_TYPE;
+  const isMessage = entry?.type === "custom_message" && entry.customType === AGENT_MESSAGE_CUSTOM_TYPE;
+  if (!isDisplay && !isMessage) return undefined;
+  const data = isDisplay ? entry.data : entry.details;
+  if (!data || typeof data !== "object") return undefined;
+  if (typeof data.sender !== "string" || typeof data.recipient !== "string") return undefined;
+  return {
+    id: typeof data.id === "string" ? data.id : `${entry.id ?? "message"}`,
+    sender: data.sender,
+    recipient: data.recipient,
+    text: typeof data.text === "string" ? data.text : textOf(entry.content),
+    at: typeof data.at === "number" ? data.at : 0,
+  };
+}
+
+function toolEventOf(entry: any): ToolCall | undefined {
+  if (entry?.type !== "custom" || entry.customType !== TOOL_EVENT_CUSTOM_TYPE) return undefined;
+  const data = entry.data;
+  if (!data || typeof data.id !== "string" || typeof data.name !== "string") return undefined;
+  if (!["running", "ok", "error", "rejected"].includes(data.state)) return undefined;
+  return {
+    id: data.id,
+    name: data.name,
+    arg: typeof data.arg === "string" ? data.arg : "",
+    state: data.state,
+    detail: typeof data.detail === "string" ? data.detail : undefined,
+  };
+}
+
+function searchRecordOf(entry: any): SearchCallRecord | undefined {
+  if (entry?.type !== "custom" || entry.customType !== WEB_SEARCH_CUSTOM_TYPE) return undefined;
+  const data = entry.data;
+  if (!data || typeof data !== "object" || typeof data.id !== "string") return undefined;
+  if (![
+    "running",
+    "ok",
+    "error",
+  ].includes(data.state)) return undefined;
+  return {
+    id: data.id,
+    query: typeof data.query === "string" ? data.query : "",
+    state: data.state,
+  };
+}
+
+/**
+ * Rebuild transcript lines from a restored session's active entries, so
+ * `pum -r` shows the conversation rather than an empty pane. Messages come
+ * from pi and are typed loosely, so every access here is defensive.
+ */
+export function replayEntries(
+  entries: readonly any[],
+  cwd: string,
+  showThinking: boolean,
+): Line[] {
+  const lines: Line[] = [];
+  const calls = new Map<string, ToolCall>();
+  const searchCalls = new Map<string, ToolCall>();
+  const customCalls = new Map<string, ToolCall>();
+  const agentMessages = new Set<string>();
+
+  for (const entry of entries) {
+    const agentMessage = agentMessageOf(entry);
+    if (agentMessage) {
+      if (!agentMessages.has(agentMessage.id)) {
+        agentMessages.add(agentMessage.id);
+        lines.push({
+          kind: "agent-message",
+          sender: agentMessage.sender,
+          recipient: agentMessage.recipient,
+          text: agentMessage.text,
+        });
+      }
+      continue;
+    }
+
+    const customCall = toolEventOf(entry);
+    if (customCall) {
+      const existing = customCalls.get(customCall.id);
+      if (existing) Object.assign(existing, customCall);
+      else {
+        customCalls.set(customCall.id, customCall);
+        lines.push({ kind: "tool", call: customCall });
+      }
+      continue;
+    }
+
+    const search = searchRecordOf(entry);
+    if (search) {
+      const existing = searchCalls.get(search.id);
+      if (existing) {
+        existing.state = search.state;
+        if (search.query) existing.arg = search.query;
+      } else {
+        const call: ToolCall = {
+          id: search.id,
+          name: "web_search",
+          arg: search.query,
+          state: search.state,
+        };
+        searchCalls.set(search.id, call);
+        lines.push({ kind: "tool", call });
+      }
+      continue;
+    }
+
+    // Accept raw AgentMessages too; this keeps the replay helper useful for
+    // callers that already have `agent.state.messages`.
+    const message = entry?.type === "message" ? entry.message : entry;
+
+    if (message?.role === "user") {
+      const text = textOf(message.content);
+      if (text.startsWith(SUBAGENT_WAKE_PREFIX)) continue;
+      if (text) lines.push({ kind: "text", role: "user", text });
+      continue;
+    }
+
+    if (message?.role === "assistant" && Array.isArray(message.content)) {
+      for (const block of message.content) {
+        if (block?.type === "text" && block.text?.trim()) {
+          lines.push({ kind: "text", role: "assistant", text: block.text.trim() });
+        } else if (showThinking && block?.type === "thinking" && block.thinking?.trim()) {
+          lines.push({ kind: "text", role: "thinking", text: block.thinking.trim() });
+        } else if (block?.type === "toolCall") {
+          const call: ToolCall = {
+            id: block.id,
+            name: block.name,
+            arg: toolArg(block.name, block.arguments, cwd),
+            // Anything replayed has already finished; a matching result may
+            // downgrade this to an error below.
+            state: "ok",
+          };
+          calls.set(block.id, call);
+          lines.push({ kind: "tool", call });
+        }
+      }
+      continue;
+    }
+
+    if (message?.role === "toolResult") {
+      const call = calls.get(message.toolCallId);
+      if (call) {
+        call.state = isRejectedToolResult(message)
+          ? "rejected"
+          : message.isError
+            ? "error"
+            : "ok";
+        if (call.name === "edit" || call.name === "apply_patch") call.detail = editCounts(message);
+      }
+    }
+  }
+
+  return lines;
+}
+
+/** Backwards-compatible name for replaying a list of messages. */
+export const replayMessages = replayEntries;

package/src/session-history-popup.tsx

@@ -0,0 +1,68 @@
+import type { SessionInfo } from "@earendil-works/pi-coding-agent";
+import type { Theme } from "./theme";
+
+function optionFor(session: SessionInfo) {
+  const title = session.name || session.firstMessage || "(empty session)";
+  const modified = session.modified.toLocaleString(undefined, {
+    month: "short",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+  });
+  return {
+    name: title.replace(/\s+/g, " ").slice(0, 80),
+    description: `${modified} · ${session.messageCount} messages`,
+    value: session.path,
+  };
+}
+
+export function SessionHistoryPopup({
+  theme,
+  sessions,
+  onSelect,
+}: {
+  theme: Theme;
+  sessions: readonly SessionInfo[];
+  onSelect: (path: string) => void;
+}) {
+  return (
+    <box
+      title=" Session history "
+      style={{
+        position: "absolute",
+        top: "10%",
+        left: "10%",
+        width: "80%",
+        height: "80%",
+        zIndex: 100,
+        border: true,
+        borderColor: theme.border,
+        backgroundColor: theme.popupBg,
+        flexDirection: "column",
+        padding: 1,
+      }}
+    >
+      {sessions.length > 0 ? (
+        <select
+          focused
+          backgroundColor={theme.popupBg}
+          focusedBackgroundColor={theme.popupBg}
+          selectedBackgroundColor={theme.popupBg}
+          style={{ flexGrow: 1 }}
+          options={sessions.map(optionFor)}
+          onSelect={(_index, option) => {
+            if (option) onSelect(option.value as string);
+          }}
+        />
+      ) : (
+        <text content="No saved sessions for this directory." fg={theme.dim} bg={theme.popupBg} />
+      )}
+      <text
+        content="↑↓ select   enter open   esc close"
+        fg={theme.dim}
+        bg={theme.popupBg}
+        style={{ flexShrink: 0 }}
+      />
+    </box>
+  );
+}