claude-cortex 1.0.0

package/dist/embeddings/generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generate embedding vector for text
+ * @param text - Text to embed (title + content recommended)
+ * @returns Float32Array of 384 dimensions
+ */
+export declare function generateEmbedding(text: string): Promise<Float32Array>;
+/**
+ * Calculate cosine similarity between two embeddings
+ * @returns Similarity score 0-1 (1 = identical)
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * Check if embedding model is loaded
+ */
+export declare function isModelLoaded(): boolean;
+/**
+ * Preload the model (call during startup if desired)
+ */
+export declare function preloadModel(): Promise<void>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/embeddings/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/embeddings/generator.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAY3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAmBzE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD"}

package/dist/embeddings/generator.js

@@ -0,0 +1,77 @@
+import { pipeline, env } from '@xenova/transformers';
+// Configure for local-only operation
+env.allowRemoteModels = true;
+env.allowLocalModels = true;
+let embeddingPipeline = null;
+let isLoading = false;
+let loadPromise = null;
+/**
+ * Lazy-load the embedding model
+ * Model: all-MiniLM-L6-v2 (22MB, 384 dimensions)
+ */
+async function getEmbeddingPipeline() {
+    if (embeddingPipeline)
+        return embeddingPipeline;
+    if (isLoading && loadPromise) {
+        return loadPromise;
+    }
+    isLoading = true;
+    loadPromise = pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+    try {
+        embeddingPipeline = await loadPromise;
+        return embeddingPipeline;
+    }
+    finally {
+        isLoading = false;
+        loadPromise = null;
+    }
+}
+/**
+ * Generate embedding vector for text
+ * @param text - Text to embed (title + content recommended)
+ * @returns Float32Array of 384 dimensions
+ */
+export async function generateEmbedding(text) {
+    const extractor = await getEmbeddingPipeline();
+    // Truncate to ~512 tokens worth (~2000 chars) for model limits
+    const truncated = text.slice(0, 2000);
+    const output = await extractor(truncated, {
+        pooling: 'mean',
+        normalize: true,
+    });
+    return new Float32Array(output.data);
+}
+/**
+ * Calculate cosine similarity between two embeddings
+ * @returns Similarity score 0-1 (1 = identical)
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Embedding dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+    if (magnitude === 0)
+        return 0;
+    return dotProduct / magnitude;
+}
+/**
+ * Check if embedding model is loaded
+ */
+export function isModelLoaded() {
+    return embeddingPipeline !== null;
+}
+/**
+ * Preload the model (call during startup if desired)
+ */
+export async function preloadModel() {
+    await getEmbeddingPipeline();
+}
+//# sourceMappingURL=generator.js.map

package/dist/embeddings/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/embeddings/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAErD,qCAAqC;AACrC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;AAC7B,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAE5B,IAAI,iBAAiB,GAAQ,IAAI,CAAC;AAClC,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,IAAI,WAAW,GAAwB,IAAI,CAAC;AAE5C;;;GAGG;AACH,KAAK,UAAU,oBAAoB;IACjC,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAC;IAEhD,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS,GAAG,IAAI,CAAC;IACjB,WAAW,GAAG,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;IAExE,IAAI,CAAC;QACH,iBAAiB,GAAG,MAAM,WAAW,CAAC;QACtC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,SAAS,GAAG,KAAK,CAAC;QAClB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,SAAS,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAE/C,+DAA+D;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE;QACxC,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC/D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE9B,OAAO,UAAU,GAAG,SAAS,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,KAAK,IAAI,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,oBAAoB,EAAE,CAAC;AAC/B,CAAC"}

package/dist/embeddings/index.d.ts

@@ -0,0 +1,2 @@
+export { generateEmbedding, cosineSimilarity, isModelLoaded, preloadModel } from './generator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/embeddings/index.js

@@ -0,0 +1,2 @@
+export { generateEmbedding, cosineSimilarity, isModelLoaded, preloadModel } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Custom Error Classes
+ *
+ * Provides actionable error messages that help users understand
+ * what went wrong and how to fix it.
+ */
+/**
+ * Base class for Claude Memory errors
+ */
+export declare class MemoryError extends Error {
+    readonly code: string;
+    readonly suggestion: string;
+    constructor(message: string, code: string, suggestion: string);
+    toUserMessage(): string;
+}
+/**
+ * Database blocked due to size limits
+ */
+export declare class DatabaseBlockedError extends MemoryError {
+    constructor(currentSize: string);
+}
+/**
+ * Database size warning (approaching limit)
+ */
+export declare class DatabaseSizeWarning extends MemoryError {
+    constructor(currentSize: string);
+}
+/**
+ * Memory not found
+ */
+export declare class MemoryNotFoundError extends MemoryError {
+    constructor(id: number);
+}
+/**
+ * Invalid search query
+ */
+export declare class InvalidQueryError extends MemoryError {
+    constructor(query: string, reason: string);
+}
+/**
+ * Content too large
+ */
+export declare class ContentTooLargeError extends MemoryError {
+    constructor(contentSize: number, maxSize: number);
+}
+/**
+ * Bulk delete safety guard
+ */
+export declare class BulkDeleteSafetyError extends MemoryError {
+    constructor(count: number);
+}
+/**
+ * Database not initialized
+ */
+export declare class DatabaseNotInitializedError extends MemoryError {
+    constructor();
+}
+/**
+ * Session not found
+ */
+export declare class SessionNotFoundError extends MemoryError {
+    constructor(sessionId: number);
+}
+/**
+ * Invalid memory relationship
+ */
+export declare class InvalidRelationshipError extends MemoryError {
+    constructor(sourceId: number, targetId: number, reason: string);
+}
+/**
+ * Format error for MCP tool output
+ */
+export declare function formatErrorForMcp(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAO7D,aAAa,IAAI,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,WAAW,EAAE,MAAM;CAQhC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,WAAW,EAAE,MAAM;CAQhC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,EAAE,EAAE,MAAM;CAQvB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ1C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAUjD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,KAAK,EAAE,MAAM;CAQ1B;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,WAAW;;CAS3D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,SAAS,EAAE,MAAM;CAQ9B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBxD"}

package/dist/errors.js

@@ -0,0 +1,131 @@
+/**
+ * Custom Error Classes
+ *
+ * Provides actionable error messages that help users understand
+ * what went wrong and how to fix it.
+ */
+/**
+ * Base class for Claude Memory errors
+ */
+export class MemoryError extends Error {
+    code;
+    suggestion;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.name = 'MemoryError';
+        this.code = code;
+        this.suggestion = suggestion;
+    }
+    toUserMessage() {
+        return `${this.message}\n\nSuggestion: ${this.suggestion}`;
+    }
+}
+/**
+ * Database blocked due to size limits
+ */
+export class DatabaseBlockedError extends MemoryError {
+    constructor(currentSize) {
+        super(`Database blocked: ${currentSize} exceeds the 100MB limit`, 'DB_BLOCKED', 'Run "consolidate" to clean up old memories, or use "forget" to remove memories you no longer need.');
+        this.name = 'DatabaseBlockedError';
+    }
+}
+/**
+ * Database size warning (approaching limit)
+ */
+export class DatabaseSizeWarning extends MemoryError {
+    constructor(currentSize) {
+        super(`Database size warning: ${currentSize} is approaching the 100MB limit`, 'DB_SIZE_WARNING', 'Consider running "consolidate" to clean up old memories before reaching the limit.');
+        this.name = 'DatabaseSizeWarning';
+    }
+}
+/**
+ * Memory not found
+ */
+export class MemoryNotFoundError extends MemoryError {
+    constructor(id) {
+        super(`Memory with ID ${id} not found`, 'MEMORY_NOT_FOUND', 'Use "recall" to search for existing memories, or check if the memory was deleted by consolidation.');
+        this.name = 'MemoryNotFoundError';
+    }
+}
+/**
+ * Invalid search query
+ */
+export class InvalidQueryError extends MemoryError {
+    constructor(query, reason) {
+        super(`Invalid search query "${query}": ${reason}`, 'INVALID_QUERY', 'Try simpler search terms. Avoid special characters like *, ^, ( ). Use quotes around phrases.');
+        this.name = 'InvalidQueryError';
+    }
+}
+/**
+ * Content too large
+ */
+export class ContentTooLargeError extends MemoryError {
+    constructor(contentSize, maxSize) {
+        const sizeKB = (contentSize / 1024).toFixed(1);
+        const maxKB = (maxSize / 1024).toFixed(1);
+        super(`Content size (${sizeKB}KB) exceeds maximum allowed (${maxKB}KB)`, 'CONTENT_TOO_LARGE', 'Split large content into multiple smaller memories. Focus on the key points rather than storing everything.');
+        this.name = 'ContentTooLargeError';
+    }
+}
+/**
+ * Bulk delete safety guard
+ */
+export class BulkDeleteSafetyError extends MemoryError {
+    constructor(count) {
+        super(`Bulk delete blocked: ${count} memories would be deleted`, 'BULK_DELETE_BLOCKED', 'This operation would delete many memories. Use "dryRun: true" first to preview what would be deleted, then set "confirm: true" to proceed.');
+        this.name = 'BulkDeleteSafetyError';
+    }
+}
+/**
+ * Database not initialized
+ */
+export class DatabaseNotInitializedError extends MemoryError {
+    constructor() {
+        super('Database not initialized', 'DB_NOT_INIT', 'This usually means the MCP server failed to start properly. Check that the database path is accessible and try restarting the server.');
+        this.name = 'DatabaseNotInitializedError';
+    }
+}
+/**
+ * Session not found
+ */
+export class SessionNotFoundError extends MemoryError {
+    constructor(sessionId) {
+        super(`Session ${sessionId} not found`, 'SESSION_NOT_FOUND', 'The session may have already ended or was never started. Use "start_session" to begin a new session.');
+        this.name = 'SessionNotFoundError';
+    }
+}
+/**
+ * Invalid memory relationship
+ */
+export class InvalidRelationshipError extends MemoryError {
+    constructor(sourceId, targetId, reason) {
+        super(`Cannot create relationship between memory ${sourceId} and ${targetId}: ${reason}`, 'INVALID_RELATIONSHIP', 'Ensure both memories exist and are not the same memory. Use "get_memory" to verify the memory IDs.');
+        this.name = 'InvalidRelationshipError';
+    }
+}
+/**
+ * Format error for MCP tool output
+ */
+export function formatErrorForMcp(error) {
+    if (error instanceof MemoryError) {
+        return error.toUserMessage();
+    }
+    if (error instanceof Error) {
+        // Try to make common errors more helpful
+        if (error.message.includes('SQLITE_BUSY')) {
+            return 'Database is busy (another operation in progress). Please try again in a moment.';
+        }
+        if (error.message.includes('SQLITE_LOCKED')) {
+            return 'Database is locked. This may happen if multiple processes are accessing the database. Wait a moment and try again.';
+        }
+        if (error.message.includes('SQLITE_CORRUPT')) {
+            return 'Database corruption detected. Try running "consolidate" to repair, or restore from backup.';
+        }
+        if (error.message.includes('no such table')) {
+            return 'Database schema error. The database may need to be reinitialized. Try restarting the MCP server.';
+        }
+        return `Error: ${error.message}`;
+    }
+    return 'An unknown error occurred. Please try again or check the server logs.';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Claude Memory - Brain-like Memory System for Claude Code
+ *
+ * This server provides persistent, intelligent memory for Claude Code,
+ * solving the context compaction and session persistence problems.
+ *
+ * Usage:
+ *   npx claude-cortex                         # Start MCP server (default)
+ *   npx claude-cortex --mode mcp              # Start MCP server
+ *   npx claude-cortex --mode api              # Start visualization API server
+ *   npx claude-cortex --mode both             # Start both servers
+ *   npx claude-cortex --db /path/to.db        # Custom database path
+ */
+export {};
+//# 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":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Claude Memory - Brain-like Memory System for Claude Code
+ *
+ * This server provides persistent, intelligent memory for Claude Code,
+ * solving the context compaction and session persistence problems.
+ *
+ * Usage:
+ *   npx claude-cortex                         # Start MCP server (default)
+ *   npx claude-cortex --mode mcp              # Start MCP server
+ *   npx claude-cortex --mode api              # Start visualization API server
+ *   npx claude-cortex --mode both             # Start both servers
+ *   npx claude-cortex --db /path/to.db        # Custom database path
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { startVisualizationServer } from './api/visualization-server.js';
+// Parse command line arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = { mode: 'mcp' };
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--db' && args[i + 1]) {
+            result.dbPath = args[i + 1];
+            i++;
+        }
+        else if (args[i] === '--mode' && args[i + 1]) {
+            const mode = args[i + 1].toLowerCase();
+            if (mode === 'mcp' || mode === 'api' || mode === 'both') {
+                result.mode = mode;
+            }
+            i++;
+        }
+    }
+    return result;
+}
+/**
+ * Start MCP server for Claude Code integration
+ */
+async function startMcpServer(dbPath) {
+    // Create the MCP server
+    const server = createServer(dbPath);
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const { dbPath, mode } = parseArgs();
+    if (mode === 'api') {
+        // API mode only - for dashboard visualization
+        console.log('Starting Claude Memory in API mode...');
+        startVisualizationServer(dbPath);
+    }
+    else if (mode === 'both') {
+        // Both modes - API in background, MCP in foreground
+        console.log('Starting Claude Memory in both modes...');
+        startVisualizationServer(dbPath);
+        await startMcpServer(dbPath);
+    }
+    else {
+        // MCP mode (default) - for Claude Code integration
+        await startMcpServer(dbPath);
+    }
+}
+// Run
+main().catch((error) => {
+    // Log to stderr to avoid corrupting MCP protocol
+    console.error('Failed to start claude-cortex server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/memory/activation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Spreading Activation System
+ *
+ * Implements brain-like spreading activation where accessing a memory
+ * "primes" related memories, making them easier to recall.
+ *
+ * EPHEMERAL: This cache is session-only and does not persist to disk.
+ * Each MCP server restart starts with a fresh activation state.
+ *
+ * Based on spreading activation theory in cognitive psychology:
+ * - Collins & Loftus (1975) semantic network model
+ * - Activation spreads through associative links
+ * - Activation decays over time (exponential decay)
+ */
+/**
+ * Activate a memory and spread activation to linked memories
+ *
+ * When a memory is accessed, it becomes fully activated (1.0).
+ * Linked memories receive partial activation based on link strength.
+ *
+ * @param memoryId - The ID of the memory being accessed
+ */
+export declare function activateMemory(memoryId: number): void;
+/**
+ * Get the activation boost for a memory in search scoring
+ *
+ * Returns 0 if memory is not activated or activation has fully decayed.
+ * Returns up to MAX_ACTIVATION_BOOST for fully activated memories.
+ *
+ * @param memoryId - The ID of the memory to check
+ * @returns Activation boost (0 to MAX_ACTIVATION_BOOST)
+ */
+export declare function getActivationBoost(memoryId: number): number;
+/**
+ * Get current activation level for a memory (for debugging/dashboard)
+ *
+ * @param memoryId - The ID of the memory to check
+ * @returns Current activation level (0-1) or null if not activated
+ */
+export declare function getActivationLevel(memoryId: number): number | null;
+/**
+ * Get all currently activated memories with their levels
+ * Useful for dashboard visualization
+ *
+ * @returns Array of {memoryId, activationLevel} for all activated memories
+ */
+export declare function getActiveMemories(): Array<{
+    memoryId: number;
+    activationLevel: number;
+}>;
+/**
+ * Clear the activation cache
+ * Useful for testing or manual reset
+ */
+export declare function clearActivationCache(): void;
+/**
+ * Prune stale entries from the activation cache
+ * Call periodically to prevent memory bloat
+ */
+export declare function pruneActivationCache(): number;
+/**
+ * Get activation cache statistics
+ */
+export declare function getActivationStats(): {
+    totalEntries: number;
+    activeEntries: number;
+    averageActivation: number;
+};
+//# sourceMappingURL=activation.d.ts.map

package/dist/memory/activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.ts","sourceRoot":"","sources":["../../src/memory/activation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAqCrD;AAaD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAYxF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAY7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAWA"}