@oh-my-pi/pi-coding-agent 9.3.0 → 9.4.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 ## [Unreleased]
 
+## [9.4.0] - 2026-01-31
+### Changed
+
+- Migrated environment variable handling to use centralized `getEnv()` and `getEnvApiKey()` utilities from pi-ai package for consistent API key resolution across web search providers and image tools
+- Simplified web search error messages to remove provider-specific configuration hints
+- Replaced manual space padding with `padding()` utility function from pi-tui across UI components for consistent whitespace handling
+- Improved rendering performance for Python cell output by implementing caching in the table and cell results renderers
+- Updated task tool documentation to clarify that subagents can access parent conversation context via a searchable file, reducing need to repeat information in context parameter
+- Updated plan mode prompt to guide model toward using `edit` tool for incremental plan updates instead of defaulting to `write`
+
+### Removed
+
+- Removed environment variable denylist that blocked API keys from being passed to subprocesses; API keys are now controlled via allowlist only
+
+## [9.3.1] - 2026-01-31
+### Added
+
+- Added `getCompactContext()` API to retrieve parent conversation context for subagents, excluding system prompts and tool results
+- Added automatic `submit_result` tool injection for subagents with explicit tool lists
+- Added `contextFile` parameter to pass parent conversation context to subagent sessions
+
+### Changed
+
+- Updated subagent system prompt to reference parent conversation context file when available
+- Enhanced subagent system prompt formatting with clearer backtick notation for tool and parameter names
+
+### Removed
+
+- Removed schema override notification from task summary prompt
+
 ## [9.2.5] - 2026-01-31
 ### Changed
 

package/examples/hooks/snake.ts

@@ -2,7 +2,7 @@
  * Snake game hook - play snake with /snake command
  */
 import type { HookAPI } from "@oh-my-pi/pi-coding-agent";
-import { matchesKey, visibleWidth } from "@oh-my-pi/pi-tui";
+import { matchesKey, padding, visibleWidth } from "@oh-my-pi/pi-tui";
 
 const GAME_WIDTH = 40;
 const GAME_HEIGHT = 15;
@@ -227,8 +227,8 @@ class SnakeComponent {
 		// Helper to pad content inside box
 		const boxLine = (content: string) => {
 			const contentLen = visibleWidth(content);
-			const padding = Math.max(0, boxWidth - contentLen);
-			return dim(" │") + content + " ".repeat(padding) + dim("│");
+			const pad = Math.max(0, boxWidth - contentLen);
+			return dim(" │") + content + padding(pad) + dim("│");
 		};
 
 		// Top border
@@ -291,8 +291,8 @@ class SnakeComponent {
 	private padLine(line: string, width: number): string {
 		// Calculate visible length (strip ANSI codes)
 		const visibleLen = line.replace(/\x1b\[[0-9;]*m/g, "").length;
-		const padding = Math.max(0, width - visibleLen);
-		return line + " ".repeat(padding);
+		const pad = Math.max(0, width - visibleLen);
+		return line + padding(pad);
 	}
 
 	dispose(): void {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "9.3.0",
+	"version": "9.4.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -79,12 +79,12 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@oh-my-pi/omp-stats": "9.3.0",
-		"@oh-my-pi/pi-agent-core": "9.3.0",
-		"@oh-my-pi/pi-ai": "9.3.0",
-		"@oh-my-pi/pi-natives": "9.3.0",
-		"@oh-my-pi/pi-tui": "9.3.0",
-		"@oh-my-pi/pi-utils": "9.3.0",
+		"@oh-my-pi/omp-stats": "9.4.0",
+		"@oh-my-pi/pi-agent-core": "9.4.0",
+		"@oh-my-pi/pi-ai": "9.4.0",
+		"@oh-my-pi/pi-natives": "9.4.0",
+		"@oh-my-pi/pi-tui": "9.4.0",
+		"@oh-my-pi/pi-utils": "9.4.0",
 		"@openai/agents": "^0.4.4",
 		"@sinclair/typebox": "^0.34.48",
 		"ajv": "^8.17.1",

package/src/discovery/helpers.ts

@@ -189,7 +189,12 @@ export function parseAgentFields(frontmatter: Record<string, unknown>): ParsedAg
 		return null;
 	}
 
-	const tools = parseArrayOrCSV(frontmatter.tools);
+	let tools = parseArrayOrCSV(frontmatter.tools);
+
+	// Subagents with explicit tool lists always need submit_result
+	if (tools && !tools.includes("submit_result")) {
+		tools = [...tools, "submit_result"];
+	}
 
 	// Parse spawns field (array, "*", or CSV)
 	let spawns: string[] | "*" | undefined;

package/src/ipy/gateway-coordinator.ts

@@ -88,27 +88,12 @@ const WINDOWS_ENV_ALLOWLIST = new Set([
 
 const DEFAULT_ENV_ALLOW_PREFIXES = ["LC_", "XDG_", "OMP_"];
 
-const DEFAULT_ENV_DENYLIST = new Set([
-	"OPENAI_API_KEY",
-	"ANTHROPIC_API_KEY",
-	"GOOGLE_API_KEY",
-	"GEMINI_API_KEY",
-	"OPENROUTER_API_KEY",
-	"PERPLEXITY_API_KEY",
-	"EXA_API_KEY",
-	"AZURE_OPENAI_API_KEY",
-	"MISTRAL_API_KEY",
-]);
-
 const CASE_INSENSITIVE_ENV = process.platform === "win32";
 const ACTIVE_ENV_ALLOWLIST = CASE_INSENSITIVE_ENV ? WINDOWS_ENV_ALLOWLIST : DEFAULT_ENV_ALLOWLIST;
 
 const NORMALIZED_ALLOWLIST = new Map(
 	Array.from(ACTIVE_ENV_ALLOWLIST, key => [CASE_INSENSITIVE_ENV ? key.toUpperCase() : key, key] as const),
 );
-const NORMALIZED_DENYLIST = new Set(
-	Array.from(DEFAULT_ENV_DENYLIST, key => (CASE_INSENSITIVE_ENV ? key.toUpperCase() : key)),
-);
 const NORMALIZED_ALLOW_PREFIXES = CASE_INSENSITIVE_ENV
 	? DEFAULT_ENV_ALLOW_PREFIXES.map(prefix => prefix.toUpperCase())
 	: DEFAULT_ENV_ALLOW_PREFIXES;
@@ -150,7 +135,6 @@ function filterEnv(env: Record<string, string | undefined>): Record<string, stri
 	for (const [key, value] of Object.entries(env)) {
 		if (value === undefined) continue;
 		const normalizedKey = normalizeEnvKey(key);
-		if (NORMALIZED_DENYLIST.has(normalizedKey)) continue;
 		const canonicalKey = NORMALIZED_ALLOWLIST.get(normalizedKey);
 		if (canonicalKey !== undefined) {
 			filtered[canonicalKey] = value;

package/src/modes/components/armin.ts

@@ -1,7 +1,7 @@
 /**
  * Armin says hi! A fun easter egg with animated XBM art.
  */
-import type { Component, TUI } from "@oh-my-pi/pi-tui";
+import { type Component, padding, type TUI } from "@oh-my-pi/pi-tui";
 import { theme } from "../../modes/theme/theme";
 
 // XBM image: 31x36 pixels, LSB first, 1=background, 0=foreground
@@ -87,20 +87,20 @@ export class ArminComponent implements Component {
 			return this.cachedLines;
 		}
 
-		const padding = 1;
-		const availableWidth = width - padding;
+		const indent = 1;
+		const availableWidth = width - indent;
 
 		this.cachedLines = this.currentGrid.map(row => {
 			// Clip row to available width before applying color
 			const clipped = row.slice(0, availableWidth).join("");
-			const padRight = Math.max(0, width - padding - clipped.length);
-			return ` ${theme.fg("accent", clipped)}${" ".repeat(padRight)}`;
+			const padRight = Math.max(0, width - indent - clipped.length);
+			return ` ${theme.fg("accent", clipped)}${padding(padRight)}`;
 		});
 
 		// Add "ARMIN SAYS HI" at the end
 		const message = "ARMIN SAYS HI";
-		const msgPadRight = Math.max(0, width - padding - message.length);
-		this.cachedLines.push(` ${theme.fg("accent", message)}${" ".repeat(msgPadRight)}`);
+		const msgPadRight = Math.max(0, width - indent - message.length);
+		this.cachedLines.push(` ${theme.fg("accent", message)}${padding(msgPadRight)}`);
 
 		this.cachedWidth = width;
 		this.cachedVersion = this.gridVersion;

package/src/modes/components/extensions/extension-dashboard.ts

@@ -11,7 +11,16 @@
  * - Space: Toggle selected item (or master switch)
  * - Esc: Close dashboard (clears search first if active)
  */
-import { type Component, Container, matchesKey, Spacer, Text, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import {
+	type Component,
+	Container,
+	matchesKey,
+	padding,
+	Spacer,
+	Text,
+	truncateToWidth,
+	visibleWidth,
+} from "@oh-my-pi/pi-tui";
 import type { SettingsManager } from "../../../config/settings-manager";
 import { DynamicBorder } from "../../../modes/components/dynamic-border";
 import { theme } from "../../../modes/theme/theme";
@@ -296,7 +305,7 @@ class TwoColumnBody implements Component {
 
 		for (let i = 0; i < numLines; i++) {
 			const left = truncateToWidth(leftLines[i] ?? "", leftWidth);
-			const leftPadded = left + " ".repeat(Math.max(0, leftWidth - visibleWidth(left)));
+			const leftPadded = left + padding(Math.max(0, leftWidth - visibleWidth(left)));
 			const right = truncateToWidth(rightLines[i] ?? "", rightWidth);
 			combined.push(leftPadded + separator + right);
 		}

package/src/modes/components/extensions/extension-list.ts

@@ -5,7 +5,7 @@
  * that toggles the entire provider. All items below are dimmed when the
  * master switch is off.
  */
-import { type Component, matchesKey, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import { type Component, matchesKey, padding, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import { isProviderEnabled } from "../../../discovery";
 import { theme } from "../../../modes/theme/theme";
 import { applyFilter } from "./state-manager";
@@ -272,7 +272,7 @@ export class ExtensionList implements Component {
 		if (width >= targetWidth) {
 			return truncateToWidth(text, targetWidth);
 		}
-		return text + " ".repeat(targetWidth - width);
+		return text + padding(targetWidth - width);
 	}
 
 	private rebuildList(): void {

package/src/modes/components/footer.ts

@@ -1,7 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import type { AssistantMessage } from "@oh-my-pi/pi-ai";
-import { type Component, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import { type Component, padding, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import { isEnoent } from "@oh-my-pi/pi-utils";
 import { theme } from "../../modes/theme/theme";
 import type { AgentSession } from "../../session/agent-session";
@@ -283,8 +283,8 @@ export class FooterComponent implements Component {
 		let statsLine: string;
 		if (totalNeeded <= width) {
 			// Both fit - add padding to right-align model
-			const padding = " ".repeat(width - statsLeftWidth - rightSideWidth);
-			statsLine = statsLeft + padding + rightSide;
+			const pad = padding(width - statsLeftWidth - rightSideWidth);
+			statsLine = statsLeft + pad + rightSide;
 		} else {
 			// Need to truncate right side
 			const availableForRight = width - statsLeftWidth - minPadding;
@@ -293,8 +293,8 @@ export class FooterComponent implements Component {
 				const plainRightSide = rightSide.replace(/\x1b\[[0-9;]*m/g, "");
 				const truncatedPlain = plainRightSide.substring(0, availableForRight);
 				// For simplicity, just use plain truncated version (loses color, but fits)
-				const padding = " ".repeat(width - statsLeftWidth - truncatedPlain.length);
-				statsLine = statsLeft + padding + truncatedPlain;
+				const pad = padding(width - statsLeftWidth - truncatedPlain.length);
+				statsLine = statsLeft + pad + truncatedPlain;
 			} else {
 				// Not enough space for right side at all
 				statsLine = statsLeft;

package/src/modes/components/history-search.ts

@@ -3,6 +3,7 @@ import {
 	Container,
 	Input,
 	matchesKey,
+	padding,
 	Spacer,
 	Text,
 	truncateToWidth,
@@ -50,7 +51,7 @@ class HistoryResultsList implements Component {
 
 			const cursorSymbol = `${theme.nav.cursor} `;
 			const cursorWidth = visibleWidth(cursorSymbol);
-			const cursor = isSelected ? theme.fg("accent", cursorSymbol) : " ".repeat(cursorWidth);
+			const cursor = isSelected ? theme.fg("accent", cursorSymbol) : padding(cursorWidth);
 			const maxWidth = width - cursorWidth;
 
 			const normalized = entry.prompt.replace(/\s+/g, " ").trim();

package/src/modes/components/hook-selector.ts

@@ -2,7 +2,7 @@
  * Generic selector component for hooks.
  * Displays a list of string options with keyboard navigation.
  */
-import { Container, matchesKey, Spacer, Text, type TUI, visibleWidth } from "@oh-my-pi/pi-tui";
+import { Container, matchesKey, padding, Spacer, Text, type TUI, visibleWidth } from "@oh-my-pi/pi-tui";
 import { theme } from "../../modes/theme/theme";
 import { CountdownTimer } from "./countdown-timer";
 import { DynamicBorder } from "./dynamic-border";
@@ -29,7 +29,7 @@ class OutlinedList extends Container {
 		const innerWidth = Math.max(1, width - 2);
 		const content = this.lines.map(line => {
 			const pad = Math.max(0, innerWidth - visibleWidth(line));
-			return `${borderColor(theme.boxSharp.vertical)}${line}${" ".repeat(pad)}${borderColor(theme.boxSharp.vertical)}`;
+			return `${borderColor(theme.boxSharp.vertical)}${line}${padding(pad)}${borderColor(theme.boxSharp.vertical)}`;
 		});
 		return [horizontal, ...content, horizontal];
 	}

package/src/modes/components/session-selector.ts

@@ -3,6 +3,7 @@ import {
 	Container,
 	Input,
 	matchesKey,
+	padding,
 	Spacer,
 	Text,
 	truncateToWidth,
@@ -122,7 +123,7 @@ class SessionList implements Component {
 			// First line: cursor + title (or first message if no title)
 			const cursorSymbol = `${theme.nav.cursor} `;
 			const cursorWidth = visibleWidth(cursorSymbol);
-			const cursor = isSelected ? theme.fg("accent", cursorSymbol) : " ".repeat(cursorWidth);
+			const cursor = isSelected ? theme.fg("accent", cursorSymbol) : padding(cursorWidth);
 			const maxWidth = width - cursorWidth; // Account for cursor width
 
 			if (session.title) {

package/src/modes/components/status-line-segment-editor.ts

@@ -8,7 +8,7 @@
  * - Shift+J/K: Reorder segment within column
  * - Live preview shown in the actual status line above
  */
-import { Container, matchesKey } from "@oh-my-pi/pi-tui";
+import { Container, matchesKey, padding } from "@oh-my-pi/pi-tui";
 import type { StatusLineSegmentId } from "../../config/settings-manager";
 import { theme } from "../../modes/theme/theme";
 import { ALL_SEGMENT_IDS } from "./status-line/segments";
@@ -351,7 +351,7 @@ export class StatusLineSegmentEditorComponent extends Container {
 		}
 
 		// Pad to column width (accounting for ANSI codes)
-		const padding = colWidth - label.length - 1;
-		return text + " ".repeat(Math.max(0, padding));
+		const padSize = colWidth - label.length - 1;
+		return text + padding(Math.max(0, padSize));
 	}
 }

package/src/modes/components/status-line.ts

@@ -1,7 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import type { AssistantMessage } from "@oh-my-pi/pi-ai";
-import { type Component, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import { type Component, padding, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import { $ } from "bun";
 import type { StatusLineSegmentOptions, StatusLineSettings } from "../../config/settings-manager";
 import { theme } from "../../modes/theme/theme";
@@ -378,7 +378,7 @@ export class StatusLineComponent implements Component {
 		leftWidth = groupWidth(left, leftCapWidth, leftSepWidth);
 		rightWidth = groupWidth(right, rightCapWidth, rightSepWidth);
 		const gapWidth = Math.max(1, topFillWidth - leftWidth - rightWidth);
-		return leftGroup + " ".repeat(gapWidth) + rightGroup;
+		return leftGroup + padding(gapWidth) + rightGroup;
 	}
 
 	getTopBorder(width: number): { content: string; width: number } {

package/src/modes/components/welcome.ts

@@ -1,4 +1,4 @@
-import { type Component, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
+import { type Component, padding, truncateToWidth, visibleWidth } from "@oh-my-pi/pi-tui";
 import { APP_NAME } from "../../config";
 import { theme } from "../../modes/theme/theme";
 
@@ -169,7 +169,7 @@ export class WelcomeComponent implements Component {
 		}
 		const leftPad = Math.floor((width - visLen) / 2);
 		const rightPad = width - visLen - leftPad;
-		return " ".repeat(leftPad) + text + " ".repeat(rightPad);
+		return padding(leftPad) + text + padding(rightPad);
 	}
 
 	/** Apply magenta→cyan gradient to a string */
@@ -224,6 +224,6 @@ export class WelcomeComponent implements Component {
 			}
 			return `${truncated}${ellipsis}`;
 		}
-		return str + " ".repeat(width - visLen);
+		return str + padding(width - visLen);
 	}
 }

package/src/modes/controllers/command-controller.ts

@@ -2,7 +2,7 @@ import * as fs from "node:fs/promises";
 import * as os from "node:os";
 import * as path from "node:path";
 import type { UsageLimit, UsageReport } from "@oh-my-pi/pi-ai";
-import { Loader, Markdown, Spacer, Text, visibleWidth } from "@oh-my-pi/pi-tui";
+import { Loader, Markdown, padding, Spacer, Text, visibleWidth } from "@oh-my-pi/pi-tui";
 import { $ } from "bun";
 import { nanoid } from "nanoid";
 import { loadCustomShare } from "../../export/custom-share";
@@ -773,7 +773,7 @@ function formatAccountHeader(limit: UsageLimit, report: UsageReport, index: numb
 function padColumn(text: string, width: number): string {
 	const visible = visibleWidth(text);
 	if (visible >= width) return text;
-	return `${text}${" ".repeat(width - visible)}`;
+	return `${text}${padding(width - visible)}`;
 }
 
 function resolveAggregateStatus(limits: UsageLimit[]): UsageLimit["status"] {

package/src/patch/normalize.ts

@@ -4,6 +4,8 @@
  * Handles line endings, BOM, whitespace, and Unicode normalization.
  */
 
+import { padding } from "@oh-my-pi/pi-tui";
+
 // ═══════════════════════════════════════════════════════════════════════════
 // Line Ending Utilities
 // ═══════════════════════════════════════════════════════════════════════════
@@ -194,7 +196,7 @@ export function convertLeadingTabsToSpaces(text: string, spacesPerTab: number):
 			if (trimmed.length === 0) return line;
 			const leading = getLeadingWhitespace(line);
 			if (!leading.includes("\t") || leading.includes(" ")) return line;
-			const converted = " ".repeat(leading.length * spacesPerTab);
+			const converted = padding(leading.length * spacesPerTab);
 			return converted + trimmed;
 		})
 		.join("\n");

package/src/prompts/system/plan-mode-active.md

@@ -18,6 +18,7 @@ Create your plan at `{{planFilePath}}`.
 {{/if}}
 
 The plan file is the ONLY file you may write or edit.
+Use `{{editToolName}}` for incremental updates; use `{{writeToolName}}` only when creating or fully replacing the plan.
 
 <important>
 Plan execution runs in a fresh context (session cleared). Make the plan file self-contained: include any requirements, decisions, key findings, and remaining todos needed to continue without prior session history.
@@ -55,8 +56,8 @@ Use `ask` to clarify:
 - Preferences for UI/UX, performance, edge cases
 
 Batch questions. Do not ask what you can answer by exploring.
-### 3. Write Incrementally
-Update the plan file as you learn. Do not wait until the end.
+### 3. Update Incrementally
+Use `{{editToolName}}` to update the plan file as you learn. Do not wait until the end.
 ### 4. Calibrate
 - Large unspecified task → multiple interview rounds
 - Smaller task → fewer or no questions
@@ -86,8 +87,8 @@ Draft approach based on exploration. Consider trade-offs briefly, then choose.
 ### Phase 3: Review
 Read critical files. Verify plan matches original request. Use `ask` to clarify remaining questions.
 
-### Phase 4: Write Plan
-Write to `{{planFilePath}}`:
+### Phase 4: Update Plan
+Update `{{planFilePath}}` (use `{{editToolName}}` for changes, `{{writeToolName}}` only if creating from scratch):
 - Recommended approach only
 - Paths of critical files to modify
 - Verification section

package/src/prompts/system/subagent-system-prompt.md

@@ -1,24 +1,31 @@
 {{base}}
------------------------------------
+
+====================================================
 
 {{agent}}
 
+{{#if contextFile}}
+<context>
+If you need additional context about the parent conversation, check {{contextFile}} (e.g., `tail -100` or `grep` for relevant terms).
+</context>
+{{/if}}
+
 <critical>
 {{#if worktree}}
 - You MUST work under this working tree: {{worktree}}. Do not modify anything under the original repository.
 {{/if}}
-- You MUST call the submit_result tool exactly once when finished. Do not output JSON in text. Do not end with a plain-text summary. Call submit_result with your result as the data parameter.
+- You MUST call the `submit_result` tool exactly once when finished. Do not output JSON in text. Do not end with a plain-text summary. Call `submit_result` with your result as the `data` parameter.
 {{#if outputSchema}}
-- If you cannot complete the task, call submit_result with status="aborted" and an error message. Do not provide a success result or pretend completion.
+- If you cannot complete the task, call `submit_result` with `status="aborted"` and an error message. Do not provide a success result or pretend completion.
 {{else}}
-- If you cannot complete the task, call submit_result with status="aborted" and an error message. Do not claim success.
+- If you cannot complete the task, call `submit_result` with `status="aborted"` and an error message. Do not claim success.
 {{/if}}
 {{#if outputSchema}}
-- The data parameter MUST be valid JSON matching this TypeScript interface:
-```typescript
+- The `data` parameter MUST be valid JSON matching this TypeScript interface:
+```ts
 {{jtdToTypeScript outputSchema}}
 ```
 {{/if}}
-- If you cannot complete the task, call submit_result exactly once with a result that explicitly indicates failure or abort status (use a failure/notes field if available). Do not claim success.
+- If you cannot complete the task, call `submit_result` exactly once with a result that explicitly indicates failure or abort status (use a failure/notes field if available). Do not claim success.
 - Keep going until request is fully fulfilled. This matters.
 </critical>

package/src/prompts/tools/task-summary.md

@@ -20,13 +20,6 @@
 {{/unless}}
 {{/each}}
 
-{{#if schemaOverridden}}
-<schema-note>
-Note: Agent '{{agentName}}' has a fixed output schema:
-{{requiredSchema}}
-</schema-note>
-{{/if}}
-
 {{#if patchApplySummary}}
 <patch-summary>
 {{patchApplySummary}}

package/src/prompts/tools/task.md

@@ -5,10 +5,10 @@ Launch a new agent to handle complex, multi-step tasks autonomously. Each agent
 <critical>
 This matters. Get it right.
 
-Subagents have NO access to conversation history. They only see:
-1. Their agent-specific system prompt
-2. The `context` string you provide
-3. The `task` string you provide
+Subagents can access parent conversation context via a file—they can grep or tail it for details you don't include. Don't repeat information unnecessarily; focus `context` on:
+- Task-specific constraints and decisions
+- Critical requirements that must not be missed
+- Information not easily found in the codebase
 
 Use a single Task call with multiple `tasks` entries when parallelizing. Multiple concurrent Task calls bypass coordination.
 
@@ -35,12 +35,12 @@ This matters. Be thorough.
 4. **Always provide a `schema`** with typed properties. Avoid `{ "type": "string" }`—if data has any structure (list, fields, categories), model it. Plain text is almost never the right choice.
 5. Assign distinct file scopes per task to avoid conflicts.
 6. Trust the returned data, then verify with tools when correctness matters.
-7. The `context` must be self-contained. Paste relevant file contents, quote user requirements verbatim, include data from prior tool results. "The output user showed" means nothing to a subagent.
+7. For critical constraints, be explicit in `context`. For general background, subagents can search the parent context file themselves.
 </instruction>
 
 <parameters>
 - `agent`: Agent type to use for all tasks
-- `context`: Template with `\{{placeholders}}` for multi-task. Must be self-contained—include all information the subagent needs. Subagents cannot see conversation history, images, or prior tool results. Reproduce relevant content directly: paste file snippets, quote user requirements, embed data. Each placeholder is filled from task args. `\{{id}}` and `\{{description}}` are always available.
+- `context`: Template with `\{{placeholders}}` for multi-task. Include critical constraints and task-specific decisions. Subagents have access to parent conversation context via a searchable file, so don't repeat everything—focus on what matters. `\{{id}}` and `\{{description}}` are always available.
 - `isolated`: (optional) Run each task in its own git worktree and return patches; patches are applied only if all apply cleanly.
 - `tasks`: Array of `{id, description, args}` - tasks to run in parallel
 		- `id`: Short CamelCase identifier (max 32 chars, e.g., "SessionStore", "LspRefactor")

package/src/sdk.ts

@@ -760,6 +760,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
 			return undefined;
 		},
 		getPlanModeState: () => session.getPlanModeState(),
+		getCompactContext: () => session.formatCompactContext(),
 		settings: settingsManager,
 		settingsManager,
 		authStorage,

package/src/session/agent-session.ts

@@ -3916,6 +3916,69 @@ Be thorough - include exact file paths, function names, error messages, and tech
 		return lines.join("\n").trim();
 	}
 
+	/**
+	 * Format the conversation as compact context for subagents.
+	 * Includes only user messages and assistant text responses.
+	 * Excludes: system prompt, tool definitions, tool calls/results, thinking blocks.
+	 */
+	formatCompactContext(): string {
+		const lines: string[] = [];
+		lines.push("# Conversation Context");
+		lines.push("");
+		lines.push(
+			"This is a summary of the parent conversation. Read this if you need additional context about what was discussed or decided.",
+		);
+		lines.push("");
+
+		for (const msg of this.messages) {
+			if (msg.role === "user") {
+				lines.push("## User");
+				lines.push("");
+				if (typeof msg.content === "string") {
+					lines.push(msg.content);
+				} else {
+					for (const c of msg.content) {
+						if (c.type === "text") {
+							lines.push(c.text);
+						} else if (c.type === "image") {
+							lines.push("[Image attached]");
+						}
+					}
+				}
+				lines.push("");
+			} else if (msg.role === "assistant") {
+				const assistantMsg = msg as AssistantMessage;
+				// Only include text content, skip tool calls and thinking
+				const textParts: string[] = [];
+				for (const c of assistantMsg.content) {
+					if (c.type === "text" && c.text.trim()) {
+						textParts.push(c.text);
+					}
+				}
+				if (textParts.length > 0) {
+					lines.push("## Assistant");
+					lines.push("");
+					lines.push(textParts.join("\n\n"));
+					lines.push("");
+				}
+			} else if (msg.role === "fileMention") {
+				const fileMsg = msg as FileMentionMessage;
+				const paths = fileMsg.files.map(f => f.path).join(", ");
+				lines.push(`[Files referenced: ${paths}]`);
+				lines.push("");
+			} else if (msg.role === "compactionSummary") {
+				const compactMsg = msg as CompactionSummaryMessage;
+				lines.push("## Earlier Context (Summarized)");
+				lines.push("");
+				lines.push(compactMsg.summary);
+				lines.push("");
+			}
+			// Skip: toolResult, bashExecution, pythonExecution, branchSummary, custom, hookMessage
+		}
+
+		return lines.join("\n").trim();
+	}
+
 	// =========================================================================
 	// Extension System
 	// =========================================================================

package/src/task/executor.ts

@@ -196,6 +196,8 @@ export interface ExecutorOptions {
 	sessionFile?: string | null;
 	persistArtifacts?: boolean;
 	artifactsDir?: string;
+	/** Path to parent conversation context file */
+	contextFile?: string;
 	eventBus?: EventBus;
 	contextFiles?: ContextFileEntry[];
 	skills?: Skill[];
@@ -948,6 +950,7 @@ export async function runSubprocess(options: ExecutorOptions): Promise<SingleRes
 						agent: agent.systemPrompt,
 						worktree: worktree ?? "",
 						outputSchema: normalizedOutputSchema,
+						contextFile: options.contextFile,
 					}),
 				sessionManager,
 				hasUI: false,

package/src/task/index.ts

@@ -211,7 +211,6 @@ export class TaskTool implements AgentTool<typeof taskSchema, TaskToolDetails, T
 		const thinkingLevelOverride = effectiveAgent.thinkingLevel;
 
 		// Output schema priority: agent frontmatter > params > inherited from parent session
-		const schemaOverridden = outputSchema !== undefined && effectiveAgent.output !== undefined;
 		const effectiveOutputSchema = effectiveAgent.output ?? outputSchema ?? this.session.outputSchema;
 
 		// Handle empty or missing tasks
@@ -382,6 +381,15 @@ export class TaskTool implements AgentTool<typeof taskSchema, TaskToolDetails, T
 				};
 			}
 
+			// Write parent conversation context for subagents
+			await fs.mkdir(effectiveArtifactsDir, { recursive: true });
+			const compactContext = this.session.getCompactContext?.();
+			let contextFilePath: string | undefined;
+			if (compactContext) {
+				contextFilePath = path.join(effectiveArtifactsDir, "context.md");
+				await Bun.write(contextFilePath, compactContext);
+			}
+
 			// Build full prompts with context prepended
 			// Allocate unique IDs across the session to prevent artifact collisions
 			const outputManager =
@@ -478,6 +486,7 @@ export class TaskTool implements AgentTool<typeof taskSchema, TaskToolDetails, T
 						sessionFile,
 						persistArtifacts: !!artifactsDir,
 						artifactsDir: effectiveArtifactsDir,
+						contextFile: contextFilePath,
 						enableLsp: false,
 						signal,
 						eventBus: undefined,
@@ -522,6 +531,7 @@ export class TaskTool implements AgentTool<typeof taskSchema, TaskToolDetails, T
 						sessionFile,
 						persistArtifacts: !!artifactsDir,
 						artifactsDir: effectiveArtifactsDir,
+						contextFile: contextFilePath,
 						enableLsp: false,
 						signal,
 						eventBus: undefined,
@@ -735,9 +745,7 @@ export class TaskTool implements AgentTool<typeof taskSchema, TaskToolDetails, T
 				duration: formatDuration(totalDuration),
 				summaries,
 				outputIds,
-				schemaOverridden,
 				agentName,
-				requiredSchema: agent.output ? JSON.stringify(agent.output) : "",
 				patchApplySummary,
 			});
 

package/src/tools/gemini-image.ts

@@ -1,6 +1,6 @@
 import * as os from "node:os";
 import * as path from "node:path";
-import { StringEnum } from "@oh-my-pi/pi-ai";
+import { getEnv, getEnvApiKey, StringEnum } from "@oh-my-pi/pi-ai";
 import { ptree, untilAborted } from "@oh-my-pi/pi-utils";
 import { type Static, Type } from "@sinclair/typebox";
 import { nanoid } from "nanoid";
@@ -9,7 +9,6 @@ import { renderPromptTemplate } from "../config/prompt-templates";
 import type { CustomTool } from "../extensibility/custom-tools/types";
 import geminiImageDescription from "../prompts/tools/gemini-image.md" with { type: "text" };
 import { detectSupportedImageMimeTypeFromFile } from "../utils/mime";
-import { getEnv } from "../web/search/auth";
 import { resolveReadPath } from "./path-utils";
 
 const DEFAULT_MODEL = "gemini-3-pro-image-preview";
@@ -408,13 +407,13 @@ async function findImageApiKey(modelRegistry?: ModelRegistry): Promise<ImageApiK
 		// Fall through to auto-detect if preferred provider key not found
 	}
 	if (preferredImageProvider === "gemini") {
-		const geminiKey = await getEnv("GEMINI_API_KEY");
+		const geminiKey = getEnvApiKey("google");
 		if (geminiKey) return { provider: "gemini", apiKey: geminiKey };
-		const googleKey = await getEnv("GOOGLE_API_KEY");
+		const googleKey = getEnv("GOOGLE_API_KEY");
 		if (googleKey) return { provider: "gemini", apiKey: googleKey };
 		// Fall through to auto-detect if preferred provider key not found
 	} else if (preferredImageProvider === "openrouter") {
-		const openRouterKey = await getEnv("OPENROUTER_API_KEY");
+		const openRouterKey = getEnvApiKey("openrouter");
 		if (openRouterKey) return { provider: "openrouter", apiKey: openRouterKey };
 		// Fall through to auto-detect if preferred provider key not found
 	}
@@ -425,13 +424,13 @@ async function findImageApiKey(modelRegistry?: ModelRegistry): Promise<ImageApiK
 		if (antigravity) return antigravity;
 	}
 
-	const openRouterKey = await getEnv("OPENROUTER_API_KEY");
+	const openRouterKey = getEnvApiKey("openrouter");
 	if (openRouterKey) return { provider: "openrouter", apiKey: openRouterKey };
 
-	const geminiKey = await getEnv("GEMINI_API_KEY");
+	const geminiKey = getEnvApiKey("google");
 	if (geminiKey) return { provider: "gemini", apiKey: geminiKey };
 
-	const googleKey = await getEnv("GOOGLE_API_KEY");
+	const googleKey = getEnv("GOOGLE_API_KEY");
 	if (googleKey) return { provider: "gemini", apiKey: googleKey };
 
 	return null;

package/src/tools/index.ts

@@ -173,6 +173,8 @@ export interface ToolSession {
 	};
 	/** Plan mode state (if active) */
 	getPlanModeState?: () => PlanModeState | undefined;
+	/** Get compact conversation context for subagents (excludes tool results, system prompts) */
+	getCompactContext?: () => string;
 }
 
 type ToolFactory = (session: ToolSession) => Tool | null | Promise<Tool | null>;

package/src/tools/python.ts

@@ -785,8 +785,15 @@ export const pythonToolRenderer = {
 			return new Text(text, 0, 0);
 		}
 
+		// Cache state - cells don't change, only width varies
+		let cached: { width: number; result: string[] } | undefined;
+
 		return {
 			render: (width: number): string[] => {
+				if (cached && cached.width === width) {
+					return cached.result;
+				}
+
 				const lines: string[] = [];
 				for (let i = 0; i < cells.length; i++) {
 					const cell = cells[i];
@@ -812,9 +819,12 @@ export const pythonToolRenderer = {
 						lines.push("");
 					}
 				}
+				cached = { width, result: lines };
 				return lines;
 			},
-			invalidate: () => {},
+			invalidate: () => {
+				cached = undefined;
+			},
 		};
 	},
 
@@ -864,8 +874,20 @@ export const pythonToolRenderer = {
 
 		const cellResults = details?.cells;
 		if (cellResults && cellResults.length > 0) {
+			// Cache state following Box pattern
+			let cached: { key: string; width: number; result: string[] } | undefined;
+
+			const buildCacheKey = (spinnerFrame: number | undefined): string => {
+				return `${expanded}|${previewLines}|${spinnerFrame}`;
+			};
+
 			return {
 				render: (width: number): string[] => {
+					const key = buildCacheKey(options.spinnerFrame);
+					if (cached && cached.key === key && cached.width === width) {
+						return cached.result;
+					}
+
 					const lines: string[] = [];
 					for (let i = 0; i < cellResults.length; i++) {
 						const cell = cellResults[i];
@@ -921,9 +943,12 @@ export const pythonToolRenderer = {
 					if (warningLine) {
 						lines.push(warningLine);
 					}
+					cached = { key, width, result: lines };
 					return lines;
 				},
-				invalidate: () => {},
+				invalidate: () => {
+					cached = undefined;
+				},
 			};
 		}
 

package/src/tui/output-block.ts

@@ -1,7 +1,7 @@
 /**
  * Bordered output container with optional header and sections.
  */
-import { visibleWidth } from "@oh-my-pi/pi-tui";
+import { padding, visibleWidth } from "@oh-my-pi/pi-tui";
 import type { Theme } from "../modes/theme/theme";
 import type { State } from "./types";
 import { getStateBgColor, padToWidth, truncateToWidth } from "./utils";
@@ -70,7 +70,7 @@ export function renderOutputBlock(options: OutputBlockOptions, theme: Theme): st
 		const allLines = section.lines.flatMap(l => l.split("\n"));
 		for (const line of allLines) {
 			const text = truncateToWidth(line, contentWidth, theme.format.ellipsis);
-			const innerPadding = " ".repeat(Math.max(0, contentWidth - visibleWidth(text)));
+			const innerPadding = padding(Math.max(0, contentWidth - visibleWidth(text)));
 			const fullLine = `${contentPrefix}${text}${innerPadding}${contentSuffix}`;
 			lines.push(padToWidth(fullLine, lineWidth, bgFn));
 		}

package/src/tui/utils.ts

@@ -1,7 +1,7 @@
 /**
  * Shared helpers for tool-rendered UI components.
  */
-import { truncateToWidth as truncateToWidthBase, visibleWidth } from "@oh-my-pi/pi-tui";
+import { padding, truncateToWidth as truncateToWidthBase, visibleWidth } from "@oh-my-pi/pi-tui";
 import type { Theme, ThemeBg } from "../modes/theme/theme";
 import type { IconType, State } from "./types";
 
@@ -24,7 +24,7 @@ export function truncateToWidth(text: string, width: number, ellipsis: string):
 export function padToWidth(text: string, width: number, bgFn?: (s: string) => string): string {
 	if (width <= 0) return bgFn ? bgFn(text) : text;
 	const paddingNeeded = Math.max(0, width - visibleWidth(text));
-	const padded = paddingNeeded > 0 ? text + " ".repeat(paddingNeeded) : text;
+	const padded = paddingNeeded > 0 ? text + padding(paddingNeeded) : text;
 	return bgFn ? bgFn(padded) : padded;
 }
 

package/src/web/search/auth.ts

@@ -7,9 +7,8 @@
  *   3. OAuth credentials in ~/.omp/agent/agent.db (with expiry check)
  *   4. ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL fallback
  */
-import * as os from "node:os";
 import * as path from "node:path";
-import { buildAnthropicHeaders as buildProviderAnthropicHeaders } from "@oh-my-pi/pi-ai";
+import { buildAnthropicHeaders as buildProviderAnthropicHeaders, getEnv, getEnvApiKey } from "@oh-my-pi/pi-ai";
 import { logger } from "@oh-my-pi/pi-utils";
 import { getAgentDbPath, getConfigDirPaths } from "../../config";
 import { AgentStorage } from "../../session/agent-storage";
@@ -18,58 +17,7 @@ import { migrateJsonStorage } from "../../session/storage-migration";
 import type { AnthropicAuthConfig, AnthropicOAuthCredential, ModelsJson } from "./types";
 
 const DEFAULT_BASE_URL = "https://api.anthropic.com";
-
-/**
- * Parses a .env file and extracts key-value pairs.
- * @param filePath - Path to the .env file
- * @returns Object containing parsed environment variables
- */
-async function parseEnvFile(filePath: string): Promise<Record<string, string>> {
-	const result: Record<string, string> = {};
-	try {
-		const file = Bun.file(filePath);
-		if (!(await file.exists())) return result;
-
-		const content = await file.text();
-		for (const line of content.split("\n")) {
-			const trimmed = line.trim();
-			if (!trimmed || trimmed.startsWith("#")) continue;
-
-			const eqIndex = trimmed.indexOf("=");
-			if (eqIndex === -1) continue;
-
-			const key = trimmed.slice(0, eqIndex).trim();
-			let value = trimmed.slice(eqIndex + 1).trim();
-
-			// Remove surrounding quotes
-			if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-				value = value.slice(1, -1);
-			}
-
-			result[key] = value;
-		}
-	} catch (error) {
-		logger.warn("Failed to read .env file", { path: filePath, error: String(error) });
-	}
-	return result;
-}
-
-/**
- * Gets an environment variable from process.env or .env files.
- * @param key - The environment variable name to look up
- * @returns The value if found, undefined otherwise
- */
-export async function getEnv(key: string): Promise<string | undefined> {
-	if (process.env[key]) return process.env[key];
-
-	const localEnv = await parseEnvFile(`${process.cwd()}/.env`);
-	if (localEnv[key]) return localEnv[key];
-
-	const homeEnv = await parseEnvFile(`${os.homedir()}/.env`);
-	if (homeEnv[key]) return homeEnv[key];
-
-	return undefined;
-}
+export { getEnv };
 
 /**
  * Reads and parses a JSON file safely.
@@ -173,8 +121,8 @@ export async function findAnthropicAuth(): Promise<AnthropicAuthConfig | null> {
 	const configDirs = getConfigDirPaths("", { project: false });
 
 	// 1. Explicit search-specific env vars
-	const searchApiKey = await getEnv("ANTHROPIC_SEARCH_API_KEY");
-	const searchBaseUrl = await getEnv("ANTHROPIC_SEARCH_BASE_URL");
+	const searchApiKey = getEnv("ANTHROPIC_SEARCH_API_KEY");
+	const searchBaseUrl = getEnv("ANTHROPIC_SEARCH_BASE_URL");
 	if (searchApiKey) {
 		return {
 			apiKey: searchApiKey,
@@ -228,8 +176,8 @@ export async function findAnthropicAuth(): Promise<AnthropicAuthConfig | null> {
 	}
 
 	// 4. Generic ANTHROPIC_API_KEY fallback
-	const apiKey = await getEnv("ANTHROPIC_API_KEY");
-	const baseUrl = await getEnv("ANTHROPIC_BASE_URL");
+	const apiKey = getEnvApiKey("anthropic");
+	const baseUrl = getEnv("ANTHROPIC_BASE_URL");
 	if (apiKey) {
 		return {
 			apiKey,

package/src/web/search/index.ts

@@ -96,14 +96,10 @@ function formatProviderList(providers: WebSearchProvider[]): string {
 	return providers.map(provider => formatProviderLabel(provider)).join(", ");
 }
 
-function buildNoProviderError(): string {
-	return "No web search provider configured. Set EXA_API_KEY, PERPLEXITY_API_KEY, ANTHROPIC_SEARCH_API_KEY, or ANTHROPIC_API_KEY.";
-}
-
 function formatProviderError(error: unknown, provider: WebSearchProvider): string {
 	if (error instanceof WebSearchProviderError) {
 		if (error.provider === "anthropic" && error.status === 404) {
-			return "Anthropic web search returned 404 (model or endpoint not found). Set ANTHROPIC_SEARCH_MODEL/ANTHROPIC_SEARCH_BASE_URL, or configure EXA_API_KEY or PERPLEXITY_API_KEY.";
+			return "Anthropic web search returned 404 (model or endpoint not found).";
 		}
 		if (error.status === 401 || error.status === 403) {
 			return `${formatProviderLabel(error.provider)} authorization failed (${error.status}). Check API key or base URL.`;
@@ -221,7 +217,7 @@ async function executeWebSearch(
 	const { providers, allowFallback } = await resolveProviderChain(params.provider);
 
 	if (providers.length === 0) {
-		const message = buildNoProviderError();
+		const message = "No web search provider configured.";
 		const fallbackProvider = preferredProvider === "auto" ? "anthropic" : preferredProvider;
 		return {
 			content: [{ type: "text" as const, text: `Error: ${message}` }],

package/src/web/search/providers/anthropic.ts

@@ -4,8 +4,8 @@
  * Uses Claude's built-in web_search_20250305 tool to search the web.
  * Returns synthesized answers with citations and source metadata.
  */
-import { applyClaudeToolPrefix, buildAnthropicSystemBlocks, stripClaudeToolPrefix } from "@oh-my-pi/pi-ai";
-import { buildAnthropicHeaders, buildAnthropicUrl, findAnthropicAuth, getEnv } from "../../../web/search/auth";
+import { applyClaudeToolPrefix, buildAnthropicSystemBlocks, getEnv, stripClaudeToolPrefix } from "@oh-my-pi/pi-ai";
+import { buildAnthropicHeaders, buildAnthropicUrl, findAnthropicAuth } from "../../../web/search/auth";
 import type {
 	AnthropicApiResponse,
 	AnthropicAuthConfig,
@@ -41,8 +41,8 @@ export interface AnthropicSearchParams {
  * Gets the model to use for web search from environment or default.
  * @returns Model identifier string
  */
-async function getModel(): Promise<string> {
-	return (await getEnv("ANTHROPIC_SEARCH_MODEL")) ?? DEFAULT_MODEL;
+function getModel(): string {
+	return getEnv("ANTHROPIC_SEARCH_MODEL") ?? DEFAULT_MODEL;
 }
 
 /**
@@ -184,7 +184,7 @@ function parseResponse(response: AnthropicApiResponse): WebSearchResponse {
 					sources.push({
 						title: result.title,
 						url: result.url,
-						snippet: result.encrypted_content,
+						snippet: undefined,
 						publishedDate: result.page_age ?? undefined,
 						ageSeconds: parsePageAge(result.page_age),
 					});
@@ -235,7 +235,7 @@ export async function searchAnthropic(params: AnthropicSearchParams): Promise<We
 		);
 	}
 
-	const model = await getModel();
+	const model = getModel();
 	const response = await callWebSearch(auth, model, params.query, params.system_prompt);
 
 	const result = parseResponse(response);

package/src/web/search/providers/exa.ts

@@ -4,7 +4,7 @@
  * High-quality neural search via Exa Search API.
  * Returns structured search results with optional content extraction.
  */
-import * as os from "node:os";
+import { getEnvApiKey } from "@oh-my-pi/pi-ai";
 import type { WebSearchResponse, WebSearchSource } from "../../../web/search/types";
 import { WebSearchProviderError } from "../../../web/search/types";
 
@@ -24,66 +24,6 @@ export interface ExaSearchParams {
 	end_published_date?: string;
 }
 
-/** Parse a .env file and return key-value pairs */
-async function parseEnvFile(filePath: string): Promise<Record<string, string>> {
-	const result: Record<string, string> = {};
-	try {
-		const content = await Bun.file(filePath).text();
-		for (const line of content.split("\n")) {
-			let trimmed = line.trim();
-			if (!trimmed || trimmed.startsWith("#")) continue;
-
-			if (trimmed.startsWith("export ")) {
-				trimmed = trimmed.slice("export ".length).trim();
-			}
-
-			const eqIndex = trimmed.indexOf("=");
-			if (eqIndex === -1) continue;
-
-			const key = trimmed.slice(0, eqIndex).trim();
-			let value = trimmed.slice(eqIndex + 1).trim();
-
-			if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-				value = value.slice(1, -1);
-			}
-
-			result[key] = value;
-		}
-	} catch {
-		// Ignore read errors (including ENOENT for missing files)
-	}
-	return result;
-}
-
-function getHomeDir(): string {
-	return os.homedir();
-}
-
-/** Find EXA_API_KEY from environment or .env files */
-export async function findApiKey(): Promise<string | null> {
-	// 1. Check environment variable
-	if (process.env.EXA_API_KEY) {
-		return process.env.EXA_API_KEY;
-	}
-
-	// 2. Check .env in current directory
-	const localEnv = await parseEnvFile(`${process.cwd()}/.env`);
-	if (localEnv.EXA_API_KEY) {
-		return localEnv.EXA_API_KEY;
-	}
-
-	// 3. Check ~/.env
-	const homeDir = getHomeDir();
-	if (homeDir) {
-		const homeEnv = await parseEnvFile(`${homeDir}/.env`);
-		if (homeEnv.EXA_API_KEY) {
-			return homeEnv.EXA_API_KEY;
-		}
-	}
-
-	return null;
-}
-
 interface ExaSearchResult {
 	title?: string | null;
 	url?: string | null;
@@ -159,7 +99,7 @@ function dateToAgeSeconds(dateStr: string | null | undefined): number | undefine
 
 /** Execute Exa web search */
 export async function searchExa(params: ExaSearchParams): Promise<WebSearchResponse> {
-	const apiKey = await findApiKey();
+	const apiKey = getEnvApiKey("exa");
 	if (!apiKey) {
 		throw new Error("EXA_API_KEY not found. Set it in environment or .env file.");
 	}

package/src/web/search/providers/perplexity.ts

@@ -4,7 +4,8 @@
  * Supports both sonar (fast) and sonar-pro (comprehensive) models.
  * Returns synthesized answers with citations and related questions.
  */
-import * as os from "node:os";
+
+import { getEnvApiKey } from "@oh-my-pi/pi-ai";
 import type {
 	PerplexityRequest,
 	PerplexityResponse,
@@ -23,56 +24,9 @@ export interface PerplexitySearchParams {
 	num_results?: number;
 }
 
-/** Parse a .env file and return key-value pairs */
-async function parseEnvFile(filePath: string): Promise<Record<string, string>> {
-	const result: Record<string, string> = {};
-	try {
-		const file = Bun.file(filePath);
-		if (!(await file.exists())) return result;
-
-		const content = await file.text();
-		for (const line of content.split("\n")) {
-			const trimmed = line.trim();
-			if (!trimmed || trimmed.startsWith("#")) continue;
-
-			const eqIndex = trimmed.indexOf("=");
-			if (eqIndex === -1) continue;
-
-			const key = trimmed.slice(0, eqIndex).trim();
-			let value = trimmed.slice(eqIndex + 1).trim();
-
-			if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-				value = value.slice(1, -1);
-			}
-
-			result[key] = value;
-		}
-	} catch {
-		// Ignore read errors
-	}
-	return result;
-}
-
-/** Find PERPLEXITY_API_KEY from environment or .env files */
-export async function findApiKey(): Promise<string | null> {
-	// 1. Check environment variable
-	if (process.env.PERPLEXITY_API_KEY) {
-		return process.env.PERPLEXITY_API_KEY;
-	}
-
-	// 2. Check .env in current directory
-	const localEnv = await parseEnvFile(`${process.cwd()}/.env`);
-	if (localEnv.PERPLEXITY_API_KEY) {
-		return localEnv.PERPLEXITY_API_KEY;
-	}
-
-	// 3. Check ~/.env
-	const homeEnv = await parseEnvFile(`${os.homedir()}/.env`);
-	if (homeEnv.PERPLEXITY_API_KEY) {
-		return homeEnv.PERPLEXITY_API_KEY;
-	}
-
-	return null;
+/** Find PERPLEXITY_API_KEY from environment or .env files (also checks PPLX_API_KEY) */
+export function findApiKey(): string | null {
+	return getEnvApiKey("perplexity") ?? null;
 }
 
 /** Call Perplexity API */
@@ -154,7 +108,7 @@ function parseResponse(response: PerplexityResponse): WebSearchResponse {
 
 /** Execute Perplexity web search */
 export async function searchPerplexity(params: PerplexitySearchParams): Promise<WebSearchResponse> {
-	const apiKey = await findApiKey();
+	const apiKey = findApiKey();
 	if (!apiKey) {
 		throw new Error("PERPLEXITY_API_KEY not found. Set it in environment or .env file.");
 	}