@equationalapplications/core-llm-wiki 4.4.0 → 4.5.0

package/dist/index.mjs

@@ -2787,16 +2787,20 @@ function scoreFactFor(fact, weights, now) {
   const recencyDecay = Math.exp(-ageDays / 30);
   return confW * weights.confidence + Math.log(1 + fact.access_count) * weights.accessCount + recencyDecay * weights.recency;
 }
-function renderFactMarkdown(fact, includeConfidence, includeTags) {
+function renderFactMarkdown(fact, includeConfidence, includeTags, includeEntityIds, score) {
   const confPart = includeConfidence ? ` (${fact.confidence})` : "";
   const tagPart = includeTags && fact.tags.length > 0 ? ` [${fact.tags.join(", ")}]` : "";
-  return `- **${fact.title}**${confPart}${tagPart}
+  const sourcePart = includeEntityIds ? ` {entity_id=${fact.entity_id}}` : "";
+  const scorePart = score !== void 0 ? ` {score=${score.toFixed(4)}}` : "";
+  return `- **${fact.title}**${confPart}${tagPart}${sourcePart}${scorePart}
   ${fact.body.replace(/\n/g, "\n  ")}`;
 }
-function renderFactPlain(fact, includeConfidence, includeTags) {
+function renderFactPlain(fact, includeConfidence, includeTags, includeEntityIds, score) {
   const confPart = includeConfidence ? ` (${fact.confidence})` : "";
   const tagPart = includeTags && fact.tags.length > 0 ? ` [${fact.tags.join(", ")}]` : "";
-  return `${fact.title}${confPart}${tagPart}: ${fact.body}`;
+  const sourcePart = includeEntityIds ? ` {entity_id=${fact.entity_id}}` : "";
+  const scorePart = score !== void 0 ? ` {score=${score.toFixed(4)}}` : "";
+  return `${fact.title}${confPart}${tagPart}${sourcePart}${scorePart}: ${fact.body}`;
 }
 function renderTaskMarkdown(task) {
   return `- [P${task.priority}] ${task.description.replace(/\n/g, "\n  ")} (${task.status})`;
@@ -2820,6 +2824,8 @@ function formatContext(bundle, options) {
     maxEvents: options?.maxEvents ?? 10,
     includeConfidence: options?.includeConfidence ?? true,
     includeTags: options?.includeTags ?? true,
+    includeEntityIds: options?.includeEntityIds ?? false,
+    includeFactScores: options?.includeFactScores ?? false,
     factWeights: {
       confidence: options?.factWeights?.confidence ?? 1,
       accessCount: options?.factWeights?.accessCount ?? 0.3,
@@ -2831,7 +2837,7 @@ function formatContext(bundle, options) {
   validateMaxOption(opts.maxEvents, "maxEvents");
   const weights = opts.factWeights;
   const now = Date.now();
-  const sortedFacts = [...bundle.facts].sort((a, b) => scoreFactFor(b, weights, now) - scoreFactFor(a, weights, now)).slice(0, opts.maxFacts);
+  const sortedFacts = bundle.factScores ? [...bundle.facts].slice(0, opts.maxFacts) : [...bundle.facts].sort((a, b) => scoreFactFor(b, weights, now) - scoreFactFor(a, weights, now)).slice(0, opts.maxFacts);
   const sortedTasks = [...bundle.tasks].sort((a, b) => b.priority - a.priority || a.created_at - b.created_at).slice(0, opts.maxTasks);
   const sortedEvents = [...bundle.events].sort((a, b) => b.created_at - a.created_at).slice(0, opts.maxEvents);
   if (sortedFacts.length === 0 && sortedTasks.length === 0 && sortedEvents.length === 0) {
@@ -2845,7 +2851,7 @@ function formatContext(bundle, options) {
       lines.push("");
       lines.push("### Known Facts");
       for (const fact of sortedFacts) {
-        lines.push(renderFactMarkdown(fact, opts.includeConfidence, opts.includeTags));
+        lines.push(renderFactMarkdown(fact, opts.includeConfidence, opts.includeTags, opts.includeEntityIds, opts.includeFactScores ? bundle.factScores?.[fact.id] : void 0));
       }
     }
     if (sortedTasks.length > 0) {
@@ -2866,7 +2872,7 @@ function formatContext(bundle, options) {
     if (sortedFacts.length > 0) {
       lines.push("KNOWN FACTS:");
       for (const fact of sortedFacts) {
-        lines.push(renderFactPlain(fact, opts.includeConfidence, opts.includeTags));
+        lines.push(renderFactPlain(fact, opts.includeConfidence, opts.includeTags, opts.includeEntityIds, opts.includeFactScores ? bundle.factScores?.[fact.id] : void 0));
       }
     }
     if (sortedTasks.length > 0) {
@@ -2985,11 +2991,50 @@ function formatMemoryDump(dump) {
   };
 }
 
+// src/librarianPrompt.ts
+var DEFAULT_LIBRARIAN_SYNTHESIS_PROMPT = `You are a careful memory synthesis assistant.
+Use only the retrieved context when answering the request.
+Preserve source provenance when facts come from different entity namespaces.
+
+Request:
+{{query}}
+
+Retrieved context:
+{{context}}
+
+Open tasks:
+{{tasks}}`;
+function hydrateLibrarianPrompt(template, variables) {
+  return template.replace(/\{\{(context|tasks|query)\}\}/g, (_, key) => variables[key]);
+}
+function validateLibrarianPromptTemplate(template, options) {
+  if (!options.custom) return [];
+  const warnings = [];
+  if (!template.includes("{{context}}")) {
+    warnings.push("Custom Librarian systemPrompt omits {{context}}; retrieved memory will not be injected.");
+  }
+  if (!template.includes("{{query}}")) {
+    warnings.push("Custom Librarian systemPrompt omits {{query}}; the original request will not be injected.");
+  }
+  if (options.taskCount > 0 && !template.includes("{{tasks}}")) {
+    warnings.push("Custom Librarian systemPrompt omits {{tasks}} while retrieved tasks are available.");
+  }
+  return warnings;
+}
+function mapLibrarianOptionsToReadOptions(options) {
+  const readOptions = {};
+  if (options.entityWeights !== void 0) readOptions.tierWeights = options.entityWeights;
+  if (options.includeZeroWeightEntities !== void 0) {
+    readOptions.includeZeroWeightEntities = options.includeZeroWeightEntities;
+  }
+  return readOptions;
+}
+
 // src/index.ts
 function createWiki(db, options) {
   return new WikiMemory(db, options);
 }
 
-export { PrunePartialFailureError, WikiBusyError, WikiMemory, createWiki, formatContext, formatMemoryDump, parseEmbedding };
+export { DEFAULT_LIBRARIAN_SYNTHESIS_PROMPT, PrunePartialFailureError, WikiBusyError, WikiMemory, createWiki, formatContext, formatMemoryDump, hydrateLibrarianPrompt, mapLibrarianOptionsToReadOptions, parseEmbedding, validateLibrarianPromptTemplate };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map