pi-magi-theme 0.1.0 → 0.1.2

package/README.md

@@ -4,6 +4,10 @@ A three-mind council theme + extension for [pi](https://pi.dev): a detailed Tree
 
 All artwork is original. The symbolism (the three Magi, the Tree of Life, the golem, the seven seals) is public domain.
 
+![pi with the MAGI theme: Tree of Life header, side panel with the MAGI triangle and llama-swap telemetry](https://raw.githubusercontent.com/b-iurea/pi-magi-theme/main/docs/screenshot.png)
+
+![The MAGI deliberating while the model thinks](https://raw.githubusercontent.com/b-iurea/pi-magi-theme/main/docs/deliberation.png)
+
 ## Install
 
 ```bash
@@ -48,6 +52,16 @@ Every symbol stands for something real the agent is doing.
 | the seven seals | the end of an age | **context window usage**, one seal per seventh | panel |
 | breaking the seals → seventh seal opened | apocalypse and renewal | **context compaction** running → done | panel + footer |
 
+## The seventh seal: smart compaction
+
+The theme does not compact anything itself: it shows who does. For better compaction install [pi-smart-compact](https://www.npmjs.com/package/pi-smart-compact):
+
+```bash
+pi install npm:pi-smart-compact
+```
+
+It extracts files, errors, decisions and open loops locally (no LLM calls), then synthesizes and verifies the summary. Point its `summaryModel` at a local model to keep compaction free. When it is installed, the seals name it while they break (`✶ BREAKING THE SEALS · smart-compact · 4s`) and the seventh seal reports who actually produced the summary: `smart-compact`, or `pi native` if it fell back to pi's own compactor.
+
 ## The council
 
 `/magi <question>` asks three models in parallel, each with its own nature, then shows the votes and a majority verdict:

package/extensions/magi/index.ts

@@ -200,7 +200,6 @@ const state = {
 	phaseSince: Date.now(),
 	toolName: "",
 	turns: 0,
-	tools: 0,
 	toolOk: 0, // CHESED
 	toolFail: 0, // GEBURAH
 	lastFailAt: 0,
@@ -209,6 +208,7 @@ const state = {
 	lastRunMs: 0,
 	compacting: false,
 	compactSince: 0,
+	compactBy: "", // who opens the seals: "smart-compact" (pi-smart-compact package) or "pi native"
 	rebornAt: 0,
 };
 
@@ -646,7 +646,9 @@ class MagiPanel implements Component {
 			if (state.compacting || now - state.rebornAt < REBIRTH_MS) {
 				// the seals break while the context is compacted; then the world is remade
 				const reborn = !state.compacting;
-				title = reborn ? "SEVENTH SEAL OPENED · REBORN" : `BREAKING THE SEALS ${secsSince(state.compactSince, now)}s`;
+				title = reborn
+					? "SEVENTH SEAL OPENED · REBORN"
+					: `SEALS · ${state.compactBy || "compacting"} ${secsSince(state.compactSince, now)}s`;
 				link = reborn ? "success" : f % 4 < 2 ? "warning" : "error";
 				hub = reborn ? "═MAGI═" : ["─SEAL─", "━SEAL━"][f % 2]!;
 				units = names.map((name, i) =>
@@ -748,7 +750,7 @@ class MagiPanel implements Component {
 		const stats = tokenStats();
 		out.push(
 			this.frameLine(
-				` ${th.fg("dim", "TURNS".padEnd(9))}${th.fg("text", String(state.turns).padEnd(6))}${th.fg("dim", "TOOLS ")}${th.fg("text", String(state.tools))}`,
+				` ${th.fg("dim", "TURNS".padEnd(9))}${th.fg("text", String(state.turns))}`,
 				inner,
 			),
 		);
@@ -771,14 +773,13 @@ class MagiPanel implements Component {
 				inner,
 			),
 		);
-		if (state.toolOk + state.toolFail) {
-			out.push(
-				this.frameLine(
-					` ${th.fg("dim", "CHESED".padEnd(9))}${th.fg("success", `✓${state.toolOk}`.padEnd(6))}${th.fg("dim", "GEBURAH ")}${th.fg(state.toolFail ? "error" : "dim", `✗${state.toolFail}`)}`,
-					inner,
-				),
-			);
-		}
+		// TOOLS: CHESED (mercy) = succeeded, GEBURAH (severity) = failed
+		out.push(
+			this.frameLine(
+				` ${th.fg("dim", "TOOLS".padEnd(7))}${th.fg("success", `✓${state.toolOk}`)}${th.fg("dim", " CHESED ")}${th.fg(state.toolFail ? "error" : "dim", `✗${state.toolFail}`)}${th.fg("dim", " GEBURAH")}`,
+				inner,
+			),
+		);
 
 		// SEALS: the context window, one seal per seventh
 		const usage = liveCtx?.getContextUsage?.();
@@ -800,9 +801,11 @@ class MagiPanel implements Component {
 			),
 		);
 		if (swap.srvPps) out.push(this.field("PROMPT/S", swap.srvPps.toFixed(1), inner, "muted"));
-		if (swap.inputTokens) {
-			const hit = Math.round((swap.cacheTokens / swap.inputTokens) * 100);
-			out.push(this.field("KV CACHE", `${fmtTokens(swap.cacheTokens)}/${fmtTokens(swap.inputTokens)} hit ${hit}%`, inner, "muted"));
+		// llama-swap's input_tokens are the prompt tokens processed outside the cache
+		const promptTotal = swap.cacheTokens + swap.inputTokens;
+		if (promptTotal) {
+			const hit = Math.round((swap.cacheTokens / promptTotal) * 100);
+			out.push(this.field("KV CACHE", `${fmtTokens(swap.cacheTokens)}/${fmtTokens(promptTotal)} hit ${hit}%`, inner, "muted"));
 		}
 		out.push(this.field("PEAK", perf.peakTps ? `${perf.peakTps.toFixed(1)} tok/s` : "—", inner, "muted"));
 		out.push(this.field("TTFT", perf.ttft ? fmtMs(perf.ttft) : "—", inner, "muted"));
@@ -1119,7 +1122,9 @@ function footerLeft(th: Theme, now = Date.now()): string {
 			th.fg("warning", "◉".repeat(broken)) +
 			dim("○".repeat(7 - broken)) +
 			th.fg("warning", " BREAKING THE SEALS") +
-			dim(` · compacting context ${secsSince(state.compactSince, now)}s`)
+			dim(" · ") +
+			th.fg("text", state.compactBy || "compacting") +
+			dim(` · ${secsSince(state.compactSince, now)}s`)
 		);
 	}
 	if (now - state.rebornAt < REBIRTH_MS) {
@@ -1127,7 +1132,7 @@ function footerLeft(th: Theme, now = Date.now()): string {
 			th.fg("success", "✶ ") +
 			renderPath(th, lights(() => (step % 2 ? "on" : "hot"))) +
 			th.fg("success", " SEVENTH SEAL OPENED") +
-			dim(" · context compacted, the world is remade")
+			dim(` · context compacted by ${state.compactBy || "pi"}, the world is remade`)
 		);
 	}
 	if (state.phase === "tool" || now - state.lastFailAt < FAIL_FLASH_MS) {
@@ -1395,7 +1400,6 @@ export default function (pi: ExtensionAPI) {
 		liveCtx = ctx;
 		setPhase("tool");
 		state.toolName = event.toolName ?? "";
-		state.tools++;
 		repaint();
 	});
 
@@ -1422,15 +1426,21 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	// The seven seals: compaction breaks them, and the context is reborn.
+	// When pi-smart-compact is installed it owns the compaction; this theme only watches and names it.
+	const hasSmartCompact = () => pi.getCommands().some((c) => c.name.replace(/^\//, "") === "smart-compact");
+
 	pi.on("session_before_compact", async () => {
 		state.compacting = true;
 		state.compactSince = Date.now();
+		state.compactBy = hasSmartCompact() ? "smart-compact" : "pi native";
 		repaint();
 	});
 
-	pi.on("session_compact", async () => {
+	pi.on("session_compact", async (event) => {
 		state.compacting = false;
 		state.rebornAt = Date.now();
+		// fromExtension: an extension supplied the summary; otherwise pi's own compactor did (e.g. smart-compact fell back)
+		state.compactBy = event.fromExtension ? (hasSmartCompact() ? "smart-compact" : "extension") : "pi native";
 		repaint();
 	});
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-magi-theme",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MAGI theme + extension for pi: Tree of Life header, three-model /magi council, golem tool animations, seven-seal context gauge, llama-swap telemetry",
   "keywords": [
     "pi-package",
@@ -29,6 +29,7 @@
     "LICENSE"
   ],
   "pi": {
+    "image": "https://raw.githubusercontent.com/b-iurea/pi-magi-theme/main/docs/screenshot.png",
     "extensions": [
       "./extensions/magi/index.ts"
     ],