claude-cortex 1.0.0

package/dist/tools/recall.js

@@ -0,0 +1,140 @@
+/**
+ * Recall Tool
+ *
+ * Search and retrieve memories using semantic search and filters.
+ */
+import { z } from 'zod';
+import { searchMemories, accessMemory, getRecentMemories, getHighPriorityMemories } from '../memory/store.js';
+import { formatTimeSinceAccess } from '../memory/decay.js';
+import { MemoryNotFoundError, formatErrorForMcp } from '../errors.js';
+import { resolveProject } from '../context/project-context.js';
+// Input schema for the recall tool
+export const recallSchema = z.object({
+    query: z.string().optional().describe('Search query (semantic search)'),
+    category: z.enum([
+        'architecture', 'pattern', 'preference', 'error',
+        'context', 'learning', 'todo', 'note', 'relationship', 'custom'
+    ]).optional().describe('Filter by category'),
+    type: z.enum(['short_term', 'long_term', 'episodic']).optional()
+        .describe('Filter by memory type'),
+    project: z.string().optional().describe('Filter by project'),
+    tags: z.array(z.string()).optional().describe('Filter by tags'),
+    limit: z.number().min(1).max(50).optional().default(10)
+        .describe('Maximum number of results'),
+    includeDecayed: z.boolean().optional().default(false)
+        .describe('Include memories that have decayed below threshold'),
+    includeGlobal: z.boolean().optional().default(true)
+        .describe('Include global memories in search results (default: true)'),
+    mode: z.enum(['search', 'recent', 'important']).optional().default('search')
+        .describe('Recall mode: search (query-based), recent (by time), important (by salience)'),
+});
+/**
+ * Execute the recall tool
+ */
+export async function executeRecall(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        let memories = [];
+        switch (input.mode) {
+            case 'recent':
+                memories = getRecentMemories(input.limit, projectFilter);
+                break;
+            case 'important':
+                memories = getHighPriorityMemories(input.limit, projectFilter);
+                break;
+            case 'search':
+            default:
+                const results = await searchMemories({
+                    query: input.query || '',
+                    category: input.category,
+                    type: input.type,
+                    project: projectFilter,
+                    tags: input.tags,
+                    limit: input.limit,
+                    includeDecayed: input.includeDecayed,
+                    includeGlobal: input.includeGlobal,
+                });
+                memories = results.map(r => r.memory);
+                break;
+        }
+        // Access each memory to reinforce it
+        memories = memories.map(m => accessMemory(m.id) || m);
+        return {
+            success: true,
+            memories,
+            count: memories.length,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+/**
+ * Format a single memory for display
+ */
+export function formatMemory(memory, verbose = false) {
+    const lines = [
+        `[${memory.id}] **${memory.title}**`,
+        `    ${memory.content.slice(0, 200)}${memory.content.length > 200 ? '...' : ''}`,
+    ];
+    if (verbose) {
+        lines.push(`    Type: ${memory.type} | Category: ${memory.category}`);
+        lines.push(`    Salience: ${(memory.salience * 100).toFixed(0)}% | Accessed: ${memory.accessCount}x`);
+        lines.push(`    Last access: ${formatTimeSinceAccess(memory)}`);
+        if (memory.tags.length > 0) {
+            lines.push(`    Tags: ${memory.tags.join(', ')}`);
+        }
+        if (memory.project) {
+            lines.push(`    Project: ${memory.project}`);
+        }
+    }
+    else {
+        lines.push(`    (${memory.type}, ${memory.category}, ${formatTimeSinceAccess(memory)})`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the recall result for MCP response
+ */
+export function formatRecallResult(result, verbose = false) {
+    if (!result.success) {
+        return `Failed to recall: ${result.error}`;
+    }
+    if (!result.memories || result.memories.length === 0) {
+        return 'No memories found matching your query.';
+    }
+    const header = `Found ${result.count} ${result.count === 1 ? 'memory' : 'memories'}:\n`;
+    const formattedMemories = result.memories.map(m => formatMemory(m, verbose)).join('\n\n');
+    return header + formattedMemories;
+}
+/**
+ * Get a single memory by ID
+ */
+export const getMemorySchema = z.object({
+    id: z.number().describe('Memory ID to retrieve'),
+});
+export function executeGetMemory(input) {
+    try {
+        const memory = accessMemory(input.id);
+        if (!memory) {
+            const error = new MemoryNotFoundError(input.id);
+            return {
+                success: false,
+                error: error.toUserMessage(),
+            };
+        }
+        return { success: true, memory };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+//# sourceMappingURL=recall.js.map

package/dist/tools/recall.js.map

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

package/dist/tools/remember.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Remember Tool
+ *
+ * Store memories with automatic salience detection and categorization.
+ */
+import { z } from 'zod';
+import { MemoryCategory, MemoryType } from '../memory/types.js';
+export declare const rememberSchema: z.ZodObject<{
+    title: z.ZodString;
+    content: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "pattern", "preference", "error", "context", "learning", "todo", "note", "relationship", "custom"]>>;
+    type: z.ZodOptional<z.ZodEnum<["short_term", "long_term", "episodic"]>>;
+    project: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    importance: z.ZodOptional<z.ZodEnum<["low", "normal", "high", "critical"]>>;
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+    transferable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    content: string;
+    scope?: "project" | "global" | undefined;
+    transferable?: boolean | undefined;
+    project?: string | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    tags?: string[] | undefined;
+    importance?: "critical" | "low" | "normal" | "high" | undefined;
+}, {
+    title: string;
+    content: string;
+    scope?: "project" | "global" | undefined;
+    transferable?: boolean | undefined;
+    project?: string | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    tags?: string[] | undefined;
+    importance?: "critical" | "low" | "normal" | "high" | undefined;
+}>;
+export type RememberInput = z.infer<typeof rememberSchema>;
+/**
+ * Execute the remember tool
+ */
+export declare function executeRemember(input: RememberInput): Promise<{
+    success: boolean;
+    memory?: {
+        id: number;
+        title: string;
+        salience: number;
+        type: MemoryType;
+        category: MemoryCategory;
+        reason: string;
+        linksCreated?: number;
+        truncated?: {
+            wasTruncated: boolean;
+            originalLength: number;
+            truncatedLength: number;
+        };
+    };
+    error?: string;
+}>;
+/**
+ * Format the remember result for MCP response
+ */
+export declare function formatRememberResult(result: Awaited<ReturnType<typeof executeRemember>>): string;
+//# sourceMappingURL=remember.d.ts.map

package/dist/tools/remember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.d.ts","sourceRoot":"","sources":["../../src/tools/remember.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE;YACV,YAAY,EAAE,OAAO,CAAC;YACtB,cAAc,EAAE,MAAM,CAAC;YACvB,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA2FD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,GAAG,MAAM,CAwBhG"}

package/dist/tools/remember.js

@@ -0,0 +1,147 @@
+/**
+ * Remember Tool
+ *
+ * Store memories with automatic salience detection and categorization.
+ */
+import { z } from 'zod';
+import { addMemory, searchMemories, detectRelationships, createMemoryLink, getLastTruncationInfo } from '../memory/store.js';
+import { analyzeSalienceFactors, explainSalience } from '../memory/salience.js';
+import { formatErrorForMcp } from '../errors.js';
+import { resolveProject } from '../context/project-context.js';
+// Input schema for the remember tool
+export const rememberSchema = z.object({
+    title: z.string().describe('Short title for the memory (what to remember)'),
+    content: z.string().describe('Detailed content of the memory'),
+    category: z.enum([
+        'architecture', 'pattern', 'preference', 'error',
+        'context', 'learning', 'todo', 'note', 'relationship', 'custom'
+    ]).optional().describe('Category of memory (auto-detected if not provided)'),
+    type: z.enum(['short_term', 'long_term', 'episodic']).optional()
+        .describe('Memory type (auto-determined based on salience if not provided)'),
+    project: z.string().optional().describe('Project this memory belongs to'),
+    tags: z.array(z.string()).optional().describe('Tags for categorization'),
+    importance: z.enum(['low', 'normal', 'high', 'critical']).optional()
+        .describe('Override automatic salience detection'),
+    scope: z.enum(['project', 'global']).optional()
+        .describe('Memory scope: project (default) or global (cross-project)'),
+    transferable: z.boolean().optional()
+        .describe('Whether this memory can be transferred to other projects'),
+});
+/**
+ * Execute the remember tool
+ */
+export async function executeRemember(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        // Map importance to salience override
+        let salienceOverride;
+        if (input.importance) {
+            const importanceMap = {
+                low: 0.3,
+                normal: 0.5,
+                high: 0.8,
+                critical: 1.0,
+            };
+            salienceOverride = importanceMap[input.importance];
+        }
+        // Check for duplicates
+        const existing = await searchMemories({
+            query: input.title,
+            project: resolvedProject ?? undefined,
+            limit: 3,
+        });
+        // If very similar memory exists, update instead
+        if (existing.length > 0 && existing[0].relevanceScore > 0.9) {
+            const existingMemory = existing[0].memory;
+            return {
+                success: true,
+                memory: {
+                    id: existingMemory.id,
+                    title: existingMemory.title,
+                    salience: existingMemory.salience,
+                    type: existingMemory.type,
+                    category: existingMemory.category,
+                    reason: 'Updated existing similar memory',
+                },
+            };
+        }
+        // Create the memory
+        const memory = addMemory({
+            title: input.title,
+            content: input.content,
+            category: input.category,
+            type: input.type,
+            project: resolvedProject ?? undefined,
+            tags: input.tags,
+            salience: salienceOverride,
+            scope: input.scope,
+            transferable: input.transferable,
+        });
+        // Auto-detect and create relationships with existing memories
+        let linksCreated = 0;
+        try {
+            const potentialLinks = detectRelationships(memory, 3);
+            for (const link of potentialLinks) {
+                const created = createMemoryLink(memory.id, link.targetId, link.relationship, link.strength);
+                if (created)
+                    linksCreated++;
+            }
+        }
+        catch {
+            // Silently ignore relationship detection errors
+        }
+        // Explain why this was remembered
+        const factors = analyzeSalienceFactors({ title: input.title, content: input.content });
+        const reason = explainSalience(factors);
+        // Check if content was truncated
+        const truncationInfo = getLastTruncationInfo();
+        return {
+            success: true,
+            memory: {
+                id: memory.id,
+                title: memory.title,
+                salience: memory.salience,
+                type: memory.type,
+                category: memory.category,
+                reason,
+                linksCreated,
+                truncated: truncationInfo?.wasTruncated ? truncationInfo : undefined,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+/**
+ * Format the remember result for MCP response
+ */
+export function formatRememberResult(result) {
+    if (!result.success) {
+        return `Failed to remember: ${result.error}`;
+    }
+    const m = result.memory;
+    const lines = [
+        `✓ Remembered: "${m.title}"`,
+        `  ID: ${m.id}`,
+        `  Type: ${m.type}`,
+        `  Category: ${m.category}`,
+        `  Salience: ${(m.salience * 100).toFixed(0)}%`,
+        `  Reason: ${m.reason}`,
+    ];
+    if (m.linksCreated && m.linksCreated > 0) {
+        lines.push(`  Links: ${m.linksCreated} related memories connected`);
+    }
+    if (m.truncated && m.truncated.wasTruncated) {
+        const originalKB = (m.truncated.originalLength / 1024).toFixed(1);
+        const truncatedKB = (m.truncated.truncatedLength / 1024).toFixed(1);
+        lines.push(`  ⚠️  WARNING: Content truncated from ${originalKB}KB to ${truncatedKB}KB (10KB limit)`);
+        lines.push(`  Consider splitting large memories into smaller, focused pieces.`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=remember.js.map

package/dist/tools/remember.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.js","sourceRoot":"","sources":["../../src/tools/remember.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7H,OAAO,EAAqB,sBAAsB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO;QAChD,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ;KAChE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7D,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,uCAAuC,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC5C,QAAQ,CAAC,2DAA2D,CAAC;IACxE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACjC,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAoB;IAkBxD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtD,sCAAsC;QACtC,IAAI,gBAAoC,CAAC;QACzC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,aAAa,GAA2B;gBAC5C,GAAG,EAAE,GAAG;gBACR,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,GAAG;gBACT,QAAQ,EAAE,GAAG;aACd,CAAC;YACF,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,eAAe,IAAI,SAAS;YACrC,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,gDAAgD;QAChD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC;YAC5D,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,EAAE,EAAE,cAAc,CAAC,EAAE;oBACrB,KAAK,EAAE,cAAc,CAAC,KAAK;oBAC3B,QAAQ,EAAE,cAAc,CAAC,QAAQ;oBACjC,IAAI,EAAE,cAAc,CAAC,IAAI;oBACzB,QAAQ,EAAE,cAAc,CAAC,QAAQ;oBACjC,MAAM,EAAE,iCAAiC;iBAC1C;aACF,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,MAAM,MAAM,GAAG,SAAS,CAAC;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,eAAe,IAAI,SAAS;YACrC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,gBAAgB;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;QAEH,8DAA8D;QAC9D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7F,IAAI,OAAO;oBAAE,YAAY,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;QAED,kCAAkC;QAClC,MAAM,OAAO,GAAG,sBAAsB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAExC,iCAAiC;QACjC,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;QAE/C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM;gBACN,YAAY;gBACZ,SAAS,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aACrE;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC;SAChC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmD;IACtF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,uBAAuB,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,MAAO,CAAC;IACzB,MAAM,KAAK,GAAG;QACZ,kBAAkB,CAAC,CAAC,KAAK,GAAG;QAC5B,SAAS,CAAC,CAAC,EAAE,EAAE;QACf,WAAW,CAAC,CAAC,IAAI,EAAE;QACnB,eAAe,CAAC,CAAC,QAAQ,EAAE;QAC3B,eAAe,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAC/C,aAAa,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC;IACF,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,YAAY,6BAA6B,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,yCAAyC,UAAU,SAAS,WAAW,iBAAiB,CAAC,CAAC;QACrG,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/worker/brain-worker.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Brain Worker
+ *
+ * Phase 4 Organic Brain Feature
+ *
+ * Background worker that performs brain-like maintenance operations:
+ * - Light tick (5 min): Prune activation cache, check predictive consolidation
+ * - Medium tick (30 min): Discover missing links, scan for contradictions
+ *
+ * This transforms the memory system from reactive to continuously organic.
+ */
+import { WorkerConfig, LightTickResult, MediumTickResult, WorkerStatus } from './types.js';
+/**
+ * Brain Worker Class
+ *
+ * Manages background processing timers and operations.
+ * Designed to be started by the visualization server and run continuously.
+ */
+export declare class BrainWorker {
+    private lightTimer;
+    private mediumTimer;
+    private isRunning;
+    private config;
+    private stats;
+    private lastLightTick;
+    private lastMediumTick;
+    private lastConsolidation;
+    /**
+     * Create a new BrainWorker
+     *
+     * @param config - Partial configuration to override defaults
+     */
+    constructor(config?: Partial<WorkerConfig>);
+    /**
+     * Start the background worker
+     * Sets up interval timers for light and medium ticks
+     */
+    start(): void;
+    /**
+     * Stop the background worker
+     * Clears all interval timers
+     */
+    stop(): void;
+    /**
+     * Check if the worker is currently running
+     */
+    isActive(): boolean;
+    /**
+     * Light tick - runs every 5 minutes
+     *
+     * Operations:
+     * 1. Prune stale activation cache entries
+     * 2. Check if predictive consolidation should run
+     */
+    lightTick(): Promise<LightTickResult>;
+    /**
+     * Medium tick - runs every 30 minutes
+     *
+     * Operations:
+     * 1. Discover and create missing links
+     * 2. Scan for contradictions
+     */
+    mediumTick(): Promise<MediumTickResult>;
+    /**
+     * Get current worker status
+     */
+    getStatus(): WorkerStatus;
+    /**
+     * Get current configuration
+     */
+    getConfig(): WorkerConfig;
+    /**
+     * Update configuration
+     * Note: Changes won't affect running timers until restart
+     */
+    updateConfig(config: Partial<WorkerConfig>): void;
+    /**
+     * Manually trigger a light tick
+     * Useful for testing or immediate cache pruning
+     */
+    triggerLightTick(): Promise<LightTickResult>;
+    /**
+     * Manually trigger a medium tick
+     * Useful for testing or immediate link discovery
+     */
+    triggerMediumTick(): Promise<MediumTickResult>;
+}
+/**
+ * Get or create the default worker instance
+ */
+export declare function getDefaultWorker(): BrainWorker;
+/**
+ * Start the default worker if not already running
+ */
+export declare function startDefaultWorker(): BrainWorker;
+/**
+ * Stop the default worker
+ */
+export declare function stopDefaultWorker(): void;
+//# sourceMappingURL=brain-worker.d.ts.map

package/dist/worker/brain-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-worker.d.ts","sourceRoot":"","sources":["../../src/worker/brain-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,EAEZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACb,MAAM,YAAY,CAAC;AAgBpB;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,KAAK,CAIX;IAGF,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAAqB;IAE9C;;;;OAIG;gBACS,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgCb;;;OAGG;IACH,IAAI,IAAI,IAAI;IAqBZ;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAqD3C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA4C7C;;OAEG;IACH,SAAS,IAAI,YAAY;IAUzB;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAMjD;;;OAGG;IACH,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAI5C;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAG/C;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAK9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAMhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}