@minniexcode/codex-switch 0.1.2 → 0.1.3

package/README.md

@@ -8,9 +8,9 @@ Chinese version: [README.CN.md](./README.CN.md)
 
 ## Version
 
-Current package version: `0.1.2`
+Current package version: `0.1.3`
 
-This is the current stable documentation line. `0.1.2` is the Copilot runtime repair release, including the managed SDK pin and the Copilot-only `stream_idle_timeout_ms = 300000` projection used to prevent long prompt idle timeouts.
+This is the current stable documentation line. `0.1.3` is the Copilot login hotfix release, repairing the managed SDK client construction against the current official Copilot SDK runtime while keeping the `stream_idle_timeout_ms = 300000` Copilot projection unchanged.
 
 ## Install
 
@@ -217,7 +217,9 @@ npm pack --dry-run
 - [PRD 0.1.0](./docs/PRD/codex-switch-prd-v0.1.0.md)
 - [PRD 0.1.1](./docs/PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./docs/PRD/codex-switch-prd-v0.1.2.md)
+- [PRD 0.1.3](./docs/PRD/codex-switch-prd-v0.1.3.md)
 - [Design 0.1.2](./docs/Design/codex-switch-v0.1.2-design.md)
+- [Design 0.1.3](./docs/Design/codex-switch-v0.1.3-design.md)
 
 ## License
 

package/dist/runtime/copilot-adapter.js

@@ -265,14 +265,23 @@ function createCopilotClient(sdk, runtimesDir) {
     if (!ClientCtor) {
         throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK does not expose CopilotClient.", {});
     }
-    const invocation = (0, copilot_cli_1.resolveCopilotCliInvocation)([], runtimesDir);
-    const clientOptions = {
-        copilotCommand: invocation.command,
-        command: invocation.command,
-        executable: invocation.command,
-    };
+    const runtimeConnection = resolveRuntimeConnectionFactory(sdk);
+    if (!runtimeConnection?.forStdio) {
+        throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK does not expose RuntimeConnection.forStdio().", {});
+    }
+    const runtimeInvocation = (0, copilot_cli_1.resolveCopilotSdkRuntimeInvocation)(runtimesDir);
+    if (!runtimeInvocation) {
+        throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot runtime is missing the @github/copilot npm loader required by the SDK.", {
+            expectedRuntimeFile: "node_modules/@github/copilot/npm-loader.js",
+        });
+    }
     try {
-        return new ClientCtor(clientOptions);
+        return new ClientCtor({
+            connection: runtimeConnection.forStdio({
+                path: runtimeInvocation.path,
+                args: runtimeInvocation.args,
+            }),
+        });
     }
     catch (error) {
         throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK CopilotClient could not be constructed.", {
@@ -434,6 +443,17 @@ function resolveConstructor(target, name) {
     }
     return null;
 }
+function resolveRuntimeConnectionFactory(target) {
+    const direct = target.RuntimeConnection;
+    if (direct && typeof direct === "object") {
+        return direct;
+    }
+    const nestedDefault = target.default;
+    if (nestedDefault) {
+        return resolveRuntimeConnectionFactory(nestedDefault);
+    }
+    return null;
+}
 function resolveApproveAll(target) {
     const direct = target.approveAll;
     if (typeof direct === "function") {

package/dist/runtime/copilot-cli.js

@@ -37,6 +37,7 @@ exports.setCopilotCliSpawnImplementation = setCopilotCliSpawnImplementation;
 exports.resetCopilotCliSpawnImplementation = resetCopilotCliSpawnImplementation;
 exports.checkCopilotCliAvailable = checkCopilotCliAvailable;
 exports.resolveCopilotCliInvocation = resolveCopilotCliInvocation;
+exports.resolveCopilotSdkRuntimeInvocation = resolveCopilotSdkRuntimeInvocation;
 exports.runCopilotLogin = runCopilotLogin;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -85,6 +86,20 @@ function checkCopilotCliAvailable(runtimesDir) {
 function resolveCopilotCliInvocation(args = [], runtimesDir) {
     return getCopilotInvocation(args, runtimesDir);
 }
+/**
+ * Resolves the explicit runtime entrypoint required by the Copilot SDK.
+ */
+function resolveCopilotSdkRuntimeInvocation(runtimesDir) {
+    const installDir = (0, copilot_installer_1.getCopilotRuntimeInstallDir)(runtimesDir);
+    const loaderPath = path.join(installDir, "node_modules", "@github", "copilot", "npm-loader.js");
+    if (!fs.existsSync(loaderPath)) {
+        return null;
+    }
+    return {
+        path: loaderPath,
+        args: [],
+    };
+}
 /**
  * Launches the official `copilot login` flow in the current terminal.
  */

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

@@ -0,0 +1,10 @@
+# codex-switch v0.1.3 Design
+
+`0.1.3` is a targeted Copilot login compatibility repair release.
+
+## Design Notes
+
+- The SDK adapter constructs `CopilotClient` through `RuntimeConnection.forStdio({ path })`.
+- The runtime path passed to the SDK resolves to the managed `@github/copilot/npm-loader.js` entrypoint.
+- Human terminal commands such as `copilot --help` and `copilot login` continue to use the bundled `.bin` shim so interactive onboarding behavior remains unchanged.
+- The release adds regression coverage for the constructor compatibility path and runtime loader resolution.

package/docs/PRD/codex-switch-prd-v0.1.3.md

@@ -0,0 +1,22 @@
+# codex-switch v0.1.3 PRD
+
+## Version
+
+- Version line: `0.1.3`
+- Current repository package version: `0.1.3`
+
+## Summary
+
+`0.1.3` is a narrow hotfix release for the broken `login copilot` path. The goal is to restore compatibility with the currently supported official Copilot SDK/runtime pairing without expanding the command surface or the experimental Copilot bridge scope.
+
+## Required Outcome
+
+- `codexs login copilot` must no longer fail during `CopilotClient` construction when the managed SDK/runtime is installed.
+- The SDK integration must explicitly point at the managed Copilot runtime loader instead of relying on implicit package discovery.
+- Existing direct-provider behavior and Copilot bridge behavior remain unchanged outside the constructor compatibility fix.
+
+## Non-Goals
+
+- No new Copilot features or new upstream families.
+- No migration shims or backward-compatibility preservation for older local experimental runtime state.
+- No changes to the managed SDK pin or Node version requirements.

package/docs/cli-usage.md

@@ -1,6 +1,6 @@
 # codex-switch CLI Usage
 
-This document describes the current `0.1.2` CLI contract for `@minniexcode/codex-switch`, including the Copilot runtime repair boundary.
+This document describes the current `0.1.3` CLI contract for `@minniexcode/codex-switch`, including the Copilot login hotfix boundary.
 
 Executable command name:
 
@@ -10,7 +10,7 @@ codexs
 
 ## 1. Version Context
 
-The current package version in this repository is `0.1.2`.
+The current package version in this repository is `0.1.3`.
 
 This release line targets Codex `0.134.0+`. The public contract assumes runtime routing is selected by top-level `model` plus `model_provider`, while legacy `profile` and `[profiles.*]` remain inspect-and-adopt inputs instead of the recommended runtime path.
 
@@ -287,4 +287,6 @@ codexs rollback [backup-id]
 - [PRD 0.1.0](./PRD/codex-switch-prd-v0.1.0.md)
 - [PRD 0.1.1](./PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./PRD/codex-switch-prd-v0.1.2.md)
+- [PRD 0.1.3](./PRD/codex-switch-prd-v0.1.3.md)
 - [Design 0.1.2](./Design/codex-switch-v0.1.2-design.md)
+- [Design 0.1.3](./Design/codex-switch-v0.1.3-design.md)

package/docs/codex-switch-product-overview.md

@@ -88,4 +88,4 @@ codexs migrate
 - `status` / `doctor` 如何帮助定位下一步
 - 当前运行态是用顶层 `model` 与 `model_provider` 选择活动路由
 
-`0.1.2` 是规划中的 Copilot runtime 修复线，不是当前已发布包版本。当前实现边界是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，运行时会额外拒绝过旧版本和 prerelease 版本，并在真正创建 client 或 session 时验证 SDK API shape；本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge。Direct provider 路径继续支持 Node.js `>=18`。
+`0.1.3` 是当前已发布的 Copilot login hotfix 线。当前实现边界是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，运行时会额外拒绝过旧版本和 prerelease 版本，并通过显式 `RuntimeConnection.forStdio({ path })` 把官方 SDK 连接到受管安装中的 Copilot runtime loader；本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge。Direct provider 路径继续支持 Node.js `>=18`。

package/docs/codex-switch-technical-architecture.md

@@ -5,10 +5,12 @@
 - [`cli-usage.md`](./cli-usage.md)
 - [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
 - [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
-- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md) (planned)
+- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
+- [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
 - [`Design/codex-switch-v0.1.0-design.md`](./Design/codex-switch-v0.1.0-design.md)
 - [`Design/codex-switch-v0.1.1-design.md`](./Design/codex-switch-v0.1.1-design.md)
-- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md) (planned)
+- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
+- [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
 
 ## Layers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minniexcode/codex-switch",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Local-first CLI for managing and switching Codex provider/model-provider routing.",
   "license": "MIT",
   "type": "commonjs",