@promptbook/cli 0.114.0-29 → 0.114.0-30

package/apps/agents-server/src/app/admin/about/page.tsx

@@ -30,7 +30,7 @@ import { Card } from '../../../components/Homepage/Card';
 import { Section } from '../../../components/Homepage/Section';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
 import { getSession } from '../../../utils/session';
-import { listRegisteredServersUsingServiceRole } from '../../../utils/serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../../../utils/serverRegistryNode';
 
 /**
  * Constant for promptbook about text.

package/apps/agents-server/src/app/page.tsx

@@ -11,10 +11,10 @@ import { isUserAdmin } from '../utils/isUserAdmin';
 import { isUserGlobalAdmin } from '../utils/isUserGlobalAdmin';
 import {
     createServerPublicUrl,
-    listRegisteredServersUsingServiceRole,
     resolveRegisteredServerByHost,
     type ServerRecord,
 } from '../utils/serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../utils/serverRegistryNode';
 import { isStandaloneVpsRawIpBootstrapActive } from '../utils/standaloneVpsRawIpBootstrap';
 import { getHomePageAgents } from './_data/getHomePageAgents';
 

package/apps/agents-server/src/constants/federatedAgentImport.ts

@@ -1,3 +1,10 @@
+/**
+ * Metadata key storing the comma-separated federated server URL list.
+ *
+ * @private shared Agents Server constant
+ */
+export const FEDERATED_SERVERS_METADATA_KEY = 'FEDERATED_SERVERS' as const;
+
 /**
  * Metadata key storing the delay between retry attempts when importing federated agent books.
  *

package/apps/agents-server/src/middleware/createMiddlewareRequestContext/loadRegisteredServers.ts

@@ -1,4 +1,6 @@
+import { isAgentsServerSqliteMode } from '../../database/agentsServerDatabaseMode';
 import {
+    listEnvironmentRegisteredServers,
     listRegisteredServersUsingServiceRole,
     type ServerRecord,
 } from '../../utils/serverRegistry';
@@ -12,6 +14,12 @@ import {
  */
 export async function loadRegisteredServers(): Promise<Array<ServerRecord>> {
     try {
+        if (isAgentsServerSqliteMode()) {
+            // Note: Edge middleware cannot open the standalone SQLite registry. `SERVERS`
+            //       supplies the domain list required for its host-routing decisions.
+            return listEnvironmentRegisteredServers();
+        }
+
         return await listRegisteredServersUsingServiceRole();
     } catch (error) {
         console.error('Error loading server registry in middleware:', error);

package/apps/agents-server/src/tools/$provideServer.ts

@@ -3,7 +3,8 @@ import { headers } from 'next/headers';
 import { cache } from 'react';
 import { isAgentsServerSqliteMode } from '../database/agentsServerDatabaseMode';
 import { resolveInternalServerOrigin } from '../utils/resolveInternalServerOrigin';
-import { createServerPublicUrl, listRegisteredServersUsingServiceRole } from '../utils/serverRegistry';
+import { createServerPublicUrl } from '../utils/serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../utils/serverRegistryNode';
 import { resolveServerSelection } from '../utils/serverSelection';
 import { getServerContextOverride } from './serverContextOverride';
 

package/apps/agents-server/src/tools/mapRegisteredServerContexts.ts

@@ -1,10 +1,10 @@
 import {
     createServerPublicUrl,
-    listRegisteredServersUsingServiceRole,
     normalizeServerDomain,
     resolveRegisteredServerByHost,
     type ServerRecord,
 } from '../utils/serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../utils/serverRegistryNode';
 import type { ProvidedServer } from './$provideServer';
 import { runWithServerContextOverride } from './serverContextOverride';
 

package/apps/agents-server/src/utils/agentProjects/listAllAgentProjectSummaries.ts

@@ -5,7 +5,8 @@ import { runWithServerContextOverride } from '@/src/tools/serverContextOverride'
 import { DatabaseError } from '../../../../../src/errors/DatabaseError';
 import { spaceTrim } from '../../../../../src/utils/organization/spaceTrim';
 import { createLocalAgentDirectoryName, resolveLocalAgentRootPath } from '../localChatRunner/ensureLocalAgentFolder';
-import { createServerPublicUrl, type ServerRecord, listRegisteredServersUsingServiceRole } from '../serverRegistry';
+import { createServerPublicUrl, type ServerRecord } from '../serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../serverRegistryNode';
 import type { AgentProjectsSummary, AllAgentProjectsReport } from './AgentProjectInfo';
 import { listAgentProjects } from './listAgentProjects';
 

package/apps/agents-server/src/utils/createWellKnownAgentUrl.ts

@@ -0,0 +1,17 @@
+import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../../../servers';
+import type { string_agent_url } from '../../../../src/_packages/types.index';
+import { createLocalAgentUrl } from './localAgentRouteReferences';
+
+/**
+ * Creates the local profile URL of one bundled well-known agent.
+ *
+ * @param localServerUrl - Public origin of the owning Agents Server.
+ * @param agentName - Logical well-known agent identifier.
+ * @returns Canonical URL for the bundled agent.
+ */
+export function createWellKnownAgentUrl(
+    localServerUrl: string,
+    agentName: keyof typeof CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES,
+): string_agent_url {
+    return createLocalAgentUrl(localServerUrl, CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES[agentName]);
+}

package/apps/agents-server/src/utils/currentServerRegistryContext.ts

@@ -1,5 +1,6 @@
 import { headers } from 'next/headers';
-import { listRegisteredServersUsingServiceRole, type ServerRecord } from './serverRegistry';
+import type { ServerRecord } from './serverRegistry';
+import { listRegisteredServersUsingServiceRole } from './serverRegistryNode';
 import { resolveServerSelection } from './serverSelection';
 
 /**

package/apps/agents-server/src/utils/customDomainRouting.ts

@@ -12,12 +12,15 @@ import { NotFoundError } from '../../../../src/errors/NotFoundError';
 import { ParseError } from '../../../../src/errors/ParseError';
 import { spaceTrim } from '../../../../src/utils/organization/spaceTrim';
 import { normalizeDomainForMatching } from '../../../../src/utils/validators/url/normalizeDomainForMatching';
-import type { FederatedAgentImportConfiguration } from '../constants/federatedAgentImport';
+import {
+    DEFAULT_FEDERATED_AGENT_IMPORT_CONFIGURATION,
+    FEDERATED_AGENT_IMPORT_MAX_ATTEMPTS,
+    FEDERATED_AGENT_IMPORT_RETRY_DELAY_MS_METADATA_KEY,
+    FEDERATED_SERVERS_METADATA_KEY,
+    type FederatedAgentImportConfiguration,
+} from '../constants/federatedAgentImport';
 import { isSameAgentPermanentId } from './agentIdentifier';
 import { createServerAgentReferenceResolver } from './agentReferenceResolver/createServerAgentReferenceResolver';
-import { loadFederatedAgentImportConfiguration } from './federatedAgentImportConfiguration';
-import { getFederatedServers } from './getFederatedServers';
-import { getWellKnownAgentUrl } from './getWellKnownAgentUrl';
 import {
     createLocalAgentUrl,
     normalizeLocalAgentUrlReferences,
@@ -26,6 +29,8 @@ import {
 } from './localAgentRouteReferences';
 import { createMissingImportedAgentFallback } from './createMissingImportedAgentFallback';
 import { resolveInheritedAgentSource, type AgentSourceImporter } from './resolveInheritedAgentSource';
+import { createWellKnownAgentUrl } from './createWellKnownAgentUrl';
+import { parseFederatedServers } from './parseFederatedServers';
 import { createServerPublicUrl, type ServerRecord } from './serverRegistry';
 
 /**
@@ -38,6 +43,16 @@ const HTTP_PROTOCOL_PREFIX = 'http://';
  */
 const HTTPS_PROTOCOL_PREFIX = 'https://';
 
+/**
+ * Metadata values needed to resolve inherited custom-domain agent sources in Edge middleware.
+ *
+ * @private constant of custom-domain routing
+ */
+const CUSTOM_DOMAIN_FEDERATED_METADATA_KEYS = [
+    FEDERATED_SERVERS_METADATA_KEY,
+    FEDERATED_AGENT_IMPORT_RETRY_DELAY_MS_METADATA_KEY,
+] as const;
+
 /**
  * Candidate values used when searching one custom host in `agentProfile`.
  */
@@ -134,6 +149,35 @@ type CustomDomainAgentRow = {
  */
 type ResolvedCustomDomainMetadata = Pick<AgentBasicInformation, 'links' | 'meta'>;
 
+/**
+ * Metadata row shape needed while resolving a custom-domain agent in Edge middleware.
+ *
+ * @private type of custom-domain routing
+ */
+type CustomDomainMetadataRow = {
+    readonly key: unknown;
+    readonly value: unknown;
+};
+
+/**
+ * Dedicated server-limit row shape needed while resolving a custom-domain agent in Edge middleware.
+ *
+ * @private type of custom-domain routing
+ */
+type CustomDomainServerLimitRow = {
+    readonly value: unknown;
+};
+
+/**
+ * Federation dependencies scoped to the server currently considered for a custom-domain match.
+ *
+ * @private type of custom-domain routing
+ */
+type CustomDomainFederatedDependencies = {
+    readonly federatedAgentImportConfiguration: FederatedAgentImportConfiguration;
+    readonly federatedServers: ReadonlyArray<string>;
+};
+
 /**
  * Creates a minimal local collection used only for compact-reference initialization.
  *
@@ -426,12 +470,6 @@ export async function resolveCustomDomainAgent(
         return null;
     }
 
-    const [federatedServers, adamAgentUrl, federatedAgentImportConfiguration] = await Promise.all([
-        getFederatedServers(),
-        getWellKnownAgentUrl('ADAM'),
-        loadFederatedAgentImportConfiguration(),
-    ]);
-
     for (const server of servers) {
         try {
             const tableName = `${server.tablePrefix}Agent`;
@@ -455,6 +493,9 @@ export async function resolveCustomDomainAgent(
             }
 
             const localServerUrl = createServerPublicUrl(server.domain).href;
+            const { federatedServers, federatedAgentImportConfiguration } =
+                await loadCustomDomainFederatedDependencies(supabase, server);
+            const adamAgentUrl = createWellKnownAgentUrl(localServerUrl, 'ADAM');
             const agentCollection = createResolverAgentCollection(
                 resolverReferenceAgents as Array<CustomDomainAgentRow>,
             );
@@ -502,6 +543,98 @@ export async function resolveCustomDomainAgent(
     return null;
 }
 
+/**
+ * Loads federation settings for the server currently checked for a custom-domain agent.
+ *
+ * Middleware already owns an Edge-compatible Supabase client. Reading the needed rows through
+ * that client keeps custom-domain routing usable in the Edge runtime and avoids request-scoped
+ * Node database helpers, which can load the standalone SQLite backend.
+ *
+ * @param supabase - Edge-compatible Supabase client supplied by middleware.
+ * @param server - Candidate server whose inherited agent source is being resolved.
+ * @returns Federation dependencies, falling back to safe defaults when configuration is unavailable.
+ *
+ * @private function of custom-domain routing
+ */
+async function loadCustomDomainFederatedDependencies(
+    supabase: SupabaseClient,
+    server: ServerRecord,
+): Promise<CustomDomainFederatedDependencies> {
+    try {
+        const metadataTableName = `${server.tablePrefix}Metadata`;
+        const serverLimitTableName = `${server.tablePrefix}ServerLimit`;
+        const [metadataResponse, serverLimitResponse] = await Promise.all([
+            supabase.from(metadataTableName).select('key, value').in('key', CUSTOM_DOMAIN_FEDERATED_METADATA_KEYS),
+            supabase
+                .from(serverLimitTableName)
+                .select('value')
+                .eq('key', FEDERATED_AGENT_IMPORT_RETRY_DELAY_MS_METADATA_KEY)
+                .maybeSingle(),
+        ]);
+        const metadataRows = metadataResponse.error
+            ? []
+            : ((Array.isArray(metadataResponse.data) ? metadataResponse.data : []) as Array<CustomDomainMetadataRow>);
+        const serverLimitRow = serverLimitResponse.error
+            ? null
+            : (serverLimitResponse.data as CustomDomainServerLimitRow | null);
+        const federatedServersValue = readCustomDomainMetadataValue(metadataRows, FEDERATED_SERVERS_METADATA_KEY);
+        const legacyRetryDelayValue = readCustomDomainMetadataValue(
+            metadataRows,
+            FEDERATED_AGENT_IMPORT_RETRY_DELAY_MS_METADATA_KEY,
+        );
+
+        return {
+            federatedServers: parseFederatedServers(federatedServersValue),
+            federatedAgentImportConfiguration: {
+                maxAttempts: FEDERATED_AGENT_IMPORT_MAX_ATTEMPTS,
+                retryDelayMs: normalizeFederatedAgentImportRetryDelayMs(
+                    serverLimitRow?.value ?? legacyRetryDelayValue,
+                ),
+            },
+        };
+    } catch {
+        return {
+            federatedServers: [],
+            federatedAgentImportConfiguration: DEFAULT_FEDERATED_AGENT_IMPORT_CONFIGURATION,
+        };
+    }
+}
+
+/**
+ * Reads one named metadata value from a custom-domain routing query result.
+ *
+ * @param rows - Raw metadata rows loaded for the candidate server.
+ * @param key - Metadata key to read.
+ * @returns Stored string value, or `undefined` when unavailable.
+ *
+ * @private function of custom-domain routing
+ */
+function readCustomDomainMetadataValue(
+    rows: ReadonlyArray<CustomDomainMetadataRow>,
+    key: string,
+): string | undefined {
+    const row = rows.find((candidate) => candidate.key === key);
+    return typeof row?.value === 'string' ? row.value : undefined;
+}
+
+/**
+ * Normalizes the one federation retry delay used by Edge custom-domain routing.
+ *
+ * @param value - Dedicated limit or legacy metadata value.
+ * @returns A finite non-negative retry delay, or the shared default.
+ *
+ * @private function of custom-domain routing
+ */
+function normalizeFederatedAgentImportRetryDelayMs(value: unknown): number {
+    const parsedValue = Number(value);
+
+    if (!Number.isFinite(parsedValue) || parsedValue < 0) {
+        return DEFAULT_FEDERATED_AGENT_IMPORT_CONFIGURATION.retryDelayMs;
+    }
+
+    return Math.floor(parsedValue);
+}
+
 /**
  * Returns unique, non-empty values while keeping original order.
  *

package/apps/agents-server/src/utils/getFederatedServers.ts

@@ -1,24 +1,14 @@
-import { string_promptbook_server_url } from '@promptbook-local/types';
+import type { string_promptbook_server_url } from '@promptbook-local/types';
+import { FEDERATED_SERVERS_METADATA_KEY } from '../constants/federatedAgentImport';
 import { getMetadataMap } from '../database/getMetadata';
-
-/**
- * Metadata key storing the comma-separated federated servers list.
- *
- * @private
- */
-const FEDERATED_SERVERS_METADATA_KEY = 'FEDERATED_SERVERS';
+import { parseFederatedServers } from './parseFederatedServers';
 
 /**
  * Reads FEDERATED_SERVERS metadata and returns a normalized list of server URLs.
  *
  * @public exported from `apps/agents-server`
  */
-export async function getFederatedServers(): Promise<string_promptbook_server_url[]> {
+export async function getFederatedServers(): Promise<Array<string_promptbook_server_url>> {
     const metadata = await getMetadataMap([FEDERATED_SERVERS_METADATA_KEY]);
-    const federatedServersString = metadata[FEDERATED_SERVERS_METADATA_KEY] || '';
-
-    return federatedServersString
-        .split(',')
-        .map((server) => server.trim())
-        .filter((server): server is string_promptbook_server_url => server !== '');
+    return parseFederatedServers(metadata[FEDERATED_SERVERS_METADATA_KEY]);
 }

package/apps/agents-server/src/utils/getWellKnownAgentUrl.ts

@@ -1,5 +1,6 @@
 import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../../../servers';
 import { string_agent_url } from '../../../../src/_packages/types.index'; // <- [🚾]
+import { createWellKnownAgentUrl } from './createWellKnownAgentUrl';
 import { resolveCurrentOrInternalServerOrigin } from './resolveCurrentOrInternalServerOrigin';
 
 /**
@@ -14,7 +15,5 @@ export async function getWellKnownAgentUrl(
     agentName: keyof typeof CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES,
 ): Promise<string_agent_url> {
     const localServerOrigin = await resolveCurrentOrInternalServerOrigin();
-    const normalizedServerOrigin = localServerOrigin.replace(/\/+$/g, '');
-
-    return `${normalizedServerOrigin}/agents/${CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES[agentName]}` as string_agent_url;
+    return createWellKnownAgentUrl(localServerOrigin, agentName);
 }

package/apps/agents-server/src/utils/parseFederatedServers.ts

@@ -0,0 +1,14 @@
+import type { string_promptbook_server_url } from '@promptbook-local/types';
+
+/**
+ * Parses a comma-separated federated-server metadata value.
+ *
+ * @param value - Raw stored metadata value.
+ * @returns Normalized non-empty server URL values.
+ */
+export function parseFederatedServers(value: string | null | undefined): Array<string_promptbook_server_url> {
+    return (value || '')
+        .split(',')
+        .map((serverUrl) => serverUrl.trim())
+        .filter((serverUrl): serverUrl is string_promptbook_server_url => serverUrl !== '');
+}

package/apps/agents-server/src/utils/serverManagement/getManagedServerById.ts

@@ -1,7 +1,7 @@
 import { spaceTrim } from 'spacetrim';
 import { NotFoundError } from '../../../../../src/errors/NotFoundError';
 import type { ServerRecord } from '../serverRegistry';
-import { listRegisteredServersUsingServiceRole } from '../serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../serverRegistryNode';
 import { SERVER_REGISTRY_TABLE_NAME } from './SERVER_REGISTRY_TABLE_NAME';
 
 /**

package/apps/agents-server/src/utils/serverManagement/listManagedServers.ts

@@ -1,5 +1,5 @@
 import type { ServerRecord } from '../serverRegistry';
-import { listRegisteredServersUsingServiceRole } from '../serverRegistry';
+import { listRegisteredServersUsingServiceRole } from '../serverRegistryNode';
 
 /**
  * Loads all registered servers directly from the shared registry cache.

package/apps/agents-server/src/utils/serverRegistry.ts

@@ -140,21 +140,6 @@ export async function listRegisteredServersUsingServiceRole(options?: {
 }): Promise<Array<ServerRecord>> {
     const environmentServers = listEnvironmentRegisteredServers();
 
-    if (isAgentsServerSqliteMode()) {
-        if (isEdgeRuntime()) {
-            // Note: The Edge middleware cannot open SQLite files. It only needs the domain list
-            //       for host matching and never queries server tables in SQLite mode, so the
-            //       environment-derived rows are sufficient there.
-            return environmentServers;
-        }
-
-        // Note: In standalone SQLite mode the VPS registry database is the source of truth.
-        //       Every server row carries its own unique table prefix selecting the isolated
-        //       per-server database file, so servers cannot leak data into each other.
-        const { listStandaloneRegisteredServers } = await import('../database/sqlite/standaloneServerRegistryStore');
-        return listStandaloneRegisteredServers();
-    }
-
     const shouldReuseCache =
         !options?.forceRefresh &&
         cachedServerRegistry !== null &&
@@ -217,15 +202,6 @@ export function listEnvironmentRegisteredServers(): Array<ServerRecord> {
     }));
 }
 
-/**
- * Checks whether the current code runs inside the Next.js Edge runtime.
- *
- * @returns `true` when running in the Edge runtime (for example in middleware).
- */
-function isEdgeRuntime(): boolean {
-    return process.env.NEXT_RUNTIME === 'edge';
-}
-
 /**
  * Finds one registered server by incoming host header.
  *

package/apps/agents-server/src/utils/serverRegistryNode.ts

@@ -0,0 +1,27 @@
+import { isAgentsServerSqliteMode } from '../database/agentsServerDatabaseMode';
+import { listStandaloneRegisteredServers } from '../database/sqlite/standaloneServerRegistryStore';
+import {
+    listRegisteredServersUsingServiceRole as listSupabaseRegisteredServersUsingServiceRole,
+    type ServerRecord,
+} from './serverRegistry';
+
+/**
+ * Loads registered servers for a Node.js request or background task.
+ *
+ * The standalone SQLite registry is deliberately imported only by this Node.js-only
+ * module. Edge middleware must use environment-derived server rows instead, because
+ * importing SQLite code makes Next.js compile native database dependencies into its
+ * Edge bundle.
+ *
+ * @param options - Cache controls for the Supabase registry lookup.
+ * @returns Registered servers ordered by name.
+ */
+export async function listRegisteredServersUsingServiceRole(options?: {
+    readonly forceRefresh?: boolean;
+}): Promise<Array<ServerRecord>> {
+    if (isAgentsServerSqliteMode()) {
+        return listStandaloneRegisteredServers();
+    }
+
+    return listSupabaseRegisteredServersUsingServiceRole(options);
+}

package/esm/apps/agents-server/src/constants/federatedAgentImport.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Metadata key storing the comma-separated federated server URL list.
+ *
+ * @private shared Agents Server constant
+ */
+export declare const FEDERATED_SERVERS_METADATA_KEY: "FEDERATED_SERVERS";
 /**
  * Metadata key storing the delay between retry attempts when importing federated agent books.
  *

package/esm/index.es.js

@@ -48,7 +48,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.114.0-29';
+const PROMPTBOOK_ENGINE_VERSION = '0.114.0-30';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1843,6 +1843,8 @@ const PROMPT_RUNNER_MODEL_OPTION_DESCRIPTION = spaceTrim$1(`
     OpenAI examples: gpt-5.2-codex, default
     Gemini examples: gemini-3-flash-preview, default
     Qwen examples: qwen3.8-max, default
+
+    For openai-codex, "default" overrides no model at all and keeps the one configured in Codex itself, which is what a ChatGPT-account login accepts
 `);
 /**
  * Commander description for the `--git-changes` option.
@@ -26860,6 +26862,9 @@ function buildCodexScript(options) {
         fi
     `);
     const thinkingLevel = (_a = options.thinkingLevel) !== null && _a !== void 0 ? _a : DEFAULT_CODEX_THINKING_LEVEL;
+    // Note: Without an explicit model Codex keeps the model of its own configuration, which is what a
+    //       ChatGPT-account login needs — it rejects every model that Codex itself does not offer
+    const modelArgument = options.model ? ` --model ${options.model}` : '';
     const lines = [
         'if [ -n "${PTBK_AGENTS_SERVER_ENV_FILE:-}" ] && [ -f "${PTBK_AGENTS_SERVER_ENV_FILE}" ]; then',
         'set -a',
@@ -26886,7 +26891,7 @@ function buildCodexScript(options) {
         '    "${CODEX_LOGIN_METHOD_ARGUMENTS[@]}" \\',
         `    -c model_reasoning_effort="${thinkingLevel}" \\`,
         `    --ask-for-approval ${options.askForApproval} \\`,
-        `    exec --model ${options.model} \\`,
+        `    exec${modelArgument} \\`,
         ...(options.isMachineReadableProgressEnabled ? ['    --json \\'] : []),
         '    --local-provider none \\',
         `    --sandbox ${options.sandbox} \\`,
@@ -26934,6 +26939,9 @@ const CODEX_FALLBACK_PRICING_MODEL = 'gpt-5.1';
 const DEFAULT_CODEX_COMPLETION_SHARE = 0.1;
 /**
  * Builds usage stats from Codex CLI output.
+ *
+ * The `modelName` is omitted when Codex ran without a model override, in which case only Codex knows which
+ * model it picked and the price can be estimated from the fallback pricing alone.
  */
 function buildCodexUsageFromOutput(output, modelName) {
     const breakdown = parseCodexTokenBreakdown(output);
@@ -27070,18 +27078,25 @@ function parseCodexTokenCount(value) {
 }
 /**
  * Resolves a pricing model to estimate Codex cost from total tokens.
+ *
+ * An unknown model — and a run without any model override, where Codex picked the model itself — is priced
+ * with `CODEX_FALLBACK_PRICING_MODEL`, so the estimate stays in the right order of magnitude.
  */
 function resolveCodexPricing(modelName) {
     var _a, _b, _c;
-    const exactMatch = (_a = OPENAI_MODELS.find((model) => model.modelName === modelName)) === null || _a === void 0 ? void 0 : _a.pricing;
+    const fallbackPricing = (_a = OPENAI_MODELS.find((model) => model.modelName === CODEX_FALLBACK_PRICING_MODEL)) === null || _a === void 0 ? void 0 : _a.pricing;
+    if (modelName === undefined) {
+        return fallbackPricing;
+    }
+    const exactMatch = (_b = OPENAI_MODELS.find((model) => model.modelName === modelName)) === null || _b === void 0 ? void 0 : _b.pricing;
     if (exactMatch) {
         return exactMatch;
     }
-    const prefixMatch = (_b = OPENAI_MODELS.find((model) => modelName.startsWith(model.modelName))) === null || _b === void 0 ? void 0 : _b.pricing;
+    const prefixMatch = (_c = OPENAI_MODELS.find((model) => modelName.startsWith(model.modelName))) === null || _c === void 0 ? void 0 : _c.pricing;
     if (prefixMatch) {
         return prefixMatch;
     }
-    return (_c = OPENAI_MODELS.find((model) => model.modelName === CODEX_FALLBACK_PRICING_MODEL)) === null || _c === void 0 ? void 0 : _c.pricing;
+    return fallbackPricing;
 }
 
 /**
@@ -27890,9 +27905,9 @@ class QwenCodeRunner {
 }
 
 /**
- * Constant for default codex model.
+ * Value of `--model` which asks for the default model of the selected harness instead of naming one.
  */
-const DEFAULT_CODEX_MODEL = 'gpt-5.2-codex';
+const DEFAULT_MODEL_NAME = 'default';
 /**
  * Constant for cline model.
  */
@@ -27919,7 +27934,7 @@ function resolvePromptRunner(options) {
         return createRunnerResolution(options, new ClineRunner({ model: CLINE_MODEL }));
     }
     if (agentName === 'github-copilot') {
-        const actualRunnerModel = options.model === 'default' ? undefined : options.model;
+        const actualRunnerModel = options.model === DEFAULT_MODEL_NAME ? undefined : options.model;
         return createRunnerResolution(options, new GitHubCopilotRunner({
             model: actualRunnerModel,
             thinkingLevel: options.thinkingLevel,
@@ -27951,7 +27966,9 @@ function createOpenAiCodexRunnerResolution(options) {
     const actualRunnerModel = resolveRequiredModel({
         agentName: 'openai-codex',
         providedModel: options.model,
-        defaultModel: DEFAULT_CODEX_MODEL,
+        // Note: Codex must not be pinned to any model of ours, because a ChatGPT-account login only accepts the
+        //       models which Codex itself offers — `default` therefore keeps the model from `~/.codex/config.toml`
+        defaultModel: undefined,
         availableModels: OPENAI_MODELS.filter((model) => model.modelVariant === 'CHAT').map((model) => model.modelName),
         exampleUsages: ['--harness openai-codex --model gpt-5.2-codex', '--harness openai-codex --model default'],
     });
@@ -28034,12 +28051,15 @@ function isModelRequiringHarnessName(agentName) {
 }
 /**
  * Resolves a runner model, allowing `default` but otherwise requiring an explicit value.
+ *
+ * The `defaultModel` of a harness is either the model name which `--model default` stands for, or `undefined`
+ * when the harness must be started **without any model override** and keep the model of its own configuration.
  */
 function resolveRequiredModel(options) {
     if (!options.providedModel) {
         exitForMissingModel(options.agentName, options.availableModels, options.exampleUsages);
     }
-    if (options.providedModel === 'default') {
+    if (options.providedModel === DEFAULT_MODEL_NAME) {
         return options.defaultModel;
     }
     return options.providedModel;
@@ -41408,6 +41428,11 @@ function stopChildProcess(commandProcess) {
     commandProcess.kill();
 }
 
+/**
+ * Metadata key storing the comma-separated federated server URL list.
+ *
+ * @private shared Agents Server constant
+ */
 /**
  * Metadata key storing the delay between retry attempts when importing federated agent books.
  *