@pi-unipi/unipi 2.6.0 → 2.6.1

package/CHANGELOG.md

@@ -6,6 +6,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.6.1] — 2026-08-20
+
+This release fixes the notify settings overlay and recap model selector in terminals using the kitty keyboard protocol (Ghostty under Herdr), and makes the model selector reflect Pi's live model registry.
+
+### Fixed
+
+- `notify`: settings overlay and recap model selector match Up/Down/Escape/Enter/Tab/Space/Backspace via `matchesKey()` from `@earendil-works/pi-tui` instead of raw byte comparison — under the kitty keyboard protocol Escape arrives as `\x1b[27u` (Ctrl+C as `\x1b[99;5u`), so arrows/Escape silently did nothing and the selector could trap the user (issue #27).
+- `notify`: Ctrl+C now always closes both overlays, even mid-filter.
+- `notify`: recap model selector lists models injected from Pi's live `ctx.modelRegistry` instead of relying solely on `~/.unipi/config/models-cache.json`; when neither source has models it shows an actionable hint instead of a bare "No models found".
+- `core`: model-cache paths are resolved per call (respects `HOME` changes; enables isolated tests).
+
+### Added
+
+- `/unipi:notify-event <event> <on|off>` — toggle a notify event without the TUI (escape hatch for terminals with overlay input problems); reports the resulting value and reminds that `/reload` re-registers listeners.
+
+### Changed
+
+- `notify`: arrows navigate inside selector filter mode without leaving it; `m` and `M` both open the model selector from the Recap tab.
+
 ## [2.6.0] — 2026-08-14
 
 This release completes UniPi's provider prefix-cache preservation rollout, making model-visible state append-only within explicit cache epochs while adding privacy-safe diagnostics and bounded external results.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -77,26 +77,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.6.0",
-    "@pi-unipi/btw": "2.6.0",
-    "@pi-unipi/compactor": "2.6.0",
-    "@pi-unipi/notify": "2.6.0",
-    "@pi-unipi/command-enchantment": "2.6.0",
-    "@pi-unipi/core": "2.6.0",
-    "@pi-unipi/info-screen": "2.6.0",
-    "@pi-unipi/mcp": "2.6.0",
-    "@pi-unipi/memory": "2.6.0",
-    "@pi-unipi/ralph": "2.6.0",
-    "@pi-unipi/subagents": "2.6.0",
-    "@pi-unipi/utility": "2.6.0",
-    "@pi-unipi/milestone": "2.6.0",
-    "@pi-unipi/kanboard": "2.6.0",
-    "@pi-unipi/web-api": "2.6.0",
-    "@pi-unipi/workflow": "2.6.0",
-    "@pi-unipi/footer": "2.6.0",
-    "@pi-unipi/updater": "2.6.0",
-    "@pi-unipi/input-shortcuts": "2.6.0",
-    "@pi-unipi/cocoindex": "2.6.0"
+    "@pi-unipi/ask-user": "2.6.1",
+    "@pi-unipi/btw": "2.6.1",
+    "@pi-unipi/compactor": "2.6.1",
+    "@pi-unipi/notify": "2.6.1",
+    "@pi-unipi/command-enchantment": "2.6.1",
+    "@pi-unipi/core": "2.6.1",
+    "@pi-unipi/info-screen": "2.6.1",
+    "@pi-unipi/mcp": "2.6.1",
+    "@pi-unipi/memory": "2.6.1",
+    "@pi-unipi/ralph": "2.6.1",
+    "@pi-unipi/subagents": "2.6.1",
+    "@pi-unipi/utility": "2.6.1",
+    "@pi-unipi/milestone": "2.6.1",
+    "@pi-unipi/kanboard": "2.6.1",
+    "@pi-unipi/web-api": "2.6.1",
+    "@pi-unipi/workflow": "2.6.1",
+    "@pi-unipi/footer": "2.6.1",
+    "@pi-unipi/updater": "2.6.1",
+    "@pi-unipi/input-shortcuts": "2.6.1",
+    "@pi-unipi/cocoindex": "2.6.1"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.80.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/autocomplete/src/constants.ts

@@ -169,6 +169,7 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:notify-set-ntfy":  "notify",
   "unipi:notify-test":      "notify",
   "unipi:notify-recap-model": "notify",
+  "unipi:notify-event":     "notify",
 
   // kanboard (2 commands)
   "unipi:kanboard":          "kanboard",
@@ -282,6 +283,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:notify-set-ntfy":  "Set up ntfy push notifications",
   "unipi:notify-test":      "Test all enabled notification platforms",
   "unipi:notify-recap-model": "Select model for notification recaps",
+  "unipi:notify-event":     "Toggle a notify event without the TUI: <event> <on|off>",
 
   "unipi:milestone-onboard": "Create MILESTONES.md from existing workflow docs",
   "unipi:milestone-update":  "Sync MILESTONES.md with completed work",

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.80.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "pi": {
     "extensions": [],

package/packages/cocoindex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/cocoindex",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "CocoIndex integration for Pi — AST-aware content indexing, semantic vector search, and incremental pipeline management",
   "type": "module",
   "main": "index.ts",
@@ -26,7 +26,7 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "optionalDependencies": {
     "@lancedb/lancedb": "^0.21.0"

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0",
-    "@pi-unipi/info-screen": "2.6.0",
+    "@pi-unipi/core": "2.6.1",
+    "@pi-unipi/info-screen": "2.6.1",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "peerDependencies": {

package/packages/core/constants.ts

@@ -297,6 +297,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 */

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",

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Image generation and image recognition tools for the Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.80.0",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -43,8 +43,8 @@
     "better-sqlite3": "^12.9.0",
     "sqlite-vec": "^0.1.9",
     "js-yaml": "^4.1.0",
-    "@pi-unipi/core": "2.6.0",
-    "@pi-unipi/info-screen": "2.6.0"
+    "@pi-unipi/core": "2.6.1",
+    "@pi-unipi/info-screen": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Lifecycle layer for project-level goals — MILESTONES.md tracking, session hooks, auto-sync",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0"
+    "@pi-unipi/core": "2.6.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/notify/README.md

@@ -13,6 +13,7 @@ Configure once, get alerts everywhere. Per-event platform routing lets you send
 | `/unipi:notify-set-tg` | Interactive Telegram bot setup |
 | `/unipi:notify-set-ntfy` | Configure ntfy topic and server |
 | `/unipi:notify-recap-model` | Set model for notification recaps |
+| `/unipi:notify-event` | Toggle a single event without the TUI (`<event> <on\|off>`) — reports the new value; run `/reload` to re-register listeners |
 | `/unipi:notify-test` | Send test notification to all enabled platforms |
 
 ## Special Triggers

package/packages/notify/commands.ts

@@ -12,13 +12,32 @@ import { GotifySetupOverlay } from "./tui/gotify-setup.js";
 import { TelegramSetupOverlay } from "./tui/telegram-setup.js";
 import { NtfySetupOverlay } from "./tui/ntfy-setup.js";
 import { RecapModelSelectorOverlay } from "./tui/recap-model-selector.js";
-import { loadConfig } from "./settings.js";
+import type { CachedModel } from "@pi-unipi/core";
+import { loadConfig, saveConfig } from "./settings.js";
 import { loadNtfyConfig } from "./ntfy-config.js";
 import { sendNativeNotification, SuppressedError } from "./platforms/native.js";
 import { sendGotifyNotification } from "./platforms/gotify.js";
 import { sendTelegramNotification } from "./platforms/telegram.js";
 import { sendNtfyNotification } from "./platforms/ntfy.js";
 
+/**
+ * Collect models for the recap selector from Pi's live model registry.
+ * Returns undefined when the registry is unavailable so the overlay can fall
+ * back to the project-wide model cache (issue #27: selector was empty because
+ * it only read ~/.unipi/config/models-cache.json, which may not exist even
+ * when models are configured in ~/.pi/agent/models.json).
+ */
+function registryModels(ctx: ExtensionContext): CachedModel[] | undefined {
+  const registry = ctx.modelRegistry;
+  if (!registry) return undefined;
+  try {
+    const models = registry.getAvailable?.() ?? registry.getAll() ?? [];
+    return models.map((m) => ({ provider: m.provider, id: m.id, name: m.name }));
+  } catch {
+    return undefined;
+  }
+}
+
 /**
  * Register notify commands.
  */
@@ -44,7 +63,7 @@ export function registerNotifyCommands(pi: ExtensionAPI): void {
               // Open model selector as nested overlay
               ctx.ui.custom(
                 (innerTui: any, innerTheme: any, _innerKb: any, innerDone: any) => {
-                  const selector = new RecapModelSelectorOverlay();
+                  const selector = new RecapModelSelectorOverlay(registryModels(ctx));
                   selector.setTheme(innerTheme);
                   selector.onClose = () => innerDone(undefined);
                   selector.requestRender = () => innerTui.requestRender();
@@ -102,9 +121,10 @@ export function registerNotifyCommands(pi: ExtensionAPI): void {
           return;
         }
 
+        const models = registryModels(ctx);
         ctx.ui.custom(
           (tui, theme, _keybindings, done) => {
-            const overlay = new RecapModelSelectorOverlay();
+            const overlay = new RecapModelSelectorOverlay(models);
             overlay.setTheme(theme);
             overlay.onClose = () => done(undefined);
             overlay.requestRender = () => tui.requestRender();
@@ -251,6 +271,44 @@ export function registerNotifyCommands(pi: ExtensionAPI): void {
     }
   );
 
+  // /unipi:notify-event <event> <on|off> — Non-TUI event toggle (issue #27 escape
+  // hatch for terminals where overlay input is unusable)
+  pi.registerCommand(
+    `${UNIPI_PREFIX}${NOTIFY_COMMANDS.NOTIFY_EVENT}`,
+    {
+      description: "Toggle a notify event without the TUI: <event> <on|off>",
+      handler: async (args: string, ctx: ExtensionContext) => {
+        const parts = args.trim().split(/\s+/).filter(Boolean);
+        const [event, value] = parts;
+
+        if (parts.length !== 2 || (value !== "on" && value !== "off")) {
+          ctx.ui.notify(
+            "Usage: /unipi:notify-event <event> <on|off>",
+            "warning"
+          );
+          return;
+        }
+
+        const config = loadConfig();
+        if (!(event in config.events)) {
+          const known = Object.keys(config.events).join(", ");
+          ctx.ui.notify(
+            `Unknown event "${event}". Known events: ${known}`,
+            "error"
+          );
+          return;
+        }
+
+        config.events[event].enabled = value === "on";
+        saveConfig(config);
+        ctx.ui.notify(
+          `notify: ${event} is now ${value}. Run /reload to re-register listeners.`,
+          "info"
+        );
+      },
+    }
+  );
+
   // /unipi:notify-test — Send test notification to all enabled platforms
   pi.registerCommand(
     `${UNIPI_PREFIX}${NOTIFY_COMMANDS.TEST}`,

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0",
+    "@pi-unipi/core": "2.6.1",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {