@pi-unipi/core 0.1.10 → 0.1.12

package/constants.ts

@@ -158,9 +158,11 @@ export const UTILITY_COMMANDS = {
   CLEANUP: "cleanup",
   ENV: "env",
   DOCTOR: "doctor",
-  NAME_BADGE: "name-badge",
+  BADGE_NAME: "badge-name",
   BADGE_GEN: "badge-gen",
   BADGE_TOGGLE: "badge-toggle",
+  BADGE_SETTINGS: "badge-settings",
+  UTIL_SETTINGS: "util-settings",
 } as const;
 
 /** Utility tool names */
@@ -247,7 +249,6 @@ export const COMPACTOR_DIRS = {
 export const KANBOARD_COMMANDS = {
   KANBOARD: "kanboard",
   KANBOARD_DOCTOR: "kanboard-doctor",
-  NAME_GEN: "name-gen",
 } as const;
 
 /** Kanboard directory paths */

package/events.ts

@@ -78,6 +78,9 @@ export const UNIPI_EVENTS = {
 
   /** Badge generation requested (from kanboard or other module) */
   BADGE_GENERATE_REQUEST: "unipi:badge:generate:request",
+
+  /** Agent asked user a question (ask_user tool invoked) */
+  ASK_USER_PROMPT: "unipi:ask-user:prompt",
 } as const;
 
 /** Payload for MODULE_READY / MODULE_GONE */
@@ -306,6 +309,20 @@ export interface UnipiBadgeGenerateRequestEvent {
   conversationSummary?: string;
 }
 
+/** Payload for ASK_USER_PROMPT */
+export interface UnipiAskUserPromptEvent {
+  /** Question being asked */
+  question: string;
+  /** Additional context */
+  context?: string;
+  /** Number of options provided */
+  optionCount?: number;
+  /** Whether multi-select mode */
+  allowMultiple?: boolean;
+  /** Whether freeform input allowed */
+  allowFreeform?: boolean;
+}
+
 /** Payload for NOTIFICATION_SENT */
 export interface UnipiNotificationSentEvent {
   /** Event type that triggered notification */
@@ -341,4 +358,5 @@ export type UnipiEventPayload =
   | UnipiUtilityDiagnosticsEvent
   | UnipiUtilityLifecycleEvent
   | UnipiNotificationSentEvent
-  | UnipiBadgeGenerateRequestEvent;
+  | UnipiBadgeGenerateRequestEvent
+  | UnipiAskUserPromptEvent;

package/index.ts

@@ -8,3 +8,4 @@ export * from "./constants.js";
 export * from "./events.js";
 export * from "./sandbox.js";
 export * from "./utils.js";
+export * from "./model-cache.js";

package/model-cache.ts

@@ -0,0 +1,70 @@
+/**
+ * @pi-unipi/core — Model Cache
+ *
+ * File-based model list cache at ~/.unipi/config/models-cache.json.
+ * Allows TUI components and other packages to list available models
+ * without needing ctx.modelRegistry at runtime.
+ */
+
+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",
+);
+
+/** Path to the model cache file */
+const CACHE_FILE = path.join(CACHE_DIR, "models-cache.json");
+
+/** A single cached model entry */
+export interface CachedModel {
+  /** Model provider (e.g. "openai", "anthropic") */
+  provider: string;
+  /** Model ID (e.g. "gpt-4o", "claude-sonnet-4-6") */
+  id: string;
+  /** Optional display name */
+  name?: string;
+}
+
+/** The full model cache structure */
+export interface ModelCache {
+  /** ISO timestamp of last cache write */
+  updatedAt: string;
+  /** List of cached models */
+  models: CachedModel[];
+}
+
+/**
+ * Read cached model list from disk.
+ * Returns empty array if no cache file exists or it's malformed.
+ */
+export function readModelCache(): CachedModel[] {
+  try {
+    if (!fs.existsSync(CACHE_FILE)) return [];
+    const parsed = JSON.parse(fs.readFileSync(CACHE_FILE, "utf-8"));
+    return Array.isArray(parsed.models) ? parsed.models : [];
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Write model list to cache file.
+ * Creates directory if needed. Best effort — silently ignores errors.
+ */
+export function writeModelCache(models: CachedModel[]): void {
+  try {
+    if (!fs.existsSync(CACHE_DIR)) {
+      fs.mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    const cache: ModelCache = {
+      updatedAt: new Date().toISOString(),
+      models,
+    };
+    fs.writeFileSync(CACHE_FILE, 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": "0.1.10",
+  "version": "0.1.12",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",