@agent-proxy/agy 0.15.0 → 0.16.0

package/dist/credentials.d.ts

@@ -1,10 +1,14 @@
 /**
  * Antigravity CLI（agy）凭据的只读消费。
  *
- * 凭据文件是 CLI 写入的 `~/.gemini/antigravity-cli/antigravity-oauth-token`
- * （keyring 保存失败时的文件回退路径，本机即此形态）。网关只读 access_token 与
- * 过期时间，绝不刷新、绝不写回、绝不把令牌值带进日志或错误信息：
- * access_token 有效期整 1 小时，由 agy 进程（含 remote-control daemon）惰性刷新。
+ * 凭据有两处落点，macOS 按钥匙串优先的顺序只读消费：
+ * macOS 钥匙串条目 `gemini/antigravity`（`go-keyring-base64:` 前缀 + base64 的
+ * JSON）有可用令牌时优先采用，凭据文件被完全屏蔽，哪怕其内容本身是对的；
+ * 钥匙串无可用令牌（缺失/损坏/过期）才回落
+ * `~/.gemini/antigravity-cli/antigravity-oauth-token` 文件。
+ * 网关只读 access_token 与过期时间，绝不刷新、绝不写回、绝不把令牌值带进日志或
+ * 错误信息：access_token 有效期整 1 小时，由 agy 进程（含 daemon）惰性刷新并
+ * 写回上述存储；每次请求重新读取，写回自然生效。
  */
 export declare class AgyCredentialError extends Error {
     constructor(message: string);
@@ -23,13 +27,27 @@ export interface AgyCredentialOptions {
     credentialFile?: string;
     home?: string;
     readFile?: (file: string) => string;
+    /** 钥匙串条目读取（测试注入）；缺省经 security 命令读 gemini/antigravity 的值。 */
+    readKeychain?: () => string;
+    os?: NodeJS.Platform;
 }
 export declare function defaultAgyCredentialFile(home?: string, os?: NodeJS.Platform): string;
-/** 只探测凭据文件是否存在（Web UI 开关显隐用）；不读取也不解析内容。 */
-export declare function agyCredentialsPresent(credentialFile?: string): boolean;
+/** 只探测凭据来源是否存在（Web UI 开关显隐用）；不读取令牌值。 */
+export declare function agyCredentialsPresent(credentialFile?: string, options?: {
+    os?: NodeJS.Platform;
+    probeKeychain?: () => boolean;
+}): boolean;
 /**
- * 读取并校验 agy 凭据。文件缺失与损坏分开报错，损坏时带文件路径与重建指引，
- * 不静默当作未登录。
+ * 读取并校验 agy 凭据。网关不执行原生 CLI 的 refresh_token 续期逻辑：
+ *
+ * 1. 钥匙串条目（darwin）存在且令牌未被判为过期 → 采用，凭据文件被完全屏蔽
+ *    （哪怕文件内容本身是合法的）；
+ * 2. 钥匙串无可用令牌（缺失/损坏/过期）→ 回落凭据文件；
+ * 3. 文件也拿不到时，若钥匙串至少解析出凭据（已过期）则原样返回，交由请求层
+ *    按过期 401 给出刷新指引；两边都无凭据才报未登录（附钥匙串侧的具体问题）。
+ *
+ * 过期判定保留 10 秒余量；未知过期时间仍交由上游校验。每次请求重新读取，
+ * agy 对相应存储的写回自然生效。
  */
 export declare function loadAgyCredentials(options?: AgyCredentialOptions): AgyCredentials;
 /** access_token 是否已过期待判定：过期即快速失败，网关不做任何刷新。 */

package/dist/credentials.js

@@ -1,19 +1,32 @@
 import fs from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
+import { execFileSync } from "node:child_process";
 /**
  * Antigravity CLI（agy）凭据的只读消费。
  *
- * 凭据文件是 CLI 写入的 `~/.gemini/antigravity-cli/antigravity-oauth-token`
- * （keyring 保存失败时的文件回退路径，本机即此形态）。网关只读 access_token 与
- * 过期时间，绝不刷新、绝不写回、绝不把令牌值带进日志或错误信息：
- * access_token 有效期整 1 小时，由 agy 进程（含 remote-control daemon）惰性刷新。
+ * 凭据有两处落点，macOS 按钥匙串优先的顺序只读消费：
+ * macOS 钥匙串条目 `gemini/antigravity`（`go-keyring-base64:` 前缀 + base64 的
+ * JSON）有可用令牌时优先采用，凭据文件被完全屏蔽，哪怕其内容本身是对的；
+ * 钥匙串无可用令牌（缺失/损坏/过期）才回落
+ * `~/.gemini/antigravity-cli/antigravity-oauth-token` 文件。
+ * 网关只读 access_token 与过期时间，绝不刷新、绝不写回、绝不把令牌值带进日志或
+ * 错误信息：access_token 有效期整 1 小时，由 agy 进程（含 daemon）惰性刷新并
+ * 写回上述存储；每次请求重新读取，写回自然生效。
  */
 export class AgyCredentialError extends Error {
     constructor(message) { super(message); this.name = "AgyCredentialError"; }
 }
 /** access_token 判定过期时预留的时钟偏移余量。 */
 const EXPIRY_SKEW_MS = 10_000;
+/** 新版 agy CLI 的 macOS 钥匙串条目（go-keyring 惯例：服务 gemini、账户 antigravity）。 */
+const AGY_KEYCHAIN_SERVICE = "gemini";
+const AGY_KEYCHAIN_ACCOUNT = "antigravity";
+const GO_KEYRING_PREFIX = "go-keyring-base64:";
+const KEYCHAIN_TIMEOUT_MS = 5_000;
+function readAgyKeychainValue() {
+    return execFileSync("security", ["find-generic-password", "-s", AGY_KEYCHAIN_SERVICE, "-a", AGY_KEYCHAIN_ACCOUNT, "-w"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: KEYCHAIN_TIMEOUT_MS }).trim();
+}
 export function defaultAgyCredentialFile(home = process.env.HOME ?? "", os = process.platform) {
     if (os === "win32") {
         return path.join(home, "AppData", "Local", "Google", "antigravity-cli", "antigravity-oauth-token");
@@ -28,55 +41,116 @@ function parseExpiry(value) {
     const parsed = Date.parse(value);
     return Number.isFinite(parsed) ? parsed : 0;
 }
-/** 只探测凭据文件是否存在（Web UI 开关显隐用）；不读取也不解析内容。 */
-export function agyCredentialsPresent(credentialFile = defaultAgyCredentialFile()) {
+/** 只探测凭据来源是否存在（Web UI 开关显隐用）；不读取令牌值。 */
+export function agyCredentialsPresent(credentialFile = defaultAgyCredentialFile(), options = {}) {
     try {
         return fs.statSync(credentialFile).isFile();
     }
-    catch {
+    catch { /* 继续探测钥匙串。 */ }
+    if ((options.os ?? process.platform) !== "darwin")
         return false;
-    }
+    const probe = options.probeKeychain ?? (() => {
+        try {
+            execFileSync("security", ["find-generic-password", "-s", AGY_KEYCHAIN_SERVICE, "-a", AGY_KEYCHAIN_ACCOUNT], { stdio: ["ignore", "ignore", "ignore"], timeout: KEYCHAIN_TIMEOUT_MS });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+    return probe();
 }
 /**
- * 读取并校验 agy 凭据。文件缺失与损坏分开报错，损坏时带文件路径与重建指引，
- * 不静默当作未登录。
+ * 读取并校验 agy 凭据。网关不执行原生 CLI 的 refresh_token 续期逻辑：
+ *
+ * 1. 钥匙串条目（darwin）存在且令牌未被判为过期 → 采用，凭据文件被完全屏蔽
+ *    （哪怕文件内容本身是合法的）；
+ * 2. 钥匙串无可用令牌（缺失/损坏/过期）→ 回落凭据文件；
+ * 3. 文件也拿不到时，若钥匙串至少解析出凭据（已过期）则原样返回，交由请求层
+ *    按过期 401 给出刷新指引；两边都无凭据才报未登录（附钥匙串侧的具体问题）。
+ *
+ * 过期判定保留 10 秒余量；未知过期时间仍交由上游校验。每次请求重新读取，
+ * agy 对相应存储的写回自然生效。
  */
 export function loadAgyCredentials(options = {}) {
     const file = options.credentialFile
-        ?? defaultAgyCredentialFile(options.home ?? process.env.HOME ?? "");
+        ?? defaultAgyCredentialFile(options.home ?? process.env.HOME ?? "", options.os ?? process.platform);
     const read = options.readFile ?? ((source) => fs.readFileSync(source, "utf8"));
-    let raw;
-    try {
-        raw = read(file);
-    }
-    catch {
-        throw new AgyCredentialError(`未检测到 Antigravity CLI 登录（${file} 不存在）；请先运行 agy 并完成 Google 账号登录，或执行 agy remote-control start 保持登录态刷新`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new AgyCredentialError(`Antigravity 凭据文件损坏（${file} 不是有效 JSON）；请在 agy 内退出登录后重新登录以重建该文件`);
+    const keychainLabel = `keychain:${AGY_KEYCHAIN_SERVICE}/${AGY_KEYCHAIN_ACCOUNT}`;
+    /** 解析单个来源的 JSON 文本；损坏与缺字段分开报错（带来源标注）。 */
+    const parse = (raw, label) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new AgyCredentialError(`Antigravity 凭据损坏（${label} 不是有效 JSON）；请在 agy 内退出登录后重新登录以重建`);
+        }
+        const root = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed : undefined;
+        const tokenRaw = root?.token;
+        const token = tokenRaw !== null && tokenRaw !== undefined && typeof tokenRaw === "object" && !Array.isArray(tokenRaw)
+            ? tokenRaw : undefined;
+        const accessToken = typeof token?.access_token === "string" ? token.access_token : "";
+        if (!token || !accessToken) {
+            throw new AgyCredentialError(`Antigravity 凭据缺少 access_token（${label}）；请运行 agy 重新登录后重试`);
+        }
+        const seed = typeof token.refresh_token === "string" && token.refresh_token
+            ? token.refresh_token
+            : typeof root?.id_token === "string" && root.id_token ? root.id_token : accessToken;
+        return {
+            accessToken,
+            expiryMs: parseExpiry(token.expiry),
+            identity: createHash("sha256").update(seed).digest("hex"),
+            authMethod: typeof root?.auth_method === "string" && root.auth_method ? root.auth_method : "consumer",
+        };
+    };
+    /** 读凭据文件；缺失/不可读返回 undefined（由调用方决定回退或报错），损坏抛错。 */
+    const readFileCredentials = () => {
+        let raw;
+        try {
+            raw = read(file);
+        }
+        catch {
+            return undefined;
+        }
+        return parse(raw, file);
+    };
+    if ((options.os ?? process.platform) === "darwin") {
+        const readKeychain = options.readKeychain ?? readAgyKeychainValue;
+        let keychainCredentials;
+        let keychainProblem;
+        try {
+            const raw = readKeychain();
+            if (!raw.startsWith(GO_KEYRING_PREFIX)) {
+                throw new AgyCredentialError(`Antigravity 钥匙串条目格式异常（${AGY_KEYCHAIN_SERVICE}/${AGY_KEYCHAIN_ACCOUNT} 不以 ${GO_KEYRING_PREFIX} 开头）；请在 agy 内退出登录后重新登录以重建`);
+            }
+            keychainCredentials = parse(Buffer.from(raw.slice(GO_KEYRING_PREFIX.length), "base64").toString("utf8"), keychainLabel);
+        }
+        catch (error) {
+            // 子进程错误可能携带 stdout（令牌值），只允许预定义的解析错误进入提示。
+            keychainProblem = error instanceof AgyCredentialError ? error.message : "钥匙串不可读或读取超时";
+        }
+        // 钥匙串有合法（未过期）令牌：直接采用，文件被完全屏蔽。
+        if (keychainCredentials && !agyTokenStale(keychainCredentials))
+            return keychainCredentials;
+        // 钥匙串过期/损坏/缺失均回落文件。
+        const fromFile = readFileCredentials();
+        if (fromFile)
+            return fromFile;
+        // 文件也没有：过期钥匙串凭据原样返回（请求层按过期给指引），否则报未登录。
+        if (keychainCredentials)
+            return keychainCredentials;
+        throw new AgyCredentialError(`未检测到 Antigravity CLI 登录（钥匙串条目 ${AGY_KEYCHAIN_SERVICE}/${AGY_KEYCHAIN_ACCOUNT} 无可用令牌`
+            + `${keychainProblem ? `：${keychainProblem}` : ""}，且 ${file} 不存在或不可读）；`
+            + "请先运行 agy 并完成 Google 账号登录，或执行 agy remote-control start 保持登录态刷新");
     }
-    const root = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)
-        ? parsed : undefined;
-    const tokenRaw = root?.token;
-    const token = tokenRaw !== null && tokenRaw !== undefined && typeof tokenRaw === "object" && !Array.isArray(tokenRaw)
-        ? tokenRaw : undefined;
-    const accessToken = typeof token?.access_token === "string" ? token.access_token : "";
-    if (!token || !accessToken) {
-        throw new AgyCredentialError(`Antigravity 凭据缺少 access_token（${file}）；请运行 agy 重新登录后重试`);
+    const fromFile = readFileCredentials();
+    if (!fromFile) {
+        throw new AgyCredentialError(`未检测到 Antigravity CLI 登录（${file} 不存在，且当前平台无钥匙串回退）；`
+            + "请先运行 agy 并完成 Google 账号登录，或执行 agy remote-control start 保持登录态刷新");
     }
-    const seed = typeof token.refresh_token === "string" && token.refresh_token
-        ? token.refresh_token
-        : typeof root?.id_token === "string" && root.id_token ? root.id_token : accessToken;
-    return {
-        accessToken,
-        expiryMs: parseExpiry(token.expiry),
-        identity: createHash("sha256").update(seed).digest("hex"),
-        authMethod: typeof root?.auth_method === "string" && root.auth_method ? root.auth_method : "consumer",
-    };
+    return fromFile;
 }
 /** access_token 是否已过期待判定：过期即快速失败，网关不做任何刷新。 */
 export function agyTokenStale(credentials, now = Date.now()) {

package/dist/request.js

@@ -16,6 +16,61 @@ function fail(message) { throw new AgyRequestError(message); }
 function record(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+/** AGY 保持独立转换：增补信封先提升为声明，避免进入普通历史回放。 */
+function normalizeAdditionalTools(body) {
+    if (!Array.isArray(body.input))
+        return body;
+    const envelopes = body.input.filter((item) => record(item) && item.type === "additional_tools");
+    if (envelopes.length === 0)
+        return body;
+    if (body.tools !== undefined && !Array.isArray(body.tools))
+        fail("additional_tools 合并要求 tools 为数组");
+    const groups = [body.tools ?? []];
+    for (const envelope of envelopes) {
+        if (!Array.isArray(envelope.tools))
+            fail("additional_tools.tools 必须是数组");
+        groups.push(envelope.tools);
+    }
+    const merge = (entries, inNamespace = false) => {
+        const tools = [];
+        const indices = new Map();
+        for (const group of entries) {
+            for (const raw of group) {
+                if (!record(raw) || typeof raw.type !== "string" || !raw.type)
+                    fail("additional_tools.tools 包含无效工具声明");
+                if (["function", "custom", "namespace"].includes(raw.type) && (typeof raw.name !== "string" || !raw.name)) {
+                    fail("additional_tools 工具 name 必须是非空字符串");
+                }
+                if (raw.type === "function" && !record(raw.parameters))
+                    fail(`additional_tools function 工具 ${String(raw.name)} 缺少对象 parameters`);
+                let tool = raw;
+                if (raw.type === "namespace") {
+                    if (inNamespace || !Array.isArray(raw.tools))
+                        fail("additional_tools namespace.tools 必须是工具数组且不得嵌套 namespace");
+                    tool = { ...raw, tools: merge([raw.tools], true) };
+                }
+                // function/custom 共用名称身份，顶层声明优先于历史信封中的旧类型。
+                const type = tool.type === "function" || tool.type === "custom" ? "callable" : tool.type;
+                const key = JSON.stringify([type, tool.namespace ?? null, tool.name ?? null]);
+                const index = indices.get(key);
+                if (index === undefined) {
+                    indices.set(key, tools.length);
+                    tools.push(tool);
+                }
+                else if (tool.type === "namespace") {
+                    const existing = tools[index];
+                    tools[index] = { ...existing, tools: merge([existing.tools, tool.tools], true) };
+                }
+            }
+        }
+        return tools;
+    };
+    return {
+        ...body,
+        tools: merge(groups),
+        input: body.input.filter((item) => !record(item) || item.type !== "additional_tools"),
+    };
+}
 function string(value, field) {
     if (typeof value !== "string")
         fail(`${field} 必须是字符串`);
@@ -476,6 +531,8 @@ function normalizeSourceItems(body, to) {
 export function translateAgyRequest(body, upstreamModel, to = "responses") {
     if (typeof upstreamModel !== "string" || !upstreamModel)
         fail("上游模型不能为空");
+    if (to === "responses")
+        body = normalizeAdditionalTools(body);
     body = normalizeSourceItems(body, to);
     if (body.previous_response_id !== undefined && body.previous_response_id !== null && body.previous_response_id !== "") {
         fail("Antigravity 不支持 previous_response_id；请提供完整 input 历史");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-proxy/agy",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Agent Proxy agy 插件；保留基线转换行为。",
   "type": "module",
   "exports": {
@@ -35,10 +35,10 @@
     "url": "git+https://github.com/aceHubert/codex-cliproxy-gateway.git"
   },
   "devDependencies": {
-    "@agent-proxy/models": "0.15.0"
+    "@agent-proxy/models": "0.16.0"
   },
   "dependencies": {
-    "@agent-proxy/plugin-api": "0.15.0"
+    "@agent-proxy/plugin-api": "0.16.0"
   },
-  "gitHead": "18c0204058613a525fe2b9048eb6ed29f65a4f2d"
+  "gitHead": "062121f545d3391665789b2e8baae842029262be"
 }