centient 2.20.0

package/dist/utils/RateLimiter.d.ts

@@ -0,0 +1,85 @@
+export interface RateLimiterConfig {
+    name: string;
+    maxTokens: number;
+    refillRate: number;
+    maxRequestsPerMinute?: number;
+    maxWaitMs?: number;
+    onRateLimited?: (stats: RateLimitStats) => void;
+}
+export interface RateLimitStats {
+    serviceName: string;
+    currentTokens: number;
+    maxTokens: number;
+    refillRate: number;
+    requestsThisMinute: number;
+    requestsAllowed: number;
+    requestsRejected: number;
+    totalRequests: number;
+    totalWaitTimeMs: number;
+    lastRequest: Date | null;
+    lastRefill: Date;
+    isLimited: boolean;
+}
+export declare class RateLimitError extends Error {
+    readonly serviceName: string;
+    readonly retryAfterMs: number;
+    constructor(message: string, serviceName: string, retryAfterMs: number);
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private requestsThisMinute;
+    private minuteStart;
+    private requestsAllowed;
+    private requestsRejected;
+    private totalRequests;
+    private totalWaitTimeMs;
+    private lastRequest;
+    private waitQueue;
+    private processingQueue;
+    private readonly name;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private readonly maxRequestsPerMinute;
+    private readonly maxWaitMs;
+    private readonly onRateLimited?;
+    constructor(config: RateLimiterConfig);
+    acquire(tokensNeeded?: number): Promise<void>;
+    tryAcquire(tokensNeeded?: number): boolean;
+    execute<T>(operation: () => Promise<T>, tokensNeeded?: number): Promise<T>;
+    isAllowed(tokensNeeded?: number): boolean;
+    getStats(): RateLimitStats;
+    reset(): void;
+    getWaitTimeMs(tokensNeeded?: number): number;
+    private refillBucket;
+    private checkMinuteReset;
+    private msUntilMinuteReset;
+    private consumeTokens;
+    private handleRateLimited;
+    private waitForMinuteReset;
+    private queueRequest;
+    private processQueue;
+}
+declare class RateLimiterRegistry {
+    private limiters;
+    private defaultConfig;
+    getLimiter(name: string, config?: Partial<RateLimiterConfig>): RateLimiter;
+    getAllStats(): Record<string, RateLimitStats>;
+    resetAll(): void;
+    hasLimitedServices(): boolean;
+    getLimitedServices(): string[];
+    setDefaultConfig(config: Partial<RateLimiterConfig>): void;
+    clear(): void;
+}
+export declare function getRateLimiterRegistry(): RateLimiterRegistry;
+export declare function getRateLimiter(serviceName: string, config?: Partial<RateLimiterConfig>): RateLimiter;
+export declare const ServiceRateLimiters: {
+    openaiEmbeddings: () => RateLimiter;
+    openaiChat: () => RateLimiter;
+    gemini: () => RateLimiter;
+    qdrant: () => RateLimiter;
+    googleFileSearch: () => RateLimiter;
+    openrouter: () => RateLimiter;
+};
+export {};
+//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/utils/RateLimiter.d.ts.map

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

package/dist/utils/RateLimiter.js

@@ -0,0 +1,300 @@
+export class RateLimitError extends Error {
+    serviceName;
+    retryAfterMs;
+    constructor(message, serviceName, retryAfterMs) {
+        super(message);
+        this.serviceName = serviceName;
+        this.retryAfterMs = retryAfterMs;
+        this.name = "RateLimitError";
+    }
+}
+export class RateLimiter {
+    tokens;
+    lastRefill;
+    requestsThisMinute = 0;
+    minuteStart;
+    requestsAllowed = 0;
+    requestsRejected = 0;
+    totalRequests = 0;
+    totalWaitTimeMs = 0;
+    lastRequest = null;
+    waitQueue = [];
+    processingQueue = false;
+    name;
+    maxTokens;
+    refillRate;
+    maxRequestsPerMinute;
+    maxWaitMs;
+    onRateLimited;
+    constructor(config) {
+        this.name = config.name;
+        this.maxTokens = config.maxTokens;
+        this.refillRate = config.refillRate;
+        this.maxRequestsPerMinute = config.maxRequestsPerMinute ?? Infinity;
+        this.maxWaitMs = config.maxWaitMs ?? 0;
+        this.onRateLimited = config.onRateLimited;
+        this.tokens = this.maxTokens;
+        this.lastRefill = new Date();
+        this.minuteStart = new Date();
+    }
+    async acquire(tokensNeeded = 1) {
+        this.totalRequests++;
+        this.lastRequest = new Date();
+        this.refillBucket();
+        this.checkMinuteReset();
+        if (this.requestsThisMinute >= this.maxRequestsPerMinute) {
+            const waitMs = this.msUntilMinuteReset();
+            if (this.maxWaitMs > 0 && waitMs <= this.maxWaitMs) {
+                await this.waitForMinuteReset(waitMs);
+            }
+            else {
+                this.handleRateLimited(waitMs);
+                throw new RateLimitError(`Rate limited: ${this.name} exceeded ${this.maxRequestsPerMinute} requests/minute`, this.name, waitMs);
+            }
+        }
+        if (this.tokens >= tokensNeeded) {
+            this.consumeTokens(tokensNeeded);
+            return;
+        }
+        const tokensShort = tokensNeeded - this.tokens;
+        const waitMs = Math.ceil((tokensShort / this.refillRate) * 1000);
+        if (this.maxWaitMs > 0 && waitMs <= this.maxWaitMs) {
+            await this.queueRequest(tokensNeeded, waitMs);
+        }
+        else {
+            this.handleRateLimited(waitMs);
+            throw new RateLimitError(`Rate limited: ${this.name} needs ${tokensNeeded} tokens, has ${Math.floor(this.tokens)}`, this.name, waitMs);
+        }
+    }
+    tryAcquire(tokensNeeded = 1) {
+        this.totalRequests++;
+        this.lastRequest = new Date();
+        this.refillBucket();
+        this.checkMinuteReset();
+        if (this.requestsThisMinute >= this.maxRequestsPerMinute) {
+            this.handleRateLimited(this.msUntilMinuteReset());
+            return false;
+        }
+        if (this.tokens >= tokensNeeded) {
+            this.consumeTokens(tokensNeeded);
+            return true;
+        }
+        const tokensShort = tokensNeeded - this.tokens;
+        const waitMs = Math.ceil((tokensShort / this.refillRate) * 1000);
+        this.handleRateLimited(waitMs);
+        return false;
+    }
+    async execute(operation, tokensNeeded = 1) {
+        await this.acquire(tokensNeeded);
+        return operation();
+    }
+    isAllowed(tokensNeeded = 1) {
+        this.refillBucket();
+        this.checkMinuteReset();
+        return (this.requestsThisMinute < this.maxRequestsPerMinute &&
+            this.tokens >= tokensNeeded);
+    }
+    getStats() {
+        this.refillBucket();
+        this.checkMinuteReset();
+        return {
+            serviceName: this.name,
+            currentTokens: Math.floor(this.tokens),
+            maxTokens: this.maxTokens,
+            refillRate: this.refillRate,
+            requestsThisMinute: this.requestsThisMinute,
+            requestsAllowed: this.requestsAllowed,
+            requestsRejected: this.requestsRejected,
+            totalRequests: this.totalRequests,
+            totalWaitTimeMs: this.totalWaitTimeMs,
+            lastRequest: this.lastRequest,
+            lastRefill: this.lastRefill,
+            isLimited: !this.isAllowed(),
+        };
+    }
+    reset() {
+        this.tokens = this.maxTokens;
+        this.lastRefill = new Date();
+        this.requestsThisMinute = 0;
+        this.minuteStart = new Date();
+        this.waitQueue = [];
+    }
+    getWaitTimeMs(tokensNeeded = 1) {
+        this.refillBucket();
+        this.checkMinuteReset();
+        if (this.requestsThisMinute >= this.maxRequestsPerMinute) {
+            return this.msUntilMinuteReset();
+        }
+        if (this.tokens >= tokensNeeded) {
+            return 0;
+        }
+        const tokensShort = tokensNeeded - this.tokens;
+        return Math.ceil((tokensShort / this.refillRate) * 1000);
+    }
+    refillBucket() {
+        const now = new Date();
+        const elapsedMs = now.getTime() - this.lastRefill.getTime();
+        const tokensToAdd = (elapsedMs / 1000) * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    checkMinuteReset() {
+        const now = new Date();
+        if (now.getTime() - this.minuteStart.getTime() >= 60000) {
+            this.requestsThisMinute = 0;
+            this.minuteStart = now;
+        }
+    }
+    msUntilMinuteReset() {
+        const elapsed = Date.now() - this.minuteStart.getTime();
+        return Math.max(0, 60000 - elapsed);
+    }
+    consumeTokens(tokensNeeded) {
+        this.tokens -= tokensNeeded;
+        this.requestsThisMinute++;
+        this.requestsAllowed++;
+    }
+    handleRateLimited(waitMs) {
+        this.requestsRejected++;
+        this.onRateLimited?.(this.getStats());
+        console.error(`[RateLimiter] ${this.name}: Rate limited (retry after ${waitMs}ms)`);
+    }
+    async waitForMinuteReset(waitMs) {
+        this.totalWaitTimeMs += waitMs;
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        this.checkMinuteReset();
+    }
+    async queueRequest(tokensNeeded, estimatedWaitMs) {
+        return new Promise((resolve, reject) => {
+            this.waitQueue.push({ resolve, reject, tokensNeeded });
+            this.totalWaitTimeMs += estimatedWaitMs;
+            if (!this.processingQueue) {
+                this.processQueue();
+            }
+        });
+    }
+    async processQueue() {
+        if (this.processingQueue)
+            return;
+        this.processingQueue = true;
+        while (this.waitQueue.length > 0) {
+            const request = this.waitQueue[0];
+            if (!request)
+                break;
+            this.refillBucket();
+            this.checkMinuteReset();
+            if (this.tokens >= request.tokensNeeded &&
+                this.requestsThisMinute < this.maxRequestsPerMinute) {
+                this.consumeTokens(request.tokensNeeded);
+                this.waitQueue.shift();
+                request.resolve();
+            }
+            else {
+                const tokensShort = Math.max(0, request.tokensNeeded - this.tokens);
+                const waitMs = Math.max(100, Math.ceil((tokensShort / this.refillRate) * 1000));
+                await new Promise((resolve) => setTimeout(resolve, waitMs));
+            }
+        }
+        this.processingQueue = false;
+    }
+}
+class RateLimiterRegistry {
+    limiters = new Map();
+    defaultConfig = {
+        maxTokens: 100,
+        refillRate: 10,
+        maxWaitMs: 5000,
+    };
+    getLimiter(name, config) {
+        let limiter = this.limiters.get(name);
+        if (!limiter) {
+            limiter = new RateLimiter({
+                name,
+                ...this.defaultConfig,
+                ...config,
+            });
+            this.limiters.set(name, limiter);
+        }
+        return limiter;
+    }
+    getAllStats() {
+        const stats = {};
+        for (const [name, limiter] of this.limiters) {
+            stats[name] = limiter.getStats();
+        }
+        return stats;
+    }
+    resetAll() {
+        for (const limiter of this.limiters.values()) {
+            limiter.reset();
+        }
+    }
+    hasLimitedServices() {
+        for (const limiter of this.limiters.values()) {
+            if (limiter.getStats().isLimited)
+                return true;
+        }
+        return false;
+    }
+    getLimitedServices() {
+        const limited = [];
+        for (const [name, limiter] of this.limiters) {
+            if (limiter.getStats().isLimited) {
+                limited.push(name);
+            }
+        }
+        return limited;
+    }
+    setDefaultConfig(config) {
+        this.defaultConfig = { ...this.defaultConfig, ...config };
+    }
+    clear() {
+        this.limiters.clear();
+    }
+}
+const registry = new RateLimiterRegistry();
+export function getRateLimiterRegistry() {
+    return registry;
+}
+export function getRateLimiter(serviceName, config) {
+    return registry.getLimiter(serviceName, config);
+}
+export const ServiceRateLimiters = {
+    openaiEmbeddings: () => getRateLimiter("openai-embeddings", {
+        maxTokens: 100,
+        refillRate: 50,
+        maxRequestsPerMinute: 3000,
+        maxWaitMs: 5000,
+    }),
+    openaiChat: () => getRateLimiter("openai-chat", {
+        maxTokens: 20,
+        refillRate: 5,
+        maxRequestsPerMinute: 300,
+        maxWaitMs: 10000,
+    }),
+    gemini: () => getRateLimiter("gemini", {
+        maxTokens: 50,
+        refillRate: 15,
+        maxRequestsPerMinute: 900,
+        maxWaitMs: 5000,
+    }),
+    qdrant: () => getRateLimiter("qdrant", {
+        maxTokens: 200,
+        refillRate: 100,
+        maxRequestsPerMinute: 6000,
+        maxWaitMs: 2000,
+    }),
+    googleFileSearch: () => getRateLimiter("google-file-search", {
+        maxTokens: 20,
+        refillRate: 5,
+        maxRequestsPerMinute: 300,
+        maxWaitMs: 10000,
+    }),
+    openrouter: () => getRateLimiter("openrouter", {
+        maxTokens: 50,
+        refillRate: 20,
+        maxRequestsPerMinute: 1200,
+        maxWaitMs: 10000,
+    }),
+};
+//# sourceMappingURL=RateLimiter.js.map

package/dist/utils/RateLimiter.js.map

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

package/dist/utils/RecoveryEngine.d.ts

@@ -0,0 +1,45 @@
+import { SessionCoordinator } from "./SessionCoordinator.js";
+import { StuckPattern } from "./StuckDetector.js";
+export interface RecoverySuggestion {
+    title: string;
+    description: string;
+    source: "current_session" | "past_session" | "pattern_library";
+    relevanceScore: number;
+    implementation: {
+        steps: string[];
+        codeExample?: string;
+        references: string[];
+    };
+    metadata: {
+        sessionId?: string;
+        timestamp?: string;
+        successRate?: number;
+    };
+}
+export interface RecoveryAnalysis {
+    stuckPattern: StuckPattern;
+    suggestions: RecoverySuggestion[];
+    searchDuration: {
+        qdrant: number;
+        googleFS: number;
+        total: number;
+    };
+}
+export declare class RecoveryEngine {
+    private coordinator;
+    private projectPath;
+    private googleAI;
+    constructor(coordinator: SessionCoordinator, projectPath: string);
+    generateSuggestions(stuckPattern: StuckPattern, limit?: number): Promise<RecoveryAnalysis>;
+    private buildSearchQuery;
+    private searchCurrentSession;
+    private searchHistoricalSessions;
+    private extractSessionIdFromChunks;
+    private extractSessionIdFromUri;
+    private rankSuggestions;
+    private calculateRecencyScore;
+    private extractTitle;
+    private extractSteps;
+    private extractCodeExample;
+}
+//# sourceMappingURL=RecoveryEngine.d.ts.map

package/dist/utils/RecoveryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryEngine.d.ts","sourceRoot":"","sources":["../../src/utils/RecoveryEngine.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,CAAC;IAC/D,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,cAAc,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAA4B;gBAEhC,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM;IAc1D,mBAAmB,CACvB,YAAY,EAAE,YAAY,EAC1B,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,gBAAgB,CAAC;IAmD5B,OAAO,CAAC,gBAAgB;YAwBV,oBAAoB;YAuCpB,wBAAwB;IAwHtC,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,kBAAkB;CAe3B"}