@jungjaehoon/mama-core 1.3.2 → 1.4.0

package/dist/mama-api.js

@@ -22,6 +22,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.listRecentMemoryEvents = exports.listOpenAuditFindings = exports.getChannelSummary = exports.upsertChannelSummary = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.saveMemory = void 0;
 exports.save = save;
 exports.suggest = suggest;
 exports.list = listDecisions;
@@ -56,12 +57,29 @@ const os_1 = __importDefault(require("os"));
 const crypto_1 = __importDefault(require("crypto"));
 // Internal modules
 const decision_tracker_js_1 = require("./decision-tracker.js");
+const db_manager_js_1 = require("./db-manager.js");
 const memory_store_js_1 = require("./memory-store.js");
+const db_manager_js_2 = require("./db-manager.js");
 const decision_formatter_js_1 = require("./decision-formatter.js");
 const progress_indicator_js_1 = require("./progress-indicator.js");
 const embeddings_js_1 = require("./embeddings.js");
 const ollama_client_js_1 = require("./ollama-client.js");
 const debug_logger_js_1 = require("./debug-logger.js");
+const api_js_1 = require("./memory/api.js");
+Object.defineProperty(exports, "saveMemory", { enumerable: true, get: function () { return api_js_1.saveMemory; } });
+Object.defineProperty(exports, "recallMemory", { enumerable: true, get: function () { return api_js_1.recallMemory; } });
+Object.defineProperty(exports, "buildProfile", { enumerable: true, get: function () { return api_js_1.buildProfile; } });
+Object.defineProperty(exports, "ingestMemory", { enumerable: true, get: function () { return api_js_1.ingestMemory; } });
+Object.defineProperty(exports, "evolveMemory", { enumerable: true, get: function () { return api_js_1.evolveMemory; } });
+Object.defineProperty(exports, "buildMemoryBootstrap", { enumerable: true, get: function () { return api_js_1.buildMemoryBootstrap; } });
+Object.defineProperty(exports, "createAuditAck", { enumerable: true, get: function () { return api_js_1.createAuditAck; } });
+Object.defineProperty(exports, "recordMemoryAudit", { enumerable: true, get: function () { return api_js_1.recordMemoryAudit; } });
+Object.defineProperty(exports, "upsertChannelSummary", { enumerable: true, get: function () { return api_js_1.upsertChannelSummary; } });
+Object.defineProperty(exports, "getChannelSummary", { enumerable: true, get: function () { return api_js_1.getChannelSummary; } });
+const finding_store_js_1 = require("./memory/finding-store.js");
+Object.defineProperty(exports, "listOpenAuditFindings", { enumerable: true, get: function () { return finding_store_js_1.listOpenAuditFindings; } });
+const event_store_js_1 = require("./memory/event-store.js");
+Object.defineProperty(exports, "listRecentMemoryEvents", { enumerable: true, get: function () { return event_store_js_1.listRecentMemoryEvents; } });
 // Session-level warning cooldown cache (Story 1.1, 1.2)
 // Prevents spam by tracking warned topics per session
 const warnedTopicsCache = new Map();
@@ -93,7 +111,7 @@ const WARNING_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
  *   outcome: 'success'
  * });
  */
-async function save({ topic, decision, reasoning, confidence = 0.5, type = 'user_decision', outcome = 'pending', failure_reason = null, limitation = null, trust_context = null, }) {
+async function save({ topic, decision, reasoning, confidence = 0.5, type = 'user_decision', outcome = 'pending', failure_reason = null, limitation = null, trust_context: _trust_context = null, is_static, scopes: inputScopes, event_date, }) {
     // Validate required fields
     if (!topic || typeof topic !== 'string') {
         throw new Error('mama.save() requires topic (string)');
@@ -117,42 +135,49 @@ async function save({ topic, decision, reasoning, confidence = 0.5, type = 'user
     if (outcome && !validOutcomes.includes(outcome)) {
         throw new Error(`mama.save() outcome must be one of: ${validOutcomes.join(', ')} (got: ${outcome})`);
     }
+    // Validate scopes shape
+    if (inputScopes !== undefined && inputScopes !== null) {
+        if (!Array.isArray(inputScopes)) {
+            throw new Error('mama.save() scopes must be an array');
+        }
+        const validKinds = ['global', 'user', 'channel', 'project'];
+        for (const scope of inputScopes) {
+            if (!scope ||
+                typeof scope !== 'object' ||
+                typeof scope.kind !== 'string' ||
+                typeof scope.id !== 'string') {
+                throw new Error('mama.save() each scope must have kind (string) and id (string)');
+            }
+            if (typeof scope.id === 'string' && scope.id.trim().length === 0) {
+                throw new Error('mama.save() each scope.id must be a non-empty string');
+            }
+            if (!validKinds.includes(scope.kind)) {
+                throw new Error(`mama.save() scope kind must be one of: ${validKinds.join(', ')} (got: ${scope.kind})`);
+            }
+        }
+    }
     // Map type to user_involvement field
     // Note: Current schema uses user_involvement ('requested', 'approved', 'rejected')
     // Future: Will use decision_type column for proper distinction
     const _userInvolvement = type === 'user_decision' ? 'approved' : null;
-    // Create detection object for learnDecision()
-    // Convert null to undefined for type compatibility
-    const detection = {
+    (0, progress_indicator_js_1.logProgress)(`Saving decision: ${topic.substring(0, 30)}...`);
+    const { id: decisionId } = await (0, api_js_1.saveMemory)({
         topic,
-        decision,
-        reasoning,
+        kind: is_static === 1 ? 'preference' : 'decision',
+        summary: decision,
+        details: reasoning,
         confidence,
-        trust_context: trust_context ?? undefined,
-    };
-    // Create tool execution context
-    // Use current timestamp and generate session ID
-    const sessionId = `mama_api_${Date.now()}`;
-    const toolExecution = {
-        tool_name: 'mama.save',
-        tool_input: { topic, decision },
-        exit_code: 0,
-        session_id: sessionId,
-        timestamp: Date.now(),
-    };
-    // Create session context
-    const sessionContext = {
-        session_id: sessionId,
-        latest_user_message: `Save ${type}: ${topic}`,
-        recent_exchange: `Claude: ${reasoning.substring(0, 100)}...`,
-    };
-    // Call internal learnDecision function
-    // Note: learnDecision returns { decisionId, notification }
-    (0, progress_indicator_js_1.logProgress)(`Saving decision: ${topic.substring(0, 30)}...`);
-    const { decisionId } = await (0, decision_tracker_js_1.learnDecision)(detection, toolExecution, sessionContext);
+        scopes: Array.isArray(inputScopes) && inputScopes.length > 0 ? inputScopes : [],
+        source: {
+            package: 'mama-core',
+            source_type: 'legacy_save',
+        },
+        eventDate: event_date ?? undefined,
+    });
     (0, progress_indicator_js_1.logComplete)(`Decision saved: ${decisionId.substring(0, 20)}...`);
     // Update user_involvement, outcome, failure_reason, limitation
     // Note: learnDecision always sets 'requested', we need to override it
+    await (0, db_manager_js_2.initDB)();
     const adapter = (0, memory_store_js_1.getAdapter)();
     // Build UPDATE query dynamically based on what fields are provided
     const updates = [];
@@ -189,6 +214,11 @@ async function save({ topic, decision, reasoning, confidence = 0.5, type = 'user
         updates.push('limitation = ?');
         values.push(limitation);
     }
+    // is_static (user profile marker)
+    if (is_static !== undefined) {
+        updates.push('is_static = ?');
+        values.push(is_static);
+    }
     // Execute UPDATE if we have any fields to update
     if (updates.length > 0) {
         values.push(decisionId); // WHERE id = ?
@@ -209,53 +239,58 @@ async function save({ topic, decision, reasoning, confidence = 0.5, type = 'user
     let reasoning_graph = null;
     // Only run auto-search for decisions (not checkpoints) with a topic
     if (topic) {
-        try {
-            // Story 1.1: Auto-search using suggest()
-            (0, progress_indicator_js_1.logSearching)('Searching for related decisions...');
-            const searchResults = await suggest(topic, {
-                limit: 3,
-                threshold: 0.7,
-                disableRecency: true, // Pure semantic similarity for comparison
-            });
-            // Handle suggest() result which can be string | null | object
-            if (searchResults && typeof searchResults === 'object' && 'results' in searchResults) {
-                // Filter out the decision we just saved
-                similar_decisions = searchResults.results
-                    .filter((d) => d.id !== decisionId)
-                    .map((d) => ({
-                    id: d.id,
-                    topic: d.topic,
-                    decision: d.decision,
-                    similarity: d.similarity,
-                    created_at: d.created_at,
-                }));
-                if (similar_decisions.length > 0) {
-                    (0, progress_indicator_js_1.logComplete)(`Found ${similar_decisions.length} related decision(s)`);
-                }
-                // Story 1.2: Warning logic (similarity >= 0.85)
-                const highSimilarity = similar_decisions.find((d) => (d.similarity ?? 0) >= 0.85);
-                if (highSimilarity && !_isTopicInCooldown(topic)) {
-                    warning = `High similarity (${((highSimilarity.similarity ?? 0) * 100).toFixed(0)}%) with existing decision "${highSimilarity.decision.substring(0, 50)}..."`;
-                    _markTopicWarned(topic);
-                }
-                // Story 1.2: Collaboration hint
-                if (similar_decisions.length > 0) {
-                    collaboration_hint = _generateCollaborationHint(similar_decisions);
+        // Skip global similarity search and reasoning graph for scoped saves
+        if (!inputScopes || !Array.isArray(inputScopes) || inputScopes.length === 0) {
+            try {
+                // Story 1.1: Auto-search using suggest()
+                // NOTE: suggest() searches globally and does not yet support scoped similarity search.
+                // Cross-scope suggestions are possible here. Track as a follow-up.
+                (0, progress_indicator_js_1.logSearching)('Searching for related decisions...');
+                const searchResults = await suggest(topic, {
+                    limit: 3,
+                    threshold: 0.7,
+                    disableRecency: true, // Pure semantic similarity for comparison
+                });
+                // Handle suggest() result which can be string | null | object
+                if (searchResults && typeof searchResults === 'object' && 'results' in searchResults) {
+                    // Filter out the decision we just saved
+                    similar_decisions = searchResults.results
+                        .filter((d) => d.id !== decisionId)
+                        .map((d) => ({
+                        id: d.id,
+                        topic: d.topic,
+                        decision: d.decision,
+                        similarity: d.similarity,
+                        created_at: d.created_at,
+                    }));
+                    if (similar_decisions.length > 0) {
+                        (0, progress_indicator_js_1.logComplete)(`Found ${similar_decisions.length} related decision(s)`);
+                    }
+                    // Story 1.2: Warning logic (similarity >= 0.85)
+                    const highSimilarity = similar_decisions.find((d) => (d.similarity ?? 0) >= 0.85);
+                    if (highSimilarity && !_isTopicInCooldown(topic)) {
+                        warning = `High similarity (${((highSimilarity.similarity ?? 0) * 100).toFixed(0)}%) with existing decision "${highSimilarity.decision.substring(0, 50)}..."`;
+                        _markTopicWarned(topic);
+                    }
+                    // Story 1.2: Collaboration hint
+                    if (similar_decisions.length > 0) {
+                        collaboration_hint = _generateCollaborationHint(similar_decisions);
+                    }
                 }
             }
-        }
-        catch (error) {
-            // Story 1.1 AC3: Best-effort - save succeeds even if auto-search fails
-            const errMsg = error instanceof Error ? error.message : String(error);
-            (0, debug_logger_js_1.error)('Auto-search failed:', errMsg);
-        }
-        // Story 1.2: Reasoning graph info
-        try {
-            reasoning_graph = await _getReasoningGraphInfo(topic, decisionId);
-        }
-        catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            (0, debug_logger_js_1.error)('Reasoning graph query failed:', errMsg);
+            catch (error) {
+                // Story 1.1 AC3: Best-effort - save succeeds even if auto-search fails
+                const errMsg = error instanceof Error ? error.message : String(error);
+                (0, debug_logger_js_1.error)('Auto-search failed:', errMsg);
+            }
+            // Story 1.2: Reasoning graph info
+            try {
+                reasoning_graph = await _getReasoningGraphInfo(topic, decisionId);
+            }
+            catch (error) {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                (0, debug_logger_js_1.error)('Reasoning graph query failed:', errMsg);
+            }
         }
         // Story 2.2: Parse reasoning for relationship edges (builds_on, debates, synthesizes)
         if (reasoning) {
@@ -676,6 +711,71 @@ async function suggest(userQuestion, options = {}) {
     disableRecency = false, // Set true to disable recency boosting entirely
      } = options;
     try {
+        const bundle = await (0, api_js_1.recallMemory)(userQuestion, {
+            includeProfile: false,
+            topicPrefix: options.topicPrefix,
+            ...(options.scopes && { scopes: options.scopes }),
+        });
+        if (bundle.memories.length > 0) {
+            // recallMemory uses RRF fusion — confidence is overwritten with the normalized
+            // retrieval score (0-1 range, where 1.0 = best match in this result set).
+            // The original stored confidence is lost after RRF normalization.
+            // We capture the retrieval score separately so `similarity` reflects search
+            // relevance while `confidence` is passed through as-is from the bundle.
+            let filteredMemories = bundle.memories;
+            // Apply limit
+            filteredMemories = filteredMemories.slice(0, limit);
+            if (format === 'markdown') {
+                const context = filteredMemories
+                    .map((memory, index) => `${index + 1}. [${memory.topic}] ${memory.summary}\n   ${memory.details}`)
+                    .join('\n');
+                return `🔍 Search method: memory_v2\n${context}`;
+            }
+            return {
+                query: userQuestion,
+                results: filteredMemories.map((memory, idx) => ({
+                    id: memory.id,
+                    topic: memory.topic,
+                    decision: memory.summary,
+                    reasoning: memory.details,
+                    confidence: memory.confidence,
+                    // memory.confidence is the normalized RRF retrieval score (0-1) after
+                    // recallMemory.  Use it as similarity so the field reflects search relevance
+                    // rather than the original stored trust score.
+                    similarity: memory.confidence ?? 1 - idx * 0.01,
+                    created_at: memory.created_at,
+                    event_date: memory.event_date ?? null,
+                    graph_source: 'primary',
+                    graph_rank: 1,
+                    related_to: null,
+                    edge_reason: null,
+                })),
+                meta: {
+                    count: filteredMemories.length,
+                    search_method: 'memory_v2',
+                    threshold: threshold || 'adaptive',
+                    recency_boost: disableRecency
+                        ? null
+                        : {
+                            weight: recencyWeight,
+                            scale: recencyScale,
+                            decay: recencyDecay,
+                        },
+                    graph_expansion: {
+                        total_results: filteredMemories.length,
+                        primary_count: bundle.graph_context.primary.length,
+                        expanded_count: bundle.graph_context.expanded.length,
+                        sources: {
+                            primary: bundle.graph_context.primary.length,
+                            supersedes_chain: 0,
+                            refines: 0,
+                            refined_by: 0,
+                            contradicts: 0,
+                        },
+                    },
+                },
+            };
+        }
         // 1. Try vector search first (if sqlite-vss is available)
         // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-explicit-any
         let results = [];
@@ -694,6 +794,37 @@ async function suggest(userQuestion, options = {}) {
             results = await (0, memory_store_js_1.vectorSearch)(queryEmbedding, limit * 2, 0.5); // Get more candidates
             // Filter by adaptive threshold
             results = results.filter((r) => r.similarity >= adaptiveThreshold);
+            // Stage 1.4: Temporal boost — detect time-related queries and boost matching results
+            {
+                const temporalPatterns = [
+                    // English
+                    /\b(yesterday|today|last\s+(?:week|month|year)|(\d+)\s+(?:days?|weeks?|months?)\s+ago)\b/i,
+                    /\b(before|after|since|until|during)\s+\w+/i,
+                    /\b(how\s+long|when\s+did|what\s+date|what\s+day)\b/i,
+                    // Korean
+                    /(?:어제|오늘|그제|지난\s*(?:주|달|해)|(\d+)\s*(?:일|주|달|개월)\s*(?:전|후|뒤))/,
+                    /(?:언제|얼마나|며칠|몇\s*(?:일|주|달|개월))/,
+                ];
+                const isTemporalQuery = temporalPatterns.some((p) => p.test(userQuestion));
+                if (isTemporalQuery && results.length > 0) {
+                    // Boost results that contain date/time references in their content
+                    const datePatterns = [
+                        /\d{4}[-/]\d{1,2}[-/]\d{1,2}/,
+                        /(?:jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\w*\s+\d/i,
+                        /\d+\s*(?:일|월|년|주|시간|분)/,
+                        /(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday)/i,
+                        /(?:월요일|화요일|수요일|목요일|금요일|토요일|일요일)/,
+                    ];
+                    for (const result of results) {
+                        const content = `${result.decision || ''} ${result.reasoning || ''}`;
+                        const hasDateRef = datePatterns.some((p) => p.test(content));
+                        if (hasDateRef) {
+                            result.similarity = Math.min(1.0, (result.similarity || 0) + 0.1);
+                        }
+                    }
+                    results.sort((a, b) => (b.similarity || 0) - (a.similarity || 0));
+                }
+            }
             // Stage 1.5: Apply recency boosting (Gaussian Decay)
             // Allows Claude to adjust search strategy (recent vs historical)
             if (results.length > 0 && !disableRecency) {
@@ -705,6 +836,52 @@ async function suggest(userQuestion, options = {}) {
                 });
                 searchMethod = 'vector+recency';
             }
+            // Stage 1.7: FTS5 hybrid merge (Haiku Memory Layer)
+            {
+                try {
+                    const ftsResults = await (0, db_manager_js_1.fts5Search)(userQuestion, limit * 2);
+                    if (ftsResults.length > 0) {
+                        // Normalize FTS5 ranks (BM25 returns negative values, closer to 0 = better)
+                        const maxRank = Math.max(...ftsResults.map((r) => Math.abs(r.rank)));
+                        const ftsMap = new Map(ftsResults.map((r) => [r.id, maxRank > 0 ? 1 - Math.abs(r.rank) / maxRank : 0.5]));
+                        // Tunable hybrid weights (env: MAMA_VECTOR_WEIGHT, MAMA_FTS5_WEIGHT)
+                        const vectorWeight = parseFloat(process.env.MAMA_VECTOR_WEIGHT || '0.6');
+                        const fts5Weight = parseFloat(process.env.MAMA_FTS5_WEIGHT || '0.4');
+                        // Merge: boost existing results that also matched FTS5
+                        for (const result of results) {
+                            const ftsScore = ftsMap.get(result.id);
+                            if (ftsScore !== undefined) {
+                                result.similarity = vectorWeight * result.similarity + fts5Weight * ftsScore;
+                                ftsMap.delete(result.id);
+                            }
+                        }
+                        // Add FTS5-only results (not in embedding results)
+                        for (const [id, ftsScore] of ftsMap) {
+                            const ftsResult = ftsResults.find((r) => r.id === id);
+                            if (ftsResult) {
+                                // Need to get full decision record
+                                const adapter = (0, memory_store_js_1.getAdapter)();
+                                const stmt = adapter.prepare('SELECT * FROM decisions WHERE id = ? AND superseded_by IS NULL');
+                                const decision = stmt.get(id);
+                                if (decision) {
+                                    results.push({
+                                        ...decision,
+                                        similarity: fts5Weight * ftsScore, // Only FTS5 score component
+                                        graph_source: 'fts5',
+                                    });
+                                }
+                            }
+                        }
+                        // Re-sort by similarity
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        results.sort((a, b) => (b.similarity || 0) - (a.similarity || 0));
+                        searchMethod = disableRecency ? 'vector+fts5' : 'vector+recency+fts5';
+                    }
+                }
+                catch {
+                    // FTS5 not available, continue with embedding-only results
+                }
+            }
             // Stage 2: Graph expansion (NEW - Phase 1)
             // Expand candidates with supersedes chain and semantic edges
             if (results.length > 0) {
@@ -712,6 +889,14 @@ async function suggest(userQuestion, options = {}) {
                 results = graphEnhanced;
                 searchMethod = disableRecency ? 'vector+graph' : 'vector+recency+graph';
             }
+            // Stage 2.5: is_static boost (after graph expansion to preserve sort order)
+            for (const result of results) {
+                if (result.is_static === 1) {
+                    result.final_score = Math.min(1.0, (result.final_score ?? result.similarity ?? 0) + 0.2);
+                }
+            }
+            // Re-sort by final_score after is_static boost
+            results.sort((a, b) => (b.final_score ?? b.similarity ?? 0) - (a.final_score ?? a.similarity ?? 0));
         }
         catch (vectorError) {
             // Fallback to keyword search if vector search unavailable
@@ -873,13 +1058,30 @@ async function listDecisions(options = {}) {
     const { limit = 10, format = 'json' } = options;
     try {
         const adapter = (0, memory_store_js_1.getAdapter)();
-        const stmt = adapter.prepare(`
-      SELECT * FROM decisions
-      WHERE superseded_by IS NULL
-      ORDER BY created_at DESC
-      LIMIT ?
-    `);
-        const decisions = await stmt.all(limit);
+        let decisions;
+        if (options.scopes && options.scopes.length > 0) {
+            // Scope-filtered query: JOIN memory_scope_bindings + memory_scopes
+            const scopeIds = await Promise.all(options.scopes.map((s) => (0, db_manager_js_1.ensureMemoryScope)(s.kind, s.id)));
+            const placeholders = scopeIds.map(() => '?').join(', ');
+            const stmt = adapter.prepare(`
+        SELECT DISTINCT d.* FROM decisions d
+        JOIN memory_scope_bindings msb ON msb.memory_id = d.id
+        WHERE msb.scope_id IN (${placeholders})
+          AND d.superseded_by IS NULL
+        ORDER BY d.created_at DESC
+        LIMIT ?
+      `);
+            decisions = await stmt.all(...scopeIds, limit);
+        }
+        else {
+            const stmt = adapter.prepare(`
+        SELECT * FROM decisions
+        WHERE superseded_by IS NULL
+        ORDER BY created_at DESC
+        LIMIT ?
+      `);
+            decisions = await stmt.all(limit);
+        }
         if (format === 'markdown') {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return (0, decision_formatter_js_1.formatList)(decisions);
@@ -2158,9 +2360,21 @@ const mama = {
     // Core functions (used by 4 MCP tools)
     save,
     suggest,
+    saveMemory: api_js_1.saveMemory,
+    recallMemory: api_js_1.recallMemory,
     list: listDecisions,
     listCheckpoints,
     updateOutcome,
+    buildProfile: api_js_1.buildProfile,
+    ingestMemory: api_js_1.ingestMemory,
+    evolveMemory: api_js_1.evolveMemory,
+    buildMemoryBootstrap: api_js_1.buildMemoryBootstrap,
+    createAuditAck: api_js_1.createAuditAck,
+    recordMemoryAudit: api_js_1.recordMemoryAudit,
+    upsertChannelSummary: api_js_1.upsertChannelSummary,
+    getChannelSummary: api_js_1.getChannelSummary,
+    listAuditFindings: finding_store_js_1.listOpenAuditFindings,
+    listRecentMemoryEvents: event_store_js_1.listRecentMemoryEvents,
     saveCheckpoint,
     loadCheckpoint,
     // Legacy functions (retained for internal use, not exposed via MCP)
@@ -2184,6 +2398,7 @@ const mama = {
     verifyBackupExists,
     deleteAutoLinks,
     validateCleanupResult,
+    expandWithGraph,
 };
 // Default export for backward compatibility
 exports.default = mama;

package/dist/memory/api.d.ts

@@ -0,0 +1,81 @@
+import { resolveMemoryEvolution } from './evolution-engine.js';
+import { getChannelSummary, upsertChannelSummary } from './channel-summary-store.js';
+import type { MemoryKind, MemoryAgentBootstrap, MemoryAuditAck, MemoryEdge, MemoryScopeRef, MemoryStatus, ProfileSnapshot, RecallBundle, IngestConversationInput, ExtractedMemoryUnit, IngestConversationResult } from './types.js';
+interface SaveMemoryInput {
+    topic: string;
+    kind: MemoryKind;
+    summary: string;
+    details: string;
+    confidence?: number;
+    status?: MemoryStatus;
+    scopes: MemoryScopeRef[];
+    source: {
+        package: 'mama-core' | 'mcp-server' | 'standalone' | 'claude-code-plugin';
+        source_type: string;
+        user_id?: string;
+        channel_id?: string;
+        project_id?: string;
+    };
+    /** IDs to exclude from supersede candidates (e.g., sibling facts from same ingestion batch) */
+    excludeIds?: string[];
+    /**
+     * ISO 8601 date string for when the event actually occurred (e.g. "2023-01-15").
+     * Stored in the event_date column. Defaults to created_at if omitted.
+     */
+    eventDate?: string;
+}
+interface RecallMemoryOptions {
+    scopes?: MemoryScopeRef[];
+    includeProfile?: boolean;
+    includeHistory?: boolean;
+    skipGraphExpansion?: boolean;
+    topicPrefix?: string;
+}
+interface IngestMemoryInput {
+    content: string;
+    scopes?: MemoryScopeRef[];
+    source: SaveMemoryInput['source'];
+    eventDate?: string;
+}
+export declare const LEXICAL_STOPWORDS: Set<string>;
+export declare function getLexicalQueryTokens(query: string): string[];
+export declare function loadEdgesForIds(ids: string[]): Promise<MemoryEdge[]>;
+export declare function saveMemory(input: SaveMemoryInput): Promise<{
+    success: boolean;
+    id: string;
+}>;
+export declare function buildProfile(scopes: MemoryScopeRef[]): Promise<ProfileSnapshot>;
+export declare function recallMemory(query: string, options?: RecallMemoryOptions): Promise<RecallBundle>;
+export declare function ingestMemory(input: IngestMemoryInput): Promise<{
+    success: boolean;
+    id: string;
+}>;
+export declare function evolveMemory(input: Parameters<typeof resolveMemoryEvolution>[0]): Promise<import("./evolution-engine.js").EvolutionResult>;
+export declare function buildMemoryBootstrap(params: {
+    scopes: MemoryScopeRef[];
+    channelKey?: string;
+    currentGoal?: string;
+    mainAgentState?: MemoryAgentBootstrap['main_agent_state'];
+}): Promise<MemoryAgentBootstrap>;
+export declare function createAuditAck(input: MemoryAuditAck): MemoryAuditAck;
+export declare function recordMemoryAudit(input: {
+    channelKey: string;
+    turnId: string;
+    topic: string;
+    scopeRefs: MemoryScopeRef[];
+    ack: MemoryAuditAck;
+    savedMemories?: Array<{
+        id: string;
+        topic: string;
+        summary: string;
+    }>;
+}): Promise<{
+    eventIds: string[];
+    findingIds: string[];
+    state: import("./types.js").ChannelSummaryStateRecord;
+}>;
+declare function callExtractionLLM(prompt: string, options: NonNullable<IngestConversationInput['extract']>): Promise<ExtractedMemoryUnit[]>;
+export declare function setExtractionFn(fn: typeof callExtractionLLM | null): void;
+export declare function ingestConversation(input: IngestConversationInput): Promise<IngestConversationResult>;
+export { upsertChannelSummary, getChannelSummary };
+//# sourceMappingURL=api.d.ts.map