@yhong91/cpac 0.1.39 → 0.1.40

package/README.md

@@ -113,6 +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 models            List remote CPA catalog models
   cpac restore <codex|pi|kimi|grok|zed> | --all  Detach injected agents
   cpac --help            Show command usage
 ```
@@ -165,6 +166,7 @@ cpac --help
 
 ```bash
 cpac detect [--json]
+cpac models [--json]
 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]
@@ -173,6 +175,7 @@ cpac upgrade [--check]
 cpac -v | --version
 ```
 
+- `models` 从远端 CPA 拉取 rich catalog，默认一行一个 slug；`--json` 输出 `cpa_url` 和模型字段（`slug` / `display_name` / `context_window`）。用来核对 catalog 里有没有某个模型（例如 `*-fast`），不写本地配置。
 - `detect` 列出每个目标是否被检测到、是否已接入 CPAC；`--json` 输出机器可读结果。
 - `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` 有效。

package/dist/cpac.js

@@ -10,7 +10,7 @@ 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 { defaultConfigPath, loadConfig, originalBytes, pickSpawnModels, readState, saveSpawnModels, stateProxy, catalogMaxContextLive, catalogModelId, catalogModelRows, catalogSlugs, fetchCatalog, } from "./config.js";
 import { proxyIsHealthy, runProxyChild } from "./proxy.js";
 import { CPACError, expandUserPath, promptSecret, saveApiKeyExport, shellProfile, } from "./util.js";
 export { PROVIDER, loadConfig, saveSpawnModels, saveCodexSetup, liftContextWindows, reorderCatalog, sanitizeCatalogModalities, stampMultiAgentVersion, catalogMaxContextLive, readState, stateProxy, } from "./config.js";
@@ -83,12 +83,42 @@ export async function status(config) {
         return 2;
     return 0;
 }
+async function listModels(config, json) {
+    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);
+    if (!json) {
+        for (const slug of catalogSlugs(catalog.bytes))
+            console.log(slug);
+        return 0;
+    }
+    const document = JSON.parse(new TextDecoder().decode(catalog.bytes));
+    const models = (catalogModelRows(document) ?? []).flatMap((row) => {
+        const slug = catalogModelId(row);
+        if (!slug)
+            return [];
+        const display = typeof row.display_name === "string" && row.display_name.trim()
+            ? row.display_name.trim()
+            : slug;
+        const context = typeof row.context_window === "number" && row.context_window > 0
+            ? Math.floor(row.context_window)
+            : undefined;
+        return [
+            context !== undefined
+                ? { slug, display_name: display, context_window: context }
+                : { slug, display_name: display },
+        ];
+    });
+    console.log(JSON.stringify({ cpa_url: config.cpa_url, count: models.length, models }, null, 2));
+    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, 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|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`);
+  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 models            List remote CPA catalog models\n  cpac --help            Show command usage`);
     if (process.env[config.api_key_env]?.trim())
         return 0;
     const apiKey = await promptSecret(config.api_key_env);
@@ -109,6 +139,7 @@ function usage() {
         "              codex  [--v2_off] [--v2_models] [--max_context]",
         "       cpac restore <codex|pi|kimi|grok|zed...> | --all [--dry-run]",
         "       cpac status",
+        "       cpac models [--json]",
         "       cpac detect [--json]",
         "       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]",
@@ -157,7 +188,8 @@ function parseArgs(args) {
         args[0] === "sync" ||
         args[0] === "uninstall" ||
         args[0] === "restore" ||
-        args[0] === "upgrade") {
+        args[0] === "upgrade" ||
+        args[0] === "models") {
         const parsed = {
             command: args[0],
             configPath: defaultConfigPath(),
@@ -531,6 +563,8 @@ export async function main(args = process.argv.slice(2)) {
         const config = loadConfig(parsed.configPath, true);
         if (parsed.command === "guide")
             return await guide(config);
+        if (parsed.command === "models")
+            return await listModels(config, parsed.json);
         if (parsed.command === "detect")
             return await runDetect(config, parsed.json);
         if (parsed.command === "install") {

package/package.json

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