@pi-unipi/unipi 3.0.0-alpha.4 → 3.0.0-alpha.5

package/CHANGELOG.md

@@ -6,6 +6,37 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.5] — 2026-09-28
+
+### Breaking Changes
+
+- **BREAKING: `@pi-unipi/image` removed.** Image generation, editing and recognition now live in `@pi-unipi/utility` (same `image` settings namespace, so existing configs keep working). **Migration path:** nothing to do with the umbrella package; if you installed `@pi-unipi/image` on its own, remove it and use `@pi-unipi/utility`.
+- **BREAKING: utility slimmed.** Removed `/unipi:reload` (use pi's `/reload`), `/unipi:status`, `/unipi:env`, `/unipi:prefix-cache`, the agent tools `ctx_env` and `set_session_name`, the top name-badge bar, the analytics collector and the process-lifecycle signal handlers. **Migration path:** `/unipi:doctor` covers the health checks; sessions are named automatically (below) or with pi's `/name`. Old `badge.*` settings carry over to `rename.*`.
+- **BREAKING: skill exposure moved** from `utility.skills` to the new `skills` namespace (`@pi-unipi/skill-registry`). Migrated automatically on first read.
+
+### Added
+
+- `utility`: `/unipi:retry`, an alias of `/unipi:continue`.
+- `utility`: **automatic session naming.** After each round, jev checks whether the round (your message plus what the agent did) established a subject and, for a named session, whether it moved to a different task; a throwaway session with a single `rename_session` tool writes the name. Greetings never rename; names set with `/name` are never overwritten; Herdr pane/tab sync kept.
+- `utility`: **`/unipi:answer`** — answer the last reply without scrolling: `reply` (default: the reply scrolls above a fixed input box, like `/unipi:btw`), `questions` (one answer per question, Q/A template) or `web` (local form; over SSH it prints the `ssh -L` forward). A hint above the editor says when a reply asks questions.
+- `utility`: **pasted images and files** become `[Image #N]` / `[File #N]` attachments with a chip row above the editor and inline previews in Kitty, Ghostty, iTerm2 and WezTerm; images are sent to the model as images.
+- `utility`: **image tools** `image_generate`, `image_edit` (new) and `image_recognize`, with OpenRouter, fal and custom-endpoint routes, a key per provider, and model pickers filtered by input/output modality. Default model FLUX.2 [klein] 4B.
+- `utility`: **response formatting** — Settings → Utility → Response formatting: `simple` (one line per tool), `regular` (pi's own) or `advanced` (highlighted commands incl. embedded heredoc/`-c` code, tinted syntax-highlighted diffs, test summaries, exit lines).
+- `utility`: `/unipi:settings <search>` opens the hub filtered; typing `/settings` lists `/unipi:settings` first.
+- `skill-registry`: now a real extension. **Skill settings…** grid (`/unipi:skills` → Skill settings…): per skill Enabled / Discoverable / Must show, per global or project scope, plus a skill vault at `~/.unipi/skill-vault` whose skills stay off until a scope turns them on (skill proxy, off by default).
+- `core`: the shared model cache (`~/.unipi/config/models-cache.json`) records input/output modalities; the settings hub pickers and kanboard read it.
+
+### Changed
+
+- `skill-registry`: skill judging keeps skills named in the request, lists hidden skills by name in the system prompt, waits for the first real request instead of freezing on a greeting, and caps generic workflow skills.
+- `fusion`: `/unipi:model` lists only your preset lead/sidekick models; typing searches the whole catalogue (also inside the lead/sidekick dropdowns).
+- `utility`: `/unipi:cleanup` only removes files on an explicit list, previews them and asks first; v2 memory backups can never be removed. `/unipi:doctor` checks the model cache, the Decision Model key and skill exposure.
+
+### Fixed
+
+- `image`: generation failed for most users (only a pi-ai OpenRouter route with a key pi often couldn't see) and failures were reported to the agent as successes.
+- `core`: capability-filtered model pickers hide entries with no declared input again.
+
 ## [3.0.0-alpha.4] — 2026-09-28
 
 ### Breaking Changes

package/README.md

@@ -33,7 +33,6 @@ pi install npm:@pi-unipi/unipi
 
 **[Web API](./packages/web-api/README.md)** — Web search, page reading, content summarization. Defaults to [wigolo](https://github.com/KnockOutEZ/wigolo), a local-first engine with multi-engine search and on-device reranking — $0/query, no API key. Plus a smart-fetch engine with browser-grade TLS fingerprinting. Paid providers as fallbacks, and auto-selection falls through when a provider is unavailable.
 
-**[Image](./packages/image/README.md)** — Generate images from a text prompt and analyze existing ones. 34 image models, plus vision analysis on any model that accepts image input, with a customizable system prompt.
 
 **[MCP](./packages/mcp/README.md)** — Browse 7,800+ MCP servers, add them interactively. Tools from servers register automatically as Pi tools.
 
@@ -116,14 +115,12 @@ Coexists triggers enhance behavior when packages are installed together. Workflo
 | `spawn_helper` / `get_helper_result` | subagents | Parallel agents |
 | `memory_store` / `memory_search` / `memory_delete` | memory | Memory CRUD |
 | `web_search` / `multi_web_content_read` / `web_llm_summarize` | web-api | Web research |
-| `image_generate` / `image_recognize` | image | Image generation and vision (recognize auto-hides while the session model has vision) |
+| `image_generate` / `image_edit` / `image_recognize` | utility | Image generation, editing and vision (recognize hides while the session model has vision) |
 | `notify_user` | notify | Push notifications |
 | `sidekick` / `read_subagent` | fusion | Delegate to the persistent sidekick and collect its report |
 | `bg_run` / `bg_status` / `bg_logs` / `bg_kill` / `bg_delegate` / `bg_result` | background-tasks | Long-running commands and background delegate agents |
 | `ask_user` | ask-user | User input |
 | `session_recall` / `context_budget` | compactor | Context management |
-| `ctx_env` | utility | Environment info |
-| `set_session_name` | utility | Session name for badge |
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -70,7 +70,6 @@
       "packages/notify/skills",
       "packages/kanboard/skills",
       "packages/updater/skills",
-      "packages/image/skills",
       "packages/subagents/skills"
     ],
     "prompts": [
@@ -84,27 +83,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.4",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.4",
-    "@pi-unipi/btw": "3.0.0-alpha.4",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.4",
-    "@pi-unipi/compactor": "3.0.0-alpha.4",
-    "@pi-unipi/core": "3.0.0-alpha.4",
-    "@pi-unipi/footer": "3.0.0-alpha.4",
-    "@pi-unipi/image": "3.0.0-alpha.4",
-    "@pi-unipi/fusion": "3.0.0-alpha.4",
-    "@pi-unipi/info-screen": "3.0.0-alpha.4",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.4",
-    "@pi-unipi/kanboard": "3.0.0-alpha.4",
-    "@pi-unipi/mcp": "3.0.0-alpha.4",
-    "@pi-unipi/memory": "3.0.0-alpha.4",
-    "@pi-unipi/notify": "3.0.0-alpha.4",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.4",
-    "@pi-unipi/subagents": "3.0.0-alpha.4",
-    "@pi-unipi/updater": "3.0.0-alpha.4",
-    "@pi-unipi/utility": "3.0.0-alpha.4",
-    "@pi-unipi/web-api": "3.0.0-alpha.4",
-    "@pi-unipi/workflow": "3.0.0-alpha.4"
+    "@pi-unipi/ask-user": "3.0.0-alpha.5",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.5",
+    "@pi-unipi/btw": "3.0.0-alpha.5",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.5",
+    "@pi-unipi/compactor": "3.0.0-alpha.5",
+    "@pi-unipi/core": "3.0.0-alpha.5",
+    "@pi-unipi/footer": "3.0.0-alpha.5",
+    "@pi-unipi/fusion": "3.0.0-alpha.5",
+    "@pi-unipi/info-screen": "3.0.0-alpha.5",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.5",
+    "@pi-unipi/kanboard": "3.0.0-alpha.5",
+    "@pi-unipi/mcp": "3.0.0-alpha.5",
+    "@pi-unipi/memory": "3.0.0-alpha.5",
+    "@pi-unipi/notify": "3.0.0-alpha.5",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.5",
+    "@pi-unipi/subagents": "3.0.0-alpha.5",
+    "@pi-unipi/updater": "3.0.0-alpha.5",
+    "@pi-unipi/utility": "3.0.0-alpha.5",
+    "@pi-unipi/web-api": "3.0.0-alpha.5",
+    "@pi-unipi/workflow": "3.0.0-alpha.5"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "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": "3.0.0-alpha.4"
+    "@pi-unipi/core": "3.0.0-alpha.5"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "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

@@ -19,6 +19,7 @@ export const PACKAGE_ORDER: string[] = [
   "btw",
   "mcp",
   "utility",
+  "skill-registry",
   "ask-user",
   "info",
   "web-api",
@@ -41,8 +42,6 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:plan":           "workflow",
   "unipi:permission":     "workflow",
 
-  "unipi:prefix-cache":   "utility",
-
   // long-horizon (4 commands)
   "unipi:goal":           "long-horizon",
   "unipi:ralph":          "long-horizon",
@@ -68,13 +67,15 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   // mcp (5 commands)
   "unipi:mcp-status":   "mcp",
 
-  // utility (11 commands)
+  // utility
   "unipi:continue":   "utility",
-  "unipi:reload":     "utility",
-  "unipi:status":     "utility",
+  "unipi:retry":      "utility",
   "unipi:cleanup":    "utility",
-  "unipi:env":        "utility",
   "unipi:doctor":     "utility",
+  "unipi:answer":     "utility",
+
+  // skill-registry
+  "unipi:skills":     "skill-registry",
 
   // ask-user (1 command)
 
@@ -134,7 +135,6 @@ export const COMMAND_REGISTRY: Record<string, string> = {
 export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:plan":           "Plan mode — investigate read-only, then approve a plan",
   "unipi:permission":     "Permission mode — ask · auto (jev-judged) · full",
-  "unipi:prefix-cache":   "Show privacy-safe provider prefix-cache diagnostics",
 
   "unipi:goal":           "One objective until verifiably true · medium complexity · pareto cost/success",
   "unipi:ralph":          "Checklist grind over iterations · enumerable chores · low cost, solid success",
@@ -156,12 +156,13 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
 
   "unipi:mcp-status":   "Show MCP server status",
 
-  "unipi:continue":   "Continue the last conversation",
-  "unipi:reload":     "Reload extensions and settings",
-  "unipi:status":     "Show system status",
-  "unipi:cleanup":    "Clean up old sessions and cache",
-  "unipi:env":        "Show environment info",
-  "unipi:doctor":     "Run diagnostics",
+  "unipi:continue":   "Continue from where the agent stopped (/unipi:retry)",
+  "unipi:retry":      "Retry the last turn (alias of /unipi:continue)",
+  "unipi:cleanup":    "Remove stale UniPi temp files and leftovers (preview first)",
+  "unipi:doctor":     "Check UniPi's runtime: config, model cache, Decision Model, skills",
+  "unipi:answer":     "Answer the last reply — fixed input under the scrollable reply, per question, or web form",
+  "unipi:skills":     "Manage skills — on/off per project, listed or not, the skill vault",
+
   "unipi:kanboard":        "Kanboard — capture tasks, run them, open the board",
   "unipi:kanboard-add":    "Kanboard — capture a task into Backlog",
   "unipi:kanboard-do":     "Kanboard — let the agent work the board for a turn",
@@ -207,6 +208,7 @@ export const PACKAGE_LABELS: Record<string, string> = {
   btw:       "btw",
   mcp:       "mcp",
   utility:   "utility",
+  "skill-registry": "skills",
   "ask-user": "ask-user",
   info:      "info",
   "web-api": "web-api",

package/packages/autocomplete/src/sorting.ts

@@ -16,6 +16,12 @@ export interface TaggedItem {
 
 // ─── 4-tier priority ─────────────────────────────────────────────────
 
+/**
+ * UniPi commands that supersede a same-named pi built-in: typing the bare
+ * name ranks the unipi command FIRST (`/settings` → `/unipi:settings`).
+ */
+export const PREFERRED_OVER_BUILTIN = new Set(["settings"]);
+
 /**
  * Compute the match-quality tier for an autocomplete item.
  *
@@ -38,6 +44,8 @@ export function crossItemPriority(
 
   const q = query.toLowerCase();
 
+  // Tier -1: a unipi command that supersedes the same-named built-in
+  if (isUnipi && short === q && PREFERRED_OVER_BUILTIN.has(q)) return -1;
   // Tier 0: exact full-value match
   if (full === q) return 0;
   // Tier 1: unipi short-name exact match

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.4",
+    "@pi-unipi/core": "3.0.0-alpha.5",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "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.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.4"
+    "@pi-unipi/core": "3.0.0-alpha.5"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.4",
-    "@pi-unipi/info-screen": "3.0.0-alpha.4",
+    "@pi-unipi/core": "3.0.0-alpha.5",
+    "@pi-unipi/info-screen": "3.0.0-alpha.5",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/constants.ts

@@ -37,8 +37,8 @@ export const MODULES = {
   FOOTER: "@pi-unipi/footer",
   UPDATER: "@pi-unipi/updater",
   INPUT_SHORTCUTS: "@pi-unipi/input-shortcuts",
-  IMAGE: "@pi-unipi/image",
   WATCHDOG: "@pi-unipi/watchdog",
+  SKILL_REGISTRY: "@pi-unipi/skill-registry",
 } as const;
 
 /** Workflow command names — plan mode + permission modes */
@@ -104,30 +104,10 @@ export const RALPH_STATUS_ICONS = {
 /** Utility command names */
 export const UTILITY_COMMANDS = {
   CONTINUE: "continue",
-  RELOAD: "reload",
-  STATUS: "status",
+  RETRY: "retry",
   CLEANUP: "cleanup",
-  ENV: "env",
   DOCTOR: "doctor",
-  PREFIX_CACHE: "prefix-cache",
-} as const;
-
-/** Utility tool names */
-export const UTILITY_TOOLS = {
-  CONTINUE: "continue_task",
-  BATCH: "ctx_batch",
-  ENV: "ctx_env",
-  SET_SESSION_NAME: "set_session_name",
-} as const;
-
-/** Badge config path */
-export const BADGE_CONFIG_FILE = ".unipi/config/badge.json" as const;
-
-/** Utility directory paths */
-export const UTILITY_DIRS = {
-  CACHE: "~/.unipi/cache",
-  ANALYTICS: "~/.unipi/analytics",
-  TEMP: "/tmp/unipi",
+  ANSWER: "answer",
 } as const;
 
 /** Ask-user tool names */
@@ -138,6 +118,7 @@ export const ASK_USER_TOOLS = {
 /** Image tool names */
 export const IMAGE_TOOLS = {
   GENERATE: "image_generate",
+  EDIT: "image_edit",
   RECOGNIZE: "image_recognize",
 } as const;
 

package/packages/core/events.ts

@@ -35,8 +35,6 @@ export const UNIPI_EVENTS = {
   LONG_HORIZON_TODO_UPDATED: "unipi:long-horizon:todo:updated",
 
 
-  /** Info screen group registered */
-  INFO_GROUP_REGISTERED: "unipi:info:group:registered",
   /** Info screen data updated */
   INFO_DATA_UPDATED: "unipi:info:data:updated",
 
@@ -64,19 +62,10 @@ 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",
-  /** 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",
 
   /** Notification sent */
   NOTIFICATION_SENT: "unipi:notify:sent",
 
-  /** 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",
 
@@ -178,15 +167,6 @@ export interface UnipiMemoryConsolidatedEvent {
   projectName: string;
 }
 
-/** Payload for INFO_GROUP_REGISTERED */
-export interface UnipiInfoGroupEvent {
-  /** Group id */
-  groupId: string;
-  /** Group display name */
-  groupName: string;
-  /** Module that registered the group */
-  module: string;
-}
 
 /** Payload for INFO_DATA_UPDATED */
 export interface UnipiInfoDataEvent {
@@ -252,38 +232,9 @@ export interface UnipiCompactorStatsEvent {
   searchQueries: number;
 }
 
-/** Payload for UTILITY_CLEANUP_START / UTILITY_CLEANUP_DONE */
-export interface UnipiUtilityCleanupEvent {
-  /** Whether this is a dry run */
-  dryRun: boolean;
-  /** Categories being cleaned */
-  categories: string[];
-  /** Results (present on DONE) */
-  results?: Array<{
-    category: string;
-    removed: number;
-    bytesFreed: number;
-  }>;
-}
 
-/** Payload for UTILITY_DIAGNOSTICS_START / UTILITY_DIAGNOSTICS_DONE */
-export interface UnipiUtilityDiagnosticsEvent {
-  /** Overall health status */
-  overall: "healthy" | "warning" | "error" | "unknown";
-  /** Number of checks run */
-  checkCount: number;
-  /** Report (present on DONE) */
-  report?: unknown;
-}
 
 
-/** Payload for BADGE_GENERATE_REQUEST */
-export interface UnipiBadgeGenerateRequestEvent {
-  /** Source of the request (e.g., "kanboard", "input-hook") */
-  source: string;
-  /** First user message for context (optional) */
-  conversationSummary?: string;
-}
 
 /** Payload for ASK_USER_PROMPT */
 export interface UnipiAskUserPromptEvent {
@@ -361,17 +312,13 @@ export type UnipiEventPayload =
   | UnipiMemoryStoredEvent
   | UnipiMemoryDeletedEvent
   | UnipiMemoryConsolidatedEvent
-  | UnipiInfoGroupEvent
   | UnipiInfoDataEvent
   | UnipiMcpServerEvent
   | UnipiMcpToolsEvent
   | UnipiMcpCatalogSyncedEvent
   | UnipiCompactionEvent
   | UnipiCompactorStatsEvent
-  | UnipiUtilityCleanupEvent
-  | UnipiUtilityDiagnosticsEvent
   | UnipiNotificationSentEvent
-  | UnipiBadgeGenerateRequestEvent
   | UnipiAskUserPromptEvent
   | UnipiUpdateCheckEvent
   | UnipiUpdateAvailableEvent

package/packages/core/index.ts

@@ -26,12 +26,14 @@ export * from "./src/tui/kit.js";
 export * from "./src/tui/progress.js";
 export * from "./src/jev/client.js";
 export * from "./src/jev/settings.js";
+export * from "./src/jev/chatter.js";
 export * from "./src/workspace/state-migration.js";
 // v3 settings engine + migration (canonical ~/.unipi/config layout)
 export * from "./src/settings/paths.js";
 export * from "./src/settings/engine.js";
 export * from "./src/settings/schema.js";
 export { SettingsHub, type SettingsHubDeps } from "./src/settings/hub.js";
+export { openSettingsHub } from "./src/settings/open.js";
 export * from "./src/settings/catalog.js";
 export * from "./command-runner.js";
 export * from "./compaction-context.js";

package/packages/core/model-cache.ts

@@ -1,9 +1,11 @@
 /**
  * @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.
+ * File-based model list cache at ~/.unipi/config/models-cache.json — the one
+ * catalog every unipi surface reads (settings hub pickers, kanboard, image
+ * pickers) without needing ctx.modelRegistry. Written by utility on every
+ * session start from pi's live registry (models with credentials), plus the
+ * image-generation models pi-ai publishes separately.
  */
 
 import * as fs from "node:fs";
@@ -18,10 +20,12 @@ function cacheDir(): string {
 }
 
 /** Resolve the model cache file path at call time. */
-function cacheFile(): string {
+export function modelCachePath(): string {
   return path.join(cacheDir(), "models-cache.json");
 }
 
+export type Modality = "text" | "image";
+
 /** A single cached model entry */
 export interface CachedModel {
   /** Model provider (e.g. "openai", "anthropic") */
@@ -30,6 +34,14 @@ export interface CachedModel {
   id: string;
   /** Optional display name */
   name?: string;
+  /** Input modalities. Absent in pre-v3 caches → treat as ["text"]. */
+  input?: Modality[];
+  /** Output modalities. Chat models → ["text"]; image generators include "image". */
+  output?: Modality[];
+  /** "chat" = pi chat registry, "images" = pi-ai images collection / generator. */
+  kind?: "chat" | "images";
+  contextWindow?: number;
+  reasoning?: boolean;
 }
 
 /** The full model cache structure */
@@ -40,13 +52,64 @@ export interface ModelCache {
   models: CachedModel[];
 }
 
+/** `provider/id` reference for a cached model. */
+export function modelRef(model: Pick<CachedModel, "provider" | "id">): string {
+  return `${model.provider}/${model.id}`;
+}
+
+export function modelInputs(model: CachedModel): Modality[] {
+  return model.input?.length ? model.input : ["text"];
+}
+
+export function modelOutputs(model: CachedModel): Modality[] {
+  return model.output?.length ? model.output : ["text"];
+}
+
+/**
+ * Filter by modality. `input` lists what the model must accept (all of them),
+ * `output` what it must produce (any of them).
+ */
+export function filterModels(
+  models: readonly CachedModel[],
+  want: { input?: Modality[]; output?: Modality[] },
+): CachedModel[] {
+  return models.filter((m) => {
+    const inputs = modelInputs(m);
+    const outputs = modelOutputs(m);
+    if (want.input && !want.input.every((i) => inputs.includes(i))) return false;
+    if (want.output && !want.output.some((o) => outputs.includes(o))) return false;
+    return true;
+  });
+}
+
+/** Map pi registry models (chat) to cache entries. Tolerates partial shapes. */
+export function chatModelsToCache(models: readonly unknown[]): CachedModel[] {
+  const out: CachedModel[] = [];
+  for (const raw of models) {
+    const m = raw as { provider?: unknown; id?: unknown; name?: unknown; input?: unknown; contextWindow?: unknown; reasoning?: unknown };
+    if (typeof m?.provider !== "string" || typeof m?.id !== "string") continue;
+    const input = Array.isArray(m.input) ? (m.input.filter((x) => x === "text" || x === "image") as Modality[]) : ["text" as const];
+    out.push({
+      provider: m.provider,
+      id: m.id,
+      ...(typeof m.name === "string" ? { name: m.name } : {}),
+      input: input.length ? input : ["text"],
+      output: ["text"],
+      kind: "chat",
+      ...(typeof m.contextWindow === "number" ? { contextWindow: m.contextWindow } : {}),
+      ...(typeof m.reasoning === "boolean" ? { reasoning: m.reasoning } : {}),
+    });
+  }
+  return out;
+}
+
 /**
  * Read cached model list from disk.
  * Returns empty array if no cache file exists or it's malformed.
  */
 export function readModelCache(): CachedModel[] {
   try {
-    const file = cacheFile();
+    const file = modelCachePath();
     if (!fs.existsSync(file)) return [];
     const parsed = JSON.parse(fs.readFileSync(file, "utf-8"));
     return Array.isArray(parsed.models) ? parsed.models : [];
@@ -58,6 +121,8 @@ export function readModelCache(): CachedModel[] {
 /**
  * Write model list to cache file.
  * Creates directory if needed. Best effort — silently ignores errors.
+ * Entries are de-duplicated by `provider/id` (first wins) and sorted, so the
+ * file is stable across sessions with the same catalog.
  */
 export function writeModelCache(models: CachedModel[]): void {
   try {
@@ -65,11 +130,20 @@ export function writeModelCache(models: CachedModel[]): void {
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
     }
+    const seen = new Set<string>();
+    const unique = models.filter((m) => {
+      const key = modelRef(m);
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    }).sort((a, b) => modelRef(a).localeCompare(modelRef(b)));
     const cache: ModelCache = {
       updatedAt: new Date().toISOString(),
-      models,
+      models: unique,
     };
-    fs.writeFileSync(cacheFile(), JSON.stringify(cache, null, 2) + "\n", "utf-8");
+    const tmp = `${modelCachePath()}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(cache, null, 2) + "\n", "utf-8");
+    fs.renameSync(tmp, modelCachePath());
   } catch {
     // Best effort — cache is optional
   }

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",
@@ -41,6 +41,6 @@
     "themes": []
   },
   "scripts": {
-    "test": "npx tsx --test *.test.ts"
+    "test": "npx tsx --test *.test.ts src/*/__tests__/*.test.ts"
   }
 }

package/packages/core/src/jev/chatter.ts

@@ -0,0 +1,24 @@
+/**
+ * Chatter detection shared by jev consumers (auto-rename, skill judging):
+ * greetings, thanks, acknowledgements and bare "continue"-style nudges carry
+ * no subject, so no decision should be made from them.
+ */
+
+const CHATTER = new RegExp(
+  "^(?:" + [
+    "h(?:i|ello|ey|owdy)(?: there)?", "yo", "sup", "good (?:morning|afternoon|evening)",
+    "thanks?(?: you)?(?: so much)?", "thx", "ty", "cheers", "nice", "great", "cool", "perfect", "awesome",
+    "ok(?:ay)?", "k", "yes", "yep", "yeah", "no", "nope", "sure", "lgtm", "sounds good", "go(?: on| ahead)?",
+    "continue", "proceed", "retry", "again", "do it", "next", "done",
+  ].join("|") + ")[\\s.!?,]*$",
+  "i",
+);
+
+/** True for messages with no subject of their own (no jev call needed). */
+export function isChatter(text: string): boolean {
+  const t = text.trim();
+  if (t.length < 3) return true;
+  if (t.startsWith("/")) return true;
+  return CHATTER.test(t);
+}
+