@pi-unipi/unipi 2.1.2 → 2.2.0

package/packages/image/src/tui/model-selector.ts

@@ -0,0 +1,279 @@
+/**
+ * @pi-unipi/image — Model selector overlay
+ *
+ * Picks either an image-generation model (from pi-ai's image catalog) or a
+ * vision model (from pi's chat registry, filtered to image-capable models).
+ */
+
+import type { Component } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { boxInnerWidth, safeRepeat } from "@pi-unipi/core";
+
+export interface SelectableModel {
+  provider: string;
+  id: string;
+  name?: string;
+}
+
+export type ModelSelectorKind = "generate" | "recognize";
+
+/** Overlay listing models with filter, navigation and selection. */
+export class ImageModelSelectorOverlay implements Component {
+  private models: SelectableModel[] = [];
+  private filtered: SelectableModel[] = [];
+  private selectedIndex = 0;
+  private filter = "";
+  private filterMode = false;
+  private saved = false;
+  private error: string | null = null;
+  private theme: Theme | null = null;
+
+  onClose?: () => void;
+  onSelect?: (modelRef: string) => void;
+  requestRender?: () => void;
+
+  constructor(
+    private readonly kind: ModelSelectorKind,
+    models: SelectableModel[],
+    currentRef?: string,
+  ) {
+    this.models = models;
+    this.applyFilter();
+
+    if (currentRef) {
+      const index = this.filtered.findIndex(
+        (m) => `${m.provider}/${m.id}` === currentRef,
+      );
+      if (index >= 0) this.selectedIndex = index;
+    }
+  }
+
+  setTheme(theme: Theme): void {
+    this.theme = theme;
+  }
+
+  invalidate(): void {}
+
+  handleInput(data: string): void {
+    if (this.filterMode) {
+      this.handleFilterInput(data);
+      return;
+    }
+
+    switch (data) {
+      case "\x1b[A":
+      case "k":
+        this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+        break;
+      case "\x1b[B":
+      case "j":
+        this.selectedIndex = Math.min(this.filtered.length - 1, this.selectedIndex + 1);
+        break;
+      case "/":
+        this.filterMode = true;
+        this.filter = "";
+        break;
+      case "\r":
+        this.commit();
+        break;
+      case "\x1b":
+        this.onClose?.();
+        break;
+    }
+  }
+
+  private handleFilterInput(data: string): void {
+    if (data === "\r") {
+      this.filterMode = false;
+      return;
+    }
+    if (data === "\x1b") {
+      this.filter = "";
+      this.filterMode = false;
+      this.applyFilter();
+      this.selectedIndex = 0;
+      return;
+    }
+    if (data === "\x7f" || data === "\b") {
+      this.filter = this.filter.slice(0, -1);
+      this.applyFilter();
+      this.clampSelection();
+      return;
+    }
+    if (data.length === 1 && data >= " ") {
+      this.filter += data;
+      this.applyFilter();
+      this.clampSelection();
+    }
+  }
+
+  private clampSelection(): void {
+    this.selectedIndex = Math.min(
+      this.selectedIndex,
+      Math.max(0, this.filtered.length - 1),
+    );
+  }
+
+  private applyFilter(): void {
+    const query = this.filter.toLowerCase();
+    this.filtered = query
+      ? this.models.filter(
+          (m) =>
+            m.id.toLowerCase().includes(query) ||
+            m.provider.toLowerCase().includes(query) ||
+            (m.name?.toLowerCase().includes(query) ?? false),
+        )
+      : [...this.models];
+  }
+
+  private commit(): void {
+    const model = this.filtered[this.selectedIndex];
+    if (!model) {
+      this.error = "No model selected";
+      return;
+    }
+
+    this.onSelect?.(`${model.provider}/${model.id}`);
+    this.saved = true;
+    this.error = null;
+    setTimeout(() => this.onClose?.(), 500);
+  }
+
+  // ─── Theme helpers ───────────────────────────────────────────────────
+
+  private fg(color: string, text: string): string {
+    if (this.theme) return this.theme.fg(color as never, text);
+    const codes: Record<string, string> = {
+      accent: "\x1b[36m",
+      success: "\x1b[32m",
+      warning: "\x1b[33m",
+      error: "\x1b[31m",
+      dim: "\x1b[2m",
+      borderMuted: "\x1b[90m",
+    };
+    return `${codes[color] ?? ""}${text}\x1b[0m`;
+  }
+
+  private bold(text: string): string {
+    return this.theme ? this.theme.bold(text) : `\x1b[1m${text}\x1b[0m`;
+  }
+
+  private frameLine(content: string, innerWidth: number): string {
+    const truncated = truncateToWidth(content, innerWidth, "");
+    const padding = safeRepeat(" ", innerWidth - visibleWidth(truncated));
+    return `${this.fg("borderMuted", "│")}${truncated}${padding}${this.fg("borderMuted", "│")}`;
+  }
+
+  private ruleLine(innerWidth: number): string {
+    return this.fg("borderMuted", `├${safeRepeat("─", innerWidth)}┤`);
+  }
+
+  private borderLine(innerWidth: number, edge: "top" | "bottom"): string {
+    const left = edge === "top" ? "┌" : "└";
+    const right = edge === "top" ? "┐" : "┘";
+    return this.fg("borderMuted", `${left}${safeRepeat("─", innerWidth)}${right}`);
+  }
+
+  render(width: number): string[] {
+    const innerWidth = boxInnerWidth(width);
+    const lines: string[] = [];
+
+    const title =
+      this.kind === "generate"
+        ? "🎨 Image Generation Model"
+        : "👁  Image Recognition Model";
+    const subtitle =
+      this.kind === "generate"
+        ? "Model used by image_generate"
+        : "Vision model used by image_recognize";
+
+    lines.push(this.borderLine(innerWidth, "top"));
+    lines.push(this.frameLine(this.fg("accent", this.bold(title)), innerWidth));
+    lines.push(this.frameLine(this.fg("dim", subtitle), innerWidth));
+    lines.push(this.ruleLine(innerWidth));
+
+    // Filter bar
+    if (this.filterMode) {
+      lines.push(
+        this.frameLine(
+          `  ${this.fg("accent", "Filter:")} ${this.filter}${this.fg("accent", "█")}`,
+          innerWidth,
+        ),
+      );
+    } else if (this.filter) {
+      lines.push(
+        this.frameLine(
+          `  ${this.fg("dim", "Filter:")} ${this.filter} ${this.fg("dim", "(press / to edit)")}`,
+          innerWidth,
+        ),
+      );
+    } else {
+      lines.push(
+        this.frameLine(
+          `  ${this.fg("dim", `${this.models.length} models · press / to filter`)}`,
+          innerWidth,
+        ),
+      );
+    }
+    lines.push(this.ruleLine(innerWidth));
+
+    // Model list
+    const terminalRows = process.stdout.rows ?? 30;
+    const maxVisible = Math.max(5, terminalRows - 14);
+    const start = Math.max(0, this.selectedIndex - Math.floor(maxVisible / 2));
+    const end = Math.min(this.filtered.length, start + maxVisible);
+
+    if (this.filtered.length === 0) {
+      const empty =
+        this.models.length === 0
+          ? this.kind === "generate"
+            ? "No image models available (needs OpenRouter)"
+            : "No vision-capable models configured"
+          : "No models match the filter";
+      lines.push(this.frameLine(`  ${this.fg("dim", empty)}`, innerWidth));
+    } else {
+      for (let i = start; i < end; i++) {
+        const model = this.filtered[i];
+        const isSelected = i === this.selectedIndex;
+        const marker = isSelected ? this.fg("accent", "▸") : " ";
+        const label = model.name || model.id;
+        const providerTag = this.fg("dim", `[${model.provider}]`);
+        const display = isSelected
+          ? `${providerTag} ${this.bold(label)}`
+          : `${providerTag} ${this.fg("dim", label)}`;
+        lines.push(this.frameLine(`  ${marker} ${display}`, innerWidth));
+      }
+    }
+
+    if (this.filtered.length > maxVisible) {
+      const pct = Math.round(((this.selectedIndex + 1) / this.filtered.length) * 100);
+      lines.push(
+        this.frameLine(
+          this.fg("dim", `  ${pct}% (${this.selectedIndex + 1}/${this.filtered.length})`),
+          innerWidth,
+        ),
+      );
+    }
+
+    if (this.error) {
+      lines.push(this.ruleLine(innerWidth));
+      lines.push(this.frameLine(`  ${this.fg("error", `⚠ ${this.error}`)}`, innerWidth));
+    }
+    if (this.saved) {
+      lines.push(this.ruleLine(innerWidth));
+      lines.push(this.frameLine(`  ${this.fg("success", "✓ Model saved")}`, innerWidth));
+    }
+
+    lines.push(this.ruleLine(innerWidth));
+    lines.push(
+      this.frameLine(
+        this.fg("dim", "↑↓ navigate · / filter · Enter select · Esc cancel"),
+        innerWidth,
+      ),
+    );
+    lines.push(this.borderLine(innerWidth, "bottom"));
+
+    return lines;
+  }
+}

package/packages/image/src/tui/settings-dialog.ts

@@ -0,0 +1,236 @@
+/**
+ * @pi-unipi/image — Settings dialog
+ *
+ * Simple `ctx.ui.select` loop, matching the web-api settings pattern. The
+ * model pickers are richer overlays (see model-selector.ts).
+ */
+
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+import {
+  DEFAULT_CONFIG,
+  DEFAULT_RECOGNIZE_SYSTEM_PROMPT,
+  getOutputDir,
+  loadConfig,
+  saveConfig,
+  type ImageConfig,
+} from "../settings.js";
+import {
+  formatModelRef,
+  listImageGenModels,
+  listVisionModels,
+  type ChatModelRegistry,
+} from "../models.js";
+import { ImageModelSelectorOverlay, type SelectableModel } from "./model-selector.js";
+
+const EXIT = "__exit__";
+
+function describe(config: ImageConfig): Array<{ value: string; label: string }> {
+  return [
+    {
+      value: "__gen_model__",
+      label: `🎨 Generation model — ${config.generate.model || "(none)"}`,
+    },
+    {
+      value: "__gen_enabled__",
+      label: `   image_generate tool — ${config.generate.enabled ? "enabled" : "disabled"}`,
+    },
+    {
+      value: "__gen_save__",
+      label: `   Save to disk — ${config.generate.saveToDisk ? "on" : "off"}`,
+    },
+    {
+      value: "__gen_dir__",
+      label: `   Output directory — ${config.generate.outputDir}`,
+    },
+    {
+      value: "__rec_model__",
+      label: `👁  Recognition model — ${config.recognize.model || "(session model)"}`,
+    },
+    {
+      value: "__rec_enabled__",
+      label: `   image_recognize tool — ${config.recognize.enabled ? "enabled" : "disabled"}`,
+    },
+    {
+      value: "__rec_prompt__",
+      label: `   System prompt — ${summarize(config.recognize.systemPrompt)}`,
+    },
+    { value: "__reset__", label: "↺  Reset to defaults" },
+    { value: EXIT, label: "←  Back" },
+  ];
+}
+
+function summarize(text: string, max = 45): string {
+  const flat = text.replace(/\s+/g, " ").trim();
+  if (!flat) return "(empty)";
+  return flat.length <= max ? flat : `${flat.slice(0, max)}…`;
+}
+
+/** Show the settings dialog until the user backs out. */
+export async function showSettingsDialog(ctx: ExtensionCommandContext): Promise<void> {
+  for (;;) {
+    const config = loadConfig();
+    const options = describe(config);
+    const labels = options.map((o) => o.label);
+
+    const picked = await ctx.ui.select("Image Settings", labels);
+    if (!picked) return;
+
+    const choice = options.find((o) => o.label === picked)?.value;
+    if (!choice || choice === EXIT) return;
+
+    await applyChoice(ctx, choice, config);
+  }
+}
+
+async function applyChoice(
+  ctx: ExtensionCommandContext,
+  choice: string,
+  config: ImageConfig,
+): Promise<void> {
+  switch (choice) {
+    case "__gen_enabled__":
+      config.generate.enabled = !config.generate.enabled;
+      saveConfig(config);
+      ctx.ui.notify(
+        `image_generate ${config.generate.enabled ? "enabled" : "disabled"} — restart the session to apply.`,
+        "info",
+      );
+      return;
+
+    case "__rec_enabled__":
+      config.recognize.enabled = !config.recognize.enabled;
+      saveConfig(config);
+      ctx.ui.notify(
+        `image_recognize ${config.recognize.enabled ? "enabled" : "disabled"} — restart the session to apply.`,
+        "info",
+      );
+      return;
+
+    case "__gen_save__":
+      config.generate.saveToDisk = !config.generate.saveToDisk;
+      saveConfig(config);
+      ctx.ui.notify(
+        config.generate.saveToDisk
+          ? `Generated images will be saved to ${getOutputDir(config)}`
+          : "Generated images will be returned inline only.",
+        "info",
+      );
+      return;
+
+    case "__gen_dir__": {
+      const value = await ctx.ui.input(
+        "Output directory for generated images",
+        config.generate.outputDir,
+      );
+      if (value?.trim()) {
+        config.generate.outputDir = value.trim();
+        saveConfig(config);
+        ctx.ui.notify(`Output directory set to ${getOutputDir(config)}`, "info");
+      }
+      return;
+    }
+
+    case "__rec_prompt__": {
+      const value = await ctx.ui.input(
+        "System prompt for image recognition (blank to restore the default)",
+        config.recognize.systemPrompt,
+      );
+      if (value === undefined) return;
+      config.recognize.systemPrompt = value.trim() || DEFAULT_RECOGNIZE_SYSTEM_PROMPT;
+      saveConfig(config);
+      ctx.ui.notify("System prompt updated.", "info");
+      return;
+    }
+
+    case "__gen_model__":
+      await pickModel(ctx, "generate", config);
+      return;
+
+    case "__rec_model__":
+      await pickModel(ctx, "recognize", config);
+      return;
+
+    case "__reset__":
+      saveConfig(structuredClone(DEFAULT_CONFIG));
+      ctx.ui.notify("Image settings reset to defaults.", "info");
+      return;
+  }
+}
+
+async function pickModel(
+  ctx: ExtensionCommandContext,
+  kind: "generate" | "recognize",
+  config: ImageConfig,
+): Promise<void> {
+  const models = await collectModels(ctx, kind);
+
+  if (models.length === 0) {
+    ctx.ui.notify(
+      kind === "generate"
+        ? "No image models available. Image generation is served through OpenRouter — add a key with /login."
+        : "No vision-capable models configured. Add a model that accepts image input.",
+      "warning",
+    );
+    return;
+  }
+
+  if (!ctx.hasUI) {
+    ctx.ui.notify("Model selection requires an interactive UI.", "warning");
+    return;
+  }
+
+  const current =
+    kind === "generate" ? config.generate.model : config.recognize.model;
+
+  await new Promise<void>((resolve) => {
+    ctx.ui.custom(
+      (tui, theme, _keybindings, done) => {
+        const overlay = new ImageModelSelectorOverlay(kind, models, current);
+        overlay.setTheme(theme);
+        overlay.onSelect = (modelRef) => {
+          const next = loadConfig();
+          if (kind === "generate") next.generate.model = modelRef;
+          else next.recognize.model = modelRef;
+          saveConfig(next);
+        };
+        overlay.onClose = () => done(undefined);
+        return {
+          render: (width: number) => overlay.render(width),
+          invalidate: () => overlay.invalidate(),
+          handleInput: (data: string) => {
+            overlay.handleInput(data);
+            tui.requestRender();
+          },
+        };
+      },
+      {
+        overlay: true,
+        overlayOptions: { width: "80%", minWidth: 50, anchor: "center", margin: 2 },
+      },
+    );
+    resolve();
+  });
+}
+
+async function collectModels(
+  ctx: ExtensionCommandContext,
+  kind: "generate" | "recognize",
+): Promise<SelectableModel[]> {
+  if (kind === "generate") {
+    const models = await listImageGenModels();
+    return models.map((m) => ({ provider: m.provider, id: m.id, name: m.name }));
+  }
+
+  const registry = (ctx as unknown as { modelRegistry?: ChatModelRegistry })
+    .modelRegistry;
+  if (!registry) return [];
+
+  return listVisionModels(registry).map((m) => ({
+    provider: m.provider,
+    id: m.id,
+    name: m.name,
+  }));
+}
+
+export { formatModelRef };

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.1.2",
+  "version": "2.2.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.1.2"
+    "@pi-unipi/core": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/info-screen/tui/info-overlay.ts

@@ -13,6 +13,7 @@ import type { Theme } from "@earendil-works/pi-coding-agent";
 import { infoRegistry } from "../registry.js";
 import { getInfoSettings } from "../config.js";
 import type { InfoGroup, GroupData } from "../types.js";
+import { boxInnerWidth } from "@pi-unipi/core";
 
 /** Tab color palette */
 const TAB_FG: Array<"accent" | "success" | "warning" | "error"> = [
@@ -275,7 +276,7 @@ export class InfoOverlay implements Component {
   // ─── State views ─────────────────────────────────────────────────────
 
   private renderEmpty(width: number): string[] {
-    const innerWidth = Math.max(22, width - 2);
+    const innerWidth = boxInnerWidth(width);
     const lines: string[] = [];
     lines.push(this.borderLine(innerWidth, "top"));
     lines.push(this.frameLine(this.fg("accent", this.bold("📊 UniPi Info Screen")), innerWidth));
@@ -292,7 +293,7 @@ export class InfoOverlay implements Component {
   // ─── Dashboard ───────────────────────────────────────────────────────
 
   private renderDashboard(width: number): string[] {
-    const innerWidth = Math.max(22, width - 2);
+    const innerWidth = boxInnerWidth(width);
     const group = this.groups[this.activeTabIndex];
     const data = this.groupData.get(group.id) ?? {};
     const isLoading = this.groupLoading.get(group.id) ?? false;

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -27,13 +27,13 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+    "test": "npx tsx --test tests/**/*.test.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.1.2",
+  "version": "2.2.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.1.2"
+    "@pi-unipi/core": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -27,7 +27,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.2.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/src/tui/add-overlay.ts

@@ -31,6 +31,7 @@ import {
   getProjectConfigDir,
 } from "../config/manager.js";
 import { validateMcpConfig, DEFAULT_MCP_CONFIG, DEFAULT_METADATA } from "../config/schema.js";
+import { boxInnerWidth, normalizeWidth, WidthKeyedCache } from "@pi-unipi/core";
 
 type Mode = "normal" | "search" | "editor";
 type StatusKind = "info" | "success" | "warn" | "error";
@@ -158,11 +159,12 @@ export function renderMcpAddOverlay(params?: {
     // Ctrl+S handles saving; no submit path needed.
     (editor as any).disableSubmit = true;
 
-    let cachedLines: string[] | undefined;
+    // Width-keyed so a terminal resize can never serve stale, over-wide lines.
+    const lineCache = new WidthKeyedCache();
     let lastListHeight = 12;
 
     function refresh() {
-      cachedLines = undefined;
+      lineCache.clear();
       tui.requestRender();
     }
 
@@ -537,11 +539,13 @@ export function renderMcpAddOverlay(params?: {
 
     // ─── Rendering ────────────────────────────────────────────────────
 
-    function render(width: number): string[] {
-      if (cachedLines) return cachedLines;
+    function render(rawWidth: number): string[] {
+      const width = normalizeWidth(rawWidth);
+      const cached = lineCache.get(width);
+      if (cached) return cached;
 
       const lines: string[] = [];
-      const innerWidth = Math.max(40, width - 2);
+      const innerWidth = boxInnerWidth(width);
 
       // Pane widths: account for left │, middle │, right │ borders
       const leftW = Math.floor((innerWidth - 1) / 2);
@@ -776,8 +780,7 @@ export function renderMcpAddOverlay(params?: {
       );
       lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
 
-      cachedLines = lines;
-      return lines;
+      return lineCache.set(width, lines);
     }
 
     return { render, invalidate: refresh, handleInput };