@pi-unipi/core 2.6.0 → 2.9.0

package/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/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/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/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/package.json

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

package/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.js";
+
+/** 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/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}`;

package/utils.ts

@@ -303,3 +303,46 @@ export async function withHerdrBlocked<T>(
     event(false);
   }
 }
+
+/** Format a token count for display (e.g. 1234 → "1.2k", 1500000 → "1.5M"). */
+export function formatTokens(n: number): string {
+  if (n < 1000) return String(n);
+  if (n < 10_000) return `${(n / 1000).toFixed(1)}k`;
+  if (n < 1_000_000) return `${Math.round(n / 1000)}k`;
+  if (n < 10_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+  return `${Math.round(n / 1_000_000)}M`;
+}
+
+/** Check if a snapshot is active by checking its details.active field or content. */
+export function isActiveSnapshot(snapshot: { content: unknown; details?: { active?: boolean } }): boolean {
+  if (typeof snapshot.details?.active === "boolean") return snapshot.details.active;
+  return typeof snapshot.content === "string" && snapshot.content.includes("Status: active");
+}
+
+/** Compare two semver-ish version strings.
+ * Returns 1 when a > b, -1 when a < b, 0 when equal.
+ * Handles `v` prefix, splits on `.` or `-`, ignores non-numeric suffixes. */
+export function compareVersions(a: string, b: string): number {
+  const parse = (version: string): number[] => version
+    .replace(/^v/, "")
+    .split(/[.-]/)
+    .slice(0, 3)
+    .map((part) => {
+      const parsed = Number.parseInt(part, 10);
+      return Number.isNaN(parsed) ? 0 : parsed;
+    });
+
+  const left = parse(a);
+  const right = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const diff = (left[i] ?? 0) - (right[i] ?? 0);
+    if (diff > 0) return 1;
+    if (diff < 0) return -1;
+  }
+  return 0;
+}
+
+/** Return true only when `latest` is newer than `current`. */
+export function isNewerVersion(latest: string, current: string): boolean {
+  return compareVersions(latest, current) > 0;
+}