@pi-unipi/unipi 2.13.0 → 2.14.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.14.0] — 2026-08-29
+
+### Changed
+
+- `image`: **`image_recognize` is now hidden while the session model has vision** — a model that accepts image input reads images natively through pi's own read tool, so the separate recognition round-trip only duplicated the ability and burned system-prompt context. The extension drops the tool from the active set on `session_start` and `model_select` when the session model declares image input (`input` includes `"image"`), and restores it automatically when a text-only model takes over mid-session. Models that do not declare input modalities are treated as non-vision and keep the tool, matching the package's existing convention. The info screen shows "Hidden (model has vision)" for the Recognize stat while suppressed.
+
 ## [2.13.0] — 2026-08-28
 
 ### Added

package/README.md

@@ -110,7 +110,7 @@ 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 |
+| `image_generate` / `image_recognize` | image | Image generation and vision (recognize auto-hides while the session model has vision) |
 | `notify_user` | notify | Push notifications |
 | `ask_user` | ask-user | User input |
 | `compact` / `session_recall` / `sandbox` | compactor | Context management |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,28 +82,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.12.0",
-    "@pi-unipi/background-tasks": "2.13.0",
-    "@pi-unipi/btw": "2.12.0",
-    "@pi-unipi/command-enchantment": "2.12.0",
-    "@pi-unipi/compactor": "2.12.0",
-    "@pi-unipi/core": "2.12.0",
-    "@pi-unipi/footer": "2.13.0",
-    "@pi-unipi/image": "2.12.0",
-    "@pi-unipi/info-screen": "2.12.0",
-    "@pi-unipi/input-shortcuts": "2.12.0",
-    "@pi-unipi/kanboard": "2.12.0",
-    "@pi-unipi/mcp": "2.12.0",
-    "@pi-unipi/memory": "2.12.0",
-    "@pi-unipi/milestone": "2.12.0",
-    "@pi-unipi/notify": "2.12.0",
-    "@pi-unipi/ralph": "2.12.0",
-    "@pi-unipi/subagents": "2.12.0",
-    "@pi-unipi/trajectory": "2.12.0",
-    "@pi-unipi/updater": "2.12.0",
-    "@pi-unipi/utility": "2.12.0",
-    "@pi-unipi/web-api": "2.12.0",
-    "@pi-unipi/workflow": "2.12.0"
+    "@pi-unipi/ask-user": "2.14.0",
+    "@pi-unipi/background-tasks": "2.14.0",
+    "@pi-unipi/btw": "2.14.0",
+    "@pi-unipi/command-enchantment": "2.14.0",
+    "@pi-unipi/compactor": "2.14.0",
+    "@pi-unipi/core": "2.14.0",
+    "@pi-unipi/footer": "2.14.0",
+    "@pi-unipi/image": "2.14.0",
+    "@pi-unipi/info-screen": "2.14.0",
+    "@pi-unipi/input-shortcuts": "2.14.0",
+    "@pi-unipi/kanboard": "2.14.0",
+    "@pi-unipi/mcp": "2.14.0",
+    "@pi-unipi/memory": "2.14.0",
+    "@pi-unipi/milestone": "2.14.0",
+    "@pi-unipi/notify": "2.14.0",
+    "@pi-unipi/ralph": "2.14.0",
+    "@pi-unipi/subagents": "2.14.0",
+    "@pi-unipi/trajectory": "2.14.0",
+    "@pi-unipi/updater": "2.14.0",
+    "@pi-unipi/utility": "2.14.0",
+    "@pi-unipi/web-api": "2.14.0",
+    "@pi-unipi/workflow": "2.14.0"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/autocomplete/package.json

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

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.13.0",
+  "version": "2.14.0",
   "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.12.0",
+    "@pi-unipi/core": "2.14.0",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.84.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0",
-    "@pi-unipi/info-screen": "2.12.0",
+    "@pi-unipi/core": "2.14.0",
+    "@pi-unipi/info-screen": "2.14.0",
     "@earendil-works/pi-agent-core": "^0.84.0"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.13.0",
+  "version": "2.14.0",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.12.0",
-    "@pi-unipi/background-tasks": "2.13.0"
+    "@pi-unipi/core": "2.14.0",
+    "@pi-unipi/background-tasks": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/image/README.md

@@ -7,7 +7,7 @@ Image generation and image recognition tools for the agent.
 | Tool | Description |
 |------|-------------|
 | `image_generate` | Generate an image from a text prompt. Returned inline and saved to disk. |
-| `image_recognize` | Analyze an image with a vision model. Accepts a file path, `data:` URL, or base64. |
+| `image_recognize` | Analyze an image with a vision model. Accepts a file path, `data:` URL, or base64. Automatically hidden while the session model itself has vision. |
 
 ## Commands
 
@@ -63,6 +63,13 @@ works. Supported: PNG, JPEG, GIF, WebP. Remote URLs are not fetched.
 Prefer file paths — inlining base64 into the conversation is far more
 expensive in tokens.
 
+**Vision models don't get this tool.** When the session's current model already
+accepts image input, `image_recognize` is dropped from the active tool set —
+the model reads images natively through pi's own tools, so a separate
+recognition round-trip through another model would only duplicate that ability
+and burn context. Switch to a text-only model (via `/model`) and the tool comes
+back automatically.
+
 ## Configuration
 
 `~/.unipi/config/image/config.json`:

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/image/src/index.ts

@@ -20,7 +20,13 @@ import {
 
 import { registerImageCommands } from "./commands.js";
 import { registerImageTools } from "./tools.js";
-import { listImageGenModels, listVisionModels, type ChatModelRegistry } from "./models.js";
+import {
+  applyRecognizeGating,
+  isVisionModel,
+  listImageGenModels,
+  listVisionModels,
+  type ChatModelRegistry,
+} from "./models.js";
 import { registerRegistryImageProviders } from "./register-providers.js";
 import { loadConfig } from "./settings.js";
 
@@ -37,10 +43,27 @@ function getInfoRegistry() {
   ).__unipi_info_registry;
 }
 
+/**
+ * Hide image_recognize when the session model can natively see images, and
+ * restore it when a text-only model takes over. Returns whether the tool is
+ * provided after gating.
+ */
+function applyVisionGating(pi: ExtensionAPI, model: unknown): boolean {
+  const active = pi.getActiveTools();
+  const next = applyRecognizeGating(active, model, IMAGE_TOOLS.RECOGNIZE);
+  if (next !== active) pi.setActiveTools(next);
+  return next.includes(IMAGE_TOOLS.RECOGNIZE);
+}
+
 export default function (pi: ExtensionAPI) {
   registerImageTools(pi);
   registerImageCommands(pi);
 
+  pi.on("model_select", (event) => {
+    if (!loadConfig().recognize.enabled) return;
+    applyVisionGating(pi, event.model);
+  });
+
   pi.on("session_start", async (_event, ctx) => {
     const config = loadConfig();
 
@@ -51,9 +74,16 @@ export default function (pi: ExtensionAPI) {
       (ctx as unknown as { modelRegistry?: ChatModelRegistry }).modelRegistry,
     ).catch(() => undefined);
 
+    // A vision-capable session model reads images itself, so image_recognize
+    // would only duplicate that ability. Drop it from the active tool set;
+    // the model_select handler above restores it when a text-only model is
+    // chosen later in the same session.
+    const recognizeProvided =
+      config.recognize.enabled && applyVisionGating(pi, ctx.model);
+
     const tools: string[] = [];
     if (config.generate.enabled) tools.push(IMAGE_TOOLS.GENERATE);
-    if (config.recognize.enabled) tools.push(IMAGE_TOOLS.RECOGNIZE);
+    if (recognizeProvided) tools.push(IMAGE_TOOLS.RECOGNIZE);
 
     emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
       name: MODULES.IMAGE,
@@ -92,9 +122,11 @@ export default function (pi: ExtensionAPI) {
           .modelRegistry;
         const vision = chatRegistry ? listVisionModels(chatRegistry) : [];
 
-        const recognize = current.recognize.enabled
-          ? current.recognize.model || "Session model"
-          : "Disabled";
+        const recognize = !current.recognize.enabled
+          ? "Disabled"
+          : isVisionModel(ctx.model)
+            ? "Hidden (model has vision)"
+            : current.recognize.model || "Session model";
 
         return {
           generate: { value: generate },

package/packages/image/src/models.ts

@@ -383,7 +383,7 @@ export function listVisionModels(registry: ChatModelRegistry): VisionModel[] {
   return models.filter(isVisionModel);
 }
 
-function isVisionModel(model: unknown): model is VisionModel {
+export function isVisionModel(model: unknown): model is VisionModel {
   if (model === null || typeof model !== "object") return false;
   const candidate = model as Partial<VisionModel>;
   if (typeof candidate.id !== "string" || typeof candidate.provider !== "string") {
@@ -392,6 +392,29 @@ function isVisionModel(model: unknown): model is VisionModel {
   return Array.isArray(candidate.input) && candidate.input.includes("image");
 }
 
+/**
+ * Active tool names after hiding `recognizeTool` for a vision-capable model.
+ *
+ * A model that accepts image input can read images natively (pi's own read
+ * tool hands it the pixels), so a separate image_recognize round-trip through
+ * another model only duplicates the ability and burns system-prompt context.
+ * Text-only models get the tool back. Models that do not declare their input
+ * modalities are treated as non-vision, matching `isVisionModel`.
+ */
+export function applyRecognizeGating(
+  active: string[],
+  model: unknown,
+  recognizeTool: string,
+): string[] {
+  const vision = isVisionModel(model);
+  const present = active.includes(recognizeTool);
+  // Already correct: hidden for a vision model, or provided for a text-only one.
+  if (vision !== present) return active;
+  return vision
+    ? active.filter((name) => name !== recognizeTool)
+    : [...active, recognizeTool];
+}
+
 /**
  * Resolve a vision-model reference, restricted to image-capable models.
  *

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -39,8 +39,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.12.0",
-    "@pi-unipi/info-screen": "2.12.0",
+    "@pi-unipi/core": "2.14.0",
+    "@pi-unipi/info-screen": "2.14.0",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0"
+    "@pi-unipi/core": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "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.12.0",
+    "@pi-unipi/core": "2.14.0",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -31,8 +31,8 @@
     "test": "npx tsx --test reminder.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.12.0",
-    "@pi-unipi/info-screen": "2.12.0"
+    "@pi-unipi/core": "2.14.0",
+    "@pi-unipi/info-screen": "2.14.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "src/index.ts",
@@ -9,7 +9,7 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.12.0",
+    "@pi-unipi/core": "2.14.0",
     "@earendil-works/pi-agent-core": "^0.84.0",
     "acorn": "8.18.0"
   },

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/trajectory",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",