@minniexcode/codex-switch 0.1.0 → 0.1.1

package/dist/domain/providers.js

@@ -34,6 +34,9 @@ function validateProvidersShape(input) {
         if (typeof provider.apiKey !== "string" || provider.apiKey.trim() === "") {
             throw new Error(`Provider "${name}" is missing a valid apiKey.`);
         }
+        if (provider.model !== undefined && typeof provider.model !== "string") {
+            throw new Error(`Provider "${name}" has an invalid model.`);
+        }
         if (provider.baseUrl !== undefined && typeof provider.baseUrl !== "string") {
             throw new Error(`Provider "${name}" has an invalid baseUrl.`);
         }
@@ -55,6 +58,7 @@ function validateProvidersShape(input) {
         providers[name] = cleanProviderRecord({
             profile: provider.profile,
             apiKey: provider.apiKey,
+            model: provider.model,
             baseUrl: provider.baseUrl,
             note: provider.note,
             tags: provider.tags,
@@ -71,6 +75,9 @@ function cleanProviderRecord(record) {
         profile: record.profile.trim(),
         apiKey: record.apiKey.trim(),
     };
+    if (record.model && record.model.trim() !== "") {
+        next.model = record.model.trim();
+    }
     if (record.baseUrl && record.baseUrl.trim() !== "") {
         next.baseUrl = record.baseUrl.trim();
     }

package/dist/domain/runtime-state.js

@@ -90,26 +90,26 @@ function getStorageRoles(args) {
     };
 }
 /**
- * Compares the live active profile against managed providers to detect drift.
+ * Compares the live active model_provider against managed providers to detect drift.
  */
-function inspectLiveStateDrift(currentProfile, providers) {
-    if (currentProfile === null) {
+function inspectLiveStateDrift(currentModelProvider, providers) {
+    if (currentModelProvider === null) {
         return {
-            currentProfile,
+            currentModelProvider,
             mappedProvider: null,
             mappedProviders: [],
-            profileMapped: false,
+            modelProviderMapped: false,
             providerResolvable: false,
             canBackfillActiveProvider: false,
-            reason: providers ? "profile-missing" : "config-missing",
+            reason: providers ? "model-provider-missing" : "config-missing",
         };
     }
     if (!providers) {
         return {
-            currentProfile,
+            currentModelProvider,
             mappedProvider: null,
             mappedProviders: [],
-            profileMapped: false,
+            modelProviderMapped: false,
             providerResolvable: false,
             canBackfillActiveProvider: false,
             reason: "providers-missing",
@@ -117,16 +117,16 @@ function inspectLiveStateDrift(currentProfile, providers) {
     }
     const mappedProviders = [];
     for (const [name, provider] of Object.entries(providers.providers)) {
-        if (provider.profile === currentProfile) {
+        if (provider.profile === currentModelProvider) {
             mappedProviders.push(name);
         }
     }
     if (mappedProviders.length === 1) {
         return {
-            currentProfile,
+            currentModelProvider,
             mappedProvider: mappedProviders[0],
             mappedProviders,
-            profileMapped: true,
+            modelProviderMapped: true,
             providerResolvable: true,
             canBackfillActiveProvider: false,
             reason: "ok",
@@ -134,20 +134,20 @@ function inspectLiveStateDrift(currentProfile, providers) {
     }
     if (mappedProviders.length > 1) {
         return {
-            currentProfile,
+            currentModelProvider,
             mappedProvider: null,
             mappedProviders,
-            profileMapped: true,
+            modelProviderMapped: true,
             providerResolvable: false,
             canBackfillActiveProvider: false,
             reason: "shared-profile",
         };
     }
     return {
-        currentProfile,
+        currentModelProvider,
         mappedProvider: null,
         mappedProviders: [],
-        profileMapped: false,
+        modelProviderMapped: false,
         providerResolvable: false,
         canBackfillActiveProvider: true,
         reason: "provider-unmapped",

package/dist/domain/setup.js

@@ -16,8 +16,9 @@ function buildSetupDrafts(profiles, detailsByProfile, runtimeByProfile) {
         return {
             providerName,
             record: (0, providers_1.cleanProviderRecord)({
-                profile,
+                profile: runtime?.modelProvider ?? profile,
                 apiKey: detail.apiKey ?? "",
+                model: runtime?.model,
                 baseUrl: detail.baseUrl ?? runtime?.baseUrl,
                 note: detail.note,
                 tags: detail.tags,
@@ -71,6 +72,7 @@ function collectMigrateAdoptability(document, providers) {
             adoptableProfileDetails.push({
                 name: view.name,
                 model: view.model,
+                modelProvider: view.modelProvider,
                 baseUrl: view.baseUrl,
             });
             continue;

package/dist/interaction/interactive.js

@@ -70,8 +70,8 @@ function canPrompt(runtime, jsonMode) {
  */
 async function promptForProviderSelection(runtime, providersPath, configPath, message) {
     const providers = (0, providers_repo_1.readProvidersFile)(providersPath);
-    const currentProfile = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath).activeProfile : null;
-    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
+    const currentModelProvider = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath).currentModelProvider : null;
+    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
     const choices = Object.entries(providers.providers)
         .sort(([left], [right]) => left.localeCompare(right))
         .map(([providerName, provider]) => {

package/dist/runtime/codex-version.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_SUPPORTED_CODEX_VERSION = void 0;
+/**
+ * Minimum Codex CLI version supported by the managed runtime workflow.
+ */
+exports.MIN_SUPPORTED_CODEX_VERSION = "0.134.0";

package/dist/storage/config-repo.js

@@ -73,12 +73,12 @@ function readStructuredConfig(configPath) {
     }
 }
 /**
- * Reads the active top-level profile from config.toml.
+ * Reads the active top-level model_provider route from config.toml.
  */
 function readCurrentProfile(configPath) {
-    const profile = readStructuredConfig(configPath).activeProfile ?? (0, config_1.parseTopLevelProfile)(readConfigFile(configPath));
+    const profile = readStructuredConfig(configPath).currentModelProvider;
     if (!profile) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", "No top-level profile is set in config.toml.", {
+        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", "No top-level model_provider is set in config.toml.", {
             file: configPath,
         });
     }
@@ -91,18 +91,10 @@ function listConfigProfiles(configPath) {
     return new Set(readStructuredConfig(configPath).profiles.map((profile) => profile.name));
 }
 /**
- * Verifies that a provider's target profile exists before a switch operation proceeds.
+ * Loads config.toml for commands that project one model_provider route.
  */
 function ensureProfileExists(configPath, profile, provider) {
-    const document = readStructuredConfig(configPath);
-    if (!document.profiles.some((entry) => entry.name === profile)) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${profile}" does not exist in config.toml.`, {
-            file: configPath,
-            provider,
-            profile,
-        });
-    }
-    return document;
+    return readStructuredConfig(configPath);
 }
 /**
  * Resolves one profile view and enforces the managed model_provider contract.
@@ -166,7 +158,7 @@ function requireModelProviderRuntimeSection(document, profile) {
  */
 function updateTopLevelProfile(configPath, configContent, profile) {
     (0, fs_utils_1.writeTextFileAtomic)(configPath, (0, config_1.applyPatchOperations)(configContent, (0, config_1.planConfigMutation)((0, config_1.parseStructuredConfig)(configContent), {
-        setActiveProfile: profile,
+        setLegacyProfile: profile,
     }).operations));
 }
 /**

package/docs/Design/codex-switch-v0.1.1-design.md

@@ -0,0 +1,33 @@
+# codex-switch v0.1.1 Design
+
+## Scope
+
+- Support Codex `0.134.0+` only.
+- Treat top-level `model` and `model_provider` as the runtime routing source of truth.
+- Treat legacy top-level `profile` and legacy `[profiles.*]` sections as adopt-only and diagnostic inputs.
+- Project provider auth through `auth.json` with `OPENAI_API_KEY`.
+- Do not write `env_key` or `env_key_instructions` into managed `[model_providers.<id>]` sections.
+
+## Command Contract
+
+- `--profile <name>` remains a CLI alias for the stored `model_provider` id.
+- `--model <name>` stores the provider default switch model in `providers.json`.
+- `switch` writes top-level `model` and `model_provider`, repairs `[model_providers.<id>]`, rewrites `auth.json`, and removes the targeted legacy route selector/profile section.
+- `add` and `edit` repair `[model_providers.<id>]` and scrub `env_key` / `env_key_instructions`.
+- `remove --switch-to <provider-name>` switches by managed provider name, not by profile id.
+
+## Persistence
+
+- `providers.json` keeps `profile` as the persisted `model_provider` id alias.
+- `providers.json` adds `model` for default route projection.
+- Managed `[model_providers.<id>]` sections write:
+  - `base_url`
+  - `name`
+  - `requires_openai_auth = true`
+  - `wire_api = "responses"`
+
+## Legacy Handling
+
+- `config show` and `config list-profiles` expose legacy profile inspection views.
+- `migrate` remains a legacy adoption helper and does not modify the active top-level route.
+- `doctor` flags missing top-level route fields, legacy selectors/sections, and legacy `env_key` wiring in the active model provider section.

package/docs/Reference/codex-config-reference.md

@@ -137,6 +137,12 @@ model_reasoning_effort = "high"
 approval_policy = "never"
 ```
 
+Important `codex-switch` note:
+
+- official Codex still supports profiles
+- `codex-switch` `0.1.1` does not treat top-level `profile` as the recommended managed runtime selector
+- in `codex-switch`, legacy `profile` and `[profiles.*]` are mainly inspect-and-adopt inputs for `migrate`, `doctor`, and `config` inspection flows
+
 ## 4. `config.toml` by topic
 
 ### 4.1 Model, reasoning, and response style
@@ -194,6 +200,8 @@ Core keys:
 - `model_providers.<id>.env_http_headers`
 - `model_providers.<id>.query_params`
 - `model_providers.<id>.request_max_retries`
+- `model_providers.<id>.wire_api`
+- `model_providers.<id>.requires_openai_auth`
 
 Authentication options for custom providers include:
 
@@ -214,6 +222,22 @@ Related Bedrock keys:
 - `model_providers.amazon-bedrock.aws.profile`
 - `model_providers.amazon-bedrock.aws.region`
 
+#### `codex-switch` 0.1.1 managed projection
+
+When `codex-switch` manages a direct OpenAI-compatible route for Codex `0.134.0+`, it intentionally projects a narrower runtime shape than the full official provider schema:
+
+- top-level `model` is the active model selector
+- top-level `model_provider` is the active route selector
+- projected `[model_providers.<id>]` keeps `base_url`
+- projected `[model_providers.<id>]` fixes `wire_api = "responses"`
+- projected `[model_providers.<id>]` fixes `requires_openai_auth = true`
+- projected runtime config does not keep `env_key`
+- projected runtime config does not keep `env_key_instructions`
+
+Authentication is projected through `auth.json` with `OPENAI_API_KEY`, not through `env_key` in the managed runtime config.
+
+That is a `codex-switch` product decision, not a limitation of Codex itself. If you hand-write or independently manage Codex config, `env_key` remains a valid official mechanism.
+
 ### 4.3.1 `openai_base_url` vs custom providers
 
 If you only want to point the built-in OpenAI provider to a proxy, router, or residency-specific endpoint, use:
@@ -539,6 +563,23 @@ env_key = "OPENAI_API_KEY"
 http_headers = { "X-Team" = "platform" }
 ```
 
+This is an official Codex-style custom provider example.
+
+If you are using `codex-switch` managed direct-provider projection instead, the runtime projection is intentionally narrower:
+
+```toml
+model = "gpt-5.4"
+model_provider = "proxy"
+
+[model_providers.proxy]
+name = "proxy"
+base_url = "https://proxy.example.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+```
+
+In that managed projection, `OPENAI_API_KEY` is expected in `auth.json` rather than through `env_key` in `config.toml`.
+
 ### 6.4 Locked-down shell environment
 
 ```toml

package/docs/Reference/codex-config-reference.zh-CN.md

@@ -149,6 +149,12 @@ model_reasoning_effort = "high"
 approval_policy = "never"
 ```
 
+对 `codex-switch` 0.1.1 的补充说明：
+
+- 官方 Codex 仍然支持 profiles
+- `codex-switch` 不再把顶层 `profile` 视为推荐的受管 runtime selector
+- 在 `codex-switch` 里，legacy `profile` 和 `[profiles.*]` 主要用于 `migrate`、`doctor` 和 `config` 检视的 adopt / inspect 场景
+
 ## 4. `config.toml` 主题整理
 
 ### 4.1 模型、推理强度与输出风格
@@ -206,6 +212,8 @@ Codex 把“当前使用哪个 provider”和“provider 怎么定义”拆开
 - `model_providers.<id>.env_http_headers`
 - `model_providers.<id>.query_params`
 - `model_providers.<id>.request_max_retries`
+- `model_providers.<id>.wire_api`
+- `model_providers.<id>.requires_openai_auth`
 
 自定义 provider 的认证方式包括：
 
@@ -229,6 +237,22 @@ Bedrock 相关 key：
 - `model_providers.amazon-bedrock.aws.profile`
 - `model_providers.amazon-bedrock.aws.region`
 
+#### `codex-switch` 0.1.1 的受管投影
+
+当 `codex-switch` 为 Codex `0.134.0+` 管理一个 direct OpenAI-compatible route 时，它会有意把运行态投影限制在一组更窄的字段上：
+
+- 顶层 `model` 是活动模型选择器
+- 顶层 `model_provider` 是活动路由选择器
+- 投影后的 `[model_providers.<id>]` 保留 `base_url`
+- 投影后的 `[model_providers.<id>]` 固定写 `wire_api = "responses"`
+- 投影后的 `[model_providers.<id>]` 固定写 `requires_openai_auth = true`
+- 受管运行态投影不会保留 `env_key`
+- 受管运行态投影不会保留 `env_key_instructions`
+
+认证信息会通过 `auth.json` 里的 `OPENAI_API_KEY` 投影，而不是通过运行态 `config.toml` 中的 `env_key`。
+
+这属于 `codex-switch` 的产品约束，不是 Codex 官方能力限制。如果你是手工维护或独立维护 Codex config，`env_key` 仍然是官方支持的方式。
+
 ### 4.3.1 `openai_base_url` 和自定义 provider 的区别
 
 如果你只是想把内置 `openai` provider 指向公司网关、路由层或者某个数据驻留 endpoint，官方建议直接用：
@@ -568,6 +592,23 @@ env_key = "OPENAI_API_KEY"
 http_headers = { "X-Team" = "platform" }
 ```
 
+这段是官方 Codex 风格的自定义 provider 示例。
+
+如果你走的是 `codex-switch` 的受管 direct-provider 投影，运行态会被有意收窄为：
+
+```toml
+model = "gpt-5.4"
+model_provider = "proxy"
+
+[model_providers.proxy]
+name = "proxy"
+base_url = "https://proxy.example.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+```
+
+在这种受管投影下，`OPENAI_API_KEY` 预期写在 `auth.json`，而不是通过 `config.toml` 里的 `env_key` 暴露。
+
 ### 6.4 最小暴露的 shell 环境策略
 
 ```toml