@jungjaehoon/mama-core 1.4.2 → 1.6.0

package/dist/index.d.ts

@@ -15,10 +15,43 @@ export { createAdapter, DatabaseAdapter, SQLiteAdapter, type AdapterConfig, type
 export { getSessionDecisions, incrementUsageSuccess, incrementUsageFailure, getDecisionById, traverseDecisionChain, DB_PATH, DB_DIR, LEGACY_DB_PATH, DEFAULT_DB_PATH, } from './memory-store.js';
 import mama from './mama-api.js';
 export { mama };
-export { MEMORY_SCOPE_KINDS, MEMORY_KINDS, MEMORY_STATUSES, MEMORY_EDGE_TYPES, createEmptyRecallBundle, type MemoryScopeKind, type MemoryKind, type MemoryStatus, type MemoryEdgeType, type MemoryScopeRef, type MemoryRecord, type MemoryEdge, type ProfileSnapshot, type RecallBundle, type ConversationMessage, type IngestConversationInput, type ExtractedMemoryUnit, type IngestConversationResult, } from './memory/types.js';
-export { saveMemory, recallMemory, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, ingestConversation, setExtractionFn, upsertChannelSummary, getChannelSummary, } from './memory/api.js';
+export { MEMORY_SCOPE_KINDS, MEMORY_KINDS, MEMORY_STATUSES, MEMORY_EDGE_TYPES, createEmptyRecallBundle, type MemoryScopeKind, type MemoryKind, type MemoryStatus, type MemoryEdgeType, type MemoryScopeRef, type MemorySourceRef, type MemoryRecord, type MemoryWriteProvenance, type MemoryProvenanceRecord, type PublicSaveMemoryInput, type PublicIngestMemoryInput, type PublicIngestConversationInput, type MemorySearchResultHit, type MemoryEdge, type ProfileSnapshot, type RecallBundle, type ConversationMessage, type IngestConversationInput, type ExtractedMemoryUnit, type IngestConversationResult, } from './memory/types.js';
+export { saveMemory, saveMemoryWithTrustedProvenance, recallMemory, buildProfile, ingestMemory, ingestWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, ingestConversation, ingestConversationWithTrustedProvenance, setExtractionFn, upsertChannelSummary, getChannelSummary, } from './memory/api.js';
 export { buildExtractionPrompt, parseExtractionResponse } from './memory/extraction-prompt.js';
-export { listRecentMemoryEvents } from './memory/event-store.js';
+export { appendMemoryEvent, insertMemoryEventInTransaction, listMemoryEventsForMemory, listRecentMemoryEvents, } from './memory/event-store.js';
+export { createTrustedProvenanceCapability, assertTrustedProvenanceCapability, type TrustedProvenanceCapability, type TrustedMemoryWriteOptions, } from './memory/provenance.js';
+export { getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, } from './memory/provenance-query.js';
+export { backfillLegacyMemoryProvenance, backfillConnectorEventScopeMetadata, type BackfillResult, type ConnectorEventScopeBackfillInput, } from './memory/scope-backfill.js';
+export { getMemoryProvenanceAudit, listMemoryProvenanceAudit, type MemoryProvenanceAuditRecord, type MemoryProvenanceAuditListOptions, } from './memory/provenance-audit.js';
+export { MODEL_RUN_STATUSES, type ModelRunStatus, type BeginModelRunInput, type ModelRunRecord, type AppendToolTraceInput, type ToolTraceRecord, } from './model-runs/types.js';
+export { beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, } from './model-runs/store.js';
+export { appendToolTrace, listToolTracesForRun } from './model-runs/tool-trace-store.js';
+export { TWIN_EDGE_SOURCES, TWIN_EDGE_TYPES, TWIN_REF_KINDS, type InsertTwinEdgeInput, type ListVisibleTwinEdgesOptions, type TwinEdgeRecord, type TwinEdgeSource, type TwinEdgeType, type TwinRef, type TwinRefKind, type TwinScopeRef, } from './edges/types.js';
+export { getTwinEdge, insertTwinEdge, listTwinEdgesForRefs, mapTwinEdgeRow, } from './edges/store.js';
+export { assertTwinRefsVisibleToScopes, listVisibleTwinEdgesForRefs, } from './edges/ref-validation.js';
+export * from './agent-situation/index.js';
+export * from './agent-graph/index.js';
+export * from './entities/types.js';
+export * from './entities/errors.js';
+export * from './entities/store.js';
+export * from './entities/normalization.js';
+export * from './entities/projection.js';
+export * from './entities/recall-bridge.js';
+export * from './entities/read-identity.js';
+export * from './entities/audit-metrics.js';
+export * from './entities/provenance-query.js';
+export * from './entities/lineage-store.js';
+export * from './entities/lineage-backfill.js';
+export * from './entities/exact-merge-backfill.js';
+export * from './entities/entity-search.js';
+export * from './entities/entity-list.js';
+export * from './entities/entity-orphan-list.js';
+export * from './entities/entity-impact.js';
+export * from './entities/rollback-preview.js';
+export * from './entities/source-locator.js';
+export * from './entities/policy-types.js';
+export * from './entities/policy-store.js';
+export { canonicalizeJSON, targetRefHash, CanonicalizeError, type CanonicalizeErrorCode, } from './canonicalize.js';
 export { loadConfig, getModelName, getEmbeddingDim, getCacheDir, updateConfig, getConfigPath, DEFAULT_CONFIG, type MAMAConfig, type ConfigUpdates, } from './config-loader.js';
 export { calculateRelevance, selectTopDecisions, formatTopNContext, testRelevanceScoring, type DecisionWithEmbedding, type QueryContext, type FormattedContext, type TestResult, } from './relevance-scorer.js';
 export { learnDecision, generateDecisionId, getPreviousDecision, createEdge, createSupersedesEdge, markSuperseded, calculateCombinedConfidence, detectRefinement, parseReasoningForRelationships, createEdgesFromReasoning, getSupersededChainDepth, updateConfidence, VALID_EDGE_TYPES, type EdgeType, type DecisionDetection, type ToolExecution, type SessionContext, type LearnDecisionResult, type ParsedRelationship, type EvidenceItem, } from './decision-tracker.js';
@@ -33,4 +66,30 @@ export { injectDecisionContext } from './memory-inject.js';
 export { analyzeIntent, extractTopicKeywords, type IntentResult, type AnalyzeOptions, } from './query-intent.js';
 export { generate, analyzeDecision, analyzeQueryIntent, isAvailable, listModels, DEFAULT_MODEL, FALLBACK_MODEL, type GenerateOptions, type DecisionAnalysisResult, type QueryIntentResult, } from './ollama-client.js';
 export { notifyInsight } from './notification-manager.js';
+export * from './cases/types.js';
+export * from './cases/store.js';
+export * from './cases/role-inference.js';
+export * from './cases/target-ref.js';
+export * from './cases/corrections.js';
+export * from './cases/sqlite-transaction.js';
+export * from './cases/live-state.js';
+export * from './cases/tombstone-sweeper.js';
+export * from './cases/merge-split.js';
+export * from './cases/membership-matcher.js';
+export * from './cases/search-rollup.js';
+export * from './cases/timeline-range.js';
+export * from './cases/wiki-page-index.js';
+export * from './cases/case-links.js';
+export * from './cases/composition-overrides.js';
+export * from './cases/freshness.js';
+export * from './cases/membership-explain.js';
+export * from './connectors/event-index.js';
+export * from './connectors/raw-query.js';
+export * from './connectors/types.js';
+export * from './search/question-type.js';
+export * from './search/feedback-store.js';
+export * from './search/ranker-features.js';
+export * from './search/ranker-trainer.js';
+export * from './search/ranker-rescore.js';
+export * from './search/search-quality.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -8,15 +8,28 @@
  * @module mama-core
  * @version 1.0.0
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.recallMemory = exports.saveMemory = exports.createEmptyRecallBundle = exports.MEMORY_EDGE_TYPES = exports.MEMORY_STATUSES = exports.MEMORY_KINDS = exports.MEMORY_SCOPE_KINDS = exports.mama = exports.DEFAULT_DB_PATH = exports.LEGACY_DB_PATH = exports.DB_DIR = exports.DB_PATH = exports.traverseDecisionChain = exports.getDecisionById = exports.incrementUsageFailure = exports.incrementUsageSuccess = exports.getSessionDecisions = exports.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = exports.reindexEmbeddings = exports.fts5Search = exports.getDbPath = exports.getPreparedStmt = exports.updateDecisionOutcome = exports.querySemanticEdges = exports.queryDecisionGraph = exports.insertDecisionWithEmbedding = exports.queryVectorSearch = exports.vectorSearch = exports.insertEmbedding = exports.closeDB = exports.getAdapter = exports.getDB = exports.initDB = exports.TIMEOUT_MS = exports.HOST = exports.DEFAULT_PORT = exports.getServerPort = exports.isServerRunning = exports.getServerStatus = exports.getEmbeddingFromServer = exports.EmbeddingCache = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
-exports.logLoading = exports.logInfo = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierBanner = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.validateTier = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.getSupersededChainDepth = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.testRelevanceScoring = exports.formatTopNContext = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.listRecentMemoryEvents = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversation = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestMemory = exports.buildProfile = void 0;
-exports.analyzeQueryIntent = exports.analyzeDecision = exports.generate = exports.extractTopicKeywords = exports.analyzeIntent = exports.injectDecisionContext = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = exports.onUserPromptSubmit = exports.markOutcome = exports.getEvidenceImpact = exports.calculateDurationDays = exports.getRecentDecision = exports.extractFailureReason = exports.matchesPartialIndicators = exports.matchesSuccessIndicators = exports.matchesFailureIndicators = exports.analyzeOutcome = exports.extractCodeExample = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = exports.formatInstantAnswer = exports.formatTeaser = exports.formatList = exports.formatRecall = exports.formatLegacyContext = exports.formatContext = exports.isMAMAError = exports.wrapError = exports.ErrorCodes = exports.TimeoutError = exports.RateLimitError = exports.LinkError = exports.ConfigurationError = exports.EmbeddingError = exports.DatabaseError = exports.ValidationError = exports.NotFoundError = exports.MAMAError = exports.formatTimeAgo = exports.DebugLogger = exports.error = exports.warn = exports.info = exports.debug = exports.logSearching = void 0;
-exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = void 0;
-// Embeddings
+exports.saveMemoryWithTrustedProvenance = exports.saveMemory = exports.createEmptyRecallBundle = exports.MEMORY_EDGE_TYPES = exports.MEMORY_STATUSES = exports.MEMORY_KINDS = exports.MEMORY_SCOPE_KINDS = exports.mama = exports.DEFAULT_DB_PATH = exports.LEGACY_DB_PATH = exports.DB_DIR = exports.DB_PATH = exports.traverseDecisionChain = exports.getDecisionById = exports.incrementUsageFailure = exports.incrementUsageSuccess = exports.getSessionDecisions = exports.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = exports.reindexEmbeddings = exports.fts5Search = exports.getDbPath = exports.getPreparedStmt = exports.updateDecisionOutcome = exports.querySemanticEdges = exports.queryDecisionGraph = exports.insertDecisionWithEmbedding = exports.queryVectorSearch = exports.vectorSearch = exports.insertEmbedding = exports.closeDB = exports.getAdapter = exports.getDB = exports.initDB = exports.TIMEOUT_MS = exports.HOST = exports.DEFAULT_PORT = exports.getServerPort = exports.isServerRunning = exports.getServerStatus = exports.getEmbeddingFromServer = exports.EmbeddingCache = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
+exports.canonicalizeJSON = exports.listVisibleTwinEdgesForRefs = exports.assertTwinRefsVisibleToScopes = exports.mapTwinEdgeRow = exports.listTwinEdgesForRefs = exports.insertTwinEdge = exports.getTwinEdge = exports.TWIN_REF_KINDS = exports.TWIN_EDGE_TYPES = exports.TWIN_EDGE_SOURCES = exports.listToolTracesForRun = exports.appendToolTrace = exports.getModelRunInAdapter = exports.getModelRun = exports.failModelRunInAdapter = exports.failModelRun = exports.commitModelRunInAdapter = exports.commitModelRun = exports.beginModelRunInAdapter = exports.beginModelRun = exports.MODEL_RUN_STATUSES = exports.listMemoryProvenanceAudit = exports.getMemoryProvenanceAudit = exports.backfillConnectorEventScopeMetadata = exports.backfillLegacyMemoryProvenance = exports.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.assertTrustedProvenanceCapability = exports.createTrustedProvenanceCapability = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = exports.insertMemoryEventInTransaction = exports.appendMemoryEvent = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestWithTrustedProvenance = exports.ingestMemory = exports.buildProfile = exports.recallMemory = void 0;
+exports.DatabaseError = exports.ValidationError = exports.NotFoundError = exports.MAMAError = exports.formatTimeAgo = exports.DebugLogger = exports.error = exports.warn = exports.info = exports.debug = exports.logSearching = exports.logLoading = exports.logInfo = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierBanner = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.validateTier = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.getSupersededChainDepth = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.testRelevanceScoring = exports.formatTopNContext = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.CanonicalizeError = exports.targetRefHash = void 0;
+exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.analyzeQueryIntent = exports.analyzeDecision = exports.generate = exports.extractTopicKeywords = exports.analyzeIntent = exports.injectDecisionContext = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = exports.onUserPromptSubmit = exports.markOutcome = exports.getEvidenceImpact = exports.calculateDurationDays = exports.getRecentDecision = exports.extractFailureReason = exports.matchesPartialIndicators = exports.matchesSuccessIndicators = exports.matchesFailureIndicators = exports.analyzeOutcome = exports.extractCodeExample = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = exports.formatInstantAnswer = exports.formatTeaser = exports.formatList = exports.formatRecall = exports.formatLegacyContext = exports.formatContext = exports.isMAMAError = exports.wrapError = exports.ErrorCodes = exports.TimeoutError = exports.RateLimitError = exports.LinkError = exports.ConfigurationError = exports.EmbeddingError = void 0;
 var embeddings_js_1 = require("./embeddings.js");
 Object.defineProperty(exports, "generateEmbedding", { enumerable: true, get: function () { return embeddings_js_1.generateEmbedding; } });
 Object.defineProperty(exports, "generateEnhancedEmbedding", { enumerable: true, get: function () { return embeddings_js_1.generateEnhancedEmbedding; } });
@@ -25,10 +38,8 @@ Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: func
 Object.defineProperty(exports, "embeddingCache", { enumerable: true, get: function () { return embeddings_js_1.embeddingCache; } });
 Object.defineProperty(exports, "EMBEDDING_DIM", { enumerable: true, get: function () { return embeddings_js_1.EMBEDDING_DIM; } });
 Object.defineProperty(exports, "MODEL_NAME", { enumerable: true, get: function () { return embeddings_js_1.MODEL_NAME; } });
-// Embedding cache
 var embedding_cache_js_1 = require("./embedding-cache.js");
 Object.defineProperty(exports, "EmbeddingCache", { enumerable: true, get: function () { return embedding_cache_js_1.EmbeddingCache; } });
-// Embedding client
 var embedding_client_js_1 = require("./embedding-client.js");
 Object.defineProperty(exports, "getEmbeddingFromServer", { enumerable: true, get: function () { return embedding_client_js_1.getEmbeddingFromServer; } });
 Object.defineProperty(exports, "getServerStatus", { enumerable: true, get: function () { return embedding_client_js_1.getServerStatus; } });
@@ -37,7 +48,6 @@ Object.defineProperty(exports, "getServerPort", { enumerable: true, get: functio
 Object.defineProperty(exports, "DEFAULT_PORT", { enumerable: true, get: function () { return embedding_client_js_1.DEFAULT_PORT; } });
 Object.defineProperty(exports, "HOST", { enumerable: true, get: function () { return embedding_client_js_1.HOST; } });
 Object.defineProperty(exports, "TIMEOUT_MS", { enumerable: true, get: function () { return embedding_client_js_1.TIMEOUT_MS; } });
-// Database manager
 var db_manager_js_1 = require("./db-manager.js");
 Object.defineProperty(exports, "initDB", { enumerable: true, get: function () { return db_manager_js_1.initDB; } });
 Object.defineProperty(exports, "getDB", { enumerable: true, get: function () { return db_manager_js_1.getDB; } });
@@ -54,12 +64,10 @@ Object.defineProperty(exports, "getPreparedStmt", { enumerable: true, get: funct
 Object.defineProperty(exports, "getDbPath", { enumerable: true, get: function () { return db_manager_js_1.getDbPath; } });
 Object.defineProperty(exports, "fts5Search", { enumerable: true, get: function () { return db_manager_js_1.fts5Search; } });
 Object.defineProperty(exports, "reindexEmbeddings", { enumerable: true, get: function () { return db_manager_js_1.reindexEmbeddings; } });
-// Database adapter
 var index_js_1 = require("./db-adapter/index.js");
 Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return index_js_1.createAdapter; } });
 Object.defineProperty(exports, "DatabaseAdapter", { enumerable: true, get: function () { return index_js_1.DatabaseAdapter; } });
 Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return index_js_1.SQLiteAdapter; } });
-// Memory store
 var memory_store_js_1 = require("./memory-store.js");
 Object.defineProperty(exports, "getSessionDecisions", { enumerable: true, get: function () { return memory_store_js_1.getSessionDecisions; } });
 Object.defineProperty(exports, "incrementUsageSuccess", { enumerable: true, get: function () { return memory_store_js_1.incrementUsageSuccess; } });
@@ -70,10 +78,8 @@ Object.defineProperty(exports, "DB_PATH", { enumerable: true, get: function () {
 Object.defineProperty(exports, "DB_DIR", { enumerable: true, get: function () { return memory_store_js_1.DB_DIR; } });
 Object.defineProperty(exports, "LEGACY_DB_PATH", { enumerable: true, get: function () { return memory_store_js_1.LEGACY_DB_PATH; } });
 Object.defineProperty(exports, "DEFAULT_DB_PATH", { enumerable: true, get: function () { return memory_store_js_1.DEFAULT_DB_PATH; } });
-// MAMA API
 const mama_api_js_1 = __importDefault(require("./mama-api.js"));
 exports.mama = mama_api_js_1.default;
-// Memory V2
 var types_js_1 = require("./memory/types.js");
 Object.defineProperty(exports, "MEMORY_SCOPE_KINDS", { enumerable: true, get: function () { return types_js_1.MEMORY_SCOPE_KINDS; } });
 Object.defineProperty(exports, "MEMORY_KINDS", { enumerable: true, get: function () { return types_js_1.MEMORY_KINDS; } });
@@ -82,14 +88,17 @@ Object.defineProperty(exports, "MEMORY_EDGE_TYPES", { enumerable: true, get: fun
 Object.defineProperty(exports, "createEmptyRecallBundle", { enumerable: true, get: function () { return types_js_1.createEmptyRecallBundle; } });
 var api_js_1 = require("./memory/api.js");
 Object.defineProperty(exports, "saveMemory", { enumerable: true, get: function () { return api_js_1.saveMemory; } });
+Object.defineProperty(exports, "saveMemoryWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.saveMemoryWithTrustedProvenance; } });
 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, "ingestWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.ingestWithTrustedProvenance; } });
 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, "ingestConversation", { enumerable: true, get: function () { return api_js_1.ingestConversation; } });
+Object.defineProperty(exports, "ingestConversationWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.ingestConversationWithTrustedProvenance; } });
 Object.defineProperty(exports, "setExtractionFn", { enumerable: true, get: function () { return api_js_1.setExtractionFn; } });
 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; } });
@@ -97,8 +106,76 @@ var extraction_prompt_js_1 = require("./memory/extraction-prompt.js");
 Object.defineProperty(exports, "buildExtractionPrompt", { enumerable: true, get: function () { return extraction_prompt_js_1.buildExtractionPrompt; } });
 Object.defineProperty(exports, "parseExtractionResponse", { enumerable: true, get: function () { return extraction_prompt_js_1.parseExtractionResponse; } });
 var event_store_js_1 = require("./memory/event-store.js");
+Object.defineProperty(exports, "appendMemoryEvent", { enumerable: true, get: function () { return event_store_js_1.appendMemoryEvent; } });
+Object.defineProperty(exports, "insertMemoryEventInTransaction", { enumerable: true, get: function () { return event_store_js_1.insertMemoryEventInTransaction; } });
+Object.defineProperty(exports, "listMemoryEventsForMemory", { enumerable: true, get: function () { return event_store_js_1.listMemoryEventsForMemory; } });
 Object.defineProperty(exports, "listRecentMemoryEvents", { enumerable: true, get: function () { return event_store_js_1.listRecentMemoryEvents; } });
-// Config loader
+var provenance_js_1 = require("./memory/provenance.js");
+Object.defineProperty(exports, "createTrustedProvenanceCapability", { enumerable: true, get: function () { return provenance_js_1.createTrustedProvenanceCapability; } });
+Object.defineProperty(exports, "assertTrustedProvenanceCapability", { enumerable: true, get: function () { return provenance_js_1.assertTrustedProvenanceCapability; } });
+var provenance_query_js_1 = require("./memory/provenance-query.js");
+Object.defineProperty(exports, "getMemoryProvenance", { enumerable: true, get: function () { return provenance_query_js_1.getMemoryProvenance; } });
+Object.defineProperty(exports, "listMemoriesByEnvelopeHash", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByEnvelopeHash; } });
+Object.defineProperty(exports, "listMemoriesByGatewayCallId", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByGatewayCallId; } });
+Object.defineProperty(exports, "listMemoriesByModelRunId", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByModelRunId; } });
+var scope_backfill_js_1 = require("./memory/scope-backfill.js");
+Object.defineProperty(exports, "backfillLegacyMemoryProvenance", { enumerable: true, get: function () { return scope_backfill_js_1.backfillLegacyMemoryProvenance; } });
+Object.defineProperty(exports, "backfillConnectorEventScopeMetadata", { enumerable: true, get: function () { return scope_backfill_js_1.backfillConnectorEventScopeMetadata; } });
+var provenance_audit_js_1 = require("./memory/provenance-audit.js");
+Object.defineProperty(exports, "getMemoryProvenanceAudit", { enumerable: true, get: function () { return provenance_audit_js_1.getMemoryProvenanceAudit; } });
+Object.defineProperty(exports, "listMemoryProvenanceAudit", { enumerable: true, get: function () { return provenance_audit_js_1.listMemoryProvenanceAudit; } });
+var types_js_2 = require("./model-runs/types.js");
+Object.defineProperty(exports, "MODEL_RUN_STATUSES", { enumerable: true, get: function () { return types_js_2.MODEL_RUN_STATUSES; } });
+var store_js_1 = require("./model-runs/store.js");
+Object.defineProperty(exports, "beginModelRun", { enumerable: true, get: function () { return store_js_1.beginModelRun; } });
+Object.defineProperty(exports, "beginModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.beginModelRunInAdapter; } });
+Object.defineProperty(exports, "commitModelRun", { enumerable: true, get: function () { return store_js_1.commitModelRun; } });
+Object.defineProperty(exports, "commitModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.commitModelRunInAdapter; } });
+Object.defineProperty(exports, "failModelRun", { enumerable: true, get: function () { return store_js_1.failModelRun; } });
+Object.defineProperty(exports, "failModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.failModelRunInAdapter; } });
+Object.defineProperty(exports, "getModelRun", { enumerable: true, get: function () { return store_js_1.getModelRun; } });
+Object.defineProperty(exports, "getModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.getModelRunInAdapter; } });
+var tool_trace_store_js_1 = require("./model-runs/tool-trace-store.js");
+Object.defineProperty(exports, "appendToolTrace", { enumerable: true, get: function () { return tool_trace_store_js_1.appendToolTrace; } });
+Object.defineProperty(exports, "listToolTracesForRun", { enumerable: true, get: function () { return tool_trace_store_js_1.listToolTracesForRun; } });
+var types_js_3 = require("./edges/types.js");
+Object.defineProperty(exports, "TWIN_EDGE_SOURCES", { enumerable: true, get: function () { return types_js_3.TWIN_EDGE_SOURCES; } });
+Object.defineProperty(exports, "TWIN_EDGE_TYPES", { enumerable: true, get: function () { return types_js_3.TWIN_EDGE_TYPES; } });
+Object.defineProperty(exports, "TWIN_REF_KINDS", { enumerable: true, get: function () { return types_js_3.TWIN_REF_KINDS; } });
+var store_js_2 = require("./edges/store.js");
+Object.defineProperty(exports, "getTwinEdge", { enumerable: true, get: function () { return store_js_2.getTwinEdge; } });
+Object.defineProperty(exports, "insertTwinEdge", { enumerable: true, get: function () { return store_js_2.insertTwinEdge; } });
+Object.defineProperty(exports, "listTwinEdgesForRefs", { enumerable: true, get: function () { return store_js_2.listTwinEdgesForRefs; } });
+Object.defineProperty(exports, "mapTwinEdgeRow", { enumerable: true, get: function () { return store_js_2.mapTwinEdgeRow; } });
+var ref_validation_js_1 = require("./edges/ref-validation.js");
+Object.defineProperty(exports, "assertTwinRefsVisibleToScopes", { enumerable: true, get: function () { return ref_validation_js_1.assertTwinRefsVisibleToScopes; } });
+Object.defineProperty(exports, "listVisibleTwinEdgesForRefs", { enumerable: true, get: function () { return ref_validation_js_1.listVisibleTwinEdgesForRefs; } });
+__exportStar(require("./agent-situation/index.js"), exports);
+__exportStar(require("./agent-graph/index.js"), exports);
+__exportStar(require("./entities/types.js"), exports);
+__exportStar(require("./entities/errors.js"), exports);
+__exportStar(require("./entities/store.js"), exports);
+__exportStar(require("./entities/normalization.js"), exports);
+__exportStar(require("./entities/projection.js"), exports);
+__exportStar(require("./entities/recall-bridge.js"), exports);
+__exportStar(require("./entities/read-identity.js"), exports);
+__exportStar(require("./entities/audit-metrics.js"), exports);
+__exportStar(require("./entities/provenance-query.js"), exports);
+__exportStar(require("./entities/lineage-store.js"), exports);
+__exportStar(require("./entities/lineage-backfill.js"), exports);
+__exportStar(require("./entities/exact-merge-backfill.js"), exports);
+__exportStar(require("./entities/entity-search.js"), exports);
+__exportStar(require("./entities/entity-list.js"), exports);
+__exportStar(require("./entities/entity-orphan-list.js"), exports);
+__exportStar(require("./entities/entity-impact.js"), exports);
+__exportStar(require("./entities/rollback-preview.js"), exports);
+__exportStar(require("./entities/source-locator.js"), exports);
+__exportStar(require("./entities/policy-types.js"), exports);
+__exportStar(require("./entities/policy-store.js"), exports);
+var canonicalize_js_1 = require("./canonicalize.js");
+Object.defineProperty(exports, "canonicalizeJSON", { enumerable: true, get: function () { return canonicalize_js_1.canonicalizeJSON; } });
+Object.defineProperty(exports, "targetRefHash", { enumerable: true, get: function () { return canonicalize_js_1.targetRefHash; } });
+Object.defineProperty(exports, "CanonicalizeError", { enumerable: true, get: function () { return canonicalize_js_1.CanonicalizeError; } });
 var config_loader_js_1 = require("./config-loader.js");
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_loader_js_1.loadConfig; } });
 Object.defineProperty(exports, "getModelName", { enumerable: true, get: function () { return config_loader_js_1.getModelName; } });
@@ -107,13 +184,11 @@ Object.defineProperty(exports, "getCacheDir", { enumerable: true, get: function
 Object.defineProperty(exports, "updateConfig", { enumerable: true, get: function () { return config_loader_js_1.updateConfig; } });
 Object.defineProperty(exports, "getConfigPath", { enumerable: true, get: function () { return config_loader_js_1.getConfigPath; } });
 Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_loader_js_1.DEFAULT_CONFIG; } });
-// Relevance scorer
 var relevance_scorer_js_1 = require("./relevance-scorer.js");
 Object.defineProperty(exports, "calculateRelevance", { enumerable: true, get: function () { return relevance_scorer_js_1.calculateRelevance; } });
 Object.defineProperty(exports, "selectTopDecisions", { enumerable: true, get: function () { return relevance_scorer_js_1.selectTopDecisions; } });
 Object.defineProperty(exports, "formatTopNContext", { enumerable: true, get: function () { return relevance_scorer_js_1.formatTopNContext; } });
 Object.defineProperty(exports, "testRelevanceScoring", { enumerable: true, get: function () { return relevance_scorer_js_1.testRelevanceScoring; } });
-// Decision tracker
 var decision_tracker_js_1 = require("./decision-tracker.js");
 Object.defineProperty(exports, "learnDecision", { enumerable: true, get: function () { return decision_tracker_js_1.learnDecision; } });
 Object.defineProperty(exports, "generateDecisionId", { enumerable: true, get: function () { return decision_tracker_js_1.generateDecisionId; } });
@@ -128,7 +203,6 @@ Object.defineProperty(exports, "createEdgesFromReasoning", { enumerable: true, g
 Object.defineProperty(exports, "getSupersededChainDepth", { enumerable: true, get: function () { return decision_tracker_js_1.getSupersededChainDepth; } });
 Object.defineProperty(exports, "updateConfidence", { enumerable: true, get: function () { return decision_tracker_js_1.updateConfidence; } });
 Object.defineProperty(exports, "VALID_EDGE_TYPES", { enumerable: true, get: function () { return decision_tracker_js_1.VALID_EDGE_TYPES; } });
-// Tier validator
 var tier_validator_js_1 = require("./tier-validator.js");
 Object.defineProperty(exports, "validateTier", { enumerable: true, get: function () { return tier_validator_js_1.validateTier; } });
 Object.defineProperty(exports, "checkNodeVersion", { enumerable: true, get: function () { return tier_validator_js_1.checkNodeVersion; } });
@@ -137,7 +211,6 @@ Object.defineProperty(exports, "checkEmbeddings", { enumerable: true, get: funct
 Object.defineProperty(exports, "checkDatabase", { enumerable: true, get: function () { return tier_validator_js_1.checkDatabase; } });
 Object.defineProperty(exports, "getTierDescription", { enumerable: true, get: function () { return tier_validator_js_1.getTierDescription; } });
 Object.defineProperty(exports, "getTierBanner", { enumerable: true, get: function () { return tier_validator_js_1.getTierBanner; } });
-// Progress indicator
 var progress_indicator_js_1 = require("./progress-indicator.js");
 Object.defineProperty(exports, "logProgress", { enumerable: true, get: function () { return progress_indicator_js_1.logProgress; } });
 Object.defineProperty(exports, "logComplete", { enumerable: true, get: function () { return progress_indicator_js_1.logComplete; } });
@@ -146,17 +219,14 @@ Object.defineProperty(exports, "logError", { enumerable: true, get: function ()
 Object.defineProperty(exports, "logInfo", { enumerable: true, get: function () { return progress_indicator_js_1.logInfo; } });
 Object.defineProperty(exports, "logLoading", { enumerable: true, get: function () { return progress_indicator_js_1.logLoading; } });
 Object.defineProperty(exports, "logSearching", { enumerable: true, get: function () { return progress_indicator_js_1.logSearching; } });
-// Debug logger
 var debug_logger_js_1 = require("./debug-logger.js");
 Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return debug_logger_js_1.debug; } });
 Object.defineProperty(exports, "info", { enumerable: true, get: function () { return debug_logger_js_1.info; } });
 Object.defineProperty(exports, "warn", { enumerable: true, get: function () { return debug_logger_js_1.warn; } });
 Object.defineProperty(exports, "error", { enumerable: true, get: function () { return debug_logger_js_1.error; } });
 Object.defineProperty(exports, "DebugLogger", { enumerable: true, get: function () { return debug_logger_js_1.DebugLogger; } });
-// Time formatter
 var time_formatter_js_1 = require("./time-formatter.js");
 Object.defineProperty(exports, "formatTimeAgo", { enumerable: true, get: function () { return time_formatter_js_1.formatTimeAgo; } });
-// Errors
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "MAMAError", { enumerable: true, get: function () { return errors_js_1.MAMAError; } });
 Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_js_1.NotFoundError; } });
@@ -170,7 +240,6 @@ Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function
 Object.defineProperty(exports, "ErrorCodes", { enumerable: true, get: function () { return errors_js_1.ErrorCodes; } });
 Object.defineProperty(exports, "wrapError", { enumerable: true, get: function () { return errors_js_1.wrapError; } });
 Object.defineProperty(exports, "isMAMAError", { enumerable: true, get: function () { return errors_js_1.isMAMAError; } });
-// Decision formatter
 var decision_formatter_js_1 = require("./decision-formatter.js");
 Object.defineProperty(exports, "formatContext", { enumerable: true, get: function () { return decision_formatter_js_1.formatContext; } });
 Object.defineProperty(exports, "formatLegacyContext", { enumerable: true, get: function () { return decision_formatter_js_1.formatLegacyContext; } });
@@ -183,7 +252,6 @@ Object.defineProperty(exports, "ensureTokenBudget", { enumerable: true, get: fun
 Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return decision_formatter_js_1.estimateTokens; } });
 Object.defineProperty(exports, "extractQuickAnswer", { enumerable: true, get: function () { return decision_formatter_js_1.extractQuickAnswer; } });
 Object.defineProperty(exports, "extractCodeExample", { enumerable: true, get: function () { return decision_formatter_js_1.extractCodeExample; } });
-// Outcome tracker
 var outcome_tracker_js_1 = require("./outcome-tracker.js");
 Object.defineProperty(exports, "analyzeOutcome", { enumerable: true, get: function () { return outcome_tracker_js_1.analyzeOutcome; } });
 Object.defineProperty(exports, "matchesFailureIndicators", { enumerable: true, get: function () { return outcome_tracker_js_1.matchesFailureIndicators; } });
@@ -199,14 +267,11 @@ Object.defineProperty(exports, "FAILURE_INDICATORS", { enumerable: true, get: fu
 Object.defineProperty(exports, "SUCCESS_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.SUCCESS_INDICATORS; } });
 Object.defineProperty(exports, "PARTIAL_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.PARTIAL_INDICATORS; } });
 Object.defineProperty(exports, "RECENT_WINDOW_MS", { enumerable: true, get: function () { return outcome_tracker_js_1.RECENT_WINDOW_MS; } });
-// Memory inject
 var memory_inject_js_1 = require("./memory-inject.js");
 Object.defineProperty(exports, "injectDecisionContext", { enumerable: true, get: function () { return memory_inject_js_1.injectDecisionContext; } });
-// Query intent
 var query_intent_js_1 = require("./query-intent.js");
 Object.defineProperty(exports, "analyzeIntent", { enumerable: true, get: function () { return query_intent_js_1.analyzeIntent; } });
 Object.defineProperty(exports, "extractTopicKeywords", { enumerable: true, get: function () { return query_intent_js_1.extractTopicKeywords; } });
-// Ollama client
 var ollama_client_js_1 = require("./ollama-client.js");
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return ollama_client_js_1.generate; } });
 Object.defineProperty(exports, "analyzeDecision", { enumerable: true, get: function () { return ollama_client_js_1.analyzeDecision; } });
@@ -215,7 +280,32 @@ Object.defineProperty(exports, "isAvailable", { enumerable: true, get: function
 Object.defineProperty(exports, "listModels", { enumerable: true, get: function () { return ollama_client_js_1.listModels; } });
 Object.defineProperty(exports, "DEFAULT_MODEL", { enumerable: true, get: function () { return ollama_client_js_1.DEFAULT_MODEL; } });
 Object.defineProperty(exports, "FALLBACK_MODEL", { enumerable: true, get: function () { return ollama_client_js_1.FALLBACK_MODEL; } });
-// Notification manager
 var notification_manager_js_1 = require("./notification-manager.js");
 Object.defineProperty(exports, "notifyInsight", { enumerable: true, get: function () { return notification_manager_js_1.notifyInsight; } });
+__exportStar(require("./cases/types.js"), exports);
+__exportStar(require("./cases/store.js"), exports);
+__exportStar(require("./cases/role-inference.js"), exports);
+__exportStar(require("./cases/target-ref.js"), exports);
+__exportStar(require("./cases/corrections.js"), exports);
+__exportStar(require("./cases/sqlite-transaction.js"), exports);
+__exportStar(require("./cases/live-state.js"), exports);
+__exportStar(require("./cases/tombstone-sweeper.js"), exports);
+__exportStar(require("./cases/merge-split.js"), exports);
+__exportStar(require("./cases/membership-matcher.js"), exports);
+__exportStar(require("./cases/search-rollup.js"), exports);
+__exportStar(require("./cases/timeline-range.js"), exports);
+__exportStar(require("./cases/wiki-page-index.js"), exports);
+__exportStar(require("./cases/case-links.js"), exports);
+__exportStar(require("./cases/composition-overrides.js"), exports);
+__exportStar(require("./cases/freshness.js"), exports);
+__exportStar(require("./cases/membership-explain.js"), exports);
+__exportStar(require("./connectors/event-index.js"), exports);
+__exportStar(require("./connectors/raw-query.js"), exports);
+__exportStar(require("./connectors/types.js"), exports);
+__exportStar(require("./search/question-type.js"), exports);
+__exportStar(require("./search/feedback-store.js"), exports);
+__exportStar(require("./search/ranker-features.js"), exports);
+__exportStar(require("./search/ranker-trainer.js"), exports);
+__exportStar(require("./search/ranker-rescore.js"), exports);
+__exportStar(require("./search/search-quality.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/mama-api.d.ts

@@ -19,9 +19,14 @@
  */
 import { DecisionRecord } from './db-manager.js';
 import { SemanticEdges } from './decision-formatter.js';
-import { saveMemory, recallMemory, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary } from './memory/api.js';
+import { saveMemory, saveMemoryWithTrustedProvenance, recallMemory, buildProfile, ingestMemory, ingestWithTrustedProvenance, ingestConversation, ingestConversationWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary } from './memory/api.js';
 import { listOpenAuditFindings } from './memory/finding-store.js';
-import { listRecentMemoryEvents } from './memory/event-store.js';
+import { listMemoryEventsForMemory, listRecentMemoryEvents } from './memory/event-store.js';
+import type { TrustedMemoryWriteOptions } from './memory/provenance.js';
+import { getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId } from './memory/provenance-query.js';
+import { beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter } from './model-runs/store.js';
+import { appendToolTrace, listToolTracesForRun } from './model-runs/tool-trace-store.js';
+import { type SearchHitDiagnostics, type SearchQualityOptions } from './search/search-quality.js';
 /**
  * Parameters for mama.save()
  */
@@ -42,6 +47,18 @@ interface SaveParams {
     }>;
     /** ISO 8601 date string for when the event actually occurred (e.g. "2023-01-15") */
     event_date?: string | null;
+    timelineEvent?: {
+        id?: string;
+        entity_id?: string;
+        event_type: string;
+        role?: string | null;
+        valid_from?: number | null;
+        valid_to?: number | null;
+        observed_at?: number | null;
+        source_ref?: string | null;
+        summary: string;
+        details?: string | null;
+    };
 }
 /**
  * Similar decision result from search
@@ -52,8 +69,11 @@ interface SimilarDecision {
     decision: string;
     reasoning?: string;
     similarity?: number;
+    retrieval_score?: number | null;
     created_at?: number | string;
     event_date?: string | null;
+    event_datetime?: number | null;
+    retrieval_diagnostics?: SearchHitDiagnostics;
 }
 /**
  * Search result from mama.search()
@@ -76,6 +96,7 @@ interface SearchResult {
             expanded_count: number;
             sources: Record<string, number>;
         } | null;
+        ranker: Record<string, unknown> | null;
     };
 }
 /**
@@ -85,6 +106,7 @@ export interface SuggestOptions {
     limit?: number;
     threshold?: number;
     format?: 'full' | 'teaser' | 'brief' | 'markdown';
+    rerankWithLearned?: boolean;
     recency_boost?: boolean | {
         weight?: number;
         scale?: number;
@@ -106,6 +128,9 @@ interface ReasoningGraphInfo {
 interface SaveResult {
     success: boolean;
     id: string;
+    saved_decision_id?: string;
+    timeline_event_id?: string | null;
+    timeline_event_ids?: string[];
     similar_decisions?: SimilarDecision[];
     warning?: string;
     collaboration_hint?: string;
@@ -378,34 +403,6 @@ export interface QualityReport {
         meetsTarget: boolean;
     };
 }
-/**
- * Save a decision or insight to MAMA's memory
- *
- * Simple API for Claude to save insights without complex configuration
- * AC #1: Simple API - no complex configuration required
- *
- * @param {Object} params - Decision parameters
- * @param {string} params.topic - Decision topic (e.g., 'auth_strategy', 'date_format')
- * @param {string} params.decision - The decision made (e.g., 'JWT', 'ISO 8601 + Unix')
- * @param {string} params.reasoning - Why this decision was made
- * @param {number} [params.confidence=0.5] - Confidence score 0.0-1.0 (optional)
- * @param {string} [params.type='user_decision'] - 'user_decision' or 'assistant_insight' (optional)
- * @param {string} [params.outcome='pending'] - 'pending', 'success', 'failure', 'partial', 'superseded' (optional)
- * @param {string} [params.failure_reason] - Why this decision failed (optional, used with outcome='failure')
- * @param {string} [params.limitation] - Known limitations of this decision (optional)
- * @returns {Promise<{success: boolean, id: string, similar_decisions?: Array, warning?: string, collaboration_hint?: string, reasoning_graph?: Object}>} Save result with decision ID and metadata
- *
- * @example
- * const decisionId = await mama.save({
- *   topic: 'date_calculation_format',
- *   decision: 'Support both ISO 8601 and Unix timestamp formats',
- *   reasoning: 'Bootstrap data stored as ISO 8601 causing NaN errors',
- *   confidence: 0.95,
- *   type: 'assistant_insight',
- *   outcome: 'success'
- * });
- */
-declare function save({ topic, decision, reasoning, confidence, type, outcome, failure_reason, limitation, trust_context: _trust_context, is_static, scopes: inputScopes, event_date, }: SaveParams): Promise<SaveResult>;
 /**
  * Recall decisions by topic
  *
@@ -554,21 +551,22 @@ declare function expandWithGraph(candidates: SearchCandidate[]): Promise<SearchC
  * const markdown = await mama.suggest('mesh optimization', { format: 'markdown' });
  * // → "💡 MAMA found 3 related topics:\n1. ..."
  */
-interface SuggestFunctionOptions {
+interface SuggestFunctionOptions extends SearchQualityOptions {
     format?: 'json' | 'markdown';
     limit?: number;
-    threshold?: number;
     useReranking?: boolean;
+    /** Phase 3 Task 33: apply learned offline ranker rescoring. */
+    rerankWithLearned?: boolean;
     recencyWeight?: number;
     recencyScale?: number;
     recencyDecay?: number;
-    disableRecency?: boolean;
-    topicPrefix?: string;
     scopes?: Array<{
         kind: 'global' | 'user' | 'channel' | 'project';
         id: string;
     }>;
 }
+declare function save(params: SaveParams): Promise<SaveResult>;
+declare function saveWithTrustedProvenance(params: SaveParams, options: TrustedMemoryWriteOptions): Promise<SaveResult>;
 declare function suggest(userQuestion: string, options?: SuggestFunctionOptions): Promise<any>;
 /**
  * List recent decisions (all topics, chronological)
@@ -1029,14 +1027,19 @@ declare function generateQualityReport(options?: QualityReportOptions): string |
  */
 declare const mama: {
     save: typeof save;
+    saveWithTrustedProvenance: typeof saveWithTrustedProvenance;
     suggest: typeof suggest;
     saveMemory: typeof saveMemory;
+    saveMemoryWithTrustedProvenance: typeof saveMemoryWithTrustedProvenance;
     recallMemory: typeof recallMemory;
     list: typeof listDecisions;
     listCheckpoints: typeof listCheckpoints;
     updateOutcome: typeof updateOutcome;
     buildProfile: typeof buildProfile;
     ingestMemory: typeof ingestMemory;
+    ingestWithTrustedProvenance: typeof ingestWithTrustedProvenance;
+    ingestConversation: typeof ingestConversation;
+    ingestConversationWithTrustedProvenance: typeof ingestConversationWithTrustedProvenance;
     evolveMemory: typeof evolveMemory;
     buildMemoryBootstrap: typeof buildMemoryBootstrap;
     createAuditAck: typeof createAuditAck;
@@ -1044,7 +1047,22 @@ declare const mama: {
     upsertChannelSummary: typeof upsertChannelSummary;
     getChannelSummary: typeof getChannelSummary;
     listAuditFindings: typeof listOpenAuditFindings;
+    getMemoryProvenance: typeof getMemoryProvenance;
+    listMemoriesByEnvelopeHash: typeof listMemoriesByEnvelopeHash;
+    listMemoriesByGatewayCallId: typeof listMemoriesByGatewayCallId;
+    listMemoriesByModelRunId: typeof listMemoriesByModelRunId;
+    listMemoryEventsForMemory: typeof listMemoryEventsForMemory;
     listRecentMemoryEvents: typeof listRecentMemoryEvents;
+    beginModelRun: typeof beginModelRun;
+    beginModelRunInAdapter: typeof beginModelRunInAdapter;
+    commitModelRun: typeof commitModelRun;
+    commitModelRunInAdapter: typeof commitModelRunInAdapter;
+    failModelRun: typeof failModelRun;
+    failModelRunInAdapter: typeof failModelRunInAdapter;
+    getModelRun: typeof getModelRun;
+    getModelRunInAdapter: typeof getModelRunInAdapter;
+    appendToolTrace: typeof appendToolTrace;
+    listToolTracesForRun: typeof listToolTracesForRun;
     saveCheckpoint: typeof saveCheckpoint;
     loadCheckpoint: typeof loadCheckpoint;
     recall: typeof recall;
@@ -1069,6 +1087,6 @@ declare const mama: {
     validateCleanupResult: typeof validateCleanupResult;
     expandWithGraph: typeof expandWithGraph;
 };
-export { save, suggest, saveMemory, recallMemory, listDecisions as list, listCheckpoints, updateOutcome, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary, listOpenAuditFindings, listRecentMemoryEvents, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, };
+export { save, saveWithTrustedProvenance, suggest, saveMemory, saveMemoryWithTrustedProvenance, recallMemory, listDecisions as list, listCheckpoints, updateOutcome, buildProfile, ingestMemory, ingestWithTrustedProvenance, ingestConversation, ingestConversationWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary, listOpenAuditFindings, getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, listMemoryEventsForMemory, listRecentMemoryEvents, beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, appendToolTrace, listToolTracesForRun, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, expandWithGraph, };
 export default mama;
 //# sourceMappingURL=mama-api.d.ts.map