@equationalapplications/core-llm-wiki 7.14.0 → 7.15.1

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { M as MemoryBundle, F as FormatContextOptions, G as GraphNeighborhood, a as MemoryDump, b as FormattedMemoryDump, R as ReadOptions, S as SQLiteAdapter, W as WikiOptions, c as WikiMemory } from './testing-DbrL569t.mjs';
-export { C as ChunkFailure, d as ClassifierAnswer, e as ClassifierQuestion, f as ClassifyRequest, g as ClassifyResponse, D as DegradedRecord, h as DraftPage, E as EmbedFactResult, i as EmbedFailureKind, j as EmbeddingMarkerKind, k as EntityMaintenanceReport, l as EntityStatus, m as ExtractedFact, n as ExtractedFactEdge, o as ExtractedFactWithOntology, p as ExtractedTask, q as GraphTraversalOptions, r as GroundingConfig, H as HEAL_BATCH_SIZE, s as HEAL_RECHECK_MS, t as HOOK_TIMEOUT_MARKER, u as HealResult, I as IngestDocumentResult, L as LLMProvider, v as LibrarianConfig, w as LibrarianGateConfig, x as MaintenanceJob, y as MaintenanceStopReason, z as MigrationPolicy, O as ONTOLOGY_BACKFILL_BATCH_SIZE, A as ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, B as ONTOLOGY_BACKFILL_RECHECK_MS, J as OntologyBackfillResult, K as OntologyConfig, N as OntologyEdgeType, P as OntologyManifest, Q as OntologyMode, T as OntologyNodeType, U as OntologyPromptContext, V as OntologyUpdates, X as PendingMaintenance, Y as PendingMigrationWork, Z as PendingSourceStatus, _ as PromptOverrides, $ as PromptService, a0 as PrunePartialFailureError, a1 as ReembedResult, a2 as RunPendingMaintenanceOptions, a3 as RunPendingMaintenanceResult, a4 as SupersedeReplacement, a5 as VectorRanker, a6 as VectorRankerFallback, a7 as VectorRankerRankArgs, a8 as VectorRankerSemanticResult, a9 as WikiBusyError, aa as WikiBusyOperation, ab as WikiCheckpoint, ac as WikiConfig, ad as WikiDiagnostic, ae as WikiDiagnosticCode, af as WikiDiagnosticDetail, ag as WikiDiagnosticOperation, ah as WikiDiagnosticSeverity, ai as WikiDiagnosticTrigger, aj as WikiDraftNotFound, ak as WikiDuplicateHashError, al as WikiEdge, am as WikiEvent, an as WikiFact, ao as WikiGraphNodeOwnershipConflict, ap as WikiIngestEmptyError, aq as WikiInstructions, ar as WikiInvalidReadOptions, as as WikiLintReport, at as WikiMemoryTestAccess, au as WikiMigrationRequiredError, av as WikiOutboxEvent, aw as WikiParseError, ax as WikiSearchUnavailableError, ay as WikiSourceRefHashCollision, az as WikiStrictOntologyViolation, aA as WikiSupersedeError, aB as WikiSupersedeReason, aC as WikiTask, aD as WikiTransactionError, aE as isWikiSearchUnavailableError, aF as validateManifest } from './testing-DbrL569t.mjs';
+import { M as MemoryBundle, F as FormatContextOptions, G as GraphNeighborhood, a as MemoryDump, b as FormattedMemoryDump, R as ReadOptions, S as SQLiteAdapter, W as WikiOptions, c as WikiMemory } from './testing-BlGhilQw.mjs';
+export { C as ChunkFailure, d as ClassifierAnswer, e as ClassifierQuestion, f as ClassifyRequest, g as ClassifyResponse, D as DegradedRecord, h as DraftPage, E as EmbedFactResult, i as EmbedFailureKind, j as EmbeddingMarkerKind, k as EntityMaintenanceReport, l as EntityStatus, m as ExtractedFact, n as ExtractedFactEdge, o as ExtractedFactWithOntology, p as ExtractedTask, q as GraphTraversalOptions, r as GroundingConfig, H as HEAL_BATCH_SIZE, s as HEAL_RECHECK_MS, t as HOOK_TIMEOUT_MARKER, u as HealResult, I as IngestDocumentResult, L as LLMProvider, v as LibrarianConfig, w as LibrarianGateConfig, x as MaintenanceJob, y as MaintenanceStopReason, z as MigrationPolicy, O as ONTOLOGY_BACKFILL_BATCH_SIZE, A as ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, B as ONTOLOGY_BACKFILL_RECHECK_MS, J as OntologyBackfillResult, K as OntologyConfig, N as OntologyEdgeType, P as OntologyManifest, Q as OntologyMode, T as OntologyNodeType, U as OntologyPromptContext, V as OntologyUpdates, X as PendingMaintenance, Y as PendingMigrationWork, Z as PendingSourceStatus, _ as PromptOverrides, $ as PromptService, a0 as PrunePartialFailureError, a1 as ReembedResult, a2 as RememberInput, a3 as RunPendingMaintenanceOptions, a4 as RunPendingMaintenanceResult, a5 as SupersedeReplacement, a6 as VectorRanker, a7 as VectorRankerFallback, a8 as VectorRankerRankArgs, a9 as VectorRankerSemanticResult, aa as WikiBusyError, ab as WikiBusyOperation, ac as WikiCheckpoint, ad as WikiConfig, ae as WikiDiagnostic, af as WikiDiagnosticCode, ag as WikiDiagnosticDetail, ah as WikiDiagnosticOperation, ai as WikiDiagnosticSeverity, aj as WikiDiagnosticTrigger, ak as WikiDraftNotFound, al as WikiDuplicateHashError, am as WikiEdge, an as WikiEvent, ao as WikiFact, ap as WikiGraphNodeOwnershipConflict, aq as WikiIngestEmptyError, ar as WikiInstructions, as as WikiInvalidReadOptions, at as WikiLintReport, au as WikiMemoryTestAccess, av as WikiMigrationRequiredError, aw as WikiOutboxEvent, ax as WikiParseError, ay as WikiSearchUnavailableError, az as WikiSourceRefHashCollision, aA as WikiStrictOntologyViolation, aB as WikiSupersedeError, aC as WikiSupersedeReason, aD as WikiTask, aE as WikiTransactionError, aF as isWikiSearchUnavailableError, aG as validateManifest } from './testing-BlGhilQw.mjs';
 import { OkfFile } from '@equationalapplications/core-okf';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MemoryBundle, F as FormatContextOptions, G as GraphNeighborhood, a as MemoryDump, b as FormattedMemoryDump, R as ReadOptions, S as SQLiteAdapter, W as WikiOptions, c as WikiMemory } from './testing-DbrL569t.js';
-export { C as ChunkFailure, d as ClassifierAnswer, e as ClassifierQuestion, f as ClassifyRequest, g as ClassifyResponse, D as DegradedRecord, h as DraftPage, E as EmbedFactResult, i as EmbedFailureKind, j as EmbeddingMarkerKind, k as EntityMaintenanceReport, l as EntityStatus, m as ExtractedFact, n as ExtractedFactEdge, o as ExtractedFactWithOntology, p as ExtractedTask, q as GraphTraversalOptions, r as GroundingConfig, H as HEAL_BATCH_SIZE, s as HEAL_RECHECK_MS, t as HOOK_TIMEOUT_MARKER, u as HealResult, I as IngestDocumentResult, L as LLMProvider, v as LibrarianConfig, w as LibrarianGateConfig, x as MaintenanceJob, y as MaintenanceStopReason, z as MigrationPolicy, O as ONTOLOGY_BACKFILL_BATCH_SIZE, A as ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, B as ONTOLOGY_BACKFILL_RECHECK_MS, J as OntologyBackfillResult, K as OntologyConfig, N as OntologyEdgeType, P as OntologyManifest, Q as OntologyMode, T as OntologyNodeType, U as OntologyPromptContext, V as OntologyUpdates, X as PendingMaintenance, Y as PendingMigrationWork, Z as PendingSourceStatus, _ as PromptOverrides, $ as PromptService, a0 as PrunePartialFailureError, a1 as ReembedResult, a2 as RunPendingMaintenanceOptions, a3 as RunPendingMaintenanceResult, a4 as SupersedeReplacement, a5 as VectorRanker, a6 as VectorRankerFallback, a7 as VectorRankerRankArgs, a8 as VectorRankerSemanticResult, a9 as WikiBusyError, aa as WikiBusyOperation, ab as WikiCheckpoint, ac as WikiConfig, ad as WikiDiagnostic, ae as WikiDiagnosticCode, af as WikiDiagnosticDetail, ag as WikiDiagnosticOperation, ah as WikiDiagnosticSeverity, ai as WikiDiagnosticTrigger, aj as WikiDraftNotFound, ak as WikiDuplicateHashError, al as WikiEdge, am as WikiEvent, an as WikiFact, ao as WikiGraphNodeOwnershipConflict, ap as WikiIngestEmptyError, aq as WikiInstructions, ar as WikiInvalidReadOptions, as as WikiLintReport, at as WikiMemoryTestAccess, au as WikiMigrationRequiredError, av as WikiOutboxEvent, aw as WikiParseError, ax as WikiSearchUnavailableError, ay as WikiSourceRefHashCollision, az as WikiStrictOntologyViolation, aA as WikiSupersedeError, aB as WikiSupersedeReason, aC as WikiTask, aD as WikiTransactionError, aE as isWikiSearchUnavailableError, aF as validateManifest } from './testing-DbrL569t.js';
+import { M as MemoryBundle, F as FormatContextOptions, G as GraphNeighborhood, a as MemoryDump, b as FormattedMemoryDump, R as ReadOptions, S as SQLiteAdapter, W as WikiOptions, c as WikiMemory } from './testing-BlGhilQw.js';
+export { C as ChunkFailure, d as ClassifierAnswer, e as ClassifierQuestion, f as ClassifyRequest, g as ClassifyResponse, D as DegradedRecord, h as DraftPage, E as EmbedFactResult, i as EmbedFailureKind, j as EmbeddingMarkerKind, k as EntityMaintenanceReport, l as EntityStatus, m as ExtractedFact, n as ExtractedFactEdge, o as ExtractedFactWithOntology, p as ExtractedTask, q as GraphTraversalOptions, r as GroundingConfig, H as HEAL_BATCH_SIZE, s as HEAL_RECHECK_MS, t as HOOK_TIMEOUT_MARKER, u as HealResult, I as IngestDocumentResult, L as LLMProvider, v as LibrarianConfig, w as LibrarianGateConfig, x as MaintenanceJob, y as MaintenanceStopReason, z as MigrationPolicy, O as ONTOLOGY_BACKFILL_BATCH_SIZE, A as ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, B as ONTOLOGY_BACKFILL_RECHECK_MS, J as OntologyBackfillResult, K as OntologyConfig, N as OntologyEdgeType, P as OntologyManifest, Q as OntologyMode, T as OntologyNodeType, U as OntologyPromptContext, V as OntologyUpdates, X as PendingMaintenance, Y as PendingMigrationWork, Z as PendingSourceStatus, _ as PromptOverrides, $ as PromptService, a0 as PrunePartialFailureError, a1 as ReembedResult, a2 as RememberInput, a3 as RunPendingMaintenanceOptions, a4 as RunPendingMaintenanceResult, a5 as SupersedeReplacement, a6 as VectorRanker, a7 as VectorRankerFallback, a8 as VectorRankerRankArgs, a9 as VectorRankerSemanticResult, aa as WikiBusyError, ab as WikiBusyOperation, ac as WikiCheckpoint, ad as WikiConfig, ae as WikiDiagnostic, af as WikiDiagnosticCode, ag as WikiDiagnosticDetail, ah as WikiDiagnosticOperation, ai as WikiDiagnosticSeverity, aj as WikiDiagnosticTrigger, ak as WikiDraftNotFound, al as WikiDuplicateHashError, am as WikiEdge, an as WikiEvent, ao as WikiFact, ap as WikiGraphNodeOwnershipConflict, aq as WikiIngestEmptyError, ar as WikiInstructions, as as WikiInvalidReadOptions, at as WikiLintReport, au as WikiMemoryTestAccess, av as WikiMigrationRequiredError, aw as WikiOutboxEvent, ax as WikiParseError, ay as WikiSearchUnavailableError, az as WikiSourceRefHashCollision, aA as WikiStrictOntologyViolation, aB as WikiSupersedeError, aC as WikiSupersedeReason, aD as WikiTask, aE as WikiTransactionError, aF as isWikiSearchUnavailableError, aG as validateManifest } from './testing-BlGhilQw.js';
 import { OkfFile } from '@equationalapplications/core-okf';
 
 /**

package/dist/index.js

@@ -10804,6 +10804,15 @@ var RetrievalService = class {
   }
 };
 
+// src/utils/entityId.ts
+function assertEntityId(entityId) {
+  if (typeof entityId !== "string" || entityId.length === 0 || entityId.length > 200 || entityId.includes("\0")) {
+    throw new TypeError(
+      `Invalid entityId: must be a non-empty string at most 200 chars with no null bytes; got ${JSON.stringify(entityId)}.`
+    );
+  }
+}
+
 // src/services/WriteService.ts
 var WriteService = class {
   constructor(db, options, entryRepo, eventRepo, metadataRepo, jobManager, maintenanceService) {
@@ -10829,11 +10838,7 @@ var WriteService = class {
     }
   }
   async write(entityId, event) {
-    if (typeof entityId !== "string" || entityId.length === 0 || entityId.length > 200 || entityId.includes("\0")) {
-      throw new TypeError(
-        `Invalid entityId: must be a non-empty string at most 200 chars with no null bytes; got ${JSON.stringify(entityId)}.`
-      );
-    }
+    assertEntityId(entityId);
     if (event === null || typeof event !== "object" || Array.isArray(event)) {
       throw new TypeError("Invalid event: must be a non-null object.");
     }
@@ -11464,6 +11469,110 @@ var OkfTrustWritesRepository = class {
   }
 };
 
+// src/utils/rememberInput.ts
+var CONFIDENCE_VALUES = /* @__PURE__ */ new Set(["certain", "inferred", "tentative"]);
+var SOURCE_TYPE_VALUES = /* @__PURE__ */ new Set(["user_stated", "user_confirmed"]);
+function normalizeRememberInput(entityId, input, now) {
+  assertEntityId(entityId);
+  if (input === null || typeof input !== "object" || Array.isArray(input)) {
+    throw new TypeError("remember(): input must be a non-null object.");
+  }
+  if (typeof input.title !== "string" || input.title.trim() === "") {
+    throw new TypeError("remember(): input.title must be a non-empty string.");
+  }
+  if (typeof input.body !== "string") {
+    throw new TypeError("remember(): input.body must be a string.");
+  }
+  let tags = [];
+  if (input.tags !== void 0) {
+    if (!Array.isArray(input.tags)) {
+      throw new TypeError("remember(): input.tags must be an array of strings.");
+    }
+    for (let i = 0; i < input.tags.length; i++) {
+      if (typeof input.tags[i] !== "string") {
+        throw new TypeError("remember(): input.tags must be an array of strings.");
+      }
+    }
+    tags = [...input.tags];
+  }
+  const confidence = input.confidence === void 0 ? "certain" : input.confidence;
+  if (!CONFIDENCE_VALUES.has(confidence)) {
+    throw new TypeError(`remember(): input.confidence must be certain | inferred | tentative; got ${JSON.stringify(input.confidence)}.`);
+  }
+  const sourceType = input.source_type === void 0 ? "user_stated" : input.source_type;
+  if (!SOURCE_TYPE_VALUES.has(sourceType)) {
+    throw new TypeError(`remember(): input.source_type must be user_stated | user_confirmed; got ${JSON.stringify(input.source_type)}.`);
+  }
+  let okfType = null;
+  if (input.okf_type !== void 0 && input.okf_type !== null) {
+    if (typeof input.okf_type !== "string" || input.okf_type.trim() === "") {
+      throw new TypeError("remember(): input.okf_type must be a non-empty string or null.");
+    }
+    okfType = input.okf_type;
+  }
+  const validFrom = input.valid_from === void 0 ? void 0 : assertEpochMs("input.valid_from", input.valid_from);
+  const fact = {
+    id: generateId("fact_"),
+    entity_id: entityId,
+    title: input.title,
+    body: input.body,
+    tags,
+    confidence,
+    source_type: sourceType,
+    source_hash: null,
+    source_ref: null,
+    created_at: now,
+    updated_at: now,
+    last_accessed_at: null,
+    access_count: 0,
+    deleted_at: null,
+    okf_type: null
+  };
+  return { fact, validFrom, okfType };
+}
+
+// src/services/RememberService.ts
+var RememberService = class {
+  constructor(db, entryRepo, ontologyService, searchService, embeddingService) {
+    this.db = db;
+    this.entryRepo = entryRepo;
+    this.ontologyService = ontologyService;
+    this.searchService = searchService;
+    this.embeddingService = embeddingService;
+  }
+  async remember(entityId, input) {
+    const now = Date.now();
+    const { fact, validFrom, okfType } = normalizeRememberInput(entityId, input, now);
+    let stored;
+    await this.db.withTransactionAsync(async (tx) => {
+      if (okfType !== null) {
+        const { mode, manifest } = await this.ontologyService.getEffectiveState(entityId, tx);
+        const factLike = { okf_type: okfType, edges: [] };
+        fact.okf_type = this.ontologyService.validateAndNormalizeFact(factLike, manifest, {
+          strict: mode === "strict",
+          entityId
+        }).okf_type;
+      }
+      await this.entryRepo.upsert(fact, tx);
+      if (validFrom !== void 0) {
+        await this.entryRepo.setTemporal(fact.id, entityId, { valid_from: validFrom }, tx);
+      }
+      const [readBack] = await this.entryRepo.findByIds([fact.id], [entityId], tx);
+      if (!readBack) {
+        throw new Error("remember(): the stored fact could not be read back; the SQLiteAdapter did not perform the write");
+      }
+      stored = readBack;
+    });
+    await this.searchService.syncEntries(entityId, [fact.id]);
+    await this.embeddingService.embedFact(
+      { id: fact.id, entity_id: entityId, title: fact.title, body: fact.body, tags: fact.tags },
+      { operation: "remember", trigger: "call" }
+    );
+    this.searchService.evictCache(entityId);
+    return stored;
+  }
+};
+
 // src/WikiMemory.ts
 var TABLE_PREFIX_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,30}_$/;
 var SEARCH_REINIT_COOLDOWN_MS = 5e3;
@@ -11526,6 +11635,7 @@ var WikiMemory = class {
       new MiniSearchIndexStrategy()
     );
     this.temporalService = new TemporalService(this.db, this.options, this.entryRepo, this.searchService, this.embeddingService);
+    this.rememberService = new RememberService(this.db, this.entryRepo, this.ontologyService, this.searchService, this.embeddingService);
     this.jobManager = new JobManager(this.prefix);
     this.promptService = new PromptService(options.config?.prompts, resolveGrounding(options.config?.grounding));
     this.ingestionService = new IngestionService(
@@ -11623,6 +11733,7 @@ var WikiMemory = class {
       promptService: this.promptService,
       graphTraversalService: this.graphTraversalService,
       temporalService: this.temporalService,
+      rememberService: this.rememberService,
       entryRepo: this.entryRepo,
       sourceRefIndexRepo: this.sourceRefIndexRepo,
       metadataRepo: this.metadataRepo,
@@ -11784,7 +11895,7 @@ var WikiMemory = class {
    * in a sparse array), throws a `TypeError` before any SQL runs.
    */
   async pendingSources(entityId, sources) {
-    assertEntityId(entityId);
+    assertEntityId2(entityId);
     if (!Array.isArray(sources)) {
       throw new TypeError("Invalid sources: must be an array of { sourceRef, sourceHash } objects.");
     }
@@ -11816,7 +11927,7 @@ var WikiMemory = class {
   }
   /** Read-only maintenance report for one entity (spec §8.1). Reports, never repairs. */
   async lint(entityId) {
-    assertEntityId(entityId);
+    assertEntityId2(entityId);
     return this.lintService.lint(entityId);
   }
   /**
@@ -11825,7 +11936,7 @@ var WikiMemory = class {
    * overrides are returned verbatim, so keep secrets out of `WikiConfig.prompts`.
    */
   async getInstructions(entityId) {
-    assertEntityId(entityId);
+    assertEntityId2(entityId);
     const ontologyContext = await this.ontologyService.buildPromptContext(entityId);
     return this.promptService.buildInstructionTemplates(ontologyContext);
   }
@@ -12042,7 +12153,7 @@ var WikiMemory = class {
       if (await this.syncDrained(this.searchService.syncStale({ ids }))) this.dropStashedIds(stashed2);
       return;
     }
-    assertEntityId(entityId);
+    assertEntityId2(entityId);
     const stashed = this.peekStashedIds(entityId);
     if (await this.syncDrained(this.searchService.syncEntries(entityId, stashed.get(entityId)?.keys() ?? []))) {
       this.dropStashedIds(stashed);
@@ -12081,6 +12192,23 @@ var WikiMemory = class {
   async history(entityId, factId) {
     return this.temporalService.history(entityId, factId);
   }
+  /**
+   * Store one mutable fact directly, with no LLM step (spec
+   * `specs/core-remember/spec.md`). One transaction; resolves with the stored
+   * row read back (`id`, timestamps, defaults, `isStale`, `trustTier`). Never
+   * starts the librarian or heal and writes no event, in `'auto'` and
+   * `'deferred'` mode alike. Embeds through `llmProvider.embed` when present;
+   * keyword-only otherwise. Not idempotent. To replace an existing fact use
+   * `supersede()` so history is kept. Opens its own transaction: do not call
+   * it inside `withTransactionAsync` (the serialized adapter would deadlock).
+   *
+   * Throws `TypeError` on invalid input and `WikiStrictOntologyViolation` for
+   * an `okf_type` the entity's strict manifest does not define; nothing is
+   * written in either case.
+   */
+  async remember(entityId, input) {
+    return this.rememberService.remember(entityId, input);
+  }
   /**
    * Full and partial ingestion both reject foreign-owned generated fact IDs with
    * `WikiGraphNodeOwnershipConflict`. Such collisions are unexpected. Ingestion
@@ -12349,7 +12477,7 @@ var WikiMemory = class {
 _testAccessNonTestEnvWarned = new WeakMap();
 /** Max upsertGraph node ids held for their post-commit sync (spec #280 id threading). */
 WikiMemory.UPSERT_ID_STASH_CAP = 1e4;
-function assertEntityId(entityId) {
+function assertEntityId2(entityId) {
   if (typeof entityId !== "string" || entityId.length === 0) {
     throw new TypeError("Invalid entityId: must be a non-empty string.");
   }
@@ -12871,7 +12999,7 @@ function formatOkfBundle(dump, options) {
   });
   return { files };
 }
-var CONFIDENCE_VALUES = /* @__PURE__ */ new Set(["certain", "inferred", "tentative"]);
+var CONFIDENCE_VALUES2 = /* @__PURE__ */ new Set(["certain", "inferred", "tentative"]);
 var SOURCE_TYPES = /* @__PURE__ */ new Set([
   "user_stated",
   "librarian_inferred",
@@ -13017,7 +13145,7 @@ function frontmatterToFact(entityId, id, frontmatter, body, now) {
     title: typeof frontmatter.title === "string" ? frontmatter.title : "",
     body,
     tags: Array.isArray(frontmatter.tags) ? frontmatter.tags.filter((t) => typeof t === "string") : [],
-    confidence: CONFIDENCE_VALUES.has(String(frontmatter.confidence)) ? frontmatter.confidence : "tentative",
+    confidence: CONFIDENCE_VALUES2.has(String(frontmatter.confidence)) ? frontmatter.confidence : "tentative",
     source_type: SOURCE_TYPES.has(String(frontmatter.source_type)) ? frontmatter.source_type : "user_stated",
     source_hash: typeof frontmatter.source_hash === "string" ? frontmatter.source_hash : null,
     source_ref: typeof frontmatter.resource === "string" ? frontmatter.resource : null,