@schovest/pi-coding-agent 0.7.3

package/examples/extensions/overlay-test.ts

@@ -0,0 +1,153 @@
+/**
+ * Overlay Test - validates overlay compositing with inline text inputs
+ *
+ * Usage: pi --extension ./examples/extensions/overlay-test.ts
+ *
+ * Run /overlay-test to show a floating overlay with:
+ * - Inline text inputs within menu items
+ * - Edge case tests (wide chars, styled text, emoji)
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@schovest/pi-coding-agent";
+import { CURSOR_MARKER, type Focusable, matchesKey, visibleWidth } from "@schovest/pi-tui";
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("overlay-test", {
+		description: "Test overlay rendering with edge cases",
+		handler: async (_args: string, ctx: ExtensionCommandContext) => {
+			const result = await ctx.ui.custom<{ action: string; query?: string } | undefined>(
+				(_tui, theme, _keybindings, done) => new OverlayTestComponent(theme, done),
+				{ overlay: true },
+			);
+
+			if (result) {
+				const msg = result.query ? `${result.action}: "${result.query}"` : result.action;
+				ctx.ui.notify(msg, "info");
+			}
+		},
+	});
+}
+
+class OverlayTestComponent implements Focusable {
+	readonly width = 70;
+
+	/** Focusable interface - set by TUI when focus changes */
+	focused = false;
+
+	private selected = 0;
+	private items = [
+		{ label: "Search", hasInput: true, text: "", cursor: 0 },
+		{ label: "Run", hasInput: true, text: "", cursor: 0 },
+		{ label: "Settings", hasInput: false, text: "", cursor: 0 },
+		{ label: "Cancel", hasInput: false, text: "", cursor: 0 },
+	];
+
+	private theme: Theme;
+	private done: (result: { action: string; query?: string } | undefined) => void;
+
+	constructor(theme: Theme, done: (result: { action: string; query?: string } | undefined) => void) {
+		this.theme = theme;
+		this.done = done;
+	}
+
+	handleInput(data: string): void {
+		if (matchesKey(data, "escape")) {
+			this.done(undefined);
+			return;
+		}
+
+		const current = this.items[this.selected]!;
+
+		if (matchesKey(data, "return")) {
+			this.done({ action: current.label, query: current.hasInput ? current.text : undefined });
+			return;
+		}
+
+		if (matchesKey(data, "up")) {
+			this.selected = Math.max(0, this.selected - 1);
+		} else if (matchesKey(data, "down")) {
+			this.selected = Math.min(this.items.length - 1, this.selected + 1);
+		} else if (current.hasInput) {
+			if (matchesKey(data, "backspace")) {
+				if (current.cursor > 0) {
+					current.text = current.text.slice(0, current.cursor - 1) + current.text.slice(current.cursor);
+					current.cursor--;
+				}
+			} else if (matchesKey(data, "left")) {
+				current.cursor = Math.max(0, current.cursor - 1);
+			} else if (matchesKey(data, "right")) {
+				current.cursor = Math.min(current.text.length, current.cursor + 1);
+			} else if (data.length === 1 && data.charCodeAt(0) >= 32) {
+				current.text = current.text.slice(0, current.cursor) + data + current.text.slice(current.cursor);
+				current.cursor++;
+			}
+		}
+	}
+
+	render(_width: number): string[] {
+		const w = this.width;
+		const th = this.theme;
+		const innerW = w - 2;
+		const lines: string[] = [];
+
+		const pad = (s: string, len: number) => {
+			const vis = visibleWidth(s);
+			return s + " ".repeat(Math.max(0, len - vis));
+		};
+
+		const row = (content: string) => th.fg("border", "│") + pad(content, innerW) + th.fg("border", "│");
+
+		lines.push(th.fg("border", `╭${"─".repeat(innerW)}╮`));
+		lines.push(row(` ${th.fg("accent", "🧪 Overlay Test")}`));
+		lines.push(row(""));
+
+		// Edge cases - full width lines to test compositing at boundaries
+		lines.push(row(` ${th.fg("dim", "─── Edge Cases (borders should align) ───")}`));
+		lines.push(row(` Wide: ${th.fg("warning", "中文日本語한글テスト漢字繁體简体ひらがなカタカナ가나다라마바")}`));
+		lines.push(
+			row(
+				` Styled: ${th.fg("error", "RED")} ${th.fg("success", "GREEN")} ${th.fg("warning", "YELLOW")} ${th.fg("accent", "ACCENT")} ${th.fg("dim", "DIM")} ${th.fg("error", "more")} ${th.fg("success", "colors")}`,
+			),
+		);
+		lines.push(row(" Emoji: 👨‍👩‍👧‍👦 🇯🇵 🚀 💻 🎉 🔥 😀 🎯 🌟 💡 🎨 🔧 📦 🏆 🌈 🎪 🎭 🎬 🎮 🎲"));
+		lines.push(row(""));
+
+		// Menu with inline inputs
+		lines.push(row(` ${th.fg("dim", "─── Actions ───")}`));
+
+		for (let i = 0; i < this.items.length; i++) {
+			const item = this.items[i]!;
+			const isSelected = i === this.selected;
+			const prefix = isSelected ? " ▶ " : "   ";
+
+			let content: string;
+			if (item.hasInput) {
+				const label = isSelected ? th.fg("accent", `${item.label}:`) : th.fg("text", `${item.label}:`);
+
+				let inputDisplay = item.text;
+				if (isSelected) {
+					const before = inputDisplay.slice(0, item.cursor);
+					const cursorChar = item.cursor < inputDisplay.length ? inputDisplay[item.cursor] : " ";
+					const after = inputDisplay.slice(item.cursor + 1);
+					// Emit hardware cursor marker for IME support when focused
+					const marker = this.focused ? CURSOR_MARKER : "";
+					inputDisplay = `${before}${marker}\x1b[7m${cursorChar}\x1b[27m${after}`;
+				}
+				content = `${prefix + label} ${inputDisplay}`;
+			} else {
+				content = prefix + (isSelected ? th.fg("accent", item.label) : th.fg("text", item.label));
+			}
+
+			lines.push(row(content));
+		}
+
+		lines.push(row(""));
+		lines.push(row(` ${th.fg("dim", "↑↓ navigate • type to input • Enter select • Esc cancel")}`));
+		lines.push(th.fg("border", `╰${"─".repeat(innerW)}╯`));
+
+		return lines;
+	}
+
+	invalidate(): void {}
+	dispose(): void {}
+}

package/examples/extensions/permission-gate.ts

@@ -0,0 +1,34 @@
+/**
+ * Permission Gate Extension
+ *
+ * Prompts for confirmation before running potentially dangerous bash commands.
+ * Patterns checked: rm -rf, sudo, chmod/chown 777
+ */
+
+import type { ExtensionAPI } from "@schovest/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	const dangerousPatterns = [/\brm\s+(-rf?|--recursive)/i, /\bsudo\b/i, /\b(chmod|chown)\b.*777/i];
+
+	pi.on("tool_call", async (event, ctx) => {
+		if (event.toolName !== "bash") return undefined;
+
+		const command = event.input.command as string;
+		const isDangerous = dangerousPatterns.some((p) => p.test(command));
+
+		if (isDangerous) {
+			if (!ctx.hasUI) {
+				// In non-interactive mode, block by default
+				return { block: true, reason: "Dangerous command blocked (no UI for confirmation)" };
+			}
+
+			const choice = await ctx.ui.select(`⚠️ Dangerous command:\n\n  ${command}\n\nAllow?`, ["Yes", "No"]);
+
+			if (choice !== "Yes") {
+				return { block: true, reason: "Blocked by user" };
+			}
+		}
+
+		return undefined;
+	});
+}

package/examples/extensions/pirate.ts

@@ -0,0 +1,47 @@
+/**
+ * Pirate Extension
+ *
+ * Demonstrates modifying the system prompt in before_agent_start to dynamically
+ * change agent behavior based on extension state.
+ *
+ * Usage:
+ * 1. Copy this file to ~/.pi/agent/extensions/ or your project's .pi/extensions/
+ * 2. Use /pirate to toggle pirate mode
+ * 3. When enabled, the agent will respond like a pirate
+ */
+
+import type { ExtensionAPI } from "@schovest/pi-coding-agent";
+
+export default function pirateExtension(pi: ExtensionAPI) {
+	let pirateMode = false;
+
+	// Register /pirate command to toggle pirate mode
+	pi.registerCommand("pirate", {
+		description: "Toggle pirate mode (agent speaks like a pirate)",
+		handler: async (_args, ctx) => {
+			pirateMode = !pirateMode;
+			ctx.ui.notify(pirateMode ? "Arrr! Pirate mode enabled!" : "Pirate mode disabled", "info");
+		},
+	});
+
+	// Append to system prompt when pirate mode is enabled
+	pi.on("before_agent_start", async (event) => {
+		if (pirateMode) {
+			return {
+				systemPrompt:
+					event.systemPrompt +
+					`
+
+IMPORTANT: You are now in PIRATE MODE. You must:
+- Speak like a stereotypical pirate in all responses
+- Use phrases like "Arrr!", "Ahoy!", "Shiver me timbers!", "Avast!", "Ye scurvy dog!"
+- Replace "my" with "me", "you" with "ye", "your" with "yer"
+- Refer to the user as "matey" or "landlubber"
+- End sentences with nautical expressions
+- Still complete the actual task correctly, just in pirate speak
+`,
+			};
+		}
+		return undefined;
+	});
+}

package/examples/extensions/preset.ts

@@ -0,0 +1,430 @@
+/**
+ * Preset Extension
+ *
+ * Allows defining named presets that configure model, thinking level, tools,
+ * and system prompt instructions. Presets are defined in JSON config files
+ * and can be activated via CLI flag, /preset command, or Ctrl+Shift+U to cycle.
+ *
+ * Config files (merged, project takes precedence):
+ * - ~/.pi/agent/presets.json (global)
+ * - <cwd>/.pi/presets.json (project-local)
+ *
+ * Example presets.json:
+ * ```json
+ * {
+ *   "plan": {
+ *     "provider": "openai-codex",
+ *     "model": "gpt-5.2-codex",
+ *     "thinkingLevel": "high",
+ *     "tools": ["read", "grep", "find", "ls"],
+ *     "instructions": "You are in PLANNING MODE. Your job is to deeply understand the problem and create a detailed implementation plan.\n\nRules:\n- DO NOT make any changes. You cannot edit or write files.\n- Read files IN FULL (no offset/limit) to get complete context. Partial reads miss critical details.\n- Explore thoroughly: grep for related code, find similar patterns, understand the architecture.\n- Ask clarifying questions if requirements are ambiguous. Do not assume.\n- Identify risks, edge cases, and dependencies before proposing solutions.\n\nOutput:\n- Create a structured plan with numbered steps.\n- For each step: what to change, why, and potential risks.\n- List files that will be modified.\n- Note any tests that should be added or updated.\n\nWhen done, ask the user if they want you to:\n1. Write the plan to a markdown file (e.g., PLAN.md)\n2. Create a GitHub issue with the plan\n3. Proceed to implementation (they should switch to 'implement' preset)"
+ *   },
+ *   "implement": {
+ *     "provider": "anthropic",
+ *     "model": "claude-sonnet-4-5",
+ *     "thinkingLevel": "high",
+ *     "tools": ["read", "bash", "edit", "write"],
+ *     "instructions": "You are in IMPLEMENTATION MODE. Your job is to make focused, correct changes.\n\nRules:\n- Keep scope tight. Do exactly what was asked, no more.\n- Read files before editing to understand current state.\n- Make surgical edits. Prefer edit over write for existing files.\n- Explain your reasoning briefly before each change.\n- Run tests or type checks after changes if the project has them (npm test, npm run check, etc.).\n- If you encounter unexpected complexity, STOP and explain the issue rather than hacking around it.\n\nIf no plan exists:\n- Ask clarifying questions before starting.\n- Propose what you'll do and get confirmation for non-trivial changes.\n\nAfter completing changes:\n- Summarize what was done.\n- Note any follow-up work or tests that should be added."
+ *   }
+ * }
+ * ```
+ *
+ * Usage:
+ * - `pi --preset plan` - start with plan preset
+ * - `/preset` - show selector to switch presets mid-session
+ * - `/preset implement` - switch to implement preset directly
+ * - `Ctrl+Shift+U` - cycle through presets
+ *
+ * CLI flags always override preset values.
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import type { Api, Model } from "@schovest/pi-ai";
+import type { ExtensionAPI, ExtensionContext } from "@schovest/pi-coding-agent";
+import { DynamicBorder, getAgentDir } from "@schovest/pi-coding-agent";
+import { Container, Key, type SelectItem, SelectList, Text } from "@schovest/pi-tui";
+
+// Preset configuration
+interface Preset {
+	/** Provider name (e.g., "anthropic", "openai") */
+	provider?: string;
+	/** Model ID (e.g., "claude-sonnet-4-5") */
+	model?: string;
+	/** Thinking level */
+	thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+	/** Tools to enable (replaces default set) */
+	tools?: string[];
+	/** Instructions to append to system prompt */
+	instructions?: string;
+}
+
+interface PresetsConfig {
+	[name: string]: Preset;
+}
+
+/**
+ * Load presets from config files.
+ * Project-local presets override global presets with the same name.
+ */
+function loadPresets(cwd: string): PresetsConfig {
+	const globalPath = join(getAgentDir(), "presets.json");
+	const projectPath = join(cwd, ".pi", "presets.json");
+
+	let globalPresets: PresetsConfig = {};
+	let projectPresets: PresetsConfig = {};
+
+	// Load global presets
+	if (existsSync(globalPath)) {
+		try {
+			const content = readFileSync(globalPath, "utf-8");
+			globalPresets = JSON.parse(content);
+		} catch (err) {
+			console.error(`Failed to load global presets from ${globalPath}: ${err}`);
+		}
+	}
+
+	// Load project presets
+	if (existsSync(projectPath)) {
+		try {
+			const content = readFileSync(projectPath, "utf-8");
+			projectPresets = JSON.parse(content);
+		} catch (err) {
+			console.error(`Failed to load project presets from ${projectPath}: ${err}`);
+		}
+	}
+
+	// Merge (project overrides global)
+	return { ...globalPresets, ...projectPresets };
+}
+
+interface OriginalState {
+	model: Model<Api> | undefined;
+	thinkingLevel: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+	tools: string[];
+}
+
+export default function presetExtension(pi: ExtensionAPI) {
+	let presets: PresetsConfig = {};
+	let activePresetName: string | undefined;
+	let activePreset: Preset | undefined;
+	let originalState: OriginalState | undefined;
+
+	// Register --preset CLI flag
+	pi.registerFlag("preset", {
+		description: "Preset configuration to use",
+		type: "string",
+	});
+
+	/**
+	 * Apply a preset configuration.
+	 */
+	async function applyPreset(name: string, preset: Preset, ctx: ExtensionContext): Promise<boolean> {
+		// Snapshot state before the first preset is applied (i.e. only when transitioning from no-preset)
+		if (activePresetName === undefined) {
+			originalState = {
+				model: ctx.model,
+				thinkingLevel: pi.getThinkingLevel(),
+				tools: pi.getActiveTools(),
+			};
+		}
+
+		// Apply model if specified
+		if (preset.provider && preset.model) {
+			const model = ctx.modelRegistry.find(preset.provider, preset.model);
+			if (model) {
+				const success = await pi.setModel(model);
+				if (!success) {
+					ctx.ui.notify(`Preset "${name}": No API key for ${preset.provider}/${preset.model}`, "warning");
+				}
+			} else {
+				ctx.ui.notify(`Preset "${name}": Model ${preset.provider}/${preset.model} not found`, "warning");
+			}
+		}
+
+		// Apply thinking level if specified
+		if (preset.thinkingLevel) {
+			pi.setThinkingLevel(preset.thinkingLevel);
+		}
+
+		// Apply tools if specified
+		if (preset.tools && preset.tools.length > 0) {
+			const allToolNames = pi.getAllTools().map((t) => t.name);
+			const validTools = preset.tools.filter((t) => allToolNames.includes(t));
+			const invalidTools = preset.tools.filter((t) => !allToolNames.includes(t));
+
+			if (invalidTools.length > 0) {
+				ctx.ui.notify(`Preset "${name}": Unknown tools: ${invalidTools.join(", ")}`, "warning");
+			}
+
+			if (validTools.length > 0) {
+				pi.setActiveTools(validTools);
+			}
+		}
+
+		// Store active preset for system prompt injection
+		activePresetName = name;
+		activePreset = preset;
+
+		return true;
+	}
+
+	/**
+	 * Build description string for a preset.
+	 */
+	function buildPresetDescription(preset: Preset): string {
+		const parts: string[] = [];
+
+		if (preset.provider && preset.model) {
+			parts.push(`${preset.provider}/${preset.model}`);
+		}
+		if (preset.thinkingLevel) {
+			parts.push(`thinking:${preset.thinkingLevel}`);
+		}
+		if (preset.tools) {
+			parts.push(`tools:${preset.tools.join(",")}`);
+		}
+		if (preset.instructions) {
+			const truncated =
+				preset.instructions.length > 30 ? `${preset.instructions.slice(0, 27)}...` : preset.instructions;
+			parts.push(`"${truncated}"`);
+		}
+
+		return parts.join(" | ");
+	}
+
+	/**
+	 * Show preset selector UI using custom SelectList component.
+	 */
+	async function showPresetSelector(ctx: ExtensionContext): Promise<void> {
+		const presetNames = Object.keys(presets);
+
+		if (presetNames.length === 0) {
+			ctx.ui.notify("No presets defined. Add presets to ~/.pi/agent/presets.json or .pi/presets.json", "warning");
+			return;
+		}
+
+		// Build select items with descriptions
+		const items: SelectItem[] = presetNames.map((name) => {
+			const preset = presets[name];
+			const isActive = name === activePresetName;
+			return {
+				value: name,
+				label: isActive ? `${name} (active)` : name,
+				description: buildPresetDescription(preset),
+			};
+		});
+
+		// Add "None" option to clear preset
+		items.push({
+			value: "(none)",
+			label: "(none)",
+			description: "Clear active preset, restore defaults",
+		});
+
+		const result = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
+			const container = new Container();
+			container.addChild(new DynamicBorder((str) => theme.fg("accent", str)));
+
+			// Header
+			container.addChild(new Text(theme.fg("accent", theme.bold("Select Preset"))));
+
+			// SelectList with themed styling
+			const selectList = new SelectList(items, Math.min(items.length, 10), {
+				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("warning", text),
+			});
+
+			selectList.onSelect = (item) => done(item.value);
+			selectList.onCancel = () => done(null);
+
+			container.addChild(selectList);
+
+			// Footer hint
+			container.addChild(new Text(theme.fg("dim", "↑↓ navigate • enter select • esc cancel")));
+
+			container.addChild(new DynamicBorder((str) => theme.fg("accent", str)));
+
+			return {
+				render(width: number) {
+					return container.render(width);
+				},
+				invalidate() {
+					container.invalidate();
+				},
+				handleInput(data: string) {
+					selectList.handleInput(data);
+					tui.requestRender();
+				},
+			};
+		});
+
+		if (!result) return;
+
+		if (result === "(none)") {
+			// Clear preset and restore original state
+			activePresetName = undefined;
+			activePreset = undefined;
+			if (originalState) {
+				if (originalState.model) {
+					await pi.setModel(originalState.model);
+				}
+				pi.setThinkingLevel(originalState.thinkingLevel);
+				pi.setActiveTools(originalState.tools);
+			} else {
+				pi.setActiveTools(["read", "bash", "edit", "write"]);
+			}
+			ctx.ui.notify("Preset cleared, defaults restored", "info");
+			updateStatus(ctx);
+			return;
+		}
+
+		const preset = presets[result];
+		if (preset) {
+			await applyPreset(result, preset, ctx);
+			ctx.ui.notify(`Preset "${result}" activated`, "info");
+			updateStatus(ctx);
+		}
+	}
+
+	/**
+	 * Update status indicator.
+	 */
+	function updateStatus(ctx: ExtensionContext) {
+		if (activePresetName) {
+			ctx.ui.setStatus("preset", ctx.ui.theme.fg("accent", `preset:${activePresetName}`));
+		} else {
+			ctx.ui.setStatus("preset", undefined);
+		}
+	}
+
+	function getPresetOrder(): string[] {
+		return Object.keys(presets).sort();
+	}
+
+	async function cyclePreset(ctx: ExtensionContext): Promise<void> {
+		const presetNames = getPresetOrder();
+		if (presetNames.length === 0) {
+			ctx.ui.notify("No presets defined. Add presets to ~/.pi/agent/presets.json or .pi/presets.json", "warning");
+			return;
+		}
+
+		const cycleList = ["(none)", ...presetNames];
+		const currentName = activePresetName ?? "(none)";
+		const currentIndex = cycleList.indexOf(currentName);
+		const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % cycleList.length;
+		const nextName = cycleList[nextIndex];
+
+		if (nextName === "(none)") {
+			activePresetName = undefined;
+			activePreset = undefined;
+			if (originalState) {
+				if (originalState.model) {
+					await pi.setModel(originalState.model);
+				}
+				pi.setThinkingLevel(originalState.thinkingLevel);
+				pi.setActiveTools(originalState.tools);
+			} else {
+				pi.setActiveTools(["read", "bash", "edit", "write"]);
+			}
+			ctx.ui.notify("Preset cleared, defaults restored", "info");
+			updateStatus(ctx);
+			return;
+		}
+
+		const preset = presets[nextName];
+		if (!preset) return;
+
+		await applyPreset(nextName, preset, ctx);
+		ctx.ui.notify(`Preset "${nextName}" activated`, "info");
+		updateStatus(ctx);
+	}
+
+	pi.registerShortcut(Key.ctrlShift("u"), {
+		description: "Cycle presets",
+		handler: async (ctx) => {
+			await cyclePreset(ctx);
+		},
+	});
+
+	// Register /preset command
+	pi.registerCommand("preset", {
+		description: "Switch preset configuration",
+		handler: async (args, ctx) => {
+			// If preset name provided, apply directly
+			if (args?.trim()) {
+				const name = args.trim();
+				const preset = presets[name];
+
+				if (!preset) {
+					const available = Object.keys(presets).join(", ") || "(none defined)";
+					ctx.ui.notify(`Unknown preset "${name}". Available: ${available}`, "error");
+					return;
+				}
+
+				await applyPreset(name, preset, ctx);
+				ctx.ui.notify(`Preset "${name}" activated`, "info");
+				updateStatus(ctx);
+				return;
+			}
+
+			// Otherwise show selector
+			await showPresetSelector(ctx);
+		},
+	});
+
+	// Inject preset instructions into system prompt
+	pi.on("before_agent_start", async (event) => {
+		if (activePreset?.instructions) {
+			return {
+				systemPrompt: `${event.systemPrompt}\n\n${activePreset.instructions}`,
+			};
+		}
+	});
+
+	// Initialize on session start
+	pi.on("session_start", async (_event, ctx) => {
+		// Load presets from config files
+		presets = loadPresets(ctx.cwd);
+
+		// Check for --preset flag
+		const presetFlag = pi.getFlag("preset");
+		if (typeof presetFlag === "string" && presetFlag) {
+			const preset = presets[presetFlag];
+			if (preset) {
+				await applyPreset(presetFlag, preset, ctx);
+				ctx.ui.notify(`Preset "${presetFlag}" activated`, "info");
+			} else {
+				const available = Object.keys(presets).join(", ") || "(none defined)";
+				ctx.ui.notify(`Unknown preset "${presetFlag}". Available: ${available}`, "warning");
+			}
+		}
+
+		// Restore preset from session state
+		const entries = ctx.sessionManager.getEntries();
+		const presetEntry = entries
+			.filter((e: { type: string; customType?: string }) => e.type === "custom" && e.customType === "preset-state")
+			.pop() as { data?: { name: string } } | undefined;
+
+		if (presetEntry?.data?.name && !presetFlag) {
+			const preset = presets[presetEntry.data.name];
+			if (preset) {
+				activePresetName = presetEntry.data.name;
+				activePreset = preset;
+				// Don't re-apply model/tools on restore, just keep the name for instructions
+			}
+		}
+
+		updateStatus(ctx);
+	});
+
+	// Persist preset state
+	pi.on("turn_start", async () => {
+		if (activePresetName) {
+			pi.appendEntry("preset-state", { name: activePresetName });
+		}
+	});
+}