@xopcai/xopc 0.0.124 → 0.0.126

package/dist/src/tui/tool-summary.js

@@ -0,0 +1,212 @@
+import { basename, dirname } from "node:path";
+import { Text } from "@earendil-works/pi-tui";
+//#region src/tui/tool-summary.ts
+const MAX_ARG_VALUE_LENGTH = 120;
+const MAX_PATH_LABEL_LENGTH = 72;
+function formatArgsSummary(args, toolName) {
+	if (!args || typeof args !== "object") return "";
+	const compactRead = isReadStyleTool(toolName) ? formatCompactReadArgs(args) : null;
+	if (compactRead) return compactRead;
+	const command = isExecStyleTool(toolName) ? commandFromArgs(args) : null;
+	if (command) return command;
+	const entries = Object.entries(args);
+	if (entries.length === 0) return "";
+	return entries.map(([key, value]) => {
+		const stringValue = formatArgValue(value);
+		return `${key}=${stringValue.length > MAX_ARG_VALUE_LENGTH ? `${stringValue.slice(0, MAX_ARG_VALUE_LENGTH - 3)}...` : stringValue}`;
+	}).join(", ");
+}
+function getToolSummaryKind(toolName) {
+	if (isReadStyleTool(toolName)) return "read";
+	if (isSearchStyleTool(toolName)) return "search";
+	if (isExecStyleTool(toolName)) return "exec";
+	if (isMcpStyleTool(toolName)) return "mcp";
+	return "generic";
+}
+function isReadStyleTool(toolName) {
+	const base = baseToolName(toolName);
+	return [
+		"read",
+		"read_file",
+		"memory_get"
+	].includes(base);
+}
+function isSearchStyleTool(toolName) {
+	const base = baseToolName(toolName);
+	return [
+		"search",
+		"grep",
+		"rg",
+		"ripgrep",
+		"search_code",
+		"file_search",
+		"list_files"
+	].includes(base);
+}
+function isExecStyleTool(toolName) {
+	const base = baseToolName(toolName);
+	return [
+		"bash",
+		"shell",
+		"exec",
+		"run_command",
+		"exec_command",
+		"terminal"
+	].includes(base);
+}
+function isMcpStyleTool(toolName) {
+	return toolName.includes("__");
+}
+function displayToolName(toolName) {
+	const parts = toolName.split("__");
+	if (parts.length === 2 && parts[0] && parts[1]) return `${parts[0]}.${parts[1]}`;
+	return toolName;
+}
+function compactPath(path, maxLength = MAX_PATH_LABEL_LENGTH) {
+	const normalized = path.replace(/\\/g, "/");
+	if (normalized.length <= maxLength) return normalized;
+	const base = basename(normalized);
+	const parent = basename(dirname(normalized));
+	const suffix = parent ? `${parent}/${base}` : base;
+	if (suffix.length + 2 <= maxLength) return `.../${suffix}`;
+	return `.../${base.slice(Math.max(0, base.length - maxLength + 3))}`;
+}
+function formatCollapsedToolSummary(ctx) {
+	if (ctx.isError) {
+		const rows = nonBlankLines(ctx.output).length;
+		return `error; ${rows === 1 ? "1 error line" : `${rows} error lines`}; ${ctx.expandKey} to expand`;
+	}
+	switch (getToolSummaryKind(ctx.toolName)) {
+		case "read": {
+			const rows = new Text(ctx.output, 1, 0).render(80).length;
+			return `  ${rows} ${rows === 1 ? "row" : "rows"}; ${ctx.expandKey} to expand`;
+		}
+		case "search": return formatSearchSummary(ctx.output, ctx.expandKey);
+		case "exec": return formatExecSummary(ctx.output, ctx.details, ctx.isError, ctx.expandKey);
+		case "mcp": return formatMcpSummary(ctx.output, ctx.content, ctx.expandKey);
+		case "generic": return "";
+	}
+}
+function formatExecExpandedOutput(output, details) {
+	const parsed = parseExecDetails(details);
+	const sections = [];
+	const stdout = parsed.stdout ?? output;
+	if (stdout.trim()) sections.push(`stdout\n${stdout}`);
+	if (parsed.stderr?.trim()) sections.push(`stderr\n${parsed.stderr}`);
+	if (parsed.exitCode !== void 0) sections.push(`exit ${parsed.exitCode}`);
+	return sections.join("\n");
+}
+function extractExitCode(details) {
+	return parseExecDetails(details).exitCode;
+}
+function formatCompactReadArgs(args) {
+	if (!args || typeof args !== "object") return null;
+	const record = args;
+	const rawPath = typeof record.path === "string" ? record.path : typeof record.file_path === "string" ? record.file_path : void 0;
+	if (!rawPath) return null;
+	const normalized = rawPath.replace(/\\/g, "/");
+	const base = basename(normalized);
+	let label;
+	if (base === "SKILL.md") {
+		const parent = basename(dirname(normalized));
+		label = parent ? `[skill] ${parent}` : "[skill]";
+	} else if (base === "AGENTS.md") label = `read resource ${compactPath(normalized)}`;
+	else label = compactPath(normalized);
+	const start = firstFiniteNumber(record.offset, record.from, record.start, record.line);
+	const count = firstFiniteNumber(record.limit, record.lines, record.count);
+	if (start != null && count != null && count > 0) label += `:${start}-${start + count - 1}`;
+	return label;
+}
+function commandFromArgs(args) {
+	if (!args || typeof args !== "object") return null;
+	const record = args;
+	const raw = record.command ?? record.cmd ?? record.script;
+	if (Array.isArray(raw)) return raw.map(String).join(" ");
+	if (typeof raw === "string" && raw.trim()) return raw.trim();
+	return null;
+}
+function baseToolName(toolName) {
+	return toolName.split("__").pop()?.toLowerCase() ?? toolName.toLowerCase();
+}
+function firstFiniteNumber(...values) {
+	for (const value of values) {
+		if (typeof value === "number" && Number.isFinite(value)) return Math.floor(value);
+		if (typeof value === "string" && value.trim()) {
+			const parsed = Number(value);
+			if (Number.isFinite(parsed)) return Math.floor(parsed);
+		}
+	}
+	return null;
+}
+function formatArgValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "bigint") return `${value.toString()}n`;
+	if (typeof value === "function") return "[function]";
+	if (typeof value === "symbol") return String(value);
+	if (value instanceof Error) return value.message || value.name;
+	try {
+		const json = JSON.stringify(value);
+		return json === void 0 ? String(value) : json;
+	} catch {
+		return String(value);
+	}
+}
+function formatSearchSummary(output, expandKey) {
+	const lines = nonBlankLines(output);
+	const paths = /* @__PURE__ */ new Set();
+	let matchCount = 0;
+	for (const line of lines) {
+		const path = extractResultPath(line);
+		if (path) paths.add(compactPath(path, 48));
+		if (line.trim()) matchCount += 1;
+	}
+	const matchLabel = matchCount === 1 ? "1 result" : `${matchCount} results`;
+	const fileLabel = paths.size === 0 ? "" : paths.size === 1 ? ` in ${[...paths][0]}` : ` in ${paths.size} files`;
+	const samples = [...paths].slice(0, 3).join(", ");
+	return `${matchLabel}${fileLabel}${samples && paths.size > 1 ? `: ${samples}` : ""}; ${expandKey} to expand`;
+}
+function formatExecSummary(output, details, isError, expandKey) {
+	const parsed = parseExecDetails(details);
+	const rows = nonBlankLines([parsed.stdout, parsed.stderr].filter(Boolean).join("\n") || output).length;
+	return `${parsed.exitCode === void 0 ? isError ? "failed" : "completed" : `exit ${parsed.exitCode}`}; ${rows === 1 ? "1 output line" : `${rows} output lines`}; ${expandKey} to expand`;
+}
+function formatMcpSummary(output, content, expandKey) {
+	if (content?.length) {
+		const counts = /* @__PURE__ */ new Map();
+		for (const block of content) counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+		return `${[...counts.entries()].map(([type, count]) => `${count} ${type}`).join(", ")}; ${expandKey} to expand`;
+	}
+	const rows = nonBlankLines(output).length;
+	return `${rows === 1 ? "1 result line" : `${rows} result lines`}; ${expandKey} to expand`;
+}
+function parseExecDetails(details) {
+	if (!details || typeof details !== "object") return {};
+	const record = details;
+	return {
+		exitCode: numberValue(record.exitCode ?? record.exit_code ?? record.code ?? record.status),
+		stdout: stringValue(record.stdout ?? record.output),
+		stderr: stringValue(record.stderr ?? record.errorOutput ?? record.error_output)
+	};
+}
+function numberValue(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return Math.trunc(value);
+	if (typeof value === "string" && /^-?\d+$/.test(value)) return Number(value);
+}
+function stringValue(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function nonBlankLines(text) {
+	return text.split("\n").filter((line) => line.trim().length > 0);
+}
+function extractResultPath(line) {
+	const trimmed = line.trim();
+	const colonPath = trimmed.match(/^(.+?):\d+(?::\d+)?:/);
+	if (colonPath?.[1]) return colonPath[1];
+	const jsonPath = trimmed.match(/"?(?:path|file|file_path)"?\s*[:=]\s*"([^"]+)"/i);
+	if (jsonPath?.[1]) return jsonPath[1];
+	return null;
+}
+//#endregion
+export { compactPath, displayToolName, extractExitCode, formatArgsSummary, formatCollapsedToolSummary, formatExecExpandedOutput, getToolSummaryKind, isExecStyleTool, isMcpStyleTool, isReadStyleTool, isSearchStyleTool };
+
+//# sourceMappingURL=tool-summary.js.map

package/dist/src/tui/tool-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-summary.js","names":[],"sources":["../../../src/tui/tool-summary.ts"],"sourcesContent":["import { basename, dirname } from 'node:path';\n\nimport { Text } from '@earendil-works/pi-tui';\n\nimport type { TuiToolContentBlock } from './tui-tool-result.js';\n\nconst MAX_ARG_VALUE_LENGTH = 120;\nconst MAX_PATH_LABEL_LENGTH = 72;\n\nexport type ToolSummaryKind = 'read' | 'search' | 'exec' | 'mcp' | 'generic';\n\nexport interface ToolSummaryContext {\n  toolName: string;\n  args: unknown;\n  output: string;\n  content?: TuiToolContentBlock[];\n  details: unknown;\n  isError: boolean;\n  expandKey: string;\n}\n\nexport function formatArgsSummary(args: unknown, toolName: string): string {\n  if (!args || typeof args !== 'object') return '';\n  const compactRead = isReadStyleTool(toolName) ? formatCompactReadArgs(args) : null;\n  if (compactRead) return compactRead;\n  const command = isExecStyleTool(toolName) ? commandFromArgs(args) : null;\n  if (command) return command;\n  const entries = Object.entries(args as Record<string, unknown>);\n  if (entries.length === 0) return '';\n  return entries\n    .map(([key, value]) => {\n      const stringValue = formatArgValue(value);\n      const truncated =\n        stringValue.length > MAX_ARG_VALUE_LENGTH\n          ? `${stringValue.slice(0, MAX_ARG_VALUE_LENGTH - 3)}...`\n          : stringValue;\n      return `${key}=${truncated}`;\n    })\n    .join(', ');\n}\n\nexport function getToolSummaryKind(toolName: string): ToolSummaryKind {\n  if (isReadStyleTool(toolName)) return 'read';\n  if (isSearchStyleTool(toolName)) return 'search';\n  if (isExecStyleTool(toolName)) return 'exec';\n  if (isMcpStyleTool(toolName)) return 'mcp';\n  return 'generic';\n}\n\nexport function isReadStyleTool(toolName: string): boolean {\n  const base = baseToolName(toolName);\n  return ['read', 'read_file', 'memory_get'].includes(base);\n}\n\nexport function isSearchStyleTool(toolName: string): boolean {\n  const base = baseToolName(toolName);\n  return [\n    'search',\n    'grep',\n    'rg',\n    'ripgrep',\n    'search_code',\n    'file_search',\n    'list_files',\n  ].includes(base);\n}\n\nexport function isExecStyleTool(toolName: string): boolean {\n  const base = baseToolName(toolName);\n  return [\n    'bash',\n    'shell',\n    'exec',\n    'run_command',\n    'exec_command',\n    'terminal',\n  ].includes(base);\n}\n\nexport function isMcpStyleTool(toolName: string): boolean {\n  return toolName.includes('__');\n}\n\nexport function displayToolName(toolName: string): string {\n  const parts = toolName.split('__');\n  if (parts.length === 2 && parts[0] && parts[1]) {\n    return `${parts[0]}.${parts[1]}`;\n  }\n  return toolName;\n}\n\nexport function compactPath(path: string, maxLength = MAX_PATH_LABEL_LENGTH): string {\n  const normalized = path.replace(/\\\\/g, '/');\n  if (normalized.length <= maxLength) return normalized;\n  const base = basename(normalized);\n  const parent = basename(dirname(normalized));\n  const suffix = parent ? `${parent}/${base}` : base;\n  if (suffix.length + 2 <= maxLength) return `.../${suffix}`;\n  return `.../${base.slice(Math.max(0, base.length - maxLength + 3))}`;\n}\n\nexport function formatCollapsedToolSummary(ctx: ToolSummaryContext): string {\n  if (ctx.isError) {\n    const rows = nonBlankLines(ctx.output).length;\n    const rowLabel = rows === 1 ? '1 error line' : `${rows} error lines`;\n    return `error; ${rowLabel}; ${ctx.expandKey} to expand`;\n  }\n\n  switch (getToolSummaryKind(ctx.toolName)) {\n    case 'read': {\n      const rows = new Text(ctx.output, 1, 0).render(80).length;\n      const plural = rows === 1 ? 'row' : 'rows';\n      return `  ${rows} ${plural}; ${ctx.expandKey} to expand`;\n    }\n    case 'search':\n      return formatSearchSummary(ctx.output, ctx.expandKey);\n    case 'exec':\n      return formatExecSummary(ctx.output, ctx.details, ctx.isError, ctx.expandKey);\n    case 'mcp':\n      return formatMcpSummary(ctx.output, ctx.content, ctx.expandKey);\n    case 'generic':\n      return '';\n  }\n}\n\nexport function formatExecExpandedOutput(output: string, details: unknown): string {\n  const parsed = parseExecDetails(details);\n  const sections: string[] = [];\n  const stdout = parsed.stdout ?? output;\n  if (stdout.trim()) {\n    sections.push(`stdout\\n${stdout}`);\n  }\n  if (parsed.stderr?.trim()) {\n    sections.push(`stderr\\n${parsed.stderr}`);\n  }\n  if (parsed.exitCode !== undefined) {\n    sections.push(`exit ${parsed.exitCode}`);\n  }\n  return sections.join('\\n');\n}\n\nexport function extractExitCode(details: unknown): number | undefined {\n  return parseExecDetails(details).exitCode;\n}\n\nfunction formatCompactReadArgs(args: unknown): string | null {\n  if (!args || typeof args !== 'object') return null;\n  const record = args as Record<string, unknown>;\n  const rawPath = typeof record.path === 'string'\n    ? record.path\n    : typeof record.file_path === 'string'\n      ? record.file_path\n      : undefined;\n  if (!rawPath) return null;\n\n  const normalized = rawPath.replace(/\\\\/g, '/');\n  const base = basename(normalized);\n  let label: string;\n  if (base === 'SKILL.md') {\n    const parent = basename(dirname(normalized));\n    label = parent ? `[skill] ${parent}` : '[skill]';\n  } else if (base === 'AGENTS.md') {\n    label = `read resource ${compactPath(normalized)}`;\n  } else {\n    label = compactPath(normalized);\n  }\n\n  const start = firstFiniteNumber(record.offset, record.from, record.start, record.line);\n  const count = firstFiniteNumber(record.limit, record.lines, record.count);\n  if (start != null && count != null && count > 0) {\n    label += `:${start}-${start + count - 1}`;\n  }\n  return label;\n}\n\nfunction commandFromArgs(args: unknown): string | null {\n  if (!args || typeof args !== 'object') return null;\n  const record = args as Record<string, unknown>;\n  const raw = record.command ?? record.cmd ?? record.script;\n  if (Array.isArray(raw)) return raw.map(String).join(' ');\n  if (typeof raw === 'string' && raw.trim()) return raw.trim();\n  return null;\n}\n\nfunction baseToolName(toolName: string): string {\n  return toolName.split('__').pop()?.toLowerCase() ?? toolName.toLowerCase();\n}\n\nfunction firstFiniteNumber(...values: unknown[]): number | null {\n  for (const value of values) {\n    if (typeof value === 'number' && Number.isFinite(value)) return Math.floor(value);\n    if (typeof value === 'string' && value.trim()) {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed)) return Math.floor(parsed);\n    }\n  }\n  return null;\n}\n\nfunction formatArgValue(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (typeof value === 'bigint') return `${value.toString()}n`;\n  if (typeof value === 'function') return '[function]';\n  if (typeof value === 'symbol') return String(value);\n  if (value instanceof Error) return value.message || value.name;\n  try {\n    const json = JSON.stringify(value);\n    return json === undefined ? String(value) : json;\n  } catch {\n    return String(value);\n  }\n}\n\nfunction formatSearchSummary(output: string, expandKey: string): string {\n  const lines = nonBlankLines(output);\n  const paths = new Set<string>();\n  let matchCount = 0;\n  for (const line of lines) {\n    const path = extractResultPath(line);\n    if (path) paths.add(compactPath(path, 48));\n    if (line.trim()) matchCount += 1;\n  }\n\n  const matchLabel = matchCount === 1 ? '1 result' : `${matchCount} results`;\n  const fileLabel = paths.size === 0\n    ? ''\n    : paths.size === 1\n      ? ` in ${[...paths][0]}`\n      : ` in ${paths.size} files`;\n  const samples = [...paths].slice(0, 3).join(', ');\n  const sampleSuffix = samples && paths.size > 1 ? `: ${samples}` : '';\n  return `${matchLabel}${fileLabel}${sampleSuffix}; ${expandKey} to expand`;\n}\n\nfunction formatExecSummary(\n  output: string,\n  details: unknown,\n  isError: boolean,\n  expandKey: string,\n): string {\n  const parsed = parseExecDetails(details);\n  const outputText = [parsed.stdout, parsed.stderr].filter(Boolean).join('\\n') || output;\n  const rows = nonBlankLines(outputText).length;\n  const exit = parsed.exitCode === undefined\n    ? isError ? 'failed' : 'completed'\n    : `exit ${parsed.exitCode}`;\n  const rowLabel = rows === 1 ? '1 output line' : `${rows} output lines`;\n  return `${exit}; ${rowLabel}; ${expandKey} to expand`;\n}\n\nfunction formatMcpSummary(\n  output: string,\n  content: TuiToolContentBlock[] | undefined,\n  expandKey: string,\n): string {\n  if (content?.length) {\n    const counts = new Map<string, number>();\n    for (const block of content) {\n      counts.set(block.type, (counts.get(block.type) ?? 0) + 1);\n    }\n    const label = [...counts.entries()]\n      .map(([type, count]) => `${count} ${type}`)\n      .join(', ');\n    return `${label}; ${expandKey} to expand`;\n  }\n  const rows = nonBlankLines(output).length;\n  const rowLabel = rows === 1 ? '1 result line' : `${rows} result lines`;\n  return `${rowLabel}; ${expandKey} to expand`;\n}\n\nfunction parseExecDetails(details: unknown): {\n  exitCode?: number;\n  stdout?: string;\n  stderr?: string;\n} {\n  if (!details || typeof details !== 'object') return {};\n  const record = details as Record<string, unknown>;\n  return {\n    exitCode: numberValue(record.exitCode ?? record.exit_code ?? record.code ?? record.status),\n    stdout: stringValue(record.stdout ?? record.output),\n    stderr: stringValue(record.stderr ?? record.errorOutput ?? record.error_output),\n  };\n}\n\nfunction numberValue(value: unknown): number | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) return Math.trunc(value);\n  if (typeof value === 'string' && /^-?\\d+$/.test(value)) return Number(value);\n  return undefined;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction nonBlankLines(text: string): string[] {\n  return text.split('\\n').filter((line) => line.trim().length > 0);\n}\n\nfunction extractResultPath(line: string): string | null {\n  const trimmed = line.trim();\n  const colonPath = trimmed.match(/^(.+?):\\d+(?::\\d+)?:/);\n  if (colonPath?.[1]) return colonPath[1];\n  const jsonPath = trimmed.match(/\"?(?:path|file|file_path)\"?\\s*[:=]\\s*\"([^\"]+)\"/i);\n  if (jsonPath?.[1]) return jsonPath[1];\n  return null;\n}\n"],"mappings":"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"}

package/dist/src/tui/tui-backend.d.ts

@@ -1,4 +1,5 @@
 import type { ClientHistoryMessage } from '../session/client-history.js';
+import type { SessionTimelineItem } from '../session/transcript-outline.js';
 import type { ExportFormat } from '../session/types.js';
 import type { ReviewContext } from '../review/review-git.js';
 import type { SessionInfo, TuiEventSource } from './tui-types.js';
@@ -62,6 +63,12 @@ export interface TuiSessionStats {
         total: number;
     };
 }
+export interface TuiHistoryWindow {
+    messages: HistoryMessage[];
+    startRowNumber: number;
+    endRowNumber: number;
+    totalRows: number;
+}
 export type TuiExportFormat = ExportFormat | 'html';
 export interface TuiCompactionResult {
     compacted: boolean;
@@ -223,8 +230,17 @@ export interface TuiBackend {
     }): Promise<{
         messages: HistoryMessage[];
     }>;
+    /** Load a bounded transcript window around a persisted row number. */
+    loadHistoryWindow?(opts: {
+        sessionKey: string;
+        rowNumber: number;
+        before?: number;
+        after?: number;
+    }): Promise<TuiHistoryWindow>;
     /** Load current transcript rows as a tree-shaped list. */
     loadTranscriptTree(sessionKey: string): Promise<TuiTranscriptTreeEntry[]>;
+    /** Load current transcript rows as timeline items for turn navigation. */
+    loadTimeline(sessionKey: string): Promise<SessionTimelineItem[]>;
     /** Compute transcript message/token statistics. */
     getSessionStats(sessionKey: string): Promise<TuiSessionStats>;
     /** List sessions. */

package/dist/src/tui/tui-command-formatters.js

@@ -1,8 +1,8 @@
-import { parseAgentSessionKey } from "../routing/session-key-utils.js";
-import { init_agent_session_key } from "../routing/agent-session-key.js";
 import { getLogDir } from "../utils/logger/config.js";
 import { getRuntimeLogStats } from "../utils/logger/stats.js";
 import { init_logger } from "../utils/logger.js";
+import { parseAgentSessionKey } from "../routing/session-key-utils.js";
+import { init_agent_session_key } from "../routing/agent-session-key.js";
 import { resolveConfigPath } from "../config/paths.js";
 import { getProviderDisplayName, getSortedProviders, init_providers, providerSupportsApiKey, providerSupportsOAuth } from "../providers/index.js";
 import { createWorkflowCatalog } from "../agent/workflow/catalog.js";

package/dist/src/tui/tui-commands.d.ts

@@ -1,6 +1,7 @@
 import type { KeybindingsManager, TUI } from '@earendil-works/pi-tui';
 import type { TuiCompactionResult, TuiModelChoice, TuiShareRequest, TuiSessionStats, TuiSessionItem, TuiStartupResources, TuiTranscriptTreeEntry, TuiAgentInfo } from './tui-backend.js';
 import type { ChatLog } from './components/chat-log.js';
+import type { SessionTimelineItem } from '../session/transcript-outline.js';
 import { type TuiHotkeyExtensionShortcut } from './format-tui-hotkeys.js';
 import type { TuiState } from './tui-types.js';
 import { type ReasoningLevel, type ThinkLevel, type VerboseLevel } from '../agent/transcript/thinking-types.js';
@@ -37,6 +38,7 @@ export type CommandHandlerDeps = {
         openSessionPicker: () => void;
         openSessionTree: () => void;
         openTranscriptTree: () => void;
+        openTimeline: (initialSearch?: string) => void;
         openUserMessageFork: () => void;
         openScopedModels: () => void;
         openThinkingSelector: () => void;
@@ -63,6 +65,13 @@ export type CommandHandlerDeps = {
     getSessionStats?: () => TuiSessionStats | Promise<TuiSessionStats>;
     getStartupResources?: () => TuiStartupResources | undefined;
     loadTranscriptTree?: () => TuiTranscriptTreeEntry[] | Promise<TuiTranscriptTreeEntry[]>;
+    loadTimeline?: () => SessionTimelineItem[] | Promise<SessionTimelineItem[]>;
+    loadHistoryWindow?: (opts: {
+        rowNumber: number;
+        before?: number;
+        after?: number;
+    }) => boolean | Promise<boolean>;
+    loadSessionHistory?: () => void | Promise<void>;
     exportSession?: (request: TuiExportRequest) => void | Promise<void>;
     importSession?: (request: TuiImportRequest) => void | Promise<void>;
     createShare?: (request: TuiShareRequest) => void | Promise<void>;

package/dist/src/tui/tui-commands.js

@@ -1,24 +1,26 @@
+import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../storage/sqlite/connection.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, isValidAgentId, normalizeAgentId } from "../routing/agent-session-key.js";
+import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
+import "../storage/sqlite/index.js";
 import { resolveConfigPath } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { init_providers, providerSupportsOAuth } from "../providers/index.js";
-import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../storage/sqlite/connection.js";
 import { GoalService } from "../goals/goal-service.js";
 import "../goals/index.js";
-import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
-import "../storage/sqlite/index.js";
 import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
-import { normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
-import { provenanceTracker } from "../extensions/security.js";
-import "../config/index.js";
 import { ProjectService } from "../projects/project-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../projects/project-agent.js";
 import { inferSuggestedProjectDefaultAgentId } from "../projects/project-agent-suggestion.js";
 import "../projects/index.js";
+import { normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
+import { provenanceTracker } from "../extensions/security.js";
+import "../config/index.js";
+import { theme } from "./theme.js";
 import { getTuiKeybindingsPath } from "./tui-keybindings-file.js";
 import { formatKeyIds, formatXopcTuiHotkeys } from "./format-tui-hotkeys.js";
 import { formatTuiConfigInfo, formatTuiContextInfo, formatTuiLoginInfo, formatTuiModelsInfo, formatTuiSessionInfo, formatTuiSessionListInfo, formatTuiSessionTreeInfo, formatTuiStoredAuthProfilesInfo, formatTuiTranscriptTreeInfo, formatTuiTrustInfo, formatTuiUsageInfo, formatTuiWorkflowDetail, formatTuiWorkflowsInfo, loadTuiChangelogInfo, nextVerboseLevel, parseTuiExportRequest, parseTuiImportRequest, parseTuiShareRequest, writeTuiDebugInfo } from "./tui-command-formatters.js";
+import { buildTuiTimelineTurns, findNearestTimelineTurnByDisplayIndex, findTimelineTurnByNumber } from "./tui-timeline.js";
 import { getAuthStorePath, listAllProfiles, listProfilesForProvider, removeAuthProfile } from "../auth/profiles/profiles.js";
 import { rewriteUnknownSlashAsWorkflow } from "./tui-workflow-slash.js";
 import { formatTuiStartupText } from "./tui-startup-text.js";
@@ -160,6 +162,10 @@ function getSlashCommands(_isLocal, keybindings) {
 			name: "tree",
 			description: "Show grouped session tree"
 		},
+		{
+			name: "timeline",
+			description: "Jump to a previous turn in the current session"
+		},
 		{
 			name: "scoped-models",
 			description: `Choose models for ${modelCycleKey} cycling`
@@ -332,6 +338,82 @@ function defaultAuthProfiles() {
 		getStorePath: () => getAuthStorePath()
 	};
 }
+function timelineUsage() {
+	return ["Usage: /timeline [turn|latest|prev|next|search <text>]", "Examples: /timeline, /timeline 12, /timeline prev, /timeline search deploy"].join("\n");
+}
+function currentTimelineTurnIndex(turns, chatLog) {
+	const viewState = chatLog.getTimelineViewportState();
+	if (viewState.mode === "history") {
+		const current = findNearestTimelineTurnByDisplayIndex(turns, viewState.displayIndex);
+		const index = current ? turns.findIndex((turn) => turn.id === current.id) : -1;
+		return index >= 0 ? index : turns.length - 1;
+	}
+	return turns.length - 1;
+}
+async function runTimelineCommand(commandArgs, deps) {
+	const raw = commandArgs.trim();
+	if (!raw) {
+		if (deps.uiOverlays?.openTimeline) deps.uiOverlays.openTimeline();
+		else {
+			deps.chatLog.addSystem("Timeline picker is not available in this mode.");
+			deps.tui.requestRender();
+		}
+		return;
+	}
+	const [subcommandRaw, ...rest] = raw.split(/\s+/);
+	const subcommand = (subcommandRaw ?? "").toLowerCase();
+	if (subcommand === "search" || subcommand === "find") {
+		if (deps.uiOverlays?.openTimeline) deps.uiOverlays.openTimeline(rest.join(" ").trim());
+		else {
+			deps.chatLog.addSystem("Timeline picker is not available in this mode.");
+			deps.tui.requestRender();
+		}
+		return;
+	}
+	if (subcommand === "latest" || subcommand === "live" || subcommand === "end") {
+		await deps.loadSessionHistory?.();
+		deps.chatLog.jumpToLatest();
+		deps.chatLog.addSystem(theme.dim("Returned to latest transcript view."));
+		deps.tui.requestRender();
+		return;
+	}
+	if (!deps.loadTimeline) {
+		deps.chatLog.addSystem("Timeline is not available in this mode.");
+		deps.tui.requestRender();
+		return;
+	}
+	const turns = buildTuiTimelineTurns(await Promise.resolve(deps.loadTimeline()));
+	if (turns.length === 0) {
+		deps.chatLog.addSystem("No timeline turns found.");
+		deps.tui.requestRender();
+		return;
+	}
+	let target;
+	if (subcommand === "prev" || subcommand === "previous") target = turns[Math.max(0, currentTimelineTurnIndex(turns, deps.chatLog) - 1)];
+	else if (subcommand === "next") target = turns[Math.min(turns.length - 1, currentTimelineTurnIndex(turns, deps.chatLog) + 1)];
+	else {
+		const turnNumber = Number.parseInt(subcommand, 10);
+		if (!Number.isFinite(turnNumber) || String(turnNumber) !== subcommand) {
+			deps.chatLog.addSystem(timelineUsage());
+			deps.tui.requestRender();
+			return;
+		}
+		target = findTimelineTurnByNumber(turns, turnNumber);
+	}
+	if (!target) {
+		deps.chatLog.addSystem(`Timeline turn not found: ${raw}`);
+		deps.tui.requestRender();
+		return;
+	}
+	if (!deps.chatLog.jumpToDisplayIndex(target.displayIndex)) {
+		if ((target.rowNumber !== void 0 && deps.loadHistoryWindow ? await deps.loadHistoryWindow({ rowNumber: target.rowNumber }) : false) && deps.chatLog.jumpToDisplayIndex(target.displayIndex)) {
+			deps.tui.requestRender();
+			return;
+		}
+		deps.chatLog.addSystem(`Turn ${target.turn} is outside loaded history.`);
+	}
+	deps.tui.requestRender();
+}
 function formatAgentsList(agents, currentAgentId) {
 	if (agents.length === 0) return "No agents available.";
 	const current = currentAgentId?.trim().toLowerCase();
@@ -910,6 +992,13 @@ function createTuiCommandHandler(deps) {
 					tui.requestRender();
 				});
 				return;
+			case "timeline":
+				runTimelineCommand(commandArgs, deps).catch((err) => {
+					const errorMessage = err instanceof Error ? err.message : String(err);
+					chatLog.addSystem(`Timeline failed: ${errorMessage}`);
+					tui.requestRender();
+				});
+				return;
 			case "switch": {
 				const modelRef = commandArgs.trim();
 				if (!modelRef) {