@recallbricks/runtime 0.2.0

package/dist/core/ReflectionEngine.js

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReflectionEngine = void 0;
+class ReflectionEngine {
+    constructor(config) {
+        this.config = config;
+        this.interactionCount = 0;
+        this.recentTurns = [];
+        this.reflectionHistory = [];
+        this.pendingContradictions = [];
+        config.logger.debug('ReflectionEngine initialized', {
+            reflectionInterval: config.reflectionInterval,
+            confidenceThreshold: config.confidenceThreshold,
+        });
+    }
+    recordInteraction(turn, confidence) {
+        this.interactionCount++;
+        this.recentTurns.push(turn);
+        if (this.recentTurns.length > 10) {
+            this.recentTurns.shift();
+        }
+        this.config.logger.debug('Interaction recorded', {
+            count: this.interactionCount,
+            confidence,
+        });
+    }
+    shouldReflect(context) {
+        if (context?.taskComplete) {
+            return { shouldReflect: true, trigger: 'task_complete' };
+        }
+        if (context?.confidence !== undefined &&
+            context.confidence < this.config.confidenceThreshold) {
+            return { shouldReflect: true, trigger: 'confidence_below_threshold' };
+        }
+        if (context?.contradictionDetected || this.pendingContradictions.length > 0) {
+            return { shouldReflect: true, trigger: 'contradiction_detected' };
+        }
+        if (this.interactionCount >= this.config.reflectionInterval) {
+            return { shouldReflect: true, trigger: 'interaction_count' };
+        }
+        return { shouldReflect: false };
+    }
+    async reflect(trigger = 'manual') {
+        this.config.logger.info('Starting reflection', { trigger });
+        const startTime = Date.now();
+        const prompt = this.buildReflectionPrompt(trigger);
+        const messages = [
+            {
+                role: 'system',
+                content: `You are ${this.config.agentName}'s metacognition module. Analyze the recent interactions and provide insights for self-improvement. Be concise and actionable.`,
+            },
+            {
+                role: 'user',
+                content: prompt,
+            },
+        ];
+        const llmResponse = await this.config.llmAdapter.chat(messages);
+        const reflectionContent = llmResponse.content;
+        const insights = this.extractInsights(reflectionContent);
+        const confidence = this.estimateConfidence(reflectionContent, insights);
+        const reflection = {
+            id: `ref_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            type: this.getReflectionType(trigger),
+            content: reflectionContent,
+            insights,
+            confidence,
+            timestamp: new Date().toISOString(),
+            triggerCondition: trigger,
+            relatedMemories: this.recentTurns.slice(-3).map((t) => t.userMessage.slice(0, 50)),
+        };
+        await this.saveReflectionAsMemory(reflection);
+        this.interactionCount = 0;
+        this.pendingContradictions = [];
+        this.reflectionHistory.push(reflection);
+        if (this.reflectionHistory.length > 20) {
+            this.reflectionHistory.shift();
+        }
+        const duration = Date.now() - startTime;
+        this.config.logger.info('Reflection completed', {
+            duration: `${duration}ms`,
+            insights: insights.length,
+            confidence,
+        });
+        return reflection;
+    }
+    async explain(query, memories) {
+        this.config.logger.debug('Generating reasoning trace', { query });
+        const memoryContext = memories
+            .slice(0, 5)
+            .map((m, i) => `[${i + 1}] ${m.content}`)
+            .join('\n');
+        const messages = [
+            {
+                role: 'system',
+                content: `You are ${this.config.agentName}. Think step by step to answer the query. For each step, provide your thought process. Reference relevant memories by their number.`,
+            },
+            {
+                role: 'user',
+                content: `Query: ${query}\n\nRelevant memories:\n${memoryContext}\n\nThink through this step by step:`,
+            },
+        ];
+        const llmResponse = await this.config.llmAdapter.chat(messages);
+        const reasoning = llmResponse.content;
+        const steps = this.parseReasoningSteps(reasoning);
+        const conclusion = this.extractConclusion(reasoning);
+        const memoryRefs = this.extractMemoryReferences(reasoning);
+        const confidence = Math.min(1, 0.5 + steps.length * 0.1 + memoryRefs.length * 0.1);
+        return {
+            query,
+            steps,
+            conclusion,
+            confidence,
+            memoryReferences: memoryRefs,
+        };
+    }
+    detectContradiction(memory1, memory2) {
+        const opposingPairs = [
+            ['love', 'hate'],
+            ['like', 'dislike'],
+            ['yes', 'no'],
+            ['always', 'never'],
+            ['true', 'false'],
+            ['good', 'bad'],
+            ['want', "don't want"],
+            ['prefer', "don't prefer"],
+        ];
+        const content1 = memory1.content.toLowerCase();
+        const content2 = memory2.content.toLowerCase();
+        for (const [word1, word2] of opposingPairs) {
+            if ((content1.includes(word1) && content2.includes(word2)) ||
+                (content1.includes(word2) && content2.includes(word1))) {
+                const words1 = new Set(content1.split(/\s+/));
+                const words2 = new Set(content2.split(/\s+/));
+                const overlap = [...words1].filter((w) => words2.has(w) && w.length > 3);
+                if (overlap.length >= 2) {
+                    this.pendingContradictions.push({ memory1, memory2 });
+                    this.config.logger.warn('Potential contradiction detected', {
+                        overlap,
+                    });
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    getReflectionHistory() {
+        return [...this.reflectionHistory];
+    }
+    getPendingContradictions() {
+        return [...this.pendingContradictions];
+    }
+    buildReflectionPrompt(trigger) {
+        const recentContext = this.recentTurns
+            .slice(-5)
+            .map((t) => `User: ${t.userMessage.slice(0, 100)}...\nAssistant: ${t.assistantResponse.slice(0, 100)}...`)
+            .join('\n\n');
+        let prompt = `Reflect on these recent interactions:\n\n${recentContext}\n\n`;
+        switch (trigger) {
+            case 'task_complete':
+                prompt +=
+                    'The user has indicated task completion. Reflect on:\n' +
+                        '1. What was accomplished?\n' +
+                        '2. What could have been done better?\n' +
+                        '3. What should I remember for future similar tasks?';
+                break;
+            case 'confidence_below_threshold':
+                prompt +=
+                    'I detected low confidence in my responses. Reflect on:\n' +
+                        '1. Why was my confidence low?\n' +
+                        '2. What information was missing?\n' +
+                        '3. How can I improve for similar questions?';
+                break;
+            case 'contradiction_detected':
+                const contradictions = this.pendingContradictions
+                    .slice(0, 3)
+                    .map((c) => `Memory 1: "${c.memory1.content.slice(0, 50)}..."\n` +
+                    `Memory 2: "${c.memory2.content.slice(0, 50)}..."`)
+                    .join('\n\n');
+                prompt +=
+                    `Contradictions detected in my memory:\n${contradictions}\n\n` +
+                        'Reflect on:\n' +
+                        '1. Which information is more recent/reliable?\n' +
+                        '2. How should I reconcile these?\n' +
+                        '3. What questions should I ask to clarify?';
+                break;
+            case 'interaction_count':
+            case 'manual':
+            default:
+                prompt +=
+                    'Periodic self-reflection. Consider:\n' +
+                        '1. What patterns do I notice in user needs?\n' +
+                        '2. What have I learned that should be remembered?\n' +
+                        '3. How can I be more helpful?';
+        }
+        return prompt;
+    }
+    extractInsights(content) {
+        const insights = [];
+        const listMatches = content.match(/(?:\d+\.|[-•*])\s*([^\n]+)/g);
+        if (listMatches) {
+            insights.push(...listMatches.map((m) => m.replace(/^(?:\d+\.|[-•*])\s*/, '').trim()));
+        }
+        const sentences = content.split(/[.!?]+/);
+        const insightKeywords = [
+            'should',
+            'could',
+            'need to',
+            'important',
+            'remember',
+            'notice',
+            'pattern',
+            'improve',
+            'better',
+            'learn',
+        ];
+        for (const sentence of sentences) {
+            const trimmed = sentence.trim();
+            if (trimmed.length > 20 &&
+                insightKeywords.some((k) => trimmed.toLowerCase().includes(k)) &&
+                !insights.includes(trimmed)) {
+                insights.push(trimmed);
+            }
+        }
+        return insights.slice(0, 5);
+    }
+    estimateConfidence(content, insights) {
+        let confidence = 0.5;
+        confidence += Math.min(insights.length * 0.1, 0.3);
+        if (content.length > 500)
+            confidence += 0.1;
+        if (content.length > 1000)
+            confidence += 0.05;
+        if (content.includes('1.') || content.includes('-'))
+            confidence += 0.05;
+        return Math.min(confidence, 1);
+    }
+    getReflectionType(trigger) {
+        switch (trigger) {
+            case 'task_complete':
+                return 'task_completion';
+            case 'confidence_below_threshold':
+                return 'low_confidence';
+            case 'contradiction_detected':
+                return 'contradiction';
+            case 'interaction_count':
+                return 'periodic';
+            default:
+                return 'self_improvement';
+        }
+    }
+    async saveReflectionAsMemory(reflection) {
+        try {
+            await this.config.apiClient.saveMemory({
+                text: `[Reflection - ${reflection.type}] ${reflection.content}`,
+                tags: ['reflection', reflection.type],
+                source: 'reflection-engine',
+                metadata: {
+                    reflectionId: reflection.id,
+                    insights: reflection.insights,
+                    confidence: reflection.confidence,
+                },
+            });
+            this.config.logger.debug('Reflection saved as memory');
+        }
+        catch (error) {
+            this.config.logger.warn('Failed to save reflection as memory', { error });
+        }
+    }
+    parseReasoningSteps(reasoning) {
+        const steps = [];
+        const stepPatterns = [
+            /(?:Step\s*\d+[:.]\s*|(?:\d+)[.)]\s*)([^\n]+(?:\n(?![Ss]tep|\d+[.)]).*)*)/g,
+            /(?:First|Second|Third|Fourth|Fifth|Then|Next|Finally)[,:]?\s*([^\n]+)/gi,
+        ];
+        for (const pattern of stepPatterns) {
+            let match;
+            while ((match = pattern.exec(reasoning)) !== null) {
+                steps.push({
+                    thought: match[1].trim(),
+                });
+            }
+        }
+        if (steps.length === 0) {
+            const sentences = reasoning.split(/[.!?]+/).filter((s) => s.trim().length > 20);
+            for (const sentence of sentences.slice(0, 5)) {
+                steps.push({ thought: sentence.trim() });
+            }
+        }
+        return steps;
+    }
+    extractConclusion(reasoning) {
+        const conclusionPatterns = [
+            /(?:Therefore|Thus|In conclusion|So|Finally|The answer is)[,:]?\s*([^.]+\.)/i,
+            /(?:Based on|Given|Considering)[^.]+,\s*([^.]+\.)/i,
+        ];
+        for (const pattern of conclusionPatterns) {
+            const match = reasoning.match(pattern);
+            if (match) {
+                return match[1].trim();
+            }
+        }
+        const sentences = reasoning.split(/[.!?]+/).filter((s) => s.trim().length > 0);
+        return sentences[sentences.length - 1]?.trim() || reasoning.slice(-200);
+    }
+    extractMemoryReferences(reasoning) {
+        const refs = [];
+        const refMatches = reasoning.match(/\[(\d+)\]/g);
+        if (refMatches) {
+            refs.push(...refMatches.map((r) => r.slice(1, -1)));
+        }
+        const wordRefs = reasoning.match(/(?:memory|fact|observation)\s*(\d+)/gi);
+        if (wordRefs) {
+            refs.push(...wordRefs.map((r) => r.match(/\d+/)?.[0] || '').filter(Boolean));
+        }
+        return [...new Set(refs)];
+    }
+}
+exports.ReflectionEngine = ReflectionEngine;
+//# sourceMappingURL=ReflectionEngine.js.map

package/dist/core/ReflectionEngine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { AgentRuntime } from './core/AgentRuntime';
+export { LLMAdapter } from './core/LLMAdapter';
+export { ContextLoader } from './core/ContextLoader';
+export { ContextWeaver } from './core/ContextWeaver';
+export type { Context, ContextWeaverConfig, ContextBuildOptions } from './core/ContextWeaver';
+export { AutoSaver } from './core/AutoSaver';
+export { IdentityValidator } from './core/IdentityValidator';
+export { ReflectionEngine } from './core/ReflectionEngine';
+export type { Reflection, ReflectionType, ReflectionTrigger, ReasoningTrace, ReasoningStep, } from './core/ReflectionEngine';
+export { RecallBricksClient } from './api/RecallBricksClient';
+export type { RecallBricksClientConfig, SaveMemoryRequest, RecallMemoriesRequest, RegisterAgentRequest, RegisterAgentResponse, RuntimeHeuristics, } from './api/RecallBricksClient';
+export { buildConfigFromEnv, buildConfigFromOptions, createLogger, ConfigBuilder, } from './config';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigBuilder = exports.createLogger = exports.buildConfigFromOptions = exports.buildConfigFromEnv = exports.RecallBricksClient = exports.ReflectionEngine = exports.IdentityValidator = exports.AutoSaver = exports.ContextWeaver = exports.ContextLoader = exports.LLMAdapter = exports.AgentRuntime = void 0;
+var AgentRuntime_1 = require("./core/AgentRuntime");
+Object.defineProperty(exports, "AgentRuntime", { enumerable: true, get: function () { return AgentRuntime_1.AgentRuntime; } });
+var LLMAdapter_1 = require("./core/LLMAdapter");
+Object.defineProperty(exports, "LLMAdapter", { enumerable: true, get: function () { return LLMAdapter_1.LLMAdapter; } });
+var ContextLoader_1 = require("./core/ContextLoader");
+Object.defineProperty(exports, "ContextLoader", { enumerable: true, get: function () { return ContextLoader_1.ContextLoader; } });
+var ContextWeaver_1 = require("./core/ContextWeaver");
+Object.defineProperty(exports, "ContextWeaver", { enumerable: true, get: function () { return ContextWeaver_1.ContextWeaver; } });
+var AutoSaver_1 = require("./core/AutoSaver");
+Object.defineProperty(exports, "AutoSaver", { enumerable: true, get: function () { return AutoSaver_1.AutoSaver; } });
+var IdentityValidator_1 = require("./core/IdentityValidator");
+Object.defineProperty(exports, "IdentityValidator", { enumerable: true, get: function () { return IdentityValidator_1.IdentityValidator; } });
+var ReflectionEngine_1 = require("./core/ReflectionEngine");
+Object.defineProperty(exports, "ReflectionEngine", { enumerable: true, get: function () { return ReflectionEngine_1.ReflectionEngine; } });
+var RecallBricksClient_1 = require("./api/RecallBricksClient");
+Object.defineProperty(exports, "RecallBricksClient", { enumerable: true, get: function () { return RecallBricksClient_1.RecallBricksClient; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "buildConfigFromEnv", { enumerable: true, get: function () { return config_1.buildConfigFromEnv; } });
+Object.defineProperty(exports, "buildConfigFromOptions", { enumerable: true, get: function () { return config_1.buildConfigFromOptions; } });
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return config_1.createLogger; } });
+Object.defineProperty(exports, "ConfigBuilder", { enumerable: true, get: function () { return config_1.ConfigBuilder; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAQA,oDAAmD;AAA1C,4GAAA,YAAY,OAAA;AACrB,gDAA+C;AAAtC,wGAAA,UAAU,OAAA;AACnB,sDAAqD;AAA5C,8GAAA,aAAa,OAAA;AACtB,sDAAqD;AAA5C,8GAAA,aAAa,OAAA;AAEtB,8CAA6C;AAApC,sGAAA,SAAS,OAAA;AAClB,8DAA6D;AAApD,sHAAA,iBAAiB,OAAA;AAC1B,4DAA2D;AAAlD,oHAAA,gBAAgB,OAAA;AAUzB,+DAA8D;AAArD,wHAAA,kBAAkB,OAAA;AAW3B,mCAKkB;AAJhB,4GAAA,kBAAkB,OAAA;AAClB,gHAAA,sBAAsB,OAAA;AACtB,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AAIf,0CAAwB"}

package/dist/types/index.d.ts

@@ -0,0 +1,259 @@
+export type LLMProvider = 'anthropic' | 'openai' | 'gemini' | 'ollama' | 'cohere' | 'local';
+export type RecallBricksTier = 'starter' | 'professional' | 'enterprise';
+export interface LLMMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface LLMResponse {
+    content: string;
+    provider: LLMProvider;
+    model: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface LLMConfig {
+    provider: LLMProvider;
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    baseUrl?: string;
+}
+export interface AgentIdentity {
+    id: string;
+    name: string;
+    purpose: string;
+    traits: string[];
+    rules: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentBehavioralRule {
+    rule: string;
+    priority: number;
+    enforced: boolean;
+}
+export interface Memory {
+    id: string;
+    content: string;
+    type: 'conversation' | 'fact' | 'observation' | 'insight';
+    importance: number;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+}
+export interface MemoryContext {
+    recentMemories: Memory[];
+    relevantMemories: Memory[];
+    predictedContext: string[];
+    totalMemories: number;
+    lastUpdated: string;
+}
+export interface ConversationTurn {
+    userMessage: string;
+    assistantResponse: string;
+    timestamp: string;
+    importance?: number;
+}
+export interface RuntimeConfig {
+    agentId: string;
+    userId: string;
+    agentName?: string;
+    agentPurpose?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    llmConfig?: LLMConfig;
+    tier?: RecallBricksTier;
+    autoSave?: boolean;
+    validateIdentity?: boolean;
+    cacheEnabled?: boolean;
+    cacheTTL?: number;
+    maxContextTokens?: number;
+    debug?: boolean;
+    mcpMode?: boolean;
+    registerAgent?: boolean;
+}
+export interface RuntimeOptions {
+    agentId: string;
+    userId: string;
+    agentName?: string;
+    agentPurpose?: string;
+    apiUrl?: string;
+    apiKey?: string;
+    llmProvider?: LLMProvider;
+    llmApiKey?: string;
+    llmModel?: string;
+    tier?: RecallBricksTier;
+    autoSave?: boolean;
+    validateIdentity?: boolean;
+    cacheEnabled?: boolean;
+    cacheTTL?: number;
+    maxContextTokens?: number;
+    debug?: boolean;
+    mcpMode?: boolean;
+    registerAgent?: boolean;
+}
+export interface SaveConversationRequest {
+    agentId: string;
+    userId: string;
+    userMessage: string;
+    assistantResponse: string;
+    importance?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SaveConversationResponse {
+    success: boolean;
+    memoryId?: string;
+    importance?: number;
+    message?: string;
+}
+export interface GetContextRequest {
+    agentId: string;
+    userId: string;
+    limit?: number;
+    includeRelevant?: boolean;
+    includePredicted?: boolean;
+}
+export interface GetContextResponse {
+    identity: AgentIdentity;
+    context: MemoryContext;
+}
+export interface GetIdentityRequest {
+    agentId: string;
+}
+export interface GetIdentityResponse {
+    identity: AgentIdentity;
+}
+export interface IdentityViolation {
+    type: 'base_model_reference' | 'inconsistent_behavior' | 'identity_leak';
+    detected: string;
+    suggestion: string;
+    severity: 'low' | 'medium' | 'high';
+}
+export interface ValidationResult {
+    isValid: boolean;
+    violations: IdentityViolation[];
+    correctedResponse?: string;
+}
+export interface ImportanceClassification {
+    importance: number;
+    reasoning: string;
+    model: string;
+}
+export interface SaveMetadata {
+    classified: boolean;
+    importance: number;
+    isDuplicate: boolean;
+    timestamp: string;
+}
+export interface ContextPrompt {
+    systemPrompt: string;
+    identitySection: string;
+    memorySection: string;
+    rulesSection: string;
+}
+export interface CacheEntry<T> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+}
+export declare class RecallBricksError extends Error {
+    code: string;
+    statusCode?: number | undefined;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, details?: unknown | undefined);
+}
+export declare class APIError extends RecallBricksError {
+    constructor(message: string, statusCode: number, details?: unknown);
+}
+export declare class ConfigurationError extends RecallBricksError {
+    constructor(message: string, details?: unknown);
+}
+export declare class LLMError extends RecallBricksError {
+    constructor(message: string, provider: LLMProvider, details?: unknown);
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+}
+export interface ChatRequest {
+    message: string;
+    conversationHistory?: LLMMessage[];
+    streamResponse?: boolean;
+}
+export interface ChatResponse {
+    response: string;
+    metadata: {
+        provider: LLMProvider;
+        model: string;
+        contextLoaded: boolean;
+        identityValidated: boolean;
+        autoSaved: boolean;
+        tokensUsed?: number;
+    };
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeout: number;
+    monitorInterval: number;
+}
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerState {
+    state: CircuitState;
+    failures: number;
+    lastFailureTime?: number;
+    nextRetryTime?: number;
+}
+export interface SaveResponse {
+    id: string;
+    text: string;
+    user_id: string;
+    metadata?: {
+        tags?: string[];
+        category?: string;
+        importance?: number;
+        source?: string;
+    };
+    created_at: string;
+}
+export interface LearnResponse {
+    id: string;
+    text: string;
+    metadata: {
+        tags: string[];
+        category: string;
+        entities: string[];
+        importance: number;
+        summary: string;
+    };
+    created_at: string;
+}
+export interface RecallMemory {
+    id: string;
+    text: string;
+    score: number;
+    metadata: {
+        tags: string[];
+        category: string;
+        importance: number;
+        summary: string;
+    };
+    created_at: string;
+}
+export interface CategorySummary {
+    count: number;
+    avg_score: number;
+    summary: string;
+}
+export interface RecallResponse {
+    memories: RecallMemory[];
+    categories?: Record<string, CategorySummary>;
+    total: number;
+}
+//# sourceMappingURL=index.d.ts.map