@jungjaehoon/mama-core 1.6.0 → 1.8.1

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

@@ -7,7 +7,7 @@
  * @module mama-core
  * @version 1.0.0
  */
-export { generateEmbedding, generateEnhancedEmbedding, generateBatchEmbeddings, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, } from './embeddings.js';
+export { generateEmbedding, generateEnhancedEmbedding, generateBatchEmbeddings, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, EMBEDDING_PREFIX_SCHEME, type EmbeddingRole, } from './embeddings.js';
 export { EmbeddingCache } from './embedding-cache.js';
 export { getEmbeddingFromServer, getServerStatus, isServerRunning, getServerPort, DEFAULT_PORT, HOST, TIMEOUT_MS, type ServerStatus, } from './embedding-client.js';
 export { initDB, getDB, getAdapter, closeDB, insertEmbedding, vectorSearch, queryVectorSearch, insertDecisionWithEmbedding, queryDecisionGraph, querySemanticEdges, updateDecisionOutcome, getPreparedStmt, getDbPath, fts5Search, reindexEmbeddings, type DatabaseAdapter as DBManagerAdapter, type PreparedStatement, type DecisionRecord, type OutcomeData, type VectorSearchParams, type SemanticEdges, type SemanticEdgeItem, type DecisionInput, } from './db-manager.js';
@@ -16,7 +16,7 @@ export { getSessionDecisions, incrementUsageSuccess, incrementUsageFailure, getD
 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 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 { saveMemory, saveMemoryWithTrustedProvenance, promoteMemoryStatus, 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, insertMemoryEventInTransaction, listMemoryEventsForMemory, listRecentMemoryEvents, } from './memory/event-store.js';
 export { createTrustedProvenanceCapability, assertTrustedProvenanceCapability, type TrustedProvenanceCapability, type TrustedMemoryWriteOptions, } from './memory/provenance.js';
@@ -29,6 +29,8 @@ export { appendToolTrace, listToolTracesForRun } from './model-runs/tool-trace-s
 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 './provenance/source-ref.js';
 export * from './agent-situation/index.js';
 export * from './agent-graph/index.js';
 export * from './entities/types.js';

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.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;
+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.EMBEDDING_PREFIX_SCHEME = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
+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 = exports.promoteMemoryStatus = exports.saveMemoryWithTrustedProvenance = void 0;
+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 = exports.canonicalizeJSON = exports.listVisibleTwinEdgesForRefs = 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 = exports.DatabaseError = exports.ValidationError = 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; } });
@@ -38,6 +38,7 @@ 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; } });
+Object.defineProperty(exports, "EMBEDDING_PREFIX_SCHEME", { enumerable: true, get: function () { return embeddings_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");
@@ -89,6 +90,7 @@ Object.defineProperty(exports, "createEmptyRecallBundle", { enumerable: true, ge
 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, "promoteMemoryStatus", { enumerable: true, get: function () { return api_js_1.promoteMemoryStatus; } });
 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; } });
@@ -150,6 +152,8 @@ Object.defineProperty(exports, "mapTwinEdgeRow", { enumerable: true, get: functi
 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("./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);

package/dist/mama-api.js

@@ -1118,7 +1118,7 @@ async function suggest(userQuestion, options = {}) {
                 throw new Error('Vector search not available');
             }
             // Generate query embedding
-            const queryEmbedding = await (0, embeddings_js_1.generateEmbedding)(userQuestion);
+            const queryEmbedding = await (0, embeddings_js_1.generateEmbedding)(userQuestion, 'query');
             // Adaptive threshold (shorter queries need higher confidence)
             const wordCount = userQuestion.split(/\s+/).length;
             const adaptiveThreshold = threshold !== undefined ? threshold : wordCount < 3 ? 0.7 : 0.6;

package/dist/memory/api.d.ts

@@ -2,7 +2,7 @@ import { type WikiPageIndexRecord } from '../cases/wiki-page-index.js';
 import { resolveMemoryEvolution } from './evolution-engine.js';
 import { getChannelSummary, upsertChannelSummary } from './channel-summary-store.js';
 import { type SearchHitDiagnostics } from '../search/search-quality.js';
-import type { MemoryAgentBootstrap, MemoryAuditAck, MemoryEdge, MemoryRecord, MemoryScopeRef, ProfileSnapshot, PublicIngestMemoryInput, PublicSaveMemoryInput, RecallBundle, IngestConversationInput, ExtractedMemoryUnit, IngestConversationResult, RecallMemoryOptions } from './types.js';
+import type { MemoryAgentBootstrap, MemoryAuditAck, MemoryEdge, MemoryRecord, MemoryScopeRef, MemoryStatus, ProfileSnapshot, PublicIngestMemoryInput, PublicSaveMemoryInput, RecallBundle, IngestConversationInput, ExtractedMemoryUnit, IngestConversationResult, RecallMemoryOptions } from './types.js';
 import { type TrustedMemoryWriteOptions } from './provenance.js';
 type SaveMemoryInput = PublicSaveMemoryInput;
 type IngestMemoryInput = PublicIngestMemoryInput;
@@ -27,6 +27,11 @@ type SaveMemoryResult = {
 };
 export declare function saveMemory(input: SaveMemoryInput): Promise<SaveMemoryResult>;
 export declare function saveMemoryWithTrustedProvenance(input: SaveMemoryInput, options: TrustedMemoryWriteOptions): Promise<SaveMemoryResult>;
+export declare function promoteMemoryStatus(input: {
+    memoryId: string;
+    status: MemoryStatus;
+    nowMs?: number;
+}): Promise<void>;
 export declare function buildProfile(scopes: MemoryScopeRef[]): Promise<ProfileSnapshot>;
 export declare function recallMemory(query: string, options?: RecallMemoryOptions): Promise<RecallBundle>;
 export declare function ingestMemory(input: IngestMemoryInput): Promise<{