pi-posthorse 0.4.3 → 0.4.5

package/README.md

@@ -11,7 +11,7 @@ Pi owns the persisted boundary. Posthorse owns the policy: stable window guidanc
 ## Requirements
 
 - Node `>=22.19.0`.
-- The `fitchmultz/pi` fork. The current tested revision is `f9b06177e565f70cd243a785d088d1c491830dbd` (Pi `0.85.0`). Posthorse needs the fork's native `context_window` entries, its `session_before_auto_compact` hook, and `ctx.getCompactionSettings()`.
+- The `fitchmultz/pi` fork. The CI baseline is `f9b06177e565f70cd243a785d088d1c491830dbd` (Pi `0.85.0`). Posthorse needs the fork's native `context_window` entries, its `session_before_auto_compact` hook, and `ctx.getCompactionSettings()`.
 - Official, unpatched Pi is unsupported. Posthorse reports a clear extension error at session start and cannot operate; Pi itself keeps running.
 
 ## Install
@@ -40,7 +40,7 @@ pi -e git:github.com/fitchmultz/pi-posthorse              # try it for one run w
 
 Update with `pi update npm:pi-posthorse` or `pi update --extensions`; move a pinned Git install with `pi install git:github.com/fitchmultz/pi-posthorse@<new tag>`. Uninstall with `pi remove npm:pi-posthorse` (or the Git source you installed). Removing the package leaves `.pi/notes` and Pi's session history in place.
 
-After installing or updating Posthorse, run `/reload` in existing Pi sessions or restart them to load the new version.
+Restart Pi after installing or updating Posthorse to load the new extension code.
 
 Keep exactly one copy loaded. `pi list` shows every package source; if an older entry such as `git:github.com/fitchmultz/pi-headroom.git` or a local checkout is still listed, `pi remove` it before installing the npm package, otherwise two copies register the same tools and compete for the same rollover hook.
 
@@ -54,6 +54,8 @@ Keep exactly one copy loaded. `pi list` shows every package source; if an older
 6. **Bounded recovery record.** The automatic handoff keeps direct user inputs, `ask_question` outcomes, visible coordination messages, and the trailing tool batch that no model has consumed yet (call arguments, bounded result text, and the entry ids to recover the rest). A clearly labeled, possibly stale older checkpoint comes last, after the current inputs and unseen results. Older assistant prose and consumed tool results are not treated as state. Newly submitted input stays separate and is saved after the boundary, not copied into the handoff.
 7. **`notes` and `history`.** Notes live with the repository root, shared across linked worktrees. History searches normalized transcript text and returns stored images for a requested entry.
 
+At turn end, Posthorse checks whether usage is in the reminder band before explicitly looking up the full branch. Context filtering skips its branch lookup when model input contains neither `posthorse-reminder` nor legacy `headroom-reminder` messages. History searches, reads, and recovery remain available with no new limits.
+
 Automatic recovery is an emergency input record, not proof of progress. The fresh model is told to restore notes and todo state, inspect history when needed, and verify live state before taking stateful or external action.
 
 ## Settings
@@ -73,6 +75,10 @@ Only one automatic compaction or rollover policy extension should be enabled at
 - `notes({ op, ... })`: `list`, `read` (paged; `offset` continues), `write` (empty content clears), `append` (one atomic newline-terminated record), `search` (excerpts centered on the match)
 - `history({ op, ... })`: `search`, `read`; results carry native window ids, reads return stored images with the first page and the next character offset when text remains
 
+In the TUI, tools use Pi's native expandable cards. Collapsed cards show the operation and target, a short content preview, and counts or page ranges with the next offset when more remains. Expand with Pi's tool-output shortcut (`Ctrl+O` by default), or click the card's header or body in fullscreen mode. Expanded cards show the complete returned page and its metadata, not content the tool has not fetched yet. Writes and context requests also show the submitted content or handoff.
+
+Committed context-window messages and checkpoint reminders are compact, expandable cards too. The `new_context` tool card describes a request; only the committed context-window message says a fresh window has started.
+
 Read pages, including returned images, shrink to the context that is actually left. Before usage is known, they reserve prompt/tool overhead and leave half the rest free. Unsafe pages are refused with the offset preserved; call `new_context` and retry.
 
 `history search` puts matching original content before recovery material: handoffs, compaction and branch summaries, checkpoint reminders, and `notes`, `new_context`, and `history` calls/results. Ordinary prose or another tool call in the same assistant entry keeps its priority when that content matches. Every entry remains searchable; `history read` returns the complete normalized entry, including any recovery content omitted from a search excerpt.
@@ -103,4 +109,4 @@ npm run check
 PI_FORK=../pi scripts/integration.sh   # loads the real extension into the fork's test harness (fork built)
 ```
 
-`npm run check` type-checks `index.ts` and the unit tests; the integration test runs inside the fork's harness. CI runs the unit tests on Node 22.19 and 24, `npm audit`, `npm pack --dry-run`, and the integration job against the pinned fork revision.
+`npm run check` type-checks the extension, renderers, and tests. Tests cover reminder policy, notes/history behavior, and real native card components, including width, expansion, and legacy results. The pinned Pi 0.85.0 SDK's unbundled entry imports an undeclared server package, so test-only resolution loads its shipped native bundle. Integration tests run inside the fork's harness and cover rollover and history recovery; use a disposable built fork checkout because the script briefly copies the test into its test directory. CI runs the unit tests on Node 22.19 and 24, `npm audit`, `npm pack --dry-run`, and the integration job against the pinned fork revision.

package/index.ts

@@ -20,6 +20,7 @@ import { dirname, isAbsolute, join, normalize, relative, resolve, sep } from "no
 import { createInterface } from "node:readline";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
+import { registerPosthorseMessages, toolCards, type PosthorseDisplay } from "./ui.ts";
 
 const REMINDER_BUFFER_TOKENS = 32_000;
 /** Absolute ceiling for handoffs and read pages; pages shrink to the live remaining budget. */
@@ -86,7 +87,7 @@ type EntryLike = {
 };
 
 type WindowedEntry = { entry: EntryLike; windowId: string; text: string; images: ImageLike[] };
-type HistoryHit = { id: string; text: string; priority: 0 | 1 };
+type HistoryHit = { id: string; text: string; headerLength: number; priority: 0 | 1 };
 type RecoveryRecord = {
 	id: string;
 	timestamp: string;
@@ -159,8 +160,8 @@ function textOf(message: MessageLike): string {
 		.join("\n");
 }
 
-function textResult(text: string, images: ImageLike[] = []) {
-	return { content: [{ type: "text" as const, text }, ...images], details: undefined };
+function textResult(text: string, images: ImageLike[] = [], display?: PosthorseDisplay) {
+	return { content: [{ type: "text" as const, text }, ...images], details: display };
 }
 
 /**
@@ -263,10 +264,12 @@ function historyHit(item: WindowedEntry, query: string, source = ""): HistoryHit
 			matchIndex = text.toLowerCase().indexOf(query);
 		}
 	}
+	const header = `${source ? `${source} ` : ""}${entry.timestamp ?? ""} [window ${item.windowId}] [${entry.id}] `;
 	return {
 		id: entry.id!,
 		priority,
-		text: `${source ? `${source} ` : ""}${entry.timestamp ?? ""} [window ${item.windowId}] [${entry.id}] ${excerptAround(text, matchIndex, 100, 400)}`,
+		text: `${header}${excerptAround(text, matchIndex, 100, 400)}`,
+		headerLength: header.length,
 	};
 }
 
@@ -678,6 +681,7 @@ Automatic handoffs are emergency recovery records, not proof of current state. R
 }
 
 export default function (pi: ExtensionAPI) {
+	registerPosthorseMessages(pi);
 	const activeToolTokens = () => {
 		const active = new Set(pi.getActiveTools());
 		return pi
@@ -719,6 +723,10 @@ export default function (pi: ExtensionAPI) {
 		if (!usage || usage.tokens == null || usage.contextWindow <= 0) return;
 		const budget = budgetFor(native, usage.contextWindow);
 		if (!budget || !budget.enabled || !budget.supported) return;
+		if (usage.tokens >= budget.rolloverAt) return;
+		const reminderBuffer = Math.min(REMINDER_BUFFER_TOKENS, Math.floor(budget.usable * 0.1));
+		const remindAt = budget.rolloverAt - reminderBuffer;
+		if (usage.tokens < remindAt) return;
 
 		const branch = ctx.sessionManager.getBranch() as EntryLike[];
 		const fingerprint: ReminderFingerprint = {
@@ -726,10 +734,7 @@ export default function (pi: ExtensionAPI) {
 			contextWindow: budget.contextWindow,
 			reserveTokens: budget.reserveTokens,
 		};
-		if (usage.tokens >= budget.rolloverAt) return;
-		const reminderBuffer = Math.min(REMINDER_BUFFER_TOKENS, Math.floor(budget.usable * 0.1));
-		const remindAt = budget.rolloverAt - reminderBuffer;
-		if (usage.tokens < remindAt || hasReminder(branch, fingerprint)) return;
+		if (hasReminder(branch, fingerprint)) return;
 		pi.sendMessage(
 			{
 				customType: REMINDER_TYPE,
@@ -749,6 +754,7 @@ export default function (pi: ExtensionAPI) {
 		const windowId = marker?.role === "custom" ? (marker.details as { windowId?: unknown } | undefined)?.windowId : "initial";
 		if (typeof windowId !== "string") return;
 		const native = nativeContext(ctx);
+		if (!event.messages.some((message) => message.role === "custom" && isReminderType(message.customType))) return;
 		const budget = budgetFor(native);
 		const branch = ctx.sessionManager.getBranch() as EntryLike[];
 		const fingerprint: ReminderFingerprint = {
@@ -779,6 +785,7 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "new_context",
 		label: "New Context",
+		...toolCards("new_context"),
 		description:
 			"Start a genuinely fresh context window after this tool batch. Earlier conversation leaves active context without a generated summary but remains recoverable through history. Pass concise continuation state in handoff, or save richer state with notes first.",
 		promptSnippet: "start a fresh context window with an optional atomic handoff",
@@ -805,6 +812,8 @@ export default function (pi: ExtensionAPI) {
 			return {
 				...textResult(
 					"Requested a fresh Pi context after this complete tool batch succeeds. Earlier conversation stays in session history.",
+					[],
+					{ kind: "new-context" },
 				),
 				newContext: { handoff: trimmed },
 			};
@@ -814,6 +823,7 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "get_context_remaining",
 		label: "Context Remaining",
+		...toolCards("get_context_remaining"),
 		description:
 			"Best available native estimate of the context budget: tokens until Pi's automatic rollover line and until the model's hard limit.",
 		promptSnippet: "check the remaining context budget only when needed",
@@ -821,14 +831,20 @@ export default function (pi: ExtensionAPI) {
 		async execute(_id, _params, _signal, _onUpdate, ctx) {
 			const native = nativeContext(ctx);
 			const usage = native.getContextUsage();
-			if (!usage || usage.tokens == null) return textResult("Context usage is not known until the next model response.");
+			if (!usage || usage.tokens == null) return textResult("Context usage is not known until the next model response.", [], { kind: "context" });
 			const n = (value: number) => value.toLocaleString("en-US");
 			const budget = budgetFor(native, usage.contextWindow);
+			const display: PosthorseDisplay = {
+				kind: "context", usage,
+				rollover: !budget?.enabled ? "disabled" : budget.supported ? "enabled" : "unsupported",
+				rolloverAt: budget?.rolloverAt,
+			};
 			const hard = `≈${n(Math.max(0, usage.contextWindow - usage.tokens))} tokens until the hard context limit (${n(usage.tokens)}/${n(usage.contextWindow)} used, ${Math.round(usage.percent ?? 0)}%). Best available native estimate.`;
-			if (!budget?.enabled) return textResult(`Automatic rollover is disabled (Pi compaction.enabled=false). ${hard}`);
-			if (!budget.supported) return textResult(`${unsupportedMessage(budget)} ${hard}`);
+			if (!budget?.enabled) return textResult(`Automatic rollover is disabled (Pi compaction.enabled=false). ${hard}`, [], display);
+			if (!budget.supported) return textResult(`${unsupportedMessage(budget)} ${hard}`, [], display);
 			return textResult(
 				`≈${n(Math.max(0, budget.rolloverAt - usage.tokens))} tokens until automatic rollover (line at ${n(budget.rolloverAt)}); ${hard}`,
+				[], display,
 			);
 		},
 	});
@@ -836,6 +852,7 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "notes",
 		label: "Notes",
+		...toolCards("notes"),
 		description:
 			"Persistent notes in .pi/notes/ that survive context resets. Ops: list, read (paged; pass offset to continue), write (create/replace; empty content clears), append, search (case-insensitive substring over note lines). Inside a Git repository, including nested directories and linked worktrees, notes belong to the main checkout.",
 		promptSnippet: "save and recall durable state that survives context resets",
@@ -872,10 +889,10 @@ export default function (pi: ExtensionAPI) {
 
 			switch (params.op) {
 				case "list": {
-					if (!existsSync(dir)) return textResult("(no notes yet)");
+					if (!existsSync(dir)) return textResult("(no notes yet)", [], { kind: "notes-list", count: 0 });
 					const files: string[] = [];
 					walk(dir, files);
-					return textResult(files.length ? files.map((file) => file.slice(dir.length + 1)).join("\n") : "(no notes yet)");
+					return textResult(files.length ? files.map((file) => file.slice(dir.length + 1)).join("\n") : "(no notes yet)", [], { kind: "notes-list", count: files.length });
 				}
 				case "read": {
 					const relative = requireValue(params.path, "path", params.op);
@@ -889,7 +906,7 @@ export default function (pi: ExtensionAPI) {
 					const end = Math.min(text.length, offset + requirePage(nativeContext(ctx), offset, 0, activeToolTokens()));
 					const more =
 						end < text.length ? `\n[chars ${offset}-${end} of ${text.length}; continue with offset ${end}]` : "";
-					return textResult(`${text.slice(offset, end)}${more}`);
+					return textResult(`${text.slice(offset, end)}${more}`, [], { kind: "note-read", offset, end, total: text.length });
 				}
 				case "write": {
 					const relative = requireValue(params.path, "path", params.op);
@@ -897,7 +914,7 @@ export default function (pi: ExtensionAPI) {
 					const path = safeJoin(relative);
 					mkdirSync(dirname(path), { recursive: true });
 					writeFileSync(path, params.content);
-					return textResult(`Wrote .pi/notes/${relative}`);
+					return textResult(`Wrote .pi/notes/${relative}`, [], { kind: "note-write" });
 				}
 				case "append": {
 					const relative = requireValue(params.path, "path", params.op);
@@ -910,11 +927,11 @@ export default function (pi: ExtensionAPI) {
 					const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
 					const separator = existing && !existing.endsWith("\n") ? "\n" : "";
 					appendFileSync(path, `${separator}${content.replace(/\n?$/, "\n")}`);
-					return textResult(`Appended to .pi/notes/${relative}`);
+					return textResult(`Appended to .pi/notes/${relative}`, [], { kind: "note-append" });
 				}
 				case "search": {
 					const query = requireValue(params.query, "query", params.op).toLowerCase();
-					if (!existsSync(dir)) return textResult("(no notes yet)");
+					if (!existsSync(dir)) return textResult("(no notes yet)", [], { kind: "notes-search", count: 0 });
 					const files: string[] = [];
 					walk(dir, files);
 					const hits: string[] = [];
@@ -928,7 +945,7 @@ export default function (pi: ExtensionAPI) {
 							}
 						}
 					}
-					return textResult(hits.length ? hits.join("\n") : `No notes match "${params.query}".`);
+					return textResult(hits.length ? hits.join("\n") : `No notes match "${params.query}".`, [], { kind: "notes-search", count: hits.length });
 				}
 			}
 		},
@@ -937,6 +954,7 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool({
 		name: "history",
 		label: "History",
+		...toolCards("history"),
 		description:
 			"Search or read normalized session entries, including earlier native context windows. Search prioritizes original content before recovery notes, handoffs, and history lookups; all remain searchable. Current branch by default; all=true searches every project session file. Within each group: newest-modified sessions first, newest entries per session. Reads return stored images and page long text with the next offset.",
 		promptSnippet: "recover earlier conversation that left the active context window",
@@ -955,13 +973,13 @@ export default function (pi: ExtensionAPI) {
 			if (params.op === "search") {
 				const query = requireValue(params.query, "query", params.op).toLowerCase();
 				const limit = params.limit ?? 10;
-				const hits: string[][] = [[], []];
+				const hits: HistoryHit[][] = [[], []];
 				// Forks copy ancestor entries under the same ids into new session files; report each id once.
 				const seen = new Set<string>();
 				const addHit = (hit: HistoryHit | undefined) => {
 					if (!hit || seen.has(hit.id) || hits[hit.priority].length >= limit) return;
 					seen.add(hit.id);
-					hits[hit.priority].push(hit.text);
+					hits[hit.priority].push(hit);
 				};
 
 				if (params.all) {
@@ -987,7 +1005,10 @@ export default function (pi: ExtensionAPI) {
 					}
 				}
 				const results = hits.flat().slice(0, limit);
-				return textResult(results.length ? results.join("\n") : `No history matches "${params.query}".`);
+				return textResult(results.length ? results.map((hit) => hit.text).join("\n") : `No history matches "${params.query}".`, [], {
+					kind: "history-search",
+					entries: results.map((hit) => ({ headerLength: hit.headerLength, length: hit.text.length })),
+				});
 			}
 
 			const id = requireValue(params.id, "id", params.op);
@@ -1001,10 +1022,12 @@ export default function (pi: ExtensionAPI) {
 					offset + requirePage(nativeContext(ctx), offset, offset === 0 ? item.images.length : 0, activeToolTokens()),
 				);
 				const more = end < item.text.length ? `\nMore remains; call history read with id "${id}" and offset ${end}.` : "";
+				const header = `${source ? `${source} ` : ""}${item.entry.timestamp ?? ""} [window ${item.windowId}] [${id}] [chars ${offset}-${end} of ${item.text.length}] `;
 				// Stored images ride along with the first page only.
 				return textResult(
-					`${source ? `${source} ` : ""}${item.entry.timestamp ?? ""} [window ${item.windowId}] [${id}] [chars ${offset}-${end} of ${item.text.length}] ${item.text.slice(offset, end)}${more}`,
+					`${header}${item.text.slice(offset, end)}${more}`,
 					offset === 0 ? item.images : [],
+					{ kind: "history-read", headerLength: header.length, offset, end, total: item.text.length },
 				);
 			};
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-posthorse",
-	"version": "0.4.3",
+	"version": "0.4.5",
 	"type": "module",
 	"description": "Posthorse: fresh context, same journey. Native no-summary context windows for the fitchmultz/pi fork, with sparse budget reminders, handoffs, notes, and history.",
 	"keywords": ["pi-package", "pi-extension", "context", "posthorse", "rollover"],
@@ -9,7 +9,7 @@
 		"url": "git+https://github.com/fitchmultz/pi-posthorse.git"
 	},
 	"license": "MIT",
-	"files": ["index.ts"],
+	"files": ["index.ts", "ui.ts"],
 	"engines": {
 		"node": ">=22.19.0"
 	},
@@ -19,23 +19,28 @@
 	},
 	"scripts": {
 		"check": "tsc --noEmit",
-		"test": "node --test test/posthorse.test.ts",
+		"test": "node --import ./test/pi-loader.ts --test test/*.test.ts",
 		"prepublishOnly": "npm test && npm run check"
 	},
 	"peerDependencies": {
 		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
 		"typebox": "*"
 	},
 	"peerDependenciesMeta": {
 		"@earendil-works/pi-coding-agent": {
 			"optional": true
 		},
+		"@earendil-works/pi-tui": {
+			"optional": true
+		},
 		"typebox": {
 			"optional": true
 		}
 	},
 	"devDependencies": {
 		"@earendil-works/pi-coding-agent": "0.85.0",
+		"@earendil-works/pi-tui": "0.85.0",
 		"typebox": "1.3.7",
 		"typescript": "^5.5.0"
 	}

package/ui.ts

@@ -0,0 +1,180 @@
+import { keyText, type ExtensionAPI, type MessageRenderer, type Theme, type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { Box, MouseRegion, Text, stripTerminalSequences, truncateToWidth, type Component } from "@earendil-works/pi-tui";
+
+/** Display-only facts and offsets into content, never a second copy of a note or history page. */
+export type PosthorseDisplay =
+	| { kind: "context"; usage?: { tokens: number | null; contextWindow: number; percent: number | null }; rollover?: "enabled" | "disabled" | "unsupported"; rolloverAt?: number }
+	| { kind: "notes-list" | "notes-search"; count: number }
+	| { kind: "note-read"; offset: number; end: number; total: number }
+	| { kind: "note-write" | "note-append" | "new-context" }
+	| { kind: "history-search"; entries: Array<{ headerLength: number; length: number }> }
+	| { kind: "history-read"; headerLength: number; offset: number; end: number; total: number };
+
+type ToolName = "notes" | "history" | "get_context_remaining" | "new_context";
+const titles: Record<ToolName, string> = { notes: "Notes", history: "History", get_context_remaining: "Context budget", new_context: "New context" };
+const n = (value: number) => value.toLocaleString("en-US");
+
+function clean(value: string): string {
+	return stripTerminalSequences(value).replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f\ufff9-\ufffb]/g, "");
+}
+function argsOf(value: unknown): Record<string, unknown> {
+	return value && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : {};
+}
+function argument(value: unknown, name: string): string {
+	return typeof value === "string" ? clean(value) : value == null ? "…" : `[invalid ${name}]`;
+}
+function textOf(content: unknown): string {
+	if (typeof content === "string") return content;
+	return Array.isArray(content) ? content.filter((part) => part?.type === "text" && typeof part.text === "string").map((part) => part.text).join("\n") : "";
+}
+function textBlock(text: string, theme: Theme, color: "toolOutput" | "muted" | "dim" | "error" | "warning" = "toolOutput"): Text {
+	return new Text(text ? theme.fg(color, clean(text)) : "", 0, 0);
+}
+function hint(theme: Theme, width: number): string {
+	const key = keyText("app.tools.expand");
+	return truncateToWidth(theme.fg("dim", key ? `… ${key} to expand` : "… details hidden"), width);
+}
+function pageSummary(page: { offset: number; end: number; total: number }): string {
+	if (!page.total) return "Empty note";
+	if (!page.offset && page.end === page.total) return `${n(page.total)} chars · complete`;
+	return `Chars ${n(page.offset)}–${n(page.end)} of ${n(page.total)}${page.end < page.total ? `\nNext offset ${n(page.end)}` : " · final page"}`;
+}
+
+function historySections(raw: string, display: PosthorseDisplay | undefined): Array<{ body: string; header: string }> | undefined {
+	const spans = display?.kind === "history-search" ? display.entries : display?.kind === "history-read" ? [{ headerLength: display.headerLength, length: raw.length }] : undefined;
+	if (!Array.isArray(spans) || !spans.length) return undefined;
+	let start = 0;
+	const sections: Array<{ body: string; header: string }> = [];
+	for (const span of spans) {
+		if (!Number.isInteger(span.headerLength) || !Number.isInteger(span.length) || span.headerLength < 0 || span.headerLength > span.length || start + span.length > raw.length) return undefined;
+		sections.push({ header: raw.slice(start, start + span.headerLength).trimEnd(), body: raw.slice(start + span.headerLength, start + span.length) });
+		start += span.length + 1;
+	}
+	return start === raw.length + 1 ? sections : undefined;
+}
+
+export function toolCards(name: ToolName): Pick<ToolDefinition, "renderCall" | "renderResult"> {
+	return {
+		renderCall(rawArgs, theme, context) {
+			const args = argsOf(rawArgs);
+			const action = name === "notes" || name === "history" ? ` · ${argument(args.op, "op")}` : name === "new_context" ? " · request" : "";
+			const status = context.isError ? " · error" : context.isPartial ? context.executionStarted ? " · running" : " · preparing" : "";
+			const target = args.op === "search" ? ` · “${argument(args.query, "query")}”` : name === "notes" && args.op !== "list" ? ` · ${argument(args.path, "path")}` : name === "history" && args.op === "read" ? ` · ${argument(args.id, "id")}` : "";
+			const label = `${context.isPartial ? "…" : context.expanded ? "▾" : "▸"} ${titles[name]}${action}${status}${target}`;
+			return {
+				invalidate() {},
+				render(width) {
+					const heading = theme.fg(context.isError ? "error" : "toolTitle", theme.bold(label));
+					if (!context.expanded) return [truncateToWidth(heading.replace(/\s+/g, " "), width)];
+					const details = [
+						name === "history" && args.op === "search" ? `Scope: ${args.all === true ? "all project sessions" : "current branch"}` : "",
+						args.offset !== undefined ? `Offset: ${typeof args.offset === "number" ? n(args.offset) : "[invalid offset]"}` : "",
+						args.limit !== undefined ? `Limit: ${typeof args.limit === "number" ? n(args.limit) : "[invalid limit]"}` : "",
+					].filter(Boolean).join(" · ");
+					return [...new Text(heading, 0, 0).render(width), ...textBlock(details, theme, "muted").render(width)];
+				},
+			};
+		},
+		renderResult(result, { expanded, isPartial }, theme, context) {
+			const args = argsOf(context.args);
+			const raw = textOf(result.content);
+			const display = result.details as PosthorseDisplay | undefined;
+			const sections = !context.isError && !isPartial ? historySections(raw, display) : undefined;
+			let summary = "";
+			let body = raw;
+			let color: "toolOutput" | "warning" | "error" = context.isError ? "error" : "toolOutput";
+			if (!context.isError && !isPartial) {
+				switch (display?.kind) {
+					case "context": {
+						const usage = display.usage;
+						if (!usage || usage.tokens == null) { summary = "Context usage unknown"; break; }
+						const hard = `≈${n(Math.max(0, usage.contextWindow - usage.tokens))} tokens to hard limit`;
+						const rollover = display.rollover === "enabled" && display.rolloverAt !== undefined ? `≈${n(Math.max(0, display.rolloverAt - usage.tokens))} tokens to rollover` : `Automatic rollover ${display.rollover ?? "unknown"}`;
+						summary = `${rollover}\n${hard}\n≈${n(usage.tokens)} / ${n(usage.contextWindow)} used${usage.percent == null ? "" : ` (≈${Math.round(usage.percent)}%)`}`;
+						if (display.rollover === "unsupported") color = "warning";
+						break;
+					}
+					case "notes-list": summary = display.count ? `${n(display.count)} note${display.count === 1 ? "" : "s"}` : "No notes yet"; break;
+					case "notes-search": summary = display.count ? `${n(display.count)} matches returned` : "No matches"; break;
+					case "note-read": summary = pageSummary(display); break;
+					case "note-write": summary = args.content === "" ? "Cleared note" : "Saved note"; break;
+					case "note-append": summary = "Appended to note"; break;
+					case "history-search": if (Array.isArray(display.entries) && (!display.entries.length || sections)) summary = `${display.entries.length ? `${n(display.entries.length)} matches` : "No matches"} · ${args.all === true ? "all sessions" : "current branch"}`; break;
+					case "history-read": summary = pageSummary(display); break;
+					case "new-context": summary = "Requested for after the whole tool batch succeeds."; break;
+				}
+			}
+			if (!body.trim()) body = context.isError ? "No error details returned." : isPartial ? "Running…" : name === "notes" && args.op === "read" ? "Empty note" : "No text returned.";
+			const submitted = name === "new_context" && typeof args.handoff === "string" ? `Handoff supplied:\n${args.handoff}` : name === "notes" && (args.op === "write" || args.op === "append") && typeof args.content === "string" ? `Submitted content:\n${args.content || "(empty)"}` : "";
+			const images = Array.isArray(result.content) ? result.content.filter((part) => part.type === "image") : [];
+			const attachment = images.length ? `${images.length} image${images.length === 1 ? "" : "s"} attached${context.showImages ? "" : " (display hidden)"}` : "";
+			const fullText = sections ? new Text(sections.map(({ body, header }) => `${theme.fg("toolOutput", clean(body))}\n${theme.fg("dim", clean(header))}`).join("\n\n"), 0, 0) : textBlock(body, theme, color);
+			const summaryText = textBlock(summary, theme, color);
+			const submittedText = textBlock(submitted, theme);
+			const attachmentText = textBlock(attachment, theme, "muted");
+			// Old results have no spans. Only the preview sheds the known history prefix.
+			const preview = sections ? sections.map(({ body }) => body).join("\n") : name === "history" && !context.isError ? body.replace(/^[^\n]*?\[window [^\]\n]+\] \[[^\]\n]+\](?: \[chars \d+-\d+ of \d+\])? /gm, "") : body;
+			const previewText = textBlock(preview, theme, color);
+			const searchPreviews = sections && display?.kind === "history-search" ? sections.slice(0, 3).map(({ body }) => theme.fg("toolOutput", clean(body).replace(/\s+/g, " "))) : undefined;
+			const summaryOnly = display?.kind === "context" || display?.kind === "new-context" || display?.kind === "note-write" || display?.kind === "note-append" || ((display?.kind === "notes-list" || display?.kind === "notes-search") && display.count === 0) || (display?.kind === "note-read" && display.total === 0) || (display?.kind === "history-search" && Array.isArray(display.entries) && display.entries.length === 0);
+			return {
+				invalidate() {},
+				render(width) {
+					if (expanded) {
+						return [...fullText.render(width), ...attachmentText.render(width), ...(submitted ? ["", ...submittedText.render(width)] : [])];
+					}
+					const summaryRows = summaryText.render(width).slice(0, 5);
+					const previewRows = summaryOnly && !context.isError && !isPartial ? [] : searchPreviews
+						? searchPreviews.map((line) => truncateToWidth(line, width))
+						: previewText.render(width);
+					const shown = previewRows.slice(0, Math.max(0, Math.min(3, 5 - summaryRows.length - (attachment ? 1 : 0))));
+					const hidden = summaryOnly || previewRows.length > shown.length || Boolean(sections || submitted);
+					return [...summaryRows, ...shown, ...(attachment ? [truncateToWidth(theme.fg("muted", attachment), width)] : []), ...(hidden ? [hint(theme, width)] : [])];
+				},
+			};
+		},
+	};
+}
+
+export function registerPosthorseMessages(pi: ExtensionAPI): void {
+	const states = new WeakMap<object, { global: boolean; expanded: boolean }>();
+	const renderer: MessageRenderer = (message, options, theme) => {
+		let state = states.get(message);
+		if (!state || state.global !== options.expanded) {
+			state = { global: options.expanded, expanded: options.expanded };
+			states.set(message, state);
+		}
+		const view = state;
+		const window = message.customType === "context-window";
+		const raw = textOf(message.content);
+		const handoffLabel = "\n\nHandoff from the previous window:\n";
+		const handoffAt = raw.indexOf(handoffLabel);
+		const preview = window ? handoffAt < 0 ? "" : raw.slice(handoffAt + handoffLabel.length) : raw;
+		const fullText = textBlock(raw, theme);
+		const previewText = textBlock(preview, theme);
+		const historyText = textBlock("Earlier conversation remains in history.", theme, "muted");
+		const content: Component = {
+			invalidate() {},
+			render(width) {
+				const padding = Math.min(options.outputPad, Math.max(0, Math.floor((width - 1) / 2)));
+				const inner = Math.max(1, width - padding * 2);
+				const title = `${view.expanded ? "▾" : "▸"} ${window ? "Context window started" : "Checkpoint reminder"}`;
+				const heading = truncateToWidth(theme.fg(window ? "customMessageLabel" : "warning", theme.bold(title)), inner);
+				const body = view.expanded ? fullText.render(inner) : [
+					...(window ? historyText.render(inner).slice(0, 2) : []),
+					...previewText.render(inner).slice(0, window ? 2 : 3),
+					hint(theme, inner),
+				];
+				const box = new Box(padding, 1, (line) => theme.bg("customMessageBg", line));
+				box.addChild({ render: () => [heading, ...body], invalidate() {} });
+				return box.render(width);
+			},
+		};
+		return new MouseRegion(content, (event) => {
+			if (event.type !== "click" || event.button !== "left") return undefined;
+			view.expanded = !view.expanded;
+			return { handled: true };
+		});
+	};
+	for (const type of ["context-window", "posthorse-reminder", "headroom-reminder"]) pi.registerMessageRenderer(type, renderer);
+}