ai-memory-layer 2.0.0

package/dist/adapters/sync-to-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-to-async.d.ts","sourceRoot":"","sources":["../../src/adapters/sync-to-async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIzE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,CAwH5E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI,CAIxF"}

package/dist/adapters/sync-to-async.js

@@ -0,0 +1,95 @@
+const NATIVE_SYNC_ADAPTER = Symbol('nativeSyncAdapter');
+/**
+ * Wraps a synchronous `StorageAdapter` into an `AsyncStorageAdapter`.
+ * Every method call is wrapped in `Promise.resolve()` so sync adapters
+ * (SQLite, in-memory) can be used in async-first codepaths without changes.
+ *
+ * The wrapper itself does not provide rollback semantics for arbitrary async
+ * functions. Higher-level workflows that need true sync transactions can
+ * detect the native adapter through `getNativeSyncAdapter()` and execute the
+ * full write sequence inside `adapter.transaction(...)`.
+ */
+export function wrapSyncAdapter(adapter) {
+    const wrapped = {
+        insertTurn: (input) => Promise.resolve(adapter.insertTurn(input)),
+        insertTurns: (inputs) => Promise.resolve(adapter.insertTurns(inputs)),
+        getTurnById: (id) => Promise.resolve(adapter.getTurnById(id)),
+        getActiveTurns: (scope, sessionId) => Promise.resolve(adapter.getActiveTurns(scope, sessionId)),
+        getActiveTurnsPaginated: (scope, options) => Promise.resolve(adapter.getActiveTurnsPaginated(scope, options)),
+        getTurnsByTimeRange: (scope, range) => Promise.resolve(adapter.getTurnsByTimeRange(scope, range)),
+        searchTurns: (scope, query, options) => Promise.resolve(adapter.searchTurns(scope, query, options)),
+        archiveTurn: (id, archivedAt, compactionLogId) => Promise.resolve(adapter.archiveTurn(id, archivedAt, compactionLogId)),
+        getArchivedTurnRange: (sessionId, startId, endId, scope) => Promise.resolve(adapter.getArchivedTurnRange(sessionId, startId, endId, scope)),
+        insertWorkingMemory: (input) => Promise.resolve(adapter.insertWorkingMemory(input)),
+        getWorkingMemoryById: (id) => Promise.resolve(adapter.getWorkingMemoryById(id)),
+        getWorkingMemoryBySession: (sessionId, scope) => Promise.resolve(adapter.getWorkingMemoryBySession(sessionId, scope)),
+        getActiveWorkingMemory: (scope, sessionId) => Promise.resolve(adapter.getActiveWorkingMemory(scope, sessionId)),
+        getLatestWorkingMemory: (scope, sessionId) => Promise.resolve(adapter.getLatestWorkingMemory(scope, sessionId)),
+        getWorkingMemoryByTimeRange: (scope, range) => Promise.resolve(adapter.getWorkingMemoryByTimeRange(scope, range)),
+        expireWorkingMemory: (id) => Promise.resolve(adapter.expireWorkingMemory(id)),
+        markWorkingMemoryPromoted: (id, knowledgeMemoryId) => Promise.resolve(adapter.markWorkingMemoryPromoted(id, knowledgeMemoryId)),
+        insertKnowledgeMemory: (input) => Promise.resolve(adapter.insertKnowledgeMemory(input)),
+        insertKnowledgeMemories: (inputs) => Promise.resolve(adapter.insertKnowledgeMemories(inputs)),
+        insertKnowledgeCandidate: (input) => Promise.resolve(adapter.insertKnowledgeCandidate(input)),
+        insertKnowledgeCandidates: (inputs) => Promise.resolve(adapter.insertKnowledgeCandidates(inputs)),
+        getKnowledgeCandidateById: (id) => Promise.resolve(adapter.getKnowledgeCandidateById(id)),
+        listKnowledgeCandidates: (scope, options) => Promise.resolve(adapter.listKnowledgeCandidates(scope, options)),
+        insertKnowledgeEvidence: (input) => Promise.resolve(adapter.insertKnowledgeEvidence(input)),
+        insertKnowledgeEvidenceBatch: (inputs) => Promise.resolve(adapter.insertKnowledgeEvidenceBatch(inputs)),
+        listKnowledgeEvidenceForKnowledge: (knowledgeId) => Promise.resolve(adapter.listKnowledgeEvidenceForKnowledge(knowledgeId)),
+        listKnowledgeEvidenceForCandidate: (candidateId) => Promise.resolve(adapter.listKnowledgeEvidenceForCandidate(candidateId)),
+        promoteKnowledgeCandidate: (candidateId, input) => Promise.resolve(adapter.promoteKnowledgeCandidate(candidateId, input)),
+        getKnowledgeMemoryById: (id) => Promise.resolve(adapter.getKnowledgeMemoryById(id)),
+        getActiveKnowledgeMemory: (scope) => Promise.resolve(adapter.getActiveKnowledgeMemory(scope)),
+        getActiveKnowledgeMemoryPaginated: (scope, options) => Promise.resolve(adapter.getActiveKnowledgeMemoryPaginated(scope, options)),
+        getActiveKnowledgeCrossScope: (scope, level) => Promise.resolve(adapter.getActiveKnowledgeCrossScope(scope, level)),
+        getKnowledgeSince: (scope, level, since) => Promise.resolve(adapter.getKnowledgeSince(scope, level, since)),
+        getKnowledgeByTimeRange: (scope, range) => Promise.resolve(adapter.getKnowledgeByTimeRange(scope, range)),
+        searchKnowledge: (scope, query, options) => Promise.resolve(adapter.searchKnowledge(scope, query, options)),
+        searchKnowledgeCrossScope: (scope, level, query, options) => Promise.resolve(adapter.searchKnowledgeCrossScope(scope, level, query, options)),
+        insertKnowledgeMemoryAudit: (input) => Promise.resolve(adapter.insertKnowledgeMemoryAudit(input)),
+        getRecentKnowledgeMemoryAudits: (scope, limit) => Promise.resolve(adapter.getRecentKnowledgeMemoryAudits(scope, limit)),
+        getKnowledgeMemoryAuditsForKnowledge: (scope, knowledgeId, limit) => Promise.resolve(adapter.getKnowledgeMemoryAuditsForKnowledge(scope, knowledgeId, limit)),
+        updateKnowledgeMemory: (id, patch) => Promise.resolve(adapter.updateKnowledgeMemory(id, patch)),
+        touchKnowledgeMemory: (id) => Promise.resolve(adapter.touchKnowledgeMemory(id)),
+        retireKnowledgeMemory: (id, retiredAt) => Promise.resolve(adapter.retireKnowledgeMemory(id, retiredAt)),
+        supersedeKnowledgeMemory: (oldId, newId) => Promise.resolve(adapter.supersedeKnowledgeMemory(oldId, newId)),
+        insertWorkItem: (input) => Promise.resolve(adapter.insertWorkItem(input)),
+        getActiveWorkItems: (scope) => Promise.resolve(adapter.getActiveWorkItems(scope)),
+        getWorkItemsByTimeRange: (scope, range) => Promise.resolve(adapter.getWorkItemsByTimeRange(scope, range)),
+        updateWorkItemStatus: (id, status) => Promise.resolve(adapter.updateWorkItemStatus(id, status)),
+        deleteWorkItem: (id) => Promise.resolve(adapter.deleteWorkItem(id)),
+        upsertContextMonitor: (input) => Promise.resolve(adapter.upsertContextMonitor(input)),
+        getContextMonitor: (scope) => Promise.resolve(adapter.getContextMonitor(scope)),
+        insertCompactionLog: (input) => Promise.resolve(adapter.insertCompactionLog(input)),
+        getCompactionLogById: (id) => Promise.resolve(adapter.getCompactionLogById(id)),
+        getRecentCompactionLogs: (scope, limit) => Promise.resolve(adapter.getRecentCompactionLogs(scope, limit)),
+        async transaction(fn) {
+            // Since all underlying operations are synchronous and JavaScript is
+            // single-threaded, the await chains in fn() resolve as microtasks
+            // within the same event-loop tick. No external I/O or user code can
+            // interleave, providing effective atomicity.
+            //
+            // Note: this does NOT provide rollback semantics. If fn() rejects
+            // after some operations have completed, those operations will have
+            // already been applied to the sync adapter. For true transactional
+            // rollback with a sync adapter, use the adapter's own transaction()
+            // method directly.
+            return fn();
+        },
+        async close() {
+            adapter.close();
+        },
+    };
+    Object.defineProperty(wrapped, NATIVE_SYNC_ADAPTER, {
+        value: adapter,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return wrapped;
+}
+export function getNativeSyncAdapter(adapter) {
+    return adapter[NATIVE_SYNC_ADAPTER] ?? null;
+}
+//# sourceMappingURL=sync-to-async.js.map

package/dist/adapters/sync-to-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-to-async.js","sourceRoot":"","sources":["../../src/adapters/sync-to-async.ts"],"names":[],"mappings":"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"}

package/dist/cli/inspect.d.ts

@@ -0,0 +1,34 @@
+import { type CreateMemoryOptions } from '../core/quick.js';
+import type { ScopeLevel } from '../contracts/identity.js';
+import type { CompactionLog, ContextMonitor, KnowledgeEvidence, KnowledgeMemory, KnowledgeMemoryAudit, PaginatedResult } from '../contracts/types.js';
+export interface InspectCliOptions {
+    dbPath?: string;
+    databaseUrl?: string;
+    scope?: string;
+    tenantId?: string;
+    systemId?: string;
+    workspaceId?: string;
+    collaborationId?: string;
+    scopeId?: string;
+    qualityMode?: CreateMemoryOptions['qualityMode'];
+    qualityTier?: CreateMemoryOptions['qualityTier'];
+    crossScopeLevel?: ScopeLevel;
+    limit?: number;
+    cursor?: number;
+    id?: number;
+    knowledgeId?: number;
+    since?: string;
+    run?: boolean;
+}
+export declare function renderKnowledgeList(result: PaginatedResult<KnowledgeMemory>): string;
+export declare function renderKnowledgeDetail(detail: {
+    knowledge: KnowledgeMemory | null;
+    evidence: KnowledgeEvidence[];
+    audits: KnowledgeMemoryAudit[];
+}): string;
+export declare function renderAudits(audits: KnowledgeMemoryAudit[]): string;
+export declare function renderMonitor(monitor: ContextMonitor | null): string;
+export declare function renderCompactionLogs(logs: CompactionLog[]): string;
+export declare function renderDueReverification(items: KnowledgeMemory[]): string;
+export declare function runInspectCommand(target: 'knowledge' | 'audits' | 'monitor' | 'compactions' | 'reverification' | 'changes', options: InspectCliOptions): Promise<string>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/cli/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAoED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,GAAG,MAAM,CAcpF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC,GAAG,MAAM,CA8BT;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAYnE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,CAYpE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,CAWlE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAWxE;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,gBAAgB,GAAG,SAAS,EACzF,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAmDjB"}

package/dist/cli/inspect.js

@@ -0,0 +1,190 @@
+import { createMemoryWithAsyncAdapter, } from '../core/quick.js';
+import { createSQLiteAdapterWithEmbeddings } from '../adapters/sqlite/index.js';
+import { wrapSyncAdapter } from '../adapters/sync-to-async.js';
+function resolveScope(options) {
+    if (options.tenantId && options.systemId && options.scopeId) {
+        return {
+            tenant_id: options.tenantId,
+            system_id: options.systemId,
+            workspace_id: options.workspaceId,
+            collaboration_id: options.collaborationId,
+            scope_id: options.scopeId,
+        };
+    }
+    return options.scope ?? 'default';
+}
+async function createInspectionManager(options) {
+    const scope = resolveScope(options);
+    const baseOptions = {
+        adapter: 'sqlite',
+        path: options.dbPath ?? ':memory:',
+        scope,
+        qualityMode: options.qualityMode,
+        qualityTier: options.qualityTier,
+        crossScopeLevel: options.crossScopeLevel,
+    };
+    if (options.databaseUrl) {
+        const moduleName = 'pg';
+        const pgModule = await import(moduleName).catch(() => {
+            throw new Error('memory-layer inspect: Postgres mode requires the "pg" package. Install it with: npm install pg');
+        });
+        const { createPostgresAdapter } = await import('../adapters/postgres/index.js');
+        const Pool = pgModule.Pool ?? pgModule.default?.Pool;
+        const pool = new Pool({ connectionString: options.databaseUrl });
+        return createMemoryWithAsyncAdapter({
+            ...baseOptions,
+            asyncAdapter: createPostgresAdapter(pool),
+        });
+    }
+    const sqlite = createSQLiteAdapterWithEmbeddings(options.dbPath ?? ':memory:');
+    return createMemoryWithAsyncAdapter({
+        ...baseOptions,
+        asyncAdapter: wrapSyncAdapter(sqlite),
+        embeddingAdapter: sqlite.embeddings,
+    });
+}
+function formatValue(value) {
+    if (value == null)
+        return '-';
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? String(value) : value.toFixed(2);
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    return String(value);
+}
+function formatTable(headers, rows) {
+    if (rows.length === 0) {
+        return '(none)';
+    }
+    const stringRows = rows.map((row) => row.map((value) => formatValue(value)));
+    const widths = headers.map((header, index) => Math.max(header.length, ...stringRows.map((row) => row[index]?.length ?? 0)));
+    const line = widths.map((width) => '-'.repeat(width)).join('-+-');
+    const renderRow = (row) => row.map((value, index) => value.padEnd(widths[index])).join(' | ');
+    return [renderRow(headers), line, ...stringRows.map(renderRow)].join('\n');
+}
+export function renderKnowledgeList(result) {
+    const table = formatTable(['ID', 'Type', 'State', 'Trust', 'Next Reverify', 'Fact'], result.items.map((item) => [
+        item.id,
+        item.fact_type,
+        item.knowledge_state,
+        item.trust_score,
+        item.next_reverification_at,
+        item.fact,
+    ]));
+    const footer = `hasMore=${result.hasMore} nextCursor=${result.nextCursor ?? '-'}`;
+    return `${table}\n${footer}`;
+}
+export function renderKnowledgeDetail(detail) {
+    if (!detail.knowledge) {
+        return 'Knowledge not found.';
+    }
+    const knowledge = detail.knowledge;
+    const summary = [
+        `Knowledge ${knowledge.id}`,
+        `fact: ${knowledge.fact}`,
+        `type: ${knowledge.fact_type}`,
+        `state: ${knowledge.knowledge_state}`,
+        `class: ${knowledge.knowledge_class}`,
+        `trust_score: ${knowledge.trust_score}`,
+        `verification_status: ${knowledge.verification_status}`,
+        `next_reverification_at: ${formatValue(knowledge.next_reverification_at)}`,
+    ].join('\n');
+    const evidence = formatTable(['ID', 'Source', 'Polarity', 'Outcome', 'Excerpt'], detail.evidence.map((item) => [
+        item.id,
+        item.source_type,
+        item.support_polarity,
+        item.outcome,
+        item.excerpt,
+    ]));
+    const audits = formatTable(['ID', 'Decision', 'Created', 'Detail'], detail.audits.map((item) => [item.id, item.decision, item.created_at, item.detail]));
+    return `${summary}\n\nEvidence\n${evidence}\n\nAudits\n${audits}`;
+}
+export function renderAudits(audits) {
+    return formatTable(['ID', 'Decision', 'Knowledge', 'Related', 'Created', 'Detail'], audits.map((item) => [
+        item.id,
+        item.decision,
+        item.created_knowledge_id,
+        item.related_knowledge_id,
+        item.created_at,
+        item.detail,
+    ]));
+}
+export function renderMonitor(monitor) {
+    if (!monitor) {
+        return 'No context monitor found.';
+    }
+    return [
+        `compaction_state: ${monitor.compaction_state}`,
+        `active_turn_count: ${monitor.active_turn_count}`,
+        `active_token_estimate: ${monitor.active_token_estimate}`,
+        `compaction_score: ${monitor.compaction_score}`,
+        `last_compaction_at: ${formatValue(monitor.last_compaction_at)}`,
+        `updated_at: ${monitor.updated_at}`,
+    ].join('\n');
+}
+export function renderCompactionLogs(logs) {
+    return formatTable(['ID', 'Trigger', 'Turns', 'Duration', 'Created'], logs.map((item) => [
+        item.id,
+        item.trigger_type,
+        `${item.turn_id_start}-${item.turn_id_end}`,
+        item.duration_ms,
+        item.created_at,
+    ]));
+}
+export function renderDueReverification(items) {
+    return formatTable(['ID', 'State', 'Trust', 'Next Reverify', 'Fact'], items.map((item) => [
+        item.id,
+        item.knowledge_state,
+        item.trust_score,
+        item.next_reverification_at,
+        item.fact,
+    ]));
+}
+export async function runInspectCommand(target, options) {
+    const manager = await createInspectionManager(options);
+    try {
+        switch (target) {
+            case 'knowledge':
+                if (options.id != null) {
+                    return renderKnowledgeDetail(await manager.inspectKnowledge(options.id));
+                }
+                return renderKnowledgeList(await manager.listKnowledge({
+                    limit: options.limit,
+                    cursor: options.cursor,
+                }));
+            case 'audits':
+                return renderAudits(await manager.getKnowledgeAudits({
+                    knowledgeId: options.knowledgeId,
+                    limit: options.limit,
+                }));
+            case 'monitor':
+                return renderMonitor(await manager.getContextMonitor());
+            case 'compactions':
+                return renderCompactionLogs(await manager.getRecentCompactionLogs(options.limit));
+            case 'reverification':
+                if (options.run) {
+                    const result = await manager.runReverification({ limit: options.limit });
+                    return [
+                        `reverified=${result.reverifiedKnowledgeIds.length}`,
+                        `demoted=${result.demotedKnowledgeIds.length}`,
+                    ].join('\n');
+                }
+                return renderDueReverification(await manager.getDueReverification({ limit: options.limit }));
+            case 'changes': {
+                const since = options.since ? new Date(options.since) : new Date(0);
+                if (Number.isNaN(since.valueOf())) {
+                    throw new Error('Invalid --since value');
+                }
+                return renderDueReverification(await manager.pollForChanges(since, {
+                    scopeLevel: options.crossScopeLevel,
+                }));
+            }
+            default:
+                throw new Error(`Unsupported inspect target: ${target}`);
+        }
+    }
+    finally {
+        await manager.close();
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/cli/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/cli/inspect.ts"],"names":[],"mappings":"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"}

package/dist/contracts/async-storage.d.ts

@@ -0,0 +1,86 @@
+import type { MemoryScope, ScopeLevel } from './identity.js';
+import type { CompactionLog, ContextMonitor, ContextMonitorUpsert, KnowledgeCandidate, KnowledgeEvidence, KnowledgeMemory, KnowledgeMemoryAudit, NewCompactionLog, NewKnowledgeCandidate, NewKnowledgeEvidence, NewKnowledgeMemory, NewKnowledgeMemoryAudit, NewWorkItem, NewTurn, NewWorkingMemory, PaginationOptions, PaginatedResult, SearchOptions, SearchResult, TimeRange, Turn, WorkItem, WorkingMemory } from './types.js';
+/**
+ * Async-first storage adapter interface for remote backends (PostgreSQL, Redis, etc.).
+ * Every method returns a Promise, enabling non-blocking I/O.
+ *
+ * For synchronous adapters (SQLite, in-memory), use `wrapSyncAdapter()` from
+ * `memory-layer/adapters/sync-to-async` to convert a `StorageAdapter` into
+ * an `AsyncStorageAdapter`.
+ */
+export interface AsyncStorageAdapter {
+    insertTurn(input: NewTurn): Promise<Turn>;
+    insertTurns(inputs: NewTurn[]): Promise<Turn[]>;
+    getTurnById(id: number): Promise<Turn | null>;
+    getActiveTurns(scope: MemoryScope, sessionId?: string): Promise<Turn[]>;
+    getActiveTurnsPaginated(scope: MemoryScope, options?: PaginationOptions): Promise<PaginatedResult<Turn>>;
+    getTurnsByTimeRange(scope: MemoryScope, range: TimeRange): Promise<Turn[]>;
+    searchTurns(scope: MemoryScope, query: string, options?: SearchOptions): Promise<SearchResult<Turn>[]>;
+    archiveTurn(id: number, archivedAt: number, compactionLogId: number): Promise<void>;
+    getArchivedTurnRange(sessionId: string, startId: number, endId: number, scope: MemoryScope): Promise<Turn[]>;
+    insertWorkingMemory(input: NewWorkingMemory): Promise<WorkingMemory>;
+    getWorkingMemoryById(id: number): Promise<WorkingMemory | null>;
+    getWorkingMemoryBySession(sessionId: string, scope: MemoryScope): Promise<WorkingMemory[]>;
+    getActiveWorkingMemory(scope: MemoryScope, sessionId?: string): Promise<WorkingMemory[]>;
+    getLatestWorkingMemory(scope: MemoryScope, sessionId?: string): Promise<WorkingMemory | null>;
+    getWorkingMemoryByTimeRange(scope: MemoryScope, range: TimeRange): Promise<WorkingMemory[]>;
+    expireWorkingMemory(id: number): Promise<void>;
+    markWorkingMemoryPromoted(id: number, knowledgeMemoryId: number): Promise<void>;
+    insertKnowledgeMemory(input: NewKnowledgeMemory): Promise<KnowledgeMemory>;
+    insertKnowledgeMemories(inputs: NewKnowledgeMemory[]): Promise<KnowledgeMemory[]>;
+    insertKnowledgeCandidate(input: NewKnowledgeCandidate): Promise<KnowledgeCandidate>;
+    insertKnowledgeCandidates(inputs: NewKnowledgeCandidate[]): Promise<KnowledgeCandidate[]>;
+    getKnowledgeCandidateById(id: number): Promise<KnowledgeCandidate | null>;
+    listKnowledgeCandidates(scope: MemoryScope, options?: {
+        state?: Array<KnowledgeCandidate['state']>;
+    }): Promise<KnowledgeCandidate[]>;
+    insertKnowledgeEvidence(input: NewKnowledgeEvidence): Promise<KnowledgeEvidence>;
+    insertKnowledgeEvidenceBatch(inputs: NewKnowledgeEvidence[]): Promise<KnowledgeEvidence[]>;
+    listKnowledgeEvidenceForKnowledge(knowledgeId: number): Promise<KnowledgeEvidence[]>;
+    listKnowledgeEvidenceForCandidate(candidateId: number): Promise<KnowledgeEvidence[]>;
+    promoteKnowledgeCandidate(candidateId: number, input: NewKnowledgeMemory): Promise<KnowledgeMemory>;
+    getKnowledgeMemoryById(id: number): Promise<KnowledgeMemory | null>;
+    getActiveKnowledgeMemory(scope: MemoryScope): Promise<KnowledgeMemory[]>;
+    getActiveKnowledgeMemoryPaginated(scope: MemoryScope, options?: PaginationOptions): Promise<PaginatedResult<KnowledgeMemory>>;
+    getActiveKnowledgeCrossScope(scope: MemoryScope, level: ScopeLevel): Promise<KnowledgeMemory[]>;
+    getKnowledgeSince(scope: MemoryScope, level: ScopeLevel, since: number): Promise<KnowledgeMemory[]>;
+    getKnowledgeByTimeRange(scope: MemoryScope, range: TimeRange): Promise<KnowledgeMemory[]>;
+    searchKnowledge(scope: MemoryScope, query: string, options?: SearchOptions): Promise<SearchResult<KnowledgeMemory>[]>;
+    searchKnowledgeCrossScope(scope: MemoryScope, level: ScopeLevel, query: string, options?: SearchOptions): Promise<SearchResult<KnowledgeMemory>[]>;
+    insertKnowledgeMemoryAudit(input: NewKnowledgeMemoryAudit): Promise<KnowledgeMemoryAudit>;
+    getRecentKnowledgeMemoryAudits(scope: MemoryScope, limit?: number): Promise<KnowledgeMemoryAudit[]>;
+    getKnowledgeMemoryAuditsForKnowledge(scope: MemoryScope, knowledgeId: number, limit?: number): Promise<KnowledgeMemoryAudit[]>;
+    updateKnowledgeMemory(id: number, patch: {
+        knowledge_state?: KnowledgeMemory['knowledge_state'];
+        knowledge_class?: KnowledgeMemory['knowledge_class'];
+        trust_score?: number;
+        verification_status?: KnowledgeMemory['verification_status'];
+        verification_notes?: string | null;
+        last_verified_at?: number | null;
+        next_reverification_at?: number | null;
+        last_confirmed_at?: number | null;
+        confirmation_count?: number;
+        disputed_at?: number | null;
+        dispute_reason?: string | null;
+        contradiction_score?: number;
+        superseded_at?: number | null;
+        successful_use_count?: number;
+        failed_use_count?: number;
+    }): Promise<KnowledgeMemory | null>;
+    touchKnowledgeMemory(id: number): Promise<void>;
+    retireKnowledgeMemory(id: number, retiredAt?: number): Promise<void>;
+    supersedeKnowledgeMemory(oldId: number, newId: number): Promise<void>;
+    insertWorkItem(input: NewWorkItem): Promise<WorkItem>;
+    getActiveWorkItems(scope: MemoryScope): Promise<WorkItem[]>;
+    getWorkItemsByTimeRange(scope: MemoryScope, range: TimeRange): Promise<WorkItem[]>;
+    updateWorkItemStatus(id: number, status: WorkItem['status']): Promise<void>;
+    deleteWorkItem(id: number): Promise<void>;
+    upsertContextMonitor(input: ContextMonitorUpsert): Promise<ContextMonitor>;
+    getContextMonitor(scope: MemoryScope): Promise<ContextMonitor | null>;
+    insertCompactionLog(input: NewCompactionLog): Promise<CompactionLog>;
+    getCompactionLogById(id: number): Promise<CompactionLog | null>;
+    getRecentCompactionLogs(scope: MemoryScope, limit?: number): Promise<CompactionLog[]>;
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=async-storage.d.ts.map

package/dist/contracts/async-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage.d.ts","sourceRoot":"","sources":["../../src/contracts/async-storage.ts"],"names":[],"mappings":"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"}

package/dist/contracts/async-storage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async-storage.js.map

package/dist/contracts/async-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage.js","sourceRoot":"","sources":["../../src/contracts/async-storage.ts"],"names":[],"mappings":""}

package/dist/contracts/embedding.d.ts

@@ -0,0 +1,22 @@
+import type { MemoryScope, ScopeLevel } from './identity.js';
+export type EmbeddingVector = Float32Array;
+export type EmbeddingGenerator = (texts: string[]) => Promise<EmbeddingVector[]>;
+export type MaybePromise<T> = T | Promise<T>;
+export interface SimilarEmbeddingResult {
+    knowledgeMemoryId: number;
+    similarity: number;
+}
+export interface EmbeddingAdapter {
+    storeEmbedding(knowledgeMemoryId: number, vector: EmbeddingVector): MaybePromise<void>;
+    getEmbedding(knowledgeMemoryId: number): MaybePromise<EmbeddingVector | null>;
+    findSimilar(scope: MemoryScope, queryVector: EmbeddingVector, options?: {
+        limit?: number;
+        minSimilarity?: number;
+    }): MaybePromise<SimilarEmbeddingResult[]>;
+    findSimilarCrossScope(scope: MemoryScope, level: ScopeLevel, queryVector: EmbeddingVector, options?: {
+        limit?: number;
+        minSimilarity?: number;
+    }): MaybePromise<SimilarEmbeddingResult[]>;
+    deleteEmbedding(knowledgeMemoryId: number): MaybePromise<void>;
+}
+//# sourceMappingURL=embedding.d.ts.map

package/dist/contracts/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/contracts/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAC3C,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AACjF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvF,YAAY,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9E,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,qBAAqB,CACnB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,eAAe,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC1C,eAAe,CAAC,iBAAiB,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/contracts/embedding.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedding.js.map

package/dist/contracts/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../src/contracts/embedding.ts"],"names":[],"mappings":""}

package/dist/contracts/identity.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_WORKSPACE_ID = "default";
+export type ScopeLevel = 'scope' | 'workspace' | 'system' | 'tenant';
+export interface MemoryScope {
+    /** Multi-tenant partition. */
+    tenant_id: string;
+    /** Calling agent or system identity, not a shared-memory boundary. */
+    system_id: string;
+    /** Workspace or project boundary. */
+    workspace_id?: string;
+    /** Explicit shared-memory boundary across multiple systems or agents. */
+    collaboration_id?: string;
+    /** Task, thread, or branch boundary within a workspace/collaboration. */
+    scope_id: string;
+}
+export interface NormalizedMemoryScope {
+    tenant_id: string;
+    system_id: string;
+    workspace_id: string;
+    collaboration_id: string;
+    scope_id: string;
+}
+export interface ScopeQuery {
+    scope: MemoryScope;
+    level: ScopeLevel;
+}
+export declare function normalizeScope(scope: MemoryScope): NormalizedMemoryScope;
+export declare function scopeValues(scope: MemoryScope): [string, string, string, string, string];
+export declare function widenScope(scope: MemoryScope, level: ScopeLevel): ScopeQuery;
+//# sourceMappingURL=identity.d.ts.map

package/dist/contracts/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AASD,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CASxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CASxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAK5E"}

package/dist/contracts/identity.js

@@ -0,0 +1,34 @@
+export const DEFAULT_WORKSPACE_ID = 'default';
+function assertScopeValue(value, name) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`Memory validation: '${name}' must not be empty`);
+    }
+    return value.trim();
+}
+export function normalizeScope(scope) {
+    const workspaceId = scope.workspace_id?.trim() || DEFAULT_WORKSPACE_ID;
+    return {
+        tenant_id: assertScopeValue(scope.tenant_id, 'tenant_id'),
+        system_id: assertScopeValue(scope.system_id, 'system_id'),
+        workspace_id: workspaceId,
+        collaboration_id: scope.collaboration_id?.trim() || '',
+        scope_id: assertScopeValue(scope.scope_id, 'scope_id'),
+    };
+}
+export function scopeValues(scope) {
+    const normalized = normalizeScope(scope);
+    return [
+        normalized.tenant_id,
+        normalized.system_id,
+        normalized.workspace_id,
+        normalized.collaboration_id,
+        normalized.scope_id,
+    ];
+}
+export function widenScope(scope, level) {
+    return {
+        scope: normalizeScope(scope),
+        level,
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/contracts/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/contracts/identity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AA6B9C,SAAS,gBAAgB,CAAC,KAAyB,EAAE,IAAuB;IAC1E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,qBAAqB,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,oBAAoB,CAAC;IACvE,OAAO;QACL,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;QACzD,YAAY,EAAE,WAAW;QACzB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;QACtD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO;QACL,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,YAAY;QACvB,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAkB,EAAE,KAAiB;IAC9D,OAAO;QACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/contracts/observability.d.ts

@@ -0,0 +1,18 @@
+import type { NormalizedMemoryScope } from './identity.js';
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+export declare const noopLogger: Logger;
+export type MemoryEventType = 'capability' | 'compaction' | 'promotion' | 'extraction' | 'knowledge_change' | 'search' | 'context_assembly' | 'semantic_search' | 'manager';
+export interface MemoryEvent {
+    type: MemoryEventType;
+    scope: NormalizedMemoryScope;
+    timestamp: number;
+    durationMs: number;
+    meta: Record<string, unknown>;
+}
+export type EventHook = (event: MemoryEvent) => void;
+//# sourceMappingURL=observability.d.ts.map

package/dist/contracts/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,QAAQ,GACR,kBAAkB,GAClB,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/contracts/observability.js

@@ -0,0 +1,7 @@
+export const noopLogger = {
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+};
+//# sourceMappingURL=observability.js.map

package/dist/contracts/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/contracts/observability.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC"}