@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/embedding/embedder.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Embedding: the model, and one process-wide embedder over it.
+ *
+ * `createEmbedder` returns one embedder holding its own pipeline and cache. Two
+ * calls give two independent embedders, so a caller can run a different model
+ * without disturbing anyone else's, and a cache entry can never be served to a
+ * caller that asked a different model for it.
+ *
+ * Below that, the module-level surface the rest of the product and the plugin
+ * hooks call: `generateEmbedding`, the prefix scheme, the model facts and the
+ * cosine. That surface lived in a top-level `embeddings.ts` that did nothing
+ * but hold one embedder and re-expose it; a module that owns the model owns
+ * the way to ask it for a vector. The published `@jungjaehoon/mama-core/embeddings`
+ * subpath still points here, because it names a capability, not a file.
+ *
+ * @module embedding/embedder
+ */
+import { embeddingCache } from '../embedding-cache.js';
+import { EmbeddingCache } from '../embedding-cache.js';
+export type EmbeddingPipeline = (text: string | string[], options?: {
+    pooling?: string;
+    normalize?: boolean;
+    truncation?: boolean;
+    max_length?: number;
+}) => Promise<{
+    data: Float32Array;
+}>;
+export interface EmbedderOptions {
+    modelName: string;
+    /** Vectors this model must produce. A mismatch is a failed load, not a warning. */
+    dimension: number;
+    quantized: boolean;
+    maxLength: number;
+    /**
+     * Where the model files are cached. Optional: absent leaves it to the transformers
+     * library's own convention, which is the caller's machine to decide, not this
+     * library's.
+     */
+    cacheDir?: string;
+    /**
+     * Cache to use. Callers that share one embedder with existing consumers pass
+     * the cache those consumers already clear and read stats from; omit it and the
+     * embedder owns a private one.
+     */
+    cache?: EmbeddingCache;
+}
+export interface Embedder {
+    readonly modelName: string;
+    readonly dimension: number;
+    /** Embed one already-prefixed input. The caller owns the role prefix. */
+    embed(modelInput: string): Promise<Float32Array>;
+    /** Load the model without embedding anything, so a caller can pay that cost up front. */
+    warm(): Promise<void>;
+    cache: EmbeddingCache;
+}
+/**
+ * Build an embedder. The model loads on first use, not here.
+ *
+ * A failed load is remembered: the second call reports the original failure
+ * instead of spending another model download on the same broken configuration.
+ */
+export declare function createEmbedder(options: EmbedderOptions): Embedder;
+/**
+ * Which model, at what width, quantized or not.
+ *
+ * These used to be read from a config file under the product's home directory, which
+ * meant the core could not produce an embedding until that product existed. They are
+ * facts about the model, not about who is asking for one, so they live with the code
+ * that loads it. A caller that wants a different model passes it.
+ */
+export declare const DEFAULT_MODEL_NAME = "Xenova/multilingual-e5-large";
+/** State where this consumer keeps its model cache. Call before the first embedding. */
+export declare function declareEmbeddingCacheDir(dir: string): void;
+/** Test seam: forget what was declared. */
+export declare function clearEmbeddingCacheDir(): void;
+export declare const DEFAULT_EMBEDDING_DIM = 1024;
+export declare const DEFAULT_QUANTIZED = true;
+export declare const EMBEDDING_MODEL_MAX_LENGTH = 512;
+export declare const EMBEDDING_MAX_TOKENISH_SEGMENTS = 480;
+export type EmbeddingRole = 'passage' | 'query';
+export declare const EMBEDDING_PREFIX_SCHEME = "e5-prefixed-v1";
+export declare function isForceTier3Enabled(): boolean;
+export declare function prepareEmbeddingText(text: string): string;
+/**
+ * Decision object for enhanced embedding generation
+ */
+export interface DecisionForEmbedding {
+    topic: string;
+    decision: string;
+    reasoning?: string;
+    outcome?: string;
+    confidence?: number;
+    user_involvement?: string;
+    evidence?: string | string[] | unknown;
+    alternatives?: string | string[] | unknown;
+    risks?: string;
+}
+/**
+ * Generate embedding vector from text
+ *
+ * Story M1.4 AC #1: Uses configurable embeddingDim from config
+ * Target: < 30ms latency
+ *
+ * @param text - Input text to embed
+ * @returns Embedding vector (dimension from config)
+ * @throws Error if text is empty or embedding fails
+ */
+export declare function generateEmbedding(text: string, role?: EmbeddingRole): Promise<Float32Array>;
+/**
+ * Generate enhanced embedding with content + metadata
+ *
+ * Task 3.4: Implement enhanced embedding format
+ * Inspired by A-mem: Content + Metadata for richer semantic representation
+ *
+ * @param decision - Decision object
+ * @returns 1024-dim enhanced embedding
+ */
+export declare function generateEnhancedEmbedding(decision: DecisionForEmbedding, role?: EmbeddingRole): Promise<Float32Array>;
+/**
+ * Calculate cosine similarity between two embeddings
+ *
+ * Utility for testing and validation
+ *
+ * @param embA - First embedding
+ * @param embB - Second embedding
+ * @returns Cosine similarity (0-1)
+ */
+export declare function cosineSimilarity(embA: Float32Array, embB: Float32Array): number;
+export { embeddingCache };
+export declare const EMBEDDING_DIM = 1024;
+export declare const MODEL_NAME = "Xenova/multilingual-e5-large";
+//# sourceMappingURL=embedder.d.ts.map

package/dist/embedding/embedder.js

@@ -0,0 +1,299 @@
+"use strict";
+/**
+ * Embedding: the model, and one process-wide embedder over it.
+ *
+ * `createEmbedder` returns one embedder holding its own pipeline and cache. Two
+ * calls give two independent embedders, so a caller can run a different model
+ * without disturbing anyone else's, and a cache entry can never be served to a
+ * caller that asked a different model for it.
+ *
+ * Below that, the module-level surface the rest of the product and the plugin
+ * hooks call: `generateEmbedding`, the prefix scheme, the model facts and the
+ * cosine. That surface lived in a top-level `embeddings.ts` that did nothing
+ * but hold one embedder and re-expose it; a module that owns the model owns
+ * the way to ask it for a vector. The published `@jungjaehoon/mama-core/embeddings`
+ * subpath still points here, because it names a capability, not a file.
+ *
+ * @module embedding/embedder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.EMBEDDING_PREFIX_SCHEME = exports.EMBEDDING_MAX_TOKENISH_SEGMENTS = exports.EMBEDDING_MODEL_MAX_LENGTH = exports.DEFAULT_QUANTIZED = exports.DEFAULT_EMBEDDING_DIM = exports.DEFAULT_MODEL_NAME = void 0;
+exports.createEmbedder = createEmbedder;
+exports.declareEmbeddingCacheDir = declareEmbeddingCacheDir;
+exports.clearEmbeddingCacheDir = clearEmbeddingCacheDir;
+exports.isForceTier3Enabled = isForceTier3Enabled;
+exports.prepareEmbeddingText = prepareEmbeddingText;
+exports.generateEmbedding = generateEmbedding;
+exports.generateEnhancedEmbedding = generateEnhancedEmbedding;
+exports.cosineSimilarity = cosineSimilarity;
+const embedding_cache_js_1 = require("../embedding-cache.js");
+Object.defineProperty(exports, "embeddingCache", { enumerable: true, get: function () { return embedding_cache_js_1.embeddingCache; } });
+const embedding_cache_js_2 = require("../embedding-cache.js");
+const debug_logger_js_1 = require("../debug-logger.js");
+const progress_indicator_js_1 = require("../progress-indicator.js");
+/**
+ * Build an embedder. The model loads on first use, not here.
+ *
+ * A failed load is remembered: the second call reports the original failure
+ * instead of spending another model download on the same broken configuration.
+ */
+function createEmbedder(options) {
+    const cache = options.cache ?? new embedding_cache_js_2.EmbeddingCache();
+    let pipeline = null;
+    let loadFailure = null;
+    async function load() {
+        if (pipeline) {
+            return pipeline;
+        }
+        if (loadFailure) {
+            throw loadFailure;
+        }
+        (0, progress_indicator_js_1.logLoading)(`Loading embedding model: ${options.modelName}...`);
+        const startedAt = Date.now();
+        try {
+            // Dynamic import keeps the ES-module-only package out of the CommonJS graph.
+            const { pipeline: createPipeline, env } = await import('@huggingface/transformers');
+            if (options.cacheDir) {
+                env.cacheDir = options.cacheDir;
+                (0, debug_logger_js_1.info)(`[embedder] Model cache directory: ${options.cacheDir}`);
+            }
+            pipeline = (await createPipeline('feature-extraction', options.modelName, {
+                dtype: options.quantized ? 'q8' : 'fp32',
+            }));
+            (0, progress_indicator_js_1.logComplete)(`Embedding model ready (${Date.now() - startedAt}ms, ${options.dimension}-dim, ${options.quantized ? 'q8' : 'fp32'})`);
+            return pipeline;
+        }
+        catch (error) {
+            loadFailure = error instanceof Error ? error : new Error(String(error));
+            throw loadFailure;
+        }
+    }
+    return {
+        modelName: options.modelName,
+        dimension: options.dimension,
+        cache,
+        async warm() {
+            await load();
+        },
+        async embed(modelInput) {
+            const cached = cache.get(modelInput);
+            if (cached) {
+                return cached;
+            }
+            const model = await load();
+            const output = await model(modelInput, {
+                pooling: 'mean',
+                normalize: true,
+                truncation: true,
+                max_length: options.maxLength,
+            });
+            const vector = output.data;
+            if (vector.length !== options.dimension) {
+                throw new Error(`Expected ${options.dimension}-dim, got ${vector.length}-dim`);
+            }
+            cache.set(modelInput, vector);
+            return vector;
+        },
+    };
+}
+// Shared cache directory (not in node_modules)
+/**
+ * Which model, at what width, quantized or not.
+ *
+ * These used to be read from a config file under the product's home directory, which
+ * meant the core could not produce an embedding until that product existed. They are
+ * facts about the model, not about who is asking for one, so they live with the code
+ * that loads it. A caller that wants a different model passes it.
+ */
+exports.DEFAULT_MODEL_NAME = 'Xenova/multilingual-e5-large';
+/**
+ * Where the shared embedder caches its model files.
+ *
+ * The core used to compute one under the user's home directory and call it "the
+ * library's convention". It is not: `@huggingface/transformers@3.8.1` caches under its
+ * own package directory (`src/env.js:96`). So the old value was this library choosing
+ * a location on one machine, for consumers that never asked - and dropping it outright
+ * would move a 560MB model into `node_modules` and re-download it on the next run.
+ *
+ * A consumer states its own, once, before anything embeds. Nothing declared and no
+ * `HF_HOME`/`TRANSFORMERS_CACHE` set leaves the library to its own default.
+ */
+let declaredCacheDir;
+/** State where this consumer keeps its model cache. Call before the first embedding. */
+function declareEmbeddingCacheDir(dir) {
+    declaredCacheDir = dir;
+}
+/** Test seam: forget what was declared. */
+function clearEmbeddingCacheDir() {
+    declaredCacheDir = undefined;
+}
+exports.DEFAULT_EMBEDDING_DIM = 1024;
+exports.DEFAULT_QUANTIZED = true;
+const TIER3_ENV_VALUES = new Set(['1', 'true', 'yes']);
+exports.EMBEDDING_MODEL_MAX_LENGTH = 512;
+exports.EMBEDDING_MAX_TOKENISH_SEGMENTS = 480;
+exports.EMBEDDING_PREFIX_SCHEME = 'e5-prefixed-v1';
+function applyRolePrefix(preparedText, role) {
+    return `${role}: ${preparedText}`;
+}
+const TOKENISH_SEGMENT_PATTERN = /[\p{Script=Hangul}\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}]|\S+/gu;
+// Type for pipeline function from @huggingface/transformers
+// One process-wide embedder for callers that have not been given one of their
+// own. `createEmbedder` owns the pipeline and its cache; this module only holds
+// the instance and rebuilds it when the configured model changes.
+let embedder = null;
+function isForceTier3Enabled() {
+    return TIER3_ENV_VALUES.has(String(process.env.MAMA_FORCE_TIER_3 || '').toLowerCase());
+}
+function assertEmbeddingsEnabled() {
+    if (isForceTier3Enabled()) {
+        throw new Error('Embedding generation disabled because MAMA_FORCE_TIER_3=true. ' +
+            'Tier 3 test mode must use lexical/no-vector fallback instead of loading the embedding model.');
+    }
+}
+function prepareEmbeddingText(text) {
+    const trimmed = text.trim();
+    let count = 0;
+    let cutIndex = trimmed.length;
+    for (const match of trimmed.matchAll(TOKENISH_SEGMENT_PATTERN)) {
+        count++;
+        if (count > exports.EMBEDDING_MAX_TOKENISH_SEGMENTS) {
+            cutIndex = match.index ?? trimmed.length;
+            break;
+        }
+    }
+    return cutIndex === trimmed.length ? trimmed : trimmed.slice(0, cutIndex).trimEnd();
+}
+/**
+ * Load embedding model (configurable)
+ *
+ * Story M1.4 AC #2: Transformers.js singleton initialization
+ * Story M1.4 AC #3: Changing model via config triggers informative log + resets caches
+ *
+ * @returns Embedding pipeline
+ */
+function resolveEmbedder() {
+    assertEmbeddingsEnabled();
+    const modelName = exports.DEFAULT_MODEL_NAME;
+    // Story M1.4 AC #3: a configured model change resets the pipeline and cache.
+    if (embedder && embedder.modelName !== modelName) {
+        (0, debug_logger_js_1.info)('[MAMA] Embedding model changed - resetting pipeline');
+        (0, debug_logger_js_1.info)(`[MAMA] Old model: ${embedder.modelName}`);
+        (0, debug_logger_js_1.info)(`[MAMA] New model: ${modelName}`);
+        embedding_cache_js_1.embeddingCache.clear();
+        embedder = null;
+        (0, debug_logger_js_1.info)('[MAMA] Model cache cleared');
+    }
+    if (!embedder) {
+        embedder = createEmbedder({
+            modelName,
+            dimension: exports.DEFAULT_EMBEDDING_DIM,
+            quantized: exports.DEFAULT_QUANTIZED,
+            maxLength: exports.EMBEDDING_MODEL_MAX_LENGTH,
+            // The environment a user set, else what this consumer declared, else the
+            // library's own default. The core names no directory of its own.
+            cacheDir: process.env.HF_HOME || process.env.TRANSFORMERS_CACHE || declaredCacheDir,
+            // The shared cache: consumers already clear it and read its stats.
+            cache: embedding_cache_js_1.embeddingCache,
+        });
+    }
+    return embedder;
+}
+/**
+ * Generate embedding vector from text
+ *
+ * Story M1.4 AC #1: Uses configurable embeddingDim from config
+ * Target: < 30ms latency
+ *
+ * @param text - Input text to embed
+ * @returns Embedding vector (dimension from config)
+ * @throws Error if text is empty or embedding fails
+ */
+async function generateEmbedding(text, role = 'passage') {
+    if (typeof text !== 'string' || text.trim().length === 0) {
+        throw new Error('Text cannot be empty');
+    }
+    assertEmbeddingsEnabled();
+    const preparedText = prepareEmbeddingText(text);
+    const modelInput = applyRolePrefix(preparedText, role); // e5 instruction prefix
+    // The embedder keys its cache on the PREFIXED input, so a passage vector can
+    // never be served to a query.
+    try {
+        return await resolveEmbedder().embed(modelInput);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to generate embedding: ${message}`);
+    }
+}
+/**
+ * Generate enhanced embedding with content + metadata
+ *
+ * Task 3.4: Implement enhanced embedding format
+ * Inspired by A-mem: Content + Metadata for richer semantic representation
+ *
+ * @param decision - Decision object
+ * @returns 1024-dim enhanced embedding
+ */
+async function generateEnhancedEmbedding(decision, role = 'passage') {
+    // Construct enriched text representation with narrative fields (Story 2.2)
+    const parts = [
+        `Topic: ${decision.topic}`,
+        `Decision: ${decision.decision}`,
+        `Reasoning: ${decision.reasoning || 'N/A'}`,
+        `Outcome: ${decision.outcome || 'ONGOING'}`,
+        `Confidence: ${decision.confidence !== undefined ? decision.confidence : 0.5}`,
+        `User Involvement: ${decision.user_involvement || 'N/A'}`,
+    ];
+    // Add narrative fields if present (Story 2.2: Narrative-Based Search)
+    if (decision.evidence) {
+        const evidenceText = Array.isArray(decision.evidence)
+            ? decision.evidence.join('; ')
+            : typeof decision.evidence === 'string'
+                ? decision.evidence
+                : JSON.stringify(decision.evidence);
+        parts.push(`Evidence: ${evidenceText}`);
+    }
+    if (decision.alternatives) {
+        const alternativesText = Array.isArray(decision.alternatives)
+            ? decision.alternatives.join('; ')
+            : typeof decision.alternatives === 'string'
+                ? decision.alternatives
+                : JSON.stringify(decision.alternatives);
+        parts.push(`Alternatives: ${alternativesText}`);
+    }
+    if (decision.risks) {
+        parts.push(`Risks: ${decision.risks}`);
+    }
+    const enrichedText = parts.join('\n').trim();
+    return generateEmbedding(enrichedText, role);
+}
+/**
+ * Calculate cosine similarity between two embeddings
+ *
+ * Utility for testing and validation
+ *
+ * @param embA - First embedding
+ * @param embB - Second embedding
+ * @returns Cosine similarity (0-1)
+ */
+function cosineSimilarity(embA, embB) {
+    if (embA.length !== embB.length) {
+        throw new Error('Embeddings must have same dimension');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < embA.length; i++) {
+        dotProduct += embA[i] * embB[i];
+        normA += embA[i] * embA[i];
+        normB += embB[i] * embB[i];
+    }
+    const similarity = dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+    return similarity;
+}
+// Static snapshots of config values at module load time (Story M1.4)
+exports.EMBEDDING_DIM = exports.DEFAULT_EMBEDDING_DIM;
+exports.MODEL_NAME = exports.DEFAULT_MODEL_NAME;
+// Expose config functions for external use
+//# sourceMappingURL=embedder.js.map

package/dist/identity/principal-repository.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseAdapter as DBManagerAdapter } from '../db-manager.js';
+import type { DatabaseAdapter } from '../db-manager.js';
 export interface PrincipalRow {
     principalId: string;
     kind: 'owner' | 'member';
@@ -64,5 +64,5 @@ export declare class PrincipalScopeGrantError extends Error {
     readonly code: PrincipalScopeGrantErrorCode;
     constructor(code: PrincipalScopeGrantErrorCode, message: string);
 }
-export declare function createPrincipalRepository(adapter: Pick<DBManagerAdapter, 'prepare' | 'transaction'>): PrincipalRepository;
+export declare function createPrincipalRepository(adapter: Pick<DatabaseAdapter, 'prepare' | 'transaction'>): PrincipalRepository;
 //# sourceMappingURL=principal-repository.d.ts.map

package/dist/index.d.ts

@@ -2,83 +2,68 @@
  * 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
  */
-export { generateEmbedding, generateEnhancedEmbedding, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, EMBEDDING_PREFIX_SCHEME, type EmbeddingRole, } from './embeddings.js';
+export { generateEmbedding, generateEnhancedEmbedding, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, EMBEDDING_PREFIX_SCHEME, type EmbeddingRole, } from './embedding/embedder.js';
 export { EmbeddingCache } from './embedding-cache.js';
-export { 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, type DatabaseAdapter as DBManagerAdapter, type PreparedStatement, type DecisionRecord, type OutcomeData, type VectorSearchParams, type SemanticEdges, type SemanticEdgeItem, type DecisionInput, } from './db-manager.js';
-export { createAdapter, DatabaseAdapter, SQLiteAdapter, type AdapterConfig, type Statement, type VectorSearchResult, type RunResult, } from './db-adapter/index.js';
-export { traverseDecisionChain, DB_PATH, DB_DIR, LEGACY_DB_PATH, DEFAULT_DB_PATH, } from './memory-store.js';
+export { initDB, getDB, getAdapter, closeDB, updateDecisionOutcome, getDbPath, type DatabaseAdapter, type DatabaseInstance, type PreparedStatement, type DecisionRecord, type OutcomeData, type SemanticEdges, type SemanticEdgeItem, type DecisionInput, } from './db-manager.js';
+export { createAdapter, SQLiteAdapter, type AdapterConfig, type Statement, type VectorSearchResult, type RunResult, } from './db-adapter/index.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 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, type AuditFindingRecord, } from './memory/types.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 { createMamaApi, type MamaApi } from './mama-api.js';
+export { MEMORY_SCOPE_KINDS, MEMORY_KINDS, MEMORY_STATUSES, MEMORY_EDGE_TYPES, createEmptyRecallBundle, type MemoryScopeKind, type MemoryKind, type MemoryKindFilter, 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, type AuditFindingRecord, canonicalizeContextScopes, } from './memory/types.js';
+export { saveMemory, saveJudgmentRecord, saveLegacyMemory, promoteMemoryStatus, readMemoryRecordById, readMemoryRecordsInScopes, retireMemoryRecord, recallMemory, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, ingestConversation, upsertChannelSummary, getChannelSummary, type MemoryRetirementStatus, type ReadMemoryRecordsOptions, } from './memory/api.js';
+export { createKnowledge, appendJudgment, ingestSource, JudgmentError, type Knowledge, type KnowledgeOptions, type JudgmentAccess, type SourceIngestCommand, type SourceIngestReceipt, type WorkGraphPage, type WorkGraphQuery, type WorkReference, } from './knowledge/index.js';
 export { queryRelevantTruth } from './memory/truth-store.js';
 export { createAuditFinding, listOpenAuditFindings } from './memory/finding-store.js';
 export { appendMemoryEvent, insertMemoryEventInTransaction, listMemoryEventsForMemory, listRecentMemoryEvents, } from './memory/event-store.js';
-export { createTrustedProvenanceCapability, assertTrustedProvenanceCapability, type TrustedProvenanceCapability, type TrustedMemoryWriteOptions, } from './memory/provenance.js';
+export { normalizeMemoryWriteProvenance, type NormalizedMemoryProvenance, } from './memory/provenance.js';
 export { getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, } from './memory/provenance-query.js';
-export { 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, type ToolTraceScope, type ListToolTracesInput, type ToolTracePage, } from './model-runs/types.js';
-export { beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, } from './model-runs/store.js';
-export { appendToolTrace, listToolTracesForRun, listToolTraces, readToolTrace, } 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, listTwinEdgesForRefs, mapTwinEdgeRow } from './edges/store.js';
-export { listVisibleTwinEdgesForRefs } from './edges/ref-validation.js';
-export * from './context-compile/index.js';
+export { OBSERVATION_COLUMNS, isEventVisibleNow, isMessageRefVisible, parseSourceRef, resolveMemoryProvenanceLive, toIndexedEvent, type EventRow, type LiveProvenanceOptions, } from './memory/provenance-live.js';
+export { resolveMemoryProvenance, type IndexedEvent, type ParsedSourceRef, type ProvenanceResolution, type ProvenanceResolverDeps, type ProvenanceSubjectRecord, type RecordedSupport, type ResolutionFailure, type ResolvedEvent, type UnresolvedSupport, } from './memory/provenance-resolver.js';
+export { sanitizeRecallBundle, sanitizeRecallText, type SafeRecallBundle, type SafeRecallMemory, } from './memory/recall-sanitize.js';
+export { scanForSecrets, scanMemoryWriteInput, type SecretScanResult, } from './memory/secret-filter.js';
+export { MODEL_RUN_STATUSES, type ModelRunStatus, type BeginModelRunInput, type ModelRunRecord, type AppendToolTraceInput, type AppendOperationToolTraceInput, type ToolTraceRecord, type ToolTraceScope, type ListToolTracesInput, type ToolTracePage, } from './runtime/model-run-types.js';
+export { beginModelRun, commitModelRun, failModelRun, getModelRun, } from './runtime/model-run-store.js';
+export { appendToolTrace, appendOperationToolTrace, listToolTracesForRun, listToolTraces, readToolTrace, } from './runtime/tool-trace-store.js';
+export { TWIN_EDGE_SOURCES, TWIN_EDGE_TYPES, TWIN_REF_KINDS, type InsertTwinEdgeInput, type ListVisibleTwinEdgesOptions, type TwinEdgeInsert, type TwinEdgeRecord, type TwinEdgeSource, type TwinEdgeType, type TwinRef, type TwinRefKind, type TwinScopeRef, } from './knowledge/twin-edge-types.js';
+export { getTwinEdge, insertTwinEdge, listTwinEdgesForRefs, mapTwinEdgeRow, } from './knowledge/judgments.js';
+export { listVisibleTwinEdgesForRefs } from './knowledge/access.js';
+export type { ActionCall, ActionContract, ActionExample, ActionFailure, ActionFailureKind, ActionResult, ActionSchemaObject, ActionSessionFacts, } from './action-contracts.js';
+export { createCatalog, coreActionRegistrations, UnknownActionError, type ActionCatalog, type ActionContext, type ActionExec, type ActionRegistration, type MemoryReadAllowance, } from './api/catalog.js';
+export { createDispatcher, validateInput, withCallReceipt, type ActionDispatcher, type DispatcherOptions, } from './api/dispatch.js';
+export { createClient, type Client, type ClientCall, type ClientOptions } from './client/client.js';
+export { startRuntime, type RuntimeHandle, type RuntimePaths, type StartRuntimeOptions, } from './runtime/runtime.js';
+export { createActionIpcServer, encodeFrame, IpcTransportError, newRequestId, sendIpcRequest, IPC_MAX_FRAME_BYTES, type ActionIpcServer, type ActionIpcServerOptions, type IpcRequest, type IpcResponse, } from './client/ipc.js';
 export * from './provenance/source-ref.js';
-export * from './agent-situation/index.js';
-export * from './agent-graph/index.js';
-export * from './entities/types.js';
-export * from './entities/errors.js';
-export * from './entities/store.js';
-export * from './entities/normalization.js';
-export * from './entities/projection.js';
-export * from './entities/recall-bridge.js';
-export * from './entities/read-identity.js';
-export * from './entities/audit-metrics.js';
-export * from './entities/provenance-query.js';
-export * from './entities/lineage-store.js';
-export * from './entities/entity-search.js';
-export * from './entities/entity-list.js';
-export * from './entities/entity-orphan-list.js';
-export * from './entities/rollback-preview.js';
-export * from './entities/source-locator.js';
-export * from './entities/policy-types.js';
-export * from './entities/policy-store.js';
+export * from './knowledge/case-errors.js';
+export * from './knowledge/graph-query.js';
 export { canonicalizeJSON, targetRefHash, CanonicalizeError, type CanonicalizeErrorCode, } from './canonicalize.js';
-export { loadConfig, getModelName, getEmbeddingDim, getCacheDir, updateConfig, getConfigPath, DEFAULT_CONFIG, type MAMAConfig, type ConfigUpdates, } from './config-loader.js';
 export { calculateRelevance, selectTopDecisions, formatTopNContext, type DecisionWithEmbedding, type QueryContext, type FormattedContext, type TestResult, } from './relevance-scorer.js';
-export { learnDecision, generateDecisionId, getPreviousDecision, createEdge, createSupersedesEdge, markSuperseded, calculateCombinedConfidence, detectRefinement, parseReasoningForRelationships, createEdgesFromReasoning, updateConfidence, VALID_EDGE_TYPES, type EdgeType, type DecisionDetection, type ToolExecution, type SessionContext, type LearnDecisionResult, type ParsedRelationship, type EvidenceItem, } from './decision-tracker.js';
-export { checkNodeVersion, checkSQLite, checkEmbeddings, checkDatabase, getTierDescription, type TierValidation, type CheckResult, type NamedCheckResult, } from './tier-validator.js';
 export { logProgress, logComplete, logFailed, logError, logLoading, logSearching, } from './progress-indicator.js';
 export { debug, info, warn, error, DebugLogger } from './debug-logger.js';
-export { formatTimeAgo } from './time-formatter.js';
 export { MAMAError, NotFoundError, ValidationError, DatabaseError, EmbeddingError, ConfigurationError, LinkError, RateLimitError, TimeoutError, ErrorCodes, wrapError, isMAMAError, type ErrorDetails, type ErrorResponse, type ErrorJSON, type ErrorCode, } from './errors.js';
 export { formatContext, formatLegacyContext, formatRecall, formatList, formatTrustContext, ensureTokenBudget, estimateTokens, extractQuickAnswer, extractCodeExample, type DecisionForFormat, type TrustContext, type SemanticEdges as FormatterSemanticEdges, type FormatOptions, } from './decision-formatter.js';
-export { analyzeOutcome, matchesFailureIndicators, matchesSuccessIndicators, matchesPartialIndicators, extractFailureReason, getRecentDecision, calculateDurationDays, getEvidenceImpact, markOutcome, FAILURE_INDICATORS, SUCCESS_INDICATORS, PARTIAL_INDICATORS, RECENT_WINDOW_MS, type HookContext, type OutcomeType, } from './outcome-tracker.js';
-export { analyzeIntent, type IntentResult, type AnalyzeOptions } from './query-intent.js';
 export { generate, isAvailable, listModels, DEFAULT_MODEL, FALLBACK_MODEL, type GenerateOptions, type DecisionAnalysisResult, type QueryIntentResult, } from './ollama-client.js';
-export { notifyInsight } from './notification-manager.js';
-export * from './cases/types.js';
-export * from './cases/store.js';
-export * from './cases/search-rollup.js';
-export * from './cases/timeline-range.js';
-export * from './cases/wiki-page-index.js';
-export * from './connectors/event-index.js';
-export * from './connectors/raw-query.js';
-export * from './connectors/types.js';
+export type { TextCompletion, TextCompletionOptions } from './runtime/text-completion.js';
+export * from './knowledge/case-types.js';
+export * from './knowledge/case-store.js';
+export * from './knowledge/case-search-rollup.js';
+export * from './knowledge/case-timeline-range.js';
+export * from './knowledge/observations.js';
 export * from './identity/principal-repository.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';
+export * from './knowledge/question-type.js';
+export * from './knowledge/feedback-store.js';
+export * from './knowledge/ranker-features.js';
+export * from './knowledge/ranker-trainer.js';
+export * from './knowledge/ranker-rescore.js';
+export * from './knowledge/search-quality.js';
+export * from './registry/store.js';
+export * from './registry/record-identity.js';
+export * from './registry/corrections.js';
+export * from './registry/types.js';
+export * from './operations/owner-action-effects.js';
 //# sourceMappingURL=index.d.ts.map