@minniexcode/codex-switch 0.1.0 → 0.1.2

package/dist/app/edit-provider.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.editProvider = editProvider;
 const errors_1 = require("../domain/errors");
-const config_1 = require("../domain/config");
 const providers_1 = require("../domain/providers");
 const config_repo_1 = require("../storage/config-repo");
 const fs_utils_1 = require("../storage/fs-utils");
@@ -24,6 +23,7 @@ function editProvider(args) {
     }
     const updatedFields = [];
     const nextProfile = args.profile ?? current.profile;
+    const nextModel = args.model === null ? undefined : args.model ?? current.model;
     if (args.profile !== undefined && args.profile !== current.profile) {
         updatedFields.push("profile");
     }
@@ -33,6 +33,9 @@ function editProvider(args) {
     if (args.baseUrl !== undefined && (args.baseUrl ?? undefined) !== current.baseUrl) {
         updatedFields.push("baseUrl");
     }
+    if (args.model !== undefined && args.model !== current.model) {
+        updatedFields.push("model");
+    }
     if (args.note !== undefined && (args.note ?? undefined) !== current.note) {
         updatedFields.push("note");
     }
@@ -41,87 +44,46 @@ function editProvider(args) {
     }
     const oldProfile = current.profile;
     const newProfile = nextProfile;
-    const targetSection = document.profiles.find((profile) => profile.name === newProfile) ?? null;
     const targetModelProviderSection = document.modelProviders.find((entry) => entry.name === newProfile) ?? null;
-    const targetProfileExists = Boolean(targetSection);
-    let upsertProfiles;
     let upsertModelProviders;
-    if (!targetProfileExists) {
-        if (!args.createProfile) {
-            throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${newProfile}" does not exist in config.toml.`, {
-                profile: newProfile,
-                provider: args.providerName,
-            });
-        }
-        if (!args.baseUrl || args.baseUrl.trim() === "") {
+    const resolvedBaseUrl = (args.baseUrl ?? current.baseUrl ?? targetModelProviderSection?.baseUrl ?? "").trim();
+    if (!current.runtime) {
+        if (!resolvedBaseUrl) {
             throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Model provider "${newProfile}" requires base_url.`, {
                 profile: newProfile,
                 modelProvider: newProfile,
                 missingFields: ["base_url"],
             });
         }
-        upsertProfiles = {
-            [newProfile]: (0, config_1.validateManagedProfileCreation)(newProfile, {
-                model: args.model ?? undefined,
-                modelProvider: newProfile,
-            }),
-        };
         upsertModelProviders = {
-            [newProfile]: (0, providers_1.buildDirectModelProviderProjection)(newProfile, args.baseUrl),
+            [newProfile]: (0, providers_1.buildDirectModelProviderProjection)(newProfile, resolvedBaseUrl),
         };
     }
-    else {
-        (0, config_repo_1.requireManagedProfileRuntime)(document, providers, newProfile);
-    }
-    if (targetProfileExists &&
-        !current.runtime &&
-        args.baseUrl !== undefined &&
-        args.baseUrl !== null) {
+    else if (targetModelProviderSection || args.profile !== undefined) {
         upsertModelProviders = {
             ...(upsertModelProviders ?? {}),
-            [newProfile]: (0, providers_1.buildDirectModelProviderProjection)(newProfile, args.baseUrl),
+            [newProfile]: {
+                ...(current.runtime
+                    ? {
+                        baseUrl: current.baseUrl ?? targetModelProviderSection?.baseUrl ?? "",
+                        name: "copilot",
+                        requiresOpenAiAuth: true,
+                        wireApi: "responses",
+                    }
+                    : (0, providers_1.buildDirectModelProviderProjection)(newProfile, resolvedBaseUrl)),
+            },
         };
     }
     const nextRecord = (0, providers_1.cleanProviderRecord)({
         profile: newProfile,
         apiKey: args.apiKey ?? current.apiKey,
+        model: nextModel,
         baseUrl: args.baseUrl === null ? undefined : args.baseUrl ?? current.baseUrl,
         note: args.note === null ? undefined : args.note ?? current.note,
         tags: args.tags ?? current.tags,
+        runtime: current.runtime,
     });
-    if (targetProfileExists && args.model !== undefined) {
-        upsertProfiles = {
-            [newProfile]: {
-                ...(args.model !== undefined && args.model !== null ? { model: args.model } : {}),
-            },
-        };
-        if (args.model !== undefined && targetSection?.model !== args.model && !updatedFields.includes("model")) {
-            updatedFields.push("model");
-        }
-    }
-    // Compute profile link ownership after the edit so lifecycle planning can decide whether sections stay, move, or delete.
-    const remainingLinksByProfile = new Map();
-    for (const [name, provider] of Object.entries(providers.providers)) {
-        if (name === args.providerName) {
-            continue;
-        }
-        const list = remainingLinksByProfile.get(provider.profile) ?? [];
-        list.push(name);
-        remainingLinksByProfile.set(provider.profile, list);
-    }
-    if (newProfile !== oldProfile) {
-        const list = remainingLinksByProfile.get(newProfile) ?? [];
-        list.push(args.providerName);
-        remainingLinksByProfile.set(newProfile, list);
-    }
-    const lifecycle = (0, config_1.planProfileLifecycleOutcome)({
-        providerName: args.providerName,
-        oldProfile,
-        newProfile,
-        activeProfile: document.activeProfile,
-        remainingLinksByProfile,
-        switchToProfile: args.switchToProfile ?? null,
-    });
+    const isActive = document.currentModelProvider === oldProfile;
     return (0, run_mutation_1.runMutation)({
         lockPath: args.lockPath,
         backupsDir: args.backupsDir,
@@ -133,10 +95,12 @@ function editProvider(args) {
         ],
         mutate: () => {
             const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
-                upsertProfiles,
                 upsertModelProviders,
-                deleteProfiles: lifecycle.deletedProfileSections,
-                setActiveProfile: lifecycle.nextActiveProfile,
+                setCurrentModel: isActive ? nextModel ?? document.currentModel : undefined,
+                setCurrentModelProvider: isActive ? newProfile : undefined,
+                deleteLegacyProfile: isActive,
+                deleteLegacyProfilesByName: isActive ? [newProfile] : [],
+                scrubModelProviderEnvKeys: [newProfile],
             });
             const nextProviders = {
                 providers: {
@@ -149,12 +113,13 @@ function editProvider(args) {
             (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 provider: args.providerName,
+                modelProvider: newProfile,
                 updatedFields,
                 createdProfileSections: configPlan.createdProfileSections,
                 createdModelProviderSections: configPlan.createdModelProviderSections,
                 deletedProfileSections: configPlan.deletedProfileSections,
-                keptSharedProfiles: lifecycle.keptSharedProfiles,
-                switchedActiveProfile: lifecycle.switchedActiveProfile,
+                keptSharedProfiles: [],
+                switchedActiveProfile: isActive && newProfile !== oldProfile,
                 adoptedProfiles: [],
                 repairedProfiles: [],
             };

package/dist/app/get-current-profile.js

@@ -2,13 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentProfile = getCurrentProfile;
 const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
- * Returns the currently active top-level Codex profile.
+ * Returns the currently active top-level Codex route.
  */
-function getCurrentProfile(configPath) {
+function getCurrentProfile(configPath, providersPath) {
+    const document = (0, config_repo_1.readStructuredConfig)(configPath);
+    const providers = providersPath ? (0, providers_repo_1.readProvidersFileIfExists)(providersPath) : null;
+    const providerCandidates = document.currentModelProvider && providers
+        ? Object.entries(providers.providers)
+            .filter(([, provider]) => provider.profile === document.currentModelProvider)
+            .map(([name]) => name)
+            .sort()
+        : [];
     return {
         data: {
-            profile: (0, config_repo_1.readCurrentProfile)(configPath),
+            model: document.currentModel,
+            modelProvider: document.currentModelProvider,
+            provider: providerCandidates.length === 1 ? providerCandidates[0] : null,
+            profile: document.currentModelProvider,
         },
     };
 }

package/dist/app/get-status.js

@@ -51,7 +51,8 @@ const runtime_state_repo_1 = require("../storage/runtime-state-repo");
 async function getStatus(codexDir, configPath, providersPath, authPath, options) {
     const configExists = fs.existsSync(configPath);
     const providersExists = fs.existsSync(providersPath);
-    let currentProfile = null;
+    let currentModelProvider = null;
+    let currentModel = null;
     const warnings = [];
     const providers = providersExists ? (0, providers_repo_1.readProvidersFile)(providersPath) : null;
     let configViews = [];
@@ -59,14 +60,15 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
     const authState = (0, auth_repo_1.readAuthFileState)(authPath);
     if (configExists) {
         const document = (0, config_repo_1.readStructuredConfig)(configPath);
-        currentProfile = document.activeProfile;
+        currentModel = document.currentModel;
+        currentModelProvider = document.currentModelProvider;
         configViews = (0, config_1.buildManagedProfileViews)(document, providers);
         consistencyIssues = (0, config_1.collectConfigConsistencyIssues)(document, providers);
-        if (!currentProfile) {
-            warnings.push("config.toml exists but has no top-level profile.");
+        if (!currentModelProvider) {
+            warnings.push("config.toml exists but has no top-level model_provider.");
         }
     }
-    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
+    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
     const activeProviderCandidates = liveState.mappedProviders;
     const activeProvider = liveState.providerResolvable && providers && liveState.mappedProvider
         ? providers.providers[liveState.mappedProvider]
@@ -111,7 +113,7 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
         warnings.push("Current config profile is not mapped in providers.json. Backfill would be required before treating live state as managed.");
     }
     if (liveState.reason === "shared-profile") {
-        warnings.push(`Current config profile "${currentProfile}" is shared by multiple providers in providers.json, so the active provider cannot be resolved uniquely.`);
+        warnings.push(`Current model provider "${currentModelProvider}" is shared by multiple providers in providers.json, so the active provider cannot be resolved uniquely.`);
     }
     if (runtimeStateInspection.exists && !runtimeStateInspection.valid) {
         warnings.push(`Copilot bridge runtime state is unreadable: ${runtimeStateInspection.parseError ?? "unknown parse failure"}`);
@@ -130,8 +132,9 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
             }),
             configExists,
             providersExists,
-            currentProfile,
-            currentProfileMapped: liveState.profileMapped,
+            currentModelProvider,
+            currentModelProviderMapped: liveState.modelProviderMapped,
+            currentModel,
             provider: liveState.mappedProvider,
             activeProviderResolvable: liveState.providerResolvable,
             activeProviderCandidates,

package/dist/app/list-config-profiles.js

@@ -22,7 +22,9 @@ function listConfigProfilesView(args) {
     }));
     return {
         data: {
-            activeProfile: document.activeProfile,
+            currentModel: document.currentModel,
+            currentModelProvider: document.currentModelProvider,
+            legacyProfile: document.legacyProfile,
             profiles,
             count: profiles.length,
         },

package/dist/app/list-providers.js

@@ -45,13 +45,18 @@ const providers_repo_1 = require("../storage/providers-repo");
 function listProviders(providersPath, configPath) {
     const providers = (0, providers_repo_1.readProvidersFile)(providersPath);
     const names = Object.keys(providers.providers).sort();
-    const currentProfile = configPath && fs.existsSync(configPath)
-        ? (0, config_repo_1.readStructuredConfig)(configPath).activeProfile
+    const currentModelProvider = configPath && fs.existsSync(configPath)
+        ? (0, config_repo_1.readStructuredConfig)(configPath).currentModelProvider
         : null;
-    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
+    const currentModel = configPath && fs.existsSync(configPath)
+        ? (0, config_repo_1.readStructuredConfig)(configPath).currentModel
+        : null;
+    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
     const items = names.map((name) => ({
         name,
         profile: providers.providers[name].profile,
+        modelProvider: providers.providers[name].profile,
+        model: providers.providers[name].model ?? null,
         providerType: (0, providers_1.isCopilotBridgeProvider)(providers.providers[name]) ? "copilot" : "direct",
         isActive: liveState.providerResolvable && liveState.mappedProvider === name,
         note: providers.providers[name].note ?? null,
@@ -61,7 +66,8 @@ function listProviders(providersPath, configPath) {
         data: {
             providers: items,
             count: items.length,
-            currentProfile,
+            currentModel,
+            currentModelProvider,
             activeProvider: liveState.mappedProvider,
             activeProviderResolvable: liveState.providerResolvable,
             activeProviderCandidates: liveState.mappedProviders,

package/dist/app/remove-provider.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeProvider = removeProvider;
 const errors_1 = require("../domain/errors");
-const config_1 = require("../domain/config");
 const config_repo_1 = require("../storage/config-repo");
 const providers_repo_1 = require("../storage/providers-repo");
+const providers_1 = require("../domain/providers");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Removes a provider from the managed providers registry.
@@ -17,22 +17,48 @@ function removeProvider(args) {
         throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", `Provider "${args.providerName}" was not found.`);
     }
     const nextProviders = { ...providers.providers };
-    // Delete against a copied object so the original parsed state stays untouched.
     delete nextProviders[args.providerName];
-    const remainingLinksByProfile = new Map();
-    for (const [name, provider] of Object.entries(nextProviders)) {
-        const list = remainingLinksByProfile.get(provider.profile) ?? [];
-        list.push(name);
-        remainingLinksByProfile.set(provider.profile, list);
+    const activeModelProvider = document.currentModelProvider;
+    const linkedProviders = Object.entries(providers.providers)
+        .filter(([, provider]) => provider.profile === activeModelProvider)
+        .map(([name]) => name)
+        .sort();
+    const removingActiveProvider = activeModelProvider === current.profile && linkedProviders.length === 1;
+    const switchTargetName = args.switchToProvider ?? null;
+    const switchTarget = switchTargetName ? nextProviders[switchTargetName] ?? null : null;
+    if (removingActiveProvider && !switchTargetName) {
+        throw (0, errors_1.cliError)("PROFILE_IN_USE", `Provider "${args.providerName}" is the active route and requires --switch-to <provider-name>.`, {
+            provider: args.providerName,
+            activeModelProvider,
+            linkedProviders,
+        });
+    }
+    if (switchTargetName && !switchTarget) {
+        throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", `Provider "${switchTargetName}" was not found.`, {
+            provider: switchTargetName,
+            availableProviders: Object.keys(nextProviders).sort(),
+        });
+    }
+    const switchTargetModel = switchTarget?.model ?? document.currentModel ?? null;
+    if (switchTargetName && !switchTargetModel) {
+        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${switchTargetName}" has no model to switch with.`, {
+            provider: switchTargetName,
+            suggestion: "Run `codexs edit <provider> --model <name>` first.",
+        });
+    }
+    const switchTargetProjection = switchTarget
+        ? (0, providers_1.isCopilotBridgeProvider)(switchTarget)
+            ? (0, providers_1.buildCopilotModelProviderProjection)(switchTarget.runtime)
+            : switchTarget.baseUrl
+                ? (0, providers_1.buildDirectModelProviderProjection)(switchTarget.profile, switchTarget.baseUrl)
+                : null
+        : null;
+    if (switchTargetName && !switchTargetProjection) {
+        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${switchTargetName}" requires base_url before it can become active.`, {
+            provider: switchTargetName,
+            suggestion: "Run `codexs edit <provider> --base-url <url>` first.",
+        });
     }
-    const lifecycle = (0, config_1.planProfileLifecycleOutcome)({
-        providerName: args.providerName,
-        oldProfile: current.profile,
-        newProfile: null,
-        activeProfile: document.activeProfile,
-        remainingLinksByProfile,
-        switchToProfile: args.switchToProfile ?? null,
-    });
     return (0, run_mutation_1.runMutation)({
         lockPath: args.lockPath,
         backupsDir: args.backupsDir,
@@ -44,17 +70,24 @@ function removeProvider(args) {
         ],
         mutate: () => {
             const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
-                deleteProfiles: lifecycle.deletedProfileSections,
-                setActiveProfile: lifecycle.nextActiveProfile,
+                setCurrentModel: switchTarget ? switchTargetModel : undefined,
+                setCurrentModelProvider: switchTarget ? switchTarget.profile : undefined,
+                upsertModelProviders: switchTarget && switchTargetProjection
+                    ? { [switchTarget.profile]: switchTargetProjection }
+                    : undefined,
+                deleteLegacyProfile: Boolean(switchTarget),
+                deleteLegacyProfilesByName: switchTarget ? [switchTarget.profile] : [],
+                scrubModelProviderEnvKeys: switchTarget ? [switchTarget.profile] : [],
             });
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, { providers: nextProviders });
             (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 provider: args.providerName,
+                switchedTo: switchTargetName,
                 createdProfileSections: configPlan.createdProfileSections,
                 deletedProfileSections: configPlan.deletedProfileSections,
-                keptSharedProfiles: lifecycle.keptSharedProfiles,
-                switchedActiveProfile: lifecycle.switchedActiveProfile,
+                keptSharedProfiles: [],
+                switchedActiveProfile: Boolean(switchTarget),
                 adoptedProfiles: [],
                 repairedProfiles: [],
             };

package/dist/app/run-doctor.js

@@ -47,12 +47,13 @@ const copilot_installer_1 = require("../runtime/copilot-installer");
 const copilot_bridge_1 = require("../runtime/copilot-bridge");
 const copilot_adapter_1 = require("../runtime/copilot-adapter");
 const runtime_state_repo_1 = require("../storage/runtime-state-repo");
+const codex_version_1 = require("../runtime/codex-version");
 /**
  * Performs consistency checks across config.toml, providers.json, and the local Codex CLI.
  */
 async function runDoctor(args) {
     const issues = [];
-    let currentProfile = null;
+    let currentModelProvider = null;
     let providers = null;
     let document = null;
     if (!fs.existsSync(args.configPath)) {
@@ -64,11 +65,11 @@ async function runDoctor(args) {
     }
     else {
         document = (0, config_repo_1.readStructuredConfig)(args.configPath);
-        currentProfile = document.activeProfile;
-        if (!currentProfile) {
+        currentModelProvider = document.currentModelProvider;
+        if (!currentModelProvider) {
             issues.push({
-                code: "PROFILE_NOT_FOUND",
-                message: "config.toml has no top-level profile.",
+                code: "MODEL_PROVIDER_MISSING",
+                message: "config.toml has no top-level model_provider.",
                 file: args.configPath,
             });
         }
@@ -118,8 +119,8 @@ async function runDoctor(args) {
             message: `Copilot bridge runtime state is unreadable: ${runtimeStateInspection.parseError ?? "unknown parse failure"}`,
         });
     }
-    if (document?.activeProfile && providers) {
-        const matches = (0, providers_1.findProvidersByProfile)(providers, document.activeProfile);
+    if (document?.currentModelProvider && providers) {
+        const matches = (0, providers_1.findProvidersByProfile)(providers, document.currentModelProvider);
         if (matches.length === 1) {
             const activeProvider = providers.providers[matches[0]];
             if ((0, providers_1.isCopilotBridgeProvider)(activeProvider)) {
@@ -163,11 +164,11 @@ async function runDoctor(args) {
                 ...runtimeState,
             });
         }
-        else if (!document?.activeProfile || runtimeProvider.profile !== document.activeProfile) {
+        else if (!document?.currentModelProvider || runtimeProvider.profile !== document.currentModelProvider) {
             issues.push({
                 code: "BRIDGE_STATE_STALE",
-                message: "Copilot bridge runtime state exists for a provider that is not the current active profile.",
-                activeProfile: document?.activeProfile ?? null,
+                message: "Copilot bridge runtime state exists for a provider that is not the current active model_provider.",
+                activeModelProvider: document?.currentModelProvider ?? null,
                 runtimeProvider: runtimeState.provider,
                 runtimeProfile: runtimeProvider.profile,
                 ...runtimeState,
@@ -175,8 +176,8 @@ async function runDoctor(args) {
         }
     }
     // Drift inspection still runs when files are missing so status output can explain partial state.
-    const drift = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
-    const codexCheck = (0, codex_probe_1.probeCodexRuntime)();
+    const drift = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
+    const codexCheck = (0, codex_probe_1.probeCodexRuntime)(codex_version_1.MIN_SUPPORTED_CODEX_VERSION);
     if (!codexCheck.ok) {
         const message = codexCheck.reason === "missing"
             ? "codex CLI is not available on PATH."
@@ -229,32 +230,28 @@ function mapBridgeDiagnosticCode(cause) {
  */
 function renderConfigIssueMessage(issue) {
     switch (issue.code) {
-        case "ORPHANED_PROFILE_REFERENCE":
-            return `Profile "${issue.profile}" is referenced by providers but missing from config.toml.`;
-        case "UNMANAGED_ACTIVE_PROFILE":
-            return `Active profile "${issue.profile}" is not mapped by providers.json.`;
-        case "SHARED_PROFILE_REFERENCE":
-            return `Profile "${issue.profile}" is shared by multiple providers.`;
-        case "ORPHANED_PROFILE_SECTION":
-            return `Profile section "${issue.profile}" is not linked to any provider.`;
+        case "MODEL_MISSING":
+            return "Top-level model is missing from config.toml.";
         case "MODEL_PROVIDER_MISSING":
-            return `Profile "${issue.profile}" is missing model_provider.`;
-        case "MODEL_PROVIDER_NAME_MISMATCH":
-            return `Profile "${issue.profile}" must use matching model_provider name "${issue.profile}", found "${issue.modelProvider}".`;
+            return "Top-level model_provider is missing from config.toml.";
         case "MODEL_PROVIDER_SECTION_MISSING":
-            return `Model provider section "${issue.modelProvider}" for profile "${issue.profile}" is missing from config.toml.`;
+            return `Model provider section "${issue.modelProvider}" is missing from config.toml.`;
         case "MODEL_PROVIDER_BASE_URL_MISSING":
-            return `Model provider section "${issue.modelProvider}" for profile "${issue.profile}" is missing base_url.`;
+            return `Model provider section "${issue.modelProvider}" is missing base_url.`;
+        case "LEGACY_PROFILE_SELECTOR":
+            return `Legacy top-level profile selector "${issue.profile}" is still present.`;
+        case "LEGACY_PROFILE_SECTION":
+            return `Legacy profile section "${issue.profile}" is still present.`;
+        case "LEGACY_MODEL_PROVIDER_ENV_KEY":
+            return `Model provider "${issue.modelProvider}" still contains legacy env_key wiring.`;
         case "PROVIDER_BASE_URL_MISMATCH":
             return issue.providerType === "direct"
-                ? `Direct provider "${issue.provider}" baseUrl does not match config.toml model provider "${issue.profile}" base_url.`
+                ? `Direct provider "${issue.provider}" baseUrl does not match config.toml model provider "${issue.modelProvider}" base_url.`
                 : String(issue.code ?? "UNKNOWN_ISSUE");
-        case "ACTIVE_PROVIDER_UNRESOLVED":
-            return `Active profile "${issue.profile}" maps to multiple providers, so the active managed provider cannot be resolved uniquely.`;
         case "AUTH_JSON_INVALID":
             return String(issue.message ?? issue.reason ?? "auth.json is invalid.");
         case "DESTRUCTIVE_REMOVE_BLOCKED":
-            return `Provider "${issue.provider}" cannot be removed while "${issue.activeProfile}" remains active.`;
+            return `Provider "${issue.provider}" cannot be removed while "${issue.activeModelProvider}" remains active.`;
         default:
             return String(issue.code ?? "UNKNOWN_ISSUE");
     }

package/dist/app/setup-codex.js

@@ -42,9 +42,9 @@ const codex_cli_1 = require("../runtime/codex-cli");
 const config_repo_1 = require("../storage/config-repo");
 const fs_utils_1 = require("../storage/fs-utils");
 const providers_repo_1 = require("../storage/providers-repo");
+const codex_version_1 = require("../runtime/codex-version");
 const run_doctor_1 = require("./run-doctor");
 const run_mutation_1 = require("./run-mutation");
-const MIN_CODEX_VERSION = "0.0.1";
 /**
  * Migrates unmanaged Codex config profiles into a managed providers.json registry.
  */
@@ -55,10 +55,10 @@ async function migrateCodex(args) {
             cause: available.cause,
         });
     }
-    const version = (0, codex_cli_1.checkCodexVersion)(MIN_CODEX_VERSION);
+    const version = (0, codex_cli_1.checkCodexVersion)(codex_version_1.MIN_SUPPORTED_CODEX_VERSION);
     if (!version.ok) {
         throw (0, errors_1.cliError)("CODEX_VERSION_UNSUPPORTED", "codex CLI version is below the supported minimum.", {
-            minimumVersion: MIN_CODEX_VERSION,
+            minimumVersion: codex_version_1.MIN_SUPPORTED_CODEX_VERSION,
             currentVersion: version.currentVersion ?? null,
             cause: version.cause,
         });

package/dist/app/show-config.js

@@ -27,7 +27,9 @@ function showConfig(args) {
     }
     return {
         data: {
-            activeProfile: document.activeProfile,
+            currentModel: document.currentModel,
+            currentModelProvider: document.currentModelProvider,
+            legacyProfile: document.legacyProfile,
             selectedProfile,
             profiles: profiles.map((profile) => ({
                 ...profile,

package/dist/app/switch-provider.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.switchProvider = switchProvider;
 const errors_1 = require("../domain/errors");
-const providers_1 = require("../domain/providers");
 const config_repo_1 = require("../storage/config-repo");
 const auth_repo_1 = require("../storage/auth-repo");
 const providers_repo_1 = require("../storage/providers-repo");
@@ -10,8 +9,9 @@ const copilot_bridge_1 = require("../runtime/copilot-bridge");
 const copilot_installer_1 = require("../runtime/copilot-installer");
 const copilot_adapter_1 = require("../runtime/copilot-adapter");
 const run_mutation_1 = require("./run-mutation");
+const providers_1 = require("../domain/providers");
 /**
- * Switches the active Codex profile to the target provider.
+ * Switches the active Codex route to the target provider.
  */
 async function switchProvider(args) {
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
@@ -21,8 +21,17 @@ async function switchProvider(args) {
             availableProviders: Object.keys(providers.providers).sort(),
         });
     }
-    const document = (0, config_repo_1.ensureProfileExists)(args.configPath, provider.profile, args.providerName);
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const resolvedModel = provider.model ?? document.currentModel;
+    if (!resolvedModel) {
+        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" has no model to switch with.`, {
+            provider: args.providerName,
+            modelProvider: provider.profile,
+            suggestion: "Run `codexs edit <provider> --model <name>` or `codexs add <provider> --model <name>`.",
+        });
+    }
     if ((0, providers_1.isCopilotBridgeProvider)(provider)) {
+        (0, copilot_installer_1.assertCopilotNodeRuntimeSupported)();
         const installStatus = (0, copilot_installer_1.probeCopilotSdkInstall)(args.runtimesDir);
         if (!installStatus.installed) {
             throw (0, errors_1.cliError)("COPILOT_SDK_MISSING", "The optional Copilot SDK runtime is not installed.", {
@@ -31,7 +40,7 @@ async function switchProvider(args) {
             });
         }
         await (0, copilot_adapter_1.readCopilotAuthState)(args.runtimesDir);
-        const bridge = await (0, copilot_bridge_1.ensureCopilotBridge)(args.providerName, provider, args.runtimeDir);
+        const bridge = await (0, copilot_bridge_1.ensureCopilotBridge)(args.providerName, provider, args.runtimeDir, args.runtimesDir);
         const nextProvider = bridge.portChanged
             ? (0, providers_1.cleanProviderRecord)({
                 ...provider,
@@ -55,10 +64,14 @@ async function switchProvider(args) {
                 ],
                 mutate: () => {
                     const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
-                        setActiveProfile: provider.profile,
+                        setCurrentModel: resolvedModel,
+                        setCurrentModelProvider: provider.profile,
                         upsertModelProviders: {
                             [provider.profile]: (0, providers_1.buildCopilotModelProviderProjection)(nextProvider.runtime),
                         },
+                        deleteLegacyProfile: true,
+                        deleteLegacyProfilesByName: [provider.profile],
+                        scrubModelProviderEnvKeys: [provider.profile],
                     });
                     if (bridge.portChanged) {
                         (0, providers_repo_1.writeProvidersFile)(args.providersPath, {
@@ -72,6 +85,8 @@ async function switchProvider(args) {
                     (0, auth_repo_1.writeOpenAiApiKeyAuth)(args.authPath, provider.apiKey);
                     return {
                         provider: args.providerName,
+                        model: resolvedModel,
+                        modelProvider: nextProvider.profile,
                         profile: nextProvider.profile,
                         portChanged: bridge.portChanged,
                         bridgePort: bridge.port,
@@ -96,13 +111,30 @@ async function switchProvider(args) {
             { absolutePath: args.configPath, relativePath: "config.toml" },
         ],
         mutate: () => {
+            const directBaseUrl = provider.baseUrl?.trim() ?? "";
+            if (!directBaseUrl) {
+                throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" requires base_url before switching.`, {
+                    provider: args.providerName,
+                    modelProvider: provider.profile,
+                    suggestion: "Run `codexs edit <provider> --base-url <url>`.",
+                });
+            }
             const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
-                setActiveProfile: provider.profile,
+                setCurrentModel: resolvedModel,
+                setCurrentModelProvider: provider.profile,
+                upsertModelProviders: {
+                    [provider.profile]: (0, providers_1.buildDirectModelProviderProjection)(provider.profile, directBaseUrl),
+                },
+                deleteLegacyProfile: true,
+                deleteLegacyProfilesByName: [provider.profile],
+                scrubModelProviderEnvKeys: [provider.profile],
             });
             (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             (0, auth_repo_1.writeOpenAiApiKeyAuth)(args.authPath, provider.apiKey);
             return {
                 provider: args.providerName,
+                model: resolvedModel,
+                modelProvider: provider.profile,
                 profile: provider.profile,
             };
         },