@jsonstudio/rcc 0.89.1491 → 0.89.1502

package/dist/runtime/wasm-runtime/wasm-config.d.ts

@@ -1,73 +0,0 @@
-/**
- * WASM 运行时配置与运行模式开关
- *
- * 责任边界：
- * - Host：开关读取、影子请求分发、指标上报
- * - Core（WASM/TS）：canonicalization、routing、tools、compat、diff 协议
- *
- * 开关优先级矩阵（高 → 低）：
- * - 全局（进程级）：ROUTECODEX_HUB_PIPELINE_IMPL
- * - 租户级：config.virtualRouter.*（暂未实现）
- * - 路由级：metadata.routeHint（暂未实现）
- * - 请求级：header X-RC-Pipeline-Impl（暂未实现）
- */
-/**
- * HubPipeline 实现类型
- */
-export type HubPipelineImpl = 'ts' | 'wasm';
-/**
- * 运行模式
- */
-export type HubPipelineMode = 'ts_primary' | 'wasm_primary' | 'shadow_ts' | 'shadow_wasm' | 'split';
-/**
- * 运行模式配置
- */
-export interface HubPipelineRuntimeConfig {
-    /**
-     * 运行模式
-     */
-    mode: HubPipelineMode;
-    /**
-     * 分流比例（仅 split 模式有效）
-     * - 0.0 = 全部走 TS
-     * - 1.0 = 全部走 WASM
-     * - 0.5 = 50% TS / 50% WASM
-     */
-    splitRatio?: number;
-    /**
-     * 是否启用影子 diff 记录
-     */
-    enableShadowDiff?: boolean;
-    /**
-     * 影子失败是否回退到主路（false = 影子失败不影响主路）
-     */
-    shadowFallback?: boolean;
-}
-/**
- * 解析运行模式（从环境变量）
- */
-export declare function resolveHubPipelineMode(): HubPipelineMode;
-/**
- * 解析分流比例
- */
-export declare function resolveSplitRatio(): number;
-/**
- * 解析运行时配置
- */
-export declare function resolveHubPipelineRuntimeConfig(): HubPipelineRuntimeConfig;
-/**
- * 判断是否应该使用 WASM 作为主路
- */
-export declare function shouldUseWasmPrimary(config: HubPipelineRuntimeConfig): boolean;
-/**
- * 判断是否应该运行影子管道
- */
-export declare function shouldRunShadow(config: HubPipelineRuntimeConfig): boolean;
-/**
- * 获取影子管道的实现类型
- */
-export declare function getShadowImpl(config: HubPipelineRuntimeConfig): HubPipelineImpl;
-/**
- * 根据分流比例决定使用哪种实现
- */
-export declare function selectImplBySplitRatio(requestId: string, splitRatio: number): HubPipelineImpl;

package/dist/runtime/wasm-runtime/wasm-config.js

@@ -1,124 +0,0 @@
-/**
- * WASM 运行时配置与运行模式开关
- *
- * 责任边界：
- * - Host：开关读取、影子请求分发、指标上报
- * - Core（WASM/TS）：canonicalization、routing、tools、compat、diff 协议
- *
- * 开关优先级矩阵（高 → 低）：
- * - 全局（进程级）：ROUTECODEX_HUB_PIPELINE_IMPL
- * - 租户级：config.virtualRouter.*（暂未实现）
- * - 路由级：metadata.routeHint（暂未实现）
- * - 请求级：header X-RC-Pipeline-Impl（暂未实现）
- */
-/**
- * 解析运行模式（从环境变量）
- */
-export function resolveHubPipelineMode() {
-    const raw = String(process.env.ROUTECODEX_HUB_PIPELINE_IMPL || 'ts_primary').trim().toLowerCase();
-    const validModes = [
-        'ts_primary',
-        'wasm_primary',
-        'shadow_ts',
-        'shadow_wasm',
-        'split'
-    ];
-    if (validModes.includes(raw)) {
-        return raw;
-    }
-    // 兼容旧环境变量
-    if (raw === 'ts') {
-        return 'ts_primary';
-    }
-    if (raw === 'wasm' || raw === 'engine') {
-        return 'wasm_primary';
-    }
-    if (raw === 'shadow') {
-        return 'shadow_ts';
-    }
-    console.warn(`[wasm-config] Invalid ROUTECODEX_HUB_PIPELINE_IMPL: ${raw}, fallback to ts_primary`);
-    return 'ts_primary';
-}
-/**
- * 解析分流比例
- */
-export function resolveSplitRatio() {
-    const raw = process.env.ROUTECODEX_HUB_PIPELINE_SPLIT_RATIO;
-    if (!raw) {
-        return 0.5; // 默认 50/50
-    }
-    const ratio = parseFloat(raw);
-    if (isNaN(ratio) || ratio < 0 || ratio > 1) {
-        console.warn(`[wasm-config] Invalid ROUTECODEX_HUB_PIPELINE_SPLIT_RATIO: ${raw}, fallback to 0.5`);
-        return 0.5;
-    }
-    return ratio;
-}
-/**
- * 解析运行时配置
- */
-export function resolveHubPipelineRuntimeConfig() {
-    const mode = resolveHubPipelineMode();
-    const splitRatio = mode === 'split' ? resolveSplitRatio() : undefined;
-    const enableShadowDiff = process.env.ROUTECODEX_HUB_PIPELINE_SHADOW_DIFF !== '0';
-    const shadowFallback = process.env.ROUTECODEX_HUB_PIPELINE_SHADOW_FALLBACK !== '0';
-    return {
-        mode,
-        splitRatio,
-        enableShadowDiff,
-        shadowFallback
-    };
-}
-/**
- * 判断是否应该使用 WASM 作为主路
- */
-export function shouldUseWasmPrimary(config) {
-    if (config.mode === 'wasm_primary' || config.mode === 'shadow_wasm') {
-        return true;
-    }
-    if (config.mode === 'split' && config.splitRatio !== undefined) {
-        // 使用 requestId 的哈希值进行一致性分流
-        return false; // 在请求分发时动态决定
-    }
-    return false;
-}
-/**
- * 判断是否应该运行影子管道
- */
-export function shouldRunShadow(config) {
-    return config.mode === 'shadow_ts' || config.mode === 'shadow_wasm';
-}
-/**
- * 获取影子管道的实现类型
- */
-export function getShadowImpl(config) {
-    if (config.mode === 'shadow_ts') {
-        return 'wasm';
-    }
-    if (config.mode === 'shadow_wasm') {
-        return 'ts';
-    }
-    return 'ts'; // 默认
-}
-/**
- * 根据分流比例决定使用哪种实现
- */
-export function selectImplBySplitRatio(requestId, splitRatio) {
-    // 使用 requestId 的哈希值进行一致性分流
-    const hash = simpleHash(requestId);
-    const threshold = Math.floor(hash * 1000) / 1000;
-    return threshold < splitRatio ? 'wasm' : 'ts';
-}
-/**
- * 简单哈希函数（用于一致性分流）
- */
-function simpleHash(str) {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = (hash << 5) - hash + char;
-        hash = hash & hash; // Convert to 32bit integer
-    }
-    return Math.abs(hash) / Math.pow(2, 31); // Normalize to [0, 1]
-}
-//# sourceMappingURL=wasm-config.js.map

package/dist/runtime/wasm-runtime/wasm-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasm-config.js","sourceRoot":"","sources":["../../../src/runtime/wasm-runtime/wasm-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6CH;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAElG,MAAM,UAAU,GAAsB;QACpC,YAAY;QACZ,cAAc;QACd,WAAW;QACX,aAAa;QACb,OAAO;KACR,CAAC;IAEF,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAsB,CAAC,EAAE,CAAC;QAChD,OAAO,GAAsB,CAAC;IAChC,CAAC;IAED,UAAU;IACV,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,uDAAuD,GAAG,0BAA0B,CAAC,CAAC;IACnG,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;IAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,CAAC,CAAC,WAAW;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,8DAA8D,GAAG,mBAAmB,CAAC,CAAC;QACnG,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,MAAM,IAAI,GAAG,sBAAsB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,mCAAmC,KAAK,GAAG,CAAC;IACjF,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,uCAAuC,KAAK,GAAG,CAAC;IAEnF,OAAO;QACL,IAAI;QACJ,UAAU;QACV,gBAAgB;QAChB,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC/D,2BAA2B;QAC3B,OAAO,KAAK,CAAC,CAAC,aAAa;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgC;IAC9D,OAAO,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAgC;IAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,KAAK;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,UAAkB;IAC1E,2BAA2B;IAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACjD,OAAO,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QACjC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;IACjD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB;AACjE,CAAC"}

package/dist/runtime/wasm-runtime/wasm-loader.d.ts

@@ -1,40 +0,0 @@
-/**
- * WASM HubPipeline 加载器
- * 负责从 llms-engine 包加载 WASM HubPipeline 实现并提供给 Host 使用
- */
-export type WasmHubPipelineCtor = new (config: {
-    virtualRouter: unknown;
-    [key: string]: unknown;
-}) => WasmHubPipelineInstance;
-export type WasmHubPipelineInstance = {
-    execute(request: {
-        id?: string;
-        endpoint?: string;
-        payload?: Record<string, unknown>;
-        metadata?: Record<string, unknown>;
-    }): Promise<{
-        requestId: string;
-        providerPayload: Record<string, unknown>;
-        standardizedRequest?: Record<string, unknown>;
-        processedRequest?: Record<string, unknown>;
-        routingDecision?: Record<string, unknown>;
-        routingDiagnostics?: Record<string, unknown>;
-        target?: Record<string, unknown>;
-        metadata?: Record<string, unknown>;
-        nodeResults?: Array<{
-            id: string;
-            success: boolean;
-            metadata?: Record<string, unknown>;
-            error?: unknown;
-        }>;
-    }>;
-    updateVirtualRouterConfig?(config: unknown): void;
-};
-/**
- * 加载 WASM HubPipeline 构造函数
- */
-export declare function loadWasmHubPipelineCtor(): Promise<WasmHubPipelineCtor>;
-/**
- * 清除缓存的 WASM HubPipeline 构造函数（主要用于测试）
- */
-export declare function clearWasmHubPipelineCache(): void;

package/dist/runtime/wasm-runtime/wasm-loader.js

@@ -1,62 +0,0 @@
-/**
- * WASM HubPipeline 加载器
- * 负责从 llms-engine 包加载 WASM HubPipeline 实现并提供给 Host 使用
- */
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import path from 'node:path';
-import fs from 'node:fs';
-// No sync loading needed in current wasm loader.
-let cachedWasmHubPipelineCtor = null;
-/**
- * 解析 llms-engine 包路径
- */
-function resolveWasmEnginePackageDir() {
-    let currentDir = path.dirname(fileURLToPath(import.meta.url));
-    while (true) {
-        const scope = '@jsonstudio';
-        const packageName = 'llms-engine';
-        const candidate = path.join(currentDir, 'node_modules', scope, packageName);
-        if (fs.existsSync(candidate)) {
-            return candidate;
-        }
-        const parent = path.dirname(currentDir);
-        if (parent === currentDir) {
-            break;
-        }
-        currentDir = parent;
-    }
-    throw new Error('[wasm-loader] Unable to locate llms-engine package. Please install it via npm install.');
-}
-/**
- * 加载 WASM HubPipeline 构造函数
- */
-export async function loadWasmHubPipelineCtor() {
-    if (cachedWasmHubPipelineCtor) {
-        return cachedWasmHubPipelineCtor;
-    }
-    const pkgDir = resolveWasmEnginePackageDir();
-    const hubPipelineEntry = path.join(pkgDir, 'js', 'hub-pipeline.mjs');
-    if (!fs.existsSync(hubPipelineEntry)) {
-        throw new Error(`[wasm-loader] HubPipeline entry not found at ${hubPipelineEntry}. Please verify llms-engine installation.`);
-    }
-    try {
-        const wasmModule = await import(pathToFileURL(hubPipelineEntry).href);
-        const { HubPipeline: WasmHubPipeline } = wasmModule;
-        if (typeof WasmHubPipeline !== 'function') {
-            throw new Error('[wasm-loader] HubPipeline export is not a constructor');
-        }
-        cachedWasmHubPipelineCtor = WasmHubPipeline;
-        return cachedWasmHubPipelineCtor;
-    }
-    catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        throw new Error(`[wasm-loader] Failed to load WASM HubPipeline: ${detail}`);
-    }
-}
-/**
- * 清除缓存的 WASM HubPipeline 构造函数（主要用于测试）
- */
-export function clearWasmHubPipelineCache() {
-    cachedWasmHubPipelineCtor = null;
-}
-//# sourceMappingURL=wasm-loader.js.map

package/dist/runtime/wasm-runtime/wasm-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasm-loader.js","sourceRoot":"","sources":["../../../src/runtime/wasm-runtime/wasm-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAgCzB,iDAAiD;AAEjD,IAAI,yBAAyB,GAA+B,IAAI,CAAC;AAEjE;;GAEG;AACH,SAAS,2BAA2B;IAClC,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,aAAa,CAAC;QAC5B,MAAM,WAAW,GAAG,aAAa,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM;QACR,CAAC;QACD,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,yBAAyB,EAAE,CAAC;QAC9B,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAErE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,gDAAgD,gBAAgB,2CAA2C,CAC5G,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,UAAU,CAAC;QAEpD,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,yBAAyB,GAAG,eAAsC,CAAC;QACnE,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,kDAAkD,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,yBAAyB,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/docs/antigravity-gemini-format-cleanup.md

@@ -1,143 +0,0 @@
----
-title: Antigravity Gemini 格式清理要求
-date: 2026-01-25
-tags:
-  - routecodex
-  - antigravity
-  - gemini
-  - claude
-status: active
----
-
-# Antigravity Gemini 格式清理要求（gcli2api 对齐）
-
-> [!summary]
-> 本文汇总当前 **antigravity** 走 Gemini 协议时的格式清理要求，覆盖 **Gemini 系列** 与 **Claude 系列** 的关键输出/请求规范、UA/Headers 规范、工具历史一致性要求等。
-> 本次改动已生效：历史 `functionCall` 强制补 `thoughtSignature: "skip_thought_signature_validator"`。
-
-## 1) 适用范围
-- **Gemini 系列**：`gemini-3-pro-low / gemini-3-pro-high` 等 Gemini 协议模型。
-- **Claude 系列**：`claude-*` 走 antigravity/兼容层的 Gemini 路由时的兼容字段统一。
-
----
-
-## 2) UA 与 Headers（Antigravity Tools 对齐）
-- **Antigravity 分支**：
-  - **JSON wrapper 内保留**：`requestId / requestType / userAgent / project / request`
-  - **不发送 Gemini CLI header triplet**：`x-goog-api-client / client-metadata`（避免与 Antigravity Tools 行为不一致）
-  - **不注入 session_id**（保持协议最小化）
-- **非 Antigravity 分支**（Gemini CLI 常规）：
-  - 仍可维持稳定 header triplet（用于 Gemini CLI 兼容）
-
-> [!note]
-> Antigravity 路径的 User-Agent 由 wrapper 里的 `userAgent: "antigravity"` 控制，Header 仅保留必要的 HTTP 通用头。
-
----
-
-## 3) 工具与历史一致性（核心要求）
-
-> [!important]
-> **历史中出现的工具调用必须与当前请求 tools 对齐**。历史中不得出现当前 tools 列表中不存在的工具调用。
-
-- **历史工具清理**：
-  - 对 **history 中出现但当前 tools 不存在** 的 `functionCall`/`functionResponse` 做 **移除或降级为纯文本**。
-  - 保持 **tools 列表与历史工具调用**的 **一一对应**。
-- **工具名合法性**：
-  - Gemini 对函数名字符集/形状严格校验；不合法名称需 **清理或过滤**。
-- **工具 schema 对齐**：
-  - 历史 `functionCall.args` 必须与当前工具 schema 对齐。
-  - 对 `args` 做 **结构修正**：Gemini 期望 `functionCall.args` 为对象（Struct），非对象需包 `value`。
-
----
-
-## 4) Gemini 协议的格式清理要点
-
-### 4.1 functionCall 历史补签名
-- **新增要求（已生效）**：
-  - 历史 `functionCall` **必须包含**：
-    - `thoughtSignature: "skip_thought_signature_validator"`
-  - 这是 gcli2api 的行为：即使没有真实签名，也需要该字段以通过 Cloud Code 严格校验。
-
-### 4.2 工具 schema 输出
-- **始终输出工具 schema**（Gemini 需要工具声明来校验 `functionCall`/`functionResponse`）。
-- `toolConfig.functionCallingConfig`：
-  - `NONE / ANY / ALLOWED` 按 `tool_choice` 映射。
-
-### 4.3 Content 清理
-- 统一 `contents` 结构，确保每条 entry 的 parts 合法。
-- 对无效 part 做降级或过滤，避免 Gemini 侧 malformed。
-
----
-
-## 5) Claude 系列在 Antigravity 中的兼容统一
-
-- Claude-thinking / 非 thinking 输出在 antigravity 侧 **统一形态**：
-  - 保证与 Gemini/OpenAI 响应结构一致的 **content 形状**。
-- 保持 **history/tool 行为与 Gemini 同步**（同样遵循历史工具一致性要求）。
-
----
-
-## 6) 当前已生效的关键修复（含 2026-01-26 更新）
-
-- ✅ **历史 functionCall 强制补 `thoughtSignature`**（gcli2api 行为一致）。
-- ✅ **history/tool 对齐清理**：历史工具调用不再允许与当前 tools 不一致。
-- ✅ **args 结构修正**：非对象 args 包装到 `{ value }`。
-- ✅ **UA/Headers 与 Antigravity Tools 对齐**（wrapper 保留 identity，移除 Gemini CLI triplet）。
-- ✅ **兼容层保留 wrapper 字段**：`chat:gemini` 的 `shallow_pick` 允许 `request / requestId / requestType / userAgent / project`。
-- ✅ **上游 request 不含 metadata**：避免 `Unknown name "metadata" at 'request'`。
-- ✅ **baseURL 对齐 prod**：`https://cloudcode-pa.googleapis.com`。
-
----
-
-## 6.1) Request Wrapper 结构（Antigravity）
-
-```json
-{
-  "model": "gemini-3-pro",
-  "project": "your-project-id",
-  "requestId": "agent-...",
-  "requestType": "agent|web_search|image_gen",
-  "userAgent": "antigravity",
-  "request": {
-    "contents": [...],
-    "systemInstruction": {...},
-    "tools": [...],
-    "generationConfig": {...},
-    "safetySettings": [...]
-  }
-}
-```
-
-> [!important]
-> `request` 内部 **禁止** `metadata` 字段。
-
----
-
-## 6.2) 多账号 alias 策略（Antigravity）
-
-- **默认策略**：按 **model 维度**挑选“最佳账号”（剩余配额最高）。
-- **不做轮询**：只有当该 alias 的该 model **为空** 才切换。
-- **model 空判定**：
-  - quota `<= 0`
-  - 或 **429 冷却移出账号池 ≥ 30s**
-- **数据来源**：quota 池（antigravity quota snapshot 注入到 `quotaView`）。
-- **模型族分开**：每个 model 单独选择最佳 alias。
-
-> [!note]
-> “最佳账号推荐”来自 quota 池的剩余额度排序，优先消耗高配额账号以提升稳定性与命中率。
-
----
-
-## 7) 验证方式（建议）
-
-- 对比两条请求（首条无历史、次条带历史）：
-  - `provider-request.json` 中 **`functionCall` 必须带 `thoughtSignature`**。
-  - `tools` 与历史 functionCall **必须一一对齐**。
-  - `args` 必须为对象（Struct）。
-
----
-
-## 8) 备注
-
-> [!note]
-> 本次修改已验证生效。若后续仍出现 429 或 Cloud Code 严格校验失败，优先检查 **history 中工具清理是否遗漏** 或 **functionCall/Response 的结构化字段是否存在差异**。