@recallbricks/runtime 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitBreaker.d.ts","sourceRoot":"","sources":["../../src/core/CircuitBreaker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMlC,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAUxD;AAMD,qBAAa,cAAc;IAavB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAbhB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAK;gBAGnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM;IAUlB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BlD,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,SAAS;IAyBjB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,oBAAoB;IAY5B,QAAQ,IAAI,YAAY;IAOxB,QAAQ,IAAI,mBAAmB;IAgB/B,UAAU,IAAI,IAAI;IAQlB,SAAS,IAAI,IAAI;IAQjB,UAAU,IAAI,IAAI;CAQnB;AAMD,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAqC;gBAEjC,MAAM,EAAE,MAAM;IAKlC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,cAAc;IAsBjF,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAOrC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAWlD,aAAa,IAAI,IAAI;IAUrB,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB;CAeF"}

package/dist/core/CircuitBreaker.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerManager = exports.CircuitBreaker = exports.CircuitBreakerOpenError = void 0;
+class CircuitBreakerOpenError extends Error {
+    constructor(circuitName, nextRetryTime) {
+        super(`Circuit breaker "${circuitName}" is OPEN. ${nextRetryTime
+            ? `Next retry at ${new Date(nextRetryTime).toISOString()}`
+            : 'Service unavailable'}`);
+        this.name = 'CircuitBreakerOpenError';
+    }
+}
+exports.CircuitBreakerOpenError = CircuitBreakerOpenError;
+class CircuitBreaker {
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        this.state = 'closed';
+        this.failures = 0;
+        this.successes = 0;
+        this.totalRequests = 0;
+        this.stateChanges = 0;
+        this.createdAt = Date.now();
+        this.halfOpenAttempts = 0;
+        this.logger.info(`Circuit breaker "${config.name}" initialized`, {
+            config,
+        });
+    }
+    async execute(fn) {
+        this.totalRequests++;
+        if (this.state === 'open') {
+            if (this.shouldAttemptReset()) {
+                this.transitionToHalfOpen();
+            }
+            else {
+                this.logger.warn(`Circuit breaker "${this.config.name}" is OPEN`, {
+                    nextRetryTime: this.nextRetryTime,
+                });
+                throw new CircuitBreakerOpenError(this.config.name, this.nextRetryTime);
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure(error);
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.successes++;
+        this.lastSuccessTime = Date.now();
+        if (this.state === 'half-open') {
+            this.halfOpenAttempts++;
+            if (this.halfOpenAttempts >= this.config.halfOpenMaxAttempts) {
+                this.transitionToClosed();
+            }
+            this.logger.debug(`Circuit breaker "${this.config.name}" half-open success`, {
+                attempts: this.halfOpenAttempts,
+                max: this.config.halfOpenMaxAttempts,
+            });
+        }
+        if (this.state === 'closed' && this.failures > 0) {
+            this.failures = 0;
+        }
+    }
+    onFailure(error) {
+        this.failures++;
+        this.lastFailureTime = Date.now();
+        this.logger.warn(`Circuit breaker "${this.config.name}" failure`, {
+            error: error instanceof Error ? error.message : String(error),
+            failures: this.failures,
+            threshold: this.config.failureThreshold,
+            state: this.state,
+        });
+        if (this.state === 'half-open') {
+            this.transitionToOpen();
+        }
+        else if (this.state === 'closed') {
+            if (this.failures >= this.config.failureThreshold) {
+                this.transitionToOpen();
+            }
+        }
+    }
+    shouldAttemptReset() {
+        if (!this.nextRetryTime) {
+            return false;
+        }
+        return Date.now() >= this.nextRetryTime;
+    }
+    transitionToClosed() {
+        this.logger.info(`Circuit breaker "${this.config.name}" transitioning to CLOSED`);
+        this.state = 'closed';
+        this.failures = 0;
+        this.halfOpenAttempts = 0;
+        this.nextRetryTime = undefined;
+        this.stateChanges++;
+    }
+    transitionToOpen() {
+        this.logger.error(`Circuit breaker "${this.config.name}" transitioning to OPEN`, {
+            failures: this.failures,
+            threshold: this.config.failureThreshold,
+        });
+        this.state = 'open';
+        this.halfOpenAttempts = 0;
+        this.nextRetryTime = Date.now() + this.config.resetTimeout;
+        this.stateChanges++;
+    }
+    transitionToHalfOpen() {
+        this.logger.info(`Circuit breaker "${this.config.name}" transitioning to HALF-OPEN`);
+        this.state = 'half-open';
+        this.halfOpenAttempts = 0;
+        this.stateChanges++;
+    }
+    getState() {
+        return this.state;
+    }
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            totalRequests: this.totalRequests,
+            lastFailureTime: this.lastFailureTime,
+            lastSuccessTime: this.lastSuccessTime,
+            stateChanges: this.stateChanges,
+            uptime: Date.now() - this.createdAt,
+        };
+    }
+    forceClose() {
+        this.logger.warn(`Circuit breaker "${this.config.name}" force closed`);
+        this.transitionToClosed();
+    }
+    forceOpen() {
+        this.logger.warn(`Circuit breaker "${this.config.name}" force opened`);
+        this.transitionToOpen();
+    }
+    resetStats() {
+        this.failures = 0;
+        this.successes = 0;
+        this.totalRequests = 0;
+        this.lastFailureTime = undefined;
+        this.lastSuccessTime = undefined;
+        this.logger.debug(`Circuit breaker "${this.config.name}" stats reset`);
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+class CircuitBreakerManager {
+    constructor(logger) {
+        this.logger = logger;
+        this.breakers = new Map();
+    }
+    getOrCreate(name, config) {
+        if (this.breakers.has(name)) {
+            return this.breakers.get(name);
+        }
+        const defaultConfig = {
+            failureThreshold: 5,
+            resetTimeout: 60000,
+            monitorInterval: 120000,
+            halfOpenMaxAttempts: 3,
+            name,
+            ...config,
+        };
+        const breaker = new CircuitBreaker(defaultConfig, this.logger);
+        this.breakers.set(name, breaker);
+        return breaker;
+    }
+    getAll() {
+        return new Map(this.breakers);
+    }
+    getAllStats() {
+        const stats = {};
+        for (const [name, breaker] of this.breakers) {
+            stats[name] = breaker.getStats();
+        }
+        return stats;
+    }
+    forceCloseAll() {
+        this.logger.warn('Force closing all circuit breakers');
+        for (const breaker of this.breakers.values()) {
+            breaker.forceClose();
+        }
+    }
+    getHealth() {
+        const openCircuits = [];
+        for (const [name, breaker] of this.breakers) {
+            if (breaker.getState() === 'open') {
+                openCircuits.push(name);
+            }
+        }
+        return {
+            healthy: openCircuits.length === 0,
+            openCircuits,
+            totalCircuits: this.breakers.size,
+        };
+    }
+}
+exports.CircuitBreakerManager = CircuitBreakerManager;
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/core/CircuitBreaker.js.map

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

package/dist/core/ContextLoader.d.ts

@@ -0,0 +1,31 @@
+import { AgentIdentity, MemoryContext, ContextPrompt, GetContextResponse, Logger } from '../types';
+interface ContextLoaderConfig {
+    apiUrl: string;
+    apiKey: string;
+    agentId: string;
+    userId: string;
+    agentName?: string;
+    agentPurpose?: string;
+    cacheEnabled: boolean;
+    cacheTTL: number;
+    maxContextTokens: number;
+    logger: Logger;
+}
+export declare class ContextLoader {
+    private config;
+    private apiClient;
+    private identityCache?;
+    private contextCache?;
+    constructor(config: ContextLoaderConfig);
+    loadContext(): Promise<GetContextResponse>;
+    private transformRecallToContext;
+    loadIdentity(): Promise<AgentIdentity>;
+    formatContextPrompt(identity: AgentIdentity, context: MemoryContext): ContextPrompt;
+    private formatIdentitySection;
+    private formatMemorySection;
+    private formatRulesSection;
+    clearCache(): void;
+    private handleAPIError;
+}
+export {};
+//# sourceMappingURL=ContextLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextLoader.d.ts","sourceRoot":"","sources":["../../src/core/ContextLoader.ts"],"names":[],"mappings":"AASA,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAKlB,MAAM,EAEP,MAAM,UAAU,CAAC;AAMlB,UAAU,mBAAmB;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,aAAa;IAKZ,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,aAAa,CAAC,CAA8C;IACpE,OAAO,CAAC,YAAY,CAAC,CAA8C;gBAE/C,MAAM,EAAE,mBAAmB;IA+BzC,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAwEhD,OAAO,CAAC,wBAAwB;IAoC1B,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAgD5C,mBAAmB,CACjB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,GACrB,aAAa;IA0BhB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,kBAAkB;IAgB1B,UAAU,IAAI,IAAI;IAalB,OAAO,CAAC,cAAc;CAoBvB"}

package/dist/core/ContextLoader.js

@@ -0,0 +1,236 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextLoader = void 0;
+const axios_1 = __importDefault(require("axios"));
+const lru_cache_1 = require("lru-cache");
+const p_retry_1 = __importDefault(require("p-retry"));
+const types_1 = require("../types");
+class ContextLoader {
+    constructor(config) {
+        this.config = config;
+        this.apiClient = axios_1.default.create({
+            baseURL: config.apiUrl,
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': config.apiKey,
+            },
+        });
+        if (config.cacheEnabled) {
+            this.identityCache = new lru_cache_1.LRUCache({
+                max: 100,
+                ttl: config.cacheTTL,
+            });
+            this.contextCache = new lru_cache_1.LRUCache({
+                max: 500,
+                ttl: config.cacheTTL,
+            });
+            config.logger.debug('Context caching enabled', {
+                cacheTTL: config.cacheTTL,
+            });
+        }
+    }
+    async loadContext() {
+        this.config.logger.debug('Loading context', {
+            agentId: this.config.agentId,
+            userId: this.config.userId,
+        });
+        try {
+            const response = await (0, p_retry_1.default)(async () => {
+                const result = await this.apiClient.get('/api/v1/memories/recall', {
+                    params: {
+                        query: 'recent interactions and context',
+                        limit: 20,
+                        organized: true,
+                        user_id: this.config.userId,
+                    },
+                });
+                return result.data;
+            }, {
+                retries: 3,
+                minTimeout: 1000,
+                onFailedAttempt: (error) => {
+                    this.config.logger.warn(`Context load attempt ${error.attemptNumber} failed. ${error.retriesLeft} retries left.`);
+                },
+            });
+            const context = this.transformRecallToContext(response);
+            const identity = await this.loadIdentity();
+            if (this.identityCache) {
+                this.identityCache.set(this.config.agentId, {
+                    data: identity,
+                    timestamp: Date.now(),
+                    ttl: this.config.cacheTTL,
+                });
+            }
+            if (this.contextCache) {
+                const cacheKey = `${this.config.agentId}:${this.config.userId}`;
+                this.contextCache.set(cacheKey, {
+                    data: context,
+                    timestamp: Date.now(),
+                    ttl: this.config.cacheTTL,
+                });
+            }
+            this.config.logger.info('Context loaded successfully', {
+                memoryCount: context.totalMemories,
+                recentCount: context.recentMemories.length,
+            });
+            return { identity, context };
+        }
+        catch (error) {
+            this.config.logger.error('Failed to load context', { error });
+            throw this.handleAPIError(error);
+        }
+    }
+    transformRecallToContext(response) {
+        const memories = response.memories.map((mem) => ({
+            id: mem.id,
+            content: mem.text,
+            type: 'conversation',
+            importance: mem.metadata?.importance ?? 0.5,
+            timestamp: mem.created_at,
+            metadata: mem.metadata,
+            tags: mem.metadata?.tags,
+        }));
+        const recentMemories = memories.slice(0, 10);
+        const relevantMemories = memories
+            .slice(10)
+            .sort((a, b) => (b.importance ?? 0) - (a.importance ?? 0))
+            .slice(0, 5);
+        const predictedContext = response.categories
+            ? Object.keys(response.categories).slice(0, 5)
+            : [];
+        return {
+            recentMemories,
+            relevantMemories,
+            predictedContext,
+            totalMemories: response.total,
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+    async loadIdentity() {
+        if (this.identityCache) {
+            const cached = this.identityCache.get(this.config.agentId);
+            if (cached && Date.now() - cached.timestamp < cached.ttl) {
+                this.config.logger.debug('Identity loaded from cache');
+                return cached.data;
+            }
+        }
+        this.config.logger.debug('Building identity from config', {
+            agentId: this.config.agentId,
+        });
+        const identity = {
+            id: this.config.agentId,
+            name: this.config.agentName || 'RecallBricks Agent',
+            purpose: this.config.agentPurpose || 'A persistent cognitive agent with continuous memory',
+            traits: ['helpful', 'knowledgeable', 'consistent'],
+            rules: [
+                'Maintain consistency with your identity and purpose',
+                'Reference your continuous memory when relevant',
+                'Never claim to be a base model like Claude or GPT',
+            ],
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        if (this.identityCache) {
+            this.identityCache.set(this.config.agentId, {
+                data: identity,
+                timestamp: Date.now(),
+                ttl: this.config.cacheTTL,
+            });
+        }
+        this.config.logger.info('Identity built successfully', {
+            agentName: identity.name,
+        });
+        return identity;
+    }
+    formatContextPrompt(identity, context) {
+        this.config.logger.debug('Formatting context prompt');
+        const identitySection = this.formatIdentitySection(identity);
+        const memorySection = this.formatMemorySection(context);
+        const rulesSection = this.formatRulesSection(identity);
+        const systemPrompt = `${identitySection}\n\n${memorySection}\n\n${rulesSection}`;
+        return {
+            systemPrompt,
+            identitySection,
+            memorySection,
+            rulesSection,
+        };
+    }
+    formatIdentitySection(identity) {
+        const traits = identity.traits.join(', ');
+        return `You are ${identity.name}, a persistent cognitive agent built on RecallBricks.
+
+Your purpose: ${identity.purpose}
+Your traits: ${traits}
+
+CRITICAL: Never refer to yourself as the base model (Claude, ChatGPT, GPT, Assistant, etc.).
+You are ${identity.name} with continuous memory and persistent identity across all conversations.`;
+    }
+    formatMemorySection(context) {
+        if (context.recentMemories.length === 0 &&
+            context.relevantMemories.length === 0) {
+            return 'Recent context from your memory:\nNo previous interactions found. This is a new conversation.';
+        }
+        let memoryText = 'Recent context from your memory:\n\n';
+        if (context.recentMemories.length > 0) {
+            memoryText += 'Recent interactions:\n';
+            context.recentMemories.slice(0, 5).forEach((memory, index) => {
+                memoryText += `${index + 1}. ${memory.content}\n`;
+            });
+            memoryText += '\n';
+        }
+        if (context.relevantMemories.length > 0) {
+            memoryText += 'Relevant context:\n';
+            context.relevantMemories.slice(0, 5).forEach((memory, index) => {
+                memoryText += `${index + 1}. ${memory.content}\n`;
+            });
+            memoryText += '\n';
+        }
+        if (context.predictedContext.length > 0) {
+            memoryText += 'Predicted relevant topics:\n';
+            memoryText += context.predictedContext.slice(0, 3).join(', ');
+            memoryText += '\n';
+        }
+        return memoryText.trim();
+    }
+    formatRulesSection(identity) {
+        if (identity.rules.length === 0) {
+            return 'Behavioral guidelines:\n- Maintain consistency with your identity and purpose\n- Reference your continuous memory when relevant';
+        }
+        let rulesText = 'Behavioral guidelines:\n';
+        identity.rules.forEach((rule, index) => {
+            rulesText += `${index + 1}. ${rule}\n`;
+        });
+        return rulesText.trim();
+    }
+    clearCache() {
+        if (this.identityCache) {
+            this.identityCache.clear();
+        }
+        if (this.contextCache) {
+            this.contextCache.clear();
+        }
+        this.config.logger.debug('Context caches cleared');
+    }
+    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.ContextLoader = ContextLoader;
+//# sourceMappingURL=ContextLoader.js.map

package/dist/core/ContextLoader.js.map

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

package/dist/core/ContextWeaver.d.ts

@@ -0,0 +1,49 @@
+import { RecallBricksClient } from '../api/RecallBricksClient';
+import { Memory, AgentIdentity, ContextPrompt, Logger } from '../types';
+export interface ContextWeaverConfig {
+    apiClient: RecallBricksClient;
+    agentId: string;
+    agentName: string;
+    agentPurpose: string;
+    maxContextMemories: number;
+    maxContextTokens: number;
+    logger: Logger;
+}
+export interface Context {
+    identity: AgentIdentity;
+    memories: Memory[];
+    recentMemories: Memory[];
+    relevantMemories: Memory[];
+    predictedTopics: string[];
+    totalMemoriesAvailable: number;
+    systemPrompt: string;
+}
+export interface ContextBuildOptions {
+    query?: string;
+    includeRecent?: boolean;
+    includeRelevant?: boolean;
+    maxMemories?: number;
+}
+export declare class ContextWeaver {
+    private config;
+    private identity;
+    private lastContext?;
+    constructor(config: ContextWeaverConfig);
+    buildContext(query: string, options?: ContextBuildOptions): Promise<Context>;
+    getIdentity(): AgentIdentity;
+    updateIdentity(updates: Partial<AgentIdentity>): void;
+    getLastContext(): Context | undefined;
+    formatContextPrompt(context: Context): ContextPrompt;
+    private transformMemories;
+    private rankMemories;
+    private getRecentMemories;
+    private getRelevantMemories;
+    private deduplicateMemories;
+    private buildSystemPrompt;
+    private formatIdentitySection;
+    private formatMemorySection;
+    private formatRulesSection;
+    estimateTokenCount(text: string): number;
+    trimToTokenLimit(context: Context, maxTokens: number): Context;
+}
+//# sourceMappingURL=ContextWeaver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextWeaver.d.ts","sourceRoot":"","sources":["../../src/core/ContextWeaver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,MAAM,EACN,aAAa,EACb,aAAa,EAEb,MAAM,EACP,MAAM,UAAU,CAAC;AAMlB,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,aAAa;IAIZ,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAC,CAAU;gBAEV,MAAM,EAAE,mBAAmB;IA0BzC,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC;IA4EnB,WAAW,IAAI,aAAa;IAO5B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAQrD,cAAc,IAAI,OAAO,GAAG,SAAS;IAOrC,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAYpD,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,kBAAkB;IAgB1B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQxC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAkC/D"}