@zhushanwen/pi-subagent-workflow 8.7.0 → 8.8.1

package/src/interface/views/format.ts

@@ -1,320 +0,0 @@
-/**
- * Workflow View — Pure formatting functions (FR-4)
- *
- * Stateless functions extracted from WorkflowsView for testability.
- * All functions are pure: no Pi runtime, no side effects.
- */
-
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-
-import type { AgentEventLogEntry } from "@zhushanwen/subagent-core/execution/types.ts";
-import type { ExecutionTraceNode, ToolCallEntry } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
-import type { DoneReason, RunStatus } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
-import { displayAgentName } from "@zhushanwen/subagent-core/shared/agent-ref.ts";
-
-// ── Constants ─────────────────────────────────────────────────
-
-export const SIDEBAR_WIDTH = 24;
-export const PROMPT_FOLD_LINES = 3;
-export const OUTPUT_TRUNCATE_BYTES = 100_000;
-export const ELLIPSIS = "\u2026"; // U+2026
-
-// L2 详情滚动常量（对齐 subagents list-view.ts）。
-/** terminal.rows 读不到时的翻页兜底步长（防 NaN）。 */
-export const PAGE_SCROLL_DEFAULT = 10;
-/** tui.terminal.rows 兜底行数（duck-type 失败时，对齐 subagents TERM_ROWS_FALLBACK）。 */
-export const TERM_ROWS_FALLBACK = 24;
-
-// 跨 view 共享的布局常量（WorkflowsView + detail-content 都用）。
-/** box 左右边框字符宽度（│ x 2），用于内容行截断预算。 */
-export const BOX_BORDER_CHARS = 2;
-/** token 数 → k 单位的除数。 */
-export const BUDGET_TOKENS_DIVISOR = 1000;
-/** Activity 区最多显示的 tool call 条数。 */
-export const MAX_TOOL_CALLS_DISPLAY = 3;
-
-// 时间换算（模块私有常量）。
-const MS_PER_SEC = 1000;
-const SECS_PER_MIN = 60;
-
-/**
- * 可显示的状态文本集合。
- *
- * 包含 RunStatus（"running"|"done" 不直接显示，转 reason）+ DoneReason
- * （completed/failed/aborted/budget_limited/time_limited）+ ExecutionTraceNode.status
- * （含 "pending"——trace 节点的初始态）。
- *
- * 收窄自 string → 显式联合，编译器会在新增 status 时强制 switch 补齐分支。
- */
-type StatusText =
-  | RunStatus
-  | DoneReason
-  | "pending";
-
-// ── Theme interface (avoids importing Pi runtime) ─────────────
-
-export interface ThemeLike {
-  fg(token: string, text: string): string;
-  bold(text: string): string;
-}
-
-// ── Status helpers ────────────────────────────────────────────
-
-/** status → 语义颜色 token（用于给任意文本染色，不含符号）。 */
-function statusColorToken(
-  status: StatusText,
-): "success" | "warning" | "error" | "muted" {
-  switch (status) {
-    case "completed": return "success";
-    case "running": return "warning";
-    case "failed": case "aborted": return "error";
-    default: return "muted";
-  }
-}
-
-export function statusDotStr(
-  status: StatusText,
-  theme: ThemeLike,
-): string {
-  return theme.fg(statusColorToken(status), "●");
-}
-
-/** Format a status badge with color for the header area. */
-export function formatStatusBadge(
-  status: StatusText,
-  theme: ThemeLike,
-): string {
-  switch (status) {
-    case "running": return theme.fg("warning", "\u25CF running");
-    case "completed": return theme.fg("success", "\u2713 completed");
-    case "failed": return theme.fg("error", "\u2717 failed");
-    case "aborted": return theme.fg("error", "\u2717 aborted");
-    case "budget_limited": return theme.fg("error", "\u26A0 budget");
-    case "time_limited": return theme.fg("error", "\u26A0 timeout");
-    default: return theme.fg("muted", status);
-  }
-}
-
-// ── Pure formatting functions ─────────────────────────────────
-
-/** Group trace nodes by phase. Nodes without phase go to "(no phase)". */
-function groupByPhase(nodes: ExecutionTraceNode[]): Map<string, ExecutionTraceNode[]> {
-  const map = new Map<string, ExecutionTraceNode[]>();
-  for (const node of nodes) {
-    const phase = node.phase || "(default)";
-    let arr = map.get(phase);
-    if (!arr) {
-      arr = [];
-      map.set(phase, arr);
-    }
-    arr.push(node);
-  }
- // Sort within each phase by stepIndex ascending (FR-3.2)
-  for (const arr of map.values()) {
-    arr.sort((a, b) => a.stepIndex - b.stepIndex);
-  }
-  return map;
-}
-
-/** Format elapsed time string from startedAt. */
-export function formatElapsed(startedAt?: string, now: number = Date.now()): string {
-  if (!startedAt) return "-";
-  const ms = now - new Date(startedAt).getTime();
-  if (ms < MS_PER_SEC) return "0s";
-  const secs = Math.floor(ms / MS_PER_SEC);
-  if (secs < SECS_PER_MIN) return `${secs}s`;
-  const mins = Math.floor(secs / SECS_PER_MIN);
-  const remSecs = secs % SECS_PER_MIN;
-  return `${mins}m${remSecs}s`;
-}
-
-/**
- * Format elapsed time from integer seconds（live 路径用）。
- * 与 formatElapsed 输出格式一致，但输入是 computeElapsedSeconds 的秒数（非时间戳）。
- */
-export function formatElapsedSeconds(seconds: number): string {
-  if (seconds < 1) return "0s";
-  if (seconds < SECS_PER_MIN) return `${seconds}s`;
-  const mins = Math.floor(seconds / SECS_PER_MIN);
-  const remSecs = seconds % SECS_PER_MIN;
-  return `${mins}m${remSecs}s`;
-}
-
-/**
- * Format a live eventLog entry（live 路径 Activity 区用）。
- *
- *   tool_start → "→ {label}"
- *   tool_end   → "← {label}"（done）/ "✗ {label}"（failed）
- *   turn_end   → "∘ {label}"（turn 摘要）
- *   error      → "✗ {label}"
- *
- * 对齐 subagents formatEventLine 的视觉风格，但用 workflow 的 ThemeLike（无 spinner）。
- */
-export function formatEventLine(entry: AgentEventLogEntry, theme: ThemeLike): string {
-  switch (entry.type) {
-    case "tool_start":
-      return `→ ${entry.label}`;
-    case "tool_end":
-      return entry.status === "failed"
-        ? theme.fg("error", `✗ ${entry.label}`)
-        : `✓ ${entry.label}`;
-    case "turn_end":
-      return theme.fg("dim", `∘ ${entry.label}`);
-    case "error":
-      return theme.fg("error", `✗ ${entry.label}`);
-    default:
-      return entry.label;
-  }
-}
-
-/** Format token + tool call statistics. */
-export function formatTokenStat(
-  usage?: { input: number; output: number },
-  toolCalls?: ToolCallEntry[],
-  elapsed?: string,
-): string {
-  const tokens = usage ? usage.input + usage.output : 0;
-  const tools = toolCalls?.length ?? 0;
-  const base = `${tokens} tok · ${tools} tool calls`;
-  return elapsed ? `${base} · ${elapsed}` : base;
-}
-
-/**
- * renderResult 的文本兜底：从 result.content[0] 提取纯文本。
- * 多处 tool 的 renderResult 曾各自内联此逻辑，提取后统一调用。
- */
-export function renderTextFallback(
-  result: { content?: Array<{ type: string; text?: string }> },
-): string {
-  const first = result.content?.[0];
-  return first?.type === "text" ? (first.text ?? "") : "";
-}
-
-/** Format a single activity line: ToolName(argsPreview). */
-export function formatActivityLine(entry: ToolCallEntry, maxWidth: number): string {
- // 语义阈值与开销：低于此宽度只显名称；括号占 2 字符 (name)。
-  const MIN_ACTIVITY_WIDTH = 10;
-  const PARENS_OVERHEAD = 2;
-  if (maxWidth < MIN_ACTIVITY_WIDTH) return entry.name;
-  const argsBudget = maxWidth - entry.name.length - PARENS_OVERHEAD;
-  if (argsBudget <= 0) return truncateToWidth(entry.name, maxWidth);
-  const truncated = entry.input.length > argsBudget
-    ? entry.input.slice(0, argsBudget - 1) + ELLIPSIS
-    : entry.input;
-  return `${entry.name}(${truncated})`;
-}
-
-// ── ANSI helpers ──────────────────────────────────────────────
-
-/** Measure visible width of a string (strips ANSI escapes, handles CJK/emoji).
- *  Delegates to pi-tui's visibleWidth for accurate width calculation.
- */
-export function visibleLen(s: string): number {
-  return visibleWidth(s);
-}
-
-/** Pad an ANSI-escaped string to a target *visible* width.
- *  只 pad 不截断：超宽时原样返回（调用方负责先截断）。
- *  对齐 subagents 的 padToVisible 语义。
- */
-export function padVisible(s: string, width: number): string {
-  const vl = visibleLen(s);
-  if (vl >= width) return s;
-  return s + " ".repeat(width - vl);
-}
-
-/**
- * 分段着色版填充：title 和 fill 都已着色（含 ANSI），拼接时各自 ANSI 延续。
- * 解决 ANSI 嵌套失色：若用 fg("c1", fill(title, "─", n))，
- * title 内的 \x1b[0m 会重置外层 c1，导致 title 之后的 ─ 失去 c1。
- * 改成 title + fill.repeat(后)，fill 整段保持自己的 ANSI，不依赖外层包裹。
- *
- * 对齐 subagents format.ts segFillColored（同源移植）。
- */
-export function segFillColored(
-  titleStyled: string | undefined,
-  fillStyled: string,
-  width: number,
-): string {
-  if (width <= 0) return "";
-  const fillW = visibleLen(fillStyled);
-  if (!titleStyled || fillW === 0) {
-    return fillStyled.repeat(width);
-  }
-  const tw = visibleLen(titleStyled);
-  if (tw >= width) return truncateToWidth(titleStyled, width);
-  const fillCount = width - tw;
-  return titleStyled + fillStyled.repeat(fillCount);
-}
-
-// ── Phase group (filters empty phases) ────────────────────────
-
-export interface PhaseGroup {
-  name: string;
-  nodes: ExecutionTraceNode[];
-  doneCount: number;
-}
-
-/** The fallback phase name when node has no explicit phase. */
-const NO_PHASE = "(default)";
-
-/** Build phase groups. Nodes without a phase are placed in an unnamed group. */
-export function buildPhaseGroups(nodes: ExecutionTraceNode[]): PhaseGroup[] {
-  const map = groupByPhase(nodes);
-  const result: PhaseGroup[] = [];
-  for (const [name, phaseNodes] of map) {
-    if (phaseNodes.length > 0) {
-      result.push({
-        name: name === NO_PHASE ? "" : name,
-        nodes: phaseNodes,
-        doneCount: phaseNodes.filter((n) => n.status === "completed").length,
-      });
-    }
-  }
-  return result;
-}
-
-// ── Sidebar phase line formatter ─────────────────────────────
-
-export function formatPhaseLine(
-  pg: PhaseGroup,
-  idx: number,
-  isSelected: boolean,
-  theme: ThemeLike,
-  maxWidth: number,
-): string {
-  const pointer = isSelected ? "❯ " : "  ";
-  const dot = statusDotStr(pg.doneCount === pg.nodes.length ? "completed" : "running", theme);
-  const name = pg.name || "(unnamed)";
-  const label = `${idx + 1} ${name} ${pg.doneCount}/${pg.nodes.length}`;
- // pointer(2) + dot(1) + space(1)
-  const PHASE_PREFIX_WIDTH = 4;
-  const budget = maxWidth - PHASE_PREFIX_WIDTH;
-  const truncated = visibleLen(label) > budget
-    ? truncateToWidth(label, budget - 1) + ELLIPSIS
-    : label;
-  return `${pointer}${dot} ${truncated}`;
-}
-
-// ── Agent one-liner for overview right panel ──────────────────
-
-const TOKEN_K = 1000;
-
-export function formatAgentOneLiner(node: ExecutionTraceNode, theme: ThemeLike): string {
-  const dot = statusDotStr(node.status, theme);
-  const elapsed = formatElapsed(
-    node.startedAt,
-    node.completedAt ? new Date(node.completedAt).getTime() : Date.now(),
-  );
-  const tok = node.result?.usage;
-  const tokStr = tok
-    ? `${Math.round((tok.input + tok.output) / TOKEN_K)}k tok`
-    : "";
-  const tcCount = node.result?.toolCalls?.length ?? 0;
-  const parts = [dot, displayAgentName(node.agent), node.model];
-  if (tokStr) parts.push(`${tokStr} · ${tcCount} tools`);
-  parts.push(elapsed);
-  return parts.join("    ");
-}
-
-