fix(deps): declare host-provided Pi packages as peers and adopt the Pi 0.99.1 host

docs/gentle-shell.md

@@ -15,7 +15,7 @@ The [v2.6.0 release](https://github.com/Gentleman-Programming/gentle-pi/releases
 - The Agents List and Details views preserve the orchestrator/session hierarchy and completion, abort, and lost-exit history. Parent-child queries and notifications have an explicit handoff path, while model, effort, and usage stay observable per task.
 - Named `/gentle:profiles` atomically route the orchestrator separately from packaged and review roles; see the [technical reference](readme-reference.md#agent-model-profiles) for the profile model.
 
-The source checkout prepares `gentle-pi` `3.7.0` with a package-local Gentle AI `v3.7.0` pin; this does not imply that the package release has been published.
+The source checkout prepares `gentle-pi` `3.7.1` with a package-local Gentle AI `v3.7.0` pin; this does not imply that the package release has been published.
 
 ## Shell interactions and runtime behavior
 

docs/readme-reference.md

@@ -157,11 +157,11 @@ This installs the current npm release; select an explicit version if you need a
 
 ### Source checkout
 
-This checkout declares `gentle-pi` `3.7.0` with a package-local Gentle AI `v3.7.0` pin. Checkout metadata alone is not proof of npm publication; verify the registry version and its release workflow.
+This checkout declares `gentle-pi` `3.7.1` with a package-local Gentle AI `v3.7.0` pin. Checkout metadata alone is not proof of npm publication; verify the registry version and its release workflow.
 
 ### Pi compatibility
 
-The current package requires Pi 0.85.1 or newer (development tests pin 0.87.1). Use the latest Pi release; gentle-pi does not update your installed Pi automatically. Children, including any `GENTLE_PI_AGENTS_PI` override, must emit `agent_settled`: `agent_end` records a run's output but is not completion because retries or queued continuations may follow.
+The current package requires Pi 0.85.1 or newer (development tests pin 0.99.1). Use the latest Pi release; gentle-pi does not update your installed Pi automatically. Children, including any `GENTLE_PI_AGENTS_PI` override, must emit `agent_settled`: `agent_end` records a run's output but is not completion because retries or queued continuations may follow.
 
 The [`v2.6.0` release](https://github.com/Gentleman-Programming/gentle-shell/releases/tag/v2.6.0) added persistent registered worktrees and grouped `/gentle:changes` views; fuller workspace interaction details are in the [Gentle Shell reference](gentle-shell.md). It also adds named atomic `/gentle:profiles`, native review intended-untracked selection and provider continuations, and opt-in custom ask responses. Pi recognizes its global Git-managed package path; subsystems install with explicit recovery guidance when npm lifecycle work was skipped. Windows keeps child consoles hidden and fixes ownership mode; Gentle Todo keeps the next pending task visible when collapsed.
 
@@ -977,7 +977,7 @@ The frame labels INSERT, NORMAL, VISUAL (characterwise), or VISUAL LINE (linewis
 
 **Deliberate `/` divergence from Claude Code:** NORMAL `/` hands off to **Pi's native slash commands and skills**, enters INSERT, and inserts `/` at the existing cursor. Pi offers slash completion only at the start of the first line; elsewhere it inserts a literal slash without moving or replacing the draft. There is **no reverse prompt-history search**. Pi's explicit history shortcuts still work, transferring to INSERT first. Unknown NORMAL printable input, encoded text and bracketed paste do not silently insert; application shortcuts can transfer to INSERT before acting.
 
-This is a bounded command subset, not full Claude Code/Vim parity. The private editor adapter supports only the proven Pi coding-agent/TUI `0.85.1` and `0.87.1` package pairs: version metadata must come from a canonical candidate host package root whose actual `CustomEditor` and `Editor` classes match the loaded classes, never from the extension's local metadata or CLI path alone. Unknown versions, mismatched prototypes, or invalid layouts fail closed: a single compatibility warning is shown and the prompt continues with ordinary editing instead of silently entering inert NORMAL mode. Operations that would cross a registered collapsed paste marker, or encounter duplicate occurrences of a registered marker ID, are rejected without editing it. Visual highlighting relies on Pi's render layout and may be omitted if its geometry cannot be validated. No live-terminal proof of every layout or complete parity is claimed.
+This is a bounded command subset, not full Claude Code/Vim parity. The private editor adapter supports only the proven Pi coding-agent/TUI `0.85.1`, `0.87.1` and `0.99.1` package pairs — the list mirrors `SUPPORTED_VERSIONS` in `lib/vim-editor-adapter.ts`, which is the single source of truth for both the identity gate and `resolveVimRuntime()`: version metadata must come from a canonical candidate host package root whose actual `CustomEditor` and `Editor` classes match the loaded classes, never from the extension's local metadata or CLI path alone. Unknown versions, mismatched prototypes, or invalid layouts fail closed: a single compatibility warning is shown and the prompt continues with ordinary editing instead of silently entering inert NORMAL mode. Operations that would cross a registered collapsed paste marker, or encounter duplicate occurrences of a registered marker ID, are rejected without editing it. Visual highlighting relies on Pi's render layout and may be omitted if its geometry cannot be validated. No live-terminal proof of every layout or complete parity is claimed.
 
 Startup banner settings remain global in `banner.json` under `GENTLE_PI_CONFIG_HOME` (default `~/.pi/gentle-ai`). Existing `showRose` and `showTextLogo` opt-outs independently control the main startup artwork; both default to enabled. Changes apply on the next session or `/reload`. Color presets are `pink` (default), `cyan`, `yellow`, and `green`. The static sidebar heading is independent of these preferences and follows the active theme.
 

extensions/gentle-shell.ts

@@ -30,7 +30,7 @@ import { resolveAnimationPolicy, writeAnimationPolicy, type AnimationPolicy } fr
 import { resolveVimPolicy, writeVimPolicy, type VimPolicy } from "../lib/vim-policy.ts";
 import { resolveHistoryCapture, writeHistoryCapturePolicy } from "../lib/history-capture-policy.ts";
 import { createRequire } from "node:module";
-import { createVimEditorAdapter } from "../lib/vim-editor-adapter.ts";
+import { createVimEditorAdapter, SUPPORTED_VERSIONS } from "../lib/vim-editor-adapter.ts";
 import { VimNormalEngine } from "../lib/vim-normal-engine.ts";
 import { VimOperatorEngine, type OperatorResult } from "../lib/vim-operator-engine.ts";
 import { VimVisualEngine } from "../lib/vim-visual-engine.ts";
@@ -60,7 +60,7 @@ export function resolveVimRuntime(entry = process.argv[1], customClass: typeof C
 					const requireFromBundle = createRequire(bundlePath);
 					const bundled = requireFromBundle(bundlePath) as { CustomEditor?: typeof CustomEditor; VERSION?: string };
 					const metadata = requireFromBundle(resolve(root, "package.json")) as { name?: string; version?: string };
-					if (metadata.name === "@earendil-works/pi-coding-agent" && metadata.version === "0.87.1" &&
+					if (metadata.name === "@earendil-works/pi-coding-agent" && SUPPORTED_VERSIONS.has(metadata.version ?? "") &&
 						bundled.VERSION === metadata.version && bundled.CustomEditor === customClass &&
 						typeof editorClass === "function" && editorClass.name === "Editor" &&
 						editorPrototype === editorClass.prototype &&
@@ -94,7 +94,7 @@ export function resolveVimRuntime(entry = process.argv[1], customClass: typeof C
 			const tuiMetadata = requireFromRuntime(resolve(tuiRoot, "package.json")) as { version?: string; name?: string };
 			if (agent.CustomEditor === customClass && tui.Editor === editorClass &&
 				agentMetadata.name === "@earendil-works/pi-coding-agent" && tuiMetadata.name === "@earendil-works/pi-tui" &&
-				(agentMetadata.version === "0.85.1" || agentMetadata.version === "0.87.1") &&
+				(SUPPORTED_VERSIONS.has(agentMetadata.version ?? "")) &&
 				agentMetadata.version === tuiMetadata.version) return { version: tuiMetadata.version, editorClass };
 		} catch { /* Unknown package or constructor: ordinary editing stays active. */ }
 	}

lib/nan-provider.ts

@@ -2,6 +2,12 @@ import * as piAi from "@earendil-works/pi-ai";
 import type { Provider, ProviderStreams, RefreshModelsContext } from "@earendil-works/pi-ai";
 import type { ProviderModelConfig } from "@earendil-works/pi-coding-agent";
 
+// Pi 0.99 made ProviderModelConfig a chat/image/classifier union. This provider serves chat
+// models only, and pi's registration expects Model<"openai-completions">[], so the catalog is
+// typed as the chat member: the image and classifier members carry no reasoning, contextWindow
+// or maxTokens, which the union would have required here.
+type ChatModelConfig = Extract<ProviderModelConfig, { reasoning: boolean }>;
+
 export const NAN_PROVIDER_ID = "nan";
 export const NAN_PROVIDER_BASE_URL = "https://api.nan.builders/v1";
 export const NAN_MODELS_TIMEOUT_MS = 3_000;
@@ -18,7 +24,7 @@ const ZERO_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
 // Decimal bounds conservatively interpret the documented 1M/262K/131K labels.
 // Pi models text/image inputs only; MiMo's documented audio input is not advertised.
 // Where no output maximum is published, 8,192 is our conservative configured cap for coding with reasoning, not NaN's limit.
-const CHAT_MODELS: ProviderModelConfig[] = [
+const CHAT_MODELS: ChatModelConfig[] = [
 	{ id: "glm5.3", name: "GLM 5.3", input: ["text"], contextWindow: 1_000_000 },
 	{ id: "deepseek-v4-flash", name: "DeepSeek V4 Flash", input: ["text", "image"], contextWindow: 1_000_000 },
 	{ id: "glm5.3-flash", name: "GLM 5.3 Flash", input: ["text", "image"], contextWindow: 1_000_000 },
@@ -28,7 +34,7 @@ const CHAT_MODELS: ProviderModelConfig[] = [
 	{ id: "qwen3.6", name: "Qwen 3.6", input: ["text", "image"], contextWindow: 262_000 },
 ].map((model) => ({
 	...model,
-	input: model.input as ProviderModelConfig["input"],
+	input: model.input as ChatModelConfig["input"],
 	api: "openai-completions",
 	reasoning: true,
 	cost: ZERO_COST,
@@ -39,11 +45,11 @@ const CHAT_MODELS: ProviderModelConfig[] = [
 // A successful live catalog remains authoritative for the credential that fetched it.
 const OFFLINE_MODELS = CHAT_MODELS;
 
-function cloneModel(model: ProviderModelConfig): ProviderModelConfig {
+function cloneModel(model: ChatModelConfig): ChatModelConfig {
 	return { ...model, input: [...model.input], cost: { ...model.cost } };
 }
 
-function knownChatModels(ids: readonly string[]): ProviderModelConfig[] {
+function knownChatModels(ids: readonly string[]): ChatModelConfig[] {
 	return ids.flatMap((id) => {
 		const known = CHAT_MODELS.find((model) => model.id === id);
 		return known ? [cloneModel(known)] : [];
@@ -102,7 +108,7 @@ async function fetchLiveModelIds(options: {
 	}
 }
 
-function cloneCatalog(models: readonly ProviderModelConfig[]): ProviderModelConfig[] {
+function cloneCatalog(models: readonly ChatModelConfig[]): ChatModelConfig[] {
 	return models.map(cloneModel);
 }
 
@@ -151,7 +157,7 @@ export function createNanProviderConfig(options: NanProviderOptions = {}): Provi
 }
 
 function createCatalogConfig(options: NanProviderOptions = {}): {
-	getModels(): ProviderModelConfig[];
+	getModels(): ChatModelConfig[];
 	refreshModels(context: RefreshModelsContext): Promise<void>;
 } {
 	let catalog = cloneCatalog(OFFLINE_MODELS);

lib/theme-customization.ts

@@ -1,5 +1,9 @@
 import { closeSync, constants, fstatSync, openSync, readFileSync, realpathSync } from "node:fs";
 import { isAbsolute } from "node:path";
+// Namespace import on purpose: this module must also load on hosts that predate the
+// colour parser (pi-tui 0.85.1/0.87.1 ship no colors.js at all), and a named import
+// of a missing export would fail at load time instead of degrading at call time.
+import * as piTui from "@earendil-works/pi-tui";
 
 const MAX_BYTES = 256_000;
 const HEX = /^#[0-9a-fA-F]{6}$/;
@@ -37,7 +41,20 @@ export function sourcePalettePreview(name: string, sourcePath: string | undefine
 		}
 		const prefix = background ? 48 : 38;
 		if (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 255) return `\x1b[${prefix};5;${value}m`;
-		if (typeof value === "string" && HEX.test(value)) return `\x1b[${prefix};2;${parseInt(value.slice(1, 3), 16)};${parseInt(value.slice(3, 5), 16)};${parseInt(value.slice(5, 7), 16)}m`;
+		if (typeof value === "string") {
+			// Pi 0.99 writes its built-in themes in okhsl() (and accepts oklch()/#rgb) while
+			// 0.85.1 and 0.87.1 only ever shipped hex. Normalise through the host's own
+			// parser when it is present, so the colour semantics stay Pi's and this module
+			// never reimplements a colour space; hosts that predate the parser keep the hex
+			// path below, which is all their theme files could contain anyway.
+			if (typeof piTui.parseColor === "function" && typeof piTui.colorToHex === "function") {
+				try {
+					const normalised: unknown = piTui.colorToHex(piTui.parseColor(value));
+					if (typeof normalised === "string") value = normalised;
+				} catch { /* Syntax this host does not know: fail closed through the checks below. */ }
+			}
+			if (typeof value === "string" && HEX.test(value)) return `\x1b[${prefix};2;${parseInt(value.slice(1, 3), 16)};${parseInt(value.slice(3, 5), 16)};${parseInt(value.slice(5, 7), 16)}m`;
+		}
 		throw new Error("Invalid theme palette color.");
 	};
 	return { title: `${name} · source palette`, sample: `${escape("accent", true)}  \x1b[0m ${escape("text", false)}Aa  sample text\x1b[0m` };

lib/vim-editor-adapter.ts

@@ -38,7 +38,17 @@ interface PrivateEditor {
   exitHistoryBrowsing(): void;
 }
 
-const SUPPORTED_VERSIONS = new Set(["0.85.1", "0.87.1"]);
+// Host Pi versions whose private editor layout this adapter has been verified
+// against. This list is the single source of truth for the identity gate below and
+// for resolveVimRuntime() in extensions/gentle-shell.ts, so a newly verified host
+// is admitted in one place and the two checks cannot drift apart.
+//
+// 0.99.1 was admitted after auditing a real 0.99.1 Editor instance against every
+// structural precondition asserted here (state.lines/cursorLine/cursorCol, pastes
+// Map, pasteCounter, undoStack push/pop/stack/length, pushUndoSnapshot, undo,
+// setCursorCol, cancelAutocomplete, exitHistoryBrowsing, layoutText, render,
+// paddingX) and running the vim adapter suites against it.
+export const SUPPORTED_VERSIONS = new Set(["0.85.1", "0.87.1", "0.99.1"]);
 const importedTuiMetadata: unknown = createRequire(import.meta.url)("@earendil-works/pi-tui/package.json");
 const IMPORTED_TUI_VERSION = typeof importedTuiMetadata === "object" && importedTuiMetadata !== null &&
   "version" in importedTuiMetadata ? importedTuiMetadata.version : undefined;
@@ -47,8 +57,9 @@ const IMPORTED_TUI_VERSION = typeof importedTuiMetadata === "object" && imported
 // as the version metadata. An arbitrary object with matching fields is not an editor.
 function hasEditorIdentity(value: unknown, version: string, editorClass: typeof Editor, verifiedVersion?: string): boolean {
   if (!SUPPORTED_VERSIONS.has(version) || typeof value !== "object" || value === null ||
-      (verifiedVersion !== undefined ? version !== verifiedVersion :
-        editorClass === Editor ? version !== IMPORTED_TUI_VERSION : version !== "0.87.1") || !(value instanceof editorClass)) return false;
+      (verifiedVersion !== undefined ? version !== verifiedVersion
+        : editorClass === Editor && version !== IMPORTED_TUI_VERSION) ||
+      !(value instanceof editorClass)) return false;
   let prototype: unknown = Object.getPrototypeOf(value);
   for (let depth = 0; depth < 3; depth++) {
     if (prototype === editorClass.prototype) return true;

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gentle-pi",
-	"version": "3.7.0",
+	"version": "3.7.1",
 	"description": "Turn Pi into el Gentleman: an ODD development harness with focused subagents, configured TDD evidence, native review, and skill discovery.",
 	"license": "MIT",
 	"type": "module",
@@ -72,12 +72,12 @@
 		]
 	},
 	"dependencies": {
-		"@earendil-works/pi-ai": "0.87.1",
-		"@earendil-works/pi-tui": "0.87.1",
 		"@heyhuynhgiabuu/pi-pretty": "0.6.27"
 	},
 	"peerDependencies": {
+		"@earendil-works/pi-ai": "*",
 		"@earendil-works/pi-coding-agent": ">=0.85.1",
+		"@earendil-works/pi-tui": "*",
 		"typebox": "*"
 	},
 	"peerDependenciesMeta": {
@@ -86,7 +86,9 @@
 		}
 	},
 	"devDependencies": {
-		"@earendil-works/pi-coding-agent": "0.87.1",
+		"@earendil-works/pi-ai": "0.99.1",
+		"@earendil-works/pi-coding-agent": "0.99.1",
+		"@earendil-works/pi-tui": "0.99.1",
 		"@types/node": "^24.13.3",
 		"typescript": "^5.9.3"
 	},