@pi-unipi/unipi 2.14.1 → 2.14.2

package/CHANGELOG.md

@@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.14.2] — 2026-08-31
+
+### Fixed
+
+- `footer`: **glance frame no longer writes the terminal's last column** (GitHub [#31](https://github.com/Neuron-Mr-White/UniPi/issues/31)) — the glance frame, session strip, process one-liner, and classic status line now cap emitted lines at `width - 1` instead of exactly `width`. pi-tui joins per-tick rewrites with `\r\n`; a line at EXACTLY the terminal width trips auto-wrap on terminals that wrap immediately (or whose glyph widths disagree with `visibleWidth()`, e.g. missing Nerd Fonts / ambiguous-width settings), silently desyncing the differential renderer so every 1s footer refresh painted a fresh input-box copy one block lower until the screen filled. Verified by PTY capture + VT replay: identical byte stream renders 1 stable frame on deferred-wrap terminals vs 12 stacked frames on immediate-wrap ones; the cap removes the footer's contribution entirely. Full resolution of terminal-side drift from pi's own boot/info lines is upstream (pi-tui main-screen wrap-safe bookkeeping).
+- `web-api`: **fetch errors surface their real cause instead of "[object Object]"** — engine errors were plain objects (`{ error, code, phase, retryable }`), so every tool-level catch serialized them via `String()` and both the agent and the user saw only "Read failed: [object Object]" with no diagnosis. `createError()` now returns a real `Error` instance carrying the FetchError fields (interface-compatible: `.error`/`.code`/`.phase`/`.retryable` preserved, classification untouched), and a new `describeError()` normalizes Error instances, FetchError-shaped objects, `{message}`/`{reason}`/`{detail}` shapes, strings, and unserializable values at every tool boundary and in the provider fallthrough. Regression tests cover all shapes; a provider throwing `{ error: "HTTP 429" }` now reports the 429 instead of nothing.
+
 ## [2.14.1] — 2026-08-28
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.14.1",
+  "version": "2.14.2",
   "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.14.1",
-    "@pi-unipi/background-tasks": "2.14.1",
-    "@pi-unipi/btw": "2.14.1",
-    "@pi-unipi/command-enchantment": "2.14.1",
-    "@pi-unipi/compactor": "2.14.1",
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/footer": "2.14.1",
-    "@pi-unipi/image": "2.14.1",
-    "@pi-unipi/info-screen": "2.14.1",
-    "@pi-unipi/input-shortcuts": "2.14.1",
-    "@pi-unipi/kanboard": "2.14.1",
-    "@pi-unipi/mcp": "2.14.1",
-    "@pi-unipi/memory": "2.14.1",
-    "@pi-unipi/milestone": "2.14.1",
-    "@pi-unipi/notify": "2.14.1",
-    "@pi-unipi/ralph": "2.14.1",
-    "@pi-unipi/subagents": "2.14.1",
-    "@pi-unipi/trajectory": "2.14.1",
-    "@pi-unipi/updater": "2.14.1",
-    "@pi-unipi/utility": "2.14.1",
-    "@pi-unipi/web-api": "2.14.1",
-    "@pi-unipi/workflow": "2.14.1"
+    "@pi-unipi/ask-user": "2.14.2",
+    "@pi-unipi/background-tasks": "2.14.2",
+    "@pi-unipi/btw": "2.14.2",
+    "@pi-unipi/command-enchantment": "2.14.2",
+    "@pi-unipi/compactor": "2.14.2",
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/footer": "2.14.2",
+    "@pi-unipi/image": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2",
+    "@pi-unipi/input-shortcuts": "2.14.2",
+    "@pi-unipi/kanboard": "2.14.2",
+    "@pi-unipi/mcp": "2.14.2",
+    "@pi-unipi/memory": "2.14.2",
+    "@pi-unipi/milestone": "2.14.2",
+    "@pi-unipi/notify": "2.14.2",
+    "@pi-unipi/ralph": "2.14.2",
+    "@pi-unipi/subagents": "2.14.2",
+    "@pi-unipi/trajectory": "2.14.2",
+    "@pi-unipi/updater": "2.14.2",
+    "@pi-unipi/utility": "2.14.2",
+    "@pi-unipi/web-api": "2.14.2",
+    "@pi-unipi/workflow": "2.14.2"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.14.1",
-  "description": "Structured user input tool for Pi coding agent \u2014 single-select, multi-select, freeform",
+  "version": "2.14.2",
+  "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.14.2"
   },
   "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.14.1",
+  "version": "2.14.2",
   "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,7 +1,7 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.14.1",
-  "description": "Background tasks for UniPi \u2014 durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
+  "version": "2.14.2",
+  "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.14.1",
+    "@pi-unipi/core": "2.14.2",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.14.1",
-  "description": "A pi extension for parallel side conversations with /unipi:btw \u2014 part of the Unipi suite",
+  "version": "2.14.2",
+  "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
   "license": "MIT",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.84.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.14.2"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

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

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.14.1",
+  "version": "2.14.2",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.14.1",
-  "description": "Persistent status bar for Unipi \u2014 subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
+  "version": "2.14.2",
+  "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/background-tasks": "2.14.1"
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/background-tasks": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/footer/src/glance-editor.ts

@@ -63,6 +63,24 @@ function repeat(s: string, n: number): string {
 	return s.repeat(Math.max(0, n));
 }
 
+/**
+ * Frame width for a terminal of `terminalWidth` columns: one column SHORT of
+ * the terminal (legacy 8-column floor preserved below 9 columns).
+ *
+ * Issue #31 invariant — the frame is repainted every second and pi-tui joins
+ * the rewritten lines with "\r\n". A line at EXACTLY the terminal width hits
+ * the auto-wrap threshold: on terminals that wrap immediately (and whenever
+ * a glyph renders wider than visibleWidth() assumed) the cursor silently
+ * advances one extra row per line, desyncing the differential renderer —
+ * every refresh then paints a fresh frame copy one block lower until the
+ * screen fills. Never writing the last column keeps every frame line below
+ * the wrap threshold on every terminal.
+ */
+export function glanceFrameWidth(terminalWidth: number): number {
+	if (!Number.isFinite(terminalWidth)) return 8;
+	return Math.max(8, terminalWidth - 1);
+}
+
 function padLine(line: string, width: number): string {
 	const w = visibleWidth(line);
 	if (w === width) return line;
@@ -160,7 +178,8 @@ export class GlanceEditor extends CustomEditor {
 	}
 
 	override render(width: number): string[] {
-		const safe = Math.max(8, width);
+		// One column short of the terminal — see glanceFrameWidth() / issue #31.
+		const safe = glanceFrameWidth(width);
 		const inner = Math.max(0, safe - 2);
 
 		// Base render at inner width: harvest content rows only (rules dropped).

package/packages/footer/src/index.ts

@@ -354,8 +354,11 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         // Hard safety net: never return a line wider than the terminal.
         // This catches any edge cases in layout math or visibleWidth()
         // inconsistencies with PUA characters + ANSI codes.
+        // Cap at width - 1 (issue #31): a line at EXACTLY the terminal width
+        // trips immediate-wrap terminals and desyncs the diff renderer.
         const line = layout.topContent;
-        return [visibleWidth(line) > width ? truncateToWidth(line, width) : line];
+        const cap = Math.max(1, width - 1);
+        return [visibleWidth(line) > cap ? truncateToWidth(line, cap) : line];
       },
     };
   }, { placement: "aboveEditor" });
@@ -373,7 +376,9 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         if (!strip) return [];
         // Centered under the input box.
         const w = visibleWidth(strip);
-        if (w >= width) return [truncateToWidth(strip, width)];
+        // Truncate one column short of the terminal (issue #31 — same wrap
+        // desync as the glance frame; see glanceFrameWidth()).
+        if (w >= width) return [truncateToWidth(strip, Math.max(1, width - 1))];
         const leftPad = Math.floor((width - w) / 2);
         return [" ".repeat(leftPad) + strip];
       },

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

@@ -55,7 +55,9 @@ export function countBgProcesses(): BgProcessCounts | null {
  * Returns [] when there is nothing to show.
  */
 export function renderProcessLine(width: number): string[] {
-  if (width <= 0) return [];
+  // One column can never host a meaningful one-liner, and any content would
+  // be exactly-full-width (issue #31 wrap desync) — render nothing.
+  if (width <= 1) return [];
   const counts = countBgProcesses();
   if (!counts) return [];
 
@@ -68,7 +70,9 @@ export function renderProcessLine(width: number): string[] {
 
   const line = parts.join("  ");
   const w = visibleWidth(line);
-  if (w >= width) return [truncateToWidth(line, width)];
+  // One column short of the terminal (issue #31 — same wrap desync as the
+  // glance frame; see glanceFrameWidth() in glance-editor.ts).
+  if (w >= width) return [truncateToWidth(line, Math.max(1, width - 1))];
   const leftPad = Math.floor((width - w) / 2);
   return [" ".repeat(leftPad) + line];
 }

package/packages/image/package.json

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

package/packages/info-screen/package.json

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

package/packages/input-shortcuts/package.json

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

package/packages/kanboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.14.1",
-  "description": "Visualization layer for unipi workflow \u2014 HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
+  "version": "2.14.2",
+  "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",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

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

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.14.1",
+  "version": "2.14.2",
   "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.14.1",
-    "@pi-unipi/info-screen": "2.14.1",
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

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

package/packages/notify/package.json

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

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.14.1",
+  "version": "2.14.2",
   "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.14.1",
-    "@pi-unipi/info-screen": "2.14.1"
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.14.1",
-  "description": "Subagents for UniPi \u2014 parallel execution, file locking, workflow integration",
+  "version": "2.14.2",
+  "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -9,7 +9,7 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
+    "@pi-unipi/core": "2.14.2",
     "@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.14.1",
+  "version": "2.14.2",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",