@minniexcode/codex-switch 0.0.12 → 0.1.1

package/dist/domain/providers.js

@@ -10,6 +10,7 @@ exports.isRuntimeBackedProvider = isRuntimeBackedProvider;
 exports.isCopilotBridgeProvider = isCopilotBridgeProvider;
 exports.buildCopilotBridgeBaseUrl = buildCopilotBridgeBaseUrl;
 exports.buildCopilotModelProviderProjection = buildCopilotModelProviderProjection;
+exports.buildDirectModelProviderProjection = buildDirectModelProviderProjection;
 /**
  * Validates and normalizes unknown JSON into the providers.json domain model.
  */
@@ -33,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.`);
         }
@@ -54,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,
@@ -70,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();
     }
@@ -162,6 +170,21 @@ function buildCopilotModelProviderProjection(runtime) {
         wireApi: "responses",
     };
 }
+/**
+ * Builds the Codex-facing custom model_provider projection for a direct provider.
+ */
+function buildDirectModelProviderProjection(profile, baseUrl) {
+    const normalizedBaseUrl = baseUrl.trim();
+    if (!normalizedBaseUrl) {
+        throw new Error(`Direct model provider "${profile}" requires a non-empty base_url.`);
+    }
+    return {
+        baseUrl: normalizedBaseUrl,
+        name: profile.trim(),
+        requiresOpenAiAuth: true,
+        wireApi: "responses",
+    };
+}
 /**
  * Validates one runtime-backed provider block.
  */

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.0-design.md

@@ -0,0 +1,152 @@
+# codex-switch `0.1.0` Design
+
+## 文档信息
+
+- 文档类型：实现约束设计文档
+- 适用版本：`0.1.0`
+- 当前定位：release-hardening only
+- 关联 PRD：[`../PRD/codex-switch-prd-v0.1.0.md`](../PRD/codex-switch-prd-v0.1.0.md)
+- 关联 beta 设计：[`./codex-switch-v0.0.12-design.md`](./codex-switch-v0.0.12-design.md)
+
+## 1. 设计原则
+
+`0.1.0` 的实现只做 release-hardening，不新增命令面，不改 JSON envelope，不引入兼容层，也不把历史草案继续扩成平台设想。
+
+这个版本的实现目标是收口，不是扩张：
+
+- 把用户看见的主路径讲清楚。
+- 把 `list`、`status`、`doctor` 的可读语义讲清楚。
+- 把 `migrate` 和 `setup` 的产品定位讲清楚。
+- 把文档、help、输出、测试和包内容收口成同一套事实。
+
+## 2. 当前阻塞项
+
+实现收口前必须先正视以下阻塞项：
+
+1. `tests/` 仍被忽略，导致回归测试无法稳定版本化。
+2. README 仍引用不存在的 `docs/Tests/testing.md`，说明文档入口还未收口。
+3. 版本叙事仍以 `0.0.12` 为中心，`0.1.0` 还没有被写成稳定发布线。
+4. 主工作流、`migrate` 定位、`setup` 定位和真实实现状态还没有完全对齐。
+
+只要这些阻塞项还存在，就不应把当前实现视为 `0.1.0` ready。
+
+## 3. 收口矩阵
+
+以下子系统必须完成对应收口。
+
+| 子系统 | 必须稳定的内容 | 约束 |
+| --- | --- | --- |
+| 文档 | PRD、design、README、CLI usage、product overview、changelog、testing guide | 所有面向用户的文档必须与 `0.1.0` 事实一致 |
+| 帮助 | 顶层 help、命令 help、示例顺序 | direct/Copilot 主路径优先，`migrate` 降级，`setup` 仅保留 deprecated 语义 |
+| 输出 | `init`、`list`、`status`、`doctor`、`login` 的 human-readable 文案 | 只收口语义，不改 JSON envelope |
+| 读路径 | tool home / runtime separation、dual-path model、ambiguous active profile 处理 | 不新增兼容层，不伪造 current 状态 |
+| 测试 | release gate、回归测试、fixture 检查 | 回归测试必须落仓库，不能继续停留在忽略状态 |
+
+## 4. 必须稳定的用户可见语义
+
+### 4.1 `list`
+
+`list` 必须能让用户直接看出：
+
+- provider 属于 `direct` 还是 `copilot`
+- 哪个 provider 是 current
+- 当前 active profile 是否可唯一解析
+
+如果当前 active profile 对应多个 provider，就必须显式表现为 ambiguous，而不是把任何一个 provider 假装成 current。
+
+`list --json` 仍然使用既有 envelope，只允许追加字段，不允许改顶层契约。
+
+### 4.2 `status`
+
+`status` 必须把以下内容讲清楚：
+
+- tool home 是什么
+- target runtime 是什么
+- 当前 active provider 是什么
+- 当前路径是 direct 还是 Copilot
+- 下一步应该做什么
+
+`status` 是摘要，不是字段堆叠。输出顺序必须围绕“当前状态 -> 影响 -> 下一步”组织。
+
+### 4.3 `doctor`
+
+`doctor` 必须先给整体健康结论，再列 issue，再给修复建议。
+
+每条 issue 至少要表达：
+
+- 问题是什么
+- 为什么重要
+- 下一步怎么修
+
+`doctor` 的目标不是罗列内部数据结构，而是把用户推到下一步修复动作。
+
+### 4.4 provider picker
+
+list 和 provider picker 必须一致处理 ambiguous active profile。
+
+选择器提示至少要包含：
+
+- `profile`
+- `providerType`
+- `current` 标记，仅在唯一解析时出现
+
+### 4.5 命令定位
+
+`0.1.0` 还必须稳定以下产品定位：
+
+- 稳定命令面以 `init`、`login`、`list`、`show`、`current`、`status`、`doctor`、`config`、`add`、`edit`、`switch`、`remove`、`import`、`export`、`bridge`、`backups`、`rollback` 为准。
+- `migrate` 只能被表述为高级 adopt helper。
+- `setup` 只能被表述为 deprecated entry。
+- `--json` 顶层 envelope 继续固定为 `ok / command / data / warnings / error`。
+
+## 5. 文档同步要求
+
+以下面向用户的文档必须与 `0.1.0` 事实一致：
+
+- `README.md`
+- `README.CN.md`
+- `README.AI.md`
+- `docs/cli-usage.md`
+- `docs/codex-switch-product-overview.md`
+- `docs/PRD/codex-switch-prd-v0.1.0.md`
+- `docs/Design/codex-switch-v0.1.0-design.md`
+- `CHANGELOG.md`
+- `docs/Tests/testing.md`
+
+历史大文档不需要在本版全文重写，但必须明确它们只是历史参考，不是当前 release contract。
+
+## 6. 最小测试计划
+
+`0.1.0` 的最小测试计划必须包含以下内容：
+
+1. `npm run build`
+2. `npm test`
+3. `npx tsc --noEmit`
+4. `npm pack --dry-run`
+5. built CLI `--help`
+6. built CLI `--version`
+7. fresh direct provider flow
+8. fresh Copilot provider flow
+9. `list/status/doctor` 输出语义检查
+10. `migrate` 高级 adopt helper 检查
+11. `setup` deprecated entry 检查
+
+测试结论必须落在仓库中的正式测试内容里，不能继续依赖忽略目录或口头约定。
+
+## 7. 明确不做
+
+本版不做以下事情：
+
+- 新 upstream
+- GUI / TUI
+- daemon
+- plugin system
+- auto migration
+- 兼容层
+- dual-read / dual-write
+- 重新设计公开 JSON envelope
+- 重新扩张命令面
+
+## 8. 结论
+
+`0.1.0` 设计的核心不是“再造一个版本叙事”，而是把已存在的实现收口成稳定合同。实现只要偏离这条线，就不应被视为 `0.1.0` 的合理内容。

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.