@pi-unipi/unipi 2.1.0 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -65,26 +65,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.1.0",
-    "@pi-unipi/btw": "2.1.0",
-    "@pi-unipi/compactor": "2.1.0",
-    "@pi-unipi/notify": "2.1.0",
-    "@pi-unipi/command-enchantment": "2.1.0",
-    "@pi-unipi/core": "2.1.0",
-    "@pi-unipi/info-screen": "2.1.0",
-    "@pi-unipi/mcp": "2.1.0",
-    "@pi-unipi/memory": "2.1.0",
-    "@pi-unipi/ralph": "2.1.0",
-    "@pi-unipi/subagents": "2.1.0",
-    "@pi-unipi/utility": "2.1.0",
-    "@pi-unipi/milestone": "2.1.0",
-    "@pi-unipi/kanboard": "2.1.0",
-    "@pi-unipi/web-api": "2.1.0",
-    "@pi-unipi/workflow": "2.1.0",
-    "@pi-unipi/footer": "2.1.0",
-    "@pi-unipi/updater": "2.1.0",
-    "@pi-unipi/input-shortcuts": "2.1.0",
-    "@pi-unipi/cocoindex": "2.1.0"
+    "@pi-unipi/ask-user": "2.1.2",
+    "@pi-unipi/btw": "2.1.2",
+    "@pi-unipi/compactor": "2.1.2",
+    "@pi-unipi/notify": "2.1.2",
+    "@pi-unipi/command-enchantment": "2.1.2",
+    "@pi-unipi/core": "2.1.2",
+    "@pi-unipi/info-screen": "2.1.2",
+    "@pi-unipi/mcp": "2.1.2",
+    "@pi-unipi/memory": "2.1.2",
+    "@pi-unipi/ralph": "2.1.2",
+    "@pi-unipi/subagents": "2.1.2",
+    "@pi-unipi/utility": "2.1.2",
+    "@pi-unipi/milestone": "2.1.2",
+    "@pi-unipi/kanboard": "2.1.2",
+    "@pi-unipi/web-api": "2.1.2",
+    "@pi-unipi/workflow": "2.1.2",
+    "@pi-unipi/footer": "2.1.2",
+    "@pi-unipi/updater": "2.1.2",
+    "@pi-unipi/input-shortcuts": "2.1.2",
+    "@pi-unipi/cocoindex": "2.1.2"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.80.0",

package/packages/ask-user/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.1.0",
-  "description": "Structured user input tool for Pi coding agent \u2014 single-select, multi-select, freeform",
+  "version": "2.1.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.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/ask-user/tools.ts

@@ -11,6 +11,7 @@ import {
   COMPACTOR_INSTRUCTION,
   UNIPI_EVENTS,
   emitEvent,
+  withHerdrBlocked,
 } from "@pi-unipi/core";
 import type { NormalizedOption, AskUserResponse, SessionLauncherResult } from "./types.js";
 import { renderAskUI, createRenderCall, createRenderResult } from "./ask-ui.js";
@@ -272,15 +273,19 @@ export function registerAskUserTools(pi: ExtensionAPI): void {
       }
 
       // Render interactive UI
-      const result = await ctx.ui.custom<{ response: AskUserResponse } | null>(
-        renderAskUI({
-          question,
-          context,
-          options: normalizedOptions,
-          allowMultiple,
-          allowFreeform,
-          timeout,
-        }),
+      const result = await withHerdrBlocked(
+        pi,
+        "ask_user",
+        () => ctx.ui.custom<{ response: AskUserResponse } | null>(
+          renderAskUI({
+            question,
+            context,
+            options: normalizedOptions,
+            allowMultiple,
+            allowFreeform,
+            timeout,
+          }),
+        ),
       );
 
       // Handle cancel
@@ -346,8 +351,12 @@ export function registerAskUserTools(pi: ExtensionAPI): void {
       // Session launcher intercept: when user selects new_session, offer compact/direct/cancel
       if (response.kind === "new_session") {
         const prefill = response.prefill || "";
-        const launcherResult = await ctx.ui.custom<SessionLauncherResult | null>(
-          renderLauncherUI({ prefill }),
+        const launcherResult = await withHerdrBlocked(
+          pi,
+          "ask_user: launch",
+          () => ctx.ui.custom<SessionLauncherResult | null>(
+            renderLauncherUI({ prefill }),
+          ),
         );
 
         if (!launcherResult || launcherResult.action === "cancel") {

package/packages/autocomplete/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.1.0",
-  "description": "Enhanced TUI autocomplete for /unipi:* commands \u2014 colored, sorted, and grouped by package",
+  "version": "2.1.2",
+  "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",

package/packages/btw/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.1.0",
-  "description": "A pi extension for parallel side conversations with /unipi:btw \u2014 part of the Unipi suite",
+  "version": "2.1.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.80.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "pi": {
     "extensions": [],

package/packages/cocoindex/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/cocoindex",
-  "version": "2.1.0",
-  "description": "CocoIndex integration for Pi \u2014 AST-aware content indexing, semantic vector search, and incremental pipeline management",
+  "version": "2.1.2",
+  "description": "CocoIndex integration for Pi — AST-aware content indexing, semantic vector search, and incremental pipeline management",
   "type": "module",
   "main": "index.ts",
   "types": "index.ts",
@@ -25,7 +25,7 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "optionalDependencies": {
     "@lancedb/lancedb": "^0.21.0"

package/packages/compactor/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.1.0",
-  "description": "Context engine for Pi \u2014 zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
+  "version": "2.1.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.1.0",
-    "@pi-unipi/info-screen": "2.1.0",
+    "@pi-unipi/core": "2.1.2",
+    "@pi-unipi/info-screen": "2.1.2",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "peerDependencies": {
@@ -51,8 +51,12 @@
     "better-sqlite3": ">=11.0.0"
   },
   "pi": {
-    "extensions": [],
-    "skills": [],
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ],
     "prompts": [],
     "themes": []
   }

package/packages/core/package.json

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

package/packages/core/utils.ts

@@ -240,3 +240,29 @@ export function emitEvent(
     return false;
   }
 }
+
+/**
+ * Wrap an awaitable blocking-UI operation with herdr `blocked` state reporting.
+ *
+ * Emits `herdr:blocked` active (with a label) before awaiting `fn`, and
+ * inactive (with matching label) afterwards — including on throw. This lets
+ * the herdr integration surface `blocked` agent status for ask_user and other
+ * stop-and-continue UIs instead of `working`.
+ *
+ * The label should match what's shown to the user so herdr's sidebar reads
+ * meaningfully (e.g. "ask_user", "helper viewer").
+ */
+export async function withHerdrBlocked<T>(
+  pi: { events: { emit: (name: string, payload: unknown) => void } },
+  label: string,
+  fn: () => Promise<T>,
+): Promise<T> {
+  const event = (active: boolean) =>
+    emitEvent(pi, "herdr:blocked", { active, label });
+  event(true);
+  try {
+    return await fn();
+  } finally {
+    event(false);
+  }
+}

package/packages/footer/package.json

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

package/packages/footer/src/index.ts

@@ -96,6 +96,14 @@ export default function footerExtension(pi: ExtensionAPI): void {
     state.registry.registerGroup(group);
   }
 
+  // ─── TPS streaming-event hooks (registered once) ────────────────────────
+  // pi.on() has no unsubscribe, so we register these exactly once at factory
+  // time (not per session_start) to avoid duplicate handlers accumulating
+  // across session restarts. The streamingIndex counter is reset on each
+  // session_shutdown. These hooks feed the TPS tracker in real time; the
+  // 1s branch-scan in the refresh timer only reconciles persisted messages.
+  wireTpsStreamingEvents(pi);
+
   // ─── Session lifecycle ──────────────────────────────────────────────────
 
   pi.on("session_start", async (_event, ctx) => {
@@ -127,6 +135,7 @@ export default function footerExtension(pi: ExtensionAPI): void {
     }
     state.tuiRef = null;
     tpsTracker.reset();
+    resetTpsStreamingIndex();
   });
 
   // ─── Register commands ──────────────────────────────────────────────────
@@ -152,10 +161,14 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
   ctx.ui.setFooter((tui, _theme, footerData) => {
     state.tuiRef = tui;
 
-    // Start periodic refresh for time-sensitive segments (e.g. clock)
+    // Start periodic refresh for time-sensitive segments (e.g. clock, TPS)
     if (!state.refreshTimer) {
       state.refreshTimer = setInterval(() => {
-        // Feed TPS tracker with per-message data
+        // Re-seed TPS tracker from the session branch on each tick.
+        // Streaming events (message_start/update/end) handle live updates
+        // in real time; this scan reconciles the tracker with persisted
+        // messages after compactions, branch switches, or session reloads
+        // where in-flight streaming state may have been lost.
         try {
           const piCtx = state.piContext as Record<string, unknown> | undefined;
           if (piCtx?.sessionManager) {
@@ -168,9 +181,10 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
               const m = e.message;
               if (!m || m.role !== "assistant") continue;
               if (m.stopReason === "error" || m.stopReason === "aborted") continue;
-              const output = m.usage?.output ?? 0;
               const hasStop = !!m.stopReason;
-              tpsTracker.onMessageUpdate(msgIndex, output, hasStop);
+              // Pass the whole message: TPS tracker counts tokens from content,
+              // not from usage.output (which is 0 during streaming).
+              tpsTracker.onMessageUpdate(msgIndex, m, hasStop);
               msgIndex++;
             }
           }
@@ -251,3 +265,56 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
     };
   }, { placement: "belowEditor" });
 }
+
+// ─── TPS streaming-event hooks ──────────────────────────────────────────────
+
+/**
+ * Sequential index of the currently-streaming assistant message. Tracked
+ * locally because pi does not expose a stable message index on streaming
+ * events, and the TPS tracker keys records off this index.
+ */
+let tpsStreamingIndex = -1;
+
+/** Reset the streaming index (called on session_shutdown). */
+function resetTpsStreamingIndex(): void {
+  tpsStreamingIndex = -1;
+}
+
+/**
+ * Subscribe to pi's message streaming events and feed the TPS tracker in real
+ * time. This complements the 1s branch-scan in the refresh timer, which only
+ * sees persisted (completed) messages. Without these hooks the tracker would
+ * never observe an in-flight assistant message, so live TPS would stay frozen
+ * at the last completed message's value.
+ *
+ * Registered once at extension-factory time (pi.on has no unsubscribe, so we
+ * must not re-register per session_start or handlers would accumulate).
+ */
+function wireTpsStreamingEvents(pi: ExtensionAPI): void {
+  const safe = (fn: () => void) => {
+    try { fn(); } catch { /* TPS is best-effort */ }
+  };
+
+  pi.on("message_start", ((event: { message: unknown }) => safe(() => {
+    const m = event.message as Record<string, unknown> | undefined;
+    if (!m || m.role !== "assistant") return;
+    if (m.stopReason === "error" || m.stopReason === "aborted") return;
+    tpsStreamingIndex++;
+    tpsTracker.onMessageUpdate(tpsStreamingIndex, m, false);
+  })) as (event: unknown) => void);
+
+  pi.on("message_update", ((event: { message: unknown }) => safe(() => {
+    if (tpsStreamingIndex < 0) return;
+    const m = event.message as Record<string, unknown> | undefined;
+    if (!m || m.role !== "assistant") return;
+    tpsTracker.onMessageUpdate(tpsStreamingIndex, m, false);
+  })) as (event: unknown) => void);
+
+  pi.on("message_end", ((event: { message: unknown }) => safe(() => {
+    if (tpsStreamingIndex < 0) return;
+    const m = event.message as Record<string, unknown> | undefined;
+    if (!m || m.role !== "assistant") return;
+    if (m.stopReason === "error" || m.stopReason === "aborted") return;
+    tpsTracker.onMessageUpdate(tpsStreamingIndex, m, true);
+  })) as (event: unknown) => void);
+}

package/packages/footer/src/tps-tracker.ts

@@ -4,37 +4,112 @@
  * Per-message TPS calculation for live generation rate display.
  * Tracks individual assistant messages with start/stop timestamps
  * to measure generation rate excluding idle/tool-execution time.
+ *
+ * ## Token counting
+ *
+ * Output tokens are counted from the assistant message *content* (text +
+ * thinking blocks) via a lightweight word/char heuristic, NOT from
+ * `usage.output`. Rationale:
+ *   - `usage.output` is only populated by the provider at stream end (or in
+ *     a final `message_delta`), so it is 0 throughout generation and useless
+ *     for a live rate.
+ *   - Counting the streamed text ourselves gives a real, monotonically
+ *     increasing numerator that reflects how much the model has actually
+ *     produced so far.
+ *   - This matches what users perceive as "tokens per second" (visible
+ *     output rate) and avoids the previous bug where the displayed TPS was
+ *     always inflated to 90+ t/s (caused by dividing a post-hoc `usage.output`
+ *     total by a too-short, incorrectly measured elapsed window).
+ *
+ * The heuristic intentionally over-counts slightly (whitespace + punctuation
+ * are treated as tokens). That is acceptable for a live speed indicator and
+ * keeps the estimate in the right order of magnitude (within ~10-20% of the
+ * provider's reported output tokens for typical English/code output).
  */
 
 /** Per-message TPS record */
 interface MessageTpsRecord {
-  /** Message index in the session */
+  /** Message index in the session (sequential, assistant-only) */
   messageIndex: number;
-  /** Output tokens for this message */
+  /** Estimated output tokens produced so far for this message */
   outputTokens: number;
-  /** When generation started (Date.now()) */
+  /** When generation started (Date.now(), ms) */
   startedAt: number;
-  /** When generation completed (Date.now()), 0 if still generating */
+  /** When generation completed (Date.now(), ms), 0 if still generating */
   completedAt: number;
-  /** Computed TPS for this message */
+  /** Computed TPS for this message (final, once completed) */
   tps: number;
 }
 
+/**
+ * Estimate the number of tokens in a string.
+ *
+ * Uses a cheap word + punctuation split. Good enough for a live TPS display;
+ * we deliberately avoid pulling in a full BPE tokenizer for performance and
+ * footprint reasons.
+ */
+function estimateTokens(text: string): number {
+  if (!text) return 0;
+  // Count word-ish tokens and standalone punctuation.
+  // \p{L} / \p{N} keep this Unicode-aware for non-ASCII content.
+  const wordish = text.match(/[\p{L}\p{N}]+/gu);
+  const punct = text.match(/[^\s\p{L}\p{N}]+/gu);
+  const wordCount = wordish ? wordish.length : 0;
+  const punctCount = punct ? punct.length : 0;
+  return wordCount + punctCount;
+}
+
+/**
+ * Estimate output tokens from an assistant message by summing text and
+ * thinking content lengths. Tool-call argument JSON is also counted since
+ * it represents model output.
+ *
+ * Accepts the raw message shape from pi's session entries (loosely typed).
+ */
+function estimateOutputTokens(message: unknown): number {
+  if (!message || typeof message !== "object") return 0;
+  const m = message as Record<string, unknown>;
+  if (m.role !== "assistant") return 0;
+  const content = m.content;
+  if (!Array.isArray(content)) return 0;
+
+  let total = 0;
+  for (const block of content) {
+    if (!block || typeof block !== "object") continue;
+    const b = block as Record<string, unknown>;
+    const type = b.type;
+    if (type === "text" && typeof b.text === "string") {
+      total += estimateTokens(b.text);
+    } else if (type === "thinking" && typeof b.thinking === "string") {
+      total += estimateTokens(b.thinking);
+    } else if (type === "tool_use" || type === "toolcall") {
+      // Count tool name + serialized arguments as model output.
+      const name = typeof b.name === "string" ? b.name : "";
+      const input = b.input ?? b.arguments;
+      let inputStr: string;
+      try {
+        inputStr = typeof input === "string" ? input : JSON.stringify(input ?? "");
+      } catch {
+        inputStr = "";
+      }
+      total += estimateTokens(name) + estimateTokens(inputStr);
+    }
+  }
+  return total;
+}
+
 /**
  * Tracks per-message TPS and computes live/session metrics.
  *
- * Usage: Call `onMessageUpdate()` whenever output tokens change.
- * The tracker records generation start/stop per message and computes
- * live TPS from the current message and session averages excluding idle time.
+ * Usage: Call `onMessageUpdate()` on every tick (e.g. 1s interval) with the
+ * current assistant message state. The tracker records generation start/stop
+ * per message and computes live TPS from elapsed wall-clock time.
  */
 export class TpsTracker {
-  /** Per-message records */
+  /** Per-message records (one per assistant message, in order) */
   private records: MessageTpsRecord[] = [];
 
-  /** Highest message index seen so far (for dedup) */
-  private lastSeenMessageCount = 0;
-
-  /** Total output tokens across all completed messages */
+  /** Total estimated output tokens across all messages */
   private totalOutput = 0;
 
   /**
@@ -42,15 +117,16 @@ export class TpsTracker {
    * Call this on every tick (e.g. 1s interval) with the current state.
    *
    * @param messageIndex - Index of the assistant message (0-based, sequential)
-   * @param outputTokens - Output tokens for this message
+   * @param message - The assistant message object (content used to count tokens)
    * @param hasStopReason - Whether this message has completed (has stopReason)
    */
-  onMessageUpdate(messageIndex: number, outputTokens: number, hasStopReason: boolean): void {
+  onMessageUpdate(messageIndex: number, message: unknown, hasStopReason: boolean): void {
     const now = Date.now();
+    const outputTokens = estimateOutputTokens(message);
 
     // New message — create a record
     if (messageIndex >= this.records.length) {
-      // Fill gaps if indices jump
+      // Fill gaps if indices jump (shouldn't normally happen)
       while (this.records.length < messageIndex) {
         this.records.push({
           messageIndex: this.records.length,
@@ -62,11 +138,12 @@ export class TpsTracker {
       }
 
       if (hasStopReason && outputTokens > 0) {
-        // Fast message: already completed on first sighting
-        // Estimate duration: floor of 1 second, or outputTokens/100, whichever is smaller
-        const estimatedDuration = Math.max(1, outputTokens / 100);
+        // Fast message: already completed on first sighting.
+        // We never observed it streaming, so we can't measure real duration.
+        // Fall back to a conservative estimate instead of inventing a 1s
+        // window (which previously produced inflated TPS values).
+        const estimatedDuration = Math.max(0.5, outputTokens / 60);
         const tps = outputTokens / estimatedDuration;
-
         this.records.push({
           messageIndex,
           outputTokens,
@@ -85,7 +162,6 @@ export class TpsTracker {
           tps: 0,
         });
       }
-      this.lastSeenMessageCount = messageIndex + 1;
       return;
     }
 
@@ -93,23 +169,24 @@ export class TpsTracker {
     const record = this.records[messageIndex];
     if (!record) return;
 
-    record.outputTokens = outputTokens;
+    if (record.completedAt === 0) {
+      // Still generating — update token count (live TPS computed on demand)
+      record.outputTokens = outputTokens;
 
-    if (record.completedAt === 0 && hasStopReason) {
-      // Message just completed
-      record.completedAt = now;
-      const durationSec = (record.completedAt - record.startedAt) / 1000;
-      record.tps = durationSec > 0 ? outputTokens / durationSec : outputTokens;
-      this.totalOutput += outputTokens;
-    } else if (record.completedAt === 0) {
-      // Still generating — update output tokens (live TPS computed on demand)
+      if (hasStopReason) {
+        // Message just completed
+        record.completedAt = now;
+        const durationSec = (record.completedAt - record.startedAt) / 1000;
+        record.tps = durationSec > 0 ? record.outputTokens / durationSec : 0;
+        this.totalOutput += record.outputTokens;
+      }
     }
   }
 
   /**
    * Get the live TPS from the currently generating message.
    * Returns the instantaneous rate based on tokens generated so far
-   * in the current message divided by elapsed time.
+   * in the current message divided by elapsed wall-clock time.
    */
   getLiveTps(): number {
     // Find the last record that's still generating
@@ -177,7 +254,7 @@ export class TpsTracker {
   }
 
   /**
-   * Get total output tokens for the session.
+   * Get total output tokens for the session (estimated).
    */
   getTotalOutput(): number {
     // Include tokens from incomplete messages too
@@ -195,7 +272,6 @@ export class TpsTracker {
    */
   reset(): void {
     this.records = [];
-    this.lastSeenMessageCount = 0;
     this.totalOutput = 0;
   }
 }

package/packages/info-screen/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.1.0",
-  "description": "Dashboard and module registry for Unipi \u2014 configurable info overlay with tabbed groups",
+  "version": "2.1.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.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

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

@@ -94,15 +94,24 @@ export class InfoOverlay implements Component {
 
   /**
    * Fetch all groups in background. Each resolves independently.
+   *
+   * Each fetch is deferred to a macrotask (setTimeout 0) so the constructor
+   * returns immediately. Without this, getGroupData() runs each group's
+   * dataProvider synchronously up to its first `await` before yielding —
+   * heavy providers (usage stats parse 1GB+ of session files, memory scans)
+   * blocked the session_start handler for seconds.
    */
-  private async fetchAllBackground(): Promise<void> {
+  private fetchAllBackground(): void {
     for (const group of this.groups) {
-      // Fire each fetch independently — don't await sequentially
-      infoRegistry.getGroupData(group.id).then(() => {
-        this.groupLoading.set(group.id, false);
-      }).catch(() => {
-        this.groupLoading.set(group.id, false);
-      });
+      // Defer each fetch to a macrotask so the overlay constructs instantly.
+      setTimeout(() => {
+        if (this._destroyed) return;
+        infoRegistry.getGroupData(group.id).then(() => {
+          this.groupLoading.set(group.id, false);
+        }).catch(() => {
+          this.groupLoading.set(group.id, false);
+        });
+      }, 0);
     }
   }
 

package/packages/input-shortcuts/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.1.0",
-  "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle \u2014 chord-based overlay system",
+  "version": "2.1.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.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/kanboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.1.0",
-  "description": "Visualization layer for unipi workflow \u2014 HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
+  "version": "2.1.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.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.1.0",
-  "description": "MCP server management extension for Pi coding agent \u2014 browse, add, configure, and use MCP servers",
+  "version": "2.1.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",
@@ -27,7 +27,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/memory/mempalace.ts

@@ -22,6 +22,10 @@ export const DEFAULT_PALACE = path.join(os.homedir(), ".mempalace", "palace");
 
 const INSTALL_FLAG = path.join(os.homedir(), ".unipi", "memory", ".mempalace-install");
 const MIGRATED_FLAG = path.join(os.homedir(), ".unipi", "memory", ".mempalace-migrated");
+/** Flag written after a successful ping, so subsequent sessions can skip
+ *  the ~0.5s Python cold-start sanity check. Stale after PING_VERIFIED_TTL_MS. */
+const PING_VERIFIED_FLAG = path.join(os.homedir(), ".unipi", "memory", ".mempalace-ping-verified");
+const PING_VERIFIED_TTL_MS = 24 * 60 * 60 * 1000; // 24h
 
 /** Path to the bundled bridge script. */
 const BRIDGE_PATH = path.join(dirname(fileURLToPath(import.meta.url)), "bridge", "mempalace_bridge.py");
@@ -166,6 +170,30 @@ export function ensureMempalace(): MempalaceInstall | null {
 /** Drop the cached install record (forces re-detection next session). */
 export function invalidateInstallCache(): void {
   try { if (fs.existsSync(INSTALL_FLAG)) fs.unlinkSync(INSTALL_FLAG); } catch { /* ignore */ }
+  invalidatePingVerified();
+}
+
+/** Was the palace ping-verified recently enough to trust without re-pinging? */
+export function isPingVerified(): boolean {
+  try {
+    if (!fs.existsSync(PING_VERIFIED_FLAG)) return false;
+    const ts = Number.parseInt(fs.readFileSync(PING_VERIFIED_FLAG, "utf-8").trim(), 10);
+    if (!Number.isFinite(ts)) return false;
+    return Date.now() - ts < PING_VERIFIED_TTL_MS;
+  } catch { return false; }
+}
+
+/** Mark the palace as ping-verified (written after a successful ping). */
+export function markPingVerified(): void {
+  try {
+    fs.mkdirSync(path.dirname(PING_VERIFIED_FLAG), { recursive: true });
+    fs.writeFileSync(PING_VERIFIED_FLAG, String(Date.now()), "utf-8");
+  } catch { /* ignore */ }
+}
+
+/** Drop the ping-verified flag (forces a real ping next session). */
+export function invalidatePingVerified(): void {
+  try { if (fs.existsSync(PING_VERIFIED_FLAG)) fs.unlinkSync(PING_VERIFIED_FLAG); } catch { /* ignore */ }
 }
 
 /** Has the one-way legacy migration been completed? */

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -43,8 +43,8 @@
     "better-sqlite3": "^12.9.0",
     "sqlite-vec": "^0.1.9",
     "js-yaml": "^4.1.0",
-    "@pi-unipi/core": "2.1.0",
-    "@pi-unipi/info-screen": "2.1.0"
+    "@pi-unipi/core": "2.1.2",
+    "@pi-unipi/info-screen": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/memory/storage.ts

@@ -19,6 +19,9 @@ import {
   runBridge,
   isMigrated,
   markMigrated,
+  isPingVerified,
+  markPingVerified,
+  invalidatePingVerified,
   DEFAULT_PALACE,
   type MempalaceInstall,
   type MempalaceRecord,
@@ -262,6 +265,22 @@ export class MemoryStorage {
     return this.backend === "mempalace" && this.mempalaceInstall !== null;
   }
 
+  /**
+   * Run a MemPalace bridge command, invalidating the ping-verified flag
+   * when the call fails. This ensures a palace that breaks after the
+   * startup ping-skip gets re-verified on the next session.
+   */
+  private memPalaceCall<T>(cmd: string, args: Record<string, unknown> = {}): T | null {
+    const install = this.mempalaceInstall;
+    if (!install) return null;
+    const result = runBridge<T>(install, this.palacePath, cmd, args);
+    if (result === null) {
+      // Backend didn't respond — force a real ping next session.
+      invalidatePingVerified();
+    }
+    return result;
+  }
+
   /**
    * Initialize storage. Tries MemPalace first (auto-install + one-way
    * auto-migration of legacy memories); falls back to SQLite if MemPalace
@@ -325,8 +344,14 @@ export class MemoryStorage {
     if (!install) return false;
 
     // Sanity ping — if the palace/bridge is broken, fall back.
-    const ok = runBridge<string>(install, this.palacePath, "ping");
-    if (ok !== "pong") return false;
+    // Skip the ~0.5s Python cold-start when we ping-verified recently;
+    // the flag is invalidated on any backend failure so a broken palace
+    // is re-checked on the next session.
+    if (!isPingVerified()) {
+      const ok = runBridge<string>(install, this.palacePath, "ping");
+      if (ok !== "pong") return false;
+      markPingVerified();
+    }
 
     this.mempalaceInstall = install;
     this.backend = "mempalace";
@@ -539,8 +564,7 @@ export class MemoryStorage {
    * consistent and durable as a fallback source.
    */
   private storeMempalace(record: MemoryRecord): void {
-    const install = this.mempalaceInstall!;
-    runBridge(install, this.palacePath, "store", {
+    this.memPalaceCall("store", {
       record: {
         id: record.id,
         title: record.title,
@@ -572,8 +596,7 @@ export class MemoryStorage {
    */
   syncOrphanedFiles(): number {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const synced = runBridge<number>(install, this.palacePath, "sync_orphaned", {
+      const synced = this.memPalaceCall<number>("sync_orphaned", {
         project_dir: this.scopeDir,
         wing: this.projectName,
       });
@@ -636,8 +659,7 @@ export class MemoryStorage {
    */
   hasByTitle(title: string): boolean {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      return runBridge<boolean>(install, this.palacePath, "has_title", {
+      return this.memPalaceCall<boolean>("has_title", {
         wing: this.projectName,
         title,
       }) ?? false;
@@ -654,9 +676,8 @@ export class MemoryStorage {
    */
   findSimilarByTitle(title: string, threshold = 0.6): Array<{ record: MemoryRecord; similarity: number }> {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const rows = runBridge<Array<{ record: MempalaceRecord; similarity: number }>>(
-        install, this.palacePath, "find_similar",
+      const rows = this.memPalaceCall<Array<{ record: MempalaceRecord; similarity: number }>>(
+        "find_similar",
         { wing: this.projectName, title, threshold },
       ) ?? [];
       return rows.map((r) => ({ record: toMemoryRecord(r.record), similarity: r.similarity }));
@@ -694,8 +715,7 @@ export class MemoryStorage {
    */
   getById(id: string): MemoryRecord | null {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const rec = runBridge<MempalaceRecord | null>(install, this.palacePath, "get", { id });
+      const rec = this.memPalaceCall<MempalaceRecord | null>("get", { id });
       return rec ? toMemoryRecord(rec) : null;
     }
     if (!this.db) throw new Error("Storage not initialized");
@@ -721,8 +741,7 @@ export class MemoryStorage {
    */
   getByTitle(title: string): MemoryRecord | null {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const rec = runBridge<MempalaceRecord | null>(install, this.palacePath, "get_by_title", {
+      const rec = this.memPalaceCall<MempalaceRecord | null>("get_by_title", {
         wing: this.projectName,
         title,
       });
@@ -768,8 +787,7 @@ export class MemoryStorage {
    */
   listAll(): Array<{ id: string; title: string; type: string }> {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const items = runBridge<MempalaceListItem[]>(install, this.palacePath, "list", {
+      const items = this.memPalaceCall<MempalaceListItem[]>("list", {
         wing: this.projectName,
       }) ?? [];
       return items;
@@ -785,8 +803,7 @@ export class MemoryStorage {
    */
   delete(id: string): boolean {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const ok = runBridge<boolean>(install, this.palacePath, "delete", { id }) ?? false;
+      const ok = this.memPalaceCall<boolean>("delete", { id }) ?? false;
       // Also remove the markdown tier if present.
       try {
         const mdPath = path.join(this.scopeDir, `${id}.md`);
@@ -833,8 +850,7 @@ export class MemoryStorage {
    */
   search(query: string, limit = 10, embedding?: Float32Array | null): SearchResult[] {
     if (this.isMempalace()) {
-      const install = this.mempalaceInstall!;
-      const rows = runBridge<MempalaceSearchResult[]>(install, this.palacePath, "search", {
+      const rows = this.memPalaceCall<MempalaceSearchResult[]>("search", {
         query,
         wing: this.projectName,
         limit,

package/packages/milestone/package.json

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

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -27,8 +27,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0",
-    "@pi-unipi/info-screen": "2.1.0"
+    "@pi-unipi/core": "2.1.2",
+    "@pi-unipi/info-screen": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.80.0",

package/packages/subagents/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.1.0",
-  "description": "Subagents for UniPi \u2014 parallel execution, file locking, workflow integration",
+  "version": "2.1.2",
+  "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,9 +17,9 @@
     "test": "node --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0",
-    "@pi-unipi/workflow": "2.1.0",
-    "@pi-unipi/info-screen": "2.1.0",
+    "@pi-unipi/core": "2.1.2",
+    "@pi-unipi/workflow": "2.1.2",
+    "@pi-unipi/info-screen": "2.1.2",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "devDependencies": {

package/packages/subagents/src/index.ts

@@ -12,7 +12,7 @@ import { Type } from "typebox";
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
-import { emitEvent, MODULES, UNIPI_EVENTS, type UnipiBadgeGenerateRequestEvent } from "@pi-unipi/core";
+import { emitEvent, MODULES, UNIPI_EVENTS, withHerdrBlocked, type UnipiBadgeGenerateRequestEvent } from "@pi-unipi/core";
 import { AgentManager } from "./agent-manager.js";
 import { initConfig } from "./config.js";
 import { type AgentActivity, type NotificationDetails, BUILTIN_TYPES } from "./types.js";
@@ -758,28 +758,32 @@ Guidelines:
         // Open conversation viewer overlay if requested
         if (params.view && record.session) {
           const activity = agentActivity.get(record.id);
-          await ctx.ui.custom<undefined>(
-            (tui, theme, _keybindings, done) => {
-              return new ConversationViewer(
-                tui,
-                record.session!,
-                {
-                  type: record.type,
-                  description: record.description,
-                  status: record.status,
-                  toolUses: record.toolUses,
-                  startedAt: record.startedAt,
-                  completedAt: record.completedAt,
-                },
-                activity,
-                theme,
-                done,
-              );
-            },
-            {
-              overlay: true,
-              overlayOptions: { anchor: "center", width: "90%" },
-            },
+          await withHerdrBlocked(
+            pi,
+            "helper viewer",
+            () => ctx.ui.custom<undefined>(
+              (tui, theme, _keybindings, done) => {
+                return new ConversationViewer(
+                  tui,
+                  record.session!,
+                  {
+                    type: record.type,
+                    description: record.description,
+                    status: record.status,
+                    toolUses: record.toolUses,
+                    startedAt: record.startedAt,
+                    completedAt: record.completedAt,
+                  },
+                  activity,
+                  theme,
+                  done,
+                );
+              },
+              {
+                overlay: true,
+                overlayOptions: { anchor: "center", width: "90%" },
+              },
+            ),
           );
         }
 

package/packages/updater/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "2.1.0",
-  "description": "Auto-updater, changelog browser, and readme browser for Unipi \u2014 checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
+  "version": "2.1.2",
+  "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/utility/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/utility",
-  "version": "2.1.0",
-  "description": "Utility commands and tools for Pi coding agent \u2014 lifecycle, diagnostics, cache, analytics, display, batch execution",
+  "version": "2.1.2",
+  "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0",
+    "@pi-unipi/core": "2.1.2",
     "diff": "^7.0.0",
     "@shikijs/cli": "^4.0.2"
   },

package/packages/web-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/web-api",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Web search, read, and summarize tools with provider-based backend selection for Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.1.0",
+    "@pi-unipi/core": "2.1.2",
     "defuddle": "^0.18.1",
     "linkedom": "^0.18.12",
     "lodash": "^4.17.21",

package/packages/workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/workflow",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Structured development workflow commands for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.0"
+    "@pi-unipi/core": "2.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.80.0",