@pi-unipi/unipi 2.12.2 → 2.14.0

package/CHANGELOG.md

@@ -6,6 +6,23 @@ 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
+
+- `footer`: **bg-process one-liner above the glance footer** — a centered strip directly above the frame showing live background-task counts with status dots: green ● running, yellow ● stopped (killed), red ● failed, gray ● done. Zero-count buckets are omitted and the line hides entirely when idle. Reads `BackgroundTaskRegistry.allTasks()` directly (no events, no polling channels) and re-renders on the footer's 1s refresh timer; counts reset per session.
+- `background-tasks`: **shared registry accessor** (`getSharedTaskRegistry` / `setSharedTaskRegistry` / `clearSharedTaskRegistry` in `src/registry-shared.ts`) — lets sibling extensions read the live task registry synchronously. Stored on `globalThis` under a `Symbol.for` key so the singleton survives duplicate module instances; published at extension init and `session_start`, cleared on `session_shutdown`.
+
+### Changed
+
+- `footer`: new dependency on `@pi-unipi/background-tasks` for the process one-liner's direct registry reads.
+
 ## [2.12.0] — 2026-08-27
 
 ### 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.12.2",
+  "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.12.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.12.1",
-    "@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/README.md

@@ -74,6 +74,22 @@ subscription OAuth attribution, exact-match system-prompt sanitization, and
 cache-retention policy for Anthropic routes. Duplicate installed copies resolve
 ownership through an EventBus claim; later copies go inert.
 
+## Shared registry (for sibling extensions)
+
+Other packages can read the live task registry synchronously — no events, no polling:
+
+```ts
+import { getSharedTaskRegistry } from "@pi-unipi/background-tasks";
+
+const tasks = getSharedTaskRegistry()?.allTasks() ?? [];
+const running = tasks.filter((t) => t.status === "running").length;
+```
+
+The registry is published on `globalThis` under a `Symbol.for` key at extension
+init and `session_start`, and cleared on `session_shutdown` (counts are
+per-session). Returns `undefined` when the module is disabled — callers must
+treat that as "no data", e.g. the footer's glance process line does.
+
 ## Differences from the reference
 
 - Commands live in the `/unipi:*` namespace; env prefix is `UNIPI_BG_*`.

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.12.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/background-tasks/src/index.ts

@@ -19,10 +19,14 @@ import {
 import { registerToolsAndCommands } from "./tools.js";
 import { registerFusionExtension } from "./fusion-extension.js";
 import { registerDelegateExtension } from "./delegate-extension.js";
+import { setSharedTaskRegistry, clearSharedTaskRegistry } from "./registry-shared.js";
 import { taskDisplayName, type BgTask, type StartAttestedPiTaskOptions, type StartTaskOptions } from "./types.js";
 
 const STATUS_INTERVAL_MS = 1000;
 
+// Direct synchronous access for sibling extensions (footer process one-liner).
+export { getSharedTaskRegistry } from "./registry-shared.js";
+
 export default function backgroundTasksExtension(pi: ExtensionAPI): void {
   const { config, warnings } = loadBackgroundTasksConfig(process.cwd());
 
@@ -53,6 +57,8 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
       eventService.publishTerminal(task);
     },
   });
+  setSharedTaskRegistry(registry);
+
   const eventService: BackgroundTaskExtensionService = installBackgroundTaskExtensionApi({
     events: pi.events,
     registry,
@@ -253,6 +259,7 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
 
   pi.on("session_start", async (_event, ctx) => {
     registry.setShuttingDown(false);
+    setSharedTaskRegistry(registry);
     currentCtx = ctx;
     await registry.ensureRuntimeDir(ctx);
     updateUi(ctx);
@@ -264,6 +271,7 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
 
   pi.on("session_shutdown", async (_event, ctx) => {
     registry.setShuttingDown(true);
+    clearSharedTaskRegistry();
     currentCtx = undefined;
     if (statusInterval) {
       clearInterval(statusInterval);

package/packages/background-tasks/src/registry-shared.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared BackgroundTaskRegistry accessor
+ *
+ * Exposes the live registry to sibling extensions (e.g. @pi-unipi/footer)
+ * without events or request/response channels — direct synchronous reads of
+ * `allTasks()`.
+ *
+ * Stored on globalThis under a `Symbol.for` key so the singleton is shared
+ * even if this package ends up instantiated more than once (duplicate
+ * node_modules copies would otherwise each hold their own module state).
+ */
+
+import type { BackgroundTaskRegistry } from "./registry.js";
+
+const SHARED_REGISTRY_KEY = Symbol.for("unipi.background-tasks.shared-registry");
+
+/** Publish the live registry (idempotent; later calls overwrite). */
+export function setSharedTaskRegistry(registry: BackgroundTaskRegistry): void {
+  (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY] = registry;
+}
+
+/** Read the live registry, or undefined when background-tasks is not loaded. */
+export function getSharedTaskRegistry(): BackgroundTaskRegistry | undefined {
+  return (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY] as
+    | BackgroundTaskRegistry
+    | undefined;
+}
+
+/** Drop the shared reference (used on session shutdown so readers see a clean slate). */
+export function clearSharedTaskRegistry(): void {
+  delete (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY];
+}

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/README.md

@@ -18,6 +18,7 @@ An experimental input surface, on by default and toggleable in `/unipi:footer-se
 - **Top border:** animated lolcat-gradient UNIPI brand + git branch (turns rainbow-frame animated while thinking is max/xhigh)
 - **Bottom border:** workspace · context %/window · model · thinking level
 - **Session strip:** turns/steps, wall + tool wall time, average TTFT, tok/s, cache hit % — colored per stat, honest across restarts (derived from persisted session timestamps when live hooks are unavailable; provider-reported `usage.output` anchors token counts whenever present)
+- **Process line (new in 2.13):** centered one-liner directly above the frame while background work is in flight — `● 3 running  ● 1 stopped  ● 1 failed  ● 2 done` — green ● running, yellow ● stopped (killed), red ● failed, gray ● done. Covers every task type (shell jobs, delegates, fusion workflows) via direct registry reads; zero-count buckets are omitted and the line hides when idle. Counts reset per session.
 - The classic segment status line is suppressed while glance mode is on; toggle it back for the classic footer
 
 ## Commands

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.12.1",
+  "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,7 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.12.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/footer/src/index.ts

@@ -29,6 +29,7 @@ import { STATUS_EXT_SEGMENTS } from "./segments/status-ext.js";
 
 import type { FooterGroup, FooterSegment } from "./types.js";
 import { tpsTracker } from "./tps-tracker.js";
+import { renderProcessLine } from "./process-line.js";
 
 /** All segment groups */
 const ALL_GROUPS: FooterGroup[] = [
@@ -328,9 +329,10 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
     };
   });
 
-  // Top row widget — classic status line (suppressed in glance mode; the
-  // glance frame's top border already shows UNIPI │ branch and the bottom
-  // border shows context/model/thinking, so a segment row would duplicate it)
+  // Top row widget — dual role. Classic mode: status segment line. Glance
+  // mode: the bg-process one-liner, rendered directly above the glance frame
+  // (the frame replaces the editor, so this aboveEditor slot sits right above
+  // the footer); the frame's own borders show branch/context/model/thinking.
   ctx.ui.setWidget("footer-top", (_tui, theme) => {
     // Update the renderer's theme-like
     const themeLike = { fg: (color: string, text: string) => theme.fg(color as any, text) };
@@ -344,8 +346,8 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
       },
       render(width: number): string[] {
         if (!state.enabled || !state.piContext || width <= 0) return [];
-        // Glance mode replaces the classic segment line entirely.
-        if (state.glanceMode) return [];
+        // Glance mode: this slot becomes the bg-process one-liner.
+        if (state.glanceMode) return renderProcessLine(width);
         const layout = state.renderer.computeLayout(width);
         if (!layout.topContent) return [];
 

package/packages/footer/src/process-line.ts

@@ -0,0 +1,74 @@
+/**
+ * @pi-unipi/footer — Background process one-liner
+ *
+ * Glance-mode strip rendered above the footer frame: one colored dot + count
+ * per background-task status. Reads DIRECTLY from the
+ * @pi-unipi/background-tasks shared registry (no events, no polling
+ * channels); re-renders on the footer's existing 1s refresh timer.
+ *
+ * Dot → status mapping:
+ *   green ● running   yellow ● stopped (killed)   red ● failed   gray ● done (completed)
+ *
+ * Buckets with zero count are omitted; with nothing in flight the line is
+ * empty so the footer stays clean.
+ */
+
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { getSharedTaskRegistry } from "@pi-unipi/background-tasks";
+
+const GREEN_DOT = "\x1b[38;5;82m●\x1b[0m"; // running — active work
+const YELLOW_DOT = "\x1b[38;5;220m●\x1b[0m"; // stopped (killed) — needs attention
+const RED_DOT = "\x1b[38;5;196m●\x1b[0m"; // failed — needs attention
+const GRAY_DOT = "\x1b[38;5;245m●\x1b[0m"; // done (completed) — idle info
+
+export interface BgProcessCounts {
+  running: number;
+  stopped: number;
+  failed: number;
+  done: number;
+}
+
+/**
+ * Count background tasks by display status straight from the registry.
+ * Returns null when background-tasks has not published a registry (module
+ * disabled, before first load, or after session shutdown).
+ */
+export function countBgProcesses(): BgProcessCounts | null {
+  try {
+    const tasks = getSharedTaskRegistry()?.allTasks();
+    if (!tasks) return null;
+    const counts: BgProcessCounts = { running: 0, stopped: 0, failed: 0, done: 0 };
+    for (const task of tasks) {
+      if (task.status === "running") counts.running++;
+      else if (task.status === "killed") counts.stopped++;
+      else if (task.status === "failed") counts.failed++;
+      else if (task.status === "completed") counts.done++;
+    }
+    return counts;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Render the centered one-liner for the given terminal width.
+ * Returns [] when there is nothing to show.
+ */
+export function renderProcessLine(width: number): string[] {
+  if (width <= 0) return [];
+  const counts = countBgProcesses();
+  if (!counts) return [];
+
+  const parts: string[] = [];
+  if (counts.running > 0) parts.push(`${GREEN_DOT} ${counts.running} running`);
+  if (counts.stopped > 0) parts.push(`${YELLOW_DOT} ${counts.stopped} stopped`);
+  if (counts.failed > 0) parts.push(`${RED_DOT} ${counts.failed} failed`);
+  if (counts.done > 0) parts.push(`${GRAY_DOT} ${counts.done} done`);
+  if (parts.length === 0) return [];
+
+  const line = parts.join("  ");
+  const w = visibleWidth(line);
+  if (w >= width) return [truncateToWidth(line, width)];
+  const leftPad = Math.floor((width - w) / 2);
+  return [" ".repeat(leftPad) + line];
+}

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