@equationalapplications/core-llm-wiki 4.18.1 → 4.20.0

package/dist/{testing-BfxdUHg9.d.mts → testing-BVN_g414.d.mts}

@@ -13,6 +13,15 @@ interface SQLiteAdapter {
     }>;
     getAllAsync<T>(sql: string, params?: unknown[]): Promise<T[]>;
     getFirstAsync<T>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Runs `fn` inside a transaction. A bare adapter implementation is not required to
+     * serialize concurrent calls itself — `WikiMemory` wraps every adapter it's given in
+     * `withSerializedTransactions` (see `db/serializedAdapter.ts`), which is what makes
+     * transactions serialize in practice. Once wrapped, inside the callback use ONLY the
+     * provided `tx` handle — never the outer database handle (captured via closure or
+     * `this.db`). Calling the outer handle deadlocks against the transaction mutex;
+     * calling `tx.withTransactionAsync` throws (nested transactions are unsupported).
+     */
     withTransactionAsync<T>(fn: (tx: SQLiteAdapter) => Promise<T>): Promise<T>;
     closeAsync(): Promise<void>;
 }
@@ -468,6 +477,19 @@ declare class WikiBusyError extends Error {
     readonly entityId: string;
     constructor(operation: WikiBusyOperation, entityId: string);
 }
+/**
+ * Thrown by the serialized transaction wrapper when a SQLite driver error
+ * escapes a transaction callback (nested BEGIN, SQLITE_BUSY, constraint
+ * violation). Domain errors thrown from callback logic pass through unwrapped.
+ * Stable `instanceof` target for observability, mirroring {@link WikiBusyError}.
+ */
+declare class WikiTransactionError extends Error {
+    /** Best-effort SQLite code lifted from the driver error, e.g. 'SQLITE_BUSY'. */
+    readonly sqliteErrorCode?: string;
+    constructor(message: string, options: {
+        cause: unknown;
+    });
+}
 declare class PrunePartialFailureError extends Error {
     readonly deleted: number;
     readonly failedAt: string;
@@ -709,6 +731,7 @@ declare class MetadataRepository extends BaseRepository {
     deleteCheckpoint(entityId: string, tx: SQLiteAdapter): Promise<void>;
     getMeta(key: string, tx?: SQLiteAdapter): Promise<string | null>;
     setMeta(key: string, value: string, tx: SQLiteAdapter): Promise<void>;
+    deleteMeta(key: string, tx?: SQLiteAdapter): Promise<void>;
     clearDimensionMismatch(tx: SQLiteAdapter): Promise<void>;
     tableExists(tableName: string, tx?: SQLiteAdapter): Promise<boolean>;
     getTableDdl(tableName: string, tx?: SQLiteAdapter): Promise<string | null>;
@@ -1302,6 +1325,8 @@ declare class WikiMemory {
     subscribeEntityStatus(entityId: string, callback: (status: EntityStatus) => void): () => void;
     clearVectorCache(): void;
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
+    /** Entity summary prose persisted from an OKF profile ≥ 1 import; null when none stored. */
+    getEntitySummary(entityId: string): Promise<string | null>;
     importDump(dump: MemoryDump, opts?: {
         merge?: boolean;
     }): Promise<void>;
@@ -1362,4 +1387,4 @@ declare class WikiMemory {
     }): Promise<void>;
 }
 
-export { type WikiMemoryTestAccess as A, type WikiOutboxEvent as B, type WikiTask as C, EmbeddingService as D, type EntityStatus as E, type FormatContextOptions as F, type GraphNeighborhood as G, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, IngestionService as J, JobManager as K, type LLMProvider as L, type MemoryBundle as M, MaintenanceService as N, type OntologyConfig as O, type PromptOverrides as P, RetrievalService as Q, type ReadOptions as R, type SQLiteAdapter as S, SearchService as T, WriteService as U, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedFactEdge as e, type ExtractedFactWithOntology as f, type ExtractedTask as g, type GraphTraversalOptions as h, type OntologyEdgeType as i, type OntologyManifest as j, type OntologyMode as k, type OntologyNodeType as l, type OntologyPromptContext as m, type OntologyUpdates as n, PromptService as o, PrunePartialFailureError as p, type VectorRankerFallback as q, type VectorRankerRankArgs as r, type VectorRankerSemanticResult as s, WikiBusyError as t, type WikiBusyOperation as u, type WikiCheckpoint as v, type WikiConfig as w, type WikiEdge as x, type WikiEvent as y, type WikiFact as z };
+export { type WikiMemoryTestAccess as A, type WikiOutboxEvent as B, type WikiTask as C, WikiTransactionError as D, type EntityStatus as E, type FormatContextOptions as F, type GraphNeighborhood as G, HOOK_TIMEOUT_MARKER as H, EmbeddingService as I, ImportExportService as J, IngestionService as K, type LLMProvider as L, type MemoryBundle as M, JobManager as N, type OntologyConfig as O, type PromptOverrides as P, MaintenanceService as Q, type ReadOptions as R, type SQLiteAdapter as S, RetrievalService as T, SearchService as U, type VectorRanker as V, type WikiOptions as W, WriteService as X, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedFactEdge as e, type ExtractedFactWithOntology as f, type ExtractedTask as g, type GraphTraversalOptions as h, type OntologyEdgeType as i, type OntologyManifest as j, type OntologyMode as k, type OntologyNodeType as l, type OntologyPromptContext as m, type OntologyUpdates as n, PromptService as o, PrunePartialFailureError as p, type VectorRankerFallback as q, type VectorRankerRankArgs as r, type VectorRankerSemanticResult as s, WikiBusyError as t, type WikiBusyOperation as u, type WikiCheckpoint as v, type WikiConfig as w, type WikiEdge as x, type WikiEvent as y, type WikiFact as z };

package/dist/{testing-BfxdUHg9.d.ts → testing-BVN_g414.d.ts}

@@ -13,6 +13,15 @@ interface SQLiteAdapter {
     }>;
     getAllAsync<T>(sql: string, params?: unknown[]): Promise<T[]>;
     getFirstAsync<T>(sql: string, params?: unknown[]): Promise<T | null>;
+    /**
+     * Runs `fn` inside a transaction. A bare adapter implementation is not required to
+     * serialize concurrent calls itself — `WikiMemory` wraps every adapter it's given in
+     * `withSerializedTransactions` (see `db/serializedAdapter.ts`), which is what makes
+     * transactions serialize in practice. Once wrapped, inside the callback use ONLY the
+     * provided `tx` handle — never the outer database handle (captured via closure or
+     * `this.db`). Calling the outer handle deadlocks against the transaction mutex;
+     * calling `tx.withTransactionAsync` throws (nested transactions are unsupported).
+     */
     withTransactionAsync<T>(fn: (tx: SQLiteAdapter) => Promise<T>): Promise<T>;
     closeAsync(): Promise<void>;
 }
@@ -468,6 +477,19 @@ declare class WikiBusyError extends Error {
     readonly entityId: string;
     constructor(operation: WikiBusyOperation, entityId: string);
 }
+/**
+ * Thrown by the serialized transaction wrapper when a SQLite driver error
+ * escapes a transaction callback (nested BEGIN, SQLITE_BUSY, constraint
+ * violation). Domain errors thrown from callback logic pass through unwrapped.
+ * Stable `instanceof` target for observability, mirroring {@link WikiBusyError}.
+ */
+declare class WikiTransactionError extends Error {
+    /** Best-effort SQLite code lifted from the driver error, e.g. 'SQLITE_BUSY'. */
+    readonly sqliteErrorCode?: string;
+    constructor(message: string, options: {
+        cause: unknown;
+    });
+}
 declare class PrunePartialFailureError extends Error {
     readonly deleted: number;
     readonly failedAt: string;
@@ -709,6 +731,7 @@ declare class MetadataRepository extends BaseRepository {
     deleteCheckpoint(entityId: string, tx: SQLiteAdapter): Promise<void>;
     getMeta(key: string, tx?: SQLiteAdapter): Promise<string | null>;
     setMeta(key: string, value: string, tx: SQLiteAdapter): Promise<void>;
+    deleteMeta(key: string, tx?: SQLiteAdapter): Promise<void>;
     clearDimensionMismatch(tx: SQLiteAdapter): Promise<void>;
     tableExists(tableName: string, tx?: SQLiteAdapter): Promise<boolean>;
     getTableDdl(tableName: string, tx?: SQLiteAdapter): Promise<string | null>;
@@ -1302,6 +1325,8 @@ declare class WikiMemory {
     subscribeEntityStatus(entityId: string, callback: (status: EntityStatus) => void): () => void;
     clearVectorCache(): void;
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
+    /** Entity summary prose persisted from an OKF profile ≥ 1 import; null when none stored. */
+    getEntitySummary(entityId: string): Promise<string | null>;
     importDump(dump: MemoryDump, opts?: {
         merge?: boolean;
     }): Promise<void>;
@@ -1362,4 +1387,4 @@ declare class WikiMemory {
     }): Promise<void>;
 }
 
-export { type WikiMemoryTestAccess as A, type WikiOutboxEvent as B, type WikiTask as C, EmbeddingService as D, type EntityStatus as E, type FormatContextOptions as F, type GraphNeighborhood as G, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, IngestionService as J, JobManager as K, type LLMProvider as L, type MemoryBundle as M, MaintenanceService as N, type OntologyConfig as O, type PromptOverrides as P, RetrievalService as Q, type ReadOptions as R, type SQLiteAdapter as S, SearchService as T, WriteService as U, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedFactEdge as e, type ExtractedFactWithOntology as f, type ExtractedTask as g, type GraphTraversalOptions as h, type OntologyEdgeType as i, type OntologyManifest as j, type OntologyMode as k, type OntologyNodeType as l, type OntologyPromptContext as m, type OntologyUpdates as n, PromptService as o, PrunePartialFailureError as p, type VectorRankerFallback as q, type VectorRankerRankArgs as r, type VectorRankerSemanticResult as s, WikiBusyError as t, type WikiBusyOperation as u, type WikiCheckpoint as v, type WikiConfig as w, type WikiEdge as x, type WikiEvent as y, type WikiFact as z };
+export { type WikiMemoryTestAccess as A, type WikiOutboxEvent as B, type WikiTask as C, WikiTransactionError as D, type EntityStatus as E, type FormatContextOptions as F, type GraphNeighborhood as G, HOOK_TIMEOUT_MARKER as H, EmbeddingService as I, ImportExportService as J, IngestionService as K, type LLMProvider as L, type MemoryBundle as M, JobManager as N, type OntologyConfig as O, type PromptOverrides as P, MaintenanceService as Q, type ReadOptions as R, type SQLiteAdapter as S, RetrievalService as T, SearchService as U, type VectorRanker as V, type WikiOptions as W, WriteService as X, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedFactEdge as e, type ExtractedFactWithOntology as f, type ExtractedTask as g, type GraphTraversalOptions as h, type OntologyEdgeType as i, type OntologyManifest as j, type OntologyMode as k, type OntologyNodeType as l, type OntologyPromptContext as m, type OntologyUpdates as n, PromptService as o, PrunePartialFailureError as p, type VectorRankerFallback as q, type VectorRankerRankArgs as r, type VectorRankerSemanticResult as s, WikiBusyError as t, type WikiBusyOperation as u, type WikiCheckpoint as v, type WikiConfig as w, type WikiEdge as x, type WikiEvent as y, type WikiFact as z };

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-export { D as EmbeddingService, I as ImportExportService, J as IngestionService, K as JobManager, K as JobManagerType, N as MaintenanceService, Q as RetrievalService, T as SearchService, T as SearchServiceType, A as WikiMemoryTestAccess, U as WriteService } from './testing-BfxdUHg9.mjs';
+export { I as EmbeddingService, J as ImportExportService, K as IngestionService, N as JobManager, N as JobManagerType, Q as MaintenanceService, T as RetrievalService, U as SearchService, U as SearchServiceType, A as WikiMemoryTestAccess, X as WriteService } from './testing-BVN_g414.mjs';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,2 +1,2 @@
-export { D as EmbeddingService, I as ImportExportService, J as IngestionService, K as JobManager, K as JobManagerType, N as MaintenanceService, Q as RetrievalService, T as SearchService, T as SearchServiceType, A as WikiMemoryTestAccess, U as WriteService } from './testing-BfxdUHg9.js';
+export { I as EmbeddingService, J as ImportExportService, K as IngestionService, N as JobManager, N as JobManagerType, Q as MaintenanceService, T as RetrievalService, U as SearchService, U as SearchServiceType, A as WikiMemoryTestAccess, X as WriteService } from './testing-BVN_g414.js';
 import 'minisearch';

package/dist/testing.js

@@ -369,6 +369,16 @@ var EmbeddingService = class {
   }
 };
 
+// src/utils/ontology.ts
+function normalizeTitleKey(title) {
+  return title.trim().toLowerCase().replace(/\s+/g, " ");
+}
+
+// src/repositories/MetadataRepository.ts
+function entitySummaryMetaKey(entityId) {
+  return `entity_summary:${entityId}`;
+}
+
 // src/services/ImportExportService.ts
 var MAX_EMBEDDING_BLOB_BYTES = 32 * 1024;
 var IMPORT_TITLE_MAX = 500;
@@ -424,11 +434,12 @@ var ImportExportService = class {
     }
   }
   async getFullBundle(entityId, opts) {
-    const [factsRaw, tasks, events, edges] = await Promise.all([
+    const [factsRaw, tasks, events, edges, summaryValue] = await Promise.all([
       opts?.includeBlobs ? this.entryRepo.findAllByEntityIdWithBlobs(entityId) : this.entryRepo.findAllByEntityId(entityId),
       this.taskRepo.findAllByEntityId(entityId),
       this.eventRepo.getByEntityId(entityId, opts?.maxEvents),
-      this.edgeRepo.getByEntityId(entityId)
+      this.edgeRepo.getByEntityId(entityId),
+      this.metadataRepo.getMeta(entitySummaryMetaKey(entityId))
     ]);
     const facts = factsRaw.map((f) => {
       const {
@@ -447,7 +458,13 @@ var ImportExportService = class {
         tags: typeof factBase.tags === "string" ? JSON.parse(factBase.tags) : factBase.tags
       };
     });
-    return { facts, tasks, events, edges };
+    return {
+      facts,
+      tasks,
+      events,
+      edges,
+      ...summaryValue != null ? { summary: summaryValue } : {}
+    };
   }
   /** Single-entity import transaction + post-processing; package-internal hook for tests. */
   async doImportEntity(entityId, bundle, merge) {
@@ -472,6 +489,11 @@ var ImportExportService = class {
         await this.edgeRepo.bulkDeleteByEntityId(entityId, tx);
         await this.metadataRepo.deleteCheckpoint(entityId, tx);
       }
+      if (bundle.summary !== void 0) {
+        await this.metadataRepo.setMeta(entitySummaryMetaKey(entityId), bundle.summary, tx);
+      } else if (!merge) {
+        await this.metadataRepo.deleteMeta(entitySummaryMetaKey(entityId), tx);
+      }
       const factIds = bundle.facts.map((fact) => fact.id);
       const existingFactsById = /* @__PURE__ */ new Map();
       const existingFacts = await this.entryRepo.findExistingMetadataByIds(
@@ -795,11 +817,6 @@ After running the migration SQL, restart your application.`
     );
   }
 };
-
-// src/utils/ontology.ts
-function normalizeTitleKey(title) {
-  return title.trim().toLowerCase().replace(/\s+/g, " ");
-}
 function generateId(prefix = "") {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return prefix + crypto.randomUUID().replace(/-/g, "").substring(0, 24);
@@ -1278,6 +1295,7 @@ var MaintenanceService = class {
           deletedEntries = await this.entryRepo.bulkSoftDeleteByEntityId(entityId, tx);
           deletedTasks = await this.taskRepo.bulkSoftDeleteByEntityId(entityId, tx);
           await this.metadataRepo.updateCheckpoint(entityId, { memory: 0, heal: 0 }, tx);
+          await this.metadataRepo.deleteMeta(entitySummaryMetaKey(entityId), tx);
         } else {
           const hasIdSelectors = params.entryId !== void 0 || params.taskId !== void 0;
           const hasSourceSelectors = params.sourceRef !== void 0 || params.sourceHash !== void 0;