agenr 2.1.0 → 3.0.0

package/dist/{chunk-IMQIJPIP.js → chunk-575MUIW5.js}

@@ -1,10 +1,10 @@
 import {
   projectClaimCentricRecallEntry,
   runProcedureRecall
-} from "./chunk-7TDALVPY.js";
+} from "./chunk-ELR2HSVC.js";
 import {
   recall
-} from "./chunk-6T5RXGIR.js";
+} from "./chunk-5LADPJ4C.js";
 
 // src/app/before-turn/service.ts
 var DEFAULT_MAX_DURABLE_ENTRIES = 1;
@@ -764,7 +764,194 @@ function formatErrorMessage(error) {
   return String(error);
 }
 
-// src/adapters/openclaw/format/memory-context.ts
+// src/adapters/shared/memory-tool-format.ts
+var DEFAULT_RECALL_LIMIT = 10;
+var RESULT_SUBJECT_LOG_LIMIT = 5;
+function truncate2(value, maxChars) {
+  if (value.length <= maxChars) {
+    return value;
+  }
+  return `${value.slice(0, maxChars - 3).trimEnd()}...`;
+}
+function sanitizeStoreToolParams(params) {
+  return {
+    type: params.type,
+    subject: params.subject,
+    ...params.importance !== void 0 ? { importance: params.importance } : {},
+    ...params.expiry !== void 0 ? { expiry: params.expiry } : {},
+    ...params.tags.length > 0 ? { tags: params.tags } : {},
+    contentLength: params.content.length,
+    ...params.sourceContext !== void 0 ? { sourceContextLength: params.sourceContext.length } : {},
+    ...params.supersedes !== void 0 ? { hasSupersedes: true } : {},
+    ...params.claimKey !== void 0 ? { hasClaimKey: true } : {},
+    ...params.validFrom !== void 0 ? { hasValidFrom: true } : {},
+    ...params.validTo !== void 0 ? { hasValidTo: true } : {}
+  };
+}
+function formatRecallToolSummary(params) {
+  const parts = [`query=${JSON.stringify(truncate2(params.query, 80))}`];
+  if (params.mode) {
+    parts.push(`mode=${params.mode}`);
+  }
+  if (params.limit !== void 0 && params.limit !== DEFAULT_RECALL_LIMIT) {
+    parts.push(`limit=${params.limit}`);
+  }
+  if (params.types.length > 0) {
+    parts.push(`types=${JSON.stringify(params.types)}`);
+  }
+  if (params.tags.length > 0) {
+    parts.push(`tags=${JSON.stringify(params.tags)}`);
+  }
+  if (params.asOf) {
+    parts.push(`as_of=${JSON.stringify(params.asOf)}`);
+  }
+  return parts.join(" ");
+}
+function sanitizeRecallToolParams(params) {
+  return {
+    query: params.query,
+    ...params.mode ? { mode: params.mode } : {},
+    ...params.limit !== void 0 ? { limit: params.limit } : {},
+    ...params.threshold !== void 0 ? { threshold: params.threshold } : {},
+    ...params.types.length > 0 ? { types: params.types } : {},
+    ...params.tags.length > 0 ? { tags: params.tags } : {},
+    ...params.asOf ? { asOf: params.asOf } : {}
+  };
+}
+function formatUnifiedRecallLogSummary(result) {
+  const procedureCount = result.procedureCandidates.length;
+  const procedureSummary = result.procedure ? ` [procedure: ${JSON.stringify(truncate2(result.procedure.title, 80))}]` : "";
+  const entrySubjects = result.entries.map((entry) => entry.entry.subject.trim()).filter((subject) => subject.length > 0);
+  const displayed = entrySubjects.slice(0, RESULT_SUBJECT_LOG_LIMIT).map((subject) => JSON.stringify(truncate2(subject, 80)));
+  const remaining = entrySubjects.length - RESULT_SUBJECT_LOG_LIMIT;
+  const suffix = displayed.length === 0 ? "" : ` [entry subjects: ${displayed.join(", ")}${remaining > 0 ? `, ... and ${remaining} more` : ""}]`;
+  const entryEpisodeSummary = `${result.episodes.length} episode${result.episodes.length === 1 ? "" : "s"}, ${result.entries.length} entr${result.entries.length === 1 ? "y" : "ies"}`;
+  if (procedureCount === 0 && !result.procedure) {
+    return `${entryEpisodeSummary}${suffix}`;
+  }
+  return `${procedureCount} procedure candidate${procedureCount === 1 ? "" : "s"}, ${entryEpisodeSummary}${procedureSummary}${suffix}`;
+}
+function buildRecallToolDetails(result, extraDetails = {}) {
+  return {
+    status: "ok",
+    count: result.count,
+    ...extraDetails,
+    routing: {
+      requested: result.routing.requested,
+      detectedIntent: result.routing.detectedIntent,
+      queried: result.routing.queried,
+      reason: result.routing.reason
+    },
+    ...result.asOf ? { asOf: result.asOf } : {},
+    ...result.timeWindow ? { timeWindow: result.timeWindow } : {},
+    ...result.procedure ? {
+      procedure: {
+        id: result.procedure.id,
+        procedureKey: result.procedure.procedure_key,
+        title: result.procedure.title,
+        goal: result.procedure.goal
+      }
+    } : {},
+    procedures: result.procedureCandidates.map((candidate) => ({
+      id: candidate.procedure.id,
+      procedureKey: candidate.procedure.procedure_key,
+      title: candidate.procedure.title,
+      goal: candidate.procedure.goal,
+      score: candidate.score,
+      lexicalScore: candidate.scores.lexical,
+      vectorScore: candidate.scores.vector
+    })),
+    procedureNotices: result.procedureNotices,
+    episodes: result.episodes.map((episode) => ({
+      id: episode.episode.id,
+      source: episode.episode.source,
+      sourceId: episode.episode.sourceId,
+      startedAt: episode.episode.startedAt,
+      endedAt: episode.episode.endedAt,
+      tags: episode.episode.tags,
+      score: episode.score,
+      activityLevel: episode.episode.activityLevel,
+      summary: episode.episode.summary,
+      whyMatched: describeEpisodeWhyMatched(episode.scores.semantic, episode.scores.temporal)
+    })),
+    entries: result.entries.map((entry) => ({
+      id: entry.entry.id,
+      subject: entry.entry.subject,
+      type: entry.entry.type,
+      expiry: entry.entry.expiry,
+      importance: entry.entry.importance,
+      score: entry.score,
+      tags: entry.entry.tags,
+      content: entry.entry.content
+    })),
+    projectedEntries: result.projectedEntries.map((entry) => ({
+      id: entry.entryId,
+      familyKey: entry.familyKey,
+      claimKey: entry.claimKey,
+      slotPolicy: entry.slotPolicy,
+      memoryState: entry.memoryState,
+      claimStatus: entry.claimStatus,
+      freshness: entry.freshness,
+      provenance: entry.provenance,
+      whySurfaced: entry.whySurfaced
+    })),
+    entryFamilies: result.entryFamilies.map((family) => ({
+      familyKey: family.familyKey,
+      claimKey: family.claimKey,
+      slotPolicy: family.slotPolicy,
+      subject: family.subject,
+      primaryEntryId: family.primary.entryId,
+      entries: family.entries.map((entry) => ({
+        id: entry.entryId,
+        memoryState: entry.memoryState,
+        claimStatus: entry.claimStatus
+      }))
+    })),
+    claimTransitions: result.claimTransitions,
+    notices: result.notices
+  };
+}
+function describeEpisodeWhyMatched(semanticScore, temporalScore) {
+  if (semanticScore > 0 && temporalScore > 0) {
+    return "Semantic match within the resolved time window.";
+  }
+  if (semanticScore > 0) {
+    return "Semantic match to the episode summary.";
+  }
+  if (temporalScore > 0) {
+    return "Session overlaps the resolved time window.";
+  }
+  return "Matched episodic recall ranking.";
+}
+
+// src/adapters/shared/injection/entry-lines.ts
+var MAX_CONTENT_CHARS = 220;
+function formatInjectionEntryHeader(item) {
+  const metadata = [
+    `rank ${item.rank}`,
+    item.entry.id,
+    item.entry.type,
+    item.entry.expiry,
+    `importance ${item.entry.importance}`,
+    item.score !== void 0 ? `score ${item.score.toFixed(2)}` : void 0
+  ].filter((value) => value !== void 0);
+  return `- [${metadata.join(" | ")}] ${item.entry.subject}`;
+}
+function formatInjectionEntryBodyLines(item) {
+  const lines = [`  ${truncate2(item.entry.content.trim(), MAX_CONTENT_CHARS)}`];
+  lines.push(`  why: ${item.whySurfaced.summary}`);
+  const metadata = [
+    item.entry.tags.length > 0 ? `tags: ${item.entry.tags.join(", ")}` : void 0,
+    item.freshnessLabel ? `freshness: ${item.freshnessLabel}` : void 0,
+    item.provenanceSummary ? `provenance: ${truncate2(item.provenanceSummary, MAX_CONTENT_CHARS)}` : void 0
+  ].filter((value) => value !== void 0);
+  if (metadata.length > 0) {
+    lines.push(`  ${metadata.join(" | ")}`);
+  }
+  return lines;
+}
+
+// src/adapters/shared/injection/memory-context.ts
 var AGENR_MEMORY_CONTEXT_BLOCK_RE = /<agenr-memory-context>[\s\S]*?<\/agenr-memory-context>/giu;
 var AGENR_MEMORY_CONTEXT_OPEN_RE = /<agenr-memory-context>/giu;
 var AGENR_MEMORY_CONTEXT_CLOSE_RE = /<\/agenr-memory-context>/giu;
@@ -786,8 +973,8 @@ function stripAgenrMemoryContext(content) {
   return content.replace(AGENR_MEMORY_CONTEXT_BLOCK_RE, " ").replace(AGENR_MEMORY_CONTEXT_OPEN_RE, " ").replace(AGENR_MEMORY_CONTEXT_CLOSE_RE, " ").replace(AGENR_MEMORY_CONTEXT_NOTE_RE, " ");
 }
 
-// src/adapters/openclaw/format/before-turn-format.ts
-var MAX_CONTENT_CHARS = 220;
+// src/adapters/shared/injection/before-turn-format.ts
+var MAX_CONTENT_CHARS2 = 220;
 function formatAgenrBeforeTurnRecall(patch) {
   if (patch.durableMemory.length === 0 && !patch.procedure) {
     return "";
@@ -800,8 +987,8 @@ function formatAgenrBeforeTurnRecall(patch) {
   if (patch.durableMemory.length > 0) {
     lines.push("### Relevant Durable Memory");
     for (const item of patch.durableMemory) {
-      lines.push(formatEntryHeader(item));
-      lines.push(...formatEntryBodyLines(item));
+      lines.push(formatInjectionEntryHeader(item));
+      lines.push(...formatInjectionEntryBodyLines(item));
     }
     lines.push("");
   }
@@ -813,30 +1000,6 @@ function formatAgenrBeforeTurnRecall(patch) {
   }
   return wrapAgenrMemoryContext(lines.join("\n").trim());
 }
-function formatEntryHeader(item) {
-  const metadata = [
-    `rank ${item.rank}`,
-    item.entry.id,
-    item.entry.type,
-    item.entry.expiry,
-    `importance ${item.entry.importance}`,
-    `score ${item.score.toFixed(2)}`
-  ];
-  return `- [${metadata.join(" | ")}] ${item.entry.subject}`;
-}
-function formatEntryBodyLines(item) {
-  const lines = [`  ${truncate2(item.entry.content.trim(), MAX_CONTENT_CHARS)}`];
-  lines.push(`  why: ${item.whySurfaced.summary}`);
-  const metadata = [
-    item.entry.tags.length > 0 ? `tags: ${item.entry.tags.join(", ")}` : void 0,
-    item.freshnessLabel ? `freshness: ${item.freshnessLabel}` : void 0,
-    item.provenanceSummary ? `provenance: ${truncate2(item.provenanceSummary, MAX_CONTENT_CHARS)}` : void 0
-  ].filter((value) => value !== void 0);
-  if (metadata.length > 0) {
-    lines.push(`  ${metadata.join(" | ")}`);
-  }
-  return lines;
-}
 function formatProcedureHeader(suggestion) {
   const metadata = [
     suggestion.procedure.id,
@@ -848,39 +1011,29 @@ function formatProcedureHeader(suggestion) {
   return `- [${metadata.join(" | ")}] ${suggestion.procedure.title}`;
 }
 function formatProcedureBodyLines(suggestion) {
-  const lines = [`  goal: ${truncate2(suggestion.procedure.goal.trim(), MAX_CONTENT_CHARS)}`];
+  const lines = [`  goal: ${truncate2(suggestion.procedure.goal.trim(), MAX_CONTENT_CHARS2)}`];
   lines.push(`  why: ${suggestion.whySurfaced.summary}`);
   if (suggestion.procedure.when_to_use.length > 0) {
-    lines.push(`  when to use: ${truncate2(suggestion.procedure.when_to_use.join("; "), MAX_CONTENT_CHARS)}`);
+    lines.push(`  when to use: ${truncate2(suggestion.procedure.when_to_use.join("; "), MAX_CONTENT_CHARS2)}`);
   }
   if (suggestion.procedure.verification.length > 0) {
-    lines.push(`  verification: ${truncate2(suggestion.procedure.verification.join("; "), MAX_CONTENT_CHARS)}`);
+    lines.push(`  verification: ${truncate2(suggestion.procedure.verification.join("; "), MAX_CONTENT_CHARS2)}`);
   }
   return lines;
 }
-function truncate2(value, maxChars) {
-  if (value.length <= maxChars) {
-    return value;
-  }
-  return `${value.slice(0, maxChars - 3).trimEnd()}...`;
-}
-
-// src/app/debug-artifacts/before-turn.ts
-var BEFORE_TURN_DEBUG_ARTIFACT_DEFAULT_TOP_K = 10;
-var BEFORE_TURN_DEBUG_ARTIFACT_MAX_TOP_K = 25;
-
-// src/app/debug-artifacts/recall.ts
-var RECALL_DEBUG_ARTIFACT_DEFAULT_TOP_K = 10;
-var RECALL_DEBUG_ARTIFACT_MAX_TOP_K = 25;
 
 export {
   runBeforeTurn,
+  truncate2 as truncate,
+  sanitizeStoreToolParams,
+  formatRecallToolSummary,
+  sanitizeRecallToolParams,
+  formatUnifiedRecallLogSummary,
+  buildRecallToolDetails,
+  formatInjectionEntryHeader,
+  formatInjectionEntryBodyLines,
   wrapAgenrMemoryContext,
   containsAgenrMemoryContext,
   stripAgenrMemoryContext,
-  formatAgenrBeforeTurnRecall,
-  BEFORE_TURN_DEBUG_ARTIFACT_DEFAULT_TOP_K,
-  BEFORE_TURN_DEBUG_ARTIFACT_MAX_TOP_K,
-  RECALL_DEBUG_ARTIFACT_DEFAULT_TOP_K,
-  RECALL_DEBUG_ARTIFACT_MAX_TOP_K
+  formatAgenrBeforeTurnRecall
 };