@oh-my-pi/pi-coding-agent 11.2.2 → 11.3.0

package/CHANGELOG.md

@@ -2,6 +2,106 @@
 
 ## [Unreleased]
 
+## [11.3.0] - 2026-02-06
+
+### Added
+
+- Added resumption hint printed to stderr on session exit showing command to resume the session (e.g., `Resume this session with claude --resume <session-id>`)
+- New `BlobStore` class for content-addressed storage of large binary data (images) externalized from session files
+- New `getBlobsDir()` function to get path to blob store directory
+- Support for externalizing large images to blob store during session persistence, reducing JSONL file size
+- New blob reference format (`blob:sha256:<hash>`) for tracking externalized image data in sessions
+- Exported `ModeChangeEntry` type for tracking agent mode transitions
+- Support for restoring plan mode state when resuming sessions
+- New `appendModeChange()` method in SessionManager to record mode transitions
+- New `mode` and `modeData` fields in SessionContext to track active agent mode
+- Support for `PI_PACKAGE_DIR` environment variable to override package directory (useful for Nix/Guix store paths)
+- New keybindings for session management: `toggleSessionNamedFilter` (Ctrl+N), `newSession`, `tree`, `fork`, and `resume` actions
+- Support for shell command execution in configuration values (API keys, headers) using `!` prefix, with result caching
+- New `clearOnShrink` display setting to control whether empty rows are cleared when content shrinks
+- New `SlashCommandInfo`, `SlashCommandLocation`, and `SlashCommandSource` types for extension slash command discovery
+- New `getCommands()` method in ExtensionAPI to retrieve available slash commands
+- New `switchSession()` action in ExtensionCommandContext to switch between sessions
+- New `SwitchSessionHandler` type for extension session switching handlers
+- New `getSystemPrompt()` method in ExtensionUIContext to access current system prompt
+- New `getToolsExpanded()` and `setToolsExpanded()` methods in ExtensionUIContext for tool output expansion control
+- New `WriteToolCallEvent` type for write tool call events
+- New `isToolCallEventType()` type guard for tool call events
+- Support for image content in RPC `steer` and `followUp` commands
+- New `GitSource` type and `parseGitUrl()` function for parsing git URLs in plugin system
+- Tool input types exported: `BashToolInput`, `FindToolInput`, `GrepToolInput`, `ReadToolInput`, `WriteToolInput`
+- Support for `@` prefix normalization in file paths (strips leading `@` character)
+- New `parentSessionPath` field in SessionInfo to track forked session origins
+- Skill file relative path resolution against skill directory in system prompt
+- Support for Termux/Android package installation guidance for missing tools
+- Support for puppeteer query handlers (aria/, text/, xpath/, pierce/) in selector parameters across all browser actions
+- Automatic normalization of legacy p- prefixed selectors (p-aria/, p-text/, p-xpath/, p-pierce/) to modern puppeteer query handler syntax
+- Improved click action with intelligent element selection that prioritizes visible, actionable candidates and retries until timeout
+- Enhanced actionability checking for click operations, validating visibility, pointer events, opacity, viewport intersection, and element occlusion
+
+### Changed
+
+- Modified `--resume` flag to accept optional session ID or path (e.g., `--resume abc123` or `--resume /path/to/session.jsonl`), with session picker shown when no value provided
+- Consolidated `--session` flag as an alias for `--resume` with value for improved CLI consistency
+- Removed read tool grouping reset logic that was breaking grouping when text or thinking blocks appeared between tool calls
+- Image persistence now externalizes images ≥1KB to content-addressed blob store instead of compressing inline
+- Session loading now automatically resolves blob references back to base64 image data
+- Session forking now resolves blob references in copied entries to ensure data integrity
+- Screenshot tool now automatically compresses images for API content using the same resizing logic as pasted images, reducing payload size while maintaining quality
+- Improved text truncation across tool renderers to respect terminal width constraints and prevent output overflow
+- Enhanced render caching to include width parameter for accurate cache invalidation when terminal width changes
+- HTML export filter now treats `mode_change` entries as settings entries alongside model changes and thinking level changes
+- Replaced ellipsis string (`...`) with Unicode ellipsis character (`…`) throughout UI text and truncation logic for improved typography
+- Improved render performance by introducing caching for tool output blocks and search results to avoid redundant text width and padding computations
+- Enhanced read tool grouping to reset when non-tool content (text/thinking blocks) appears between read calls, preventing unintended coalescing
+- Improved string preview formatting in scalar values to show line counts and truncation indicators for multi-line strings
+- Refactored tool execution component to use shared mutable render state for spinner frames and expansion state, reducing closure overhead
+- Enhanced error handling in tool renderers with logging for renderer failures instead of silent fallbacks
+- Made shell command execution in configuration values asynchronous to prevent blocking the TUI
+- Improved `@` prefix normalization to only strip leading `@` for well-known path syntaxes (absolute paths, home directory, internal URL shorthands) to avoid mangling literal paths
+- Enhanced git URL parsing to strip credentials from repository URLs and validate URL-encoded hash fragments
+- Improved null data handling in task submission to preserve agent output when `submit_result` is called with null/undefined data, enabling fallback text extraction instead of discarding output
+- Updated default model IDs across providers: Claude Sonnet 4.5 → Claude Opus 4.6, Gemini 2.5 Pro → Gemini 3 Pro variants, and others
+- Made model definition fields optional with sensible defaults for local models (Ollama, LM Studio, etc.)
+- Modified custom tool execute signature to reorder parameters: `(toolCallId, params, signal, onUpdate, ctx)` instead of `(toolCallId, params, onUpdate, ctx, signal)`
+- Changed `--version` and `--list-models` flags to exit with `process.exit(0)` instead of returning
+- Improved `--export` flag to exit with `process.exit(0)` on success
+- Enhanced tree selector to preserve last selected ID across filter changes
+- Modified tree navigation to use real leaf ID instead of skipping metadata entries
+- Improved footer path truncation logic to prevent invalid truncation at boundary
+- Enhanced model selector to display selected model name when no matches found
+- Improved RPC client `steer()` and `followUp()` methods to accept optional image content
+- Updated extension loader to check for explicit extension entries in root directory before discovering subdirectories
+- Removed line limiting in custom message component when collapsed
+- Improved API key resolution to support shell command execution via `resolveConfigValue()`
+- Enhanced session branching to preserve parent session path reference
+- Updated selector parameter descriptions to document support for CSS selectors and puppeteer query handlers
+- Modified viewport handling in headless mode to respect custom viewport parameters while disabling viewport in headed mode for better window management
+- Improved click action to use specialized text query handler logic with retry mechanism for better reliability with dynamic content
+
+### Fixed
+
+- Fixed background color stability in output blocks when inner content contains SGR reset sequences, preventing background color from being cleared mid-line
+- Fixed spurious ellipsis appended to output lines that were already padded to terminal width by trimming trailing spaces before truncation check
+- Fixed config file parsing to properly handle missing files instead of treating them as errors
+- Fixed truncation indicator in truncate tool to use ellipsis character (…) instead of verbose '[truncated]' suffix
+- Fixed concurrent shell command execution by de-duplicating in-flight requests for the same command
+- Fixed git URL parsing to properly handle URL-encoded characters in hash fragments and reject invalid encodings
+- Fixed task executor to properly handle agents calling `submit_result` with null data by treating it as missing and attempting to extract output from conversation text rather than silently failing
+- Fixed HTML export template to safely handle invalid argument types in tool rendering
+- Fixed path shortening in HTML export to handle non-string paths
+- Fixed custom message rendering to properly display full content without artificial line limits
+- Fixed tree navigation to only restore editor text when editor is empty
+- Fixed session creation to properly track parent session when forking
+- Fixed thinking level initialization to only append change entry for new sessions without existing thinking entries
+- Fixed tool expansion state management to properly propagate through UI context
+- Fixed click action to properly handle text/ query handlers with timeout and retry logic instead of failing immediately
+- Fixed viewport application to only apply when in headless mode or when explicitly requested, preventing conflicts in headed browser mode
+
+### Security
+
+- Added support for shell command execution in configuration values with caching to enable secure credential resolution patterns
+
 ## [11.2.1] - 2026-02-05
 
 ### Fixed

package/examples/extensions/plan-mode.ts

@@ -162,7 +162,7 @@ function cleanStepText(text: string): string {
 
 	// Truncate if too long
 	if (cleaned.length > 50) {
-		cleaned = `${cleaned.slice(0, 47)}...`;
+		cleaned = `${cleaned.slice(0, 49)}…`;
 	}
 
 	return cleaned;

package/examples/hooks/qna.ts

@@ -71,7 +71,7 @@ export default function (pi: HookAPI) {
 
 			// Run extraction with loader UI
 			const result = await ctx.ui.custom<string | null>((tui, theme, done) => {
-				const loader = new BorderedLoader(tui, theme, `Extracting questions using ${ctx.model!.id}...`);
+				const loader = new BorderedLoader(tui, theme, `Extracting questions using ${ctx.model!.id}…`);
 				loader.onAbort = () => done(null);
 
 				// Do the work

package/examples/hooks/status-line.ts

@@ -18,7 +18,7 @@ export default function (pi: HookAPI) {
 		turnCount++;
 		const theme = ctx.ui.theme;
 		const spinner = theme.fg("accent", "●");
-		const text = theme.fg("dim", ` Turn ${turnCount}...`);
+		const text = theme.fg("dim", ` Turn ${turnCount}…`);
 		ctx.ui.setStatus("status-demo", spinner + text);
 	});
 

package/examples/sdk/11-sessions.ts

@@ -28,7 +28,7 @@ console.log("Continued session:", continued.sessionFile);
 const sessions = SessionManager.list(process.cwd());
 console.log(`\nFound ${sessions.length} sessions:`);
 for (const info of sessions.slice(0, 3)) {
-	console.log(`  ${info.id.slice(0, 8)}... - "${info.firstMessage.slice(0, 30)}..."`);
+	console.log(`  ${info.id.slice(0, 8)}… - "${info.firstMessage.slice(0, 30)}…"`);
 }
 
 if (sessions.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "11.2.2",
+	"version": "11.3.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -87,15 +87,15 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@oclif/core": "^4.5.6",
-		"@oclif/plugin-autocomplete": "^3.2.23",
 		"@mozilla/readability": "0.6.0",
-		"@oh-my-pi/omp-stats": "11.2.2",
-		"@oh-my-pi/pi-agent-core": "11.2.2",
-		"@oh-my-pi/pi-ai": "11.2.2",
-		"@oh-my-pi/pi-natives": "11.2.2",
-		"@oh-my-pi/pi-tui": "11.2.2",
-		"@oh-my-pi/pi-utils": "11.2.2",
+		"@oclif/core": "^4.8.0",
+		"@oclif/plugin-autocomplete": "^3.2.40",
+		"@oh-my-pi/omp-stats": "11.3.0",
+		"@oh-my-pi/pi-agent-core": "11.3.0",
+		"@oh-my-pi/pi-ai": "11.3.0",
+		"@oh-my-pi/pi-natives": "11.3.0",
+		"@oh-my-pi/pi-tui": "11.3.0",
+		"@oh-my-pi/pi-utils": "11.3.0",
 		"@sinclair/typebox": "^0.34.48",
 		"ajv": "^8.17.1",
 		"chalk": "^5.6.2",
@@ -107,7 +107,7 @@
 		"jsdom": "28.0.0",
 		"marked": "^17.0.1",
 		"node-html-parser": "^7.0.2",
-		"puppeteer": "^24.36.1",
+		"puppeteer": "^24.37.1",
 		"smol-toml": "^1.6.0",
 		"zod": "^4.3.6"
 	},

package/src/cli/args.ts

@@ -21,12 +21,11 @@ export interface Args {
 	appendSystemPrompt?: string;
 	thinking?: ThinkingLevel;
 	continue?: boolean;
-	resume?: boolean;
+	resume?: string | true;
 	help?: boolean;
 	version?: boolean;
 	mode?: Mode;
 	noSession?: boolean;
-	session?: string;
 	sessionDir?: string;
 	models?: string[];
 	tools?: string[];
@@ -76,8 +75,13 @@ export function parseArgs(args: string[], extensionFlags?: Map<string, { type: "
 			}
 		} else if (arg === "--continue" || arg === "-c") {
 			result.continue = true;
-		} else if (arg === "--resume" || arg === "-r") {
-			result.resume = true;
+		} else if (arg === "--resume" || arg === "-r" || arg === "--session") {
+			const next = args[i + 1];
+			if (next && !next.startsWith("-")) {
+				result.resume = args[++i];
+			} else {
+				result.resume = true;
+			}
 		} else if (arg === "--provider" && i + 1 < args.length) {
 			result.provider = args[++i];
 		} else if (arg === "--model" && i + 1 < args.length) {
@@ -96,8 +100,6 @@ export function parseArgs(args: string[], extensionFlags?: Map<string, { type: "
 			result.appendSystemPrompt = args[++i];
 		} else if (arg === "--no-session") {
 			result.noSession = true;
-		} else if (arg === "--session" && i + 1 < args.length) {
-			result.session = args[++i];
 		} else if (arg === "--session-dir" && i + 1 < args.length) {
 			result.sessionDir = args[++i];
 		} else if (arg === "--models" && i + 1 < args.length) {
@@ -214,6 +216,7 @@ export function getExtraHelpText(): string {
 
   ${chalk.dim("# Configuration")}
   PI_CODING_AGENT_DIR        - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  PI_PACKAGE_DIR             - Override package directory (for Nix/Guix store paths)
   PI_SMOL_MODEL              - Override smol/fast model (see --smol)
   PI_SLOW_MODEL              - Override slow/reasoning model (see --slow)
   PI_PLAN_MODEL              - Override planning model (see --plan)

package/src/cli/update-cli.ts

@@ -190,7 +190,7 @@ async function updateViaBinary(release: ReleaseInfo): Promise<void> {
 	const nativePath = path.join(execDir, nativeAddonName);
 	const nativeTempPath = `${nativePath}.new`;
 
-	console.log(chalk.dim(`Downloading ${binaryName}...`));
+	console.log(chalk.dim(`Downloading ${binaryName}…`));
 
 	// Download to temp file
 	const response = await fetch(asset.url, { redirect: "follow" });
@@ -202,7 +202,7 @@ async function updateViaBinary(release: ReleaseInfo): Promise<void> {
 	await pipeline(response.body, fileStream);
 
 	// Download native addon
-	console.log(chalk.dim(`Downloading ${nativeAddonName}...`));
+	console.log(chalk.dim(`Downloading ${nativeAddonName}…`));
 
 	const nativeResponse = await fetch(nativeAsset.url, { redirect: "follow" });
 	if (!nativeResponse.ok || !nativeResponse.body) {

package/src/commands/index/index.ts

@@ -58,12 +58,9 @@ export default class Index extends Command {
 			char: "c",
 			description: "Continue previous session",
 		}),
-		resume: Flags.boolean({
+		resume: Flags.string({
 			char: "r",
-			description: "Select a session to resume",
-		}),
-		session: Flags.string({
-			description: "Use specific session file",
+			description: "Resume a session (by ID prefix, path, or picker if omitted)",
 		}),
 		"session-dir": Flags.string({
 			description: "Directory for session storage and lookup",

package/src/commit/agentic/agent.ts

@@ -307,5 +307,5 @@ Call the missing tool(s) now.
 
 function truncateToolArg(value: string): string {
 	if (value.length <= 40) return value;
-	return `${value.slice(0, 37)}...`;
+	return `${value.slice(0, 39)}…`;
 }

package/src/commit/changelog/index.ts

@@ -54,7 +54,7 @@ export async function runChangelogFlow({
 
 	const updated: string[] = [];
 	for (const boundary of boundaries) {
-		onProgress?.(`Generating entries for ${boundary.changelogPath}...`);
+		onProgress?.(`Generating entries for ${boundary.changelogPath}…`);
 		const diff = await git.getDiffForFiles(boundary.files, true);
 		if (!diff.trim()) continue;
 		const stat = await git.getStatForFiles(boundary.files, true);
@@ -108,7 +108,7 @@ export async function applyChangelogProposals({
 			(!proposal.deletions || Object.keys(proposal.deletions).length === 0)
 		)
 			continue;
-		onProgress?.(`Applying entries for ${proposal.path}...`);
+		onProgress?.(`Applying entries for ${proposal.path}…`);
 		const exists = fs.existsSync(proposal.path);
 		if (!exists) {
 			logger.warn("commit changelog path missing", { path: proposal.path });

package/src/config/keybindings.ts

@@ -26,11 +26,16 @@ export type AppAction =
 	| "togglePlanMode"
 	| "expandTools"
 	| "toggleThinking"
+	| "toggleSessionNamedFilter"
 	| "externalEditor"
 	| "historySearch"
 	| "followUp"
 	| "dequeue"
-	| "pasteImage";
+	| "pasteImage"
+	| "newSession"
+	| "tree"
+	| "fork"
+	| "resume";
 
 /**
  * All configurable actions.
@@ -60,10 +65,15 @@ export const DEFAULT_APP_KEYBINDINGS: Record<AppAction, KeyId | KeyId[]> = {
 	historySearch: "ctrl+r",
 	expandTools: "ctrl+o",
 	toggleThinking: "ctrl+t",
+	toggleSessionNamedFilter: "ctrl+n",
 	externalEditor: "ctrl+g",
 	followUp: "ctrl+enter",
 	dequeue: "alt+up",
 	pasteImage: "ctrl+v",
+	newSession: [],
+	tree: [],
+	fork: [],
+	resume: [],
 };
 
 /**
@@ -88,10 +98,15 @@ const APP_ACTIONS: AppAction[] = [
 	"historySearch",
 	"expandTools",
 	"toggleThinking",
+	"toggleSessionNamedFilter",
 	"externalEditor",
 	"followUp",
 	"dequeue",
 	"pasteImage",
+	"newSession",
+	"tree",
+	"fork",
+	"resume",
 ];
 
 function isAppAction(action: string): action is AppAction {

package/src/config/model-registry.ts

@@ -54,9 +54,10 @@ const OpenAICompatSchema = Type.Object({
 });
 
 // Schema for custom model definition
+// Most fields are optional with sensible defaults for local models (Ollama, LM Studio, etc.)
 const ModelDefinitionSchema = Type.Object({
 	id: Type.String({ minLength: 1 }),
-	name: Type.String({ minLength: 1 }),
+	name: Type.Optional(Type.String({ minLength: 1 })),
 	api: Type.Optional(
 		Type.Union([
 			Type.Literal("openai-completions"),
@@ -68,16 +69,18 @@ const ModelDefinitionSchema = Type.Object({
 			Type.Literal("google-vertex"),
 		]),
 	),
-	reasoning: Type.Boolean(),
-	input: Type.Array(Type.Union([Type.Literal("text"), Type.Literal("image")])),
-	cost: Type.Object({
-		input: Type.Number(),
-		output: Type.Number(),
-		cacheRead: Type.Number(),
-		cacheWrite: Type.Number(),
-	}),
-	contextWindow: Type.Number(),
-	maxTokens: Type.Number(),
+	reasoning: Type.Optional(Type.Boolean()),
+	input: Type.Optional(Type.Array(Type.Union([Type.Literal("text"), Type.Literal("image")]))),
+	cost: Type.Optional(
+		Type.Object({
+			input: Type.Number(),
+			output: Type.Number(),
+			cacheRead: Type.Number(),
+			cacheWrite: Type.Number(),
+		}),
+	),
+	contextWindow: Type.Optional(Type.Number()),
+	maxTokens: Type.Optional(Type.Number()),
 	headers: Type.Optional(Type.Record(Type.String(), Type.String())),
 	compat: Type.Optional(OpenAICompatSchema),
 });
@@ -141,10 +144,10 @@ export const ModelsConfigFile = new ConfigFile<ModelsConfig>("models", ModelsCon
 				}
 
 				if (!modelDef.id) throw new Error(`Provider ${providerName}: model missing "id"`);
-				if (!modelDef.name) throw new Error(`Provider ${providerName}: model missing "name"`);
-				if (modelDef.contextWindow <= 0)
+				// Validate contextWindow/maxTokens only if provided (they have defaults)
+				if (modelDef.contextWindow !== undefined && modelDef.contextWindow <= 0)
 					throw new Error(`Provider ${providerName}, model ${modelDef.id}: invalid contextWindow`);
-				if (modelDef.maxTokens <= 0)
+				if (modelDef.maxTokens !== undefined && modelDef.maxTokens <= 0)
 					throw new Error(`Provider ${providerName}, model ${modelDef.id}: invalid maxTokens`);
 			}
 		}
@@ -377,17 +380,19 @@ export class ModelRegistry {
 				}
 
 				// baseUrl is validated to exist for providers with models
+				// Apply defaults for optional fields
+				const defaultCost = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
 				models.push({
 					id: modelDef.id,
-					name: modelDef.name,
+					name: modelDef.name ?? modelDef.id,
 					api: api as Api,
 					provider: providerName,
 					baseUrl: providerConfig.baseUrl!,
-					reasoning: modelDef.reasoning,
-					input: modelDef.input as ("text" | "image")[],
-					cost: modelDef.cost,
-					contextWindow: modelDef.contextWindow,
-					maxTokens: modelDef.maxTokens,
+					reasoning: modelDef.reasoning ?? false,
+					input: (modelDef.input ?? ["text"]) as ("text" | "image")[],
+					cost: modelDef.cost ?? defaultCost,
+					contextWindow: modelDef.contextWindow ?? 128000,
+					maxTokens: modelDef.maxTokens ?? 16384,
 					headers,
 					compat: modelDef.compat,
 				} as Model<Api>);

package/src/config/model-resolver.ts

@@ -11,25 +11,25 @@ import type { Settings } from "./settings";
 
 /** Default model IDs for each known provider */
 export const defaultModelPerProvider: Record<KnownProvider, string> = {
-	"amazon-bedrock": "us.anthropic.claude-sonnet-4-5-20250514-v1:0",
-	anthropic: "claude-sonnet-4-5",
+	"amazon-bedrock": "us.anthropic.claude-opus-4-6-v1",
+	anthropic: "claude-opus-4-6",
 	openai: "gpt-5.1-codex",
-	"openai-codex": "codex-max",
+	"openai-codex": "gpt-5.3-codex",
 	google: "gemini-2.5-pro",
 	"google-gemini-cli": "gemini-2.5-pro",
 	"google-antigravity": "gemini-3-pro-high",
-	"google-vertex": "gemini-2.5-pro",
+	"google-vertex": "gemini-3-pro-preview",
 	"github-copilot": "gpt-4o",
-	cursor: "claude-sonnet-4-5",
+	cursor: "claude-opus-4-6",
 	openrouter: "openai/gpt-5.1-codex",
-	"vercel-ai-gateway": "claude-sonnet-4-5",
+	"vercel-ai-gateway": "anthropic/claude-opus-4-6",
 	xai: "grok-4-fast-non-reasoning",
 	groq: "openai/gpt-oss-120b",
 	cerebras: "zai-glm-4.6",
 	zai: "glm-4.6",
 	mistral: "devstral-medium-latest",
-	minimax: "MiniMax-M2",
-	opencode: "claude-opus-4-5",
+	minimax: "MiniMax-M2.1",
+	opencode: "claude-opus-4-6",
 	"kimi-code": "kimi-k2.5",
 };
 

package/src/config/resolve-config-value.ts

@@ -0,0 +1,92 @@
+/**
+ * Resolve configuration values that may be shell commands, environment variables, or literals.
+ *
+ * Note: command execution is async to avoid blocking the TUI.
+ */
+
+import { executeShell } from "@oh-my-pi/pi-natives";
+
+/** Cache for successful shell command results (persists for process lifetime). */
+const commandResultCache = new Map<string, string>();
+
+/** De-duplicates concurrent executions for the same command. */
+const commandInFlight = new Map<string, Promise<string | undefined>>();
+
+/**
+ * Resolve a config value (API key, header value, etc.) to an actual value.
+ * - If starts with "!", executes the rest as a shell command and uses stdout (cached)
+ * - Otherwise checks environment variable first, then treats as literal (not cached)
+ */
+export async function resolveConfigValue(config: string): Promise<string | undefined> {
+	if (config.startsWith("!")) {
+		return await executeCommand(config);
+	}
+	const envValue = process.env[config];
+	return envValue || config;
+}
+
+async function executeCommand(commandConfig: string): Promise<string | undefined> {
+	const cached = commandResultCache.get(commandConfig);
+	if (cached !== undefined) {
+		return cached;
+	}
+
+	const existing = commandInFlight.get(commandConfig);
+	if (existing) {
+		return await existing;
+	}
+
+	const command = commandConfig.slice(1);
+	const promise = runShellCommand(command, 10_000)
+		.then(result => {
+			if (result !== undefined) {
+				commandResultCache.set(commandConfig, result);
+			}
+			return result;
+		})
+		.finally(() => {
+			commandInFlight.delete(commandConfig);
+		});
+
+	commandInFlight.set(commandConfig, promise);
+	return await promise;
+}
+
+async function runShellCommand(command: string, timeoutMs: number): Promise<string | undefined> {
+	try {
+		let output = "";
+		const result = await executeShell({ command, timeoutMs }, chunk => {
+			output += chunk;
+		});
+		if (result.timedOut || result.exitCode !== 0) {
+			return undefined;
+		}
+		const trimmed = output.trim();
+		return trimmed.length > 0 ? trimmed : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+/**
+ * Resolve all header values using the same resolution logic as API keys.
+ */
+export async function resolveHeaders(
+	headers: Record<string, string> | undefined,
+): Promise<Record<string, string> | undefined> {
+	if (!headers) return undefined;
+	const resolved: Record<string, string> = {};
+	for (const [key, value] of Object.entries(headers)) {
+		const resolvedValue = await resolveConfigValue(value);
+		if (resolvedValue) {
+			resolved[key] = resolvedValue;
+		}
+	}
+	return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+
+/** Clear the config value command cache. Exported for testing. */
+export function clearConfigValueCache(): void {
+	commandResultCache.clear();
+	commandInFlight.clear();
+}

package/src/config/settings-schema.ts

@@ -242,6 +242,15 @@ export const SETTINGS_SCHEMA = {
 		default: true, // will be computed based on platform if undefined
 		ui: { tab: "display", label: "Hardware cursor", description: "Show terminal cursor for IME support" },
 	},
+	clearOnShrink: {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "display",
+			label: "Clear on shrink",
+			description: "Clear empty rows when content shrinks (may cause flicker)",
+		},
+	},
 	extensions: { type: "array", default: [] as string[] },
 	enabledModels: { type: "array", default: [] as string[] },
 	disabledProviders: { type: "array", default: [] as string[] },

package/src/config.ts

@@ -35,6 +35,14 @@ const priorityList = [
  * Walk up from import.meta.dir until we find package.json, or fall back to cwd.
  */
 export function getPackageDir(): string {
+	// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)
+	const envDir = process.env.PI_PACKAGE_DIR;
+	if (envDir) {
+		if (envDir === "~") return os.homedir();
+		if (envDir.startsWith("~/")) return os.homedir() + envDir.slice(1);
+		return envDir;
+	}
+
 	let dir = import.meta.dir;
 	while (dir !== path.dirname(dir)) {
 		if (fs.existsSync(path.join(dir, "package.json"))) {
@@ -218,7 +226,7 @@ export class ConfigFile<T> implements IConfigFile<T> {
 			}
 			return this.#storeCache({ value: parsed, status: "ok" });
 		} catch (error) {
-			if (!isEnoent(error)) {
+			if (isEnoent(error)) {
 				return this.#storeCache({ status: "not-found" });
 			}
 			logger.warn("Failed to parse config file", { path: this.path(), error });
@@ -280,6 +288,11 @@ export function getPromptsDir(): string {
 	return path.join(getAgentDir(), "prompts");
 }
 
+/** Get path to content-addressed blob store directory */
+export function getBlobsDir(): string {
+	return path.join(getAgentDir(), "blobs");
+}
+
 /** Get path to sessions directory */
 export function getSessionsDir(): string {
 	return path.join(getAgentDir(), "sessions");

package/src/export/html/template.css

@@ -473,6 +473,10 @@
       display: block;
     }
 
+    .ansi-line {
+      white-space: pre-wrap;
+    }
+
     .tool-images {
     }
 
@@ -666,6 +670,9 @@
       color: var(--error);
       padding: 0 var(--line-height);
     }
+    .tool-error {
+      color: var(--error);
+    }
 
     /* Images */
     .message-images {