@oh-my-pi/pi-coding-agent 8.3.0 → 8.4.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [8.4.0] - 2026-01-25
+
+### Added
+- Added extension API to set working/loading messages during streaming
+- Added task worker propagation of context files, skills, and prompt templates
+- Added subagent option to skip Python preflight checks when Python tooling is unused
+- Model field now accepts string arrays for fallback model prioritization
+
+### Changed
+- Merged patch application warnings into edit tool diagnostics output
+- Cached Python prelude docs for subagent workers to avoid repeated warmups
+- Simplified image placeholders inserted on paste to match Claude-style markers
+
+### Fixed
+- Rewrote empty or corrupted session files to restore valid headers
+- Improved patch applicator ambiguity errors with match previews and overlap detection
+- Fixed Task tool agent model resolution to honor comma-separated model lists
 ## [8.3.0] - 2026-01-25
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "8.3.0",
+	"version": "8.4.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -75,11 +75,11 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@oh-my-pi/omp-stats": "8.3.0",
-		"@oh-my-pi/pi-agent-core": "8.3.0",
-		"@oh-my-pi/pi-ai": "8.3.0",
-		"@oh-my-pi/pi-tui": "8.3.0",
-		"@oh-my-pi/pi-utils": "8.3.0",
+		"@oh-my-pi/omp-stats": "8.4.0",
+		"@oh-my-pi/pi-agent-core": "8.4.0",
+		"@oh-my-pi/pi-ai": "8.4.0",
+		"@oh-my-pi/pi-tui": "8.4.0",
+		"@oh-my-pi/pi-utils": "8.4.0",
 		"@openai/agents": "^0.4.3",
 		"@sinclair/typebox": "^0.34.46",
 		"ajv": "^8.17.1",

package/src/config/model-registry.ts

@@ -19,12 +19,18 @@ import type { AuthStorage } from "../session/auth-storage";
 
 const Ajv = (AjvModule as any).default || AjvModule;
 
+const OpenRouterRoutingSchema = Type.Object({
+	only: Type.Optional(Type.Array(Type.String())),
+	order: Type.Optional(Type.Array(Type.String())),
+});
+
 // Schema for OpenAI compatibility settings
 const OpenAICompatSchema = Type.Object({
 	supportsStore: Type.Optional(Type.Boolean()),
 	supportsDeveloperRole: Type.Optional(Type.Boolean()),
 	supportsReasoningEffort: Type.Optional(Type.Boolean()),
 	maxTokensField: Type.Optional(Type.Union([Type.Literal("max_completion_tokens"), Type.Literal("max_tokens")])),
+	openRouterRouting: Type.Optional(OpenRouterRoutingSchema),
 });
 
 // Schema for custom model definition
@@ -36,6 +42,7 @@ const ModelDefinitionSchema = Type.Object({
 			Type.Literal("openai-completions"),
 			Type.Literal("openai-responses"),
 			Type.Literal("openai-codex-responses"),
+			Type.Literal("azure-openai-responses"),
 			Type.Literal("anthropic-messages"),
 			Type.Literal("google-generative-ai"),
 			Type.Literal("google-vertex"),
@@ -63,6 +70,7 @@ const ProviderConfigSchema = Type.Object({
 			Type.Literal("openai-completions"),
 			Type.Literal("openai-responses"),
 			Type.Literal("openai-codex-responses"),
+			Type.Literal("azure-openai-responses"),
 			Type.Literal("anthropic-messages"),
 			Type.Literal("google-generative-ai"),
 			Type.Literal("google-vertex"),

package/src/discovery/helpers.ts

@@ -156,13 +156,23 @@ export function parseArrayOrCSV(value: unknown): string[] | undefined {
 	return undefined;
 }
 
+/**
+ * Parse model field into a prioritized list.
+ */
+export function parseModelList(value: unknown): string[] | undefined {
+	const parsed = parseArrayOrCSV(value);
+	if (!parsed) return undefined;
+	const normalized = parsed.map(entry => entry.trim()).filter(Boolean);
+	return normalized.length > 0 ? normalized : undefined;
+}
+
 /** Parsed agent fields from frontmatter (excludes source/filePath/systemPrompt) */
 export interface ParsedAgentFields {
 	name: string;
 	description: string;
 	tools?: string[];
 	spawns?: string[] | "*";
-	model?: string;
+	model?: string[];
 	output?: unknown;
 	thinkingLevel?: ThinkingLevel;
 }
@@ -202,7 +212,7 @@ export function parseAgentFields(frontmatter: Record<string, unknown>): ParsedAg
 	}
 
 	const output = frontmatter.output !== undefined ? frontmatter.output : undefined;
-	const model = typeof frontmatter.model === "string" ? frontmatter.model : undefined;
+	const model = parseModelList(frontmatter.model);
 	const thinkingLevel = parseThinkingLevel(frontmatter);
 
 	return { name, description, tools, spawns, model, output, thinkingLevel };

package/src/extensibility/extensions/runner.ts

@@ -85,6 +85,7 @@ const noOpUIContext: ExtensionUIContext = {
 	input: async (_title, _placeholder, _dialogOptions) => undefined,
 	notify: () => {},
 	setStatus: () => {},
+	setWorkingMessage: () => {},
 	setWidget: () => {},
 	setFooter: () => {},
 	setHeader: () => {},

package/src/extensibility/extensions/types.ts

@@ -69,6 +69,9 @@ export interface ExtensionUIContext {
 	/** Set status text in the footer/status bar. Pass undefined to clear. */
 	setStatus(key: string, text: string | undefined): void;
 
+	/** Set the working/loading message shown during streaming. Call with no argument to restore default. */
+	setWorkingMessage(message?: string): void;
+
 	/** Set a widget to display above the editor. Accepts string array or component factory. */
 	setWidget(key: string, content: string[] | undefined): void;
 	setWidget(key: string, content: ((tui: TUI, theme: Theme) => Component & { dispose?(): void }) | undefined): void;

package/src/ipy/executor.ts

@@ -187,6 +187,10 @@ export function getPreludeDocs(): PreludeHelper[] {
 	return cachedPreludeDocs ?? [];
 }
 
+export function setPreludeDocsCache(docs: PreludeHelper[]): void {
+	cachedPreludeDocs = docs;
+}
+
 export function resetPreludeDocsCache(): void {
 	cachedPreludeDocs = null;
 }

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

@@ -68,6 +68,7 @@ export class EventController {
 					getSymbolTheme().spinnerFrames,
 				);
 				this.ctx.statusContainer.addChild(this.ctx.loadingAnimation);
+				this.ctx.applyPendingWorkingMessage();
 				this.ctx.ui.requestRender();
 				break;
 

package/src/modes/controllers/extension-ui-controller.ts

@@ -30,6 +30,7 @@ export class ExtensionUiController {
 			input: (title, placeholder, _dialogOptions) => this.showHookInput(title, placeholder),
 			notify: (message, type) => this.showHookNotify(message, type),
 			setStatus: (key, text) => this.setHookStatus(key, text),
+			setWorkingMessage: message => this.ctx.setWorkingMessage(message),
 			setWidget: (key, content) => this.setHookWidget(key, content),
 			setTitle: title => setTerminalTitle(title),
 			custom: (factory, _options) => this.showHookCustom(factory),
@@ -389,6 +390,7 @@ export class ExtensionUiController {
 			input: async (_title: string, _placeholder?: string, _dialogOptions?: unknown) => undefined,
 			notify: () => {},
 			setStatus: () => {},
+			setWorkingMessage: () => {},
 			setWidget: () => {},
 			setTitle: () => {},
 			custom: async () => undefined as never,

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

@@ -541,9 +541,9 @@ export class InputController {
 					data: imageData.data,
 					mimeType: imageData.mimeType,
 				});
-				// Insert styled placeholder at cursor like Claude does
+				// Insert placeholder at cursor like Claude does
 				const imageNum = this.ctx.pendingImages.length;
-				const placeholder = theme.bold(theme.underline(`[Image #${imageNum}]`));
+				const placeholder = `[Image #${imageNum}]`;
 				this.ctx.editor.insertText(`${placeholder} `);
 				this.ctx.ui.requestRender();
 				return true;

package/src/modes/interactive-mode.ts

@@ -102,6 +102,8 @@ export class InteractiveMode implements InteractiveModeContext {
 	public loadingAnimation: Loader | undefined = undefined;
 	public autoCompactionLoader: Loader | undefined = undefined;
 	public retryLoader: Loader | undefined = undefined;
+	private pendingWorkingMessage: string | undefined;
+	private readonly defaultWorkingMessage = `Working${theme.format.ellipsis} (esc to interrupt)`;
 	public autoCompactionEscapeHandler?: () => void;
 	public retryEscapeHandler?: () => void;
 	public unsubscribe?: () => void;
@@ -160,6 +162,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.statusContainer = new Container();
 		this.todoContainer = new Container();
 		this.editor = new CustomEditor(getEditorTheme());
+		this.editor.setUseTerminalCursor(this.ui.getShowHardwareCursor());
 		this.editor.onAutocompleteCancel = () => {
 			this.ui.requestRender(true);
 		};
@@ -538,6 +541,33 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.uiHelpers.showWarning(message);
 	}
 
+	setWorkingMessage(message?: string): void {
+		if (message === undefined) {
+			this.pendingWorkingMessage = undefined;
+			if (this.loadingAnimation) {
+				this.loadingAnimation.setMessage(this.defaultWorkingMessage);
+			}
+			return;
+		}
+
+		if (this.loadingAnimation) {
+			this.loadingAnimation.setMessage(message);
+			return;
+		}
+
+		this.pendingWorkingMessage = message;
+	}
+
+	applyPendingWorkingMessage(): void {
+		if (this.pendingWorkingMessage === undefined) {
+			return;
+		}
+
+		const message = this.pendingWorkingMessage;
+		this.pendingWorkingMessage = undefined;
+		this.setWorkingMessage(message);
+	}
+
 	showNewVersionNotification(newVersion: string): void {
 		this.uiHelpers.showNewVersionNotification(newVersion);
 	}

package/src/modes/rpc/rpc-mode.ts

@@ -187,6 +187,10 @@ export async function runRpcMode(session: AgentSession): Promise<never> {
 			} as RpcExtensionUIRequest);
 		}
 
+		setWorkingMessage(_message?: string): void {
+			// Not supported in RPC mode
+		}
+
 		setWidget(key: string, content: unknown): void {
 			// Only support string arrays in RPC mode - factory functions are ignored
 			if (content === undefined || Array.isArray(content)) {

package/src/modes/theme/theme.ts

@@ -1025,109 +1025,20 @@ function detectColorMode(): ColorMode {
 	return "truecolor";
 }
 
-function hexToRgb(hex: string): { r: number; g: number; b: number } {
-	const cleaned = hex.replace("#", "");
-	if (cleaned.length !== 6) {
-		throw new Error(`Invalid hex color: ${hex}`);
-	}
-	const r = parseInt(cleaned.substring(0, 2), 16);
-	const g = parseInt(cleaned.substring(2, 4), 16);
-	const b = parseInt(cleaned.substring(4, 6), 16);
-	if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) {
-		throw new Error(`Invalid hex color: ${hex}`);
-	}
-	return { r, g, b };
-}
-
-// The 6x6x6 color cube channel values (indices 0-5)
-const CUBE_VALUES = [0, 95, 135, 175, 215, 255];
-
-// Grayscale ramp values (indices 232-255, 24 grays from 8 to 238)
-const GRAY_VALUES = Array.from({ length: 24 }, (_, i) => 8 + i * 10);
-
-function findClosestCubeIndex(value: number): number {
-	let minDist = Infinity;
-	let minIdx = 0;
-	for (let i = 0; i < CUBE_VALUES.length; i++) {
-		const dist = Math.abs(value - CUBE_VALUES[i]);
-		if (dist < minDist) {
-			minDist = dist;
-			minIdx = i;
-		}
+function colorToAnsi(color: string, mode: ColorMode): string {
+	const format = mode === "truecolor" ? "ansi-16m" : "ansi-256";
+	const ansi = Bun.color(color, format);
+	if (ansi === null) {
+		throw new Error(`Invalid color value: ${color}`);
 	}
-	return minIdx;
-}
-
-function findClosestGrayIndex(gray: number): number {
-	let minDist = Infinity;
-	let minIdx = 0;
-	for (let i = 0; i < GRAY_VALUES.length; i++) {
-		const dist = Math.abs(gray - GRAY_VALUES[i]);
-		if (dist < minDist) {
-			minDist = dist;
-			minIdx = i;
-		}
-	}
-	return minIdx;
-}
-
-function colorDistance(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number): number {
-	// Weighted Euclidean distance (human eye is more sensitive to green)
-	const dr = r1 - r2;
-	const dg = g1 - g2;
-	const db = b1 - b2;
-	return dr * dr * 0.299 + dg * dg * 0.587 + db * db * 0.114;
-}
-
-function rgbTo256(r: number, g: number, b: number): number {
-	// Find closest color in the 6x6x6 cube
-	const rIdx = findClosestCubeIndex(r);
-	const gIdx = findClosestCubeIndex(g);
-	const bIdx = findClosestCubeIndex(b);
-	const cubeR = CUBE_VALUES[rIdx];
-	const cubeG = CUBE_VALUES[gIdx];
-	const cubeB = CUBE_VALUES[bIdx];
-	const cubeIndex = 16 + 36 * rIdx + 6 * gIdx + bIdx;
-	const cubeDist = colorDistance(r, g, b, cubeR, cubeG, cubeB);
-
-	// Find closest grayscale
-	const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
-	const grayIdx = findClosestGrayIndex(gray);
-	const grayValue = GRAY_VALUES[grayIdx];
-	const grayIndex = 232 + grayIdx;
-	const grayDist = colorDistance(r, g, b, grayValue, grayValue, grayValue);
-
-	// Check if color has noticeable saturation (hue matters)
-	// If max-min spread is significant, prefer cube to preserve tint
-	const maxC = Math.max(r, g, b);
-	const minC = Math.min(r, g, b);
-	const spread = maxC - minC;
-
-	// Only consider grayscale if color is nearly neutral (spread < 10)
-	// AND grayscale is actually closer
-	if (spread < 10 && grayDist < cubeDist) {
-		return grayIndex;
-	}
-
-	return cubeIndex;
-}
-
-function hexTo256(hex: string): number {
-	const { r, g, b } = hexToRgb(hex);
-	return rgbTo256(r, g, b);
+	return ansi;
 }
 
 function fgAnsi(color: string | number, mode: ColorMode): string {
 	if (color === "") return "\x1b[39m";
 	if (typeof color === "number") return `\x1b[38;5;${color}m`;
-	if (color.startsWith("#")) {
-		if (mode === "truecolor") {
-			const { r, g, b } = hexToRgb(color);
-			return `\x1b[38;2;${r};${g};${b}m`;
-		} else {
-			const index = hexTo256(color);
-			return `\x1b[38;5;${index}m`;
-		}
+	if (typeof color === "string") {
+		return colorToAnsi(color, mode);
 	}
 	throw new Error(`Invalid color value: ${color}`);
 }
@@ -1135,16 +1046,8 @@ function fgAnsi(color: string | number, mode: ColorMode): string {
 function bgAnsi(color: string | number, mode: ColorMode): string {
 	if (color === "") return "\x1b[49m";
 	if (typeof color === "number") return `\x1b[48;5;${color}m`;
-	if (color.startsWith("#")) {
-		if (mode === "truecolor") {
-			const { r, g, b } = hexToRgb(color);
-			return `\x1b[48;2;${r};${g};${b}m`;
-		} else {
-			const index = hexTo256(color);
-			return `\x1b[48;5;${index}m`;
-		}
-	}
-	throw new Error(`Invalid color value: ${color}`);
+	const ansi = colorToAnsi(color, mode);
+	return ansi.replace("\x1b[38;", "\x1b[48;");
 }
 
 function resolveVarRefs(

package/src/modes/types.ts

@@ -111,6 +111,8 @@ export interface InteractiveModeContext {
 	queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
 	flushCompactionQueue(options?: { willRetry?: boolean }): Promise<void>;
 	flushPendingBashComponents(): void;
+	setWorkingMessage(message?: string): void;
+	applyPendingWorkingMessage(): void;
 	isKnownSlashCommand(text: string): boolean;
 	addMessageToChat(message: AgentMessage, options?: { populateHistory?: boolean }): void;
 	renderSessionContext(