@yhong91/cpac 0.2.0 → 0.2.2

package/README.md

@@ -363,11 +363,22 @@ cpac restore cline
 
 配置目录尊重 `CLINE_DATA_DIR`（否则 `~/.cline/data`，CLI 与 Desktop 共享）。首次写入前若 `providers.json` 已存在，会在 `state_dir/cline/providers.json` 保留原始快照。
 
+### 手动打开 5h 窗口
+
+本机手动发一条最小请求，用来激活当前 5h 额度。不定时，也不查配额。定时仍在 VPS 的 `scripts/quota-heartbeat.py`。
+
+```bash
+cpac ping codex    # 目录里匹配 gpt-*-luna 的一条
+cpac ping agy      # gemini-3.8-flash 和 claude-sonnet-4-6，各一条
+```
+
+用 `CPA_API_KEY`。日志只打模型、HTTP 状态和不含 key 的 `x-cpa-*` trace。CPA 按账号轮询，一次只会落在一个账号上。
+
 ## 环境变量
 
 | 变量 | 默认值 | 作用 |
 | --- | --- | --- |
-| `CPA_API_KEY` | 无 | CPA Bearer key；可由 `cpac` 首次引导写入 shell 启动文件 |
+| `CPA_API_KEY` | 无 | CPA Bearer key；可由 `cpac` 首次引导写入 shell 启动文件；`cpac ping` 也用它 |
 | `CPA_BASE_URL` | `http://124.223.178.52:8317` | 覆盖内置 CPA 地址 |
 | `PI_CODING_AGENT_DIR` | `~/.pi/agent` | 覆盖 Pi agent 目录（影响 `models.json` 写入位置） |
 | `KIMI_CODE_HOME` | `~/.kimi-code` | 覆盖 Kimi Code 目录（影响 `cpac install kimi` 写入位置） |

package/dist/cpac.js

@@ -13,6 +13,7 @@ import { isZedConfigInstalled } from "./targets/zed.js";
 import { isHermesConfigInstalled } from "./targets/hermes.js";
 import { CLINE_PROVIDER_ID, isClineConfigInstalled } from "./targets/cline.js";
 import { defaultConfigPath, loadConfig, originalBytes, pickSpawnModels, readState, saveSpawnModels, stateProxy, catalogMaxContextLive, catalogModelId, catalogModelRows, catalogSlugs, fetchCatalog, } from "./config.js";
+import { runPing } from "./ping.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";
@@ -102,7 +103,13 @@ async function listModels(config, json) {
             console.log(slug);
         return 0;
     }
-    const document = JSON.parse(new TextDecoder().decode(catalog.bytes));
+    let document;
+    try {
+        document = JSON.parse(new TextDecoder().decode(catalog.bytes));
+    }
+    catch {
+        throw new CPACError("CPA catalog is not valid JSON");
+    }
     const models = (catalogModelRows(document) ?? []).flatMap((row) => {
         const slug = catalogModelId(row);
         if (!slug)
@@ -127,7 +134,7 @@ async function guide(config) {
   cpac detect            Show supported targets and install status
   cpac install [codex|pi|kimi|grok|zed|hermes|cline...]  Install CPA into detected targets, or named agents
   cpac sync              Refresh installed Codex/Pi/Kimi/Grok/Zed/Hermes/Cline 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 models            List remote CPA catalog models\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 ping codex|agy    Send one request to open that 5h window\n  cpac --help            Show command usage`);
     if (process.env[config.api_key_env]?.trim())
         return 0;
     const apiKey = await promptSecret(config.api_key_env);
@@ -164,6 +171,7 @@ function usage() {
         cmd("cpac restore <agent...>", "detach injected agents"),
         cmd("cpac uninstall", "detach all agents, then remove the cpac package"),
         cmd("cpac upgrade", "update cpac from npm and sync installed agents"),
+        cmd("cpac ping <codex|agy>", "send one request to open that 5h window"),
         "",
         "Positionals:",
         helpRow("agent", "codex, kimi, grok, pi, zed, hermes, cline, or claude (claude is launch-only)", "", 18),
@@ -227,6 +235,31 @@ function parseArgs(args) {
     if (args.length === 0) {
         return { command: "guide", configPath: defaultConfigPath() };
     }
+    if (args[0] === "ping") {
+        let configPath = defaultConfigPath();
+        let target = "";
+        for (let index = 1; index < args.length; index++) {
+            const arg = args[index];
+            if (arg === "-h" || arg === "--help") {
+                console.log(usage());
+                return null;
+            }
+            if (arg === "--config") {
+                const value = args[++index];
+                if (!value)
+                    throw new CPACError("--config requires a path");
+                configPath = resolve(expandUserPath(value));
+            }
+            else if (!arg.startsWith("-") && !target)
+                target = arg;
+            else
+                throw new CPACError(`unknown option: ${arg}`);
+        }
+        if (target !== "codex" && target !== "agy") {
+            throw new CPACError("cpac ping requires codex or agy");
+        }
+        return { command: "ping", configPath, target };
+    }
     if (args[0] === "detect" ||
         args[0] === "install" ||
         args[0] === "sync" ||
@@ -663,6 +696,8 @@ export async function main(args = process.argv.slice(2)) {
         }
         if (parsed.command === "upgrade")
             return await runUpgrade(config, parsed.check);
+        if (parsed.command === "ping")
+            return await runPing(config, parsed.target);
         if (parsed.command === "claude")
             return await runClaude(config, parsed.args);
         if (parsed.command === "claude-config") {

package/dist/ping.js

@@ -0,0 +1,67 @@
+import { apiBase, catalogSlugs, fetchCatalog } from "./config.js";
+import { CPACError } from "./util.js";
+const LUNA = /^gpt-.+-luna$/;
+export const PING_MODELS = {
+    agy: ["gemini-3.8-flash", "claude-sonnet-4-6"],
+};
+export function matchLuna(slugs) {
+    const model = slugs.filter((slug) => LUNA.test(slug)).sort().at(-1);
+    if (!model)
+        throw new CPACError("no catalog model matches gpt-*-luna");
+    return model;
+}
+const EMAIL_RE = /[A-Za-z0-9._%+\-]+@/g;
+function redact(value) {
+    return String(value).replace(EMAIL_RE, "*@");
+}
+export async function runPing(config, target, deps = {}) {
+    const env = deps.env ?? process.env;
+    const log = deps.log ?? ((line) => console.log(line));
+    const fetchImpl = deps.fetch ?? fetch;
+    const apiKey = env[config.api_key_env]?.trim();
+    if (!apiKey)
+        throw new CPACError(`environment variable ${config.api_key_env} is not set`);
+    const url = `${apiBase(config.cpa_url)}/chat/completions`;
+    const models = target === "codex"
+        ? [matchLuna(catalogSlugs((await fetchCatalog(config.cpa_url, apiKey)).bytes))]
+        : PING_MODELS[target];
+    let failed = 0;
+    for (const model of models) {
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: [{ role: "user", content: "hi" }],
+                    max_tokens: 16,
+                    stream: false,
+                }),
+                redirect: "error",
+                signal: AbortSignal.timeout(90_000),
+            });
+        }
+        catch (error) {
+            log(`${model} failed: ${error instanceof Error ? error.message : String(error)}`);
+            failed += 1;
+            continue;
+        }
+        const text = await response.text();
+        const trace = [];
+        response.headers.forEach((value, key) => {
+            const name = key.toLowerCase();
+            if (name.startsWith("x-cpa-") && !name.includes("key"))
+                trace.push(`${name}=${redact(value)}`);
+        });
+        const detail = response.status === 200 ? "" : ` ${redact(text).replaceAll(apiKey, "***").slice(0, 180)}`;
+        log(`${model} HTTP ${response.status}${trace.length ? ` ${trace.join(" ")}` : ""}${detail}`);
+        if (response.status !== 200)
+            failed += 1;
+    }
+    return failed ? 1 : 0;
+}

package/package.json

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