@fased/fased 0.1.56 → 0.1.58

package/dist/acp/client.js

@@ -2,7 +2,7 @@ import { isKnownCoreToolId } from "../agents/tool-catalog.js";
 import { DANGEROUS_ACP_TOOLS } from "../security/dangerous-tools.js";
 import { ensureFasedAgentCliOnPath } from "../infra/path-env.js";
 import { fileURLToPath } from "node:url";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
@@ -269,7 +269,7 @@ function resolveSelfEntryPath() {
 	try {
 		const here = fileURLToPath(import.meta.url);
 		const candidate = path.resolve(path.dirname(here), "..", "entry.js");
-		if (syncFs.existsSync(candidate)) {
+		if (fs.existsSync(candidate)) {
 			return candidate;
 		}
 	} catch {}

package/dist/acp/secret-file.js

@@ -1,5 +1,5 @@
 import { resolveUserPath } from "../utils.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/acp/secret-file.ts
 function readSecretFromFile(filePath, label) {
@@ -9,7 +9,7 @@ function readSecretFromFile(filePath, label) {
 	}
 	let raw = "";
 	try {
-		raw = syncFs.readFileSync(resolvedPath, "utf8");
+		raw = fs.readFileSync(resolvedPath, "utf8");
 	} catch (err) {
 		throw new Error(`Failed to read ${label} file at ${resolvedPath}: ${String(err)}`, { cause: err });
 	}

package/dist/agents/agent-scope.js

@@ -6,7 +6,7 @@ import { parseAgentSessionKey } from "../sessions/session-key-utils.js";
 import { DEFAULT_AGENT_ID, normalizeAgentId, resolveAgentIdFromSessionKey } from "../routing/session-key.js";
 import { resolveEffectiveAgentSkillFilter } from "./skills/agent-filter.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/agent-scope.ts
@@ -245,7 +245,7 @@ function normalizePathForComparison(input) {
 	const resolved = path.resolve(stripNullBytes(resolveUserPath(input)));
 	let normalized = resolved;
 	try {
-		normalized = syncFs.realpathSync.native(resolved);
+		normalized = fs.realpathSync.native(resolved);
 	} catch {}
 	if (process.platform === "win32") {
 		return normalized.toLowerCase();

package/dist/agents/apply-patch.js

@@ -3,9 +3,9 @@ import { PATH_ALIAS_POLICIES } from "../infra/path-alias-guards.js";
 import { writeFileWithinRoot } from "../infra/fs-safe.js";
 import { applyUpdateHunk } from "./apply-patch-update.js";
 import { assertSandboxPath, resolveSandboxInputPath } from "./sandbox-paths.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
-import fs from "node:fs/promises";
+import fs$1 from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 
 //#region src/agents/apply-patch.ts
@@ -159,7 +159,7 @@ function resolvePatchFileOps(options) {
 	return {
 		readFile: async (filePath) => {
 			if (!workspaceOnly) {
-				return await fs.readFile(filePath, "utf8");
+				return await fs$1.readFile(filePath, "utf8");
 			}
 			const opened = await openBoundaryFile({
 				absolutePath: filePath,
@@ -168,14 +168,14 @@ function resolvePatchFileOps(options) {
 			});
 			assertBoundaryRead(opened, filePath);
 			try {
-				return syncFs.readFileSync(opened.fd, "utf8");
+				return fs.readFileSync(opened.fd, "utf8");
 			} finally {
-				syncFs.closeSync(opened.fd);
+				fs.closeSync(opened.fd);
 			}
 		},
 		writeFile: async (filePath, content) => {
 			if (!workspaceOnly) {
-				await fs.writeFile(filePath, content, "utf8");
+				await fs$1.writeFile(filePath, content, "utf8");
 				return;
 			}
 			const relative = toRelativeWorkspacePath(options.cwd, filePath);
@@ -186,8 +186,8 @@ function resolvePatchFileOps(options) {
 				encoding: "utf8"
 			});
 		},
-		remove: (filePath) => fs.rm(filePath),
-		mkdirp: (dir) => fs.mkdir(dir, { recursive: true }).then(() => {})
+		remove: (filePath) => fs$1.rm(filePath),
+		mkdirp: (dir) => fs$1.mkdir(dir, { recursive: true }).then(() => {})
 	};
 }
 async function ensureDir(filePath, ops) {

package/dist/agents/auth-profiles/paths.js

@@ -2,7 +2,7 @@ import { resolveUserPath } from "../../utils.js";
 import { saveJsonFile } from "../../infra/json-file.js";
 import { AUTH_PROFILE_FILENAME, AUTH_STORE_VERSION, LEGACY_AUTH_FILENAME } from "./constants.js";
 import { resolveFasedAgentAgentDir } from "../agent-paths.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/auth-profiles/paths.ts
@@ -19,7 +19,7 @@ function resolveAuthStorePathForDisplay(agentDir) {
 	return pathname.startsWith("~") ? pathname : resolveUserPath(pathname);
 }
 function ensureAuthStoreFile(pathname) {
-	if (syncFs.existsSync(pathname)) {
+	if (fs.existsSync(pathname)) {
 		return;
 	}
 	const payload = {

package/dist/agents/auth-profiles/store.js

@@ -5,7 +5,7 @@ import { withFileLock } from "../../plugin-sdk/file-lock.js";
 import "../../infra/file-lock.js";
 import { syncExternalCliCredentials } from "./external-cli-sync.js";
 import { ensureAuthStoreFile, resolveAuthStorePath, resolveLegacyAuthStorePath } from "./paths.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/agents/auth-profiles/store.ts
 const AUTH_PROFILE_TYPES = new Set([
@@ -361,7 +361,7 @@ function loadAuthProfileStoreForAgent(agentDir, options) {
 	if (shouldWrite && legacy !== null) {
 		const legacyPath = resolveLegacyAuthStorePath(agentDir);
 		try {
-			syncFs.unlinkSync(legacyPath);
+			fs.unlinkSync(legacyPath);
 		} catch (err) {
 			if (err?.code !== "ENOENT") {
 				log.warn("failed to delete legacy auth.json after migration", {

package/dist/agents/bash-tools.shared.js

@@ -3,7 +3,7 @@ import { assertSandboxPath } from "./sandbox-paths.js";
 import { existsSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
-import fs from "node:fs/promises";
+import fs$1 from "node:fs/promises";
 
 //#region src/agents/bash-tools.shared.ts
 const CHUNK_LIMIT = 8 * 1024;
@@ -67,7 +67,7 @@ async function resolveSandboxWorkdir(params) {
 			cwd: process.cwd(),
 			root: params.sandbox.workspaceDir
 		});
-		const stats = await fs.stat(resolved.resolved);
+		const stats = await fs$1.stat(resolved.resolved);
 		if (!stats.isDirectory()) {
 			throw new Error("workdir is not a directory");
 		}

package/dist/agents/cli-credentials.js

@@ -1,7 +1,7 @@
 import { resolveUserPath } from "../utils.js";
 import { createSubsystemLogger } from "../logging/subsystem.js";
 import { loadJsonFile, saveJsonFile } from "../infra/json-file.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 import { execFileSync, execSync } from "node:child_process";
 import { createHash } from "node:crypto";
@@ -61,7 +61,7 @@ function resolveCodexHomePath() {
 	const configured = process.env.CODEX_HOME;
 	const home = configured ? resolveUserPath(configured) : resolveUserPath("~/.codex");
 	try {
-		return syncFs.realpathSync.native(home);
+		return fs.realpathSync.native(home);
 	} catch {
 		return home;
 	}
@@ -264,7 +264,7 @@ function writeClaudeCliKeychainCredentials(newCredentials, options) {
 }
 function writeClaudeCliFileCredentials(newCredentials, options) {
 	const credPath = resolveClaudeCliCredentialsPath(options?.homeDir);
-	if (!syncFs.existsSync(credPath)) {
+	if (!fs.existsSync(credPath)) {
 		return false;
 	}
 	try {
@@ -331,7 +331,7 @@ function readCodexCliCredentials(options) {
 	}
 	let expires;
 	try {
-		const stat = syncFs.statSync(authPath);
+		const stat = fs.statSync(authPath);
 		expires = stat.mtimeMs + 60 * 60 * 1e3;
 	} catch {
 		expires = Date.now() + 60 * 60 * 1e3;

package/dist/agents/current-model-catalog.js

@@ -11,7 +11,7 @@ import { buildCopilotModelDefinition, buildCopilotProxyModelDefinition, getDefau
 import { CHUTES_BASE_URL, CHUTES_MODEL_CATALOG, buildChutesModelDefinition } from "./chutes-models.js";
 import { DOUBAO_BASE_URL, DOUBAO_CODING_BASE_URL, DOUBAO_CODING_MODEL_CATALOG, DOUBAO_MODEL_CATALOG, buildDoubaoModelDefinition } from "./doubao-models.js";
 import "./huggingface-models.js";
-import { normalizeProviderCatalogRows } from "./model-catalog-normalized.js";
+import { normalizeModelCatalogProviderId, normalizeProviderCatalogRows } from "./model-catalog-normalized.js";
 import { getOpencodeZenStaticFallbackModels } from "./opencode-zen-models.js";
 import "./synthetic-models.js";
 import "./together-models.js";
@@ -945,6 +945,9 @@ function cloneCurrentModelProvider(provider) {
 		}))
 	};
 }
+function listCurrentModelCatalogProviderIds() {
+	return Object.keys(CURRENT_MODEL_PROVIDER_CATALOG).map(normalizeModelCatalogProviderId).filter(Boolean).toSorted((left, right) => left.localeCompare(right));
+}
 function listCurrentModelCatalogRows() {
 	return Object.entries(CURRENT_MODEL_PROVIDER_CATALOG).flatMap(([provider, providerConfig]) => normalizeProviderCatalogRows({
 		provider,
@@ -955,4 +958,4 @@ function listCurrentModelCatalogRows() {
 }
 
 //#endregion
-export { CURRENT_MODEL_PROVIDER_CATALOG, cloneCurrentModelProvider, listCurrentModelCatalogRows };
+export { CURRENT_MODEL_PROVIDER_CATALOG, cloneCurrentModelProvider, listCurrentModelCatalogProviderIds, listCurrentModelCatalogRows };

package/dist/agents/docs-path.js

@@ -1,5 +1,5 @@
 import { resolveFasedAgentPackageRoot } from "../infra/fased-root.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/docs-path.ts
@@ -7,7 +7,7 @@ async function resolveFasedAgentDocsPath(params) {
 	const workspaceDir = params.workspaceDir?.trim();
 	if (workspaceDir) {
 		const workspaceDocs = path.join(workspaceDir, "docs");
-		if (syncFs.existsSync(workspaceDocs)) {
+		if (fs.existsSync(workspaceDocs)) {
 			return workspaceDocs;
 		}
 	}
@@ -20,7 +20,7 @@ async function resolveFasedAgentDocsPath(params) {
 		return null;
 	}
 	const packageDocs = path.join(packageRoot, "docs");
-	return syncFs.existsSync(packageDocs) ? packageDocs : null;
+	return fs.existsSync(packageDocs) ? packageDocs : null;
 }
 
 //#endregion

package/dist/agents/embedded-pi-mcp.js

@@ -1,6 +1,6 @@
 import { STATE_DIR } from "../config/paths.js";
 import { isRecord, resolveUserPath } from "../utils.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/embedded-pi-mcp.ts
@@ -66,10 +66,10 @@ function readBundleMcpFile(params) {
 	if (relative.startsWith("..") || path.isAbsolute(relative)) {
 		return {};
 	}
-	if (!syncFs.existsSync(filePath)) {
+	if (!fs.existsSync(filePath)) {
 		return {};
 	}
-	const raw = JSON.parse(syncFs.readFileSync(filePath, "utf-8"));
+	const raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
 	const servers = extractMcpServerMap(raw);
 	const baseDir = path.dirname(filePath);
 	return Object.fromEntries(Object.entries(servers).map(([serverName, server]) => [serverName, absolutizeBundleMcpServer({
@@ -99,7 +99,7 @@ function loadEnabledBundleMcpConfig(params) {
 			cfg: params.cfg,
 			pluginId
 		})) {
-			if (!syncFs.existsSync(rootDir)) {
+			if (!fs.existsSync(rootDir)) {
 				continue;
 			}
 			for (const fileName of BUNDLE_MCP_FILENAMES) {

package/dist/agents/identity-avatar.js

@@ -3,7 +3,7 @@ import { resolveAgentWorkspaceDir } from "./agent-scope.js";
 import { AVATAR_MAX_BYTES, isAvatarDataUrl, isAvatarHttpUrl, isPathWithinRoot, isSupportedLocalAvatarExtension } from "../shared/avatar-policy.js";
 import { resolveAgentIdentity } from "./identity.js";
 import { loadAgentIdentityFromWorkspace } from "./identity-file.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/identity-avatar.ts
@@ -28,7 +28,7 @@ function resolveAvatarSource(cfg, agentId, opts) {
 }
 function resolveExistingPath(value) {
 	try {
-		return syncFs.realpathSync(value);
+		return fs.realpathSync(value);
 	} catch {
 		return path.resolve(value);
 	}
@@ -51,7 +51,7 @@ function resolveLocalAvatarPath(params) {
 		};
 	}
 	try {
-		const stat = syncFs.statSync(realPath);
+		const stat = fs.statSync(realPath);
 		if (!stat.isFile()) {
 			return {
 				ok: false,

package/dist/agents/identity-file.js

@@ -1,5 +1,5 @@
 import { DEFAULT_IDENTITY_FILENAME } from "./workspace.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/agents/identity-file.ts
@@ -67,7 +67,7 @@ function identityHasValues(identity) {
 }
 function loadIdentityFromFile(identityPath) {
 	try {
-		const content = syncFs.readFileSync(identityPath, "utf-8");
+		const content = fs.readFileSync(identityPath, "utf-8");
 		const parsed = parseIdentityMarkdown(content);
 		if (!identityHasValues(parsed)) {
 			return null;

package/dist/agents/model-catalog-snapshot.js

@@ -0,0 +1,124 @@
+import { resolveAgentModelFallbackValues } from "../config/model-input.js";
+import { resolveAgentEffectiveModelPrimary, resolveAgentModelFallbacksOverride } from "./agent-scope.js";
+import { deriveModelMetadata } from "./model-metadata.js";
+import { resolveAuthenticatedModelCatalog } from "./authenticated-model-catalog.js";
+import { resolveTaskModelRole } from "../cron/task-model-roles.js";
+
+//#region src/agents/model-catalog-snapshot.ts
+const TASK_ROLES = [
+	"cheapCheck",
+	"strong",
+	"escalation",
+	"coding",
+	"summarizer"
+];
+function normalizeRef(value) {
+	const trimmed = value?.trim();
+	return trimmed || undefined;
+}
+function collectAssignments(params) {
+	const assignments = [];
+	const add = (role, ref) => {
+		const normalized = normalizeRef(ref);
+		if (normalized && !assignments.some((entry) => entry.role === role && entry.ref === normalized)) {
+			assignments.push({
+				role,
+				ref: normalized
+			});
+		}
+	};
+	add("primary", resolveAgentEffectiveModelPrimary(params.cfg, params.agentId));
+	const fallbacks = resolveAgentModelFallbacksOverride(params.cfg, params.agentId) ?? resolveAgentModelFallbackValues(params.cfg.agents?.defaults?.model);
+	for (const fallback of fallbacks) {
+		add("fallback", fallback);
+	}
+	for (const role of TASK_ROLES) {
+		add(role, resolveTaskModelRole({
+			cfg: params.cfg,
+			agentId: params.agentId,
+			role
+		})?.model);
+	}
+	return assignments;
+}
+function modelRef(model) {
+	return `${model.provider}/${model.id}`;
+}
+function buildProviderSummaries(models) {
+	const summaries = new Map();
+	for (const model of models) {
+		const providerId = model.metadata.publicProviderId;
+		const existing = summaries.get(providerId) ?? {
+			id: providerId,
+			label: model.metadata.publicProviderLabel,
+			routes: [],
+			credentialRoutes: [],
+			available: 0,
+			recommended: 0,
+			assigned: 0
+		};
+		if (!existing.routes.includes(model.provider)) {
+			existing.routes.push(model.provider);
+		}
+		for (const route of model.metadata.credentialRoutes) {
+			if (!existing.credentialRoutes.some((entry) => entry.id === route.id)) {
+				existing.credentialRoutes.push(route);
+			}
+		}
+		existing.available += 1;
+		existing.recommended += model.recommended ? 1 : 0;
+		existing.assigned += model.assignedRoles.length > 0 ? 1 : 0;
+		summaries.set(providerId, existing);
+	}
+	return [...summaries.values()].map((summary) => ({
+		...summary,
+		routes: summary.routes.toSorted(),
+		credentialRoutes: summary.credentialRoutes.toSorted((left, right) => left.label.localeCompare(right.label))
+	})).toSorted((left, right) => left.label.localeCompare(right.label));
+}
+async function resolveCanonicalModelCatalogSnapshot(params) {
+	const authenticated = await resolveAuthenticatedModelCatalog({
+		cfg: params.cfg,
+		store: params.store,
+		catalog: params.catalog,
+		defaultProvider: params.defaultProvider,
+		agentDir: params.agentDir
+	});
+	const configuredAssignments = collectAssignments({
+		cfg: params.cfg,
+		agentId: params.agentId
+	});
+	const assignmentsByRef = new Map();
+	for (const assignment of configuredAssignments) {
+		assignmentsByRef.set(assignment.ref, [...assignmentsByRef.get(assignment.ref) ?? [], assignment.role]);
+	}
+	const availableRefs = new Set(authenticated.usableCatalog.map(modelRef));
+	const runnableRefs = new Set(authenticated.allowedCatalog.map(modelRef));
+	const models = authenticated.usableCatalog.map((model) => {
+		const metadata = model.metadata ?? deriveModelMetadata({
+			model,
+			cfg: params.cfg
+		});
+		return {
+			...model,
+			metadata,
+			available: true,
+			runnable: runnableRefs.size === 0 || runnableRefs.has(modelRef(model)),
+			recommended: metadata.recommended === true,
+			assignedRoles: assignmentsByRef.get(modelRef(model)) ?? []
+		};
+	}).toSorted((left, right) => left.metadata.publicProviderLabel.localeCompare(right.metadata.publicProviderLabel) || Number(right.recommended) - Number(left.recommended) || (left.metadata.recommendationRank ?? Number.MAX_SAFE_INTEGER) - (right.metadata.recommendationRank ?? Number.MAX_SAFE_INTEGER) || left.name.localeCompare(right.name));
+	return {
+		generatedAt: new Date().toISOString(),
+		agentId: params.agentId,
+		models,
+		providers: buildProviderSummaries(models),
+		assignments: configuredAssignments.map((assignment) => ({
+			...assignment,
+			available: availableRefs.has(assignment.ref)
+		}))
+	};
+}
+
+//#endregion
+export { resolveCanonicalModelCatalogSnapshot };

package/dist/agents/model-catalog-status.js

@@ -1,4 +1,5 @@
 import { normalizeProviderId } from "./provider-id.js";
+import { listCurrentModelCatalogProviderIds } from "./current-model-catalog.js";
 import { deriveModelMetadata } from "./model-metadata.js";
 import { listProviderExtensionCatalogManifestEntries } from "./provider-extension-catalog-manifest.js";
 
@@ -137,7 +138,11 @@ function buildModelCatalogStatus(params) {
 	})).toSorted((left, right) => left.provider.localeCompare(right.provider));
 	const manifestEntries = listProviderExtensionCatalogManifestEntries();
 	const mappedManifestProviderIds = [...new Set(manifestEntries.flatMap((entry) => entry.status === "mapped" ? entry.fasedProviderIds.map(normalizeProviderId) : []))].filter(Boolean).toSorted((left, right) => left.localeCompare(right));
-	const catalogProviderIds = new Set(providerRows.map((provider) => provider.provider));
+	const catalogProviderIds = new Set([
+		...listCurrentModelCatalogProviderIds(),
+		...providerRows.map((provider) => provider.provider),
+		...Object.keys(params.providerExtensionCatalog?.providers ?? {}).map(normalizeProviderId)
+	]);
 	const deferredProviderIds = manifestEntries.filter((entry) => entry.status === "deferred").map((entry) => normalizeProviderId(entry.upstreamProviderId)).filter(Boolean).toSorted((left, right) => left.localeCompare(right));
 	const providerExtensionEntries = (params.providerExtensionCatalog?.entries ?? []).map((entry) => ({
 		id: entry.id,

package/dist/agents/openai-codex-app-server.js

@@ -1,5 +1,6 @@
+import { resolveFasedAgentPackageRootSync } from "../infra/fased-root.js";
 import { resolvePluginInstallDir } from "../plugins/install.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
@@ -42,30 +43,54 @@ function executableName() {
 function codexExecutableCandidates() {
 	const configured = process.env.FASED_CODEX_BIN?.trim();
 	const componentRoot = resolvePluginInstallDir("openai-runtime");
+	const packageRoot = resolveFasedAgentPackageRootSync({
+		moduleUrl: import.meta.url,
+		argv1: process.argv[1],
+		cwd: process.cwd()
+	});
 	const candidates = [
 		configured,
 		path.join(componentRoot, "node_modules", ".bin", executableName()),
 		path.join(componentRoot, "node_modules", "@openai", "codex", "bin", executableName()),
-		"codex"
+		packageRoot ? path.join(packageRoot, "extensions", "runtime-openai", "node_modules", ".bin", executableName()) : undefined
 	].filter((value) => Boolean(value));
 	return [...new Set(candidates)];
 }
 function resolveOpenAICodexExecutable() {
+	const explicitlyConfigured = process.env.FASED_CODEX_BIN?.trim();
 	for (const candidate of codexExecutableCandidates()) {
-		if (candidate === "codex") {
-			return candidate;
-		}
 		try {
-			if (syncFs.statSync(candidate).isFile()) {
+			if (!fs.statSync(candidate).isFile()) {
+				continue;
+			}
+			if (explicitlyConfigured && candidate === explicitlyConfigured) {
 				return candidate;
 			}
+			const resolved = fs.realpathSync(candidate);
+			let current = path.dirname(resolved);
+			for (let depth = 0; depth < 6; depth += 1) {
+				try {
+					const parsed = JSON.parse(fs.readFileSync(path.join(current, "package.json"), "utf8"));
+					if (parsed.name === "@openai/codex") {
+						if (parsed.version === OPENAI_CODEX_APP_SERVER_VERSION) {
+							return candidate;
+						}
+						break;
+					}
+				} catch {}
+				const parent = path.dirname(current);
+				if (parent === current) {
+					break;
+				}
+				current = parent;
+			}
 		} catch {}
 	}
 	return null;
 }
 function managedCodexHome() {
 	const directory = path.join(stateDir(), "runtime", "openai-codex");
-	syncFs.mkdirSync(directory, {
+	fs.mkdirSync(directory, {
 		recursive: true,
 		mode: 448
 	});
@@ -228,7 +253,7 @@ function parseAppServerModels(value) {
 	});
 }
 async function listOpenAICodexAppServerModels(params) {
-	const executable = params.executable ?? resolveOpenAICodexExecutable();
+	const executable = params.executable ?? (params.resolveExecutable ? await params.resolveExecutable() : resolveOpenAICodexExecutable());
 	if (!executable) {
 		throw new Error("OpenAI sign-in runtime is not installed. Run `fased components install openai-runtime`.");
 	}
@@ -337,7 +362,7 @@ function createOpenAICodexAppServerStreamFn(params) {
 				if (!token) {
 					throw new Error("OpenAI ChatGPT sign-in is required");
 				}
-				const executable = resolveOpenAICodexExecutable();
+				const executable = params?.resolveExecutable ? await params.resolveExecutable() : resolveOpenAICodexExecutable();
 				if (!executable) {
 					throw new Error("OpenAI sign-in runtime is not installed. Run `fased components install openai-runtime`.");
 				}
@@ -496,4 +521,4 @@ const testing = {
 };
 
 //#endregion
-export { createOpenAICodexAppServerStreamFn, listOpenAICodexAppServerModels };
+export { createOpenAICodexAppServerStreamFn, listOpenAICodexAppServerModels, resolveOpenAICodexExecutable };

package/dist/agents/openai-codex-runtime-component.js

@@ -0,0 +1,39 @@
+import { VERSION } from "../version.js";
+import { resolveOpenAICodexExecutable } from "./openai-codex-app-server.js";
+import { installCapabilityComponent } from "../capabilities/install.js";
+
+//#region src/agents/openai-codex-runtime-component.ts
+const OPENAI_RUNTIME_COMPONENT_ID = "openai-runtime";
+function hasConfiguredOpenAICodexProfile(config) {
+	return Object.values(config.auth?.profiles ?? {}).some((profile) => profile?.provider === "openai-codex");
+}
+async function ensureOpenAICodexRuntimeComponent(params) {
+	const resolveExecutable = params.resolveExecutable ?? resolveOpenAICodexExecutable;
+	const existing = resolveExecutable();
+	if (existing) {
+		return {
+			config: params.config,
+			executable: existing,
+			installed: false,
+			slotWarnings: []
+		};
+	}
+	const installed = await (params.installComponent ?? installCapabilityComponent)({
+		id: OPENAI_RUNTIME_COMPONENT_ID,
+		config: params.config,
+		packageSpec: `@fased/openai-runtime@${params.version ?? VERSION}`
+	});
+	const executable = resolveExecutable();
+	if (!executable) {
+		throw new Error("OpenAI sign-in runtime installation completed without an executable. Run `fased components install openai-runtime` and retry.");
+	}
+	return {
+		config: installed.config,
+		executable,
+		installed: true,
+		slotWarnings: installed.slotWarnings
+	};
+}
+
+//#endregion
+export { OPENAI_RUNTIME_COMPONENT_ID, ensureOpenAICodexRuntimeComponent, hasConfiguredOpenAICodexProfile };

package/dist/agents/pi-embedded-runner/compact.js

@@ -19,8 +19,8 @@ import { enqueueCommandInLane } from "../../process/command-queue.js";
 import { resolveSignalReactionLevel } from "../../signal/reaction-level.js";
 import { resolveTelegramInlineButtonsScope } from "../../telegram/inline-buttons.js";
 import { resolveTelegramReactionLevel } from "../../telegram/reaction-level.js";
-import { buildModelAliasLines } from "../model-alias-lines.js";
 import { formatUserTime, resolveUserTimeFormat, resolveUserTimezone } from "../date-time.js";
+import { buildModelAliasLines } from "../model-alias-lines.js";
 import { resolveModelForExecution } from "./model.js";
 import { buildTtsSystemPromptHint } from "../../tts/tts.js";
 import { isReasoningTagProvider } from "../../utils/provider-utils.js";