@narumitw/pi-statusline 0.36.0 → 0.38.0

package/README.md

@@ -8,7 +8,7 @@ without setup and keeps useful context visible as the terminal narrows.
 A representative uncolored layout:
 
 ```text
-░▒▓ 🤖 sonnet-4 🧠 high 📁 pi-extensions 🌿 main ~2 🪟 ctx 42% 🕒 16:42
+░▒▓ 🤖 sonnet-4 🧠 high 📁 pi-extensions 🌿 main ~2 🪟 ctx 42.0%/200k 🕒 16:42
 ```
 
 ## ✨ Features
@@ -16,6 +16,7 @@ A representative uncolored layout:
 - **Zero-config default:** model, thinking, workspace, Git/PR state, context use, and local time.
 - **Responsive:** removes lower-priority segments before important information gets clipped.
 - **Quiet when idle:** activity appears only while Pi is streaming or running tools.
+- **Native-aligned usage:** optional token, prompt-cache, subscription, and cost details.
 - **Easy choices:** three information levels and seven previewable color presets.
 - **Still flexible:** custom layouts, multiline rows, colors, labels, separators, and status icons stay
   available under **Advanced**.
@@ -47,7 +48,8 @@ For the best result, use a terminal font that includes Powerline glyphs and emoj
 
 1. Install the extension and start Pi.
 2. Run `/statusline`.
-3. Choose an appearance or information level; changes apply immediately.
+3. Use the standard Main/Advanced navigation, then choose an appearance or information level;
+   specialized previews still apply changes immediately.
 
 ```text
 Appearance (tokyo-night)
@@ -74,10 +76,11 @@ preserved.
 | --- | --- |
 | **Minimal** | `model cwd branch context` |
 | **Balanced** (default) | `model thinking cwd branch tools context time` |
-| **Detailed** | `provider model thinking cwd branch tools context tokens cost time` |
+| **Detailed** | `provider model thinking cwd branch tools context tokens cache cost time` |
 | **Custom** | Any other segment order, including explicit line breaks |
 
-The `tools` segment takes no space while idle.
+The `tools` segment takes no space while idle. `cache` takes no space when Pi has reported no cache
+reads or writes.
 
 ## 💬 Commands
 
@@ -88,8 +91,11 @@ The `tools` segment takes no space while idle.
 | `/statusline status` | Show the effective settings and diagnostics |
 | `/statusline help` | Show command and schema guidance |
 
-The direct `settings`, `status`, and `help` routes remain for compatibility. RPC receives observable
-notifications instead of TUI-only controls. Unknown subcommands and trailing arguments are rejected.
+The direct `settings`, `status`, and `help` routes remain for compatibility. The root standard menu
+is TUI-only; Escape returns from Advanced or closes Main. RPC receives observable notifications
+instead of TUI-only controls. Unknown subcommands and trailing arguments are rejected. Palette and
+information previews, the width-aware layout editor, and the JSON editor remain specialized UI
+because they provide live preview/edit behavior rather than standard navigation.
 
 ## 📐 Runtime behavior
 
@@ -100,7 +106,7 @@ lowest-priority segment, recomputes the powerline transitions, and repeats until
 Retention priority is highest to lowest:
 
 ```text
-context model branch tools cwd thinking cost provider tokens time turn brand
+context model branch tools cwd thinking cost provider cache tokens time turn brand
 ```
 
 Explicit `line_break` entries remain row boundaries. A single segment that is still too wide is
@@ -117,6 +123,20 @@ ANSI-safely truncated.
 - Context color changes to warning at 70% and error at 90%.
 - Git state is cached outside footer rendering and stale session results are ignored.
 
+### Usage and context
+
+- `context` renders one-decimal current usage and the model window, such as `2.4%/272k`. After
+  compaction it can temporarily render `?/272k` until the next valid assistant response.
+- `tokens`, `cache`, and `cost` total every usage-bearing session entry, matching Pi's native footer:
+  assistant messages, nested-LLM tool results, compactions, and branch summaries, including abandoned
+  branches retained in the session.
+- Cache tokens are `R<read>`, `W<write>`, and `CH<rate>`. `R` and `W` are cumulative; `CH` uses only
+  the latest assistant prompt: `cacheRead / (input + cacheRead + cacheWrite) * 100`.
+- Subscription-backed OAuth models and `kimi-coding` append `(sub)` to cost. The dollar value is
+  usage cost, not proof of an amount billed under a subscription.
+- Pi's public extension API does not expose the current auto-compaction toggle, so this footer cannot
+  reliably show the native `(auto)` marker.
+
 ## ⚙️ Settings
 
 The extension uses one user-level file:
@@ -142,7 +162,7 @@ automatically; rename it to `pi-statusline.json`. If both files exist, `pi-statu
 | `density` | `compact`, `cozy` | Control horizontal padding |
 | `separator` | `none`, `dot`, `bar`, `powerline`, `round` | Separate adjacent segments in one color block |
 | `segments` | Ordered unique segment names and `line_break` | Control visibility, order, and rows |
-| `segmentText` | Per-segment `prefix` and `suffix` | Wrap Pi-owned dynamic values |
+| `segmentText` | Per-segment `prefix` and `suffix`; model truncation fields | Format Pi-owned dynamic values |
 | `extensionStatusIcons` | Raw status key or `namespace:*` to icon string | Customize extension status icons |
 
 All fields are optional in an existing document. Missing fields use defaults. Unknown fields produce a
@@ -156,8 +176,13 @@ A compact customization example:
   "palettePreset": "ocean",
   "density": "compact",
   "separator": "dot",
-  "segments": ["model", "thinking", "cwd", "branch", "context", "cost"],
+  "segments": ["model", "thinking", "cwd", "branch", "context", "cache", "cost"],
   "segmentText": {
+    "model": {
+      "truncationLength": 40,
+      "truncationSymbol": "…",
+      "truncationDirection": "middle"
+    },
     "context": { "prefix": "ctx ", "suffix": "" }
   },
   "extensionStatusIcons": {
@@ -198,6 +223,37 @@ When `palettePreset` is `custom`, `palette` maps segment names to foreground/bac
 `segmentText` values must be single-line text without terminal control characters. Use `line_break`
 for another row rather than inserting a newline into a prefix or suffix.
 
+### Model truncation
+
+Long model IDs are truncated out of the box so the balanced footer can retain useful model context:
+
+```json
+{
+  "segmentText": {
+    "model": {
+      "truncationLength": 36,
+      "truncationSymbol": "…",
+      "truncationDirection": "start"
+    }
+  }
+}
+```
+
+`truncationLength` counts model grapheme clusters retained before the symbol. The built-in value is
+`36`; set it to `0` to display the complete ID. The direction names the removed portion:
+
+- `start` retains the suffix and is the default, which is useful for long llama.cpp paths and model
+  variants.
+- `middle` retains both ends.
+- `end` retains the prefix.
+
+Truncation runs after the built-in Claude/GPT shortening rules but before the configured model prefix
+and suffix. It changes display only—the provider model ID is untouched. Terminal control sequences
+in model IDs are removed at render time, and unsafe configured symbols are rejected. An empty
+`truncationSymbol` truncates without a marker. pi-statusline treats model IDs as opaque strings and
+does not parse paths, repositories, GGUF suffixes, or quantization names. At very narrow widths, the
+existing responsive priorities may still omit the model rather than overflow the terminal.
+
 ## 🧩 Advanced layout
 
 Open **Advanced → Custom layout** when the curated levels are not enough.
@@ -218,7 +274,7 @@ Every successful change saves and applies immediately; closing the screen does n
 Available data segments:
 
 ```text
-brand provider model thinking cwd branch tools context tokens cost time turn
+brand provider model thinking cwd branch tools context tokens cache cost time turn
 ```
 
 Data segments must be unique. `line_break` may repeat when data segments separate occurrences, but
@@ -278,6 +334,7 @@ extensions/pi-statusline/
 │   ├── index.ts
 │   ├── statusline.ts
 │   ├── render.ts
+│   ├── usage.ts
 │   ├── powerline.ts
 │   ├── information-profiles.ts
 │   ├── commands.ts
@@ -299,7 +356,7 @@ extensions/pi-statusline/
 ## 🔎 Keywords
 
 Pi extension, Pi coding agent, statusline, Tokyo Night, powerline, responsive terminal footer,
-context usage, model status.
+context usage, prompt cache, cache hit rate, model status.
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-statusline",
-	"version": "0.36.0",
+	"version": "0.38.0",
 	"description": "Pi extension that replaces the footer with an information-rich statusline.",
 	"type": "module",
 	"license": "MIT",
@@ -38,5 +38,8 @@
 		"type": "git",
 		"url": "https://github.com/narumiruna/pi-extensions",
 		"directory": "extensions/pi-statusline"
+	},
+	"dependencies": {
+		"@narumitw/pi-tui-kit": "<1"
 	}
 }

package/src/commands.ts

@@ -14,6 +14,7 @@ import {
 	truncateToWidth,
 	wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
+import { defineMenu, runMenu } from "@narumitw/pi-tui-kit";
 import {
 	INFORMATION_PROFILE_NAMES,
 	INFORMATION_PROFILES,
@@ -51,6 +52,7 @@ const SEGMENT_DESCRIPTIONS: Record<SegmentName, string> = {
 	tools: "Current tool and streaming activity",
 	context: "Current context-window usage",
 	tokens: "Session token totals",
+	cache: "Prompt-cache reads, writes, and latest hit rate",
 	cost: "Session cost",
 	time: "Current local time",
 	turn: "Current session turn count",
@@ -67,6 +69,7 @@ export interface StatuslineCommandOptions {
 	apply(loaded: LoadedStatuslineSettings, ctx: ExtensionCommandContext): void;
 	preview?(palettePreset: PalettePreset | undefined, ctx: ExtensionCommandContext): void;
 	save?: (settingsPath: string, rawDocument: string) => LoadedStatuslineSettings;
+	getMenuOwner?(): { signal: AbortSignal; isCurrent(): boolean };
 }
 
 export function registerStatuslineCommand(pi: ExtensionAPI, options: StatuslineCommandOptions) {
@@ -114,67 +117,100 @@ export function registerStatuslineCommand(pi: ExtensionAPI, options: StatuslineC
 
 async function showMainMenu(ctx: ExtensionCommandContext, options: StatuslineCommandOptions) {
 	if (ctx.mode !== "tui") {
-		if (ctx.hasUI) ctx.ui.notify("/statusline requires an interactive Pi UI.", "error");
+		if (ctx.hasUI) ctx.ui.notify("/statusline requires an interactive Pi UI in TUI mode.", "error");
 		return;
 	}
-	while (true) {
-		const config = options.getLoaded().config;
-		const appearanceItem = `Appearance (${config.palettePreset})`;
-		const informationItem = `Information (${inferInformationProfile(config.segments)})`;
-		const selection = await ctx.ui.select("pi-statusline", [
-			appearanceItem,
-			informationItem,
-			"Advanced",
-			"Status",
-			"Help",
-		]);
-		if (selection === appearanceItem) {
-			await choosePalettePreset(ctx, options);
-			return;
-		}
-		if (selection === informationItem) {
-			await chooseInformationProfile(ctx, options);
-			return;
-		}
-		switch (selection) {
-			case "Advanced":
-				if (await showAdvancedMenu(ctx, options)) continue;
-				return;
-			case "Status":
+	const fallbackController = new AbortController();
+	const owner = options.getMenuOwner?.() ?? {
+		signal: fallbackController.signal,
+		isCurrent: () => !fallbackController.signal.aborted,
+	};
+	type Screen = "main" | "advanced";
+	type Action = "appearance" | "information" | "layout" | "edit" | "status" | "help" | "back";
+	const menu = defineMenu<undefined, Screen, Action, ExtensionCommandContext>({
+		start: "main",
+		screens: {
+			main: () => {
+				const config = options.getLoaded().config;
+				return {
+					kind: "actions",
+					title: "pi-statusline",
+					items: [
+						{
+							id: "appearance",
+							label: `Appearance (${config.palettePreset})`,
+							action: "appearance",
+						},
+						{
+							id: "information",
+							label: `Information (${inferInformationProfile(config.segments)})`,
+							action: "information",
+						},
+						{ id: "advanced", label: "Advanced", to: "advanced" },
+						{ id: "status", label: "Status", action: "status" },
+						{ id: "help", label: "Help", action: "help" },
+					],
+					hint: "close",
+				};
+			},
+			advanced: () => {
+				const config = options.getLoaded().config;
+				const visibleSegmentCount = config.segments.filter(
+					(segment): segment is SegmentName => segment !== LINE_BREAK_SEGMENT_NAME,
+				).length;
+				return {
+					kind: "actions",
+					title: "pi-statusline — Advanced",
+					items: [
+						{
+							id: "layout",
+							label: `Custom layout (${visibleSegmentCount}/${SEGMENT_NAMES.length} shown)`,
+							action: "layout",
+						},
+						{ id: "edit", label: EDIT_SETTINGS_LABEL, action: "edit" },
+						{ id: "back", label: "Back", action: "back" },
+					],
+					hint: "back",
+				};
+			},
+		},
+		actions: {
+			appearance: async () => {
+				await choosePalettePreset(ctx, options);
+				return { kind: "close" };
+			},
+			information: async () => {
+				await chooseInformationProfile(ctx, options);
+				return { kind: "close" };
+			},
+			layout: async () => {
+				await chooseSegments(ctx, options);
+				return { kind: "close" };
+			},
+			edit: async () => {
+				await editSettings(ctx, options);
+				return { kind: "close" };
+			},
+			status: async () => {
 				showStatus(ctx, options);
-				return;
-			case "Help":
+				return { kind: "close" };
+			},
+			help: async () => {
 				showHelp(ctx, options.settingsPath);
-				return;
-			default:
-				return;
-		}
-	}
-}
-
-async function showAdvancedMenu(
-	ctx: ExtensionCommandContext,
-	options: StatuslineCommandOptions,
-): Promise<boolean> {
-	const config = options.getLoaded().config;
-	const visibleSegmentCount = config.segments.filter(
-		(segment): segment is SegmentName => segment !== LINE_BREAK_SEGMENT_NAME,
-	).length;
-	const layoutItem = `Custom layout (${visibleSegmentCount}/${SEGMENT_NAMES.length} shown)`;
-	const selection = await ctx.ui.select("pi-statusline — Advanced", [
-		layoutItem,
-		EDIT_SETTINGS_LABEL,
-		"Back",
-	]);
-	if (selection === layoutItem) {
-		await chooseSegments(ctx, options);
-		return false;
-	}
-	if (selection === EDIT_SETTINGS_LABEL) {
-		await editSettings(ctx, options);
-		return false;
+				return { kind: "close" };
+			},
+			back: async () => ({ kind: "back" }),
+		},
+	});
+	try {
+		await runMenu(ctx, menu, {
+			getState: () => undefined,
+			signal: owner.signal,
+			isCurrent: owner.isCurrent,
+		});
+	} finally {
+		fallbackController.abort(new DOMException("Statusline menu closed", "AbortError"));
 	}
-	return selection === "Back";
 }
 
 async function choosePalettePreset(
@@ -919,6 +955,7 @@ function showHelp(ctx: ExtensionCommandContext, settingsPath: string) {
 			"Press M for move mode, Alt+Up/Alt+Down for quick move, and B for a line break.",
 			"Line breaks (line_break) may repeat when separated by data segments, but cannot be consecutive.",
 			"segmentText supports prefix and suffix strings around Pi-owned dynamic values.",
+			"segmentText.model also supports truncationLength, truncationSymbol, and truncationDirection (start, middle, end).",
 		].join("\n"),
 		"info",
 	);

package/src/information-profiles.ts

@@ -18,6 +18,7 @@ export const INFORMATION_PROFILES: Readonly<
 		"tools",
 		"context",
 		"tokens",
+		"cache",
 		"cost",
 		"time",
 	],

package/src/powerline.ts

@@ -49,6 +49,7 @@ const SEGMENT_RETENTION_PRIORITY: Readonly<Record<RenderSegment["name"], number>
 	thinking: 70,
 	cost: 60,
 	provider: 50,
+	cache: 45,
 	tokens: 40,
 	time: 30,
 	turn: 20,

package/src/presets/index.ts

@@ -37,6 +37,7 @@ const SEGMENT_BLOCKS: Record<SegmentName, PowerlineBlockName> = {
 	tools: "runtime",
 	context: "runtime",
 	tokens: "runtime",
+	cache: "runtime",
 	cost: "meter",
 	time: "meter",
 	turn: "meter",

package/src/render.ts

@@ -20,7 +20,9 @@ import {
 	type RenderSegment,
 	type SegmentName,
 	type StatuslineConfig,
+	type TruncationDirection,
 } from "./types.js";
+import { type FooterUsageSummary, summarizeFooterUsage } from "./usage.js";
 
 type ThinkingLevel = ReturnType<ExtensionAPI["getThinkingLevel"]>;
 export interface RuntimeState extends ExtensionStatusRuntime {
@@ -31,11 +33,6 @@ export interface RuntimeState extends ExtensionStatusRuntime {
 	gitStatus?: GitStatusSummary;
 	requestRender?: () => void;
 }
-interface TokenTotals {
-	input: number;
-	output: number;
-	cost: number;
-}
 const GITHUB_PR_KEY = "github-pr";
 const GITHUB_PR_STATUS_KEYS = new Set([GITHUB_PR_KEY]);
 export function renderStatusline(
@@ -48,6 +45,7 @@ export function renderStatusline(
 ): string {
 	if (width <= 0) return "";
 
+	const usageSummary = summarizeFooterUsage(ctx.sessionManager.getEntries());
 	const rows: Array<{ configuredSegments: number; segments: RenderSegment[] }> = [
 		{ configuredSegments: 0, segments: [] },
 	];
@@ -60,7 +58,7 @@ export function renderStatusline(
 		const row = rows.at(-1);
 		if (!row) continue;
 		row.configuredSegments += 1;
-		const rendered = buildSegment(name, ctx, footerData, config, runtime);
+		const rendered = buildSegment(name, ctx, footerData, config, runtime, usageSummary);
 		if (rendered && rendered.text.length > 0) row.segments.push(rendered);
 	}
 
@@ -103,14 +101,23 @@ function buildSegment(
 	footerData: ReadonlyFooterDataProvider,
 	config: StatuslineConfig,
 	runtime: RuntimeState,
+	usageSummary: FooterUsageSummary,
 ): RenderSegment | undefined {
 	switch (name) {
 		case "brand":
 			return segment(name, "π", config, "accent", "header", true);
 		case "provider":
 			return segment(name, ctx.model?.provider ?? "no-provider", config, "accent", "header");
-		case "model":
-			return segment(name, shortenModel(ctx.model?.id ?? "no-model"), config, "accent", "header");
+		case "model": {
+			const presentation = config.segmentText.model;
+			const model = truncateModel(
+				shortenModel(ctx.model?.id ?? "no-model"),
+				presentation.truncationLength,
+				presentation.truncationSymbol,
+				presentation.truncationDirection,
+			);
+			return segment(name, model, config, "accent", "header");
+		}
 		case "thinking":
 			return segment(
 				name,
@@ -138,25 +145,41 @@ function buildSegment(
 		}
 		case "context": {
 			const usage = ctx.getContextUsage();
-			const value =
+			const percentage =
 				usage?.percent === null || usage?.percent === undefined
 					? "?"
-					: `${usage.percent.toFixed(0)}%`;
-			return segment(name, value, config, contextColor(usage?.percent), "runtime");
+					: `${usage.percent.toFixed(1)}%`;
+			const contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow ?? 0;
+			return segment(
+				name,
+				`${percentage}/${formatCount(contextWindow)}`,
+				config,
+				contextColor(usage?.percent),
+				"runtime",
+			);
 		}
 		case "tokens": {
-			const totals = getTokenTotals(ctx);
 			const value =
-				totals.input === 0 && totals.output === 0
+				usageSummary.input === 0 && usageSummary.output === 0
 					? "tok 0"
-					: `↑${formatCount(totals.input)} ↓${formatCount(totals.output)}`;
+					: `↑${formatCount(usageSummary.input)} ↓${formatCount(usageSummary.output)}`;
 			return segment(name, value, config, "accent", "runtime");
 		}
+		case "cache": {
+			if (usageSummary.cacheRead === 0 && usageSummary.cacheWrite === 0) return undefined;
+			const values: string[] = [];
+			if (usageSummary.cacheRead > 0) values.push(`R${formatCount(usageSummary.cacheRead)}`);
+			if (usageSummary.cacheWrite > 0) values.push(`W${formatCount(usageSummary.cacheWrite)}`);
+			if (usageSummary.latestCacheHitRate !== undefined) {
+				values.push(`CH${usageSummary.latestCacheHitRate.toFixed(1)}%`);
+			}
+			return segment(name, values.join(" "), config, "accent", "runtime");
+		}
 		case "cost": {
-			const totals = getTokenTotals(ctx);
+			const subscription = isSubscriptionBacked(ctx) ? " (sub)" : "";
 			return segment(
 				name,
-				totals.cost.toFixed(totals.cost >= 1 ? 2 : 3),
+				`${usageSummary.cost.toFixed(usageSummary.cost >= 1 ? 2 : 3)}${subscription}`,
 				config,
 				"accent",
 				"meter",
@@ -268,26 +291,12 @@ function compactPrState(value: string): string | undefined {
 	return undefined;
 }
 
-function getTokenTotals(ctx: ExtensionContext): TokenTotals {
-	const totals: TokenTotals = { input: 0, output: 0, cost: 0 };
-
-	for (const entry of ctx.sessionManager.getBranch()) {
-		if (entry.type !== "message" || entry.message.role !== "assistant") continue;
-
-		const usage = entry.message.usage as
-			| {
-					input?: number;
-					output?: number;
-					cost?: { total?: number };
-			  }
-			| undefined;
-
-		totals.input += usage?.input ?? 0;
-		totals.output += usage?.output ?? 0;
-		totals.cost += usage?.cost?.total ?? 0;
-	}
-
-	return totals;
+function isSubscriptionBacked(ctx: ExtensionContext): boolean {
+	const model = ctx.model;
+	return (
+		model !== undefined &&
+		(model.provider === "kimi-coding" || ctx.modelRegistry.isUsingOAuth(model))
+	);
 }
 
 export function formatCount(value: number): string {
@@ -303,6 +312,95 @@ function formatTime(): string {
 	return `${hours}:${minutes}`;
 }
 
+const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+
+export function truncateModel(
+	model: string,
+	length: number,
+	symbol: string,
+	direction: TruncationDirection,
+): string {
+	const safeModel = sanitizeModelDisplay(model);
+	if (length === 0) return safeModel;
+	const graphemes = [...graphemeSegmenter.segment(safeModel)].map(({ segment }) => segment);
+	if (graphemes.length <= length) return safeModel;
+	const safeSymbol = sanitizeModelDisplay(symbol);
+
+	switch (direction) {
+		case "start":
+			return `${safeSymbol}${graphemes.slice(-length).join("")}`;
+		case "middle": {
+			const headLength = Math.ceil(length / 2);
+			const tailLength = Math.floor(length / 2);
+			const tail = tailLength > 0 ? graphemes.slice(-tailLength).join("") : "";
+			return `${graphemes.slice(0, headLength).join("")}${safeSymbol}${tail}`;
+		}
+		case "end":
+			return `${graphemes.slice(0, length).join("")}${safeSymbol}`;
+	}
+}
+
+function sanitizeModelDisplay(value: string): string {
+	let result = "";
+	for (let index = 0; index < value.length; ) {
+		const codePoint = value.codePointAt(index) ?? 0;
+		const character = String.fromCodePoint(codePoint);
+		if (codePoint === 0x1b || codePoint === 0x9b || codePoint === 0x9d) {
+			index = skipTerminalEscape(value, index, codePoint);
+			continue;
+		}
+		if (
+			codePoint <= 0x1f ||
+			(codePoint >= 0x7f && codePoint <= 0x9f) ||
+			codePoint === 0x2028 ||
+			codePoint === 0x2029
+		) {
+			if (
+				codePoint === 0x09 ||
+				codePoint === 0x0a ||
+				codePoint === 0x0d ||
+				codePoint === 0x85 ||
+				codePoint === 0x2028 ||
+				codePoint === 0x2029
+			) {
+				result += " ";
+			}
+			index += character.length;
+			continue;
+		}
+		result += character;
+		index += character.length;
+	}
+	return result;
+}
+
+function skipTerminalEscape(value: string, start: number, codePoint: number): number {
+	let index = start + 1;
+	const next = value.charCodeAt(index);
+	const isOsc = codePoint === 0x9d || (codePoint === 0x1b && next === 0x5d);
+	if (isOsc) {
+		if (codePoint === 0x1b) index += 1;
+		while (index < value.length) {
+			const current = value.charCodeAt(index);
+			if (current === 0x07 || current === 0x9c) return index + 1;
+			if (current === 0x1b && value.charCodeAt(index + 1) === 0x5c) return index + 2;
+			index += 1;
+		}
+		return index;
+	}
+	const isCsi = codePoint === 0x9b || (codePoint === 0x1b && next === 0x5b);
+	if (isCsi) {
+		if (codePoint === 0x1b) index += 1;
+		while (index < value.length) {
+			const current = value.charCodeAt(index);
+			index += 1;
+			if (current >= 0x40 && current <= 0x7e) break;
+		}
+		return index;
+	}
+	return Math.min(value.length, start + (codePoint === 0x1b ? 2 : 1));
+}
+
 export function shortenModel(model: string): string {
 	return model
 		.replace(/^claude-/, "")

package/src/settings.ts

@@ -16,6 +16,7 @@ import {
 	type SegmentName,
 	type SegmentPalette,
 	type StatuslineConfig,
+	TRUNCATION_DIRECTIONS,
 } from "./types.js";
 
 export const SETTINGS_FILE_NAME = "pi-statusline.json";
@@ -60,13 +61,20 @@ export const DEFAULT_STATUSLINE_CONFIG: StatuslineConfig = {
 	segmentText: {
 		brand: { prefix: "", suffix: "" },
 		provider: { prefix: "🔌 ", suffix: "" },
-		model: { prefix: "🤖 ", suffix: "" },
+		model: {
+			prefix: "🤖 ",
+			suffix: "",
+			truncationLength: 36,
+			truncationSymbol: "…",
+			truncationDirection: "start",
+		},
 		thinking: { prefix: "🧠 ", suffix: "" },
 		cwd: { prefix: "📁 ", suffix: "" },
 		branch: { prefix: "🌿 ", suffix: "" },
 		tools: { prefix: "", suffix: "" },
 		context: { prefix: "🪟 ctx ", suffix: "" },
 		tokens: { prefix: "🔢 ", suffix: "" },
+		cache: { prefix: "📦 ", suffix: "" },
 		cost: { prefix: "💸 $", suffix: "" },
 		time: { prefix: "🕒 ", suffix: "" },
 		turn: { prefix: "🔁 #", suffix: "" },
@@ -202,32 +210,25 @@ export function normalizeStatuslineConfig(value: unknown): {
 					diagnostics.push(invalidDiagnostic(path, "Expected an object"));
 					continue;
 				}
+				const knownFields = new Set([
+					"prefix",
+					"suffix",
+					...(name === "model"
+						? ["truncationLength", "truncationSymbol", "truncationDirection"]
+						: []),
+				]);
 				for (const key of Object.keys(presentation)) {
-					if (key !== "prefix" && key !== "suffix") {
-						diagnostics.push(unknownDiagnostic(`${path}.${key}`));
-					}
+					if (!knownFields.has(key)) diagnostics.push(unknownDiagnostic(`${path}.${key}`));
 				}
 				for (const field of ["prefix", "suffix"] as const) {
 					const fieldValue = presentation[field];
 					if (fieldValue === undefined) continue;
-					if (typeof fieldValue !== "string") {
-						diagnostics.push(invalidDiagnostic(`${path}.${field}`, "Expected a string"));
-						continue;
-					}
-					if (/[\r\n\u2028\u2029]/u.test(fieldValue)) {
-						diagnostics.push(
-							invalidDiagnostic(`${path}.${field}`, "Line breaks are not allowed; use line_break"),
-						);
-						continue;
-					}
-					if (hasControlCharacter(fieldValue)) {
-						diagnostics.push(
-							invalidDiagnostic(`${path}.${field}`, "Control characters are not allowed"),
-						);
-						continue;
-					}
+					if (!isSafeSegmentText(fieldValue, `${path}.${field}`, diagnostics)) continue;
 					config.segmentText[name][field] = fieldValue;
 				}
+				if (name === "model") {
+					normalizeModelTruncation(presentation, config, diagnostics);
+				}
 			}
 		}
 	}
@@ -504,6 +505,65 @@ function normalizePalette(
 	config.palettePreset = "custom";
 }
 
+function normalizeModelTruncation(
+	presentation: Record<string, unknown>,
+	config: StatuslineConfig,
+	diagnostics: StatuslineConfigDiagnostic[],
+) {
+	const path = "segmentText.model";
+	const length = presentation.truncationLength;
+	if (length !== undefined) {
+		if (typeof length !== "number" || !Number.isInteger(length) || length < 0 || length > 1000) {
+			diagnostics.push(
+				invalidDiagnostic(`${path}.truncationLength`, "Expected an integer from 0 through 1000"),
+			);
+		} else config.segmentText.model.truncationLength = length;
+	}
+
+	const symbol = presentation.truncationSymbol;
+	if (symbol !== undefined && isSafeSegmentText(symbol, `${path}.truncationSymbol`, diagnostics)) {
+		config.segmentText.model.truncationSymbol = symbol;
+	}
+
+	const direction = presentation.truncationDirection;
+	if (direction !== undefined) {
+		if (
+			typeof direction !== "string" ||
+			!TRUNCATION_DIRECTIONS.includes(direction as (typeof TRUNCATION_DIRECTIONS)[number])
+		) {
+			diagnostics.push(
+				invalidDiagnostic(
+					`${path}.truncationDirection`,
+					`Expected one of: ${TRUNCATION_DIRECTIONS.join(", ")}`,
+				),
+			);
+		} else {
+			config.segmentText.model.truncationDirection =
+				direction as (typeof TRUNCATION_DIRECTIONS)[number];
+		}
+	}
+}
+
+function isSafeSegmentText(
+	value: unknown,
+	path: string,
+	diagnostics: StatuslineConfigDiagnostic[],
+): value is string {
+	if (typeof value !== "string") {
+		diagnostics.push(invalidDiagnostic(path, "Expected a string"));
+		return false;
+	}
+	if (/[\r\n\u2028\u2029]/u.test(value)) {
+		diagnostics.push(invalidDiagnostic(path, "Line breaks are not allowed; use line_break"));
+		return false;
+	}
+	if (hasControlCharacter(value)) {
+		diagnostics.push(invalidDiagnostic(path, "Control characters are not allowed"));
+		return false;
+	}
+	return true;
+}
+
 function normalizeEnum<
 	K extends "palettePreset" | "density" | "separator",
 	T extends StatuslineConfig[K],

package/src/statusline.ts

@@ -40,6 +40,7 @@ export default function statusline(pi: ExtensionAPI) {
 	};
 
 	let sessionGeneration = 0;
+	let menuController = new AbortController();
 	let gitStatusRequestId = 0;
 	let activeGitStatusTarget: { cwd: string; generation: number } | undefined;
 	let gitStatusRefreshInFlight = false;
@@ -114,6 +115,8 @@ export default function statusline(pi: ExtensionAPI) {
 
 	const installFooter = (ctx: ExtensionContext) => {
 		const generation = ++sessionGeneration;
+		menuController.abort(new DOMException("Statusline session context replaced", "AbortError"));
+		menuController = new AbortController();
 		const cwd = ctx.cwd;
 		activeSessionManager = ctx.sessionManager;
 		previewPalettePreset = undefined;
@@ -180,6 +183,13 @@ export default function statusline(pi: ExtensionAPI) {
 	registerStatuslineCommand(pi, {
 		settingsPath: configPath,
 		getLoaded: () => loaded ?? loadStatuslineSettings(configPath),
+		getMenuOwner: () => {
+			const generation = sessionGeneration;
+			return {
+				signal: menuController.signal,
+				isCurrent: () => generation === sessionGeneration && !menuController.signal.aborted,
+			};
+		},
 		apply(next, ctx) {
 			if (ctx.sessionManager !== activeSessionManager) return;
 			previewPalettePreset = undefined;
@@ -215,6 +225,7 @@ export default function statusline(pi: ExtensionAPI) {
 	pi.on("session_shutdown", (_event, ctx) => {
 		if (!ownsRuntime(ctx)) return;
 		sessionGeneration += 1;
+		menuController.abort(new DOMException("Statusline session shut down", "AbortError"));
 		activeSessionManager = undefined;
 		previewPalettePreset = undefined;
 		activeGitStatusTarget = undefined;

package/src/types.ts

@@ -10,6 +10,7 @@ export const SEGMENT_NAMES = [
 	"tools",
 	"context",
 	"tokens",
+	"cache",
 	"cost",
 	"time",
 	"turn",
@@ -39,6 +40,9 @@ export type Density = (typeof DENSITIES)[number];
 export const SEPARATOR_NAMES = ["none", "dot", "bar", "powerline", "round"] as const;
 export type SeparatorName = (typeof SEPARATOR_NAMES)[number];
 
+export const TRUNCATION_DIRECTIONS = ["start", "middle", "end"] as const;
+export type TruncationDirection = (typeof TRUNCATION_DIRECTIONS)[number];
+
 export type PowerlineBlockName = "header" | "directory" | "git" | "runtime" | "meter";
 
 export interface SegmentTextConfig {
@@ -46,6 +50,12 @@ export interface SegmentTextConfig {
 	suffix: string;
 }
 
+export interface ModelSegmentTextConfig extends SegmentTextConfig {
+	truncationLength: number;
+	truncationSymbol: string;
+	truncationDirection: TruncationDirection;
+}
+
 export interface SegmentPaletteColor {
 	fg?: string;
 	bg?: string;
@@ -59,7 +69,7 @@ export interface StatuslineConfig {
 	density: Density;
 	separator: SeparatorName;
 	segments: ConfigSegmentName[];
-	segmentText: Record<SegmentName, SegmentTextConfig>;
+	segmentText: Record<SegmentName, SegmentTextConfig> & { model: ModelSegmentTextConfig };
 	extensionStatusIcons: Record<string, string>;
 }
 

package/src/usage.ts

@@ -0,0 +1,53 @@
+import type { SessionEntry } from "@earendil-works/pi-coding-agent";
+
+interface UsageLike {
+	input?: number;
+	output?: number;
+	cacheRead?: number;
+	cacheWrite?: number;
+	cost?: { total?: number };
+}
+
+export interface FooterUsageSummary {
+	input: number;
+	output: number;
+	cacheRead: number;
+	cacheWrite: number;
+	cost: number;
+	latestCacheHitRate?: number;
+}
+
+export function summarizeFooterUsage(entries: readonly SessionEntry[]): FooterUsageSummary {
+	const totals: FooterUsageSummary = {
+		input: 0,
+		output: 0,
+		cacheRead: 0,
+		cacheWrite: 0,
+		cost: 0,
+	};
+
+	for (const entry of entries) {
+		let usage: UsageLike | undefined;
+		if (entry.type === "message" && entry.message.role === "assistant") {
+			usage = entry.message.usage;
+			const input = usage.input ?? 0;
+			const cacheRead = usage.cacheRead ?? 0;
+			const cacheWrite = usage.cacheWrite ?? 0;
+			const promptTokens = input + cacheRead + cacheWrite;
+			totals.latestCacheHitRate = promptTokens > 0 ? (cacheRead / promptTokens) * 100 : undefined;
+		} else if (entry.type === "message" && entry.message.role === "toolResult") {
+			usage = entry.message.usage;
+		} else if (entry.type === "compaction" || entry.type === "branch_summary") {
+			usage = entry.usage;
+		}
+		if (!usage) continue;
+
+		totals.input += usage.input ?? 0;
+		totals.output += usage.output ?? 0;
+		totals.cacheRead += usage.cacheRead ?? 0;
+		totals.cacheWrite += usage.cacheWrite ?? 0;
+		totals.cost += usage.cost?.total ?? 0;
+	}
+
+	return totals;
+}