claude-cortex 1.0.0

package/dist/tools/context.js

@@ -0,0 +1,273 @@
+/**
+ * Context Tool
+ *
+ * Manages context injection and session handling.
+ * This is the key tool for solving the compaction problem.
+ */
+import { z } from 'zod';
+import { generateContextSummary, formatContextSummary, startSession, endSession, getSuggestedContext, consolidate, previewConsolidation, exportMemories, importMemories, } from '../memory/consolidate.js';
+import { getMemoryStats } from '../memory/store.js';
+import { resolveProject } from '../context/project-context.js';
+// Input schema for getting context
+export const getContextSchema = z.object({
+    project: z.string().optional().describe('Project to get context for'),
+    query: z.string().optional().describe('Current query/task to find relevant context for'),
+    format: z.enum(['summary', 'detailed', 'raw']).optional().default('summary')
+        .describe('Output format'),
+});
+/**
+ * Execute the get_context tool
+ */
+export async function executeGetContext(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        // Generate context summary
+        const summary = await generateContextSummary(projectFilter);
+        // If there's a query, also get specifically relevant memories
+        let relevantMemories = [];
+        if (input.query) {
+            relevantMemories = await getSuggestedContext(input.query, projectFilter, 5);
+        }
+        // Format based on requested format
+        let context;
+        switch (input.format) {
+            case 'raw':
+                context = JSON.stringify({ summary, relevantMemories }, null, 2);
+                break;
+            case 'detailed':
+                context = formatDetailedContext(summary, relevantMemories);
+                break;
+            case 'summary':
+            default:
+                context = formatContextSummary(summary);
+                if (relevantMemories.length > 0) {
+                    context += '\n\n### Relevant to Current Query\n';
+                    context += relevantMemories.map(m => `- **${m.title}**: ${m.content.slice(0, 100)}...`).join('\n');
+                }
+                break;
+        }
+        return {
+            success: true,
+            context,
+            summary,
+            relevantMemories,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Format detailed context output
+ */
+function formatDetailedContext(summary, relevant) {
+    const lines = [];
+    if (summary.project) {
+        lines.push(`# Project Context: ${summary.project}\n`);
+    }
+    else {
+        lines.push('# Memory Context\n');
+    }
+    // Key decisions
+    if (summary.keyDecisions.length > 0) {
+        lines.push('## Architecture & Decisions\n');
+        for (const m of summary.keyDecisions) {
+            lines.push(`### ${m.title}`);
+            lines.push(m.content);
+            lines.push(`*Salience: ${(m.salience * 100).toFixed(0)}% | Category: ${m.category}*\n`);
+        }
+    }
+    // Patterns
+    if (summary.activePatterns.length > 0) {
+        lines.push('## Active Patterns\n');
+        for (const m of summary.activePatterns) {
+            lines.push(`### ${m.title}`);
+            lines.push(m.content);
+            lines.push('');
+        }
+    }
+    // Pending
+    if (summary.pendingItems.length > 0) {
+        lines.push('## Pending Items\n');
+        for (const m of summary.pendingItems) {
+            lines.push(`- [ ] **${m.title}**: ${m.content.slice(0, 100)}`);
+        }
+        lines.push('');
+    }
+    // Relevant to query
+    if (relevant.length > 0) {
+        lines.push('## Relevant to Current Context\n');
+        for (const m of relevant) {
+            lines.push(`### ${m.title}`);
+            lines.push(m.content);
+            lines.push(`*Type: ${m.type} | Tags: ${m.tags.join(', ') || 'none'}*\n`);
+        }
+    }
+    // Recent activity
+    if (summary.recentMemories.length > 0) {
+        lines.push('## Recent Activity\n');
+        for (const m of summary.recentMemories.slice(0, 5)) {
+            lines.push(`- **${m.title}** (${m.category})`);
+        }
+    }
+    return lines.join('\n');
+}
+// Session management
+export const startSessionSchema = z.object({
+    project: z.string().optional().describe('Project for this session'),
+});
+export async function executeStartSession(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        const { sessionId, context } = await startSession(projectFilter);
+        const formattedContext = formatContextSummary(context);
+        return {
+            success: true,
+            sessionId,
+            context: formattedContext,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+export const endSessionSchema = z.object({
+    sessionId: z.number().describe('Session ID to end'),
+    summary: z.string().optional().describe('Summary of what was accomplished'),
+});
+export function executeEndSession(input) {
+    try {
+        endSession(input.sessionId, input.summary);
+        // Run consolidation
+        const consolidationResult = consolidate();
+        return {
+            success: true,
+            consolidationResult,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+// Consolidation
+export const consolidateSchema = z.object({
+    force: z.boolean().optional().default(false)
+        .describe('Force consolidation even if not due'),
+    dryRun: z.boolean().optional().default(false)
+        .describe('Preview what would happen without actually doing it'),
+});
+export function executeConsolidate(input) {
+    try {
+        if (input.dryRun) {
+            // Preview mode - don't actually do anything
+            const preview = previewConsolidation();
+            return {
+                success: true,
+                preview: {
+                    toPromote: preview.toPromote.length,
+                    toDelete: preview.toDelete.length,
+                    promoteList: preview.toPromote.slice(0, 10).map(m => m.title),
+                    deleteList: preview.toDelete.slice(0, 10).map(m => `${m.title} (${m.category})`),
+                },
+            };
+        }
+        const result = consolidate();
+        return { success: true, result };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+// Stats
+export const statsSchema = z.object({
+    project: z.string().optional().describe('Get stats for specific project'),
+});
+export function executeStats(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        const stats = getMemoryStats(projectFilter);
+        return { success: true, stats };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+export function formatStats(stats) {
+    const lines = [
+        '## Memory Statistics',
+        '',
+        `Total memories: ${stats.total}`,
+        `  - Short-term: ${stats.shortTerm}`,
+        `  - Long-term: ${stats.longTerm}`,
+        `  - Episodic: ${stats.episodic}`,
+        '',
+        `Average salience: ${(stats.averageSalience * 100).toFixed(1)}%`,
+        '',
+        '### By Category',
+    ];
+    for (const [category, count] of Object.entries(stats.byCategory)) {
+        lines.push(`  - ${category}: ${count}`);
+    }
+    return lines.join('\n');
+}
+// Export/Import
+export const exportSchema = z.object({
+    project: z.string().optional().describe('Export only memories for this project'),
+});
+export function executeExport(input) {
+    try {
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        const projectFilter = resolvedProject ?? undefined;
+        const data = exportMemories(projectFilter);
+        const memories = JSON.parse(data);
+        return {
+            success: true,
+            data,
+            count: memories.length,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+export const importSchema = z.object({
+    data: z.string().describe('JSON data to import'),
+});
+export function executeImport(input) {
+    try {
+        const imported = importMemories(input.data);
+        return { success: true, imported };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAsB,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACxF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;SACzE,QAAQ,CAAC,eAAe,CAAC;CAC7B,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAsB;IAO5D,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,eAAe,IAAI,SAAS,CAAC;QAEnD,2BAA2B;QAC3B,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAE5D,8DAA8D;QAC9D,IAAI,gBAAgB,GAAa,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,gBAAgB,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAe,CAAC;QACpB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,KAAK;gBACR,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjE,MAAM;YACR,KAAK,UAAU;gBACb,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;gBAC3D,MAAM;YACR,KAAK,SAAS,CAAC;YACf;gBACE,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACxC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChC,OAAO,IAAI,qCAAqC,CAAC;oBACjD,OAAO,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAClC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;gBACD,MAAM;QACV,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,OAAO;YACP,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,OAAuB,EAAE,QAAkB;IACxE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,WAAW;IACX,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACpE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA2B;IAMnE,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,eAAe,IAAI,SAAS,CAAC;QAEnD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS;YACT,OAAO,EAAE,gBAAgB;SAC1B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAC5E,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,KAA8C;IAK9E,IAAI,CAAC;QACH,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAE3C,oBAAoB;QACpB,MAAM,mBAAmB,GAAG,WAAW,EAAE,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACzC,QAAQ,CAAC,qCAAqC,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SAC1C,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,KAA4C;IAW7E,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,4CAA4C;YAC5C,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;oBACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;oBACjC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;oBAC7D,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;iBACjF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,QAAQ;AACR,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC1E,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,KAA2B;IAKtD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,eAAe,IAAI,SAAS,CAAC;QAEnD,MAAM,KAAK,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAwC;IAClE,MAAM,KAAK,GAAG;QACZ,sBAAsB;QACtB,EAAE;QACF,mBAAmB,KAAK,CAAC,KAAK,EAAE;QAChC,mBAAmB,KAAK,CAAC,SAAS,EAAE;QACpC,kBAAkB,KAAK,CAAC,QAAQ,EAAE;QAClC,iBAAiB,KAAK,CAAC,QAAQ,EAAE;QACjC,EAAE;QACF,qBAAqB,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAChE,EAAE;QACF,iBAAiB;KAClB,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACjF,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,KAA2B;IAMvD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,eAAe,IAAI,SAAS,CAAC;QAEnD,MAAM,IAAI,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,KAAuB;IAKnD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/forget.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Forget Tool
+ *
+ * Delete memories - either individually or in bulk.
+ */
+import { z } from 'zod';
+export declare const forgetSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "pattern", "preference", "error", "context", "learning", "todo", "note", "relationship", "custom"]>>;
+    project: z.ZodOptional<z.ZodString>;
+    olderThan: z.ZodOptional<z.ZodNumber>;
+    belowSalience: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    confirm: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    dryRun: boolean;
+    confirm: boolean;
+    project?: string | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    id?: number | undefined;
+    query?: string | undefined;
+    olderThan?: number | undefined;
+    belowSalience?: number | undefined;
+}, {
+    project?: string | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    id?: number | undefined;
+    query?: string | undefined;
+    olderThan?: number | undefined;
+    belowSalience?: number | undefined;
+    dryRun?: boolean | undefined;
+    confirm?: boolean | undefined;
+}>;
+export type ForgetInput = z.infer<typeof forgetSchema>;
+/**
+ * Execute the forget tool
+ */
+export declare function executeForget(input: ForgetInput): Promise<{
+    success: boolean;
+    deleted?: number;
+    wouldDelete?: number;
+    memories?: {
+        id: number;
+        title: string;
+    }[];
+    error?: string;
+}>;
+/**
+ * Format the forget result for MCP response
+ */
+export declare function formatForgetResult(result: Awaited<ReturnType<typeof executeForget>>): string;
+//# sourceMappingURL=forget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/tools/forget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA+HD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,MAAM,CAsC5F"}

package/dist/tools/forget.js

@@ -0,0 +1,179 @@
+/**
+ * Forget Tool
+ *
+ * Delete memories - either individually or in bulk.
+ */
+import { z } from 'zod';
+import { deleteMemory, searchMemories, getMemoryById } from '../memory/store.js';
+import { getDatabase, withTransaction } from '../database/init.js';
+import { MemoryNotFoundError, BulkDeleteSafetyError, formatErrorForMcp, } from '../errors.js';
+import { resolveProject } from '../context/project-context.js';
+// Input schema for the forget tool
+export const forgetSchema = z.object({
+    id: z.number().optional().describe('Specific memory ID to delete'),
+    query: z.string().optional().describe('Delete memories matching this query'),
+    category: z.enum([
+        'architecture', 'pattern', 'preference', 'error',
+        'context', 'learning', 'todo', 'note', 'relationship', 'custom'
+    ]).optional().describe('Delete all memories in this category'),
+    project: z.string().optional().describe('Delete all memories for this project'),
+    olderThan: z.number().optional().describe('Delete memories older than N days'),
+    belowSalience: z.number().min(0).max(1).optional()
+        .describe('Delete memories with salience below this threshold'),
+    dryRun: z.boolean().optional().default(false)
+        .describe('Preview what would be deleted without actually deleting'),
+    confirm: z.boolean().optional().default(false)
+        .describe('Confirm bulk deletion (required for operations affecting multiple memories)'),
+});
+/**
+ * Execute the forget tool
+ */
+export async function executeForget(input) {
+    try {
+        const db = getDatabase();
+        // Resolve project (auto-detect if not provided)
+        const resolvedProject = resolveProject(input.project);
+        // Single ID deletion
+        if (input.id !== undefined) {
+            const memory = getMemoryById(input.id);
+            if (!memory) {
+                const error = new MemoryNotFoundError(input.id);
+                return {
+                    success: false,
+                    error: error.toUserMessage(),
+                };
+            }
+            if (input.dryRun) {
+                return {
+                    success: true,
+                    wouldDelete: 1,
+                    memories: [{ id: memory.id, title: memory.title }],
+                };
+            }
+            deleteMemory(input.id);
+            return {
+                success: true,
+                deleted: 1,
+                memories: [{ id: memory.id, title: memory.title }],
+            };
+        }
+        // Build bulk delete query
+        const conditions = [];
+        const params = [];
+        if (input.query) {
+            // Get IDs from FTS search
+            const results = await searchMemories({
+                query: input.query,
+                limit: 100,
+                includeDecayed: true,
+            });
+            if (results.length === 0) {
+                return { success: true, deleted: 0, memories: [] };
+            }
+            const ids = results.map(r => r.memory.id);
+            conditions.push(`id IN (${ids.map(() => '?').join(',')})`);
+            params.push(...ids);
+        }
+        if (input.category) {
+            conditions.push('category = ?');
+            params.push(input.category);
+        }
+        if (resolvedProject) {
+            conditions.push('project = ?');
+            params.push(resolvedProject);
+        }
+        if (input.olderThan !== undefined) {
+            conditions.push("created_at < datetime('now', ? || ' days')");
+            params.push(-input.olderThan);
+        }
+        if (input.belowSalience !== undefined) {
+            conditions.push('salience < ?');
+            params.push(input.belowSalience);
+        }
+        if (conditions.length === 0) {
+            return {
+                success: false,
+                error: 'No deletion criteria specified. Provide id, query, category, project, olderThan, or belowSalience.',
+            };
+        }
+        const whereClause = conditions.join(' AND ');
+        // Get affected memories
+        const affected = db.prepare(`SELECT id, title FROM memories WHERE ${whereClause}`).all(...params);
+        if (affected.length === 0) {
+            return { success: true, deleted: 0, memories: [] };
+        }
+        // Dry run - just show what would be deleted
+        if (input.dryRun) {
+            return {
+                success: true,
+                wouldDelete: affected.length,
+                memories: affected.slice(0, 20), // Limit preview
+            };
+        }
+        // Require confirmation for bulk deletes
+        if (affected.length > 1 && !input.confirm) {
+            const error = new BulkDeleteSafetyError(affected.length);
+            return {
+                success: false,
+                wouldDelete: affected.length,
+                memories: affected.slice(0, 10),
+                error: error.toUserMessage(),
+            };
+        }
+        // Execute deletion within a transaction for atomicity
+        withTransaction(() => {
+            db.prepare(`DELETE FROM memories WHERE ${whereClause}`).run(...params);
+        });
+        return {
+            success: true,
+            deleted: affected.length,
+            memories: affected,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: formatErrorForMcp(error),
+        };
+    }
+}
+/**
+ * Format the forget result for MCP response
+ */
+export function formatForgetResult(result) {
+    if (!result.success) {
+        if (result.wouldDelete !== undefined) {
+            const preview = result.memories?.map(m => `  - [${m.id}] ${m.title}`).join('\n') || '';
+            return [
+                `⚠️  ${result.error}`,
+                '',
+                'Preview of memories to delete:',
+                preview,
+                result.memories && result.memories.length < (result.wouldDelete || 0)
+                    ? `  ... and ${(result.wouldDelete || 0) - result.memories.length} more`
+                    : '',
+            ].join('\n');
+        }
+        return `Failed to forget: ${result.error}`;
+    }
+    if (result.wouldDelete !== undefined) {
+        // Dry run result
+        const preview = result.memories?.map(m => `  - [${m.id}] ${m.title}`).join('\n') || '';
+        return [
+            `🔍 Dry run: Would delete ${result.wouldDelete} ${result.wouldDelete === 1 ? 'memory' : 'memories'}:`,
+            preview,
+            result.memories && result.memories.length < result.wouldDelete
+                ? `  ... and ${result.wouldDelete - result.memories.length} more`
+                : '',
+        ].join('\n');
+    }
+    if (result.deleted === 0) {
+        return 'No memories matched the deletion criteria.';
+    }
+    const deleted = result.memories?.map(m => `  - [${m.id}] ${m.title}`).join('\n') || '';
+    return [
+        `✓ Deleted ${result.deleted} ${result.deleted === 1 ? 'memory' : 'memories'}:`,
+        deleted,
+    ].join('\n');
+}
+//# sourceMappingURL=forget.js.map

package/dist/tools/forget.js.map

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

package/dist/tools/recall.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Recall Tool
+ *
+ * Search and retrieve memories using semantic search and filters.
+ */
+import { z } from 'zod';
+import { Memory } from '../memory/types.js';
+export declare const recallSchema: z.ZodObject<{
+    query: z.ZodOptional<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">>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeDecayed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeGlobal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["search", "recent", "important"]>>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    includeDecayed: boolean;
+    includeGlobal: boolean;
+    mode: "search" | "important" | "recent";
+    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;
+    query?: string | undefined;
+}, {
+    project?: string | undefined;
+    category?: "architecture" | "pattern" | "preference" | "error" | "context" | "learning" | "todo" | "note" | "relationship" | "custom" | undefined;
+    limit?: number | undefined;
+    type?: "short_term" | "long_term" | "episodic" | undefined;
+    tags?: string[] | undefined;
+    query?: string | undefined;
+    includeDecayed?: boolean | undefined;
+    includeGlobal?: boolean | undefined;
+    mode?: "search" | "important" | "recent" | undefined;
+}>;
+export type RecallInput = z.infer<typeof recallSchema>;
+/**
+ * Execute the recall tool
+ */
+export declare function executeRecall(input: RecallInput): Promise<{
+    success: boolean;
+    memories?: Memory[];
+    count?: number;
+    error?: string;
+}>;
+/**
+ * Format a single memory for display
+ */
+export declare function formatMemory(memory: Memory, verbose?: boolean): string;
+/**
+ * Format the recall result for MCP response
+ */
+export declare function formatRecallResult(result: Awaited<ReturnType<typeof executeRecall>>, verbose?: boolean): string;
+/**
+ * Get a single memory by ID
+ */
+export declare const getMemorySchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+}, {
+    id: number;
+}>;
+export declare function executeGetMemory(input: {
+    id: number;
+}): {
+    success: boolean;
+    memory?: Memory;
+    error?: string;
+};
+//# sourceMappingURL=recall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/tools/recall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAK1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA+CD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CAqB7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,EACjD,OAAO,GAAE,OAAe,GACvB,MAAM,CAaR;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAiBA"}