@recallbricks/runtime 0.2.0

package/dist/core/AgentRuntime.d.ts

@@ -0,0 +1,45 @@
+import { RuntimeConfig, RuntimeOptions, LLMMessage, ChatResponse, AgentIdentity, MemoryContext } from '../types';
+import { Reflection, ReasoningTrace } from './ReflectionEngine';
+import { RecallBricksClient } from '../api/RecallBricksClient';
+export declare class AgentRuntime {
+    private config;
+    private logger;
+    private llmAdapter?;
+    private contextLoader;
+    private contextWeaver?;
+    private autoSaver;
+    private identityValidator?;
+    private reflectionEngine?;
+    private apiClient;
+    private currentIdentity?;
+    private currentContext?;
+    private weavedContext?;
+    private previousTurn?;
+    private conversationHistory;
+    private interactionCount;
+    constructor(options: RuntimeOptions);
+    chat(message: string, conversationHistory?: LLMMessage[]): Promise<ChatResponse>;
+    reflect(): Promise<Reflection>;
+    explain(query: string): Promise<ReasoningTrace>;
+    private buildEnrichedMessages;
+    private registerAgent;
+    getIdentity(): AgentIdentity;
+    getContext(): Promise<MemoryContext | undefined>;
+    refreshContext(): Promise<void>;
+    saveNow(): Promise<void>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    getConversationHistory(): LLMMessage[];
+    clearConversationHistory(): void;
+    getValidationStats(): {
+        total: number;
+        byType: Record<string, number>;
+        bySeverity: Record<string, number>;
+    } | undefined;
+    getReflectionHistory(): Reflection[];
+    getConfig(): RuntimeConfig;
+    getVersion(): string;
+    updateLLMConfig(newConfig: Partial<RuntimeConfig['llmConfig']>): void;
+    getApiClient(): RecallBricksClient;
+}
+//# sourceMappingURL=AgentRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../src/core/AgentRuntime.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EAEZ,aAAa,EACb,aAAa,EAGd,MAAM,UAAU,CAAC;AAOlB,OAAO,EAAoB,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAY/D,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAU;IAChC,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,OAAO,EAAE,cAAc;IA0F7B,IAAI,CACR,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,UAAU,EAAE,GACjC,OAAO,CAAC,YAAY,CAAC;IA6JlB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAY9B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcrD,OAAO,CAAC,qBAAqB;YA4Cf,aAAa;IAmB3B,WAAW,IAAI,aAAa;IAOtB,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAWhD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,sBAAsB,IAAI,UAAU,EAAE;IAOtC,wBAAwB,IAAI,IAAI;IAQhC,kBAAkB,IACd;QACE,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,GACD,SAAS;IAOb,oBAAoB,IAAI,UAAU,EAAE;IAOpC,SAAS,IAAI,aAAa;IAO1B,UAAU,IAAI,MAAM;IAOpB,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI;IAmBrE,YAAY,IAAI,kBAAkB;CAGnC"}

package/dist/core/AgentRuntime.js

@@ -0,0 +1,328 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRuntime = void 0;
+const config_1 = require("../config");
+const LLMAdapter_1 = require("./LLMAdapter");
+const ContextLoader_1 = require("./ContextLoader");
+const ContextWeaver_1 = require("./ContextWeaver");
+const AutoSaver_1 = require("./AutoSaver");
+const IdentityValidator_1 = require("./IdentityValidator");
+const ReflectionEngine_1 = require("./ReflectionEngine");
+const RecallBricksClient_1 = require("../api/RecallBricksClient");
+const RUNTIME_VERSION = '0.2.0';
+class AgentRuntime {
+    constructor(options) {
+        this.conversationHistory = [];
+        this.interactionCount = 0;
+        this.config = (0, config_1.buildConfigFromOptions)(options);
+        this.logger = (0, config_1.createLogger)(this.config.debug);
+        this.logger.info('Initializing RecallBricks Agent Runtime', {
+            version: RUNTIME_VERSION,
+            agentId: this.config.agentId,
+            userId: this.config.userId,
+            provider: this.config.llmConfig?.provider,
+            tier: this.config.tier,
+            mcpMode: this.config.mcpMode,
+        });
+        this.apiClient = new RecallBricksClient_1.RecallBricksClient({
+            apiUrl: this.config.apiUrl,
+            apiKey: this.config.apiKey || '',
+            userId: this.config.userId,
+            logger: this.logger,
+        });
+        if (!this.config.mcpMode && this.config.llmConfig) {
+            this.llmAdapter = new LLMAdapter_1.LLMAdapter(this.config.llmConfig, this.logger);
+        }
+        this.contextLoader = new ContextLoader_1.ContextLoader({
+            apiUrl: this.config.apiUrl,
+            apiKey: this.config.apiKey || '',
+            agentId: this.config.agentId,
+            userId: this.config.userId,
+            agentName: this.config.agentName,
+            agentPurpose: this.config.agentPurpose,
+            cacheEnabled: this.config.cacheEnabled,
+            cacheTTL: this.config.cacheTTL,
+            maxContextTokens: this.config.maxContextTokens,
+            logger: this.logger,
+        });
+        this.contextWeaver = new ContextWeaver_1.ContextWeaver({
+            apiClient: this.apiClient,
+            agentId: this.config.agentId,
+            agentName: this.config.agentName || 'RecallBricks Agent',
+            agentPurpose: this.config.agentPurpose || 'A persistent cognitive agent',
+            maxContextMemories: 10,
+            maxContextTokens: this.config.maxContextTokens,
+            logger: this.logger,
+        });
+        this.autoSaver = new AutoSaver_1.AutoSaver({
+            apiUrl: this.config.apiUrl,
+            apiKey: this.config.apiKey || '',
+            agentId: this.config.agentId,
+            userId: this.config.userId,
+            tier: this.config.tier,
+            logger: this.logger,
+        });
+        if (this.llmAdapter) {
+            this.reflectionEngine = new ReflectionEngine_1.ReflectionEngine({
+                llmAdapter: this.llmAdapter,
+                apiClient: this.apiClient,
+                agentId: this.config.agentId,
+                agentName: this.config.agentName || 'RecallBricks Agent',
+                reflectionInterval: 5,
+                confidenceThreshold: 0.6,
+                logger: this.logger,
+            });
+        }
+        if (this.config.registerAgent === true) {
+            this.registerAgent().catch((err) => {
+                this.logger.debug('Agent registration skipped', { error: err.message });
+            });
+        }
+        this.logger.info('AgentRuntime initialized successfully');
+    }
+    async chat(message, conversationHistory) {
+        this.logger.info('Processing chat message', {
+            messageLength: message.length,
+            mcpMode: this.config.mcpMode,
+        });
+        const startTime = Date.now();
+        this.interactionCount++;
+        try {
+            if (this.previousTurn && this.config.autoSave) {
+                this.logger.debug('Saving previous conversation turn');
+                await this.autoSaver.save(this.previousTurn);
+            }
+            this.logger.debug('Building context from Memory Graph');
+            this.weavedContext = await this.contextWeaver.buildContext(message);
+            this.currentIdentity = this.weavedContext.identity;
+            this.currentContext = {
+                recentMemories: this.weavedContext.recentMemories,
+                relevantMemories: this.weavedContext.relevantMemories,
+                predictedContext: this.weavedContext.predictedTopics,
+                totalMemories: this.weavedContext.totalMemoriesAvailable,
+                lastUpdated: new Date().toISOString(),
+            };
+            if (this.config.validateIdentity && this.currentIdentity) {
+                this.identityValidator = new IdentityValidator_1.IdentityValidator({
+                    agentIdentity: this.currentIdentity,
+                    autoCorrect: true,
+                    logger: this.logger,
+                });
+            }
+            if (this.config.mcpMode) {
+                this.logger.debug('MCP mode: returning context without LLM call');
+                const duration = Date.now() - startTime;
+                this.logger.info('Context loaded successfully in MCP mode', {
+                    duration: `${duration}ms`,
+                });
+                return {
+                    response: this.weavedContext.systemPrompt,
+                    metadata: {
+                        provider: 'none',
+                        model: 'mcp-mode',
+                        contextLoaded: true,
+                        identityValidated: false,
+                        autoSaved: false,
+                        tokensUsed: 0,
+                    },
+                };
+            }
+            const enrichedMessages = this.buildEnrichedMessages(message, conversationHistory);
+            if (!this.llmAdapter) {
+                throw new Error('LLM adapter not initialized. This should not happen in non-MCP mode.');
+            }
+            this.logger.debug('Calling LLM with enriched context');
+            const llmResponse = await this.llmAdapter.chat(enrichedMessages);
+            let finalResponse = llmResponse.content;
+            let identityValidated = false;
+            if (this.identityValidator) {
+                this.logger.debug('Validating response for identity violations');
+                const validation = this.identityValidator.validate(llmResponse.content);
+                if (!validation.isValid) {
+                    this.logger.warn('Identity violations detected', {
+                        count: validation.violations.length,
+                    });
+                    if (validation.correctedResponse) {
+                        finalResponse = validation.correctedResponse;
+                        identityValidated = true;
+                    }
+                }
+                else {
+                    identityValidated = true;
+                }
+            }
+            this.previousTurn = {
+                userMessage: message,
+                assistantResponse: finalResponse,
+                timestamp: new Date().toISOString(),
+            };
+            if (this.reflectionEngine) {
+                this.reflectionEngine.recordInteraction(this.previousTurn);
+            }
+            this.conversationHistory.push({ role: 'user', content: message }, { role: 'assistant', content: finalResponse });
+            const duration = Date.now() - startTime;
+            this.logger.info('Chat message processed successfully', {
+                duration: `${duration}ms`,
+                tokensUsed: llmResponse.usage?.totalTokens,
+            });
+            if (this.reflectionEngine) {
+                const { shouldReflect, trigger } = this.reflectionEngine.shouldReflect();
+                if (shouldReflect && trigger) {
+                    this.reflectionEngine.reflect(trigger).then((reflection) => {
+                        this.logger.info('Background reflection completed', {
+                            insights: reflection.insights.length,
+                        });
+                    }).catch((err) => {
+                        this.logger.warn('Background reflection failed', { error: err.message });
+                    });
+                }
+            }
+            return {
+                response: finalResponse,
+                metadata: {
+                    provider: llmResponse.provider,
+                    model: llmResponse.model,
+                    contextLoaded: true,
+                    identityValidated,
+                    autoSaved: this.config.autoSave,
+                    tokensUsed: llmResponse.usage?.totalTokens,
+                },
+            };
+        }
+        catch (error) {
+            this.logger.error('Chat processing failed', { error });
+            throw error;
+        }
+    }
+    async reflect() {
+        if (!this.reflectionEngine) {
+            throw new Error('Reflection engine not initialized (requires LLM adapter)');
+        }
+        this.logger.info('Triggering manual reflection');
+        return this.reflectionEngine.reflect('manual');
+    }
+    async explain(query) {
+        if (!this.reflectionEngine) {
+            throw new Error('Reflection engine not initialized (requires LLM adapter)');
+        }
+        const context = await this.contextWeaver.buildContext(query);
+        return this.reflectionEngine.explain(query, context.memories);
+    }
+    buildEnrichedMessages(userMessage, conversationHistory) {
+        const messages = [];
+        if (this.weavedContext) {
+            messages.push({
+                role: 'system',
+                content: this.weavedContext.systemPrompt,
+            });
+        }
+        else if (this.currentIdentity && this.currentContext) {
+            const contextPrompt = this.contextLoader.formatContextPrompt(this.currentIdentity, this.currentContext);
+            messages.push({
+                role: 'system',
+                content: contextPrompt.systemPrompt,
+            });
+        }
+        if (conversationHistory && conversationHistory.length > 0) {
+            messages.push(...conversationHistory);
+        }
+        else if (this.conversationHistory.length > 0) {
+            messages.push(...this.conversationHistory.slice(-10));
+        }
+        messages.push({
+            role: 'user',
+            content: userMessage,
+        });
+        return messages;
+    }
+    async registerAgent() {
+        try {
+            await this.apiClient.registerAgent({
+                agentId: this.config.agentId,
+                runtimeVersion: RUNTIME_VERSION,
+                metadata: {
+                    provider: this.config.llmConfig?.provider,
+                    tier: this.config.tier,
+                },
+            });
+            this.logger.debug('Agent registered with RecallBricks');
+        }
+        catch {
+        }
+    }
+    getIdentity() {
+        return this.contextWeaver?.getIdentity() || this.currentIdentity;
+    }
+    async getContext() {
+        if (!this.currentContext) {
+            const contextResponse = await this.contextLoader.loadContext();
+            this.currentContext = contextResponse.context;
+        }
+        return this.currentContext;
+    }
+    async refreshContext() {
+        this.logger.info('Refreshing context');
+        this.contextLoader.clearCache();
+        const contextResponse = await this.contextLoader.loadContext();
+        this.currentIdentity = contextResponse.identity;
+        this.currentContext = contextResponse.context;
+        this.logger.info('Context refreshed successfully');
+    }
+    async saveNow() {
+        if (this.previousTurn) {
+            this.logger.info('Saving current conversation turn');
+            await this.autoSaver.saveSync(this.previousTurn);
+            this.previousTurn = undefined;
+        }
+        else {
+            this.logger.warn('No conversation turn to save');
+        }
+    }
+    async flush() {
+        this.logger.info('Flushing pending saves');
+        await this.autoSaver.flush();
+        this.logger.info('All saves completed');
+    }
+    async shutdown() {
+        this.logger.info('Shutting down AgentRuntime');
+        await this.flush();
+        this.logger.info('AgentRuntime shutdown complete');
+    }
+    getConversationHistory() {
+        return [...this.conversationHistory];
+    }
+    clearConversationHistory() {
+        this.conversationHistory = [];
+        this.logger.debug('Conversation history cleared');
+    }
+    getValidationStats() {
+        return this.identityValidator?.getViolationStats();
+    }
+    getReflectionHistory() {
+        return this.reflectionEngine?.getReflectionHistory() || [];
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getVersion() {
+        return RUNTIME_VERSION;
+    }
+    updateLLMConfig(newConfig) {
+        if (this.config.mcpMode) {
+            this.logger.warn('Cannot update LLM config in MCP mode');
+            return;
+        }
+        if (!this.config.llmConfig) {
+            this.logger.warn('LLM config not initialized');
+            return;
+        }
+        this.config.llmConfig = { ...this.config.llmConfig, ...newConfig };
+        this.llmAdapter?.updateConfig(this.config.llmConfig);
+        this.logger.info('LLM configuration updated');
+    }
+    getApiClient() {
+        return this.apiClient;
+    }
+}
+exports.AgentRuntime = AgentRuntime;
+//# sourceMappingURL=AgentRuntime.js.map

package/dist/core/AgentRuntime.js.map

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

package/dist/core/AutoSaver.d.ts

@@ -0,0 +1,26 @@
+import { ConversationTurn, SaveConversationResponse, RecallBricksTier, Logger } from '../types';
+interface AutoSaverConfig {
+    apiUrl: string;
+    apiKey: string;
+    agentId: string;
+    userId: string;
+    tier: RecallBricksTier;
+    logger: Logger;
+}
+export declare class AutoSaver {
+    private config;
+    private apiClient;
+    private saveQueue;
+    private isProcessing;
+    constructor(config: AutoSaverConfig);
+    save(turn: ConversationTurn): Promise<boolean>;
+    saveSync(turn: ConversationTurn): Promise<SaveConversationResponse>;
+    private processQueue;
+    private classifyImportance;
+    private calculateHeuristicImportance;
+    flush(): Promise<void>;
+    getQueueSize(): number;
+    private handleAPIError;
+}
+export {};
+//# sourceMappingURL=AutoSaver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutoSaver.d.ts","sourceRoot":"","sources":["../../src/core/AutoSaver.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EAExB,gBAAgB,EAEhB,MAAM,EACP,MAAM,UAAU,CAAC;AAMlB,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,qBAAa,SAAS;IASR,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,SAAS,CAIT;IACR,OAAO,CAAC,YAAY,CAAS;gBAET,MAAM,EAAE,eAAe;IAmBrC,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAc9C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,wBAAwB,CAAC;YA0D3D,YAAY;YA4BZ,kBAAkB;IAiBhC,OAAO,CAAC,4BAA4B;IA+C9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,YAAY,IAAI,MAAM;IAOtB,OAAO,CAAC,cAAc;CAoBvB"}

package/dist/core/AutoSaver.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoSaver = void 0;
+const axios_1 = __importDefault(require("axios"));
+const p_retry_1 = __importDefault(require("p-retry"));
+const types_1 = require("../types");
+class AutoSaver {
+    constructor(config) {
+        this.config = config;
+        this.saveQueue = [];
+        this.isProcessing = false;
+        this.apiClient = axios_1.default.create({
+            baseURL: config.apiUrl,
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': config.apiKey,
+            },
+        });
+        config.logger.debug('AutoSaver initialized', {
+            tier: config.tier,
+            apiUrl: config.apiUrl,
+        });
+    }
+    async save(turn) {
+        this.config.logger.debug('Queuing conversation turn for save', {
+            timestamp: turn.timestamp,
+        });
+        return new Promise((resolve, reject) => {
+            this.saveQueue.push({ turn, resolve, reject });
+            this.processQueue();
+        });
+    }
+    async saveSync(turn) {
+        this.config.logger.debug('Saving conversation turn synchronously');
+        const importance = turn.importance ?? (await this.classifyImportance(turn));
+        const conversationText = `User: ${turn.userMessage}
+Assistant: ${turn.assistantResponse}`;
+        try {
+            const response = await (0, p_retry_1.default)(async () => {
+                const result = await this.apiClient.post('/api/v1/memories', {
+                    text: conversationText,
+                    source: 'agent-runtime',
+                    metadata: {
+                        importance: importance,
+                        agent_id: this.config.agentId,
+                        timestamp: turn.timestamp,
+                    },
+                });
+                return result.data;
+            }, {
+                retries: 3,
+                minTimeout: 1000,
+                onFailedAttempt: (error) => {
+                    this.config.logger.warn(`Save attempt ${error.attemptNumber} failed. ${error.retriesLeft} retries left.`);
+                },
+            });
+            this.config.logger.info('Conversation saved successfully', {
+                memoryId: response.id,
+                importance: response.metadata?.importance ?? importance,
+            });
+            return {
+                success: true,
+                memoryId: response.id,
+                importance: response.metadata?.importance ?? importance,
+            };
+        }
+        catch (error) {
+            this.config.logger.error('Failed to save conversation', { error });
+            throw this.handleAPIError(error);
+        }
+    }
+    async processQueue() {
+        if (this.isProcessing || this.saveQueue.length === 0) {
+            return;
+        }
+        this.isProcessing = true;
+        while (this.saveQueue.length > 0) {
+            const item = this.saveQueue.shift();
+            if (!item)
+                continue;
+            try {
+                await this.saveSync(item.turn);
+                item.resolve(true);
+            }
+            catch (error) {
+                this.config.logger.error('Queue processing error', { error });
+                item.reject(error instanceof Error ? error : new Error('Unknown error'));
+            }
+        }
+        this.isProcessing = false;
+    }
+    async classifyImportance(turn) {
+        this.config.logger.debug('Classifying conversation importance');
+        const importance = this.calculateHeuristicImportance(turn);
+        this.config.logger.debug('Importance classified', { importance });
+        return importance;
+    }
+    calculateHeuristicImportance(turn) {
+        let score = 0.5;
+        const responseLength = turn.assistantResponse.length;
+        if (responseLength > 1000)
+            score += 0.2;
+        else if (responseLength > 500)
+            score += 0.1;
+        const questionCount = (turn.userMessage.match(/\?/g) || []).length;
+        score += Math.min(questionCount * 0.1, 0.2);
+        const exclamationCount = (turn.userMessage.match(/!/g) || []).length;
+        score += Math.min(exclamationCount * 0.05, 0.1);
+        const codeBlockCount = (turn.assistantResponse.match(/```/g) || []).length / 2;
+        score += Math.min(codeBlockCount * 0.1, 0.2);
+        const importantKeywords = [
+            'important',
+            'critical',
+            'remember',
+            'note',
+            'warning',
+            'error',
+            'issue',
+            'problem',
+            'solution',
+            'decision',
+        ];
+        const lowerMessage = turn.userMessage.toLowerCase();
+        const keywordMatches = importantKeywords.filter((keyword) => lowerMessage.includes(keyword)).length;
+        score += Math.min(keywordMatches * 0.1, 0.3);
+        return Math.max(0, Math.min(1, score));
+    }
+    async flush() {
+        this.config.logger.debug('Flushing save queue', {
+            queueSize: this.saveQueue.length,
+        });
+        while (this.saveQueue.length > 0 || this.isProcessing) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        this.config.logger.info('Save queue flushed');
+    }
+    getQueueSize() {
+        return this.saveQueue.length;
+    }
+    handleAPIError(error) {
+        if (axios_1.default.isAxiosError(error)) {
+            const status = error.response?.status || 500;
+            const message = error.response?.data?.message ||
+                error.message ||
+                'Unknown API error';
+            return new types_1.APIError(message, status, {
+                url: error.config?.url,
+                method: error.config?.method,
+            });
+        }
+        if (error instanceof Error) {
+            return new types_1.APIError(error.message, 500);
+        }
+        return new types_1.APIError('Unknown error occurred', 500, { error });
+    }
+}
+exports.AutoSaver = AutoSaver;
+//# sourceMappingURL=AutoSaver.js.map

package/dist/core/AutoSaver.js.map

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

package/dist/core/CircuitBreaker.d.ts

@@ -0,0 +1,64 @@
+import { Logger } from '../types';
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeout: number;
+    monitorInterval: number;
+    halfOpenMaxAttempts: number;
+    name: string;
+}
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerStats {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    totalRequests: number;
+    lastFailureTime?: number;
+    lastSuccessTime?: number;
+    stateChanges: number;
+    uptime: number;
+}
+export declare class CircuitBreakerOpenError extends Error {
+    constructor(circuitName: string, nextRetryTime?: number);
+}
+export declare class CircuitBreaker {
+    private config;
+    private logger;
+    private state;
+    private failures;
+    private successes;
+    private totalRequests;
+    private lastFailureTime?;
+    private lastSuccessTime?;
+    private stateChanges;
+    private createdAt;
+    private nextRetryTime?;
+    private halfOpenAttempts;
+    constructor(config: CircuitBreakerConfig, logger: Logger);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    private shouldAttemptReset;
+    private transitionToClosed;
+    private transitionToOpen;
+    private transitionToHalfOpen;
+    getState(): CircuitState;
+    getStats(): CircuitBreakerStats;
+    forceClose(): void;
+    forceOpen(): void;
+    resetStats(): void;
+}
+export declare class CircuitBreakerManager {
+    private logger;
+    private breakers;
+    constructor(logger: Logger);
+    getOrCreate(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+    getAll(): Map<string, CircuitBreaker>;
+    getAllStats(): Record<string, CircuitBreakerStats>;
+    forceCloseAll(): void;
+    getHealth(): {
+        healthy: boolean;
+        openCircuits: string[];
+        totalCircuits: number;
+    };
+}
+//# sourceMappingURL=CircuitBreaker.d.ts.map