@securecoms/agent-runtime 0.10.0 → 0.11.0

package/dist/bin.js

@@ -1782,10 +1782,12 @@ function buildLlmShim(cfg, explicit, deps) {
 // src/memory.ts
 var MAX_HISTORY = 50;
 var MAX_FACTS = 200;
+var CONTROL_CHARS = /[\p{Cc}\u2028\u2029]/gu;
 var AgentMemory = class {
   history = [];
   facts = [];
   notes = "";
+  recallItems = [];
   constructor(snapshot) {
     if (snapshot) this.replace(snapshot);
   }
@@ -1797,6 +1799,7 @@ var AgentMemory = class {
     }));
     this.facts = snapshot.facts.slice(-MAX_FACTS);
     this.notes = typeof snapshot.notes === "string" ? snapshot.notes : "";
+    this.recallItems = Array.isArray(snapshot.recall) ? snapshot.recall : [];
   }
   /** The bridge-rendered notes document for the current turn, or "". Data, never instructions. */
   getNotes() {
@@ -1818,12 +1821,19 @@ var AgentMemory = class {
     this.history = [];
     this.facts = [];
     this.notes = "";
+    this.recallItems = [];
+  }
+  /** How many semantic recall items this turn's view renders. */
+  recallCount() {
+    return this.recallItems.length;
   }
   /** Case-insensitive keyword-overlap recall over protected channel facts. */
   async recall(query) {
     const queryWords = query.toLowerCase().split(/\W+/).filter((word) => word.length >= 3);
-    if (queryWords.length === 0) return null;
-    const scored = this.facts.map((content) => {
+    const semantic = this.recallItems.map(
+      (r) => `- [r${r.id}] (${new Date(r.sent_at).toISOString().slice(0, 10)}) ${r.text.replace(CONTROL_CHARS, " ")}`
+    );
+    const scored = queryWords.length === 0 ? [] : this.facts.map((content) => {
       const contentLower = content.toLowerCase();
       const score = queryWords.reduce(
         (acc, word) => contentLower.includes(word) ? acc + 1 : acc,
@@ -1831,9 +1841,10 @@ var AgentMemory = class {
       );
       return { content, score };
     }).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score).slice(0, 5);
-    if (scored.length === 0) return null;
+    const lines = [...semantic, ...scored.map((entry) => `- ${entry.content.replace(CONTROL_CHARS, " ")}`)];
+    if (lines.length === 0) return null;
     return `Relevant context from memory:
-${scored.map((entry) => `- ${entry.content}`).join("\n")}`;
+${lines.join("\n")}`;
   }
 };
 
@@ -3675,9 +3686,25 @@ function createStatusReporter(log, fetchImpl = fetch) {
 var NO_TURN_MEMORY = Object.freeze({
   recent: Object.freeze([]),
   facts: Object.freeze([]),
-  notes: ""
+  notes: "",
+  recall: Object.freeze([])
 });
 var NOTES_MAX_CHARS = 8e3;
+function parseRecall(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+  const r = value.recall;
+  if (!Array.isArray(r)) return [];
+  const out = [];
+  for (const x of r.slice(0, 5)) {
+    if (!x || typeof x !== "object" || Array.isArray(x)) return [];
+    const { id, text, sent_at } = x;
+    if (typeof id !== "number" || !Number.isSafeInteger(id) || id < 1) return [];
+    if (typeof text !== "string" || text.length > 600) return [];
+    if (typeof sent_at !== "number" || !Number.isSafeInteger(sent_at) || sent_at < 0 || sent_at > 864e13) return [];
+    out.push(Object.freeze({ id, text, sent_at }));
+  }
+  return Object.freeze(out);
+}
 function parseNotes(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return "";
   const n = value.notes;
@@ -3701,12 +3728,13 @@ function parseRecentAndFacts(value) {
     if (typeof fact !== "string") return NO_TURN_MEMORY;
     facts.push(fact);
   }
-  return Object.freeze({ recent: Object.freeze(recent), facts: Object.freeze(facts), notes: "" });
+  return Object.freeze({ recent: Object.freeze(recent), facts: Object.freeze(facts), notes: "", recall: Object.freeze([]) });
 }
 function parseTurnMemory(value) {
   const base = parseRecentAndFacts(value);
   const notes = parseNotes(value);
-  return notes === "" ? base : Object.freeze({ ...base, notes });
+  const recall = parseRecall(value);
+  return notes === "" && recall.length === 0 ? base : Object.freeze({ ...base, notes, recall });
 }
 var AUDIENCES = /* @__PURE__ */ new Set([
   "owner_dm",
@@ -3724,9 +3752,10 @@ var NO_TURN_AUTHORIZATION = Object.freeze({
 });
 var PER_TOOL_GRANTS_FEATURE = "per_tool_grants";
 var MEMORY_NOTES_FEATURE = "memory_notes";
+var MEMORY_RECALL_FEATURE = "memory_recall";
 var MEMORY_NOTE_TIMEOUT_MS = 1e4;
 function runtimeHelloFrame() {
-  return { type: "hello", features: ["nack", PER_TOOL_GRANTS_FEATURE, MEMORY_NOTES_FEATURE] };
+  return { type: "hello", features: ["nack", PER_TOOL_GRANTS_FEATURE, MEMORY_NOTES_FEATURE, MEMORY_RECALL_FEATURE] };
 }
 function parseTurnAuthorization(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return NO_TURN_AUTHORIZATION;
@@ -4336,13 +4365,13 @@ var MEMORY_NOTE_TOOL = {
   type: "function",
   function: {
     name: MEMORY_NOTE,
-    description: "Save, change or delete one short note in this chat's saved notes. Save only what the owner asked you to keep. `text` must be copied word for word from the owner's CURRENT message (a contiguous part of it is fine). You cannot save something said earlier, said in a call, found by a tool, or your own summary. If the owner asks you to remember something from earlier, ask them to type it in one short message. Never store credentials, keys or passwords. To change or delete a note, pass its id: [n7] is id 7.",
+    description: "Save, change or delete one short note in this chat's saved notes. Save only what the owner asked you to keep. First check the saved notes already shown to you: if the fact is already saved, do not call this tool; just tell the owner it is already remembered. `text` must be copied word for word from the owner's CURRENT message (a contiguous part of it is fine). You cannot save something said earlier, said in a call, found by a tool, or your own summary. If the owner asks you to remember something from earlier, ask them to type it in one short message. Never store credentials, keys or passwords. To change or delete a note, pass its id: [n7] is id 7. To forget a remembered message shown to you as [r12], pass op forget with id \"r12\". You can make only one change (replace or forget) per owner message: One change per message. Ask the owner to confirm the next one.",
     parameters: {
       type: "object",
       properties: {
         op: { type: "string", enum: ["add", "replace", "forget"] },
         text: { type: "string" },
-        id: { type: "integer", minimum: 1 }
+        id: { anyOf: [{ type: "integer", minimum: 1 }, { type: "string", pattern: "^r[1-9][0-9]*$" }] }
       },
       required: ["op"],
       additionalProperties: false
@@ -4360,6 +4389,10 @@ var REFUSAL = {
   cap: "Not saved. The notes are full or the note is too long. Replace or forget older notes first.",
   audience: "Not saved. Notes can be saved only from the owner's own typed message in their private chat.",
   cleared: "Not saved. The owner cleared the notes after this message arrived.",
+  // [COPY] spec 7b §9.1.
+  budget: "One change per message. Ask the owner to confirm the next one.",
+  // [COPY, NEW] Gate: Eric sign-off before npm publish (release PR). The bridge emits it when the chat's memory was purged after the write was queued.
+  purged: "Not saved. This chat's memory was removed after this message arrived.",
   mode: "Not saved. Notes are turned off for this agent right now."
 };
 function parseArgs(raw) {
@@ -4375,7 +4408,11 @@ function parseArgs(raw) {
   const text = typeof a.text === "string" && a.text.length > 0 ? a.text : void 0;
   if (a.op === "add" && text !== void 0 && a.id === void 0) return { op: "add", text };
   if (a.op === "replace" && text !== void 0 && id !== void 0) return { op: "replace", text, id };
-  if (a.op === "forget" && id !== void 0 && a.text === void 0) return { op: "forget", id };
+  const recallId = typeof a.id === "string" && /^r[1-9][0-9]{0,15}$/.test(a.id) && Number.isSafeInteger(Number(a.id.slice(1))) ? a.id : void 0;
+  if (a.op === "forget" && a.text === void 0) {
+    if (id !== void 0) return { op: "forget", id };
+    if (recallId !== void 0) return { op: "forget", id: recallId };
+  }
   return null;
 }
 async function runMemoryNoteCalls(calls, m, ctx = {}) {
@@ -4967,6 +5004,8 @@ ${notesLines.slice(0, k).join("\n")}` };
       history_messages: history.length - historyStart,
       history_dropped: historyStart,
       recalled: keepRecalled,
+      recall_items: memory.recallCount(),
+      recall_kept: keepRecalled ? memory.recallCount() : 0,
       tools_offered: tools.length,
       // Counts only: the tools this runtime loaded, and the grants the bridge
       // sent. tools_offered=0 with grants=0 points at the bridge decision;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@securecoms/agent-runtime",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "bin": {
     "securecoms-agent": "dist/bin.js"