@oh-my-pi/pi-coding-agent 15.1.2 → 15.1.4

package/src/internal-urls/index.ts

@@ -15,8 +15,8 @@ export * from "./json-query";
 export * from "./local-protocol";
 export * from "./mcp-protocol";
 export * from "./memory-protocol";
+export * from "./omp-protocol";
 export * from "./parse";
-export * from "./pi-protocol";
 export * from "./router";
 export * from "./rule-protocol";
 export * from "./skill-protocol";

package/src/internal-urls/{pi-protocol.ts → omp-protocol.ts}

@@ -1,23 +1,23 @@
 /**
- * Protocol handler for pi:// URLs.
+ * Protocol handler for omp:// URLs.
  *
  * Serves statically embedded documentation files bundled at build time.
  *
  * URL forms:
- * - pi:// - Lists all available documentation files
- * - pi://<file>.md - Reads a specific documentation file
+ * - omp:// - Lists all available documentation files
+ * - omp://<file>.md - Reads a specific documentation file
  */
 import * as path from "node:path";
 import { EMBEDDED_DOC_FILENAMES, EMBEDDED_DOCS } from "./docs-index.generated";
 import type { InternalResource, InternalUrl, ProtocolHandler } from "./types";
 
 /**
- * Handler for pi:// URLs.
+ * Handler for omp:// URLs.
  *
  * Resolves documentation file names to their content, or lists available docs.
  */
-export class PiProtocolHandler implements ProtocolHandler {
-	readonly scheme = "pi";
+export class OmpProtocolHandler implements ProtocolHandler {
+	readonly scheme = "omp";
 	readonly immutable = true;
 
 	async resolve(url: InternalUrl): Promise<InternalResource> {
@@ -38,7 +38,7 @@ export class PiProtocolHandler implements ProtocolHandler {
 			throw new Error("No documentation files found");
 		}
 
-		const listing = EMBEDDED_DOC_FILENAMES.map(f => `- [${f}](pi://${f})`).join("\n");
+		const listing = EMBEDDED_DOC_FILENAMES.map(f => `- [${f}](omp://${f})`).join("\n");
 		const content = `# Documentation\n\n${EMBEDDED_DOC_FILENAMES.length} files available:\n\n${listing}\n`;
 
 		return {
@@ -52,12 +52,12 @@ export class PiProtocolHandler implements ProtocolHandler {
 	async #readDoc(filename: string, url: InternalUrl): Promise<InternalResource> {
 		// Validate: no traversal, no absolute paths
 		if (path.isAbsolute(filename)) {
-			throw new Error("Absolute paths are not allowed in pi:// URLs");
+			throw new Error("Absolute paths are not allowed in omp:// URLs");
 		}
 
 		const normalized = path.posix.normalize(filename.replaceAll("\\", "/"));
 		if (normalized === ".." || normalized.startsWith("../") || normalized.includes("/../")) {
-			throw new Error("Path traversal (..) is not allowed in pi:// URLs");
+			throw new Error("Path traversal (..) is not allowed in omp:// URLs");
 		}
 
 		const content = EMBEDDED_DOCS[normalized];
@@ -69,7 +69,7 @@ export class PiProtocolHandler implements ProtocolHandler {
 			const suffix =
 				suggestions.length > 0
 					? `\nDid you mean: ${suggestions.join(", ")}`
-					: "\nUse pi:// to list available files.";
+					: "\nUse omp:// to list available files.";
 			throw new Error(`Documentation file not found: ${filename}${suffix}`);
 		}
 

package/src/internal-urls/router.ts

@@ -1,5 +1,5 @@
 /**
- * Internal URL router for internal protocols (agent://, artifact://, memory://, skill://, rule://, mcp://, pi://, local://).
+ * Internal URL router for internal protocols (agent://, artifact://, memory://, skill://, rule://, mcp://, omp://, local://).
  *
  * One process-global router with one handler per scheme. Access via
  * `InternalUrlRouter.instance()`. Handlers are stateless; per-session and
@@ -11,8 +11,8 @@ import { IssueProtocolHandler, PrProtocolHandler } from "./issue-pr-protocol";
 import { LocalProtocolHandler } from "./local-protocol";
 import { McpProtocolHandler } from "./mcp-protocol";
 import { MemoryProtocolHandler } from "./memory-protocol";
+import { OmpProtocolHandler } from "./omp-protocol";
 import { parseInternalUrl } from "./parse";
-import { PiProtocolHandler } from "./pi-protocol";
 import { RuleProtocolHandler } from "./rule-protocol";
 import { SkillProtocolHandler } from "./skill-protocol";
 import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext } from "./types";
@@ -23,7 +23,7 @@ export class InternalUrlRouter {
 	#handlers = new Map<string, ProtocolHandler>();
 
 	constructor() {
-		this.register(new PiProtocolHandler());
+		this.register(new OmpProtocolHandler());
 		this.register(new AgentProtocolHandler());
 		this.register(new ArtifactProtocolHandler());
 		this.register(new MemoryProtocolHandler());

package/src/internal-urls/types.ts

@@ -1,7 +1,7 @@
 /**
  * Types for the internal URL routing system.
  *
- * Internal URLs (agent://, artifact://, memory://, skill://, rule://, mcp://, pi://, local://) are resolved by tools like read,
+ * Internal URLs (agent://, artifact://, memory://, skill://, rule://, mcp://, omp://, local://) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
 

package/src/lsp/types.ts

@@ -22,17 +22,14 @@ export const lspSchema = z.object({
 		"capabilities",
 		"request",
 	]),
-	file: z.string().describe("File path or source path for rename_file").optional(),
-	line: z.number().describe("Line number (1-indexed)").optional(),
-	symbol: z.string().describe("Symbol/substring to locate on the line").optional(),
-	query: z.string().describe("Search query, code-action selector, or LSP method name for action=request").optional(),
-	new_name: z.string().describe("New name for rename, or destination path for rename_file").optional(),
-	apply: z.boolean().describe("Apply edits (default: true for rename/rename_file)").optional(),
-	timeout: z.number().describe("Request timeout in seconds").optional(),
-	payload: z
-		.string()
-		.describe("JSON-encoded params for action=request. When omitted, params are auto-built from file/line/symbol.")
-		.optional(),
+	file: z.string().describe("file path or source path for rename_file").optional(),
+	line: z.number().describe("line number (1-indexed)").optional(),
+	symbol: z.string().describe("symbol substring on the line").optional(),
+	query: z.string().describe("search query or code-action selector").optional(),
+	new_name: z.string().describe("new symbol name or destination path").optional(),
+	apply: z.boolean().describe("apply edits").optional(),
+	timeout: z.number().describe("request timeout in seconds").optional(),
+	payload: z.string().describe("json-encoded request params").optional(),
 });
 
 export type LspParams = z.infer<typeof lspSchema>;

package/src/main.ts

@@ -49,8 +49,14 @@ import type { MCPManager } from "./mcp";
 import { InteractiveMode, runAcpMode, runPrintMode, runRpcMode } from "./modes";
 import { initTheme, stopThemeWatcher } from "./modes/theme/theme";
 import type { SubmittedUserInput } from "./modes/types";
-import { type CreateAgentSessionOptions, createAgentSession, discoverAuthStorage } from "./sdk";
+import {
+	type CreateAgentSessionOptions,
+	type CreateAgentSessionResult,
+	createAgentSession,
+	discoverAuthStorage,
+} from "./sdk";
 import type { AgentSession } from "./session/agent-session";
+import type { AuthStorage } from "./session/auth-storage";
 import { resolveResumableSession, type SessionInfo, SessionManager } from "./session/session-manager";
 import { resolvePromptInput } from "./system-prompt";
 import type { LspStartupServerInfo } from "./tools";
@@ -102,9 +108,9 @@ const RPC_DEFAULTED_SETTING_PATHS: SettingPath[] = [
 	"memories.enabled",
 ];
 
-function applyRpcDefaultSettingOverrides(): void {
+function applyRpcDefaultSettingOverrides(targetSettings: Settings = settings): void {
 	for (const settingPath of RPC_DEFAULTED_SETTING_PATHS) {
-		settings.override(settingPath, getDefault(settingPath));
+		targetSettings.override(settingPath, getDefault(settingPath));
 	}
 }
 
@@ -160,6 +166,73 @@ export async function submitInteractiveInput(
 	}
 }
 
+function applyExtensionFlagValues(session: AgentSession, rawArgs: string[]): Map<string, boolean | string> {
+	const extensionRunner = session.extensionRunner;
+	if (!extensionRunner) {
+		return new Map();
+	}
+
+	const extFlags = extensionRunner.getFlags();
+	if (extFlags.size > 0) {
+		for (let i = 0; i < rawArgs.length; i++) {
+			const arg = rawArgs[i];
+			if (!arg.startsWith("--")) {
+				continue;
+			}
+			const flagName = arg.slice(2);
+			const extFlag = extFlags.get(flagName);
+			if (!extFlag) {
+				continue;
+			}
+			if (extFlag.type === "boolean") {
+				extensionRunner.setFlagValue(flagName, true);
+				continue;
+			}
+			if (i + 1 < rawArgs.length) {
+				extensionRunner.setFlagValue(flagName, rawArgs[++i]);
+			}
+		}
+	}
+
+	return extensionRunner.getFlagValues();
+}
+
+type AcpSessionFactory = (cwd: string) => Promise<AgentSession>;
+
+interface AcpSessionFactoryOptions {
+	baseOptions: CreateAgentSessionOptions;
+	settings: Settings;
+	sessionDir?: string;
+	authStorage: AuthStorage;
+	modelRegistry: ModelRegistry;
+	parsedArgs: Pick<Args, "apiKey">;
+	rawArgs: string[];
+	createSession: (options: CreateAgentSessionOptions) => Promise<CreateAgentSessionResult>;
+}
+
+function createAcpSessionFactory(args: AcpSessionFactoryOptions): AcpSessionFactory {
+	return async cwd => {
+		const nextSettings = await args.settings.cloneForCwd(cwd);
+		const nextSessionManager = SessionManager.create(cwd, args.sessionDir);
+		const agentId = `acp:${nextSessionManager.getSessionId()}`;
+		const { session: nextSession } = await args.createSession({
+			...args.baseOptions,
+			cwd,
+			sessionManager: nextSessionManager,
+			settings: nextSettings,
+			authStorage: args.authStorage,
+			modelRegistry: args.modelRegistry,
+			agentId,
+			hasUI: false,
+		});
+		if (args.parsedArgs.apiKey && !args.baseOptions.model && nextSession.model) {
+			args.authStorage.setRuntimeApiKey(nextSession.model.provider, args.parsedArgs.apiKey);
+		}
+		applyExtensionFlagValues(nextSession, args.rawArgs);
+		return nextSession;
+	};
+}
+
 async function runInteractiveMode(
 	session: AgentSession,
 	version: string,
@@ -290,7 +363,11 @@ async function flushChangelogVersion(): Promise<void> {
 	}
 }
 
-async function createSessionManager(parsed: Args, cwd: string): Promise<SessionManager | undefined> {
+async function createSessionManager(
+	parsed: Args,
+	cwd: string,
+	activeSettings: Settings = settings,
+): Promise<SessionManager | undefined> {
 	if (parsed.fork) {
 		if (parsed.noSession) {
 			throw new Error("--fork requires session persistence");
@@ -343,7 +420,7 @@ async function createSessionManager(parsed: Args, cwd: string): Promise<SessionM
 	// session exists. When a prior session is resumed, mark parsed.continue so
 	// buildSessionOptions restores the session's model/thinking instead of
 	// overriding them with CLI defaults.
-	if (settings.get("autoResume")) {
+	if (activeSettings.get("autoResume")) {
 		const manager = await SessionManager.continueRecent(cwd, parsed.sessionDir);
 		if (manager.getEntries().length > 0) {
 			parsed.continue = true;
@@ -437,6 +514,7 @@ async function buildSessionOptions(
 	scopedModels: ScopedModel[],
 	sessionManager: SessionManager | undefined,
 	modelRegistry: ModelRegistry,
+	activeSettings: Settings,
 ): Promise<{ options: CreateAgentSessionOptions }> {
 	const options: CreateAgentSessionOptions = {
 		cwd: parsed.cwd ?? getProjectDir(),
@@ -459,7 +537,7 @@ async function buildSessionOptions(
 	// - supports --provider <name> --model <pattern>
 	// - supports --model <provider>/<pattern>
 	const modelMatchPreferences = {
-		usageOrder: settings.getStorage()?.getModelUsageOrder(),
+		usageOrder: activeSettings.getStorage()?.getModelUsageOrder(),
 	};
 	if (parsed.model) {
 		const resolved = resolveCliModel({
@@ -482,7 +560,7 @@ async function buildSessionOptions(
 			}
 		} else if (resolved.model) {
 			options.model = resolved.model;
-			settings.overrideModelRoles({
+			activeSettings.overrideModelRoles({
 				default: resolved.selector ?? `${resolved.model.provider}/${resolved.model.id}`,
 			});
 			if (!parsed.thinking && resolved.thinkingLevel) {
@@ -490,13 +568,13 @@ async function buildSessionOptions(
 			}
 		}
 	} else if (scopedModels.length > 0 && !parsed.continue && !parsed.resume) {
-		const remembered = settings.getModelRole("default");
+		const remembered = activeSettings.getModelRole("default");
 		if (remembered) {
 			const rememberedSpec = resolveModelRoleValue(
 				remembered,
 				scopedModels.map(scopedModel => scopedModel.model),
 				{
-					settings,
+					settings: activeSettings,
 					matchPreferences: modelMatchPreferences,
 					modelRegistry,
 				},
@@ -534,7 +612,7 @@ async function buildSessionOptions(
 
 	// Scoped models for Ctrl+P cycling - fill in default thinking levels when not explicit
 	if (scopedModels.length > 0) {
-		const defaultThinkingLevel = settings.get("defaultThinkingLevel");
+		const defaultThinkingLevel = activeSettings.get("defaultThinkingLevel");
 		options.scopedModels = scopedModels.map(scopedModel => ({
 			model: scopedModel.model,
 			thinkingLevel: scopedModel.explicitThinkingLevel
@@ -571,7 +649,7 @@ async function buildSessionOptions(
 		options.skills = [];
 	} else if (parsed.skills && parsed.skills.length > 0) {
 		// Override includeSkills for this session
-		settings.override("skills.includeSkills", parsed.skills as string[]);
+		activeSettings.override("skills.includeSkills", parsed.skills as string[]);
 	}
 
 	// Rules
@@ -593,7 +671,18 @@ async function buildSessionOptions(
 	return { options };
 }
 
-export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<void> {
+interface RunRootCommandDependencies {
+	createAgentSession?: typeof createAgentSession;
+	discoverAuthStorage?: typeof discoverAuthStorage;
+	runAcpMode?: typeof runAcpMode;
+	settings?: Settings;
+}
+
+export async function runRootCommand(
+	parsed: Args,
+	rawArgs: string[],
+	deps: RunRootCommandDependencies = {},
+): Promise<void> {
 	logger.startTiming();
 
 	// Initialize theme early with defaults (CLI commands need symbols)
@@ -606,7 +695,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 	const notifs: (InteractiveModeNotify | null)[] = [];
 
 	// Create AuthStorage and ModelRegistry upfront
-	const authStorage = await logger.time("discoverModels", discoverAuthStorage);
+	const authStorage = await logger.time("discoverModels", deps.discoverAuthStorage ?? discoverAuthStorage);
 	const modelRegistry = new ModelRegistry(authStorage);
 
 	if (parsedArgs.version) {
@@ -668,9 +757,9 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 	pluginPreloadPromise.catch(() => {});
 
 	const cwd = getProjectDir();
-	const settingsInstance = await logger.time("settings:init", Settings.init, { cwd });
+	const settingsInstance = deps.settings ?? (await logger.time("settings:init", Settings.init, { cwd }));
 	if (parsedArgs.mode === "rpc" || parsedArgs.mode === "rpc-ui" || parsedArgs.mode === "acp") {
-		applyRpcDefaultSettingOverrides();
+		applyRpcDefaultSettingOverrides(settingsInstance);
 	}
 	if (parsedArgs.noPty || parsedArgs.mode === "rpc-ui") {
 		Bun.env.PI_NO_PTY = "1";
@@ -684,7 +773,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 			return { pipedInput, fileText: undefined, fileImages: undefined };
 		}
 		const processed = await processFileArguments(parsedArgs.fileArgs, {
-			autoResizeImages: settings.get("images.autoResize"),
+			autoResizeImages: settingsInstance.get("images.autoResize"),
 		});
 		return { pipedInput, fileText: processed.text, fileImages: processed.images };
 	});
@@ -699,14 +788,14 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 	const mode = parsedArgs.mode || "text";
 
 	// Initialize discovery system with settings for provider persistence
-	logger.time("initializeWithSettings", initializeWithSettings, settings);
+	logger.time("initializeWithSettings", initializeWithSettings, settingsInstance);
 
 	// Apply model role overrides from CLI args or env vars (ephemeral, not persisted)
 	const smolModel = parsedArgs.smol ?? $env.PI_SMOL_MODEL;
 	const slowModel = parsedArgs.slow ?? $env.PI_SLOW_MODEL;
 	const planModel = parsedArgs.plan ?? $env.PI_PLAN_MODEL;
 	if (smolModel || slowModel || planModel) {
-		settings.overrideModelRoles({
+		settingsInstance.overrideModelRoles({
 			smol: smolModel,
 			slow: slowModel,
 			plan: planModel,
@@ -717,16 +806,16 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		"initTheme:final",
 		initTheme,
 		isInteractive,
-		settings.get("symbolPreset"),
-		settings.get("colorBlindMode"),
-		settings.get("theme.dark"),
-		settings.get("theme.light"),
+		settingsInstance.get("symbolPreset"),
+		settingsInstance.get("colorBlindMode"),
+		settingsInstance.get("theme.dark"),
+		settingsInstance.get("theme.light"),
 	);
 
 	let scopedModels: ScopedModel[] = [];
-	const modelPatterns = parsedArgs.models ?? settings.get("enabledModels");
+	const modelPatterns = parsedArgs.models ?? settingsInstance.get("enabledModels");
 	const modelMatchPreferences = {
-		usageOrder: settings.getStorage()?.getModelUsageOrder(),
+		usageOrder: settingsInstance.getStorage()?.getModelUsageOrder(),
 	};
 	if (modelPatterns && modelPatterns.length > 0) {
 		scopedModels = await logger.time(
@@ -739,7 +828,13 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 	}
 
 	// Create session manager based on CLI flags
-	let sessionManager = await logger.time("createSessionManager", createSessionManager, parsedArgs, cwd);
+	let sessionManager = await logger.time(
+		"createSessionManager",
+		createSessionManager,
+		parsedArgs,
+		cwd,
+		settingsInstance,
+	);
 
 	// Handle --resume (no value): show session picker
 	if (parsedArgs.resume === true && !parsedArgs.fork) {
@@ -759,7 +854,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 	await pluginPreloadPromise;
 
 	// Background marketplace auto-update — never blocks startup.
-	const autoUpdate = settings.get("marketplace.autoUpdate");
+	const autoUpdate = settingsInstance.get("marketplace.autoUpdate");
 	if (autoUpdate !== "off") {
 		void (async () => {
 			try {
@@ -793,6 +888,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		scopedModels,
 		sessionManager,
 		modelRegistry,
+		settingsInstance,
 	);
 	sessionOptions.authStorage = authStorage;
 	sessionOptions.modelRegistry = modelRegistry;
@@ -812,137 +908,111 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		}
 	}
 
-	const { session, setToolUIContext, modelFallbackMessage, lspServers, mcpManager, eventBus } = await logger.time(
-		"createAgentSession",
-		createAgentSession,
-		sessionOptions,
-	);
-	// Kick off background model discovery only after createAgentSession finishes its parallel
-	// discovery arms; running these concurrently contends for the event loop and stretches
-	// every parallel arm by ~30ms.
-	modelRegistry.refreshInBackground();
-	if (parsedArgs.apiKey && !sessionOptions.model && session.model) {
-		authStorage.setRuntimeApiKey(session.model.provider, parsedArgs.apiKey);
-	}
-
-	if (modelFallbackMessage) {
-		notifs.push({ kind: "warn", message: modelFallbackMessage });
-	}
-
-	const modelRegistryError = modelRegistry.getError();
-	if (modelRegistryError) {
-		notifs.push({ kind: "error", message: modelRegistryError.message });
-	}
+	const createAgentSessionImpl = deps.createAgentSession ?? createAgentSession;
+	const createSession = async (options: CreateAgentSessionOptions): Promise<CreateAgentSessionResult> => {
+		const result = await logger.time("createAgentSession", createAgentSessionImpl, options);
+		// Kick off background model discovery only after createAgentSession finishes its parallel
+		// discovery arms; running these concurrently contends for the event loop and stretches
+		// every parallel arm by ~30ms.
+		modelRegistry.refreshInBackground();
+		return result;
+	};
 
-	// Re-parse CLI args with extension flags and apply values
-	if (session.extensionRunner) {
-		const extFlags = session.extensionRunner.getFlags();
-		if (extFlags.size > 0) {
-			for (let i = 0; i < rawArgs.length; i++) {
-				const arg = rawArgs[i];
-				if (!arg.startsWith("--")) {
-					continue;
-				}
-				const flagName = arg.slice(2);
-				const extFlag = extFlags.get(flagName);
-				if (!extFlag) {
-					continue;
-				}
-				if (extFlag.type === "boolean") {
-					session.extensionRunner.setFlagValue(flagName, true);
-					continue;
-				}
-				if (i + 1 < rawArgs.length) {
-					session.extensionRunner.setFlagValue(flagName, rawArgs[++i]);
-				}
-			}
+	if (mode === "acp") {
+		const createAcpSession = createAcpSessionFactory({
+			baseOptions: sessionOptions,
+			settings: settingsInstance,
+			sessionDir: parsedArgs.sessionDir,
+			authStorage,
+			modelRegistry,
+			parsedArgs,
+			rawArgs,
+			createSession,
+		});
+		await (deps.runAcpMode ?? runAcpMode)(createAcpSession);
+	} else {
+		const { session, setToolUIContext, modelFallbackMessage, lspServers, mcpManager, eventBus } =
+			await createSession(sessionOptions);
+		if (parsedArgs.apiKey && !sessionOptions.model && session.model) {
+			authStorage.setRuntimeApiKey(session.model.provider, parsedArgs.apiKey);
 		}
-	}
 
-	if (!isInteractive && parsedArgs.mode !== "acp" && !session.model) {
 		if (modelFallbackMessage) {
-			process.stderr.write(`${chalk.red(modelFallbackMessage)}\n`);
-		} else {
-			process.stderr.write(`${chalk.red("No models available.")}\n`);
+			notifs.push({ kind: "warn", message: modelFallbackMessage });
 		}
-		process.stderr.write(`${chalk.yellow("\nSet an API key environment variable:")}\n`);
-		process.stderr.write("  ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, etc.\n");
-		process.stderr.write(`${chalk.yellow(`\nOr create ${ModelsConfigFile.path()}`)}\n`);
-		process.exit(1);
-	}
 
-	const extensionFlagValues = session.extensionRunner?.getFlagValues() ?? new Map<string, boolean | string>();
-	const createAcpSession = async (cwd: string) => {
-		const nextSettings = await session.settings.cloneForCwd(cwd);
-		const nextSessionManager = SessionManager.create(cwd, parsedArgs.sessionDir);
-		const { session: nextSession } = await createAgentSession({
-			...sessionOptions,
-			cwd,
-			sessionManager: nextSessionManager,
-			settings: nextSettings,
-			authStorage,
-			modelRegistry,
-			hasUI: false,
-		});
-		if (nextSession.extensionRunner) {
-			for (const [flagName, value] of extensionFlagValues) {
-				nextSession.extensionRunner.setFlagValue(flagName, value);
-			}
+		const modelRegistryError = modelRegistry.getError();
+		if (modelRegistryError) {
+			notifs.push({ kind: "error", message: modelRegistryError.message });
 		}
-		return nextSession;
-	};
 
-	if (mode === "rpc" || mode === "rpc-ui") {
-		await runRpcMode(session, mode === "rpc-ui" ? setToolUIContext : undefined);
-	} else if (mode === "acp") {
-		await runAcpMode(session, createAcpSession);
-	} else if (isInteractive) {
-		const versionCheckPromise = checkForNewVersion(VERSION).catch(() => undefined);
-		const changelogMarkdown = await logger.time("main:getChangelogForDisplay", getChangelogForDisplay, parsedArgs);
-
-		const scopedModelsForDisplay = sessionOptions.scopedModels ?? scopedModels;
-		if (scopedModelsForDisplay.length > 0) {
-			const modelList = scopedModelsForDisplay
-				.map(scopedModel => {
-					const thinkingStr = !scopedModel.thinkingLevel ? `:${scopedModel.thinkingLevel}` : "";
-					return `${scopedModel.model.id}${thinkingStr}`;
-				})
-				.join(", ");
-			process.stdout.write(`${chalk.dim(`Model scope: ${modelList} ${chalk.gray("(Ctrl+P to cycle)")}`)}\n`);
-		}
-
-		if ($env.PI_TIMING) {
-			logger.printTimings();
-			if ($env.PI_TIMING === "x") {
-				process.exit(0);
+		applyExtensionFlagValues(session, rawArgs);
+
+		if (!isInteractive && !session.model) {
+			if (modelFallbackMessage) {
+				process.stderr.write(`${chalk.red(modelFallbackMessage)}\n`);
+			} else {
+				process.stderr.write(`${chalk.red("No models available.")}\n`);
 			}
+			process.stderr.write(`${chalk.yellow("\nSet an API key environment variable:")}\n`);
+			process.stderr.write("  ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, etc.\n");
+			process.stderr.write(`${chalk.yellow(`\nOr create ${ModelsConfigFile.path()}`)}\n`);
+			process.exit(1);
 		}
 
-		logger.endTiming();
-		await runInteractiveMode(
-			session,
-			VERSION,
-			changelogMarkdown,
-			notifs,
-			versionCheckPromise,
-			parsedArgs.messages,
-			setToolUIContext,
-			lspServers,
-			mcpManager,
-			eventBus,
-			initialMessage,
-			initialImages,
-		);
-	} else {
-		await runPrintMode(session, {
-			mode,
-			messages: parsedArgs.messages,
-			initialMessage,
-			initialImages,
-		});
-		await session.dispose();
-		stopThemeWatcher();
-		await postmortem.quit(0);
+		if (mode === "rpc" || mode === "rpc-ui") {
+			await runRpcMode(session, mode === "rpc-ui" ? setToolUIContext : undefined);
+		} else if (isInteractive) {
+			const versionCheckPromise = checkForNewVersion(VERSION).catch(() => undefined);
+			const changelogMarkdown = await logger.time("main:getChangelogForDisplay", getChangelogForDisplay, parsedArgs);
+
+			const scopedModelsForDisplay = sessionOptions.scopedModels ?? scopedModels;
+			if (scopedModelsForDisplay.length > 0) {
+				const modelList = scopedModelsForDisplay
+					.map(scopedModel => {
+						const thinkingStr = !scopedModel.thinkingLevel ? `:${scopedModel.thinkingLevel}` : "";
+						return `${scopedModel.model.id}${thinkingStr}`;
+					})
+					.join(", ");
+				process.stdout.write(`${chalk.dim(`Model scope: ${modelList} ${chalk.gray("(Ctrl+P to cycle)")}`)}\n`);
+			}
+
+			if ($env.PI_TIMING) {
+				logger.printTimings();
+				if ($env.PI_TIMING === "x") {
+					process.exit(0);
+				}
+			}
+
+			logger.endTiming();
+			await runInteractiveMode(
+				session,
+				VERSION,
+				changelogMarkdown,
+				notifs,
+				versionCheckPromise,
+				parsedArgs.messages,
+				setToolUIContext,
+				lspServers,
+				mcpManager,
+				eventBus,
+				initialMessage,
+				initialImages,
+			);
+		} else {
+			await runPrintMode(session, {
+				mode,
+				messages: parsedArgs.messages,
+				initialMessage,
+				initialImages,
+			});
+			if ($env.PI_TIMING) {
+				logger.printTimings();
+			}
+			await session.dispose();
+			stopThemeWatcher();
+			await postmortem.quit(0);
+		}
 	}
 }