@howaboua/pi-ask 0.0.17 → 0.0.19

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @howaboua/pi-ask
 
+## 0.0.19
+
+- Requires Node.js 22.19 or newer.
+  - Replaced the TypeBox dependency with Pi's native schema builders and validation.
+
+## 0.0.18
+
+- Requires Pi 1.5 or newer.
+  - Waiting prompts now report Pi's native blocked state. Steering prompts remain non-blocking.
+  - Invalid question arguments now explain how to find the supported format.
+  - Removed custom changelog suppression. Updates use Pi's native notices and `collapseChangelog`.
+
 ## 0.0.17
 
 - - Removed redundant help-call instructions from Ask's help.

package/README.md

@@ -49,6 +49,7 @@ Set either value to `false`, then run `/reload`, to hide that template. The same
 ## TUI controls
 
 The panel uses Pi's active keybindings. The defaults are:
+
 - `Up` / `Down` — move through choices, free text, and comments
 - `Enter` — choose or edit the focused item, or save an edit
 - `Left` / `Right` — move between prompts and the review tab

package/ask/contracts.ts

@@ -1,26 +1,43 @@
-import { StringEnum } from "@earendil-works/pi-ai";
-import { type Static, Type } from "typebox";
+import {
+	arr,
+	bool,
+	lit,
+	obj,
+	oneOf,
+	opt,
+	type Static,
+	str,
+} from "@earendil-works/pi-schema";
 
 const ASK_DELIVERIES = ["wait", "steer"] as const;
 
-const ChoiceSchema = Type.Object({
-	label: Type.String(),
-	description: Type.Optional(Type.String()),
-});
-
-const PromptSchema = Type.Object({
-	title: Type.String(),
-	body: Type.Optional(Type.String()),
-	multiple: Type.Optional(Type.Boolean()),
-	choices: Type.Optional(Type.Array(ChoiceSchema)),
-});
-
-export const AskParameters = Type.Object({
-	help: Type.Optional(Type.Literal(true)),
-	handoff: Type.Optional(Type.Boolean()),
-	prompts: Type.Optional(Type.Array(PromptSchema)),
-	delivery: Type.Optional(StringEnum(ASK_DELIVERIES)),
-});
+const ChoiceSchema = obj(
+	{
+		label: str(),
+		description: opt(str()),
+	},
+	{ open: true },
+);
+
+const PromptSchema = obj(
+	{
+		title: str(),
+		body: opt(str()),
+		multiple: opt(bool()),
+		choices: opt(arr(ChoiceSchema)),
+	},
+	{ open: true },
+);
+
+export const AskParameters = obj(
+	{
+		help: opt({ ...lit(true), type: "boolean" }),
+		handoff: opt(bool()),
+		prompts: opt(arr(PromptSchema)),
+		delivery: opt({ ...oneOf(ASK_DELIVERIES), type: "string" }),
+	},
+	{ open: true },
+);
 
 export type PromptChoice = Static<typeof ChoiceSchema>;
 

package/ask/normalize.ts

@@ -57,7 +57,7 @@ function unknownField(
 	const field = Object.keys(value).find((key) => !fields.includes(key));
 	return field === undefined
 		? undefined
-		: `Unknown ask field ${path}${field}; allowed: ${fields.join(", ")}`;
+		: `Ask doesn't recognise ${path}${field}. Use ${fields.join(", ")}; call ask({}) for the supported format.`;
 }
 
 /** Why a tool call would lose input to normalization, so a misnamed field fails instead of vanishing. */

package/ask/tool.ts

@@ -1,6 +1,6 @@
 import { defineTool } from "@earendil-works/pi-coding-agent";
+import { compile, type Static } from "@earendil-works/pi-schema";
 import { Text } from "@earendil-works/pi-tui";
-import { Check } from "typebox/value";
 import { AskParameters, type AskPrompt } from "./contracts.js";
 import {
 	type AskCoordinatorOptions,
@@ -16,6 +16,8 @@ import {
 	textContent,
 } from "./normalize.js";
 
+const askValidator = compile(AskParameters);
+
 interface BlockedState {
 	id: string;
 	active: boolean;
@@ -57,11 +59,19 @@ export function createAskRuntime({
 			const params = input === undefined ? {} : input;
 			const problem = askInputProblem(params);
 			if (problem) throw new Error(problem);
-			if (!Check(AskParameters, params))
-				throw new Error("Invalid ask arguments; ask({}) returns help");
+			if (!askValidator.check(params))
+				throw new Error(
+					"Ask couldn't read these arguments. Call ask({}) for the supported format.",
+				);
 			return params;
 		},
-		async execute(toolCallId, params, signal, _onUpdate, ctx) {
+		async execute(
+			toolCallId,
+			params: Static<typeof AskParameters>,
+			signal,
+			_onUpdate,
+			ctx,
+		) {
 			if (isAskHelpInput(params)) {
 				return {
 					content: [
@@ -88,7 +98,7 @@ export function createAskRuntime({
 			const { delivery, handoff, prompts } = normalizeAskInput(params);
 			if (prompts.length === 0) {
 				throw new Error(
-					"ask requires at least one prompt with a non-empty title.",
+					"Add at least one prompt with a non-empty title. Call ask({}) for the format.",
 				);
 			}
 			if (!askInComposer && !ctx.hasUI)
@@ -156,8 +166,15 @@ export function createAskRuntime({
 		renderCall(args, theme, context) {
 			if (isAskHelpInput(args))
 				return new Text(theme.fg("toolTitle", theme.bold("ask help")), 0, 0);
-			const count = Array.isArray(args.prompts) ? args.prompts.length : 0;
+			const prompts =
+				args && typeof args === "object" && "prompts" in args
+					? args.prompts
+					: undefined;
+			const count = Array.isArray(prompts) ? prompts.length : 0;
 			const label =
+				args &&
+				typeof args === "object" &&
+				"handoff" in args &&
 				args.handoff === true
 					? "ask handoff "
 					: isSteeringAskInput(args)

package/ask/tui.ts

@@ -34,202 +34,213 @@ export async function askInTui(
 	}: { handoff?: boolean; steering?: boolean; signal?: AbortSignal } = {},
 ): Promise<AskResponse[] | null> {
 	if (!ctx.hasUI || signal?.aborted) return null;
-	return await ctx.ui.custom<AskResponse[] | null>((tui, theme, kb, done) => {
-		let settled = false;
-		const finish = (result: AskResponse[] | null) => {
-			if (settled) return;
-			settled = true;
-			signal?.removeEventListener("abort", abort);
-			done(result);
-		};
-		const abort = () => finish(null);
-		signal?.addEventListener("abort", abort, { once: true });
-		if (signal?.aborted) queueMicrotask(abort);
-		const state: AskUiState = { tab: 0, focus: 0, editing: null };
-		let cached: string[] | undefined;
-		// Keep response lifecycle in one object per prompt. Parallel arrays made tab/default
-		// transitions easy to desynchronise as this tool grows.
-		const promptStates = prompts.map(createPromptState);
-		const editor = new Editor(tui, {
-			borderColor: (text) => theme.fg("accent", text),
-			selectList: {
-				selectedPrefix: (text) => theme.fg("accent", text),
-				selectedText: (text) => theme.fg("accent", text),
-				description: (text) => theme.fg("muted", text),
-				scrollInfo: (text) => theme.fg("dim", text),
-				noMatch: (text) => theme.fg("muted", text),
-			},
-		});
+	return await ctx.ui.custom<AskResponse[] | null>(
+		(tui, theme, kb, done) => {
+			let settled = false;
+			const finish = (result: AskResponse[] | null) => {
+				if (settled) return;
+				settled = true;
+				signal?.removeEventListener("abort", abort);
+				done(result);
+			};
+			const abort = () => finish(null);
+			signal?.addEventListener("abort", abort, { once: true });
+			if (signal?.aborted) queueMicrotask(abort);
+			const state: AskUiState = { tab: 0, focus: 0, editing: null };
+			let cached: { width: number; lines: string[] } | undefined;
+			// Keep response lifecycle in one object per prompt. Parallel arrays made tab/default
+			// transitions easy to desynchronise as this tool grows.
+			const promptStates = prompts.map(createPromptState);
+			const editor = new Editor(tui, {
+				borderColor: (text) => theme.fg("accent", text),
+				selectList: {
+					selectedPrefix: (text) => theme.fg("accent", text),
+					selectedText: (text) => theme.fg("accent", text),
+					description: (text) => theme.fg("muted", text),
+					scrollInfo: (text) => theme.fg("dim", text),
+					noMatch: (text) => theme.fg("muted", text),
+				},
+			});
 
-		const reviewTab = () => prompts.length;
-		const current = () => prompts[state.tab];
-		const currentPromptState = () => promptStates[state.tab];
-		const choices = () => current()?.choices ?? [];
-		const isReview = () => state.tab === reviewTab();
-		const count = () => choices().length + 2;
-		const refresh = () => {
-			cached = undefined;
-			tui.requestRender();
-		};
-		const responded = (index: number) =>
-			promptStateResponded(promptStates[index]);
-		const setTab = (next: number) => {
-			state.tab = Math.max(0, Math.min(reviewTab(), next));
-			state.focus = 0;
-			state.editing = null;
-			editor.setText(promptStates[state.tab]?.customText ?? "");
-			refresh();
-		};
-		const saveCustom = (submittedText = editor.getText()) => {
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!prompt || !promptState) return;
-			saveCustomSelection(prompt, promptState, submittedText);
-		};
-		const saveEditing = (submittedText = editor.getText()) => {
-			const promptState = currentPromptState();
-			if (!promptState) return;
-			if (state.editing === "comment") saveComment(promptState, submittedText);
-			else saveCustom(submittedText);
-		};
-		const startEditing = (kind: EditingKind) => {
-			const promptState = currentPromptState();
-			if (!promptState) return;
-			state.editing = kind;
-			editor.setText(
-				kind === "comment" ? promptState.comment : promptState.customText,
-			);
-			refresh();
-		};
-		const selectOther = () => {
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!prompt || !promptState) return;
-			if (prompt.multiple && promptState.customEnabled) {
-				clearCustomSelection(promptState);
+			const reviewTab = () => prompts.length;
+			const current = () => prompts[state.tab];
+			const currentPromptState = () => promptStates[state.tab];
+			const choices = () => current()?.choices ?? [];
+			const isReview = () => state.tab === reviewTab();
+			const count = () => choices().length + 2;
+			const refresh = () => {
+				cached = undefined;
+				tui.requestRender();
+			};
+			const responded = (index: number) =>
+				promptStateResponded(promptStates[index]);
+			const setTab = (next: number) => {
+				state.tab = Math.max(0, Math.min(reviewTab(), next));
+				state.focus = 0;
+				state.editing = null;
+				editor.setText(promptStates[state.tab]?.customText ?? "");
+				refresh();
+			};
+			const saveCustom = (submittedText = editor.getText()) => {
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!prompt || !promptState) return;
+				saveCustomSelection(prompt, promptState, submittedText);
+			};
+			const saveEditing = (submittedText = editor.getText()) => {
+				const promptState = currentPromptState();
+				if (!promptState) return;
+				if (state.editing === "comment")
+					saveComment(promptState, submittedText);
+				else saveCustom(submittedText);
+			};
+			const startEditing = (kind: EditingKind) => {
+				const promptState = currentPromptState();
+				if (!promptState) return;
+				state.editing = kind;
+				editor.setText(
+					kind === "comment" ? promptState.comment : promptState.customText,
+				);
 				refresh();
-				return;
-			}
-			startEditing("other");
-		};
-		const advance = () => setTab(state.tab + 1);
-		const advanceWithDefault = () => {
-			if (!isReview() && !responded(state.tab)) saveCustom("");
-			advance();
-		};
-		editor.onSubmit = (value) => {
-			saveEditing(value);
-			state.editing = null;
-			refresh();
-		};
-		const pick = (index: number) => {
-			const choice = choices()[index];
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!choice || !promptState) return;
-			pickChoiceSelection(prompt, promptState, choice);
-			refresh();
-		};
-		const handleInput = (data: string) => {
-			if (state.editing) {
-				handleAskEditingInput(data, {
-					advance,
-					editor,
+			};
+			const selectOther = () => {
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!prompt || !promptState) return;
+				if (prompt.multiple && promptState.customEnabled) {
+					clearCustomSelection(promptState);
+					refresh();
+					return;
+				}
+				startEditing("other");
+			};
+			const advance = () => setTab(state.tab + 1);
+			const advanceWithDefault = () => {
+				if (!isReview() && !responded(state.tab)) saveCustom("");
+				advance();
+			};
+			editor.onSubmit = (value) => {
+				saveEditing(value);
+				state.editing = null;
+				refresh();
+			};
+			const pick = (index: number) => {
+				const choice = choices()[index];
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!choice || !promptState) return;
+				pickChoiceSelection(prompt, promptState, choice);
+				refresh();
+			};
+			const handleInput = (data: string) => {
+				if (state.editing) {
+					handleAskEditingInput(data, {
+						advance,
+						editor,
+						keybindings: kb,
+						refresh,
+						saveEditing,
+						state,
+					});
+					return;
+				}
+				if (
+					handleAskNavigationInput(data, {
+						done: finish,
+						isReview,
+						keybindings: kb,
+						promptStates,
+						prompts,
+						setTab,
+						state,
+					})
+				) {
+					return;
+				}
+				handleAskPromptInput(data, {
+					advanceWithDefault,
+					count,
+					choices,
 					keybindings: kb,
+					pick,
 					refresh,
-					saveEditing,
+					selectOther,
+					startEditingComment: () => startEditing("comment"),
 					state,
 				});
-				return;
-			}
-			if (
-				handleAskNavigationInput(data, {
-					done: finish,
-					isReview,
-					keybindings: kb,
-					promptStates,
-					prompts,
-					setTab,
-					state,
-				})
-			) {
-				return;
-			}
-			handleAskPromptInput(data, {
-				advanceWithDefault,
-				count,
-				choices,
-				keybindings: kb,
-				pick,
-				refresh,
-				selectOther,
-				startEditingComment: () => startEditing("comment"),
-				state,
-			});
-		};
-		const render = (width: number) => {
-			if (cached) return cached;
-			const lines: string[] = [];
-			const add: AddLine = (line = "") =>
-				lines.push(truncateToWidth(line, width));
-			add(theme.fg("accent", "─".repeat(width)));
-			add(
-				renderAskTabs({
-					handoff,
-					prompts,
-					responded,
-					steering,
-					tab: state.tab,
-					theme,
-				}),
-			);
-			add();
-			if (isReview()) {
-				renderAskReview({
-					add,
-					handoff,
-					keybindings: kb,
-					promptStates,
-					prompts,
-					theme,
-					width,
-				});
-			} else {
-				const prompt = current();
-				if (prompt) {
-					renderAskPrompt({
+			};
+			const render = (width: number) => {
+				if (cached?.width === width) return cached.lines;
+				const lines: string[] = [];
+				const add: AddLine = (line = "") =>
+					lines.push(truncateToWidth(line, width));
+				add(theme.fg("accent", "─".repeat(width)));
+				add(
+					renderAskTabs({
+						handoff,
+						prompts,
+						responded,
+						steering,
+						tab: state.tab,
+						theme,
+					}),
+				);
+				add();
+				if (isReview()) {
+					renderAskReview({
 						add,
-						editor,
 						handoff,
-						isEditing: state.editing,
 						keybindings: kb,
-						choices: choices(),
-						prompt,
-						promptState: currentPromptState(),
-						state,
+						promptStates,
+						prompts,
 						theme,
 						width,
 					});
+				} else {
+					const prompt = current();
+					if (prompt) {
+						renderAskPrompt({
+							add,
+							editor,
+							handoff,
+							isEditing: state.editing,
+							keybindings: kb,
+							choices: choices(),
+							prompt,
+							promptState: currentPromptState(),
+							state,
+							theme,
+							width,
+						});
+					}
 				}
-			}
-			add(theme.fg("accent", "─".repeat(width)));
-			cached = lines;
-			return lines;
-		};
-		return {
-			get focused() {
-				return editor.focused;
-			},
-			set focused(value: boolean) {
-				editor.focused = value;
-				cached = undefined;
-			},
-			render,
-			handleInput,
-			dispose: () => signal?.removeEventListener("abort", abort),
-			invalidate: () => {
-				cached = undefined;
-			},
-		};
-	});
+				add(theme.fg("accent", "─".repeat(width)));
+				cached = { width, lines };
+				return lines;
+			};
+			return {
+				get focused() {
+					return editor.focused;
+				},
+				set focused(value: boolean) {
+					editor.focused = value;
+					cached = undefined;
+				},
+				render,
+				handleInput,
+				dispose: () => signal?.removeEventListener("abort", abort),
+				invalidate: () => {
+					cached = undefined;
+				},
+			};
+		},
+		steering
+			? undefined
+			: {
+					blocked: {
+						kind: "question",
+						message: handoff ? "Human action needed" : "Waiting for input",
+					},
+				},
+	);
 }

package/biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.6.6/schema.json",
 	"vcs": {
 		"enabled": true,
 		"clientKind": "git",

package/index.ts

@@ -16,7 +16,6 @@ import {
 import { isAskHelpInput, isSteeringAskInput } from "./ask/normalize.js";
 import { PENDING_ASK_ENTRY_TYPE, readPendingAsks } from "./ask/pending.js";
 import { createAskRuntime, createAskTool } from "./ask/tool.js";
-import registerPackageChangelog from "./changelog.js";
 
 export { createAskTool } from "./ask/tool.js";
 
@@ -28,7 +27,6 @@ const CODE_MODE_MODULE = `${CODE_MODE_PACKAGE}/code-mode`;
 const DEVELOPER_MESSAGES_MODULE = `${CODE_MODE_PACKAGE}/developer-messages`;
 
 export default async function humanInTheLoop(pi: ExtensionAPI): Promise<void> {
-	registerPackageChangelog(pi);
 	const trySendCodexDeveloperMessage = await loadCodexDeveloperMessageSender();
 	let gpt = false;
 	const askRuntime = createAskRuntime({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howaboua/pi-ask",
-	"version": "0.0.17",
+	"version": "0.0.19",
 	"description": "Interactive decisions, review triage, and human handoffs for Pi.",
 	"type": "module",
 	"license": "MIT",
@@ -23,7 +23,7 @@
 		"handoff"
 	],
 	"engines": {
-		"node": ">=20.6.0"
+		"node": ">=22.19.0"
 	},
 	"publishConfig": {
 		"access": "public"
@@ -36,7 +36,6 @@
 		"LICENSE",
 		"tsconfig.json",
 		"biome.json",
-		"changelog.ts",
 		"CHANGELOG.md"
 	],
 	"pi": {
@@ -45,11 +44,10 @@
 		]
 	},
 	"peerDependencies": {
-		"@howaboua/pi-codex-conversion": ">=4.0.5",
+		"@howaboua/pi-codex-conversion": ">=4.0.10",
 		"@earendil-works/pi-ai": ">=1.0.0",
-		"@earendil-works/pi-coding-agent": ">=1.0.0",
-		"@earendil-works/pi-tui": ">=1.0.0",
-		"typebox": "*"
+		"@earendil-works/pi-coding-agent": ">=1.5.0",
+		"@earendil-works/pi-tui": ">=1.0.0"
 	},
 	"peerDependenciesMeta": {
 		"@howaboua/pi-codex-conversion": {
@@ -57,12 +55,11 @@
 		}
 	},
 	"devDependencies": {
-		"@howaboua/pi-codex-conversion": "4.0.5",
-		"@biomejs/biome": "^2.6.3",
-		"@earendil-works/pi-ai": "1.4.0",
-		"@earendil-works/pi-coding-agent": "1.4.0",
-		"@earendil-works/pi-tui": "1.4.0",
-		"typebox": "1.4.3",
+		"@howaboua/pi-codex-conversion": "4.0.10",
+		"@biomejs/biome": "^2.6.6",
+		"@earendil-works/pi-ai": "1.5.2",
+		"@earendil-works/pi-coding-agent": "1.5.2",
+		"@earendil-works/pi-tui": "1.5.2",
 		"typescript": "^7.0.2"
 	},
 	"scripts": {
@@ -74,5 +71,8 @@
 		"pack:dry": "npm pack --dry-run"
 	},
 	"main": "index.ts",
-	"exports": "./index.ts"
+	"exports": "./index.ts",
+	"dependencies": {
+		"@earendil-works/pi-schema": "1.5.2"
+	}
 }

package/prompts/fold.md

@@ -11,6 +11,7 @@ $ARGUMENTS
 If no material follows the command, use the most recent lengthy report or structured list in the conversation.
 
 Call `ask` once with one prompt per independently decidable item:
+
 - Keep the title short.
 - Preserve concrete evidence, consequences, and recommendations in the body.
 - Use the source's natural choices. For review findings, default to Fix, Defer, and Reject.

package/prompts/grill.md

@@ -11,6 +11,7 @@ $ARGUMENTS
 Use the working directory, web search, available skills, and any relevant tools to understand the thing before asking. Prefer finding answers yourself over asking me.
 
 Loop until ask is dismissed. There is no round limit:
+
 1. Investigate the relevant context.
 2. Use ask for the next set of decisions.
 3. After the first answer round, create docs/<short-name>.md.
@@ -18,6 +19,7 @@ Loop until ask is dismissed. There is no round limit:
 5. Keep updating the markdown file after each round.
 
 The markdown file is the current plan, not a transcript. Keep it ready to use if I stop at any point. Include:
+
 - goal
 - agreed decisions
 - important tradeoffs
@@ -28,6 +30,7 @@ The markdown file is the current plan, not a transcript. Keep it ready to use if
 Do not log every question and answer.
 
 When ask is dismissed, the grilling session is done. Then:
+
 - give a short summary of what was agreed
 - open the markdown file with $EDITOR if available
 - print the file path

package/changelog.ts

@@ -1,337 +0,0 @@
-// Generated extension packages copy this file during changelog:extensions.
-
-import { randomUUID } from "node:crypto";
-import { readFileSync } from "node:fs";
-import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-	DynamicBorder,
-	type ExtensionAPI,
-	getAgentDir,
-	getMarkdownTheme,
-} from "@earendil-works/pi-coding-agent";
-import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
-
-const ENTRY_TYPE = "@howaboua/pi-stuff/changelog";
-const REGISTRATION_CHANNEL = "@howaboua/pi-stuff/changelog/register/v1";
-const STATE_FILENAME = "howaboua-pi-stuff-changelog.json";
-const SUPPRESS_KEY = "suppress";
-const LOCK_STALE_MS = 30_000;
-const LOCK_TIMEOUT_MS = 2_000;
-
-interface PackageMetadata {
-	name: string;
-	version: string;
-}
-
-interface PackageRegistration extends PackageMetadata {
-	changelogPath: string;
-}
-
-interface RegistrationEvent {
-	accept: () => void;
-	registration: PackageRegistration;
-}
-
-interface ChangelogEntry {
-	content: string;
-	version: string;
-}
-
-interface ChangelogEntryData {
-	markdown: string;
-}
-
-type ChangelogState = Record<string, boolean | string>;
-
-function packageRegistration(): PackageRegistration {
-	const packageDirectory = fileURLToPath(new URL(".", import.meta.url));
-	const metadata = JSON.parse(
-		readFileSync(join(packageDirectory, "package.json"), "utf8"),
-	) as Partial<PackageMetadata>;
-	if (typeof metadata.name !== "string" || typeof metadata.version !== "string")
-		throw new Error(`Invalid package metadata in ${packageDirectory}`);
-	return {
-		name: metadata.name,
-		version: metadata.version,
-		changelogPath: join(packageDirectory, "CHANGELOG.md"),
-	};
-}
-
-function isRegistrationEvent(value: unknown): value is RegistrationEvent {
-	if (!value || typeof value !== "object") return false;
-	const event = value as Partial<RegistrationEvent>;
-	return (
-		typeof event.accept === "function" &&
-		typeof event.registration?.name === "string" &&
-		typeof event.registration.version === "string" &&
-		typeof event.registration.changelogPath === "string"
-	);
-}
-
-function parseChangelog(markdown: string): ChangelogEntry[] {
-	const entries: ChangelogEntry[] = [];
-	let currentLines: string[] = [];
-	let currentVersion: string | undefined;
-
-	for (const line of markdown.split("\n")) {
-		const version = line.match(/^##\s+\[?(\d+\.\d+\.\d+)\]?(?:\s.*)?$/)?.[1];
-		if (version) {
-			if (currentVersion)
-				entries.push({
-					content: currentLines.join("\n").trim(),
-					version: currentVersion,
-				});
-			currentVersion = version;
-			currentLines = [line];
-		} else if (currentVersion) {
-			currentLines.push(line);
-		}
-	}
-
-	if (currentVersion)
-		entries.push({
-			content: currentLines.join("\n").trim(),
-			version: currentVersion,
-		});
-	return entries;
-}
-
-function compareVersions(left: string, right: string): number {
-	const leftParts = left.split(".").map(Number);
-	const rightParts = right.split(".").map(Number);
-	for (let index = 0; index < 3; index++) {
-		const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
-		if (difference !== 0) return difference;
-	}
-	return 0;
-}
-
-function isStableVersion(version: string): boolean {
-	return /^\d+\.\d+\.\d+$/.test(version);
-}
-
-function statePath(): string {
-	return join(getAgentDir(), STATE_FILENAME);
-}
-
-async function readState(path: string): Promise<ChangelogState> {
-	let text: string;
-	try {
-		text = await readFile(path, "utf8");
-	} catch (error) {
-		if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
-		throw error;
-	}
-	const parsed = JSON.parse(text) as unknown;
-	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-		throw new Error(`${path} must contain a JSON object`);
-	for (const [name, value] of Object.entries(parsed)) {
-		if (name === SUPPRESS_KEY) {
-			if (typeof value !== "boolean")
-				throw new Error(`${path} ${SUPPRESS_KEY} must be a boolean`);
-		} else if (typeof value !== "string") {
-			throw new Error(`${path} version for ${name} must be a string`);
-		}
-	}
-	return parsed as ChangelogState;
-}
-
-async function acquireLock(path: string): Promise<() => Promise<void>> {
-	const deadline = Date.now() + LOCK_TIMEOUT_MS;
-	while (true) {
-		try {
-			await mkdir(path);
-			return () => rm(path, { force: true, recursive: true });
-		} catch (error) {
-			if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
-			const info = await stat(path).catch(() => undefined);
-			if (info && Date.now() - info.mtimeMs > LOCK_STALE_MS) {
-				await rm(path, { force: true, recursive: true });
-				continue;
-			}
-			if (Date.now() >= deadline)
-				throw new Error(`Timed out waiting for ${path}`);
-			await new Promise((resolve) => setTimeout(resolve, 20));
-		}
-	}
-}
-
-async function writeState(path: string, state: ChangelogState): Promise<void> {
-	await mkdir(dirname(path), { mode: 0o700, recursive: true });
-	const temporaryPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
-	try {
-		const ordered = Object.fromEntries(
-			Object.entries(state).sort(([left], [right]) =>
-				left.localeCompare(right),
-			),
-		);
-		await writeFile(temporaryPath, `${JSON.stringify(ordered, null, 2)}\n`, {
-			encoding: "utf8",
-			mode: 0o600,
-		});
-		await rename(temporaryPath, path);
-	} catch (error) {
-		await rm(temporaryPath, { force: true });
-		throw error;
-	}
-}
-
-function packageMarkdown(
-	registration: PackageRegistration,
-	entries: ChangelogEntry[],
-): string {
-	const body = (entry: ChangelogEntry) =>
-		entry.content
-			.replace(/^##[^\n]*\n*/, "")
-			.replace(/^###\s+(?:Changes|Minor Changes|Patch Changes)\s*\n*/gim, "")
-			.replace(/^###\s+(.+)$/gm, "**$1**");
-	if (entries.length === 1) {
-		const [entry] = entries;
-		if (!entry) return "";
-		return `## ${registration.name} ${entry.version}\n\n${body(entry)}`;
-	}
-	return [
-		`## ${registration.name}`,
-		...entries.map((entry) => `**${entry.version}**\n\n${body(entry)}`),
-	].join("\n\n");
-}
-
-async function claimUpdates(
-	registrations: Iterable<PackageRegistration>,
-): Promise<{ errors: string[]; markdown?: string }> {
-	const stableRegistrations = [...registrations]
-		.filter((registration) => isStableVersion(registration.version))
-		.sort((left, right) => left.name.localeCompare(right.name));
-	if (stableRegistrations.length === 0) return { errors: [] };
-	const path = statePath();
-	await mkdir(dirname(path), { mode: 0o700, recursive: true });
-	const release = await acquireLock(`${path}.lock`);
-	try {
-		const state = await readState(path);
-		const errors: string[] = [];
-		const sections: string[] = [];
-		let changed = false;
-		if (state[SUPPRESS_KEY] === true) {
-			for (const registration of stableRegistrations) {
-				const seenVersion = state[registration.name];
-				if (
-					typeof seenVersion !== "string" ||
-					compareVersions(registration.version, seenVersion) > 0
-				) {
-					state[registration.name] = registration.version;
-					changed = true;
-				}
-			}
-			if (changed) await writeState(path, state);
-			return { errors };
-		}
-		for (const registration of stableRegistrations) {
-			const seenVersion = state[registration.name];
-			if (
-				typeof seenVersion === "string" &&
-				compareVersions(registration.version, seenVersion) <= 0
-			)
-				continue;
-			try {
-				const entries = parseChangelog(
-					await readFile(registration.changelogPath, "utf8"),
-				).filter(
-					(entry) =>
-						compareVersions(entry.version, registration.version) <= 0 &&
-						(typeof seenVersion === "string"
-							? compareVersions(entry.version, seenVersion) > 0
-							: entry.version === registration.version),
-				);
-				if (entries.length === 0) {
-					errors.push(
-						`No ${registration.version} changelog entry found for ${registration.name}`,
-					);
-					continue;
-				}
-				sections.push(packageMarkdown(registration, entries));
-				state[registration.name] = registration.version;
-				changed = true;
-			} catch (error) {
-				errors.push(
-					`Could not read the ${registration.name} changelog: ${error instanceof Error ? error.message : String(error)}`,
-				);
-			}
-		}
-		if (changed) await writeState(path, state);
-		return {
-			errors,
-			...(sections.length > 0 ? { markdown: sections.join("\n\n") } : {}),
-		};
-	} finally {
-		await release();
-	}
-}
-
-function registerCoordinator(
-	pi: ExtensionAPI,
-	registration: PackageRegistration,
-): void {
-	let accepted = false;
-	pi.events.emit(REGISTRATION_CHANNEL, {
-		registration,
-		accept: () => {
-			accepted = true;
-		},
-	} satisfies RegistrationEvent);
-	if (accepted) return;
-
-	const registrations = new Map([[registration.name, registration]]);
-	pi.events.on(REGISTRATION_CHANNEL, (value) => {
-		if (!isRegistrationEvent(value)) return;
-		registrations.set(value.registration.name, value.registration);
-		value.accept();
-	});
-	pi.registerEntryRenderer<ChangelogEntryData>(
-		ENTRY_TYPE,
-		(entry, _options, theme) => {
-			if (!entry.data) return undefined;
-			const container = new Container();
-			container.addChild(new DynamicBorder());
-			container.addChild(
-				new Text(theme.bold(theme.fg("accent", "What's New")), 1, 0),
-			);
-			container.addChild(new Spacer(1));
-			container.addChild(
-				new Markdown(entry.data.markdown.trim(), 1, 0, getMarkdownTheme()),
-			);
-			container.addChild(new Spacer(1));
-			container.addChild(new DynamicBorder());
-			return container;
-		},
-	);
-	pi.on("session_start", async (event, ctx) => {
-		if (event.reason === "reload" || ctx.mode !== "tui") return;
-		if (
-			ctx.sessionManager
-				.getEntries()
-				.some((entry) =>
-					["branch_summary", "compaction", "message"].includes(entry.type),
-				)
-		)
-			return;
-		try {
-			const update = await claimUpdates(registrations.values());
-			if (update.markdown)
-				pi.appendEntry<ChangelogEntryData>(ENTRY_TYPE, {
-					markdown: update.markdown,
-				});
-			for (const error of update.errors) ctx.ui.notify(error, "warning");
-		} catch (error) {
-			ctx.ui.notify(
-				`Could not update Howaboua changelog state: ${error instanceof Error ? error.message : String(error)}`,
-				"warning",
-			);
-		}
-	});
-}
-
-export default function howabouaPackageChangelog(pi: ExtensionAPI): void {
-	registerCoordinator(pi, packageRegistration());
-}