@jungjaehoon/mama-core 1.5.0 → 1.7.0

package/dist/entities/store.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityMergeError = void 0;
+exports.clearEntityTableColumnCache = clearEntityTableColumnCache;
 exports.parseObservationRow = parseObservationRow;
 exports.createEntityNode = createEntityNode;
 exports.getEntityNode = getEntityNode;
@@ -25,6 +26,13 @@ class EntityMergeError extends Error {
 }
 exports.EntityMergeError = EntityMergeError;
 const MAX_MERGE_CHAIN_DEPTH = 8;
+const OBSERVATION_CONTEXT_KEY_COLUMNS = [
+    'workspace_context_key',
+    'channel_context_key',
+    'thread_context_key',
+    'actor_context_key',
+];
+const tableColumnCache = new WeakMap();
 function now() {
     return Date.now();
 }
@@ -32,6 +40,58 @@ function normalizeSourceLocator(value) {
     // Write empty-string as the null sentinel so SQLite UNIQUE can collapse null-like locators; parseObservationRow maps it back to null on read.
     return value ?? '';
 }
+function normalizeContextKey(value) {
+    return value ?? '';
+}
+function sourceLocatorForInput(input) {
+    return normalizeSourceLocator(input.source_locator);
+}
+function channelContextKey(input) {
+    if (input.channel_context_key !== undefined) {
+        return normalizeContextKey(input.channel_context_key);
+    }
+    if (input.scope_kind !== 'channel' || !input.scope_id) {
+        return '';
+    }
+    return input.scope_id.startsWith(`${input.source_connector}:`)
+        ? input.scope_id
+        : `${input.source_connector}:${input.scope_id}`;
+}
+function actorContextKey(input) {
+    if (input.actor_context_key !== undefined) {
+        return normalizeContextKey(input.actor_context_key);
+    }
+    if (input.observation_type === 'author') {
+        return input.surface_form;
+    }
+    return input.related_surface_forms.find((value) => value.trim().length > 0) ?? '';
+}
+function observationContextKeys(input) {
+    return {
+        workspace_context_key: normalizeContextKey(input.workspace_context_key ?? input.source_connector),
+        channel_context_key: channelContextKey(input),
+        thread_context_key: normalizeContextKey(input.thread_context_key),
+        actor_context_key: actorContextKey(input),
+    };
+}
+function tableColumnNames(adapter, tableName) {
+    let adapterCache = tableColumnCache.get(adapter);
+    if (!adapterCache) {
+        adapterCache = new Map();
+        tableColumnCache.set(adapter, adapterCache);
+    }
+    const cached = adapterCache.get(tableName);
+    if (cached) {
+        return cached;
+    }
+    const rows = adapter.prepare(`PRAGMA table_info(${tableName})`).all();
+    const columns = new Set(rows.map((row) => row.name));
+    adapterCache.set(tableName, columns);
+    return columns;
+}
+function clearEntityTableColumnCache(adapter) {
+    tableColumnCache.delete(adapter);
+}
 function requireStringField(row, field) {
     if (typeof row[field] !== 'string' || row[field].length === 0) {
         throw new Error(`Invalid entity observation row: ${field} must be a non-empty string`);
@@ -134,6 +194,10 @@ function parseObservationRow(row) {
         source_connector: requireStringField(row, 'source_connector'),
         source_locator: sourceLocator && sourceLocator.length > 0 ? sourceLocator : null,
         source_raw_record_id: requireStringField(row, 'source_raw_record_id'),
+        workspace_context_key: optionalStringFieldIfPresent(row, 'workspace_context_key'),
+        channel_context_key: optionalStringFieldIfPresent(row, 'channel_context_key'),
+        thread_context_key: optionalStringFieldIfPresent(row, 'thread_context_key'),
+        actor_context_key: optionalStringFieldIfPresent(row, 'actor_context_key'),
         created_at: createdAt,
     };
 }
@@ -226,44 +290,152 @@ function listEntityAliases(entityId, adapter = (0, db_manager_js_1.getAdapter)()
         created_at: Number(row.created_at),
     }));
 }
-async function upsertEntityObservation(input) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const createdAt = now();
-    const normalizedSourceLocator = normalizeSourceLocator(input.source_locator);
+function observationContextColumns(columns) {
+    return OBSERVATION_CONTEXT_KEY_COLUMNS.filter((column) => columns.has(column));
+}
+function observationInsertValues(input, normalizedSourceLocator, contextColumns, contextKeys, createdAt) {
+    const columns = [
+        'id',
+        'observation_type',
+        'entity_kind_hint',
+        'surface_form',
+        'normalized_form',
+        'lang',
+        'script',
+        'context_summary',
+        'related_surface_forms',
+        'timestamp_observed',
+        'scope_kind',
+        'scope_id',
+        'extractor_version',
+        'embedding_model_version',
+        'source_connector',
+        'source_locator',
+        'source_raw_record_id',
+        ...contextColumns,
+        'created_at',
+    ];
+    const values = [
+        input.id,
+        input.observation_type,
+        input.entity_kind_hint,
+        input.surface_form,
+        input.normalized_form,
+        input.lang,
+        input.script,
+        input.context_summary,
+        JSON.stringify(input.related_surface_forms),
+        input.timestamp_observed,
+        input.scope_kind,
+        input.scope_id,
+        input.extractor_version,
+        input.embedding_model_version,
+        input.source_connector,
+        normalizedSourceLocator,
+        input.source_raw_record_id,
+        ...contextColumns.map((column) => contextKeys[column]),
+        createdAt,
+    ];
+    return { columns, values };
+}
+function findExistingObservation(adapter, input, normalizedSourceLocator, contextColumns, contextKeys) {
+    const conditions = [
+        'source_connector = ?',
+        'source_locator = ?',
+        'source_raw_record_id = ?',
+        'observation_type = ?',
+        ...contextColumns.map((column) => `COALESCE(${column}, '') = ?`),
+    ];
+    const params = [
+        input.source_connector,
+        normalizedSourceLocator,
+        input.source_raw_record_id,
+        input.observation_type,
+        ...contextColumns.map((column) => contextKeys[column]),
+    ];
+    return adapter
+        .prepare(`
+        SELECT id FROM entity_observations
+        WHERE ${conditions.join(' AND ')}
+        ORDER BY created_at ASC, id ASC
+        LIMIT 1
+      `)
+        .get(...params);
+}
+function insertObservation(adapter, input, normalizedSourceLocator, contextColumns, contextKeys, createdAt) {
+    const insert = observationInsertValues(input, normalizedSourceLocator, contextColumns, contextKeys, createdAt);
+    const placeholders = insert.columns.map(() => '?').join(', ');
     adapter
         .prepare(`
-        INSERT INTO entity_observations (
-          id, observation_type, entity_kind_hint, surface_form, normalized_form, lang, script,
-          context_summary, related_surface_forms, timestamp_observed, scope_kind, scope_id,
-          extractor_version, embedding_model_version, source_connector, source_locator,
-          source_raw_record_id, created_at
-        )
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-        ON CONFLICT(source_connector, source_locator, source_raw_record_id, observation_type)
-        DO UPDATE SET
-          entity_kind_hint = excluded.entity_kind_hint,
-          surface_form = excluded.surface_form,
-          normalized_form = excluded.normalized_form,
-          lang = excluded.lang,
-          script = excluded.script,
-          context_summary = excluded.context_summary,
-          related_surface_forms = excluded.related_surface_forms,
-          timestamp_observed = excluded.timestamp_observed,
-          scope_kind = excluded.scope_kind,
-          scope_id = excluded.scope_id,
-          extractor_version = excluded.extractor_version,
-          embedding_model_version = excluded.embedding_model_version,
-          source_locator = excluded.source_locator,
-          created_at = entity_observations.created_at
+        INSERT INTO entity_observations (${insert.columns.join(', ')})
+        VALUES (${placeholders})
       `)
-        .run(input.id, input.observation_type, input.entity_kind_hint, input.surface_form, input.normalized_form, input.lang, input.script, input.context_summary, JSON.stringify(input.related_surface_forms), input.timestamp_observed, input.scope_kind, input.scope_id, input.extractor_version, input.embedding_model_version, input.source_connector, normalizedSourceLocator, input.source_raw_record_id, createdAt);
-    const saved = adapter
+        .run(...insert.values);
+}
+function updateObservation(adapter, id, input, normalizedSourceLocator, contextColumns, contextKeys) {
+    const assignments = [
+        'entity_kind_hint = ?',
+        'surface_form = ?',
+        'normalized_form = ?',
+        'lang = ?',
+        'script = ?',
+        'context_summary = ?',
+        'related_surface_forms = ?',
+        'timestamp_observed = ?',
+        'scope_kind = ?',
+        'scope_id = ?',
+        'extractor_version = ?',
+        'embedding_model_version = ?',
+        'source_locator = ?',
+        ...contextColumns.map((column) => `${column} = ?`),
+    ];
+    const values = [
+        input.entity_kind_hint,
+        input.surface_form,
+        input.normalized_form,
+        input.lang,
+        input.script,
+        input.context_summary,
+        JSON.stringify(input.related_surface_forms),
+        input.timestamp_observed,
+        input.scope_kind,
+        input.scope_id,
+        input.extractor_version,
+        input.embedding_model_version,
+        normalizedSourceLocator,
+        ...contextColumns.map((column) => contextKeys[column]),
+        id,
+    ];
+    adapter
         .prepare(`
-        SELECT * FROM entity_observations
-        WHERE source_connector = ? AND source_locator = ? AND source_raw_record_id = ? AND observation_type = ?
+        UPDATE entity_observations
+        SET ${assignments.join(', ')}
+        WHERE id = ?
       `)
-        .get(input.source_connector, normalizedSourceLocator, input.source_raw_record_id, input.observation_type);
+        .run(...values);
+}
+function saveObservation(adapter, input) {
+    const columns = tableColumnNames(adapter, 'entity_observations');
+    const contextColumns = observationContextColumns(columns);
+    const contextKeys = observationContextKeys(input);
+    const normalizedSourceLocator = sourceLocatorForInput(input);
+    const existing = findExistingObservation(adapter, input, normalizedSourceLocator, contextColumns, contextKeys);
+    if (existing) {
+        const id = requireStringField(existing, 'id');
+        updateObservation(adapter, id, input, normalizedSourceLocator, contextColumns, contextKeys);
+        return { id, created: false };
+    }
+    insertObservation(adapter, input, normalizedSourceLocator, contextColumns, contextKeys, now());
+    return { id: input.id, created: true };
+}
+async function upsertEntityObservation(input) {
+    await (0, db_manager_js_1.initDB)();
+    const adapter = (0, db_manager_js_1.getAdapter)();
+    const result = saveObservation(adapter, input);
+    const saved = adapter.prepare('SELECT * FROM entity_observations WHERE id = ?').get(result.id);
+    if (!saved) {
+        throw new Error(`Failed to load saved entity observation ${result.id}`);
+    }
     return parseObservationRow(saved);
 }
 async function upsertEntityObservations(inputs) {
@@ -271,51 +443,7 @@ async function upsertEntityObservations(inputs) {
     const adapter = (0, db_manager_js_1.getAdapter)();
     const observations = [];
     const upsertOne = (input) => {
-        const normalizedSourceLocator = normalizeSourceLocator(input.source_locator);
-        const existing = adapter
-            .prepare(`
-          SELECT id FROM entity_observations
-          WHERE source_connector = ? AND source_locator = ? AND source_raw_record_id = ? AND observation_type = ?
-        `)
-            .get(input.source_connector, normalizedSourceLocator, input.source_raw_record_id, input.observation_type);
-        const createdAt = now();
-        adapter
-            .prepare(`
-          INSERT INTO entity_observations (
-            id, observation_type, entity_kind_hint, surface_form, normalized_form, lang, script,
-            context_summary, related_surface_forms, timestamp_observed, scope_kind, scope_id,
-            extractor_version, embedding_model_version, source_connector, source_locator,
-            source_raw_record_id, created_at
-          )
-          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-          ON CONFLICT(source_connector, source_locator, source_raw_record_id, observation_type)
-          DO UPDATE SET
-            entity_kind_hint = excluded.entity_kind_hint,
-            surface_form = excluded.surface_form,
-            normalized_form = excluded.normalized_form,
-            lang = excluded.lang,
-            script = excluded.script,
-            context_summary = excluded.context_summary,
-            related_surface_forms = excluded.related_surface_forms,
-            timestamp_observed = excluded.timestamp_observed,
-            scope_kind = excluded.scope_kind,
-            scope_id = excluded.scope_id,
-            extractor_version = excluded.extractor_version,
-            embedding_model_version = excluded.embedding_model_version,
-            source_locator = excluded.source_locator,
-            created_at = entity_observations.created_at
-        `)
-            .run(input.id, input.observation_type, input.entity_kind_hint, input.surface_form, input.normalized_form, input.lang, input.script, input.context_summary, JSON.stringify(input.related_surface_forms), input.timestamp_observed, input.scope_kind, input.scope_id, input.extractor_version, input.embedding_model_version, input.source_connector, normalizedSourceLocator, input.source_raw_record_id, createdAt);
-        const saved = adapter
-            .prepare(`
-          SELECT * FROM entity_observations
-          WHERE source_connector = ? AND source_locator = ? AND source_raw_record_id = ? AND observation_type = ?
-        `)
-            .get(input.source_connector, normalizedSourceLocator, input.source_raw_record_id, input.observation_type);
-        observations.push({
-            id: requireStringField(saved, 'id'),
-            created: !existing,
-        });
+        observations.push(saveObservation(adapter, input));
     };
     if ('transaction' in adapter && typeof adapter.transaction === 'function') {
         const txResult = adapter.transaction(() => {

package/dist/entities/types.d.ts

@@ -12,7 +12,7 @@ export declare const ENTITY_NODE_STATUSES: readonly ["active", "merged", "archiv
 export type EntityNodeStatus = (typeof ENTITY_NODE_STATUSES)[number];
 export declare const ENTITY_ALIAS_STATUSES: readonly ["active", "suppressed"];
 export type EntityAliasStatus = (typeof ENTITY_ALIAS_STATUSES)[number];
-export declare const ENTITY_OBSERVATION_TYPES: readonly ["generic", "author", "channel"];
+export declare const ENTITY_OBSERVATION_TYPES: readonly ["generic", "author", "channel", "thread"];
 export type EntityObservationType = (typeof ENTITY_OBSERVATION_TYPES)[number];
 export declare const ENTITY_CANDIDATE_KINDS: readonly ["alias_to_entity", "entity_to_entity", "cluster"];
 export type EntityCandidateKind = (typeof ENTITY_CANDIDATE_KINDS)[number];
@@ -71,6 +71,10 @@ export interface EntityObservation {
     source_connector: string;
     source_locator: string | null;
     source_raw_record_id: string;
+    workspace_context_key?: string | null;
+    channel_context_key?: string | null;
+    thread_context_key?: string | null;
+    actor_context_key?: string | null;
     created_at: number;
 }
 export interface EntityResolutionCandidate {

package/dist/entities/types.js

@@ -14,7 +14,7 @@ exports.ENTITY_MERGE_ACTION_TYPES = ['merge', 'reject', 'defer', 'split'];
 exports.ENTITY_SCOPE_KINDS = ['project', 'channel', 'user', 'global'];
 exports.ENTITY_NODE_STATUSES = ['active', 'merged', 'archived'];
 exports.ENTITY_ALIAS_STATUSES = ['active', 'suppressed'];
-exports.ENTITY_OBSERVATION_TYPES = ['generic', 'author', 'channel'];
+exports.ENTITY_OBSERVATION_TYPES = ['generic', 'author', 'channel', 'thread'];
 exports.ENTITY_CANDIDATE_KINDS = ['alias_to_entity', 'entity_to_entity', 'cluster'];
 exports.ENTITY_ACTOR_TYPES = ['system', 'user', 'agent'];
 exports.ENTITY_INGEST_RUN_STATUSES = ['running', 'complete', 'failed'];

package/dist/index.d.ts

@@ -15,10 +15,23 @@ 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 MemorySearchResultHit, 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 { appendMemoryEvent, 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 './context-compile/index.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';
@@ -72,10 +85,12 @@ 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

@@ -26,10 +26,10 @@ 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.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 = exports.canonicalizeJSON = exports.listRecentMemoryEvents = exports.appendMemoryEvent = 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.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 = exports.logLoading = exports.logInfo = exports.logError = exports.logFailed = void 0;
-exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.analyzeQueryIntent = exports.analyzeDecision = exports.generate = exports.extractTopicKeywords = void 0;
+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; } });
@@ -88,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; } });
@@ -104,7 +107,52 @@ Object.defineProperty(exports, "buildExtractionPrompt", { enumerable: true, get:
 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; } });
+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("./context-compile/index.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);
@@ -253,10 +301,12 @@ __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