@yhong91/cpac 0.1.10 → 0.1.12

package/README.md

@@ -93,18 +93,18 @@ cpac --help
 
 ### 统一管理（detect / install / uninstall / upgrade）
 
-参考 vibetime 的目标式命令，对 `codex`、`claude`、`pi`、`kimi` 四个目标统一管理：
+参考 vibetime 的目标式命令，对 `codex`、`pi`、`kimi` 三个持久注入目标统一管理（claude/opencode 是临时接管，用 `cpac claude` / `cpac opencode` 启动，不属于 install 目标）：
 
 ```bash
 cpac detect [--json] [--home PATH]
-cpac install [--target codex,claude,pi,kimi] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--home PATH]
-cpac uninstall [--target codex,claude,pi,kimi] [--all] [--dry-run] [--home PATH]
+cpac install [--target codex,pi,kimi] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--home PATH]
+cpac uninstall [--target codex,pi,kimi] [--all] [--dry-run] [--home PATH]
 cpac upgrade [--check]
 cpac version
 ```
 
 - `detect` 列出每个目标是否被检测到、是否已接入 CPAC；`--json` 输出机器可读结果。
-- `install` 默认作用于检测到的目标；`--target` 指定目标、`--all` 全部。各目标映射到既有逻辑：`codex` → `cpac inject`，`pi` → `cpac pi install`，`kimi` → `cpac kimi install`；`claude` 无持久化安装（用 `cpac claude` 启动）。`--dry-run` 只打印将要做的事，`--force` 允许重装已安装目标。
+- `install` 默认作用于检测到的目标；`--target` 指定目标、`--all` 全部。各目标映射到既有逻辑：`codex` → `cpac inject`，`pi` → `cpac pi install`，`kimi` → `cpac kimi install`。`--dry-run` 只打印将要做的事，`--force` 允许重装已安装目标。
 - Codex 注入默认开启 multi-agent v2（写入 `[features.multi_agent_v2] enabled = true`）；`install --target codex --v2_off` 写入 `enabled = false`。服务端还需在 CPA 配置中开启 `codex.optimize-multi-agent-v2`。
 - `--v2_models` 进入 arrow-key 复选框选择最多 5 个 spawn_agent 模型（勾选顺序即推荐顺序），选择结果存入配置文件的 `spawn_models`，注入时把这些模型排到 `codex-models.json` 最前——Codex 客户端只把 catalog 前 5 个可见模型广告为 spawn 覆盖项。
 - `uninstall` 默认作用于已安装目标，映射到 `cpac restore` / `cpac pi uninstall` / `cpac kimi uninstall`。
@@ -215,6 +215,14 @@ CPAC state：~/.cpac
 
 为防止误删或覆盖，`state_dir` 不能是文件系统根目录、用户 home、系统临时目录，也不能包含 Codex 配置文件。
 
+### OpenCode（临时接管）
+
+```bash
+cpac opencode [--] [opencode args...]
+```
+
+通过 `OPENCODE_CONFIG_CONTENT` 内联注入一个 `cpac` OpenAI 兼容 provider（baseURL 直指 CPA，模型列表来自 CPA 目录），不触碰任何 opencode 配置文件，退出即无痕。首次使用时 opencode 会自行安装 `@ai-sdk/openai-compatible` 适配器。模型选择用 `cpac/<模型名>`。
+
 ### Pi
 
 安装 CPA provider 扩展到 Pi：

package/dist/cpac.js

@@ -1427,6 +1427,58 @@ async function guide(config) {
     console.log(`\nSaved ${config.api_key_env} to ${profile}. Open a new terminal or run:\n  source ${profile}`);
     return 0;
 }
+// opencode's config schema rejects a limit block with context but no output;
+// the catalog has no output field, so a safe budget stands in, clamped to the
+// context window (same scheme as opencodex's SCHEMA_REQUIRED_OUTPUT_BUDGET).
+const OPENCODE_OUTPUT_BUDGET = 32_000;
+// Ephemeral takeover: inline a CPA provider via OPENCODE_CONFIG_CONTENT so no
+// opencode config file is touched; the session ends with zero residue.
+export async function runOpencode(config, args, executable = "opencode") {
+    const apiKey = process.env[config.api_key_env]?.trim();
+    if (!apiKey)
+        throw new CPACError(`environment variable ${config.api_key_env} is not set`);
+    const catalog = await fetchCatalog(config.cpa_url, apiKey);
+    const document = JSON.parse(new TextDecoder().decode(catalog.bytes));
+    const models = {};
+    for (const row of document.models) {
+        const id = catalogModelId(row);
+        if (!id)
+            continue;
+        const window = typeof row.context_window === "number" && row.context_window > 0
+            ? Math.floor(row.context_window)
+            : 0;
+        models[id] = window > 0
+            ? {
+                limit: {
+                    context: window,
+                    output: Math.min(OPENCODE_OUTPUT_BUDGET, window),
+                },
+            }
+            : {};
+    }
+    const content = JSON.stringify({
+        provider: {
+            cpac: {
+                npm: "@ai-sdk/openai-compatible",
+                options: { baseURL: apiBase(config.cpa_url), apiKey },
+                models,
+            },
+        },
+    });
+    const env = {
+        ...process.env,
+        OPENCODE_CONFIG_CONTENT: content,
+    };
+    return await new Promise((resolve, reject) => {
+        const child = spawn(executable, args, { env, stdio: "inherit" });
+        child.once("error", (error) => {
+            reject(new CPACError(error instanceof Error && "code" in error && error.code === "ENOENT"
+                ? `${executable} not found`
+                : `cannot start ${executable}: ${error.message}`));
+        });
+        child.once("close", (code) => resolve(code ?? 1));
+    });
+}
 export async function runClaudeModels(parsed) {
     if (parsed.pick.length) {
         const config = loadConfig(parsed.configPath, true);
@@ -1783,20 +1835,6 @@ const TARGETS = [
             await restore(config);
         },
     },
-    {
-        id: "claude",
-        home: () => expandUserPath(process.env.CLAUDE_CONFIG_DIR?.trim() || join(homedir(), ".claude")),
-        detected: () => binaryOnPath("claude") || existsSync(join(homedir(), ".claude")),
-        installed: () => false,
-        install: async (_config, dryRun) => {
-            const message = "claude needs no install; launch it through CPA with: cpac claude";
-            console.log(dryRun ? `would do nothing: ${message}` : message);
-        },
-        uninstall: async (_config, dryRun) => {
-            const message = "claude keeps no persistent CPAC state; nothing to remove";
-            console.log(dryRun ? `would do nothing: ${message}` : message);
-        },
-    },
     {
         id: "pi",
         home: () => piExtensionsDir(),
@@ -1945,14 +1983,18 @@ function usage() {
         "       cpac <inject|status|restore> [--config PATH]",
         "       cpac proxy [--config PATH]",
         "       cpac claude [--config PATH] [--] [claude args...]",
+        "       cpac opencode [--config PATH] [--] [opencode args...]",
         "       cpac claude-models [--opus [M]] [--sonnet [M]] [--haiku [M]] [--classifier [M]] [--reset] [--config PATH]",
         "       cpac pi <install|uninstall|status> [--config PATH]",
         "       cpac kimi <install|uninstall|status> [--config PATH]",
         "       cpac detect [--json] [--home PATH]",
-        "       cpac install [--target codex,claude,pi,kimi] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--home PATH]",
-        "       cpac uninstall [--target codex,claude,pi,kimi] [--all] [--dry-run] [--home PATH]",
+        "       cpac install [--target codex,pi,kimi] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--home PATH]",
+        "       cpac uninstall [--target codex,pi,kimi] [--all] [--dry-run] [--home PATH]",
         "       cpac upgrade [--check]",
         "       cpac version",
+        "",
+        "install/uninstall manage persistent injections only; claude and opencode are",
+        "ephemeral — launch them with `cpac claude` / `cpac opencode` instead.",
     ].join("\n");
 }
 function parseArgs(args) {
@@ -2104,6 +2146,20 @@ function parseArgs(args) {
             index += 1;
         return { command: "claude", configPath, args: args.slice(index) };
     }
+    if (args[0] === "opencode") {
+        let configPath = defaultConfigPath();
+        let index = 1;
+        if (args[index] === "--config") {
+            const value = args[++index];
+            if (!value)
+                throw new CPACError("--config requires a path");
+            configPath = resolve(expandUserPath(value));
+            index += 1;
+        }
+        if (args[index] === "--")
+            index += 1;
+        return { command: "opencode", configPath, args: args.slice(index) };
+    }
     if (args.includes("-h") || args.includes("--help")) {
         console.log(usage());
         return null;
@@ -2178,6 +2234,8 @@ export async function main(args = process.argv.slice(2)) {
         }
         if (parsed.command === "claude")
             return await runClaude(config, parsed.args);
+        if (parsed.command === "opencode")
+            return await runOpencode(config, parsed.args);
         if (parsed.command === "claude-models")
             return await runClaudeModels(parsed);
         if (parsed.command === "proxy")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yhong91/cpac",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Connect Codex and Claude Code to a remote CLIProxyAPI gateway",
   "type": "module",
   "bin": {