@pi-unipi/unipi 2.6.0 → 2.6.2

package/packages/compactor/src/types.ts

@@ -8,12 +8,6 @@ import type { Message } from "@earendil-works/pi-ai";
 // Normalized blocks (from pi-vcc)
 // ─────────────────────────────────────────────────────────
 
-export interface FileOps {
-  readFiles?: string[];
-  modifiedFiles?: string[];
-  createdFiles?: string[];
-}
-
 export type NormalizedBlock =
   | { kind: "user"; text: string; sourceIndex?: number }
   | { kind: "assistant"; text: string; sourceIndex?: number }
@@ -21,6 +15,13 @@ export type NormalizedBlock =
   | { kind: "tool_result"; name: string; text: string; isError: boolean; sourceIndex?: number }
   | { kind: "thinking"; text: string; redacted: boolean; sourceIndex?: number };
 
+/** Hook-provided file activity (pi-vcc parity) — structural signal for ranking */
+export interface FileOps {
+  readFiles?: string[];
+  modifiedFiles?: string[];
+  createdFiles?: string[];
+}
+
 // ─────────────────────────────────────────────────────────
 // Section data (from pi-vcc)
 // ─────────────────────────────────────────────────────────
@@ -32,16 +33,6 @@ export interface SectionData {
   outstandingContext: string[];
   userPreferences: string[];
   briefTranscript: string;
-  transcriptEntries: TranscriptEntry[];
-}
-
-export interface TranscriptEntry {
-  role: "user" | "assistant" | "tool_error";
-  text?: string;
-  tool?: string;
-  cmd?: string;
-  ref?: string;
-  count?: number;
 }
 
 export interface BriefLine {
@@ -49,16 +40,6 @@ export interface BriefLine {
   lines: string[];
 }
 
-/** Runtime stats tracked during a live session. */
-export interface RuntimeStats {
-  bytesReturned: Record<string, number>;
-  bytesSandboxed: number;
-  calls: Record<string, number>;
-  sessionStart: number;
-  cacheHits: number;
-  cacheBytesSaved: number;
-}
-
 // ─────────────────────────────────────────────────────────
 // Compaction input / output
 // ─────────────────────────────────────────────────────────
@@ -66,26 +47,48 @@ export interface RuntimeStats {
 export interface CompileInput {
   messages: Message[];
   previousSummary?: string;
-  fileOps?: FileOps;
 }
 
 export interface CompactionStats {
   summarized: number;
   kept: number;
-  totalMessages: number;
+  totalMessages?: number;
   /** Actual token count from Pi's preparation */
-  tokensBefore: number;
+  tokensBefore?: number;
   /** Estimated tokens after compaction (proportional from kept/total chars) */
-  tokensAfterEst: number;
+  tokensAfterEst?: number;
+  keptUserTurns: number;
+  totalUserTurns: number;
+  requestedKeepUserTurns: number;
+  keepUserTurnsExplicit: boolean;
+  keepFallbackToCompactAll: boolean;
+  /** Set when the tail came from a token-budget cut instead of a user-turn cut. */
+  budgetCut?: BudgetCutKind;
+  keptTokensEst: number;
+  /** True when smart-keep boosted the default keep beyond 1. */
+  smartKeepAdjusted?: boolean;
+  /** Base keep before smart adjustment (for toast like "1→3"). */
+  smartFromKeep?: number;
 }
 
+export type BudgetCutKind = "no_anchor" | "oversized_tail";
+
 export type OwnCutCancelReason =
   | "no_live_messages"
-  | "too_few_live_messages"
-  | "no_user_message";
+  | "too_few_live_messages";
 
 export type OwnCutResult =
-  | { ok: true; messages: Message[]; firstKeptEntryId: string; compactAll: boolean }
+  | {
+      ok: true;
+      messages: Message[];
+      firstKeptEntryId: string;
+      compactAll: boolean;
+      keptUserTurns: number;
+      totalUserTurns: number;
+      requestedKeepUserTurns: number;
+      keepFallbackToCompactAll: boolean;
+      budgetCut?: BudgetCutKind;
+    }
   | { ok: false; reason: OwnCutCancelReason };
 
 // ─────────────────────────────────────────────────────────
@@ -125,25 +128,13 @@ export interface CompactorConfig {
     /** @deprecated Category filtering was never implemented; ignored by runtime. */
     eventCategories: string[];
   };
-  /** @deprecated Project indexing moved to @pi-unipi/cocoindex; retained for config compatibility. */
+  /** @deprecated Retained for config compatibility. */
   fts5Index: CompactorStrategyConfig & { mode: "auto" | "manual" | "off"; chunkSize: number; cacheTtlHours: number };
   sandboxExecution: CompactorStrategyConfig & { mode: "all" | "safe-only" | "off"; allowedLanguages: Language[]; outputLimit: number };
-  /** @deprecated Display profiles were never connected to runtime; retained for config compatibility. */
-  toolDisplay: CompactorStrategyConfig & { mode: "opencode" | "balanced" | "verbose" | "custom"; diffLayout: "auto" | "split" | "unified"; diffIndicator: "bars" | "classic" | "none"; showThinkingLabels: boolean; showUserMessageBox: boolean; showBashSpinner: boolean; showPendingPreviews: boolean };
 
   // Pipeline features
   pipeline: {
-    /** @deprecated Reserved compatibility field; ignored by runtime. */
-    ttlCache: boolean;
     autoInjection: boolean;
-    /** @deprecated Reserved compatibility field; ignored by runtime. */
-    proximityReranking: boolean;
-    /** @deprecated Reserved compatibility field; ignored by runtime. */
-    timelineSort: boolean;
-    /** @deprecated Reserved compatibility field; ignored by runtime. */
-    progressiveThrottling: boolean;
-    /** @deprecated Reserved compatibility field; ignored by runtime. */
-    mmapPragma: boolean;
     customNoisePatterns: string[];
   };
 
@@ -152,9 +143,12 @@ export interface CompactorConfig {
 
   // Global settings
   overrideDefaultCompaction: boolean;
+  /** Boost default keep:1 to a larger tail when it is small (≤5k tok, capped 25k). Explicit keep:N always respected. */
+  smartKeepTail: boolean;
+  /** Ask the agent to continue after automatic (threshold/overflow) compaction. */
+  continueAfterThresholdCompact: boolean;
+  /** Write detailed compaction diagnostics to /tmp/compactor-debug.json. */
   debug: boolean;
-  /** @deprecated Truncation hints were never connected to runtime; retained for config compatibility. */
-  showTruncationHints: boolean;
 }
 
 export type CompactorPreset = "precise" | "balanced" | "thorough" | "lean" | "opencode" | "verbose" | "minimal" | "custom";
@@ -236,61 +230,10 @@ export type Language =
   | "elixir";
 
 // ─────────────────────────────────────────────────────────
-// Content store — REMOVED (moved to @pi-unipi/cocoindex)
+// Content store — REMOVED
 // SearchResult, IndexResult, StoreStats types no longer needed.
 // ─────────────────────────────────────────────────────────
 
-// ─────────────────────────────────────────────────────────
-// Security (from context-mode)
-// ─────────────────────────────────────────────────────────
-
-export type PermissionDecision = "allow" | "deny" | "ask";
-
-export interface SecurityPolicy {
-  allow: string[];
-  deny: string[];
-  ask: string[];
-}
-
-// ─────────────────────────────────────────────────────────
-// Display (from pi-tool-display)
-// ─────────────────────────────────────────────────────────
-
-export type DiffLayout = "auto" | "split" | "unified";
-export type DiffIndicator = "bars" | "classic" | "none";
-export type OutputMode = "hidden" | "summary" | "preview" | "count";
-
-export interface ToolDisplayConfig {
-  registerToolOverrides: {
-    read: boolean;
-    grep: boolean;
-    find: boolean;
-    ls: boolean;
-    bash: boolean;
-    edit: boolean;
-    write: boolean;
-  };
-  enableNativeUserMessageBox: boolean;
-  readOutputMode: OutputMode;
-  searchOutputMode: OutputMode;
-  mcpOutputMode: OutputMode;
-  previewLines: number;
-  expandedPreviewMaxLines: number;
-  bashOutputMode: OutputMode;
-  bashCollapsedLines: number;
-  diffViewMode: DiffLayout;
-  diffIndicatorMode: DiffIndicator;
-  diffSplitMinWidth: number;
-  diffCollapsedLines: number;
-  diffWordWrap: boolean;
-  showTruncationHints: boolean;
-  showRtkCompactionHints: boolean;
-}
-
-// ─────────────────────────────────────────────────────────
-// Runtime counters (live session stats)
-// ─────────────────────────────────────────────────────────
-
 export interface RuntimeCounters {
   sandboxRuns: number;
   searchQueries: number;

package/packages/core/constants.ts

@@ -38,7 +38,6 @@ export const MODULES = {
   FOOTER: "@pi-unipi/footer",
   UPDATER: "@pi-unipi/updater",
   INPUT_SHORTCUTS: "@pi-unipi/input-shortcuts",
-  COCOINDEX: "@pi-unipi/cocoindex",
   IMAGE: "@pi-unipi/image",
 } as const;
 
@@ -134,13 +133,6 @@ export const MEMORY_DEFAULTS = {
 } as const;
 
 /** Memory types */
-export const MEMORY_TYPES = {
-  PREFERENCE: "preference",
-  DECISION: "decision",
-  PATTERN: "pattern",
-  SUMMARY: "summary",
-} as const;
-
 /** Default ralph loop settings */
 export const RALPH_DEFAULTS = {
   MAX_ITERATIONS: 50,
@@ -297,6 +289,7 @@ export const NOTIFY_COMMANDS = {
   SET_NTFY: "notify-set-ntfy",
   TEST: "notify-test",
   RECAP_MODEL: "notify-recap-model",
+  NOTIFY_EVENT: "notify-event",
 } as const;
 
 /** Notify tool names */
@@ -369,23 +362,3 @@ export const COMPACTOR_DEFAULTS = {
   CACHE_TTL_HOURS: 24,
 } as const;
 
-/** CocoIndex minimum supported CLI version. */
-export const COCOINDEX_MIN_VERSION = "1.0" as const;
-
-/** CocoIndex package spec installed by the interactive installer. */
-export const COCOINDEX_PACKAGE_SPEC = `cocoindex[lancedb]>=${COCOINDEX_MIN_VERSION}` as const;
-
-/** CocoIndex tool names */
-export const COCOINDEX_TOOLS = {
-  SEARCH: "cocoindex_search",
-  STATUS: "cocoindex_status",
-} as const;
-
-/** CocoIndex command names */
-export const COCOINDEX_COMMANDS = {
-  UPDATE: "cocoindex-update",
-  STATUS: "cocoindex-status",
-  INIT: "cocoindex-init",
-  SETTINGS: "cocoindex-settings",
-  SEARCH: "cocoindex-search",
-} as const;

package/packages/core/events.ts

@@ -9,8 +9,6 @@
 export const UNIPI_EVENTS = {
   /** Module loaded and ready */
   MODULE_READY: "unipi:module:ready",
-  /** @deprecated No built-in emitter; retained for external compatibility. */
-  MODULE_GONE: "unipi:module:gone",
 
   /** Workflow command started */
   WORKFLOW_START: "unipi:workflow:start",
@@ -24,10 +22,6 @@ export const UNIPI_EVENTS = {
   /** Ralph loop iteration completed */
   RALPH_ITERATION_DONE: "unipi:ralph:iteration:done",
 
-  /** @deprecated No built-in responders; use the info registry and /unipi:info. */
-  MODULE_STATUS_REQUEST: "unipi:module:status:request",
-  /** @deprecated No built-in aggregator; use the info registry and /unipi:info. */
-  MODULE_STATUS_RESPONSE: "unipi:module:status:response",
 
   /** Info screen group registered */
   INFO_GROUP_REGISTERED: "unipi:info:group:registered",
@@ -38,8 +32,6 @@ export const UNIPI_EVENTS = {
   MEMORY_STORED: "unipi:memory:stored",
   /** Memory deleted */
   MEMORY_DELETED: "unipi:memory:deleted",
-  /** @deprecated No built-in emitter; retained for external compatibility. */
-  MEMORY_SEARCHED: "unipi:memory:searched",
   /** Memory consolidation completed */
   MEMORY_CONSOLIDATED: "unipi:memory:consolidated",
 
@@ -60,18 +52,12 @@ export const UNIPI_EVENTS = {
   COMPACTOR_COMPACTED: "unipi:compactor:compacted",
   /** @deprecated Footer reads live Pi session data; retained for compatibility. */
   COMPACTOR_STATS_UPDATED: "unipi:compactor:stats:updated",
-  /** @deprecated No built-in emitter; retained for external compatibility. */
-  UTILITY_CLEANUP_START: "unipi:utility:cleanup:start",
   /** Utility module cleanup completed */
   UTILITY_CLEANUP_DONE: "unipi:utility:cleanup:done",
   /** Utility diagnostics started */
   UTILITY_DIAGNOSTICS_START: "unipi:utility:diagnostics:start",
   /** Utility diagnostics completed */
   UTILITY_DIAGNOSTICS_DONE: "unipi:utility:diagnostics:done",
-  /** @deprecated No built-in emitter; retained for external compatibility. */
-  UTILITY_CACHE_INVALIDATED: "unipi:utility:cache:invalidated",
-  /** @deprecated No built-in emitter; retained for external compatibility. */
-  UTILITY_LIFECYCLE_STATE: "unipi:utility:lifecycle:state",
 
   /** Notification sent */
   NOTIFICATION_SENT: "unipi:notify:sent",
@@ -91,12 +77,6 @@ export const UNIPI_EVENTS = {
   /** Update error */
   UPDATE_ERROR: "unipi:update:error",
 
-  /** @deprecated Reserved external contract; no built-in emitter. */
-  COCOINDEX_UPDATE_STARTED: "unipi:cocoindex:update:started",
-  /** @deprecated Reserved external contract; no built-in emitter. */
-  COCOINDEX_UPDATE_COMPLETED: "unipi:cocoindex:update:completed",
-  /** @deprecated Reserved external contract; no built-in emitter. */
-  COCOINDEX_SEARCH_PERFORMED: "unipi:cocoindex:search:performed",
 } as const;
 
 /** Payload for MODULE_READY / MODULE_GONE */
@@ -151,21 +131,7 @@ export interface UnipiRalphIterationEvent {
   nextIteration: number;
 }
 
-/** @deprecated No built-in responders; retained for compatibility. */
-export interface UnipiStatusRequestEvent {
-  /** Request ID for correlation */
-  requestId: string;
-}
 
-/** @deprecated No built-in aggregator; retained for compatibility. */
-export interface UnipiStatusResponseEvent {
-  /** Request ID this responds to */
-  requestId: string;
-  /** Module name */
-  name: string;
-  /** Module status data */
-  status: Record<string, unknown>;
-}
 
 /** Payload for MEMORY_STORED */
 export interface UnipiMemoryStoredEvent {
@@ -191,15 +157,6 @@ export interface UnipiMemoryDeletedEvent {
   project: string;
 }
 
-/** Payload for MEMORY_SEARCHED */
-export interface UnipiMemorySearchedEvent {
-  /** Search query */
-  query: string;
-  /** Number of results */
-  resultCount: number;
-  /** Project scope */
-  project: string;
-}
 
 /** Payload for MEMORY_CONSOLIDATED */
 export interface UnipiMemoryConsolidatedEvent {
@@ -307,15 +264,6 @@ export interface UnipiUtilityDiagnosticsEvent {
   report?: unknown;
 }
 
-/** Payload for UTILITY_LIFECYCLE_STATE */
-export interface UnipiUtilityLifecycleEvent {
-  /** New lifecycle state */
-  state: "running" | "shutting_down" | "orphaned" | "error";
-  /** Previous state */
-  previousState?: string;
-  /** Reason for state change */
-  reason?: string;
-}
 
 /** Payload for BADGE_GENERATE_REQUEST */
 export interface UnipiBadgeGenerateRequestEvent {
@@ -375,31 +323,8 @@ export interface UnipiUpdateErrorEvent {
   phase: "check" | "install";
 }
 
-/** Payload for COCOINDEX_UPDATE_STARTED */
-export interface UnipiCocoindexUpdateStartedEvent {
-  /** Project directory being indexed */
-  projectDir: string;
-}
 
-/** Payload for COCOINDEX_UPDATE_COMPLETED */
-export interface UnipiCocoindexUpdateCompletedEvent {
-  /** Whether the update succeeded */
-  success: boolean;
-  /** Number of chunks processed */
-  chunksProcessed: number;
-  /** Duration in ms */
-  durationMs: number;
-  /** Error message if failed */
-  error?: string;
-}
 
-/** Payload for COCOINDEX_SEARCH_PERFORMED */
-export interface UnipiCocoindexSearchPerformedEvent {
-  /** Search query */
-  query: string;
-  /** Number of results */
-  resultCount: number;
-}
 
 /** Payload for NOTIFICATION_SENT */
 export interface UnipiNotificationSentEvent {
@@ -421,11 +346,8 @@ export type UnipiEventPayload =
   | UnipiWorkflowEvent
   | UnipiRalphLoopEvent
   | UnipiRalphIterationEvent
-  | UnipiStatusRequestEvent
-  | UnipiStatusResponseEvent
   | UnipiMemoryStoredEvent
   | UnipiMemoryDeletedEvent
-  | UnipiMemorySearchedEvent
   | UnipiMemoryConsolidatedEvent
   | UnipiInfoGroupEvent
   | UnipiInfoDataEvent
@@ -436,14 +358,10 @@ export type UnipiEventPayload =
   | UnipiCompactorStatsEvent
   | UnipiUtilityCleanupEvent
   | UnipiUtilityDiagnosticsEvent
-  | UnipiUtilityLifecycleEvent
   | UnipiNotificationSentEvent
   | UnipiBadgeGenerateRequestEvent
   | UnipiAskUserPromptEvent
   | UnipiUpdateCheckEvent
   | UnipiUpdateAvailableEvent
   | UnipiUpdateAppliedEvent
-  | UnipiUpdateErrorEvent
-  | UnipiCocoindexUpdateStartedEvent
-  | UnipiCocoindexUpdateCompletedEvent
-  | UnipiCocoindexSearchPerformedEvent;
+  | UnipiUpdateErrorEvent;

package/packages/core/index.ts

@@ -10,4 +10,5 @@ export * from "./sandbox.js";
 export * from "./utils.js";
 export * from "./model-cache.js";
 export * from "./tui-width.js";
+export * from "./tui-overlay.js";
 export * from "./bounded-output.js";

package/packages/core/model-cache.ts

@@ -9,14 +9,18 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 
-/** Path to the model cache directory */
-const CACHE_DIR = path.join(
-  process.env.HOME ?? process.env.USERPROFILE ?? "~",
-  ".unipi/config",
-);
+/** Resolve the model cache directory at call time (respects HOME changes). */
+function cacheDir(): string {
+  return path.join(
+    process.env.HOME ?? process.env.USERPROFILE ?? "~",
+    ".unipi/config",
+  );
+}
 
-/** Path to the model cache file */
-const CACHE_FILE = path.join(CACHE_DIR, "models-cache.json");
+/** Resolve the model cache file path at call time. */
+function cacheFile(): string {
+  return path.join(cacheDir(), "models-cache.json");
+}
 
 /** A single cached model entry */
 export interface CachedModel {
@@ -42,8 +46,9 @@ export interface ModelCache {
  */
 export function readModelCache(): CachedModel[] {
   try {
-    if (!fs.existsSync(CACHE_FILE)) return [];
-    const parsed = JSON.parse(fs.readFileSync(CACHE_FILE, "utf-8"));
+    const file = cacheFile();
+    if (!fs.existsSync(file)) return [];
+    const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
     return Array.isArray(parsed.models) ? parsed.models : [];
   } catch {
     return [];
@@ -56,14 +61,15 @@ export function readModelCache(): CachedModel[] {
  */
 export function writeModelCache(models: CachedModel[]): void {
   try {
-    if (!fs.existsSync(CACHE_DIR)) {
-      fs.mkdirSync(CACHE_DIR, { recursive: true });
+    const dir = cacheDir();
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
     }
     const cache: ModelCache = {
       updatedAt: new Date().toISOString(),
       models,
     };
-    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2) + "\n", "utf-8");
+    fs.writeFileSync(cacheFile(), JSON.stringify(cache, null, 2) + "\n", "utf-8");
   } catch {
     // Best effort — cache is optional
   }

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",
@@ -25,10 +25,12 @@
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",
+    "@earendil-works/pi-tui": "^0.80.0",
     "typebox": "^1.1.38"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",
+    "@earendil-works/pi-tui": "^0.80.0",
     "typebox": "^1.1.38",
     "@types/node": "^22.0.0"
   },

package/packages/core/tui-overlay.ts

@@ -0,0 +1,89 @@
+/**
+ * @pi-unipi/core — Shared TUI overlay helpers
+ *
+ * Eliminates the frameLine/borderLine/ruleLine/fg/bold duplication across
+ * 9+ overlay files. Each overlay creates an OverlayTheme instance and
+ * delegates box-drawing and theming to it.
+ *
+ * The key-handling bug (raw \x1b comparisons vs matchesKey) would have been
+ * caught at one site instead of 10 if these helpers had existed from the start.
+ */
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { safeRepeat } from "./tui-width.ts";
+
+/** ANSI codes used when no Theme is available (terminal default). */
+const FALLBACK_COLORS: Record<string, string> = {
+  accent: "\x1b[36m",
+  success: "\x1b[32m",
+  warning: "\x1b[33m",
+  error: "\x1b[31m",
+  dim: "\x1b[2m",
+  borderMuted: "\x1b[90m",
+};
+
+/**
+ * Shared theme + box-drawing helper for TUI overlays.
+ *
+ * Usage:
+ * ```ts
+ * class MyOverlay implements Component {
+ *   private overlay = new OverlayTheme();
+ *
+ *   setTheme(theme: Theme) { this.overlay.setTheme(theme); }
+ *
+ *   render(width: number): string[] {
+ *     const inner = boxInnerWidth(width);
+ *     return [
+ *       this.overlay.borderLine(inner, "top"),
+ *       this.overlay.frameLine("Title", inner),
+ *       this.overlay.borderLine(inner, "bottom"),
+ *     ];
+ *   }
+ * }
+ * ```
+ */
+export class OverlayTheme {
+  private theme: Theme | null = null;
+
+  setTheme(theme: Theme | null): void {
+    this.theme = theme;
+  }
+
+  /** Color text using the active theme, or a fallback ANSI code. */
+  fg(color: string, text: string): string {
+    if (this.theme) return this.theme.fg(color as never, text);
+    return `${FALLBACK_COLORS[color] ?? ""}${text}\x1b[0m`;
+  }
+
+  /** Bold text using the active theme, or a fallback ANSI code. */
+  bold(text: string): string {
+    if (this.theme) return this.theme.bold(text);
+    return `\x1b[1m${text}\x1b[0m`;
+  }
+
+  /** Background color using the active theme, or text unchanged. */
+  bg(color: string, text: string): string {
+    if (this.theme) return this.theme.bg(color as never, text);
+    return text;
+  }
+
+  /** Frame a content line with `│` borders, padded and truncated to innerWidth. */
+  frameLine(content: string, innerWidth: number): string {
+    const truncated = truncateToWidth(content, innerWidth, "");
+    const padding = Math.max(0, innerWidth - visibleWidth(truncated));
+    return `${this.fg("borderMuted", "│")}${truncated}${safeRepeat(" ", padding)}${this.fg("borderMuted", "│")}`;
+  }
+
+  /** Horizontal rule: `├───┤`. */
+  ruleLine(innerWidth: number): string {
+    return this.fg("borderMuted", `├${safeRepeat("─", innerWidth)}┤`);
+  }
+
+  /** Top or bottom border: `┌───┐` / `└───┘`. */
+  borderLine(innerWidth: number, edge: "top" | "bottom"): string {
+    const left = edge === "top" ? "┌" : "└";
+    const right = edge === "top" ? "┐" : "┘";
+    return this.fg("borderMuted", `${left}${safeRepeat("─", innerWidth)}${right}`);
+  }
+}

package/packages/core/tui-width.ts

@@ -125,3 +125,21 @@ export class WidthKeyedCache {
     this.width = -1;
   }
 }
+
+/** Shared ANSI escape codes for TUI overlays. */
+export const ansi = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  gray: "\x1b[90m",
+  white: "\x1b[37m",
+  blue: "\x1b[34m",
+};
+
+/** Toggle symbols for TUI settings overlays. */
+export const TOGGLE_ON = `${ansi.green}●${ansi.reset}`;
+export const TOGGLE_OFF = `${ansi.dim}○${ansi.reset}`;