@recallbricks/runtime 0.2.0

package/dist/api/RecallBricksClient.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecallBricksClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const p_retry_1 = __importDefault(require("p-retry"));
+class RecallBricksClient {
+    constructor(config) {
+        this.config = config;
+        this.retries = config.retries ?? 3;
+        this.logger = config.logger;
+        this.client = axios_1.default.create({
+            baseURL: config.apiUrl,
+            timeout: config.timeout ?? 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': config.apiKey,
+            },
+        });
+        this.client.interceptors.response.use((response) => {
+            this.logger?.debug('API response received', {
+                url: response.config.url,
+                status: response.status,
+            });
+            return response;
+        }, (error) => {
+            this.logger?.error('API request failed', {
+                url: error.config?.url,
+                status: error.response?.status,
+                message: error.message,
+            });
+            throw error;
+        });
+        this.logger?.debug('RecallBricksClient initialized', {
+            apiUrl: config.apiUrl,
+        });
+    }
+    async saveMemory(request) {
+        this.logger?.debug('Saving memory', { textLength: request.text.length });
+        return this.withRetry(async () => {
+            const response = await this.client.post('/api/v1/memories', {
+                text: request.text,
+                tags: request.tags,
+                source: request.source || 'agent-runtime',
+                metadata: request.metadata,
+            });
+            return response.data;
+        });
+    }
+    async recallMemories(request) {
+        this.logger?.debug('Recalling memories', { query: request.query });
+        return this.withRetry(async () => {
+            const response = await this.client.post('/api/v1/memories/search', {
+                query: request.query,
+                limit: request.limit ?? 10,
+            });
+            return response.data;
+        });
+    }
+    async registerAgent(request) {
+        this.logger?.debug('Registering agent', { agentId: request.agentId });
+        return this.withRetry(async () => {
+            const response = await this.client.post('/api/v1/collaboration/agents', {
+                name: request.agentId,
+                capabilities: ['memory', 'conversation'],
+                metadata: {
+                    runtime_version: request.runtimeVersion,
+                    ...request.metadata,
+                },
+            });
+            return response.data;
+        });
+    }
+    async getHeuristics() {
+        this.logger?.debug('Fetching runtime heuristics');
+        try {
+            return await this.withRetry(async () => {
+                const response = await this.client.get('/api/v1/runtime/heuristics');
+                return response.data;
+            });
+        }
+        catch {
+            this.logger?.warn('Heuristics endpoint not available, using defaults');
+            return {
+                reflectionInterval: 3,
+                confidenceThreshold: 0.7,
+                maxContextMemories: 10,
+                batchFlushInterval: 5000,
+            };
+        }
+    }
+    async getTopMemories(query, limit = 10) {
+        const response = await this.recallMemories({ query, limit, organized: false });
+        return response.memories
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    async healthCheck() {
+        try {
+            const response = await this.client.get('/health');
+            return response.status === 200;
+        }
+        catch {
+            return false;
+        }
+    }
+    async withRetry(fn) {
+        return (0, p_retry_1.default)(fn, {
+            retries: this.retries,
+            minTimeout: 1000,
+            maxTimeout: 10000,
+            onFailedAttempt: (error) => {
+                this.logger?.warn(`API attempt ${error.attemptNumber} failed. ${error.retriesLeft} retries left.`, { error: error.message });
+            },
+        });
+    }
+    updateApiKey(apiKey) {
+        this.client.defaults.headers['X-API-Key'] = apiKey;
+        this.logger?.info('API key updated');
+    }
+    updateUserId(userId) {
+        this.config.userId = userId;
+        this.logger?.info('User ID updated', { userId });
+    }
+}
+exports.RecallBricksClient = RecallBricksClient;
+//# sourceMappingURL=RecallBricksClient.js.map

package/dist/api/RecallBricksClient.js.map

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

package/dist/api/TelemetryClient.d.ts

@@ -0,0 +1,54 @@
+import { Logger } from '../types';
+export interface TelemetryMetrics {
+    avgConfidence: number;
+    reflectionCycles: number;
+    contextHitRate: number;
+    memoryGrowth: number;
+    avgResponseTime?: number;
+    errorRate?: number;
+}
+export interface TelemetryEvent {
+    event: string;
+    timestamp: string;
+    metrics?: Partial<TelemetryMetrics>;
+    metadata?: Record<string, unknown>;
+}
+export interface TelemetryConfig {
+    apiUrl: string;
+    apiKey: string;
+    runtimeVersion: string;
+    flushInterval?: number;
+    batchSize?: number;
+    enabled?: boolean;
+    logger?: Logger;
+}
+export declare class TelemetryClient {
+    private client;
+    private eventQueue;
+    private flushInterval;
+    private batchSize;
+    private flushTimer?;
+    private enabled;
+    private logger?;
+    private runtimeVersion;
+    private apiUrl;
+    private metrics;
+    private sampleCount;
+    constructor(config: TelemetryConfig);
+    track(event: string, metadata?: Record<string, unknown>): void;
+    recordMetric(metric: keyof TelemetryMetrics, value: number): void;
+    recordResponseTime(ms: number): void;
+    recordContextHit(hit: boolean): void;
+    recordConfidence(score: number): void;
+    incrementReflectionCycles(): void;
+    recordMemoryGrowth(count: number): void;
+    recordError(): void;
+    flush(): Promise<void>;
+    private startPeriodicFlush;
+    shutdown(): Promise<void>;
+    setEnabled(enabled: boolean): void;
+    getMetricsSnapshot(): TelemetryMetrics;
+    private resetMetrics;
+    private sanitizeMetadata;
+}
+//# sourceMappingURL=TelemetryClient.d.ts.map

package/dist/api/TelemetryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryClient.d.ts","sourceRoot":"","sources":["../../src/api/TelemetryClient.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,OAAO,CAOb;IACF,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,EAAE,eAAe;IA+BnC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuB9D,YAAY,CAAC,MAAM,EAAE,MAAM,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBjE,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOpC,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAOpC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOrC,yBAAyB,IAAI,IAAI;IAOjC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOvC,WAAW,IAAI,IAAI;IAOb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C5B,OAAO,CAAC,kBAAkB;IAWpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAgBlC,kBAAkB,IAAI,gBAAgB;IAOtC,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,gBAAgB;CAyCzB"}

package/dist/api/TelemetryClient.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+class TelemetryClient {
+    constructor(config) {
+        this.eventQueue = [];
+        this.metrics = {
+            avgConfidence: 0,
+            reflectionCycles: 0,
+            contextHitRate: 0,
+            memoryGrowth: 0,
+            avgResponseTime: 0,
+            errorRate: 0,
+        };
+        this.sampleCount = 0;
+        this.flushInterval = config.flushInterval ?? 60000;
+        this.batchSize = config.batchSize ?? 50;
+        this.enabled = config.enabled ?? true;
+        this.logger = config.logger;
+        this.runtimeVersion = config.runtimeVersion;
+        this.apiUrl = config.apiUrl;
+        this.client = axios_1.default.create({
+            baseURL: this.apiUrl,
+            timeout: 10000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': config.apiKey,
+            },
+        });
+        if (this.enabled) {
+            this.startPeriodicFlush();
+        }
+        this.logger?.debug('TelemetryClient initialized', {
+            enabled: this.enabled,
+            flushInterval: this.flushInterval,
+        });
+    }
+    track(event, metadata) {
+        if (!this.enabled)
+            return;
+        const sanitizedMetadata = this.sanitizeMetadata(metadata);
+        this.eventQueue.push({
+            event,
+            timestamp: new Date().toISOString(),
+            metadata: sanitizedMetadata,
+        });
+        if (this.eventQueue.length >= this.batchSize) {
+            this.flush().catch(() => {
+            });
+        }
+    }
+    recordMetric(metric, value) {
+        if (!this.enabled)
+            return;
+        this.sampleCount++;
+        const prevWeight = (this.sampleCount - 1) / this.sampleCount;
+        const newWeight = 1 / this.sampleCount;
+        this.metrics[metric] =
+            this.metrics[metric] * prevWeight + value * newWeight;
+    }
+    recordResponseTime(ms) {
+        this.recordMetric('avgResponseTime', ms);
+    }
+    recordContextHit(hit) {
+        this.recordMetric('contextHitRate', hit ? 1 : 0);
+    }
+    recordConfidence(score) {
+        this.recordMetric('avgConfidence', score);
+    }
+    incrementReflectionCycles() {
+        this.metrics.reflectionCycles++;
+    }
+    recordMemoryGrowth(count) {
+        this.metrics.memoryGrowth += count;
+    }
+    recordError() {
+        this.recordMetric('errorRate', 1);
+    }
+    async flush() {
+        if (!this.enabled)
+            return;
+        if (this.eventQueue.length === 0 && this.sampleCount === 0)
+            return;
+        this.logger?.debug('Flushing telemetry', {
+            events: this.eventQueue.length,
+            samples: this.sampleCount,
+        });
+        const events = [...this.eventQueue];
+        const metrics = { ...this.metrics };
+        const samples = this.sampleCount;
+        this.eventQueue = [];
+        this.resetMetrics();
+        try {
+            await this.client.post('/api/v1/telemetry', {
+                runtime_version: this.runtimeVersion,
+                metrics: {
+                    avg_confidence: metrics.avgConfidence,
+                    reflection_cycles: metrics.reflectionCycles,
+                    context_hit_rate: metrics.contextHitRate,
+                    memory_growth: metrics.memoryGrowth,
+                    avg_response_time: metrics.avgResponseTime,
+                    error_rate: metrics.errorRate,
+                },
+                events: events.slice(0, 100),
+                sample_count: samples,
+                flushed_at: new Date().toISOString(),
+            });
+            this.logger?.debug('Telemetry flushed successfully');
+        }
+        catch (error) {
+            this.logger?.warn('Telemetry flush failed', { error });
+        }
+    }
+    startPeriodicFlush() {
+        this.flushTimer = setInterval(() => {
+            this.flush().catch(() => {
+            });
+        }, this.flushInterval);
+    }
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        await this.flush();
+        this.logger?.info('TelemetryClient shutdown complete');
+    }
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        if (enabled && !this.flushTimer) {
+            this.startPeriodicFlush();
+        }
+        else if (!enabled && this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        this.logger?.info('Telemetry enabled status changed', { enabled });
+    }
+    getMetricsSnapshot() {
+        return { ...this.metrics };
+    }
+    resetMetrics() {
+        this.metrics = {
+            avgConfidence: 0,
+            reflectionCycles: 0,
+            contextHitRate: 0,
+            memoryGrowth: 0,
+            avgResponseTime: 0,
+            errorRate: 0,
+        };
+        this.sampleCount = 0;
+    }
+    sanitizeMetadata(metadata) {
+        if (!metadata)
+            return undefined;
+        const piiKeys = [
+            'user_id',
+            'userId',
+            'email',
+            'name',
+            'phone',
+            'address',
+            'content',
+            'text',
+            'message',
+            'password',
+            'token',
+            'apiKey',
+            'api_key',
+        ];
+        const sanitized = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            if (piiKeys.some((pii) => key.toLowerCase().includes(pii.toLowerCase()))) {
+                continue;
+            }
+            if (typeof value === 'string' ||
+                typeof value === 'number' ||
+                typeof value === 'boolean') {
+                sanitized[key] = value;
+            }
+        }
+        return Object.keys(sanitized).length > 0 ? sanitized : undefined;
+    }
+}
+exports.TelemetryClient = TelemetryClient;
+//# sourceMappingURL=TelemetryClient.js.map

package/dist/api/TelemetryClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryClient.js","sourceRoot":"","sources":["../../src/api/TelemetryClient.ts"],"names":[],"mappings":";;;;;;AAOA,kDAA6C;AAqC7C,MAAa,eAAe;IAsB1B,YAAY,MAAuB;QApB3B,eAAU,GAAqB,EAAE,CAAC;QAUlC,YAAO,GAAqB;YAClC,aAAa,EAAE,CAAC;YAChB,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,CAAC;SACb,CAAC;QACM,gBAAW,GAAG,CAAC,CAAC;QAGtB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE5B,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM,CAAC,MAAM;aAC3B;SACF,CAAC,CAAC;QAGH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,6BAA6B,EAAE;YAChD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAKD,KAAK,CAAC,KAAa,EAAE,QAAkC;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAG1B,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,iBAAiB;SAC5B,CAAC,CAAC;QAGH,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAExB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAKD,YAAY,CAAC,MAA8B,EAAE,KAAa;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,CAAC,WAAW,EAAE,CAAC;QAGnB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAEvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAY,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IACtE,CAAC;IAKD,kBAAkB,CAAC,EAAU;QAC3B,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAKD,gBAAgB,CAAC,GAAY;QAC3B,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IAKD,gBAAgB,CAAC,KAAa;QAC5B,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAKD,yBAAyB;QACvB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAClC,CAAC;IAKD,kBAAkB,CAAC,KAAa;QAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACrC,CAAC;IAKD,WAAW;QACT,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAKD,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC;YAAE,OAAO;QAEnE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,oBAAoB,EAAE;YACvC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;YAC9B,OAAO,EAAE,IAAI,CAAC,WAAW;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;QAGjC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC1C,eAAe,EAAE,IAAI,CAAC,cAAc;gBACpC,OAAO,EAAE;oBACP,cAAc,EAAE,OAAO,CAAC,aAAa;oBACrC,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;oBAC3C,gBAAgB,EAAE,OAAO,CAAC,cAAc;oBACxC,aAAa,EAAE,OAAO,CAAC,YAAY;oBACnC,iBAAiB,EAAE,OAAO,CAAC,eAAe;oBAC1C,UAAU,EAAE,OAAO,CAAC,SAAS;iBAC9B;gBACD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC5B,YAAY,EAAE,OAAO;gBACrB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAKO,kBAAkB;QACxB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YAExB,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IAKD,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAGD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAKD,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAKD,kBAAkB;QAChB,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAKO,YAAY;QAClB,IAAI,CAAC,OAAO,GAAG;YACb,aAAa,EAAE,CAAC;YAChB,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,CAAC;SACb,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAKO,gBAAgB,CACtB,QAAkC;QAElC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,OAAO,GAAG;YACd,SAAS;YACT,QAAQ;YACR,OAAO;YACP,MAAM;YACN,OAAO;YACP,SAAS;YACT,SAAS;YACT,MAAM;YACN,SAAS;YACT,UAAU;YACV,OAAO;YACP,QAAQ;YACR,SAAS;SACV,CAAC;QAEF,MAAM,SAAS,GAA4B,EAAE,CAAC;QAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAEpD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzE,SAAS;YACX,CAAC;YAGD,IACE,OAAO,KAAK,KAAK,QAAQ;gBACzB,OAAO,KAAK,KAAK,QAAQ;gBACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;gBACD,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;CACF;AAzRD,0CAyRC"}

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+export { RecallBricksClient } from './RecallBricksClient';
+export type { RecallBricksClientConfig, SaveMemoryRequest, RecallMemoriesRequest, RegisterAgentRequest, RegisterAgentResponse, RuntimeHeuristics, } from './RecallBricksClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecallBricksClient = void 0;
+var RecallBricksClient_1 = require("./RecallBricksClient");
+Object.defineProperty(exports, "RecallBricksClient", { enumerable: true, get: function () { return RecallBricksClient_1.RecallBricksClient; } });
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;AAIA,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA"}

package/dist/config/index.d.ts

@@ -0,0 +1,13 @@
+import { RuntimeConfig, RuntimeOptions, Logger } from '../types';
+export declare class ConfigBuilder {
+    private logger;
+    constructor(debug?: boolean);
+    fromEnvironment(): RuntimeConfig;
+    fromOptions(options: RuntimeOptions): RuntimeConfig;
+    private buildLLMConfig;
+    private validateConfig;
+}
+export declare function createLogger(debug?: boolean): Logger;
+export declare function buildConfigFromEnv(): RuntimeConfig;
+export declare function buildConfigFromOptions(options: RuntimeOptions): RuntimeConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EACb,cAAc,EAKd,MAAM,EAEP,MAAM,UAAU,CAAC;AAwGlB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,KAAK,UAAQ;IAOzB,eAAe,IAAI,aAAa;IAkDhC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IA4CnD,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,cAAc;CA0CvB;AAMD,wBAAgB,YAAY,CAAC,KAAK,UAAQ,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAGlD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAG7E"}

package/dist/config/index.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigBuilder = void 0;
+exports.createLogger = createLogger;
+exports.buildConfigFromEnv = buildConfigFromEnv;
+exports.buildConfigFromOptions = buildConfigFromOptions;
+const types_1 = require("../types");
+const DEFAULT_API_URL = 'https://recallbricks-api-clean.onrender.com';
+const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
+const DEFAULT_MAX_CONTEXT_TOKENS = 4000;
+const DEFAULT_TIER = 'starter';
+const DEFAULT_TEMPERATURE = 0.7;
+const DEFAULT_MAX_TOKENS = 2048;
+const DEFAULT_MODELS = {
+    anthropic: 'claude-sonnet-4-5-20250929',
+    openai: 'gpt-4-turbo-preview',
+    gemini: 'gemini-1.5-pro',
+    ollama: 'llama3.2',
+    cohere: 'command-r-plus',
+    local: 'local-model',
+};
+class ConsoleLogger {
+    constructor(level = 'info') {
+        this.level = level;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const currentIndex = levels.indexOf(this.level);
+        const messageIndex = levels.indexOf(level);
+        return messageIndex >= currentIndex;
+    }
+    debug(message, meta) {
+        if (this.shouldLog('debug')) {
+            console.error(`[DEBUG] ${message}`, meta || '');
+        }
+    }
+    info(message, meta) {
+        if (this.shouldLog('info')) {
+            console.error(`[INFO] ${message}`, meta || '');
+        }
+    }
+    warn(message, meta) {
+        if (this.shouldLog('warn')) {
+            console.warn(`[WARN] ${message}`, meta || '');
+        }
+    }
+    error(message, meta) {
+        if (this.shouldLog('error')) {
+            console.error(`[ERROR] ${message}`, meta || '');
+        }
+    }
+}
+function getEnv(key, defaultValue) {
+    return process.env[key] || defaultValue;
+}
+function getEnvRequired(key) {
+    const value = process.env[key];
+    if (!value) {
+        throw new types_1.ConfigurationError(`Required environment variable ${key} is not set`);
+    }
+    return value;
+}
+function getEnvBoolean(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return value.toLowerCase() === 'true' || value === '1';
+}
+function getEnvNumber(key, defaultValue) {
+    const value = process.env[key];
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        return defaultValue;
+    }
+    return parsed;
+}
+class ConfigBuilder {
+    constructor(debug = false) {
+        this.logger = new ConsoleLogger(debug ? 'debug' : 'info');
+    }
+    fromEnvironment() {
+        this.logger.debug('Building configuration from environment variables');
+        const agentId = getEnv('RECALLBRICKS_AGENT_ID');
+        const userId = getEnv('RECALLBRICKS_USER_ID');
+        if (!agentId || !userId) {
+            throw new types_1.ConfigurationError('RECALLBRICKS_AGENT_ID and RECALLBRICKS_USER_ID must be set');
+        }
+        const llmProvider = (getEnv('RECALLBRICKS_LLM_PROVIDER', 'anthropic') ||
+            'anthropic');
+        const llmApiKey = getEnvRequired('RECALLBRICKS_API_KEY');
+        const config = {
+            agentId,
+            userId,
+            agentName: getEnv('RECALLBRICKS_AGENT_NAME'),
+            agentPurpose: getEnv('RECALLBRICKS_AGENT_PURPOSE'),
+            apiUrl: getEnv('RECALLBRICKS_API_URL', DEFAULT_API_URL),
+            apiKey: getEnv('RECALLBRICKS_API_KEY', ''),
+            llmConfig: this.buildLLMConfig(llmProvider, llmApiKey),
+            tier: (getEnv('RECALLBRICKS_TIER', DEFAULT_TIER) ||
+                DEFAULT_TIER),
+            autoSave: getEnvBoolean('RECALLBRICKS_AUTO_SAVE', true),
+            validateIdentity: getEnvBoolean('RECALLBRICKS_VALIDATE_IDENTITY', true),
+            cacheEnabled: getEnvBoolean('RECALLBRICKS_CACHE_ENABLED', true),
+            cacheTTL: getEnvNumber('RECALLBRICKS_CACHE_TTL', DEFAULT_CACHE_TTL),
+            maxContextTokens: getEnvNumber('RECALLBRICKS_MAX_CONTEXT_TOKENS', DEFAULT_MAX_CONTEXT_TOKENS),
+            debug: getEnvBoolean('RECALLBRICKS_DEBUG', false),
+        };
+        this.validateConfig(config);
+        this.logger.info('Configuration built successfully', {
+            agentId: config.agentId,
+            provider: config.llmConfig?.provider,
+            tier: config.tier,
+        });
+        return config;
+    }
+    fromOptions(options) {
+        this.logger.debug('Building configuration from options');
+        const mcpMode = options.mcpMode || false;
+        const llmProvider = options.llmProvider || 'anthropic';
+        const llmApiKey = options.llmApiKey;
+        if (!mcpMode && !llmApiKey) {
+            throw new types_1.ConfigurationError('LLM API key is required');
+        }
+        const config = {
+            agentId: options.agentId,
+            userId: options.userId,
+            agentName: options.agentName,
+            agentPurpose: options.agentPurpose,
+            apiUrl: options.apiUrl || DEFAULT_API_URL,
+            apiKey: options.apiKey || getEnv('RECALLBRICKS_API_KEY', ''),
+            llmConfig: llmApiKey ? this.buildLLMConfig(llmProvider, llmApiKey, options.llmModel) : undefined,
+            tier: options.tier || DEFAULT_TIER,
+            autoSave: options.autoSave !== undefined ? options.autoSave : true,
+            validateIdentity: options.validateIdentity !== undefined
+                ? options.validateIdentity
+                : true,
+            cacheEnabled: options.cacheEnabled !== undefined ? options.cacheEnabled : true,
+            cacheTTL: options.cacheTTL || DEFAULT_CACHE_TTL,
+            maxContextTokens: options.maxContextTokens || DEFAULT_MAX_CONTEXT_TOKENS,
+            debug: options.debug || false,
+            mcpMode,
+            registerAgent: options.registerAgent || false,
+        };
+        this.validateConfig(config);
+        this.logger.info('Configuration built successfully from options');
+        return config;
+    }
+    buildLLMConfig(provider, apiKey, model) {
+        const defaultModel = DEFAULT_MODELS[provider];
+        return {
+            provider,
+            apiKey,
+            model: model || getEnv('RECALLBRICKS_LLM_MODEL', defaultModel),
+            temperature: getEnvNumber('RECALLBRICKS_LLM_TEMPERATURE', DEFAULT_TEMPERATURE),
+            maxTokens: getEnvNumber('RECALLBRICKS_LLM_MAX_TOKENS', DEFAULT_MAX_TOKENS),
+            baseUrl: getEnv('RECALLBRICKS_LLM_BASE_URL'),
+        };
+    }
+    validateConfig(config) {
+        if (!config.agentId || config.agentId.trim().length === 0) {
+            throw new types_1.ConfigurationError('Agent ID cannot be empty');
+        }
+        if (!config.userId || config.userId.trim().length === 0) {
+            throw new types_1.ConfigurationError('User ID cannot be empty');
+        }
+        if (!config.mcpMode && config.llmConfig) {
+            if (!config.llmConfig.apiKey || config.llmConfig.apiKey.trim().length === 0) {
+                throw new types_1.ConfigurationError('LLM API key cannot be empty');
+            }
+            const validProviders = ['anthropic', 'openai', 'gemini', 'ollama', 'cohere', 'local'];
+            if (!validProviders.includes(config.llmConfig.provider)) {
+                throw new types_1.ConfigurationError(`Invalid LLM provider: ${config.llmConfig.provider}. Must be one of: ${validProviders.join(', ')}`);
+            }
+        }
+        if (!config.apiUrl || config.apiUrl.trim().length === 0) {
+            throw new types_1.ConfigurationError('API URL cannot be empty');
+        }
+        const validTiers = ['starter', 'professional', 'enterprise'];
+        if (config.tier && !validTiers.includes(config.tier)) {
+            throw new types_1.ConfigurationError(`Invalid tier: ${config.tier}. Must be one of: ${validTiers.join(', ')}`);
+        }
+        if (config.cacheTTL && config.cacheTTL < 0) {
+            throw new types_1.ConfigurationError('Cache TTL must be non-negative');
+        }
+        if (config.maxContextTokens && config.maxContextTokens < 100) {
+            throw new types_1.ConfigurationError('Max context tokens must be at least 100');
+        }
+    }
+}
+exports.ConfigBuilder = ConfigBuilder;
+function createLogger(debug = false) {
+    return new ConsoleLogger(debug ? 'debug' : 'info');
+}
+function buildConfigFromEnv() {
+    const builder = new ConfigBuilder();
+    return builder.fromEnvironment();
+}
+function buildConfigFromOptions(options) {
+    const builder = new ConfigBuilder(options.debug);
+    return builder.fromOptions(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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