@jsonstudio/rcc 0.89.683 → 0.89.912

package/dist/manager/modules/token/index.d.ts

@@ -0,0 +1,10 @@
+import type { ManagerContext, ManagerModule } from '../../types.js';
+export declare class TokenManagerModule implements ManagerModule {
+    readonly id = "token";
+    private daemon;
+    private ownerId;
+    private isLeader;
+    init(context: ManagerContext): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}

package/dist/manager/modules/token/index.js

@@ -0,0 +1,58 @@
+import { TokenDaemon } from '../../../token-daemon/token-daemon.js';
+import { releaseTokenManagerLeader, tryAcquireTokenManagerLeader } from '../../../token-daemon/leader-lock.js';
+export class TokenManagerModule {
+    id = 'token';
+    daemon = null;
+    ownerId = null;
+    isLeader = false;
+    async init(context) {
+        // 使用 serverId 构造稳定 ownerId，便于区分不同服务器实例。
+        this.ownerId = `server:${context.serverId}`;
+    }
+    async start() {
+        if (this.daemon || !this.ownerId) {
+            return;
+        }
+        const { isLeader, leader } = await tryAcquireTokenManagerLeader(this.ownerId);
+        if (!isLeader) {
+            const owner = leader?.ownerId ?? 'unknown';
+            const pid = leader?.pid ?? 'unknown';
+            // 仅日志提示，避免重复刷新同一批 token。
+            // eslint-disable-next-line no-console
+            console.log(`[TokenManagerModule] Token manager leader already active (owner=${owner}, pid=${pid}); skipping TokenDaemon in this process.`);
+            this.isLeader = false;
+            return;
+        }
+        const intervalSec = readPositiveNumberFromEnv('ROUTECODEX_TOKEN_INTERVAL_SEC', 60);
+        // 默认不提前刷新；仅在 token 已过期时刷新。
+        const aheadMinutes = readPositiveNumberFromEnv('ROUTECODEX_TOKEN_REFRESH_AHEAD_MIN', 0);
+        this.daemon = new TokenDaemon({
+            intervalMs: intervalSec * 1000,
+            refreshAheadMinutes: aheadMinutes
+        });
+        this.isLeader = true;
+        await this.daemon.start();
+    }
+    async stop() {
+        if (this.daemon) {
+            this.daemon.stop();
+            this.daemon = null;
+        }
+        if (this.isLeader && this.ownerId) {
+            await releaseTokenManagerLeader(this.ownerId);
+            this.isLeader = false;
+        }
+    }
+}
+function readPositiveNumberFromEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw) {
+        return fallback;
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return fallback;
+    }
+    return parsed;
+}
+//# sourceMappingURL=index.js.map

package/dist/manager/modules/token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/manager/modules/token/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAE9C,MAAM,OAAO,kBAAkB;IACpB,EAAE,GAAG,OAAO,CAAC;IACd,MAAM,GAAuB,IAAI,CAAC;IAClC,OAAO,GAAkB,IAAI,CAAC;IAC9B,QAAQ,GAAY,KAAK,CAAC;IAElC,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,wCAAwC;QACxC,IAAI,CAAC,OAAO,GAAG,UAAU,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,MAAM,EAAE,OAAO,IAAI,SAAS,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC;YACrC,yBAAyB;YACzB,sCAAsC;YACtC,OAAO,CAAC,GAAG,CACT,mEAAmE,KAAK,SAAS,GAAG,0CAA0C,CAC/H,CAAC;YACF,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QACnF,2BAA2B;QAC3B,MAAM,YAAY,GAAG,yBAAyB,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC;YAC5B,UAAU,EAAE,WAAW,GAAG,IAAI;YAC9B,mBAAmB,EAAE,YAAY;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,SAAS,yBAAyB,CAAC,IAAY,EAAE,QAAgB;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/manager/storage/base-store.d.ts

@@ -0,0 +1,6 @@
+export interface StateStore<TSnapshot, TEvent = unknown> {
+    load(): Promise<TSnapshot | null>;
+    save(snapshot: TSnapshot): Promise<void>;
+    append?(event: TEvent): Promise<void>;
+    compact?(): Promise<void>;
+}

package/dist/manager/storage/base-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-store.js.map

package/dist/manager/storage/base-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-store.js","sourceRoot":"","sources":["../../../src/manager/storage/base-store.ts"],"names":[],"mappings":""}

package/dist/manager/storage/file-store.d.ts

@@ -0,0 +1,25 @@
+import type { StateStore } from './base-store.js';
+export interface FileStoreOptions {
+    filePath: string;
+    /**
+     * 最大事件保留时长（毫秒）。超出该时间窗口的旧事件会在 compact 时被丢弃。
+     * 若未设置或 <=0，则不按时间裁剪。
+     */
+    maxAgeMs?: number;
+    /**
+     * 单个文件中最多保留的事件条数（不含最新快照）。
+     * 若未设置或 <=0，则不按数量裁剪。
+     */
+    maxEvents?: number;
+}
+export declare class JsonlFileStore<TSnapshot, TEvent = unknown> implements StateStore<TSnapshot, TEvent> {
+    private readonly filePath;
+    private readonly maxAgeMs;
+    private readonly maxEvents;
+    constructor(options: FileStoreOptions);
+    load(): Promise<TSnapshot | null>;
+    save(snapshot: TSnapshot): Promise<void>;
+    append(event: TEvent): Promise<void>;
+    compact(): Promise<void>;
+    private appendLine;
+}

package/dist/manager/storage/file-store.js

@@ -0,0 +1,117 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export class JsonlFileStore {
+    filePath;
+    maxAgeMs;
+    maxEvents;
+    constructor(options) {
+        this.filePath = options.filePath;
+        this.maxAgeMs = typeof options.maxAgeMs === 'number' && options.maxAgeMs > 0 ? options.maxAgeMs : undefined;
+        this.maxEvents = typeof options.maxEvents === 'number' && options.maxEvents > 0 ? options.maxEvents : undefined;
+    }
+    async load() {
+        try {
+            const raw = await fs.readFile(this.filePath, 'utf8');
+            if (!raw.trim()) {
+                return null;
+            }
+            const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
+            for (let idx = lines.length - 1; idx >= 0; idx -= 1) {
+                const line = lines[idx];
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed && parsed.kind === 'snapshot' && parsed.snapshot !== undefined) {
+                        return parsed.snapshot;
+                    }
+                }
+                catch {
+                    // ignore parse errors for individual lines
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(snapshot) {
+        const envelope = {
+            kind: 'snapshot',
+            timestamp: Date.now(),
+            snapshot
+        };
+        await this.appendLine(envelope);
+    }
+    async append(event) {
+        const envelope = {
+            kind: 'event',
+            timestamp: Date.now(),
+            event
+        };
+        await this.appendLine(envelope);
+    }
+    async compact() {
+        try {
+            const raw = await fs.readFile(this.filePath, 'utf8');
+            const lines = raw
+                .split(/\r?\n/)
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0);
+            if (!lines.length) {
+                return;
+            }
+            const envelopes = [];
+            for (const line of lines) {
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed && typeof parsed.timestamp === 'number') {
+                        envelopes.push(parsed);
+                    }
+                }
+                catch {
+                    // 忽略单行解析错误
+                }
+            }
+            if (!envelopes.length) {
+                return;
+            }
+            // 保留最后一个快照
+            const snapshots = envelopes.filter((entry) => entry.kind === 'snapshot');
+            const lastSnapshot = snapshots.length ? snapshots[snapshots.length - 1] : undefined;
+            // 事件按时间与数量窗口裁剪
+            const now = Date.now();
+            let events = envelopes.filter((entry) => entry.kind === 'event');
+            if (this.maxAgeMs) {
+                const cutoff = now - this.maxAgeMs;
+                events = events.filter((entry) => entry.timestamp >= cutoff);
+            }
+            if (this.maxEvents && events.length > this.maxEvents) {
+                events = events.slice(-this.maxEvents);
+            }
+            const next = [];
+            if (lastSnapshot) {
+                next.push(lastSnapshot);
+            }
+            next.push(...events);
+            const dir = path.dirname(this.filePath);
+            await fs.mkdir(dir, { recursive: true });
+            const payload = next.map((entry) => JSON.stringify(entry)).join('\n') + '\n';
+            await fs.writeFile(this.filePath, payload, 'utf8');
+        }
+        catch {
+            // 压缩失败不影响主流程
+        }
+    }
+    async appendLine(payload) {
+        try {
+            const dir = path.dirname(this.filePath);
+            await fs.mkdir(dir, { recursive: true });
+            const line = `${JSON.stringify(payload)}\n`;
+            await fs.appendFile(this.filePath, line, 'utf8');
+        }
+        catch {
+            // 持久化失败不应影响主流程；吞掉错误。
+        }
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/manager/storage/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../../src/manager/storage/file-store.ts"],"names":[],"mappings":"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"}

package/dist/manager/types.d.ts

@@ -0,0 +1,9 @@
+export interface ManagerContext {
+    serverId: string;
+}
+export interface ManagerModule {
+    id: string;
+    init(context: ManagerContext): Promise<void> | void;
+    start(): Promise<void> | void;
+    stop(): Promise<void> | void;
+}

package/dist/manager/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/manager/types.ts"],"names":[],"mappings":""}

package/dist/message-center/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MessageCenter Index
+ * 导出 MessageCenter 相关类型和工具
+ */
+export { MessageCenter, type MessageHandler, type Topic, type TopicPattern, type Subscription, type PublishOptions, type MessageCenterOptions } from './message-center.js';

package/dist/message-center/index.js

@@ -0,0 +1,6 @@
+/**
+ * MessageCenter Index
+ * 导出 MessageCenter 相关类型和工具
+ */
+export { MessageCenter } from './message-center.js';
+//# sourceMappingURL=index.js.map

package/dist/message-center/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/message-center/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAyH,MAAM,qBAAqB,CAAC"}

package/dist/message-center/message-center.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MessageCenter - 主题订阅与消息路由系统
+ *
+ * 提供发布/订阅模式的消息总线，支持主题通配符、
+ * 消息过滤、订阅者隔离等功能
+ */
+export type Topic = string;
+export type TopicPattern = string;
+export type MessageHandler<T = unknown> = (message: T, topic: string) => void | Promise<void>;
+export interface Subscription<T = unknown> {
+    id: string;
+    pattern: TopicPattern;
+    handler: MessageHandler<T>;
+    once?: boolean;
+}
+export interface PublishOptions {
+    /**
+     * 是否异步执行订阅者回调
+     */
+    async?: boolean;
+    /**
+     * 订阅者执行超时时间（毫秒）
+     */
+    timeout?: number;
+}
+export interface MessageCenterOptions {
+    /**
+     * 是否启用调试日志
+     */
+    debug?: boolean;
+    /**
+     * 订阅者默认超时时间（毫秒）
+     */
+    defaultHandlerTimeout?: number;
+}
+export declare class MessageCenter {
+    private subscriptions;
+    private subscriptionIdCounter;
+    private readonly options;
+    private readonly debug;
+    constructor(options?: Partial<MessageCenterOptions>);
+    /**
+     * 发布消息到指定主题
+     */
+    publish<T = unknown>(topic: Topic, message: T, options?: PublishOptions): Promise<void>;
+    /**
+     * 订阅主题（支持通配符）
+     *
+     * 通配符规则:
+     * - `*` 匹配所有主题
+     * - `foo:*` 匹配 `foo:` 开头的所有主题
+     * - `foo.bar` 精确匹配 `foo.bar`
+     */
+    subscribe<T = unknown>(pattern: TopicPattern, handler: MessageHandler<T>, options?: {
+        once?: boolean;
+    }): string;
+    /**
+     * 取消订阅
+     */
+    unsubscribe(subscriptionId: string): boolean;
+    /**
+     * 取消指定模式的所有订阅
+     */
+    unsubscribeByPattern(pattern: TopicPattern): number;
+    /**
+     * 获取所有订阅信息（用于调试）
+     */
+    getSubscriptions(): Array<{
+        topic: Topic;
+        count: number;
+        patterns: TopicPattern[];
+    }>;
+    /**
+     * 清除所有订阅
+     */
+    clear(): void;
+    /**
+     * 查找匹配指定主题的订阅
+     */
+    private findSubscriptions;
+    /**
+     * 判断订阅模式是否匹配目标主题
+     */
+    private matchPattern;
+    /**
+     * 解析主题模式
+     */
+    private parsePattern;
+    /**
+     * 生成订阅 ID
+     */
+    private generateSubscriptionId;
+}

package/dist/message-center/message-center.js

@@ -0,0 +1,189 @@
+/**
+ * MessageCenter - 主题订阅与消息路由系统
+ *
+ * 提供发布/订阅模式的消息总线，支持主题通配符、
+ * 消息过滤、订阅者隔离等功能
+ */
+export class MessageCenter {
+    subscriptions = new Map();
+    subscriptionIdCounter = 0;
+    options;
+    debug;
+    constructor(options) {
+        this.options = {
+            debug: false,
+            defaultHandlerTimeout: 5000,
+            ...options
+        };
+        this.debug = (msg) => {
+            if (this.options.debug) {
+                console.log(`[MessageCenter] ${msg}`);
+            }
+        };
+    }
+    /**
+     * 发布消息到指定主题
+     */
+    async publish(topic, message, options) {
+        this.debug(`Publishing to topic: ${topic}`);
+        const subscriptions = this.findSubscriptions(topic);
+        if (subscriptions.size === 0) {
+            this.debug(`No subscribers for topic: ${topic}`);
+            return;
+        }
+        const { async: isAsync, timeout = this.options.defaultHandlerTimeout } = options || {};
+        const results = [];
+        for (const subscription of subscriptions) {
+            try {
+                const handlerPromise = subscription.handler(message, subscription.pattern);
+                const wrappedPromise = isAsync
+                    ? handlerPromise
+                    : Promise.resolve(handlerPromise);
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error(`Handler timeout after ${timeout}ms`)), timeout);
+                });
+                const result = Promise.race([wrappedPromise, timeoutPromise]);
+                results.push(result);
+                if (subscription.once) {
+                    this.unsubscribe(subscription.id);
+                }
+            }
+            catch (error) {
+                this.debug(`Handler error for topic ${subscription.pattern}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        Promise.all(results);
+        this.debug(`Published to ${subscriptions.size} subscribers for topic: ${topic}`);
+    }
+    /**
+     * 订阅主题（支持通配符）
+     *
+     * 通配符规则:
+     * - `*` 匹配所有主题
+     * - `foo:*` 匹配 `foo:` 开头的所有主题
+     * - `foo.bar` 精确匹配 `foo.bar`
+     */
+    subscribe(pattern, handler, options) {
+        const subscription = {
+            id: this.generateSubscriptionId(),
+            pattern,
+            handler,
+            once: options?.once
+        };
+        const { topic, isWildcard } = this.parsePattern(pattern);
+        if (!this.subscriptions.has(topic)) {
+            this.subscriptions.set(topic, new Set());
+        }
+        this.subscriptions.get(topic).add(subscription);
+        this.debug(`Subscribed to pattern: ${pattern} (topic: ${topic}, wildcard: ${isWildcard})`);
+        return subscription.id;
+    }
+    /**
+     * 取消订阅
+     */
+    unsubscribe(subscriptionId) {
+        for (const [topic, subscriptions] of this.subscriptions.entries()) {
+            for (const subscription of subscriptions) {
+                if (subscription.id === subscriptionId) {
+                    subscriptions.delete(subscription);
+                    if (subscriptions.size === 0) {
+                        this.subscriptions.delete(topic);
+                    }
+                    this.debug(`Unsubscribed ${subscriptionId} from ${subscription.pattern}`);
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * 取消指定模式的所有订阅
+     */
+    unsubscribeByPattern(pattern) {
+        let count = 0;
+        for (const [topic, subscriptions] of this.subscriptions.entries()) {
+            const toRemove = [];
+            for (const subscription of subscriptions) {
+                if (subscription.pattern === pattern) {
+                    toRemove.push(subscription);
+                }
+            }
+            for (const subscription of toRemove) {
+                subscriptions.delete(subscription);
+                count++;
+            }
+            if (subscriptions.size === 0) {
+                this.subscriptions.delete(topic);
+            }
+        }
+        this.debug(`Unsubscribed ${count} subscriptions for pattern: ${pattern}`);
+        return count;
+    }
+    /**
+     * 获取所有订阅信息（用于调试）
+     */
+    getSubscriptions() {
+        const result = [];
+        for (const [topic, subscriptions] of this.subscriptions.entries()) {
+            const patterns = [];
+            for (const subscription of subscriptions) {
+                patterns.push(subscription.pattern);
+            }
+            result.push({ topic, count: subscriptions.size, patterns });
+        }
+        return result;
+    }
+    /**
+     * 清除所有订阅
+     */
+    clear() {
+        this.subscriptions.clear();
+        this.debug('All subscriptions cleared');
+    }
+    /**
+     * 查找匹配指定主题的订阅
+     */
+    findSubscriptions(topic) {
+        const result = new Set();
+        for (const [subTopic, subscriptions] of this.subscriptions.entries()) {
+            if (this.matchPattern(subTopic, topic)) {
+                for (const subscription of subscriptions) {
+                    result.add(subscription);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 判断订阅模式是否匹配目标主题
+     */
+    matchPattern(pattern, target) {
+        if (pattern === '*') {
+            return true;
+        }
+        if (pattern.includes('*')) {
+            const prefix = pattern.replace(/\*$/, '');
+            return target.startsWith(prefix);
+        }
+        return pattern === target;
+    }
+    /**
+     * 解析主题模式
+     */
+    parsePattern(pattern) {
+        if (pattern === '*') {
+            return { topic: '*', isWildcard: true };
+        }
+        if (pattern.endsWith('*')) {
+            return { topic: pattern.replace(/\*$/, ''), isWildcard: true };
+        }
+        return { topic: pattern, isWildcard: false };
+    }
+    /**
+     * 生成订阅 ID
+     */
+    generateSubscriptionId() {
+        return `sub_${++this.subscriptionIdCounter}_${Date.now()}`;
+    }
+}
+//# sourceMappingURL=message-center.js.map

package/dist/message-center/message-center.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-center.js","sourceRoot":"","sources":["../../src/message-center/message-center.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,MAAM,OAAO,aAAa;IAChB,aAAa,GAA2C,IAAI,GAAG,EAAE,CAAC;IAClE,qBAAqB,GAAG,CAAC,CAAC;IACjB,OAAO,CAAuB;IAC9B,KAAK,CAAwB;IAE9C,YAAY,OAAuC;QACjD,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,KAAK;YACZ,qBAAqB,EAAE,IAAI;YAC3B,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE;YAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAY,EACZ,OAAU,EACV,OAAwB;QAExB,IAAI,CAAC,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;QAE5C,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEpD,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACvF,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC3E,MAAM,cAAc,GAAG,OAAO;oBAC5B,CAAC,CAAC,cAAc;oBAChB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;gBAEpC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAU,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBACxD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,OAAO,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACrF,CAAC,CAAC,CAAC;gBAEH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;gBAE9D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAErB,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;oBACtB,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CACR,2BAA2B,YAAY,CAAC,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,gBAAgB,aAAa,CAAC,IAAI,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CACP,OAAqB,EACrB,OAA0B,EAC1B,OAA4B;QAE5B,MAAM,YAAY,GAAoB;YACpC,EAAE,EAAE,IAAI,CAAC,sBAAsB,EAAE;YACjC,OAAO;YACP,OAAO;YACP,IAAI,EAAE,OAAO,EAAE,IAAI;SACpB,CAAC;QAEF,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,YAAqC,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,CACR,0BAA0B,OAAO,YAAY,KAAK,eAAe,UAAU,GAAG,CAC/E,CAAC;QAEF,OAAO,YAAY,CAAC,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,cAAsB;QAChC,KAAK,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAClE,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,IAAI,YAAY,CAAC,EAAE,KAAK,cAAc,EAAE,CAAC;oBACvC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACnC,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;wBAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACnC,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,gBAAgB,cAAc,SAAS,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC1E,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,OAAqB;QACxC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAClE,MAAM,QAAQ,GAA4B,EAAE,CAAC;YAE7C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,IAAI,YAAY,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBACrC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YAED,KAAK,MAAM,YAAY,IAAI,QAAQ,EAAE,CAAC;gBACpC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBACnC,KAAK,EAAE,CAAC;YACV,CAAC;YAED,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,gBAAgB,KAAK,+BAA+B,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,MAAM,GAAqE,EAAE,CAAC;QAEpF,KAAK,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAmB,EAAE,CAAC;YACpC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,KAAY;QACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;QAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YACrE,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;gBACvC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;oBACzC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAAc,EAAE,MAAa;QAChD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,KAAK,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAAqB;QACxC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACjE,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACK,sBAAsB;QAC5B,OAAO,OAAO,EAAE,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC7D,CAAC;CACF"}

package/dist/providers/auth/antigravity-userinfo-helper.d.ts

@@ -3,8 +3,10 @@
  * Mirrors the logic implemented in gcli2api for resolving project metadata.
  */
 export declare function fetchAntigravityProjectId(accessToken: string, apiBase?: string): Promise<string | undefined>;
+export declare function buildAntigravityHeaders(accessToken: string): Record<string, string>;
 export declare function resolveAntigravityApiBase(explicit?: string): string;
 export declare const ANTIGRAVITY_HELPER_DEFAULTS: {
     apiBase: string;
     userAgent: string;
 };
+export declare function ensureAntigravityTokenProjectMetadata(tokenFilePath: string, apiBaseHint?: string): Promise<boolean>;