@yhong91/cpac 0.1.37 → 0.1.39

package/README.md

@@ -10,7 +10,7 @@ CPAC 将 Codex 和 Claude Code 接入远端 CLIProxyAPI（CPA）：
 ## 要求
 
 - [Node.js](https://nodejs.org/) 20 或更新版本（npm 随 Node 安装）
-- 已安装需要使用的 agent：`codex`、`claude`、`pi`、`kimi` 或 `grok`
+- 已安装需要使用的 agent：`codex`、`claude`、`pi`、`kimi`、`grok` 或 `zed`
 - 有权访问的 CPA API key
 
 ## 安装
@@ -37,7 +37,7 @@ echo 'export CPA_API_KEY="<你的key>"' >> ~/.zshrc && source ~/.zshrc
 cpac status
 
 # 4a. 持久注入（长期生效，写入 agent 配置，可完整恢复）
-cpac install --all                     # 注入所有检测到的目标（codex/pi/kimi）
+cpac install --all                     # 注入所有检测到的目标（codex/pi/kimi/grok/zed）
 cpac install codex                     # 只注入 Codex（默认开启 multi-agent v2）
 cpac install codex --v2_models         # 先多选 spawn_agent 模型再注入
 cpac install codex --max_context       # 注入时把模型上下文提升到实测上限（opt-in，仅限 codex）
@@ -61,7 +61,7 @@ cpac upgrade
 
 本节面向 AI agent：按顺序执行即可完成安装与配置，**全程无交互**。注意：`cpac codex --config` 和 `cpac claude --config` 的交互向导是 TTY-only，agent 必须走下方直接写配置 JSON 的路径。
 
-1. **检查前置**：`node --version` ≥ 20；确认用户需要哪些 agent（`codex`/`claude`/`pi`/`kimi`/`grok` 在 PATH 上）。向用户索取 CPA API key。
+1. **检查前置**：`node --version` ≥ 20；确认用户需要哪些 agent（`codex`/`claude`/`pi`/`kimi`/`grok`/`zed` 在 PATH 上）。向用户索取 CPA API key。
 
 2. **安装与密钥**：
 
@@ -90,14 +90,14 @@ cpac status   # 验证：各 target 显示 ready/injected
 ```
 
 1. **统一启动与配置**：
-   - 启动：`cpac <codex|claude|kimi|grok|pi> [args...]`（所有原生参数如 `-c` 等原样透明传递）
+   - 启动：`cpac <codex|claude|kimi|grok|pi|zed> [args...]`（所有原生参数如 `-c` 等原样透明传递）
      - `setup` / `--setup`：配置 Codex/Claude，然后启动
      - `clear`：还原原生配置
    - 只写配置、不启动：`cpac setup [claude|codex]`；查看当前：`cpac setup`
 
-2. **已安装后升级**：npm 发布新版本后，等 publish 成功再执行 `cpac upgrade`。它会按需 `npm install -g`，再对已接入的 Codex / Pi / Kimi / Grok 做 `sync`。不要拆成 `npm install -g @yhong91/cpac` 再手动 `cpac sync`。只刷新配置、不升 CLI 时才用 `cpac sync`。
+2. **已安装后升级**：npm 发布新版本后，等 publish 成功再执行 `cpac upgrade`。它会按需 `npm install -g`，再对已接入的 Codex / Pi / Kimi / Grok / Zed 做 `sync`。不要拆成 `npm install -g @yhong91/cpac` 再手动 `cpac sync`。只刷新配置、不升 CLI 时才用 `cpac sync`。
 
-失败处理：任何一步报错时先跑 `cpac status`；密钥未配置回到步骤 2；注入后异常用 `cpac <agent> clear` 或 `cpac restore <codex|pi|kimi|grok>` 恢复原配置。
+失败处理：任何一步报错时先跑 `cpac status`；密钥未配置回到步骤 2；注入后异常用 `cpac <agent> clear` 或 `cpac restore <codex|pi|kimi|grok|zed>` 恢复原配置。
 
 ## 首次引导
 
@@ -113,7 +113,7 @@ Commands:
   cpac <agent> [args...] Launch an agent through CPA
   cpac setup            Show current Codex/Claude setup
   cpac status            Show agent support status
-  cpac restore <codex|pi|kimi|grok> | --all  Detach injected agents
+  cpac restore <codex|pi|kimi|grok|zed> | --all  Detach injected agents
   cpac --help            Show command usage
 ```
 
@@ -161,26 +161,26 @@ cpac --help
 
 ### 统一管理（detect / install / sync / restore / uninstall / upgrade）
 
-参考 vibetime 的目标式命令，对 `codex`、`pi`、`kimi`、`grok` 四个持久注入目标统一管理（claude 是临时接管，用 `cpac claude` 启动，不属于 install 目标）：
+参考 vibetime 的目标式命令，对 `codex`、`pi`、`kimi`、`grok`、`zed` 五个持久注入目标统一管理（claude 是临时接管，用 `cpac claude` 启动，不属于 install 目标）：
 
 ```bash
 cpac detect [--json]
-cpac install [codex|pi|kimi|grok...] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--max_context]
-cpac sync [codex|pi|kimi|grok...] [--all] [--dry-run] [--v2_off] [--v2_models] [--max_context]
-cpac restore <codex|pi|kimi|grok...> | --all [--dry-run]
+cpac install [codex|pi|kimi|grok|zed...] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--max_context]
+cpac sync [codex|pi|kimi|grok|zed...] [--all] [--dry-run] [--v2_off] [--v2_models] [--max_context]
+cpac restore <codex|pi|kimi|grok|zed...> | --all [--dry-run]
 cpac uninstall [--dry-run]
 cpac upgrade [--check]
 cpac -v | --version
 ```
 
 - `detect` 列出每个目标是否被检测到、是否已接入 CPAC；`--json` 输出机器可读结果。
-- `install` 默认作用于检测到的目标；后面直接写 agent 名（`cpac install codex pi`），`--all` 全部。`codex` 写入 catalog 并拉起 loopback 代理；`pi`/`kimi`/`grok` 写入各自配置。`--dry-run` 只打印将要做的事，`--force` 允许重装已安装目标。
-- `sync` 按当前 `cpa_url` 和 CPA 目录强制刷新**已经接入**的目标（Codex 重新注入、Pi 确认 `npm:@yhong91/cpac` 并清理旧的 `extensions/pi-cpac.ts`、Kimi 配置重写），用来在 CPA 地址或模型目录变化后一次对齐本地配置。不带参数只动已安装目标；`--all` 会对检测到的目标做同样的强制刷新（尚未安装的会装上）。`--max_context` 仍只对 `cpac install codex` 有效。
+- `install` 默认作用于检测到的目标；后面直接写 agent 名（`cpac install codex pi`），`--all` 全部。`codex` 写入 catalog 并拉起 loopback 代理；`pi`/`kimi`/`grok`/`zed` 写入各自配置。`--dry-run` 只打印将要做的事，`--force` 允许重装已安装目标。
+- `sync` 按当前 `cpa_url` 和 CPA 目录强制刷新**已经接入**的目标（Codex 重新注入、Pi 按 CLI 版本决定写入 packages / `pi update` / 跳过，并清理旧的 `extensions/pi-cpac.ts`、Kimi / Grok / Zed 配置重写），用来在 CPA 地址或模型目录变化后一次对齐本地配置。不带参数只动已安装目标；`--all` 会对检测到的目标做同样的强制刷新（尚未安装的会装上）。`--max_context` 仍只对 `cpac install codex` 有效。
 - Codex 注入默认开启 multi-agent v2（写入 `[features.multi_agent_v2] enabled = true`，catalog 行打 `multi_agent_version: "v2"`）；`install codex --v2_off` 关掉 toml 并去掉 catalog 戳。v2 开着时会剥掉 `[agents] max_threads`（Codex 否则拒启动）。`cpac status` 对照 config 里的 `v2_off` / `max_context` 和 live toml / catalog。服务端还需在 CPA 配置中开启 `codex.optimize-multi-agent-v2`。
 - `--v2_models` 进入 arrow-key 复选框选择最多 5 个 spawn_agent 模型（勾选顺序即推荐顺序），选择结果存入配置文件的 `spawn_models`，注入时把这些模型排到 `codex-models.json` 最前——Codex 客户端只把 catalog 前 5 个可见模型广告为 spawn 覆盖项。
 - `restore` 必须带 agent 名或 `--all`，卸掉指定（或全部）已注入目标。`--all` 时未安装的目标静默跳过。
 - `uninstall` 先用和 `cpac setup codex` 相同的方向键选择器确认（默认 Cancel），再 `restore --all`，最后 `npm uninstall -g @yhong91/cpac`。不要跟 agent 名；卸载的是 cpac 包本身。非终端取消。`--dry-run` 跳过确认。
-- `upgrade` 是发布后更新本机的一次性入口：查 npm → 需要时 `npm install -g` → 对**已接入**的 Codex / Pi / Kimi 执行 `sync`。已是最新也会 sync。不要先手动 `npm install -g` 再 `cpac sync`。`--check` 只报告版本，不安装也不 sync。没有已安装目标时跳过 sync，不报错。只刷新配置、不升 CLI 时用 `cpac sync`。
+- `upgrade` 是发布后更新本机的一次性入口：查 npm → 需要时 `npm install -g` → 对**已接入**的 Codex / Pi / Kimi / Grok / Zed 执行 `sync`。已是最新也会 sync。不要先手动 `npm install -g` 再 `cpac sync`。`--check` 只报告版本，不安装也不 sync。没有已安装目标时跳过 sync，不报错。只刷新配置、不升 CLI 时用 `cpac sync`。
 
 ### Claude Code
 
@@ -250,9 +250,9 @@ Codex App 的长驻 `app-server` 可能缓存旧目录。注入会删除 `models
 
 注入命令可选 `--max_context`（`cpac install codex --max_context`，默认不带）：把 catalog 中 `max_context_window` 高于 `context_window` 的模型提升到上限，并把 `auto_compact_token_limit` 设为上限的 90%。Codex 把 `context_window` 当输入预算而非展示标签，上游默认保留保守运营值（如 GPT-5.6 家族 272k），带上该参数后可用到实测上限（约 921k，opencodex 实测）；90% 压缩线确保在硬上限前触发 auto-compact。不带参数注入的仍是原本上下文的目录。该参数仅限 codex，与其他 target 组合使用会直接报错。
 
-`config.toml` 不存在时拒绝注入。当前是 native 时把原文件备份到 `state_dir/codex/config.toml`（覆盖更旧的 native 快照）；已注入后再装不覆盖备份。kimi/grok 同样：没有旧配置不写空备份，native 覆盖旧快照，已接入则保留。Pi 只改 `settings.json` 的 `packages`，不备份。`restore codex`：若 `config.toml` 相对注入未改，按原 mode 逐字节还原备份；若用户在注入期间改过文件，只撤掉 CPAC 写入的 catalog、url 和标记。没有其它需要代理的 agent 时才关闭代理。
+`config.toml` 不存在时拒绝注入。当前是 native 时把原文件备份到 `state_dir/codex/config.toml`（覆盖更旧的 native 快照）；已注入后再装不覆盖备份。kimi/grok/zed/pi 同样：没有旧配置不写空备份，native 覆盖旧快照，已接入则保留。所有 target 的 restore 都按 Codex 规则：注入后记下文件 hash；相对注入未改则逐字节还原备份（没有备份则删除我们创建的文件）；注入后改过则只剥 CPAC 字段，用户改动留下。没有其它需要代理的 agent 时才关闭代理。
 
-loopback 代理是 detached 用户进程，不安装系统服务。机器重启或进程意外退出后，`cpac status` 会报告 `loopback proxy stopped`；重新执行 `cpac install codex` 或 `cpac kimi` / `cpac grok` 即可恢复。
+loopback 代理是 detached 用户进程，不安装系统服务。机器重启或进程意外退出后，`cpac status` 会报告 `loopback proxy stopped`；重新执行 `cpac install codex` 或 `cpac kimi` / `cpac grok` / `cpac zed` 即可恢复。
 
 默认路径：
 
@@ -263,6 +263,8 @@ CPAC state：~/.cpac/state.json（公用 proxy 字段 + 已接入 agent 记录
   Codex  ~/.cpac/codex/config.toml
   Kimi   ~/.cpac/kimi/config.toml
   Grok   ~/.cpac/grok/config.toml
+  Zed    ~/.cpac/zed/settings.json
+  Pi     ~/.cpac/pi/settings.json
 restore / `<agent> clear` 会删掉该 agent 的备份目录和 state.json 里的对应记录
 ```
 
@@ -270,19 +272,14 @@ restore / `<agent> clear` 会删掉该 agent 的备份目录和 state.json 里
 
 ### Pi
 
-安装 CPA provider 扩展到 Pi：
-
 ```bash
-cpac pi install
+cpac install pi
+cpac pi
 ```
 
-在 `~/.pi/agent/settings.json` 的 `packages` 中加入 `npm:@yhong91/cpac`。Pi 启动时按 npm 包加载 `extensions/pi-cpac.ts`，从 CPA 动态注册模型。旧版写入的 `~/.pi/agent/extensions/pi-cpac.ts` 会在 install / restore 时删掉。卸载：
-
-```bash
-cpac restore pi
-```
+未接入时把 `npm:@yhong91/cpac` 写入 `~/.pi/agent/settings.json` 的 `packages`。已接入则比较 `~/.pi/agent/npm/node_modules/@yhong91/cpac` 与当前 CLI 版本：落后则 `pi update npm:@yhong91/cpac`，已是最新（或尚未下载副本）则跳过。`cpac pi` 启动前走同一套判断。Pi 启动时加载 `extensions/pi-cpac.ts` 从 CPA 动态注册模型。旧版 `~/.pi/agent/extensions/pi-cpac.ts` 会在 install / restore 时删掉。
 
-尊重 `PI_CODING_AGENT_DIR`。扩展代码随 npm 包更新，已装过的副本用 `pi update npm:@yhong91/cpac`（或 `pi update --extensions`）。
+卸载：`cpac restore pi` 或 `cpac pi clear`。尊重 `PI_CODING_AGENT_DIR`。
 
 ### Kimi Code
 
@@ -292,7 +289,7 @@ cpac restore pi
 cpac kimi install
 ```
 
-它在 `~/.kimi-code/config.toml` 追加一个由 CPAC 管理的块，注册 `cpac` OpenAI 兼容 provider，并把 CPA 目录里的每个模型映射为一个 `cpac/<模型名>` 条目。带 `supported_reasoning_levels` 的模型会写入 `capabilities`、`support_efforts` 和 `default_effort`，否则 Kimi 只给 Claude 名套内置 thinking profile，其它模型会停在 thinking off 且无法改 effort。`base_url` 指向共享 loopback 代理，因此密钥不落盘。install 会写入 `state.json` 并在需要时启动代理，不必先单独注入 Codex。卸载与状态：
+它在 `~/.kimi-code/config.toml` 追加一个由 CPAC 管理的块，注册 `cpac` OpenAI 兼容 provider，并把 CPA 目录里的每个模型映射为一个 `cpac/<模型名>` 条目。带 `supported_reasoning_levels` 的模型会写入 `capabilities`、`support_efforts` 和 `default_effort`，否则 Kimi 只给 Claude 名套内置 thinking profile，其它模型会停在 thinking off 且无法改 effort。`base_url` 指向共享 loopback 代理，因此密钥不落盘。install 会写入 `state.json` 并在需要时启动代理，不必先单独注入 Codex。`restore` 未改过注入文件则还原备份，改过则只剥 CPAC 块。卸载与状态：
 
 ```bash
 cpac restore kimi
@@ -300,6 +297,23 @@ cpac restore kimi
 
 Kimi Code 配置目录尊重 `KIMI_CODE_HOME` 环境变量。首次写入前若 `config.toml` 已存在，会在 `state_dir/kimi/config.toml` 保留一份原始快照（只存最早版本），万一文件损坏可手动复制回去。
 
+### Zed
+
+写入 CPA 的 OpenAI-compatible provider 到 Zed Agent：
+
+```bash
+cpac install zed
+cpac zed
+```
+
+它在 `~/.config/zed/settings.json` 的 `language_models.openai_compatible.cpac` 写入 `api_url`（指向共享 loopback 代理）和 CPA 目录里的 `available_models`。模型走 Responses API（`chat_completions: false`），与 Pi / Grok 一致。密钥不写进 settings：Zed 读取 `CPAC_API_KEY`（任意非空即可，loopback 会换成真正的 `CPA_API_KEY`），也可在 Agent Settings 里为 `cpac` provider 填一次。卸载：
+
+```bash
+cpac restore zed
+```
+
+配置目录尊重 `ZED_CONFIG_DIR`（否则 `$XDG_CONFIG_HOME/zed` 或 `~/.config/zed`）。首次写入前若 `settings.json` 已存在，会在 `state_dir/zed/settings.json` 保留原始快照。
+
 ## 环境变量
 
 | 变量 | 默认值 | 作用 |
@@ -307,7 +321,8 @@ Kimi Code 配置目录尊重 `KIMI_CODE_HOME` 环境变量。首次写入前若
 | `CPA_API_KEY` | 无 | CPA Bearer key；可由 `cpac` 首次引导写入 shell 启动文件 |
 | `CPA_BASE_URL` | `http://124.223.178.52:8317` | 覆盖内置 CPA 地址 |
 | `PI_CODING_AGENT_DIR` | `~/.pi/agent` | 覆盖 Pi agent 目录（影响 `settings.json` 写入位置） |
-| `KIMI_CODE_HOME` | `~/.kimi-code` | 覆盖 Kimi Code 目录（影响 `cpac kimi install` 写入位置） |
+| `KIMI_CODE_HOME` | `~/.kimi-code` | 覆盖 Kimi Code 目录（影响 `cpac install kimi` 写入位置） |
+| `ZED_CONFIG_DIR` | `~/.config/zed` | 覆盖 Zed 配置目录（影响 `cpac install zed` 写入位置） |
 | `CPAC_CONFIG` | `~/.config/cpac/config.json` | 指定可选 JSON 配置路径 |
 | `CODEX_HOME` | `~/.codex` | Codex home 目录 |
 

package/dist/agents.js

@@ -7,8 +7,9 @@ import { MAX_SPAWN_MODELS, loadCatalogSlugs, pickSpawnModels, saveCodexSetup, sa
 import { MANAGED_MARKER, inject, restore } from "./targets/codex.js";
 import { grokConfigPath, grokHome, installGrokConfig, isGrokConfigInstalled, uninstallGrokConfig, } from "./targets/grok.js";
 import { installKimiConfig, isKimiConfigInstalled, kimiConfigPath, uninstallKimiConfig, } from "./targets/kimi.js";
-import { PI_PACKAGE, installPiExtension, isPiExtensionInstalled, piAgentDir, piSettingsPath, uninstallPiExtension, } from "./targets/pi.js";
-import { CPACError, atomicWrite, checkboxPicker, expandUserPath, objectValue, tabWizard, } from "./util.js";
+import { PI_PACKAGE, ensurePiExtension, isPiExtensionInstalled, piAgentDir, piSettingsPath, uninstallPiExtension, } from "./targets/pi.js";
+import { installZedConfig, isZedConfigInstalled, uninstallZedConfig, zedConfigPath, zedHome, } from "./targets/zed.js";
+import { CPACError, atomicWrite, checkboxPicker, compareVersions, expandUserPath, objectValue, tabWizard, } from "./util.js";
 const CODEX_CTX_STD = "Standard (default input budget, e.g. 200K~272K)";
 const CODEX_CTX_MAX = "Max Context Window (lift to full upper bound, e.g. 921K~1M, 90% auto-compact limit)";
 const CODEX_V2_ON = "Enabled (Default)";
@@ -220,11 +221,7 @@ const TARGETS = [
         installed: () => isPiExtensionInstalled(),
         version: () => detectClientVersion("pi"),
         install: async (config, dryRun) => {
-            if (dryRun) {
-                console.log(`would add ${PI_PACKAGE} to ${piSettingsPath()}`);
-                return;
-            }
-            await installPiExtension(config);
+            await ensurePiExtension(config, CPAC_VERSION, dryRun);
         },
         uninstall: async (config, dryRun) => {
             if (dryRun) {
@@ -276,6 +273,27 @@ const TARGETS = [
             await uninstallGrokConfig(config);
         },
     },
+    {
+        id: "zed",
+        home: () => zedHome(),
+        detected: () => binaryOnPath("zed") || existsSync(zedHome()),
+        installed: () => isZedConfigInstalled(),
+        version: () => detectClientVersion("zed"),
+        install: async (config, dryRun) => {
+            if (dryRun) {
+                console.log(`would write CPA openai_compatible provider: ${zedConfigPath()}`);
+                return;
+            }
+            await installZedConfig(config);
+        },
+        uninstall: async (config, dryRun) => {
+            if (dryRun) {
+                console.log(`would remove CPA openai_compatible provider: ${zedConfigPath()}`);
+                return;
+            }
+            await uninstallZedConfig(config);
+        },
+    },
 ];
 export async function detectTargets(config) {
     return TARGETS.map((target) => ({
@@ -321,7 +339,7 @@ export async function runInstall(config, requested, options) {
         throw new CPACError("--max_context is only valid with codex");
     }
     for (const target of selected) {
-        if (target.installed(config) && !options.force) {
+        if (target.installed(config) && !options.force && target.id !== "pi") {
             console.log(`${target.id}: already installed; use --force to reinstall`);
             continue;
         }
@@ -398,17 +416,6 @@ export async function runUninstall(config, options) {
     }
     return 0;
 }
-function compareVersions(a, b) {
-    const left = a.split(".").map(Number);
-    const right = b.split(".").map(Number);
-    for (let index = 0; index < Math.max(left.length, right.length); index++) {
-        const l = left[index] ?? 0;
-        const r = right[index] ?? 0;
-        if (l !== r)
-            return l > r ? 1 : -1;
-    }
-    return 0;
-}
 export async function runUpgrade(config, checkOnly) {
     console.log(`Current version: ${CPAC_VERSION}`);
     let latest;

package/dist/config.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
-import { existsSync, readFileSync, rmdirSync, rmSync } from "node:fs";
+import { existsSync, readFileSync, rmdirSync, rmSync, statSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
-import { isAbsolute, join, parse, relative, resolve } from "node:path";
+import { basename, isAbsolute, join, parse, relative, resolve } from "node:path";
 import { CPACError, atomicWrite, checkboxPicker, expandUserPath, objectValue, } from "./util.js";
 export const PROVIDER = "cpac_cpa";
 export const DEFAULT_CPA_URL = "http://124.223.178.52:8317";
@@ -22,7 +22,7 @@ const CONFIG_KEYS = new Set([
 // spawn_agent overrides (codex-rs MAX_SPAWN_AGENT_MODEL_OVERRIDES).
 export const MAX_SPAWN_MODELS = 5;
 export const CLAUDE_SLOT_KEYS = ["opus", "sonnet", "haiku"];
-export const AGENT_IDS = ["codex", "pi", "kimi", "grok"];
+export const AGENT_IDS = ["codex", "pi", "kimi", "grok", "zed"];
 const AGENT_ID_SET = new Set(AGENT_IDS);
 const STATE_KEYS = new Set([
     "config_path",
@@ -42,6 +42,7 @@ export const STATE_FILES = [
     "config.toml.backup",
     "codex-models.json",
 ];
+const AGENT_RECORD_KEYS = new Set(["path", "existed", "mode", "injected_hash"]);
 export function defaultConfigPath() {
     return resolve(expandUserPath(process.env.CPAC_CONFIG || "~/.config/cpac/config.json"));
 }
@@ -468,7 +469,14 @@ export function readState(stateDir) {
                 typeof rec.path !== "string" ||
                 !rec.path ||
                 (rec.existed !== undefined && typeof rec.existed !== "boolean") ||
-                Object.keys(rec).some((key) => key !== "path" && key !== "existed")) {
+                (rec.mode !== undefined &&
+                    (!Number.isInteger(rec.mode) ||
+                        rec.mode < 0 ||
+                        rec.mode > 0o7777)) ||
+                (rec.injected_hash !== undefined &&
+                    (typeof rec.injected_hash !== "string" ||
+                        !/^[a-f0-9]{64}$/.test(rec.injected_hash))) ||
+                Object.keys(rec).some((key) => !AGENT_RECORD_KEYS.has(key))) {
                 throw new CPACError(`invalid agent record: ${id}`);
             }
         }
@@ -517,17 +525,27 @@ export function needsProxy(state) {
     if (state.config_path)
         return true;
     const agents = state.agents ?? {};
-    return Boolean(agents.codex || agents.kimi || agents.grok);
+    return Boolean(agents.codex || agents.kimi || agents.grok || agents.zed);
 }
 export function saveState(stateDir, state) {
     atomicWrite(join(stateDir, "state.json"), Buffer.from(`${JSON.stringify(state, null, 2)}\n`));
 }
-export function recordAgent(stateDir, id, path, proxy, existed) {
+export function recordAgent(stateDir, id, path, proxy, existed, injected) {
     const current = readState(stateDir) ?? {};
     const prev = current.agents?.[id];
     const record = { path };
     if (!(prev?.existed ?? existed ?? true))
         record.existed = false;
+    if (injected) {
+        record.injected_hash = injected.hash;
+        record.mode = injected.mode;
+    }
+    else {
+        if (prev?.injected_hash)
+            record.injected_hash = prev.injected_hash;
+        if (prev?.mode !== undefined)
+            record.mode = prev.mode;
+    }
     const next = {
         ...current,
         agents: { ...current.agents, [id]: record },
@@ -541,10 +559,52 @@ export function recordAgent(stateDir, id, path, proxy, existed) {
     saveState(stateDir, next);
     return next;
 }
+export function recordWrittenConfig(stateDir, id, path, proxy, existed) {
+    const bytes = readFileSync(path);
+    return recordAgent(stateDir, id, path, proxy, existed, {
+        hash: sha256Hex(bytes),
+        mode: statSync(path).mode & 0o7777,
+    });
+}
 export function removeCreatedTarget(stateDir, id, target) {
     if (readState(stateDir)?.agents?.[id]?.existed === false)
         rmSync(target, { force: true });
 }
+function restoredIsEmpty(bytes) {
+    const text = new TextDecoder("utf-8").decode(bytes).trim();
+    if (text === "")
+        return true;
+    try {
+        const value = JSON.parse(text);
+        return objectValue(value) && Object.keys(value).length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Codex restore: unchanged → backup bytes; edited → strip owned fields. */
+export function restoreOwnedConfig(stateDir, id, target, strip) {
+    const rec = readState(stateDir)?.agents?.[id];
+    const existed = rec?.existed !== false;
+    const mode = rec?.mode ??
+        (existsSync(target) ? statSync(target).mode & 0o7777 : 0o600);
+    const current = existsSync(target) ? readFileSync(target) : null;
+    const unchanged = !rec?.injected_hash ||
+        (current !== null && sha256Hex(current) === rec.injected_hash);
+    if (!current || unchanged) {
+        const backup = join(stateDir, id, basename(target));
+        if (existsSync(backup))
+            atomicWrite(target, readFileSync(backup), mode);
+        else
+            rmSync(target, { force: true });
+        return;
+    }
+    const stripped = strip(current);
+    if (!existed && restoredIsEmpty(stripped))
+        rmSync(target, { force: true });
+    else
+        atomicWrite(target, stripped, mode);
+}
 export function dropAgent(stateDir, id) {
     rmSync(join(stateDir, id), { recursive: true, force: true });
     const current = readState(stateDir);

package/dist/cpac.js

@@ -9,6 +9,7 @@ import { multiAgentV2Enabled } from "./targets/codex.js";
 import { isGrokConfigInstalled } from "./targets/grok.js";
 import { isKimiConfigInstalled } from "./targets/kimi.js";
 import { isPiExtensionInstalled } from "./targets/pi.js";
+import { isZedConfigInstalled } from "./targets/zed.js";
 import { defaultConfigPath, loadConfig, originalBytes, pickSpawnModels, readState, saveSpawnModels, stateProxy, catalogMaxContextLive, } from "./config.js";
 import { proxyIsHealthy, runProxyChild } from "./proxy.js";
 import { CPACError, expandUserPath, promptSecret, saveApiKeyExport, shellProfile, } from "./util.js";
@@ -20,7 +21,8 @@ export { claudeTierSlots, createClaudeProxy, runClaude, } from "./targets/claude
 export { detectClientVersion, detectTargets, runInstall, runRestore, runSync, runTargetLauncher, } from "./agents.js";
 export { installGrokConfig, isGrokConfigInstalled, uninstallGrokConfig, } from "./targets/grok.js";
 export { installKimiConfig, isKimiConfigInstalled, uninstallKimiConfig, } from "./targets/kimi.js";
-export { installPiExtension, isPiExtensionInstalled, uninstallPiExtension, } from "./targets/pi.js";
+export { ensurePiExtension, installPiExtension, isPiExtensionInstalled, piPackageAction, piPackageVersion, uninstallPiExtension, } from "./targets/pi.js";
+export { installZedConfig, isZedConfigInstalled, uninstallZedConfig, ZED_PROVIDER_ID, } from "./targets/zed.js";
 export async function status(config) {
     const apiKey = process.env[config.api_key_env]?.trim();
     const keyConfigured = !!apiKey;
@@ -72,6 +74,8 @@ export async function status(config) {
     console.log(`kimi: ${keyConfigured ? (kimiInstalled ? "ready" : "config not installed; run: cpac install kimi") : "not configured"}`);
     const grokInstalled = isGrokConfigInstalled();
     console.log(`grok: ${keyConfigured ? (grokInstalled ? "ready" : "config not installed; run: cpac install grok") : "not configured"}`);
+    const zedInstalled = isZedConfigInstalled();
+    console.log(`zed: ${keyConfigured ? (zedInstalled ? "ready" : "config not installed; run: cpac install zed") : "not configured"}`);
     if (!state)
         return 1;
     const proxy = stateProxy(state);
@@ -80,10 +84,10 @@ export async function status(config) {
     return 0;
 }
 async function guide(config) {
-    console.log(`CPA Companion\n\nCPA: ${config.cpa_url}\nCPA_API_KEY: ${process.env[config.api_key_env]?.trim() ? "configured" : "not configured"}\n\nCommands:\n  cpac <agent> [args...] Launch an agent (codex, kimi, grok, pi, claude) through CPA\n  cpac setup            Show current Codex/Claude setup; cpac setup <codex|claude> to change\n  cpac status            Show agent support status (Codex, Claude, Pi, Kimi, Grok)\n  cpac restore <codex|pi|kimi|grok> | --all  Detach injected agents
+    console.log(`CPA Companion\n\nCPA: ${config.cpa_url}\nCPA_API_KEY: ${process.env[config.api_key_env]?.trim() ? "configured" : "not configured"}\n\nCommands:\n  cpac <agent> [args...] Launch an agent (codex, kimi, grok, pi, zed, claude) through CPA\n  cpac setup            Show current Codex/Claude setup; cpac setup <codex|claude> to change\n  cpac status            Show agent support status (Codex, Claude, Pi, Kimi, Grok, Zed)\n  cpac restore <codex|pi|kimi|grok|zed> | --all  Detach injected agents
   cpac detect            Show supported targets and install status
-  cpac install [codex|pi|kimi|grok...]  Install CPA into detected targets, or named agents
-  cpac sync              Refresh installed Codex/Pi/Kimi/Grok injections from CPA
+  cpac install [codex|pi|kimi|grok|zed...]  Install CPA into detected targets, or named agents
+  cpac sync              Refresh installed Codex/Pi/Kimi/Grok/Zed injections from CPA
   cpac uninstall         Detach all agents, then remove the cpac package (confirms first)\n  cpac upgrade           Update cpac from npm and sync installed agents\n  cpac --help            Show command usage`);
     if (process.env[config.api_key_env]?.trim())
         return 0;
@@ -97,17 +101,17 @@ async function guide(config) {
 function usage() {
     return [
         "Usage: cpac",
-        "       cpac <codex|kimi|grok|pi|claude> [args...]",
+        "       cpac <codex|kimi|grok|pi|zed|claude> [args...]",
         "              setup|--setup     configure Codex/Claude, then launch",
         "              clear             restore native config",
         "       cpac setup     Show current Codex/Claude setup",
         "              claude [--opus [M]] [--sonnet [M]] [--haiku [M]] [--reset]",
         "              codex  [--v2_off] [--v2_models] [--max_context]",
-        "       cpac restore <codex|pi|kimi|grok...> | --all [--dry-run]",
+        "       cpac restore <codex|pi|kimi|grok|zed...> | --all [--dry-run]",
         "       cpac status",
         "       cpac detect [--json]",
-        "       cpac install [codex|pi|kimi|grok...] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--max_context]",
-        "       cpac sync [codex|pi|kimi|grok...] [--all] [--dry-run] [--v2_off] [--v2_models] [--max_context]",
+        "       cpac install [codex|pi|kimi|grok|zed...] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--max_context]",
+        "       cpac sync [codex|pi|kimi|grok|zed...] [--all] [--dry-run] [--v2_off] [--v2_models] [--max_context]",
         "       cpac uninstall [--dry-run]",
         "       cpac upgrade [--check]",
         "       cpac -v | --version",
@@ -221,7 +225,7 @@ function parseArgs(args) {
         }
         return parsed;
     }
-    if (["codex", "kimi", "grok", "pi", "claude"].includes(args[0])) {
+    if (["codex", "kimi", "grok", "pi", "zed", "claude"].includes(args[0])) {
         const targetId = args[0];
         let configPath = defaultConfigPath();
         const raw = args.slice(1);
@@ -567,7 +571,7 @@ export async function main(args = process.argv.slice(2)) {
             });
         if (parsed.command === "uninstall") {
             if (parsed.targets.length || parsed.all) {
-                throw new CPACError("uninstall removes the cpac package; detach agents with: cpac restore <codex|pi|kimi|grok> | --all");
+                throw new CPACError("uninstall removes the cpac package; detach agents with: cpac restore <codex|pi|kimi|grok|zed> | --all");
             }
             return await runUninstall(config, { dryRun: parsed.dryRun });
         }
@@ -618,7 +622,8 @@ export async function main(args = process.argv.slice(2)) {
         }
         if (parsed.command === "kimi" ||
             parsed.command === "grok" ||
-            parsed.command === "pi") {
+            parsed.command === "pi" ||
+            parsed.command === "zed") {
             return await runTargetLauncher(config, parsed.command, parsed.args);
         }
         return await status(config);

package/dist/proxy.js

@@ -329,7 +329,7 @@ export async function runProxy(config) {
         throw new CPACError("no active CPAC state; run cpac inject or install an agent first");
     const recorded = stateProxy(state);
     if (!recorded) {
-        throw new CPACError("state has no loopback proxy; run cpac inject or install kimi/grok first");
+        throw new CPACError("state has no loopback proxy; run cpac inject or install kimi/grok/zed first");
     }
     if (await proxyIsHealthy(recorded)) {
         throw new CPACError(`loopback proxy is already running on 127.0.0.1:${recorded.port}`);

package/dist/targets/grok.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { catalogModelId, catalogModelRows, dropAgent, fetchCatalog, recordAgent, removeCreatedTarget, } from "../config.js";
+import { catalogModelId, catalogModelRows, dropAgent, fetchCatalog, recordWrittenConfig, restoreOwnedConfig, } from "../config.js";
 import { ensureLoopbackProxy, stopProxyProcess } from "../proxy.js";
 import { CPACError, atomicWrite, ensureCpacBackup, expandUserPath, resolveApiKey, tomlString, } from "../util.js";
 export function grokHome() {
@@ -43,16 +43,16 @@ function stripOrphanCpacGrokTables(content) {
     }
     return out.join(eol).replace(/(?:\r?\n){3,}/g, `${eol}${eol}`);
 }
-function writeGrokBlock(path, block) {
-    let content = existsSync(path) ? readFileSync(path, "utf8") : "";
+function stripGrokManaged(content) {
     content = content.replace(grokBlockRegex, "");
     const orphan = content.indexOf(GROK_BLOCK_START);
     if (orphan !== -1)
         content = content.slice(0, orphan);
-    content = stripOrphanCpacGrokTables(content);
-    if (block) {
-        content = `${content}${content && !content.endsWith("\n") ? "\n" : ""}${block}\n`;
-    }
+    return stripOrphanCpacGrokTables(content);
+}
+function writeGrokBlock(path, block) {
+    let content = stripGrokManaged(existsSync(path) ? readFileSync(path, "utf8") : "");
+    content = `${content}${content && !content.endsWith("\n") ? "\n" : ""}${block}\n`;
     mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
     const mode = existsSync(path) ? statSync(path).mode & 0o7777 : 0o600;
     atomicWrite(path, Buffer.from(content), mode);
@@ -93,7 +93,7 @@ export async function installGrokConfig(config) {
     try {
         ensureCpacBackup(config.state_dir, "grok", target, !isGrokConfigInstalled());
         writeGrokBlock(target, lines.join("\n"));
-        recordAgent(config.state_dir, "grok", target, {
+        recordWrittenConfig(config.state_dir, "grok", target, {
             id: proxy.id,
             pid: proxy.pid,
             port: proxy.port,
@@ -111,8 +111,7 @@ export async function uninstallGrokConfig(config) {
     const target = grokConfigPath();
     if (!isGrokConfigInstalled())
         throw new CPACError("Grok Build config is not installed");
-    writeGrokBlock(target, null);
-    removeCreatedTarget(config.state_dir, "grok", target);
+    restoreOwnedConfig(config.state_dir, "grok", target, (current) => Buffer.from(stripGrokManaged(new TextDecoder("utf-8").decode(current))));
     const { stopProxy } = dropAgent(config.state_dir, "grok");
     if (stopProxy)
         await stopProxyProcess(stopProxy);

package/dist/targets/kimi.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { catalogModelId, catalogModelRows, dropAgent, fetchCatalog, recordAgent, removeCreatedTarget, } from "../config.js";
+import { catalogModelId, catalogModelRows, dropAgent, fetchCatalog, recordWrittenConfig, restoreOwnedConfig, } from "../config.js";
 import { ensureLoopbackProxy, stopProxyProcess } from "../proxy.js";
 import { CPACError, atomicWrite, ensureCpacBackup, expandUserPath, objectValue, resolveApiKey, tomlString, tomlStringArray, } from "../util.js";
 export function kimiConfigPath() {
@@ -44,8 +44,7 @@ function stripOrphanCpacTables(content) {
     }
     return out.join(eol).replace(/(?:\r?\n){3,}/g, `${eol}${eol}`);
 }
-function writeKimiBlock(path, block) {
-    let content = existsSync(path) ? readFileSync(path, "utf8") : "";
+function stripKimiManaged(content) {
     content = content.replace(kimiBlockRegex, "");
     // A truncated managed block (start marker without the end marker) leaves its
     // tables behind; appending again would duplicate [providers.cpac], make the
@@ -54,10 +53,11 @@ function writeKimiBlock(path, block) {
     const orphan = content.indexOf(KIMI_BLOCK_START);
     if (orphan !== -1)
         content = content.slice(0, orphan);
-    content = stripOrphanCpacTables(content);
-    if (block) {
-        content = `${content}${content && !content.endsWith("\n") ? "\n" : ""}${block}\n`;
-    }
+    return stripOrphanCpacTables(content);
+}
+function writeKimiBlock(path, block) {
+    let content = stripKimiManaged(existsSync(path) ? readFileSync(path, "utf8") : "");
+    content = `${content}${content && !content.endsWith("\n") ? "\n" : ""}${block}\n`;
     mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
     const mode = existsSync(path) ? statSync(path).mode & 0o7777 : 0o600;
     atomicWrite(path, Buffer.from(content), mode);
@@ -159,7 +159,7 @@ export async function installKimiConfig(config) {
     try {
         ensureCpacBackup(config.state_dir, "kimi", target, !isKimiConfigInstalled());
         writeKimiBlock(target, lines.join("\n"));
-        recordAgent(config.state_dir, "kimi", target, {
+        recordWrittenConfig(config.state_dir, "kimi", target, {
             id: proxy.id,
             pid: proxy.pid,
             port: proxy.port,
@@ -177,8 +177,7 @@ export async function uninstallKimiConfig(config) {
     const target = kimiConfigPath();
     if (!isKimiConfigInstalled())
         throw new CPACError("Kimi Code config is not installed");
-    writeKimiBlock(target, null);
-    removeCreatedTarget(config.state_dir, "kimi", target);
+    restoreOwnedConfig(config.state_dir, "kimi", target, (current) => Buffer.from(stripKimiManaged(new TextDecoder("utf-8").decode(current))));
     const { stopProxy } = dropAgent(config.state_dir, "kimi");
     if (stopProxy)
         await stopProxyProcess(stopProxy);

package/dist/targets/pi.js

@@ -1,9 +1,10 @@
+import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, unlinkSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { dropAgent, recordAgent } from "../config.js";
+import { dropAgent, recordWrittenConfig, restoreOwnedConfig, } from "../config.js";
 import { stopProxyProcess } from "../proxy.js";
-import { CPACError, atomicWrite, expandUserPath, objectValue, } from "../util.js";
+import { CPACError, atomicWrite, compareVersions, ensureCpacBackup, expandUserPath, objectValue, } from "../util.js";
 export const PI_PACKAGE = "npm:@yhong91/cpac";
 const PI_PACKAGE_NAME = "@yhong91/cpac";
 const LEGACY_EXTENSIONS = ["pi-cpac.ts", "cpac.ts", "pi-cpa.ts"];
@@ -77,9 +78,7 @@ function removeLeftovers() {
     }
     return removed;
 }
-export function isPiExtensionInstalled() {
-    if (leftoverExtensions().length > 0)
-        return true;
+function isPiPackageEnabled() {
     const path = piSettingsPath();
     if (!existsSync(path))
         return false;
@@ -91,10 +90,67 @@ export function isPiExtensionInstalled() {
         return false;
     }
 }
+export function isPiExtensionInstalled() {
+    return leftoverExtensions().length > 0 || isPiPackageEnabled();
+}
+export function piPackageVersion() {
+    const pkg = join(piAgentDir(), "npm", "node_modules", "@yhong91", "cpac", "package.json");
+    try {
+        const version = JSON.parse(readFileSync(pkg, "utf8")).version;
+        return typeof version === "string" ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function piPackageAction(desiredVersion) {
+    if (leftoverExtensions().length > 0 || !isPiExtensionInstalled()) {
+        return "install";
+    }
+    const version = piPackageVersion();
+    if (version !== undefined && compareVersions(version, desiredVersion) < 0) {
+        return "upgrade";
+    }
+    return "none";
+}
+export async function ensurePiExtension(config, desiredVersion, dryRun = false) {
+    const action = piPackageAction(desiredVersion);
+    if (action === "none")
+        return;
+    if (dryRun) {
+        console.log(action === "install"
+            ? `would add ${PI_PACKAGE} to ${piSettingsPath()}`
+            : `would update ${PI_PACKAGE}`);
+        return;
+    }
+    if (action === "install") {
+        await installPiExtension(config);
+        return;
+    }
+    const result = spawnSync("pi", ["update", PI_PACKAGE], {
+        stdio: "inherit",
+        env: { ...process.env, PI_CODING_AGENT_DIR: piAgentDir() },
+    });
+    if (result.error || (result.status ?? 1) !== 0) {
+        console.warn(`warning: pi update ${PI_PACKAGE} failed`);
+    }
+}
+function stripPiManaged(content) {
+    const settings = JSON.parse(new TextDecoder("utf-8").decode(content));
+    if (!objectValue(settings))
+        return content;
+    const packages = settings.packages;
+    if (!Array.isArray(packages) || !packages.some(isCpacPackage))
+        return Buffer.from(`${JSON.stringify(settings, null, 2)}\n`);
+    settings.packages = packages.filter((entry) => !isCpacPackage(entry));
+    return Buffer.from(`${JSON.stringify(settings, null, 2)}\n`);
+}
 export async function installPiExtension(config) {
     const path = piSettingsPath();
     mkdirSync(piAgentDir(), { recursive: true, mode: 0o700 });
-    const settings = existsSync(path) ? readSettings(path) : {};
+    const hadFile = existsSync(path);
+    ensureCpacBackup(config.state_dir, "pi", path, !isPiPackageEnabled());
+    const settings = hadFile ? readSettings(path) : {};
     const packages = settingsPackages(settings, path) ?? [];
     if (!packages.some(isEnabledCpacPackage)) {
         settings.packages = [
@@ -103,7 +159,7 @@ export async function installPiExtension(config) {
         ];
         writeSettings(path, settings);
     }
-    recordAgent(config.state_dir, "pi", path);
+    recordWrittenConfig(config.state_dir, "pi", path, undefined, hadFile);
     for (const file of removeLeftovers()) {
         console.log(`Removed leftover Pi extension: ${file}`);
     }
@@ -116,15 +172,12 @@ export async function uninstallPiExtension(config) {
         console.log(`Removed leftover Pi extension: ${file}`);
         removed = true;
     }
-    if (existsSync(path)) {
+    if (isPiExtensionInstalled() || existsSync(path)) {
         try {
-            const settings = readSettings(path);
-            const packages = settingsPackages(settings, path);
-            if (packages?.some(isCpacPackage)) {
-                settings.packages = packages.filter((entry) => !isCpacPackage(entry));
-                writeSettings(path, settings);
-                console.log(`Removed Pi package ${PI_PACKAGE} from ${path}`);
+            if (existsSync(path)) {
+                restoreOwnedConfig(config.state_dir, "pi", path, stripPiManaged);
                 removed = true;
+                console.log(`Removed Pi package ${PI_PACKAGE} from ${path}`);
             }
         }
         catch (error) {

package/dist/targets/zed.js

@@ -0,0 +1,306 @@
+import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { catalogModelId, catalogModelRows, dropAgent, fetchCatalog, recordWrittenConfig, restoreOwnedConfig, } from "../config.js";
+import { ensureLoopbackProxy, stopProxyProcess } from "../proxy.js";
+import { CPACError, atomicWrite, ensureCpacBackup, expandUserPath, objectValue, resolveApiKey, } from "../util.js";
+export const ZED_PROVIDER_ID = "cpac";
+const ZED_REASONING_EFFORTS = new Set([
+    "none",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+]);
+export function zedHome() {
+    const override = process.env.ZED_CONFIG_DIR?.trim();
+    if (override)
+        return expandUserPath(override);
+    const xdg = process.env.XDG_CONFIG_HOME?.trim();
+    const base = xdg ? expandUserPath(xdg) : join(homedir(), ".config");
+    return join(base, "zed");
+}
+export function zedConfigPath() {
+    return join(zedHome(), "settings.json");
+}
+/** Strip // and /* *\/ comments outside strings for Zed JSONC settings. */
+export function stripJsonc(text) {
+    let out = "";
+    let i = 0;
+    let inString = false;
+    let escape = false;
+    while (i < text.length) {
+        const c = text[i];
+        if (inString) {
+            out += c;
+            if (escape)
+                escape = false;
+            else if (c === "\\")
+                escape = true;
+            else if (c === '"')
+                inString = false;
+            i += 1;
+            continue;
+        }
+        if (c === '"') {
+            inString = true;
+            out += c;
+            i += 1;
+            continue;
+        }
+        if (c === "/" && text[i + 1] === "/") {
+            i += 2;
+            while (i < text.length && text[i] !== "\n")
+                i += 1;
+            continue;
+        }
+        if (c === "/" && text[i + 1] === "*") {
+            i += 2;
+            while (i + 1 < text.length && !(text[i] === "*" && text[i + 1] === "/"))
+                i += 1;
+            i += 2;
+            continue;
+        }
+        out += c;
+        i += 1;
+    }
+    return out;
+}
+/** Drop trailing commas before } or ] (Zed settings.json is JSONC). */
+export function stripTrailingCommas(text) {
+    let out = "";
+    let i = 0;
+    let inString = false;
+    let escape = false;
+    while (i < text.length) {
+        const c = text[i];
+        if (inString) {
+            out += c;
+            if (escape)
+                escape = false;
+            else if (c === "\\")
+                escape = true;
+            else if (c === '"')
+                inString = false;
+            i += 1;
+            continue;
+        }
+        if (c === '"') {
+            inString = true;
+            out += c;
+            i += 1;
+            continue;
+        }
+        if (c === ",") {
+            let j = i + 1;
+            while (j < text.length && /\s/.test(text[j]))
+                j += 1;
+            if (text[j] === "}" || text[j] === "]") {
+                i += 1;
+                continue;
+            }
+        }
+        out += c;
+        i += 1;
+    }
+    return out;
+}
+function parseSettings(text) {
+    const parsed = JSON.parse(stripTrailingCommas(stripJsonc(text)));
+    if (!objectValue(parsed))
+        throw new CPACError("invalid Zed settings.json");
+    return parsed;
+}
+function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    return parseSettings(readFileSync(path, "utf8"));
+}
+export function isZedConfigInstalled() {
+    try {
+        const doc = readSettings(zedConfigPath());
+        const languageModels = objectValue(doc.language_models)
+            ? doc.language_models
+            : null;
+        const openaiCompatible = languageModels && objectValue(languageModels.openai_compatible)
+            ? languageModels.openai_compatible
+            : null;
+        return Boolean(openaiCompatible && objectValue(openaiCompatible[ZED_PROVIDER_ID]));
+    }
+    catch {
+        return false;
+    }
+}
+function zedSupportEffort(row) {
+    const levels = row.supported_reasoning_levels ??
+        row.reasoning_effort_levels ??
+        row.reasoning_levels;
+    if (!Array.isArray(levels))
+        return undefined;
+    const efforts = [];
+    const seen = new Set();
+    for (const level of levels) {
+        const effort = typeof level === "string"
+            ? level.toLowerCase()
+            : objectValue(level) && typeof level.effort === "string"
+                ? level.effort.toLowerCase()
+                : undefined;
+        if (!effort || !ZED_REASONING_EFFORTS.has(effort) || seen.has(effort))
+            continue;
+        if (effort === "none")
+            continue;
+        seen.add(effort);
+        efforts.push(effort);
+    }
+    if (efforts.length === 0)
+        return undefined;
+    const rawDefaultEffort = (typeof row.default_reasoning_level === "string" &&
+        row.default_reasoning_level) ||
+        (typeof row.default_reasoning_effort === "string" &&
+            row.default_reasoning_effort) ||
+        (typeof row.default_effort === "string" && row.default_effort) ||
+        undefined;
+    const preferred = typeof rawDefaultEffort === "string"
+        ? rawDefaultEffort.toLowerCase()
+        : undefined;
+    if (preferred && efforts.includes(preferred))
+        return preferred;
+    for (const candidate of ["high", "medium", "xhigh", "max", "low", "minimal"]) {
+        if (efforts.includes(candidate))
+            return candidate;
+    }
+    return efforts[0];
+}
+function zedInputHasImage(row) {
+    const modalities = row.input_modalities;
+    if (!Array.isArray(modalities))
+        return false;
+    return modalities.some((value) => value === "image");
+}
+function buildCpacProvider(port, rows) {
+    const available_models = [];
+    for (const row of rows) {
+        const slug = catalogModelId(row);
+        if (!slug)
+            continue;
+        const context = typeof row.context_window === "number" && row.context_window > 0
+            ? Math.floor(row.context_window)
+            : 200000;
+        const model = {
+            name: slug,
+            max_tokens: context,
+            capabilities: {
+                tools: true,
+                images: zedInputHasImage(row),
+                parallel_tool_calls: false,
+                prompt_cache_key: false,
+                // CPA speaks OpenAI Responses (same as Pi / Grok).
+                chat_completions: false,
+                interleaved_reasoning: false,
+                max_tokens_parameter: false,
+            },
+        };
+        if (typeof row.display_name === "string" && row.display_name.trim()) {
+            model.display_name = row.display_name.trim();
+        }
+        const maxOut = typeof row.max_output_tokens === "number" && row.max_output_tokens > 0
+            ? Math.floor(row.max_output_tokens)
+            : undefined;
+        if (maxOut)
+            model.max_output_tokens = maxOut;
+        const effort = zedSupportEffort(row);
+        if (effort)
+            model.reasoning_effort = effort;
+        available_models.push(model);
+    }
+    if (available_models.length === 0)
+        throw new CPACError("CPA catalog contains no models");
+    return {
+        api_url: `http://127.0.0.1:${port}/v1`,
+        available_models,
+    };
+}
+function applyZedProvider(doc, provider) {
+    const languageModels = objectValue(doc.language_models)
+        ? { ...doc.language_models }
+        : {};
+    const openaiCompatible = objectValue(languageModels.openai_compatible)
+        ? { ...languageModels.openai_compatible }
+        : {};
+    if (provider) {
+        openaiCompatible[ZED_PROVIDER_ID] = provider;
+    }
+    else {
+        delete openaiCompatible[ZED_PROVIDER_ID];
+    }
+    if (Object.keys(openaiCompatible).length > 0) {
+        languageModels.openai_compatible = openaiCompatible;
+    }
+    else {
+        delete languageModels.openai_compatible;
+    }
+    if (Object.keys(languageModels).length > 0) {
+        doc.language_models = languageModels;
+    }
+    else {
+        delete doc.language_models;
+    }
+    return doc;
+}
+function stripZedManaged(content) {
+    const doc = applyZedProvider(parseSettings(new TextDecoder("utf-8").decode(content)), null);
+    return Buffer.from(`${JSON.stringify(doc, null, 2)}\n`);
+}
+function writeZedProvider(path, provider) {
+    const doc = applyZedProvider(readSettings(path), provider);
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const mode = existsSync(path) ? statSync(path).mode & 0o7777 : 0o600;
+    atomicWrite(path, Buffer.from(`${JSON.stringify(doc, null, 2)}\n`), mode);
+}
+export async function installZedConfig(config) {
+    const apiKey = await resolveApiKey(config.api_key_env);
+    const catalog = await fetchCatalog(config.cpa_url, apiKey);
+    let document;
+    try {
+        document = JSON.parse(new TextDecoder("utf-8").decode(catalog.bytes));
+    }
+    catch {
+        throw new CPACError("invalid CPA catalog");
+    }
+    const rows = catalogModelRows(document) ?? [];
+    if (rows.length === 0)
+        throw new CPACError("CPA catalog contains no models");
+    const { proxy, fingerprint, started } = await ensureLoopbackProxy(config, apiKey);
+    const provider = buildCpacProvider(proxy.port, rows);
+    const target = zedConfigPath();
+    const hadFile = existsSync(target);
+    try {
+        ensureCpacBackup(config.state_dir, "zed", target, !isZedConfigInstalled());
+        writeZedProvider(target, provider);
+        recordWrittenConfig(config.state_dir, "zed", target, {
+            id: proxy.id,
+            pid: proxy.pid,
+            port: proxy.port,
+            fingerprint,
+        }, hadFile);
+    }
+    catch (error) {
+        if (started)
+            await stopProxyProcess(proxy);
+        throw error;
+    }
+    console.log(`Installed Zed openai_compatible provider "${ZED_PROVIDER_ID}": ${target}`);
+    console.log(`Zed reads CPAC_API_KEY for this provider (any non-empty value; loopback injects ${config.api_key_env}).`);
+}
+export async function uninstallZedConfig(config) {
+    const target = zedConfigPath();
+    if (!isZedConfigInstalled())
+        throw new CPACError("Zed CPAC provider is not installed");
+    restoreOwnedConfig(config.state_dir, "zed", target, stripZedManaged);
+    const { stopProxy } = dropAgent(config.state_dir, "zed");
+    if (stopProxy)
+        await stopProxyProcess(stopProxy);
+    console.log(`Removed Zed openai_compatible provider "${ZED_PROVIDER_ID}": ${target}`);
+}

package/dist/util.js

@@ -205,9 +205,7 @@ export async function tabWizard(tabs) {
     };
     const resultOf = () => Object.fromEntries(state.map((tab) => [
         tab.id,
-        [...tab.selected]
-            .sort((a, b) => a - b)
-            .map((i) => tab.items[i]),
+        [...tab.selected].sort((a, b) => a - b).map((i) => tab.items[i]),
     ]));
     const goNext = () => {
         if (index < state.length && state[index].selected.size === 0)
@@ -385,3 +383,14 @@ export function saveApiKeyExport(profile, name, apiKey) {
     const mode = existsSync(profile) ? statSync(profile).mode & 0o7777 : 0o600;
     atomicWrite(profile, Buffer.from(content), mode);
 }
+export function compareVersions(a, b) {
+    const left = a.split(".").map(Number);
+    const right = b.split(".").map(Number);
+    for (let index = 0; index < Math.max(left.length, right.length); index++) {
+        const l = left[index] ?? 0;
+        const r = right[index] ?? 0;
+        if (l !== r)
+            return l > r ? 1 : -1;
+    }
+    return 0;
+}

package/package.json

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