@recallbricks/runtime 0.2.0

package/dist/core/RateLimiter.d.ts

@@ -0,0 +1,39 @@
+import { Logger } from '../types';
+export interface RateLimiterConfig {
+    maxRequests: number;
+    windowMs: number;
+    strategy: 'sliding-window' | 'token-bucket' | 'fixed-window';
+    keyGenerator?: (context: unknown) => string;
+    skipSuccessfulRequests?: boolean;
+    skipFailedRequests?: boolean;
+}
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    resetTime: number;
+    retryAfter?: number;
+}
+export declare class RateLimitExceededError extends Error {
+    info: RateLimitInfo;
+    constructor(info: RateLimitInfo, key?: string);
+}
+export declare class RateLimiter {
+    private config;
+    private logger;
+    private limiter;
+    private cleanupInterval;
+    constructor(config: RateLimiterConfig, logger: Logger);
+    execute<T>(fn: () => Promise<T>, context?: unknown): Promise<T>;
+    check(context?: unknown): RateLimitInfo;
+    reset(key: string): void;
+    destroy(): void;
+}
+export declare class RateLimiterManager {
+    private logger;
+    private limiters;
+    constructor(logger: Logger);
+    getOrCreate(name: string, config: Partial<RateLimiterConfig>): RateLimiter;
+    getAll(): Map<string, RateLimiter>;
+    destroyAll(): void;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/core/RateLimiter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,GAAG,cAAc,GAAG,cAAc,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,sBAAuB,SAAQ,KAAK;IAEtC,IAAI,EAAE,aAAa;gBAAnB,IAAI,EAAE,aAAa,EAC1B,GAAG,CAAC,EAAE,MAAM;CASf;AAiMD,qBAAa,WAAW;IAQpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,OAAO,CAGQ;IACvB,OAAO,CAAC,eAAe,CAAiB;gBAG9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM;IAqClB,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC;IAuCb,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa;IAYvC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQxB,OAAO,IAAI,IAAI;CAIhB;AAMD,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAkC;gBAE9B,MAAM,EAAE,MAAM;IAKlC,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACjC,WAAW;IAoBd,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAOlC,UAAU,IAAI,IAAI;CAOnB"}

package/dist/core/RateLimiter.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiterManager = exports.RateLimiter = exports.RateLimitExceededError = void 0;
+class RateLimitExceededError extends Error {
+    constructor(info, key) {
+        super(`Rate limit exceeded for ${key || 'default'}. ` +
+            `Limit: ${info.limit}, Remaining: ${info.remaining}, ` +
+            `Reset at: ${new Date(info.resetTime).toISOString()}`);
+        this.info = info;
+        this.name = 'RateLimitExceededError';
+    }
+}
+exports.RateLimitExceededError = RateLimitExceededError;
+class SlidingWindowLimiter {
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+        this.requests = new Map();
+    }
+    tryAcquire(key) {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        const requestTimes = this.requests.get(key) || [];
+        const validRequests = requestTimes.filter((time) => time > windowStart);
+        const allowed = validRequests.length < this.maxRequests;
+        const resetTime = validRequests.length > 0
+            ? validRequests[0] + this.windowMs
+            : now + this.windowMs;
+        if (allowed) {
+            validRequests.push(now);
+            this.requests.set(key, validRequests);
+        }
+        return {
+            allowed,
+            info: {
+                limit: this.maxRequests,
+                remaining: Math.max(0, this.maxRequests - validRequests.length),
+                resetTime,
+                retryAfter: allowed ? undefined : resetTime - now,
+            },
+        };
+    }
+    reset(key) {
+        this.requests.delete(key);
+    }
+    cleanup() {
+        const now = Date.now();
+        const windowStart = now - this.windowMs;
+        for (const [key, times] of this.requests) {
+            const validRequests = times.filter((time) => time > windowStart);
+            if (validRequests.length === 0) {
+                this.requests.delete(key);
+            }
+            else {
+                this.requests.set(key, validRequests);
+            }
+        }
+    }
+}
+class TokenBucketLimiter {
+    constructor(maxTokens, refillRate, refillInterval = 1000) {
+        this.maxTokens = maxTokens;
+        this.refillRate = refillRate;
+        this.refillInterval = refillInterval;
+        this.buckets = new Map();
+    }
+    tryAcquire(key) {
+        const now = Date.now();
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = { tokens: this.maxTokens, lastRefill: now };
+            this.buckets.set(key, bucket);
+        }
+        const timePassed = now - bucket.lastRefill;
+        const intervalsPasssed = Math.floor(timePassed / this.refillInterval);
+        const tokensToAdd = intervalsPasssed * this.refillRate;
+        if (tokensToAdd > 0) {
+            bucket.tokens = Math.min(this.maxTokens, bucket.tokens + tokensToAdd);
+            bucket.lastRefill = now;
+        }
+        const allowed = bucket.tokens >= 1;
+        if (allowed) {
+            bucket.tokens -= 1;
+        }
+        const resetTime = bucket.lastRefill + this.refillInterval;
+        return {
+            allowed,
+            info: {
+                limit: this.maxTokens,
+                remaining: Math.floor(bucket.tokens),
+                resetTime,
+                retryAfter: allowed ? undefined : resetTime - now,
+            },
+        };
+    }
+    reset(key) {
+        this.buckets.delete(key);
+    }
+    cleanup() {
+        const now = Date.now();
+        const maxAge = 60000;
+        for (const [key, bucket] of this.buckets) {
+            if (now - bucket.lastRefill > maxAge) {
+                this.buckets.delete(key);
+            }
+        }
+    }
+}
+class FixedWindowLimiter {
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+        this.windows = new Map();
+    }
+    tryAcquire(key) {
+        const now = Date.now();
+        let window = this.windows.get(key);
+        if (!window || now >= window.resetTime) {
+            window = {
+                count: 0,
+                resetTime: now + this.windowMs,
+            };
+            this.windows.set(key, window);
+        }
+        const allowed = window.count < this.maxRequests;
+        if (allowed) {
+            window.count++;
+        }
+        return {
+            allowed,
+            info: {
+                limit: this.maxRequests,
+                remaining: Math.max(0, this.maxRequests - window.count),
+                resetTime: window.resetTime,
+                retryAfter: allowed ? undefined : window.resetTime - now,
+            },
+        };
+    }
+    reset(key) {
+        this.windows.delete(key);
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [key, window] of this.windows) {
+            if (now >= window.resetTime + this.windowMs) {
+                this.windows.delete(key);
+            }
+        }
+    }
+}
+class RateLimiter {
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        switch (config.strategy) {
+            case 'sliding-window':
+                this.limiter = new SlidingWindowLimiter(config.maxRequests, config.windowMs);
+                break;
+            case 'token-bucket':
+                const refillRate = config.maxRequests / (config.windowMs / 1000);
+                this.limiter = new TokenBucketLimiter(config.maxRequests, refillRate);
+                break;
+            case 'fixed-window':
+                this.limiter = new FixedWindowLimiter(config.maxRequests, config.windowMs);
+                break;
+        }
+        this.cleanupInterval = setInterval(() => {
+            this.limiter.cleanup();
+        }, config.windowMs);
+        this.logger.info('Rate limiter initialized', {
+            strategy: config.strategy,
+            maxRequests: config.maxRequests,
+            windowMs: config.windowMs,
+        });
+    }
+    async execute(fn, context) {
+        const key = this.config.keyGenerator
+            ? this.config.keyGenerator(context)
+            : 'default';
+        const { allowed, info } = this.limiter.tryAcquire(key);
+        if (!allowed) {
+            this.logger.warn('Rate limit exceeded', { key, info });
+            throw new RateLimitExceededError(info, key);
+        }
+        this.logger.debug('Rate limit check passed', {
+            key,
+            remaining: info.remaining,
+        });
+        try {
+            const result = await fn();
+            if (this.config.skipSuccessfulRequests) {
+                this.reset(key);
+            }
+            return result;
+        }
+        catch (error) {
+            if (this.config.skipFailedRequests) {
+                this.reset(key);
+            }
+            throw error;
+        }
+    }
+    check(context) {
+        const key = this.config.keyGenerator
+            ? this.config.keyGenerator(context)
+            : 'default';
+        const { info } = this.limiter.tryAcquire(key);
+        return info;
+    }
+    reset(key) {
+        this.limiter.reset(key);
+        this.logger.debug('Rate limit reset', { key });
+    }
+    destroy() {
+        clearInterval(this.cleanupInterval);
+        this.logger.debug('Rate limiter destroyed');
+    }
+}
+exports.RateLimiter = RateLimiter;
+class RateLimiterManager {
+    constructor(logger) {
+        this.logger = logger;
+        this.limiters = new Map();
+    }
+    getOrCreate(name, config) {
+        if (this.limiters.has(name)) {
+            return this.limiters.get(name);
+        }
+        const defaultConfig = {
+            maxRequests: 100,
+            windowMs: 60000,
+            strategy: 'sliding-window',
+            ...config,
+        };
+        const limiter = new RateLimiter(defaultConfig, this.logger);
+        this.limiters.set(name, limiter);
+        return limiter;
+    }
+    getAll() {
+        return new Map(this.limiters);
+    }
+    destroyAll() {
+        for (const limiter of this.limiters.values()) {
+            limiter.destroy();
+        }
+        this.limiters.clear();
+        this.logger.info('All rate limiters destroyed');
+    }
+}
+exports.RateLimiterManager = RateLimiterManager;
+//# sourceMappingURL=RateLimiter.js.map

package/dist/core/RateLimiter.js.map

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

package/dist/core/ReflectionEngine.d.ts

@@ -0,0 +1,70 @@
+import { LLMAdapter } from './LLMAdapter';
+import { RecallBricksClient } from '../api/RecallBricksClient';
+import { Memory, ConversationTurn, Logger } from '../types';
+export interface Reflection {
+    id: string;
+    type: ReflectionType;
+    content: string;
+    insights: string[];
+    confidence: number;
+    timestamp: string;
+    triggerCondition: ReflectionTrigger;
+    relatedMemories: string[];
+}
+export type ReflectionType = 'task_completion' | 'low_confidence' | 'contradiction' | 'pattern_recognition' | 'self_improvement' | 'periodic';
+export type ReflectionTrigger = 'task_complete' | 'confidence_below_threshold' | 'contradiction_detected' | 'interaction_count' | 'manual';
+export interface ReflectionEngineConfig {
+    llmAdapter: LLMAdapter;
+    apiClient: RecallBricksClient;
+    agentId: string;
+    agentName: string;
+    reflectionInterval: number;
+    confidenceThreshold: number;
+    logger: Logger;
+}
+export interface ReasoningTrace {
+    query: string;
+    steps: ReasoningStep[];
+    conclusion: string;
+    confidence: number;
+    memoryReferences: string[];
+}
+export interface ReasoningStep {
+    thought: string;
+    observation?: string;
+    action?: string;
+}
+export declare class ReflectionEngine {
+    private config;
+    private interactionCount;
+    private recentTurns;
+    private reflectionHistory;
+    private pendingContradictions;
+    constructor(config: ReflectionEngineConfig);
+    recordInteraction(turn: ConversationTurn, confidence?: number): void;
+    shouldReflect(context?: {
+        taskComplete?: boolean;
+        confidence?: number;
+        contradictionDetected?: boolean;
+    }): {
+        shouldReflect: boolean;
+        trigger?: ReflectionTrigger;
+    };
+    reflect(trigger?: ReflectionTrigger): Promise<Reflection>;
+    explain(query: string, memories: Memory[]): Promise<ReasoningTrace>;
+    detectContradiction(memory1: Memory, memory2: Memory): boolean;
+    getReflectionHistory(): Reflection[];
+    getPendingContradictions(): Array<{
+        memory1: Memory;
+        memory2: Memory;
+    }>;
+    private buildReflectionPrompt;
+    private extractInsights;
+    private estimateConfidence;
+    private getReflectionType;
+    private saveReflectionAsMemory;
+    private parseReasoningSteps;
+    private extractConclusion;
+    private extractMemoryReferences;
+}
+//# sourceMappingURL=ReflectionEngine.d.ts.map

package/dist/core/ReflectionEngine.d.ts.map

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