@jungjaehoon/mama-core 2.4.1 → 4.0.0

package/dist/index.js

@@ -3,7 +3,6 @@
  * MAMA Core - Main exports
  *
  * Shared modules for Memory-Augmented MCP Assistant.
- * Used by mcp-server, claude-code-plugin, and standalone packages.
  *
  * @module mama-core
  * @version 1.0.0
@@ -26,78 +25,63 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestWithTrustedProvenance = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.promoteMemoryStatus = 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.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = 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.EmbeddingCache = exports.EMBEDDING_PREFIX_SCHEME = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
-exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.CanonicalizeError = exports.targetRefHash = exports.canonicalizeJSON = exports.listVisibleTwinEdgesForRefs = exports.mapTwinEdgeRow = exports.listTwinEdgesForRefs = exports.getTwinEdge = exports.TWIN_REF_KINDS = exports.TWIN_EDGE_TYPES = exports.TWIN_EDGE_SOURCES = exports.readToolTrace = exports.listToolTraces = 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.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.assertTrustedProvenanceCapability = exports.createTrustedProvenanceCapability = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = exports.insertMemoryEventInTransaction = exports.appendMemoryEvent = exports.listOpenAuditFindings = exports.createAuditFinding = exports.queryRelevantTruth = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = void 0;
-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 = exports.logLoading = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.formatTopNContext = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = void 0;
-exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.generate = exports.analyzeIntent = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = 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.formatList = 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; } });
-Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return embeddings_js_1.cosineSimilarity; } });
-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; } });
-Object.defineProperty(exports, "EMBEDDING_PREFIX_SCHEME", { enumerable: true, get: function () { return embeddings_js_1.EMBEDDING_PREFIX_SCHEME; } });
+exports.insertMemoryEventInTransaction = exports.appendMemoryEvent = exports.listOpenAuditFindings = exports.createAuditFinding = exports.queryRelevantTruth = exports.JudgmentError = exports.ingestSource = exports.appendJudgment = exports.createKnowledge = exports.getChannelSummary = exports.upsertChannelSummary = exports.ingestConversation = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.retireMemoryRecord = exports.readMemoryRecordsInScopes = exports.readMemoryRecordById = exports.promoteMemoryStatus = exports.saveLegacyMemory = exports.saveJudgmentRecord = exports.saveMemory = exports.canonicalizeContextScopes = exports.createEmptyRecallBundle = exports.MEMORY_EDGE_TYPES = exports.MEMORY_STATUSES = exports.MEMORY_KINDS = exports.MEMORY_SCOPE_KINDS = exports.createMamaApi = exports.mama = exports.SQLiteAdapter = exports.createAdapter = exports.getDbPath = exports.updateDecisionOutcome = exports.closeDB = exports.getAdapter = exports.getDB = exports.initDB = exports.EmbeddingCache = exports.EMBEDDING_PREFIX_SCHEME = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
+exports.newRequestId = exports.IpcTransportError = exports.encodeFrame = exports.createActionIpcServer = exports.startRuntime = exports.createClient = exports.withCallReceipt = exports.validateInput = exports.createDispatcher = exports.UnknownActionError = exports.coreActionRegistrations = exports.createCatalog = exports.listVisibleTwinEdgesForRefs = exports.mapTwinEdgeRow = exports.listTwinEdgesForRefs = exports.insertTwinEdge = exports.getTwinEdge = exports.TWIN_REF_KINDS = exports.TWIN_EDGE_TYPES = exports.TWIN_EDGE_SOURCES = exports.readToolTrace = exports.listToolTraces = exports.listToolTracesForRun = exports.appendOperationToolTrace = exports.appendToolTrace = exports.getModelRun = exports.failModelRun = exports.commitModelRun = exports.beginModelRun = exports.MODEL_RUN_STATUSES = exports.scanMemoryWriteInput = exports.scanForSecrets = exports.sanitizeRecallText = exports.sanitizeRecallBundle = exports.resolveMemoryProvenance = exports.toIndexedEvent = exports.resolveMemoryProvenanceLive = exports.parseSourceRef = exports.isMessageRefVisible = exports.isEventVisibleNow = exports.OBSERVATION_COLUMNS = exports.listMemoryProvenanceAudit = exports.getMemoryProvenanceAudit = exports.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.normalizeMemoryWriteProvenance = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = void 0;
+exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.generate = exports.extractCodeExample = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = 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.DebugLogger = exports.error = exports.warn = exports.info = exports.debug = exports.logSearching = exports.logLoading = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.formatTopNContext = exports.selectTopDecisions = exports.calculateRelevance = exports.CanonicalizeError = exports.targetRefHash = exports.canonicalizeJSON = exports.IPC_MAX_FRAME_BYTES = exports.sendIpcRequest = void 0;
+var embedder_js_1 = require("./embedding/embedder.js");
+Object.defineProperty(exports, "generateEmbedding", { enumerable: true, get: function () { return embedder_js_1.generateEmbedding; } });
+Object.defineProperty(exports, "generateEnhancedEmbedding", { enumerable: true, get: function () { return embedder_js_1.generateEnhancedEmbedding; } });
+Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return embedder_js_1.cosineSimilarity; } });
+Object.defineProperty(exports, "embeddingCache", { enumerable: true, get: function () { return embedder_js_1.embeddingCache; } });
+Object.defineProperty(exports, "EMBEDDING_DIM", { enumerable: true, get: function () { return embedder_js_1.EMBEDDING_DIM; } });
+Object.defineProperty(exports, "MODEL_NAME", { enumerable: true, get: function () { return embedder_js_1.MODEL_NAME; } });
+Object.defineProperty(exports, "EMBEDDING_PREFIX_SCHEME", { enumerable: true, get: function () { return embedder_js_1.EMBEDDING_PREFIX_SCHEME; } });
 var embedding_cache_js_1 = require("./embedding-cache.js");
 Object.defineProperty(exports, "EmbeddingCache", { enumerable: true, get: function () { return embedding_cache_js_1.EmbeddingCache; } });
-var embedding_client_js_1 = require("./embedding-client.js");
-Object.defineProperty(exports, "getServerPort", { enumerable: true, get: function () { return embedding_client_js_1.getServerPort; } });
-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; } });
 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; } });
 Object.defineProperty(exports, "getAdapter", { enumerable: true, get: function () { return db_manager_js_1.getAdapter; } });
 Object.defineProperty(exports, "closeDB", { enumerable: true, get: function () { return db_manager_js_1.closeDB; } });
-Object.defineProperty(exports, "insertEmbedding", { enumerable: true, get: function () { return db_manager_js_1.insertEmbedding; } });
-Object.defineProperty(exports, "vectorSearch", { enumerable: true, get: function () { return db_manager_js_1.vectorSearch; } });
-Object.defineProperty(exports, "queryVectorSearch", { enumerable: true, get: function () { return db_manager_js_1.queryVectorSearch; } });
-Object.defineProperty(exports, "insertDecisionWithEmbedding", { enumerable: true, get: function () { return db_manager_js_1.insertDecisionWithEmbedding; } });
-Object.defineProperty(exports, "queryDecisionGraph", { enumerable: true, get: function () { return db_manager_js_1.queryDecisionGraph; } });
-Object.defineProperty(exports, "querySemanticEdges", { enumerable: true, get: function () { return db_manager_js_1.querySemanticEdges; } });
 Object.defineProperty(exports, "updateDecisionOutcome", { enumerable: true, get: function () { return db_manager_js_1.updateDecisionOutcome; } });
-Object.defineProperty(exports, "getPreparedStmt", { enumerable: true, get: function () { return db_manager_js_1.getPreparedStmt; } });
 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; } });
 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; } });
-var memory_store_js_1 = require("./memory-store.js");
-Object.defineProperty(exports, "traverseDecisionChain", { enumerable: true, get: function () { return memory_store_js_1.traverseDecisionChain; } });
-Object.defineProperty(exports, "DB_PATH", { enumerable: true, get: function () { return memory_store_js_1.DB_PATH; } });
-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; } });
 const mama_api_js_1 = __importDefault(require("./mama-api.js"));
 exports.mama = mama_api_js_1.default;
+var mama_api_js_2 = require("./mama-api.js");
+Object.defineProperty(exports, "createMamaApi", { enumerable: true, get: function () { return mama_api_js_2.createMamaApi; } });
 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; } });
 Object.defineProperty(exports, "MEMORY_STATUSES", { enumerable: true, get: function () { return types_js_1.MEMORY_STATUSES; } });
 Object.defineProperty(exports, "MEMORY_EDGE_TYPES", { enumerable: true, get: function () { return types_js_1.MEMORY_EDGE_TYPES; } });
 Object.defineProperty(exports, "createEmptyRecallBundle", { enumerable: true, get: function () { return types_js_1.createEmptyRecallBundle; } });
+Object.defineProperty(exports, "canonicalizeContextScopes", { enumerable: true, get: function () { return types_js_1.canonicalizeContextScopes; } });
 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, "saveJudgmentRecord", { enumerable: true, get: function () { return api_js_1.saveJudgmentRecord; } });
+Object.defineProperty(exports, "saveLegacyMemory", { enumerable: true, get: function () { return api_js_1.saveLegacyMemory; } });
 Object.defineProperty(exports, "promoteMemoryStatus", { enumerable: true, get: function () { return api_js_1.promoteMemoryStatus; } });
+Object.defineProperty(exports, "readMemoryRecordById", { enumerable: true, get: function () { return api_js_1.readMemoryRecordById; } });
+Object.defineProperty(exports, "readMemoryRecordsInScopes", { enumerable: true, get: function () { return api_js_1.readMemoryRecordsInScopes; } });
+Object.defineProperty(exports, "retireMemoryRecord", { enumerable: true, get: function () { return api_js_1.retireMemoryRecord; } });
 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; } });
-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 index_js_2 = require("./knowledge/index.js");
+Object.defineProperty(exports, "createKnowledge", { enumerable: true, get: function () { return index_js_2.createKnowledge; } });
+Object.defineProperty(exports, "appendJudgment", { enumerable: true, get: function () { return index_js_2.appendJudgment; } });
+Object.defineProperty(exports, "ingestSource", { enumerable: true, get: function () { return index_js_2.ingestSource; } });
+Object.defineProperty(exports, "JudgmentError", { enumerable: true, get: function () { return index_js_2.JudgmentError; } });
 var truth_store_js_1 = require("./memory/truth-store.js");
 Object.defineProperty(exports, "queryRelevantTruth", { enumerable: true, get: function () { return truth_store_js_1.queryRelevantTruth; } });
 var finding_store_js_1 = require("./memory/finding-store.js");
@@ -109,8 +93,7 @@ Object.defineProperty(exports, "insertMemoryEventInTransaction", { enumerable: t
 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; } });
 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; } });
+Object.defineProperty(exports, "normalizeMemoryWriteProvenance", { enumerable: true, get: function () { return provenance_js_1.normalizeMemoryWriteProvenance; } });
 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; } });
@@ -119,88 +102,75 @@ Object.defineProperty(exports, "listMemoriesByModelRunId", { enumerable: true, g
 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");
+var provenance_live_js_1 = require("./memory/provenance-live.js");
+Object.defineProperty(exports, "OBSERVATION_COLUMNS", { enumerable: true, get: function () { return provenance_live_js_1.OBSERVATION_COLUMNS; } });
+Object.defineProperty(exports, "isEventVisibleNow", { enumerable: true, get: function () { return provenance_live_js_1.isEventVisibleNow; } });
+Object.defineProperty(exports, "isMessageRefVisible", { enumerable: true, get: function () { return provenance_live_js_1.isMessageRefVisible; } });
+Object.defineProperty(exports, "parseSourceRef", { enumerable: true, get: function () { return provenance_live_js_1.parseSourceRef; } });
+Object.defineProperty(exports, "resolveMemoryProvenanceLive", { enumerable: true, get: function () { return provenance_live_js_1.resolveMemoryProvenanceLive; } });
+Object.defineProperty(exports, "toIndexedEvent", { enumerable: true, get: function () { return provenance_live_js_1.toIndexedEvent; } });
+var provenance_resolver_js_1 = require("./memory/provenance-resolver.js");
+Object.defineProperty(exports, "resolveMemoryProvenance", { enumerable: true, get: function () { return provenance_resolver_js_1.resolveMemoryProvenance; } });
+var recall_sanitize_js_1 = require("./memory/recall-sanitize.js");
+Object.defineProperty(exports, "sanitizeRecallBundle", { enumerable: true, get: function () { return recall_sanitize_js_1.sanitizeRecallBundle; } });
+Object.defineProperty(exports, "sanitizeRecallText", { enumerable: true, get: function () { return recall_sanitize_js_1.sanitizeRecallText; } });
+var secret_filter_js_1 = require("./memory/secret-filter.js");
+Object.defineProperty(exports, "scanForSecrets", { enumerable: true, get: function () { return secret_filter_js_1.scanForSecrets; } });
+Object.defineProperty(exports, "scanMemoryWriteInput", { enumerable: true, get: function () { return secret_filter_js_1.scanMemoryWriteInput; } });
+var model_run_types_js_1 = require("./runtime/model-run-types.js");
+Object.defineProperty(exports, "MODEL_RUN_STATUSES", { enumerable: true, get: function () { return model_run_types_js_1.MODEL_RUN_STATUSES; } });
+var model_run_store_js_1 = require("./runtime/model-run-store.js");
+Object.defineProperty(exports, "beginModelRun", { enumerable: true, get: function () { return model_run_store_js_1.beginModelRun; } });
+Object.defineProperty(exports, "commitModelRun", { enumerable: true, get: function () { return model_run_store_js_1.commitModelRun; } });
+Object.defineProperty(exports, "failModelRun", { enumerable: true, get: function () { return model_run_store_js_1.failModelRun; } });
+Object.defineProperty(exports, "getModelRun", { enumerable: true, get: function () { return model_run_store_js_1.getModelRun; } });
+var tool_trace_store_js_1 = require("./runtime/tool-trace-store.js");
 Object.defineProperty(exports, "appendToolTrace", { enumerable: true, get: function () { return tool_trace_store_js_1.appendToolTrace; } });
+Object.defineProperty(exports, "appendOperationToolTrace", { enumerable: true, get: function () { return tool_trace_store_js_1.appendOperationToolTrace; } });
 Object.defineProperty(exports, "listToolTracesForRun", { enumerable: true, get: function () { return tool_trace_store_js_1.listToolTracesForRun; } });
 Object.defineProperty(exports, "listToolTraces", { enumerable: true, get: function () { return tool_trace_store_js_1.listToolTraces; } });
 Object.defineProperty(exports, "readToolTrace", { enumerable: true, get: function () { return tool_trace_store_js_1.readToolTrace; } });
-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, "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, "listVisibleTwinEdgesForRefs", { enumerable: true, get: function () { return ref_validation_js_1.listVisibleTwinEdgesForRefs; } });
-__exportStar(require("./context-compile/index.js"), exports);
+var twin_edge_types_js_1 = require("./knowledge/twin-edge-types.js");
+Object.defineProperty(exports, "TWIN_EDGE_SOURCES", { enumerable: true, get: function () { return twin_edge_types_js_1.TWIN_EDGE_SOURCES; } });
+Object.defineProperty(exports, "TWIN_EDGE_TYPES", { enumerable: true, get: function () { return twin_edge_types_js_1.TWIN_EDGE_TYPES; } });
+Object.defineProperty(exports, "TWIN_REF_KINDS", { enumerable: true, get: function () { return twin_edge_types_js_1.TWIN_REF_KINDS; } });
+var judgments_js_1 = require("./knowledge/judgments.js");
+Object.defineProperty(exports, "getTwinEdge", { enumerable: true, get: function () { return judgments_js_1.getTwinEdge; } });
+Object.defineProperty(exports, "insertTwinEdge", { enumerable: true, get: function () { return judgments_js_1.insertTwinEdge; } });
+Object.defineProperty(exports, "listTwinEdgesForRefs", { enumerable: true, get: function () { return judgments_js_1.listTwinEdgesForRefs; } });
+Object.defineProperty(exports, "mapTwinEdgeRow", { enumerable: true, get: function () { return judgments_js_1.mapTwinEdgeRow; } });
+var access_js_1 = require("./knowledge/access.js");
+Object.defineProperty(exports, "listVisibleTwinEdgesForRefs", { enumerable: true, get: function () { return access_js_1.listVisibleTwinEdgesForRefs; } });
+var catalog_js_1 = require("./api/catalog.js");
+Object.defineProperty(exports, "createCatalog", { enumerable: true, get: function () { return catalog_js_1.createCatalog; } });
+Object.defineProperty(exports, "coreActionRegistrations", { enumerable: true, get: function () { return catalog_js_1.coreActionRegistrations; } });
+Object.defineProperty(exports, "UnknownActionError", { enumerable: true, get: function () { return catalog_js_1.UnknownActionError; } });
+var dispatch_js_1 = require("./api/dispatch.js");
+Object.defineProperty(exports, "createDispatcher", { enumerable: true, get: function () { return dispatch_js_1.createDispatcher; } });
+Object.defineProperty(exports, "validateInput", { enumerable: true, get: function () { return dispatch_js_1.validateInput; } });
+Object.defineProperty(exports, "withCallReceipt", { enumerable: true, get: function () { return dispatch_js_1.withCallReceipt; } });
+var client_js_1 = require("./client/client.js");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_js_1.createClient; } });
+var runtime_js_1 = require("./runtime/runtime.js");
+Object.defineProperty(exports, "startRuntime", { enumerable: true, get: function () { return runtime_js_1.startRuntime; } });
+var ipc_js_1 = require("./client/ipc.js");
+Object.defineProperty(exports, "createActionIpcServer", { enumerable: true, get: function () { return ipc_js_1.createActionIpcServer; } });
+Object.defineProperty(exports, "encodeFrame", { enumerable: true, get: function () { return ipc_js_1.encodeFrame; } });
+Object.defineProperty(exports, "IpcTransportError", { enumerable: true, get: function () { return ipc_js_1.IpcTransportError; } });
+Object.defineProperty(exports, "newRequestId", { enumerable: true, get: function () { return ipc_js_1.newRequestId; } });
+Object.defineProperty(exports, "sendIpcRequest", { enumerable: true, get: function () { return ipc_js_1.sendIpcRequest; } });
+Object.defineProperty(exports, "IPC_MAX_FRAME_BYTES", { enumerable: true, get: function () { return ipc_js_1.IPC_MAX_FRAME_BYTES; } });
 __exportStar(require("./provenance/source-ref.js"), exports);
-__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/entity-search.js"), exports);
-__exportStar(require("./entities/entity-list.js"), exports);
-__exportStar(require("./entities/entity-orphan-list.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);
+__exportStar(require("./knowledge/case-errors.js"), exports);
+__exportStar(require("./knowledge/graph-query.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; } });
-Object.defineProperty(exports, "getEmbeddingDim", { enumerable: true, get: function () { return config_loader_js_1.getEmbeddingDim; } });
-Object.defineProperty(exports, "getCacheDir", { enumerable: true, get: function () { return config_loader_js_1.getCacheDir; } });
-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; } });
 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; } });
-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; } });
-Object.defineProperty(exports, "getPreviousDecision", { enumerable: true, get: function () { return decision_tracker_js_1.getPreviousDecision; } });
-Object.defineProperty(exports, "createEdge", { enumerable: true, get: function () { return decision_tracker_js_1.createEdge; } });
-Object.defineProperty(exports, "createSupersedesEdge", { enumerable: true, get: function () { return decision_tracker_js_1.createSupersedesEdge; } });
-Object.defineProperty(exports, "markSuperseded", { enumerable: true, get: function () { return decision_tracker_js_1.markSuperseded; } });
-Object.defineProperty(exports, "calculateCombinedConfidence", { enumerable: true, get: function () { return decision_tracker_js_1.calculateCombinedConfidence; } });
-Object.defineProperty(exports, "detectRefinement", { enumerable: true, get: function () { return decision_tracker_js_1.detectRefinement; } });
-Object.defineProperty(exports, "parseReasoningForRelationships", { enumerable: true, get: function () { return decision_tracker_js_1.parseReasoningForRelationships; } });
-Object.defineProperty(exports, "createEdgesFromReasoning", { enumerable: true, get: function () { return decision_tracker_js_1.createEdgesFromReasoning; } });
-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; } });
-var tier_validator_js_1 = require("./tier-validator.js");
-Object.defineProperty(exports, "checkNodeVersion", { enumerable: true, get: function () { return tier_validator_js_1.checkNodeVersion; } });
-Object.defineProperty(exports, "checkSQLite", { enumerable: true, get: function () { return tier_validator_js_1.checkSQLite; } });
-Object.defineProperty(exports, "checkEmbeddings", { enumerable: true, get: function () { return tier_validator_js_1.checkEmbeddings; } });
-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; } });
 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; } });
@@ -214,8 +184,6 @@ Object.defineProperty(exports, "info", { enumerable: true, get: function () { re
 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; } });
-var time_formatter_js_1 = require("./time-formatter.js");
-Object.defineProperty(exports, "formatTimeAgo", { enumerable: true, get: function () { return time_formatter_js_1.formatTimeAgo; } });
 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; } });
@@ -239,43 +207,27 @@ 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; } });
-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; } });
-Object.defineProperty(exports, "matchesSuccessIndicators", { enumerable: true, get: function () { return outcome_tracker_js_1.matchesSuccessIndicators; } });
-Object.defineProperty(exports, "matchesPartialIndicators", { enumerable: true, get: function () { return outcome_tracker_js_1.matchesPartialIndicators; } });
-Object.defineProperty(exports, "extractFailureReason", { enumerable: true, get: function () { return outcome_tracker_js_1.extractFailureReason; } });
-Object.defineProperty(exports, "getRecentDecision", { enumerable: true, get: function () { return outcome_tracker_js_1.getRecentDecision; } });
-Object.defineProperty(exports, "calculateDurationDays", { enumerable: true, get: function () { return outcome_tracker_js_1.calculateDurationDays; } });
-Object.defineProperty(exports, "getEvidenceImpact", { enumerable: true, get: function () { return outcome_tracker_js_1.getEvidenceImpact; } });
-Object.defineProperty(exports, "markOutcome", { enumerable: true, get: function () { return outcome_tracker_js_1.markOutcome; } });
-Object.defineProperty(exports, "FAILURE_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.FAILURE_INDICATORS; } });
-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; } });
-var query_intent_js_1 = require("./query-intent.js");
-Object.defineProperty(exports, "analyzeIntent", { enumerable: true, get: function () { return query_intent_js_1.analyzeIntent; } });
 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, "isAvailable", { enumerable: true, get: function () { return ollama_client_js_1.isAvailable; } });
 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; } });
-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/search-rollup.js"), exports);
-__exportStar(require("./cases/timeline-range.js"), exports);
-__exportStar(require("./cases/wiki-page-index.js"), exports);
-__exportStar(require("./connectors/event-index.js"), exports);
-__exportStar(require("./connectors/raw-query.js"), exports);
-__exportStar(require("./connectors/types.js"), exports);
+__exportStar(require("./knowledge/case-types.js"), exports);
+__exportStar(require("./knowledge/case-store.js"), exports);
+__exportStar(require("./knowledge/case-search-rollup.js"), exports);
+__exportStar(require("./knowledge/case-timeline-range.js"), exports);
+__exportStar(require("./knowledge/observations.js"), exports);
 __exportStar(require("./identity/principal-repository.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);
+__exportStar(require("./knowledge/question-type.js"), exports);
+__exportStar(require("./knowledge/feedback-store.js"), exports);
+__exportStar(require("./knowledge/ranker-features.js"), exports);
+__exportStar(require("./knowledge/ranker-trainer.js"), exports);
+__exportStar(require("./knowledge/ranker-rescore.js"), exports);
+__exportStar(require("./knowledge/search-quality.js"), exports);
+__exportStar(require("./registry/store.js"), exports);
+__exportStar(require("./registry/record-identity.js"), exports);
+__exportStar(require("./registry/corrections.js"), exports);
+__exportStar(require("./registry/types.js"), exports);
+__exportStar(require("./operations/owner-action-effects.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/{context-compile/channel-grant.d.ts → knowledge/access.d.ts}

@@ -1,19 +1,13 @@
-/**
- * The raw visibility rule, in one place.
- *
- * There were three copies of this decision. The reader had one, twin-ref validation had a
- * second, and the standalone citation path had a third that carried a comment promising it
- * reproduced the reader "clause for clause" - which it did, until the reader changed. The
- * differential test that was supposed to catch that kept passing, because its fixtures
- * never exercised the branch production takes. Copies pinned by a test are still copies;
- * the test just tells you later.
- *
- * So the rule lives here, and everything that needs it takes it from here. It has to exist
- * in two compiled forms - a boolean for checking one row you already hold, and SQL for
- * selecting rows you do not - and those two forms are adjacent in this file with a
- * differential over a matrix that includes what production sends. Two forms of one rule is
- * the irreducible minimum; three copies of a decision is not.
- */
+import type { DatabaseAdapter } from '../db-manager.js';
+import type { ListVisibleTwinEdgesOptions, TwinEdgeRecord, TwinRef, TwinVisibility } from './twin-edge-types.js';
+type TwinRefVisibilityAdapter = Pick<DatabaseAdapter, 'prepare'>;
+export declare class TwinRefNotVisibleError extends Error {
+    constructor(ref: TwinRef);
+}
+export declare function visibleTwinRefKeys(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], visibility: TwinVisibility): Set<string>;
+export declare function visibleTwinRefKeysRecursive(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], visibility: TwinVisibility): Set<string>;
+export declare function assertTwinRefsVisible(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], visibility?: TwinVisibility): void;
+export declare function listVisibleTwinEdgesForRefs(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], options?: ListVisibleTwinEdgesOptions): TwinEdgeRecord[];
 /** Connector -> the channels of it that may be read. */
 export type ChannelGrant = Record<string, readonly string[]>;
 /**
@@ -43,4 +37,5 @@ export declare function channelGrantClause(grant: ChannelGrant, requestedConnect
     connector: string;
     channel: string;
 }): ChannelGrantClause | null;
-//# sourceMappingURL=channel-grant.d.ts.map
+export {};
+//# sourceMappingURL=access.d.ts.map