@pi-unipi/unipi 3.0.0-alpha.24 → 3.0.0-alpha.26

package/CHANGELOG.md

@@ -6,6 +6,46 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.26] — 2026-10-04
+
+### Fixed
+- `fusion`: the "Non-trivial shell work since last handoff" nudge fires at most once per agent run instead of repeating on every 4th non-trivial shell command; a sidekick handoff still resets the streak but no longer re-arms the nudge, and a new prompt arms it again. (UNI-87)
+- `long-horizon`: mode-control tools are now truly OFF in pi's active tool set outside their mode (previously registered/active and only hidden from the provider payload), so pi's tool snippets and other modules no longer see them. Fresh and resumed sessions start with them off; resolving into a mode (command, judge, or active owner) turns that mode's tools on. (UNI-90)
+- `info-screen`: scope order now reads biggest first — footer legend `g global  p project  s session`, Compactor savings tiles global → project → session, Memory tiles global → project → share.
+- `info-screen`: Skills page tags each source with its real scope (`g` for user/agents/unipi/package skills, `p` for project skills) instead of implying session scope; the Tools page's tool list is tagged `s` (the active set is per session).
+- `info-screen`: Usage page leaves one blank line between the model share bar and the ranked model rows.
+
+## [3.0.0-alpha.25] — 2026-10-04
+
+### Added
+- `info-screen`: **Unicrab splash** at startup — the existing Unicrab half-block art, a shimmering block wordmark with version chip, greeting, how fast Pi got ready, and live facts (resumed session totals or cwd/branch, today's spend from the cached snapshot, update available), with a draining countdown edge. Non-capturing and stack-safe in `auto-close` mode. Replaces the boot-time dashboard; the hints start-screen header is unchanged. (UNI-78)
+- `info-screen`: redesigned **`/unipi:info`** dashboard — opaque panel coloured per page, pill tab strip, fixed body height, page dots, `1`–`9` jump, `/unipi:info <page>`. Pages draw themselves with a new Unicode toolkit, no emoji. (UNI-79)
+  - **This session** (first page): cost / tokens / replies / time in 3-row gradient digits, context meter, token mix + cache hit, tokens-per-reply braille chart, ranked tools with failures, directory/branch/files/compactions. (UNI-80)
+  - **Usage**: today / week / month spend, 30-day column chart with Monday ticks, model share bar + ranked models. (UNI-81)
+  - **Tools / Skills / Modules**: live from pi (`getAllTools`, `getCommands`), source share bars, column grids, active vs. off; modules with versions and measured load time. (UNI-82)
+  - **MCP, Compactor, Updates, Web, Memory, Keys**: status dots, compaction before→after bars, version track, provider × capability matrix, memory types, keycaps. (UNI-83)
+- `core`: `viz` kit (`Paint`, `bigText`, `gradient`, `spark`, `columns`, `brailleArea`, `gauge`, `shareBar`, `chip`, `grid`, …) — every piece returns exact-width lines in truecolor or 256-colour. (UNI-77)
+- `scripts/info-preview`: print the splash and every page at any width without Pi.
+- `info-screen`: **scope tags** `s` session / `p` project / `g` global on every scoped number (legend in the footer); project pages (memory, mcp, compactor) are cached per workspace, so one project's numbers never show in another. MCP servers show whether they come from global or project config. (UNI-91)
+- `info-screen` / `core`: **compaction savings** — tokens not re-sent (saved × replies after each compaction) and ≈ money not spent at the context rate actually paid, for the session, the project and all projects (`core/src/compaction-savings.ts`; the usage parser collects it per session file). Compactor page: savings tiles, without-vs-with bars, per-compaction timeline. (UNI-92)
+- `core`: 37 new Unicrab hints (127 in total). Catch-up tips for what shipped since the hints release — `/unipi:summarize`, `/unipi:info`, `/unipi:regular`, `Ctrl+O` in simple mode, **E**/**M** in `/unipi:skills`, the splash setting, the `s`/`p`/`g` tags — and 8 "what's new" tips tied to alpha.22–alpha.25 (shown once after you update). Eight new lore lines.
+- `core`: **moment hints** — Unicrab reacts once a session to a late-night turn, 50 clean tool calls in a row, an `rm -rf`, a force push, a 40k+ character write, a ≥95% cache-hit reply, a finished goal, a deleted memory, new MCP tools and a ralph lap. The hint-count test is gone; only the "every named command exists" check stays.
+- `long-horizon`: the owner-changed event now carries `reason` when an owner finishes.
+- `info-screen`: **context breakdown** on This session — a bucket split into system prompt, tool schemas, your prompts, replies, tool results and summaries (from what pi will send next), window gauge on its edge, heaviest tool outputs. (UNI-93)
+
+### Changed
+- `info-screen`: Usage chart labels its peak and today over the bars with a real date axis; one model → one line; model bars are true shares. (UNI-94)
+- `info-screen`: Modules page shows what each module adds (tools, commands, settings, keys — recorded exactly by `packages/unipi` during load) instead of millisecond bars; load time is flagged only past 20 ms. (UNI-95)
+- harness: prompts that UniPi sends for you (`/unipi:goal`/`ralph`/`swarm`/`graph` kickoffs, `/unipi:summarize`, `/unipi:answer`, the compactor follow-up, the ask-user handoff) render as a UniPi harness panel instead of a plain user message. The skills reveal names the skills in simple mode and lists them in advanced mode. (UNI-88, UNI-89)
+- `info-screen`: `bootMode` / `bootTimeoutMs` now control the splash (default 2.5 s). `groupOrder` and per-page show/hide are honoured and re-read when the dashboard opens. Duplicate tab priorities fixed by one page-style table.
+
+### Docs
+- README: new **See your session** section with screenshots of the splash and the dashboard (demo data), a **What's new** table for the recent releases, and two new rows in "Why UniPi". The Info Screen README explains the context bucket and how compaction savings are counted.
+- `scripts/info-preview/demo.ts`: demo session and history for screenshots — no real paths or spend.
+
+### Performance
+- `info-screen`: page data is saved to `~/.unipi/cache/info-screen.json`, so the dashboard opens filled; page bodies are memoised; the session page walks the transcript once per new entry. Usage refresh on a 1,500-session history went from ~190 ms to ~35 ms warm (in-memory parser cache, debounced cache writes, no per-record string keys). (UNI-84)
+
 ## [3.0.0-alpha.24] — 2026-10-04
 
 ### Added

package/README.md

@@ -64,6 +64,8 @@ runs commands. UniPi adds the parts that a long session needs.
 | **A board for deferred work** | Kanboard keeps tasks in Markdown files, with a web UI and a terminal UI. |
 | **Hang detection** | Watchdog asks a small judge model about long tool calls. |
 | **A short transcript** | Simple mode shows one line for each tool call. Ctrl+O expands it. |
+| **A view of the session** | `/unipi:info` shows cost, context use, spend history and what compaction saved. |
+| **A recap at the end** | The `summarize` skill gives the answer first, then open items, in plain words. |
 
 ## Proof
 
@@ -118,6 +120,61 @@ review or answer a blocked question in one click.
 
 The screenshots use demo data. Read the [Kanboard README](packages/kanboard/README.md).
 
+## See your session: `/unipi:info`
+
+Pi starts. Unicrab says hello and gives you three facts: how fast Pi got
+ready, the session you came back to, and what you spent today. Then it goes
+away. It does not take your keys, so you can type your first prompt at once.
+
+<p align="center">
+  <img src="docs/assets/screenshots/info-splash.png" width="760" alt="The Unicrab startup splash: mascot, UNIPI wordmark, version, ready time, resumed session and today's spend">
+</p>
+
+Run `/unipi:info` when you want the full picture. The first page is about
+**this session**. It answers the questions you ask during long work:
+
+- **What did this cost?** Cost, tokens, replies and time, in large digits.
+- **What fills my context?** A bucket shows each part in its own colour:
+  system prompt, tool schemas, summaries, your prompts, replies and tool
+  results. The edge of the bucket shows how full the window is. It turns
+  amber at 70% and red at 90%.
+- **Which tool output is the heaviest?** The page names the three largest.
+- **Which tools failed?** Each tool gets a bar, and failures show in red.
+
+<p align="center">
+  <img src="docs/assets/screenshots/info-session.png" alt="The This session page: cost, tokens, replies, time, the context bucket, billed tokens and tools">
+</p>
+
+The other pages answer the questions that come later:
+
+| Page | It shows |
+|---|---|
+| Usage | Spend today, this week and this month, a 30-day chart, and the share of each model. |
+| Compactor | Tokens that compaction kept out of your requests, and the money that saved. |
+| Tools · Skills · Modules | What Pi loaded, where it came from, and what each UniPi module adds. |
+| MCP · Memory · Web · Updates · Keys | The state of each module. |
+
+<table>
+  <tr>
+    <td><img src="docs/assets/screenshots/info-usage.png" alt="The Usage page: spend tiles, a 30-day chart with the peak labelled, and models this month"></td>
+    <td><img src="docs/assets/screenshots/info-compactor.png" alt="The Compactor page: money saved for this session, this project and all projects, and a without-versus-with bar"></td>
+  </tr>
+</table>
+
+A small letter before a number tells you its scope: **`s`** is this session,
+**`p`** is this project and **`g`** is every project on this machine. Numbers
+from one project never show in another.
+
+How the Compactor page counts: each compaction makes the context smaller.
+Every reply after it sends that smaller context. The page multiplies the
+tokens removed by the number of replies that followed. Then it prices them at
+the rate you paid for context. A free model saves tokens but no money.
+
+Keys: `←`/`→` or `1`–`9` change the page, `r` refreshes it, `q` closes it.
+`/unipi:info usage` opens one page. The dashboard opens at once on cached
+numbers, then updates them in the background. The screenshots use demo data.
+Read the [Info Screen README](packages/info-screen/README.md).
+
 ## Harness architecture
 
 UniPi adds these mechanisms to the Pi harness. Each page gives the problem, a
@@ -167,7 +224,9 @@ each package.
 
 Unicrab is the UniPi mascot. It started as the author's pet crab. Now it says
 hello when Pi starts and leaves hints above the input box. Press `Alt+H` for the
-next hint.
+next hint, or run `/unipi:hint` to read all 127 of them.
+
+After an update, the first hint tells you what is new in that release.
 
 Read [The making of Unicrab](docs/story/unicrab.md): from a real crab, to pixel
 art, to a terminal character that is 7 columns wide.
@@ -176,6 +235,17 @@ art, to a terminal character that is 7 columns wide.
   <img src="docs/assets/screenshots/unicrab-start.png" alt="The UniPi start screen with Unicrab in half-block pixel art">
 </p>
 
+## What's new
+
+The recent releases, in short. The [changelog](CHANGELOG.md) has the details.
+
+| Release | What changed for you |
+|---|---|
+| alpha.25 | The Unicrab splash at startup. A new `/unipi:info`: this session, the context bucket, compaction savings and `s`/`p`/`g` scope tags. Prompts that UniPi sends for you (goal, summarize, answer) show as a UniPi panel, not as your own message. |
+| alpha.24 | The `summarize` skill and `/unipi:summarize [focus]`. Long work ends with a short recap: the answer first, then findings, open items and questions. |
+| alpha.23 | `/unipi:settings` explains each setting and each option in a panel below the list. Web tools with no working provider hide from the agent. |
+| alpha.22 | Simple mode is the default. Each tool call is one line, and `Ctrl+O` opens it. Images no longer overlap the text below them. |
+
 ## Docs
 
 - [Getting started](docs/guide/getting-started.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.24",
+  "version": "3.0.0-alpha.26",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -44,6 +44,7 @@
     "packages/*/bridge/**/*.py",
     "packages/*/platforms/*",
     "packages/*/tui/*",
+    "packages/*/pages/*.ts",
     "packages/*/SKILL.md",
     "packages/*/skills/**/*",
     "packages/*/README.md",
@@ -82,26 +83,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.24",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.24",
-    "@pi-unipi/btw": "3.0.0-alpha.24",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.24",
-    "@pi-unipi/compactor": "3.0.0-alpha.24",
-    "@pi-unipi/core": "3.0.0-alpha.24",
-    "@pi-unipi/footer": "3.0.0-alpha.24",
-    "@pi-unipi/fusion": "3.0.0-alpha.24",
-    "@pi-unipi/info-screen": "3.0.0-alpha.24",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.24",
-    "@pi-unipi/kanboard": "3.0.0-alpha.24",
-    "@pi-unipi/mcp": "3.0.0-alpha.24",
-    "@pi-unipi/memory": "3.0.0-alpha.24",
-    "@pi-unipi/notify": "3.0.0-alpha.24",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.24",
-    "@pi-unipi/subagents": "3.0.0-alpha.24",
-    "@pi-unipi/updater": "3.0.0-alpha.24",
-    "@pi-unipi/utility": "3.0.0-alpha.24",
-    "@pi-unipi/web-api": "3.0.0-alpha.24",
-    "@pi-unipi/workflow": "3.0.0-alpha.24"
+    "@pi-unipi/ask-user": "3.0.0-alpha.26",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.26",
+    "@pi-unipi/btw": "3.0.0-alpha.26",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.26",
+    "@pi-unipi/compactor": "3.0.0-alpha.26",
+    "@pi-unipi/core": "3.0.0-alpha.26",
+    "@pi-unipi/footer": "3.0.0-alpha.26",
+    "@pi-unipi/fusion": "3.0.0-alpha.26",
+    "@pi-unipi/info-screen": "3.0.0-alpha.26",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.26",
+    "@pi-unipi/kanboard": "3.0.0-alpha.26",
+    "@pi-unipi/mcp": "3.0.0-alpha.26",
+    "@pi-unipi/memory": "3.0.0-alpha.26",
+    "@pi-unipi/notify": "3.0.0-alpha.26",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.26",
+    "@pi-unipi/subagents": "3.0.0-alpha.26",
+    "@pi-unipi/updater": "3.0.0-alpha.26",
+    "@pi-unipi/utility": "3.0.0-alpha.26",
+    "@pi-unipi/web-api": "3.0.0-alpha.26",
+    "@pi-unipi/workflow": "3.0.0-alpha.26"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/handoff.ts

@@ -5,6 +5,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { sendHarnessUserMessage } from "@pi-unipi/core";
 import type { SessionLaunchReason, SessionLaunchStatus } from "./types.js";
 
 /** Compact handoff fallback timer. Keeps the launcher from stalling if callbacks wait for the tool turn to finish. */
@@ -80,7 +81,7 @@ function deliverFollowUpMessage(
   reason: SessionLaunchReason,
 ): HandoffResult {
   try {
-    pi.sendUserMessage(prefill, { deliverAs: "followUp" });
+    sendHarnessUserMessage(pi, prefill, { source: "Ask user", title: "Handoff", synopsis: "Prefill from the launcher" }, { deliverAs: "followUp" });
     return { status: "queued", reason, prefill };
   } catch (error) {
     return fallbackToEditor(ctx, prefill, reason, error);

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.24",
+  "version": "3.0.0-alpha.26",
   "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": "3.0.0-alpha.24"
+    "@pi-unipi/core": "3.0.0-alpha.26"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

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

package/packages/autocomplete/src/constants.ts

@@ -171,7 +171,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
 
   "unipi:settings": "Configure all unipi modules in one panel",
 
-  "unipi:info":          "Show system information",
+  "unipi:info":          "Dashboard — this session, context, usage, compaction savings, modules",
   "unipi:hint":          "Browse and search Unicrab hints, or cycle/reset",
 
 

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.24",
+  "version": "3.0.0-alpha.26",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/core": "3.0.0-alpha.26",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.24",
+  "version": "3.0.0-alpha.26",
   "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.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.24"
+    "@pi-unipi/core": "3.0.0-alpha.26"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.24",
+  "version": "3.0.0-alpha.26",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.24",
-    "@pi-unipi/info-screen": "3.0.0-alpha.24",
+    "@pi-unipi/core": "3.0.0-alpha.26",
+    "@pi-unipi/info-screen": "3.0.0-alpha.26",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/compactor/src/compaction/hooks.ts

@@ -14,7 +14,7 @@
 
 import type { ExtensionAPI, ExtensionContext, SessionBeforeCompactEvent, SessionCompactEvent } from "@earendil-works/pi-coding-agent";
 import { compact as piCompact, generateSummaryWithUsage, DEFAULT_COMPACTION_SETTINGS } from "@earendil-works/pi-coding-agent";
-import { collectCompactionContext, emitEvent, formatTokens, UNIPI_EVENTS } from "@pi-unipi/core";
+import { collectCompactionContext, emitEvent, formatTokens, sendHarnessUserMessage, UNIPI_EVENTS } from "@pi-unipi/core";
 import { loadConfig } from "../config/manager.js";
 import { autoCompactionOf } from "../config/schema.js";
 import { buildOwnCut, resolveSmartKeepUserTurns, applyTailBudget, MAX_SMART_TAIL_TOKENS } from "./cut.js";
@@ -444,7 +444,7 @@ export function registerCompactionHooks(pi: ExtensionAPI, deps: CompactionHookDe
     if (followUp) {
       setTimeout(() => {
         try {
-          pi.sendUserMessage(followUp, { deliverAs: "followUp" });
+          sendHarnessUserMessage(pi, followUp, { source: "Compactor", title: "Follow-up", synopsis: "Prompt queued after compaction" }, { deliverAs: "followUp" });
         } catch {}
       }, 0);
     }

package/packages/compactor/src/info-screen.ts

@@ -3,17 +3,33 @@
  * compactions, read from the session branch.
  */
 
-import { formatTokens } from "@pi-unipi/core";
+import { compactionSavings, formatTokens, type CompactionSaving, type SavingsTotals } from "@pi-unipi/core";
 import { loadConfig } from "./config/manager.js";
 import { methodBreakdown, sessionCompactionStats } from "./stats.js";
 
-type Stat = { value: string; detail: string };
+type Stat = { value: string; detail: string; raw?: unknown };
+
+/** Structured payload for the info-screen Compactor page renderer. */
+export interface CompactorPageRaw {
+  method: string;
+  trigger: string;
+  piCompact: string;
+  history: Array<{ before: number; after: number; method: string; at?: number }>;
+  before: number;
+  after: number;
+  saved: number;
+  /** This session's savings (tokens not re-sent + money). */
+  session: SavingsTotals;
+  /** Per-compaction savings for the timeline. */
+  items: CompactionSaving[];
+}
 
 export interface CompactorInfoData {
   settings: Stat;
   compactions: Stat;
   tokens: Stat;
   last: Stat;
+  raw: Stat;
 }
 
 const METHOD_NAME = { vcc: "lossless", llm: "model summary" } as const;
@@ -32,7 +48,21 @@ export function getInfoScreenData(branch: readonly any[], cwd: string = process.
   const count = stats.compactions.length;
   const last = stats.compactions[count - 1];
   const pct = stats.tokensBefore > 0 ? Math.round((stats.tokensSaved / stats.tokensBefore) * 100) : 0;
+  const raw: CompactorPageRaw = {
+    method: METHOD_NAME[config.method],
+    trigger: config.trigger === "pi" ? "at Pi's context limit" : `at ${config.thresholdPercent}% of context`,
+    piCompact: config.piCompact === "follow" ? "same as method" : METHOD_NAME[config.piCompact],
+    history: stats.compactions.slice(-24).map((c) => ({ before: c.tokensBefore, after: c.tokensAfter, method: METHOD_NAME[c.method] ?? c.method, at: c.at })),
+    before: stats.tokensBefore,
+    after: stats.tokensAfter,
+    saved: stats.tokensSaved,
+    ...(() => {
+      const s = compactionSavings(branch);
+      return { session: s.totals, items: s.items.slice(-24) };
+    })(),
+  };
   return {
+    raw: { value: "", detail: "", raw },
     settings: {
       value: METHOD_NAME[config.method],
       detail: `when: ${config.trigger === "pi" ? "Pi's context limit" : `${config.thresholdPercent}% of context`} · Pi's /compact: ${config.piCompact === "follow" ? "same as method" : METHOD_NAME[config.piCompact]}`,

package/packages/core/README.md

@@ -70,7 +70,13 @@ Unicrab is the UniPi mascot. The hints engine shows one short tip above the
 editor.
 
 - At startup, the engine shows the tip with the lowest show count. After a
-  version upgrade, it shows a "what's new" tip first.
+  version upgrade, it shows a "what's new" tip first. Each release adds its
+  own "what's new" tips, so you learn about a feature when it arrives.
+- The engine has 127 tips in 9 categories: commands, shortcuts, settings,
+  capabilities, explanations, troubleshooting, what's new, workflows and lore.
+- Some tips react to a moment, one time per session. Examples are a late-night
+  turn, 50 tool calls with no error, an `rm -rf`, a force push, a hot prompt
+  cache and a finished goal.
 - The start screen shows the Unicrab pixel art, the version and a random lore
   line. It needs 40 columns or more. At 72 columns or more, it shows the large crab.
 - Some events show a tip. Examples are context use of 70% or more, a `bash`

package/packages/core/harness-messages.ts

@@ -31,7 +31,7 @@
  * boundaries purge everything outstanding — the failure mode is always native
  * fallback, never a human message mislabelled.
  */
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { parseSkillBlock, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 export type HarnessDelivery =
   | "direct"
@@ -47,6 +47,8 @@ export interface HarnessMessageMeta {
   source: string;
   title: string;
   synopsis?: string;
+  /** Optional pre-rendered summary rows (advanced style renders one row each). */
+  lines?: string[];
   delivery: HarnessDelivery;
   severity?: "warning";
 }
@@ -172,6 +174,10 @@ export function readHarnessMeta(source: unknown): HarnessMessageMeta | undefined
   ) {
     return undefined;
   }
+  // Optional summary lines: malformed ones are dropped, the meta stays valid.
+  if (m.lines !== undefined && !(Array.isArray(m.lines) && m.lines.every((l) => typeof l === "string"))) {
+    return { ...m, lines: undefined } as HarnessMessageMeta;
+  }
   return m as HarnessMessageMeta;
 }
 
@@ -185,6 +191,24 @@ export function userMessageText(content: unknown): string {
     .join("");
 }
 
+/** Match an admission record's text against a dispatched text. Exact by
+ * default; a `/skill:<name> <rest>` record additionally matches its
+ * POST-EXPANSION form — pi turns the command into a `<skill …>` block AFTER
+ * the input handlers ran (AgentSession._expandSkillCommand), so the
+ * before_agent_start prompt and the message user text no longer equal the
+ * armed text. Everything else stays exact; no match = native (fail closed). */
+function recordMatchesText(recordText: string, text: string): boolean {
+  if (recordText === text) return true;
+  if (!recordText.startsWith("/skill:")) return false;
+  const skill = parseSkillBlock(text);
+  if (!skill) return false;
+  // Mirror _expandSkillCommand's split: name up to the first space, rest trimmed.
+  const spaceIndex = recordText.indexOf(" ");
+  const name = spaceIndex === -1 ? recordText.slice(7) : recordText.slice(7, spaceIndex);
+  const rest = spaceIndex === -1 ? "" : recordText.slice(spaceIndex + 1).trim();
+  return skill.name === name && (skill.userMessage ?? "") === rest;
+}
+
 function userTextFromMessage(message: unknown): string {
   if (!message || typeof message !== "object") return "";
   const m = message as { role?: unknown; content?: unknown };
@@ -203,7 +227,7 @@ export function sendHarnessUserMessage(
   pi: ExtensionAPI,
   content: string,
   meta: HarnessMessageMetaInput,
-  options?: { deliverAs?: "steer" | "followUp" },
+  options?: { deliverAs?: "steer" | "followUp"; expandPromptTemplates?: boolean },
 ): ReturnType<ExtensionAPI["sendUserMessage"]> {
   let arm: Arm | undefined;
   try {
@@ -253,7 +277,7 @@ function prune(state: HarnessRegistryState): void {
  * matching group. */
 function selectRecord(state: HarnessRegistryState, text: string): HarnessMessageMeta | undefined {
   const candidates = state.records.filter(
-    (r) => r.state === "admitted" && r.text === text && (r.kind !== "harness" || r.eligible),
+    (r) => r.state === "admitted" && recordMatchesText(r.text, text) && (r.kind !== "harness" || r.eligible),
   );
   if (candidates.length === 0) return undefined;
   const origins = new Set(candidates.map((r) => r.origin));
@@ -336,7 +360,7 @@ export function installHarnessProvenance(pi: ExtensionAPI): void {
     // unconfirmed direct records are stale and dropped. Queued untouched.
     for (const r of state.records) {
       if (r.kind === "harness" && r.delivery === "direct" && r.state === "admitted") {
-        if (r.text === prompt) r.eligible = true;
+        if (recordMatchesText(r.text, prompt)) r.eligible = true;
       }
     }
     state.records = state.records.filter(

package/packages/core/index.ts

@@ -28,6 +28,8 @@ export * from "./src/package-colors.js";
 export * from "./src/tui/hub-kit.js";
 export * from "./src/tui/kit.js";
 export * from "./src/tui/progress.js";
+export * from "./src/tui/viz.js";
+export * from "./src/compaction-savings.js";
 export * from "./src/jev/client.js";
 export * from "./src/jev/settings.js";
 export * from "./src/jev/chatter.js";
@@ -45,4 +47,5 @@ export * from "./compaction-context.js";
 export * from "./src/settings/migrations.js";
 export * from "./src/hints/index.js";
 export * from "./src/hints/store.js";
+export { CRAB_14_LINES_256, CRAB_14_LINES_TRUECOLOR, CRAB_22_LINES_256, CRAB_22_LINES_TRUECOLOR } from "./src/hints/crab-data.js";
 export * from "./harness-messages.js";

package/packages/core/package.json

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

package/packages/core/src/compaction-savings.ts

@@ -0,0 +1,122 @@
+/**
+ * @pi-unipi/core — what compaction saved, from session entries.
+ *
+ * For every compaction:
+ *   saved     = context before − context after
+ *   replies   = assistant replies sent after it (until the next compaction)
+ *   avoided   = saved × replies          tokens that were NOT re-sent
+ *   rate      = Σ paid for context / Σ context tokens of those replies
+ *               (input + cache read + cache write — the blended price the
+ *               user actually paid per context token, so cache discounts
+ *               are already in it)
+ *   dollars   = avoided × rate           ≈ money not spent
+ *
+ * "after" is the compactor's own `details.tokensAfter` when present, else the
+ * context size the first reply after the compaction actually reported — the
+ * real number, not an estimate.
+ *
+ * Feed entries in file/branch order; works streaming (usage parser) or over
+ * a branch array (info screen).
+ */
+
+export interface CompactionSaving {
+  at: number;
+  before: number;
+  after: number;
+  replies: number;
+  /** Σ cost paid for context tokens by the replies after this compaction. */
+  paid: number;
+  /** Σ context tokens of those replies. */
+  context: number;
+}
+
+export interface SavingsTotals {
+  count: number;
+  saved: number;
+  avoided: number;
+  dollars: number;
+  /** Σ context actually sent after compactions (the "with" bar). */
+  sent: number;
+}
+
+export class SavingsAccumulator {
+  readonly items: CompactionSaving[] = [];
+  private seen = new Set<string>();
+  private open: CompactionSaving | null = null;
+  private afterKnown = false;
+
+  feed(entry: unknown): void {
+    const e = entry as { type?: string; timestamp?: string; tokensBefore?: number; details?: { tokensAfter?: number }; message?: any };
+    if (!e || typeof e !== "object") return;
+    if (e.type === "compaction") {
+      const at = Date.parse(e.timestamp ?? "") || 0;
+      const before = Number(e.tokensBefore ?? 0);
+      const key = `${at}:${before}`;
+      // Forked session files copy history; count each compaction once.
+      if (this.seen.has(key)) {
+        this.open = null;
+        return;
+      }
+      this.seen.add(key);
+      const after = Number(e.details?.tokensAfter ?? 0);
+      this.open = { at, before, after, replies: 0, paid: 0, context: 0 };
+      this.afterKnown = after > 0;
+      this.items.push(this.open);
+      return;
+    }
+    if (e.type !== "message" || !this.open) return;
+    const m = e.message;
+    if (m?.role !== "assistant" || m.stopReason === "error" || m.stopReason === "aborted") return;
+    const u = m.usage ?? {};
+    const ctx = (u.input ?? 0) + (u.cacheRead ?? 0) + (u.cacheWrite ?? 0);
+    if (ctx <= 0) return;
+    if (!this.afterKnown) {
+      this.open.after = ctx;
+      this.afterKnown = true;
+    }
+    this.open.replies++;
+    this.open.context += ctx;
+    const c = u.cost ?? {};
+    this.open.paid += (c.input ?? 0) + (c.cacheRead ?? 0) + (c.cacheWrite ?? 0);
+  }
+
+  totals(): SavingsTotals {
+    return totalsOf(this.items);
+  }
+}
+
+export function savedOf(c: CompactionSaving): number {
+  return Math.max(0, c.before - (c.after || c.before));
+}
+
+export function avoidedOf(c: CompactionSaving): number {
+  return savedOf(c) * c.replies;
+}
+
+export function dollarsOf(c: CompactionSaving): number {
+  return c.context > 0 ? avoidedOf(c) * (c.paid / c.context) : 0;
+}
+
+export function totalsOf(items: readonly CompactionSaving[]): SavingsTotals {
+  let saved = 0, avoided = 0, dollars = 0, sent = 0;
+  for (const c of items) {
+    saved += savedOf(c);
+    avoided += avoidedOf(c);
+    dollars += dollarsOf(c);
+    sent += c.context;
+  }
+  return { count: items.length, saved, avoided, dollars, sent };
+}
+
+export function addTotals(a: SavingsTotals, b: SavingsTotals): SavingsTotals {
+  return { count: a.count + b.count, saved: a.saved + b.saved, avoided: a.avoided + b.avoided, dollars: a.dollars + b.dollars, sent: a.sent + b.sent };
+}
+
+export const EMPTY_SAVINGS: SavingsTotals = { count: 0, saved: 0, avoided: 0, dollars: 0, sent: 0 };
+
+/** Convenience: savings for a whole branch. */
+export function compactionSavings(branch: readonly unknown[]): { items: CompactionSaving[]; totals: SavingsTotals } {
+  const acc = new SavingsAccumulator();
+  for (const e of branch) acc.feed(e);
+  return { items: acc.items, totals: acc.totals() };
+}