@arkimedehq/openclaw-recordare 0.1.0 → 0.2.0

package/dist/index.js

@@ -97,7 +97,7 @@ var require_code = __commonJS({
     }
     exports._ = _;
     var plus = new _Code("+");
-    function str2(strs, ...args) {
+    function str3(strs, ...args) {
       const expr = [safeStringify(strs[0])];
       let i = 0;
       while (i < args.length) {
@@ -108,7 +108,7 @@ var require_code = __commonJS({
       optimize(expr);
       return new _Code(expr);
     }
-    exports.str = str2;
+    exports.str = str3;
     function addCodeArg(code, arg) {
       if (arg instanceof _Code)
         code.push(...arg._items);
@@ -151,7 +151,7 @@ var require_code = __commonJS({
       return;
     }
     function strConcat(c1, c2) {
-      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str2`${c1}${c2}`;
+      return c2.emptyStr() ? c1 : c1.emptyStr() ? c2 : str3`${c1}${c2}`;
     }
     exports.strConcat = strConcat;
     function interpolate(x) {
@@ -865,12 +865,12 @@ var require_codegen = __commonJS({
       }
       // `for-in` statement.
       // With option `ownProperties` replaced with a `for-of` loop for object keys
-      forIn(nameOrPrefix, obj2, forBody, varKind = this.opts.es5 ? scope_1.varKinds.var : scope_1.varKinds.const) {
+      forIn(nameOrPrefix, obj, forBody, varKind = this.opts.es5 ? scope_1.varKinds.var : scope_1.varKinds.const) {
         if (this.opts.ownProperties) {
-          return this.forOf(nameOrPrefix, (0, code_1._)`Object.keys(${obj2})`, forBody);
+          return this.forOf(nameOrPrefix, (0, code_1._)`Object.keys(${obj})`, forBody);
         }
         const name = this._scope.toName(nameOrPrefix);
-        return this._for(new ForIter("in", varKind, name, obj2), () => forBody(name));
+        return this._for(new ForIter("in", varKind, name, obj), () => forBody(name));
       }
       // end `for` loop
       endFor() {
@@ -1113,22 +1113,22 @@ var require_util = __commonJS({
       return (0, codegen_1._)`${topSchemaRef}${schemaPath}${(0, codegen_1.getProperty)(keyword)}`;
     }
     exports.schemaRefOrVal = schemaRefOrVal;
-    function unescapeFragment(str2) {
-      return unescapeJsonPointer(decodeURIComponent(str2));
+    function unescapeFragment(str3) {
+      return unescapeJsonPointer(decodeURIComponent(str3));
     }
     exports.unescapeFragment = unescapeFragment;
-    function escapeFragment(str2) {
-      return encodeURIComponent(escapeJsonPointer(str2));
+    function escapeFragment(str3) {
+      return encodeURIComponent(escapeJsonPointer(str3));
     }
     exports.escapeFragment = escapeFragment;
-    function escapeJsonPointer(str2) {
-      if (typeof str2 == "number")
-        return `${str2}`;
-      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPointer(str3) {
+      if (typeof str3 == "number")
+        return `${str3}`;
+      return str3.replace(/~/g, "~0").replace(/\//g, "~1");
     }
     exports.escapeJsonPointer = escapeJsonPointer;
-    function unescapeJsonPointer(str2) {
-      return str2.replace(/~1/g, "/").replace(/~0/g, "~");
+    function unescapeJsonPointer(str3) {
+      return str3.replace(/~1/g, "/").replace(/~0/g, "~");
     }
     exports.unescapeJsonPointer = unescapeJsonPointer;
     function eachItem(xs, f) {
@@ -2153,8 +2153,8 @@ var require_json_schema_traverse = __commonJS({
         post(schema, jsonPtr, rootSchema, parentJsonPtr, parentKeyword, parentSchema, keyIndex);
       }
     }
-    function escapeJsonPtr(str2) {
-      return str2.replace(/~/g, "~0").replace(/\//g, "~1");
+    function escapeJsonPtr(str3) {
+      return str3.replace(/~/g, "~0").replace(/\//g, "~1");
     }
   }
 });
@@ -2690,11 +2690,11 @@ var require_validate = __commonJS({
         if (!this.allErrors)
           this.gen.if(cond);
       }
-      setParams(obj2, assign) {
+      setParams(obj, assign) {
         if (assign)
-          Object.assign(this.params, obj2);
+          Object.assign(this.params, obj);
         else
-          this.params = obj2;
+          this.params = obj;
       }
       block$data(valid, codeBlock, $dataValid = codegen_1.nil) {
         this.gen.block(() => {
@@ -3251,10 +3251,10 @@ var require_utils = __commonJS({
         isIPV6: true
       };
     }
-    function findToken(str2, token) {
+    function findToken(str3, token) {
       let ind = 0;
-      for (let i = 0; i < str2.length; i++) {
-        if (str2[i] === token) ind++;
+      for (let i = 0; i < str3.length; i++) {
+        if (str3[i] === token) ind++;
       }
       return ind;
     }
@@ -4268,7 +4268,7 @@ var require_core = __commonJS({
     var util_1 = require_util();
     var $dataRefSchema = require_data();
     var uri_1 = require_uri();
-    var defaultRegExp = (str2, flags) => new RegExp(str2, flags);
+    var defaultRegExp = (str3, flags) => new RegExp(str3, flags);
     defaultRegExp.code = "new RegExp";
     var META_IGNORE_OPTIONS = ["removeAdditional", "useDefaults", "coerceTypes"];
     var EXT_SCOPE_NAMES = /* @__PURE__ */ new Set([
@@ -5063,16 +5063,16 @@ var require_ucs2length = __commonJS({
   "../../packages/client/node_modules/ajv/dist/runtime/ucs2length.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    function ucs2length(str2) {
-      const len = str2.length;
+    function ucs2length(str3) {
+      const len = str3.length;
       let length = 0;
       let pos = 0;
       let value;
       while (pos < len) {
         length++;
-        value = str2.charCodeAt(pos++);
+        value = str3.charCodeAt(pos++);
         if (value >= 55296 && value <= 56319 && pos < len) {
-          value = str2.charCodeAt(pos);
+          value = str3.charCodeAt(pos);
           if ((value & 64512) === 56320)
             pos++;
         }
@@ -6955,8 +6955,8 @@ var require_formats = __commonJS({
     }
     var DATE = /^(\d\d\d\d)-(\d\d)-(\d\d)$/;
     var DAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-    function date4(str2) {
-      const matches = DATE.exec(str2);
+    function date4(str3) {
+      const matches = DATE.exec(str3);
       if (!matches)
         return false;
       const year = +matches[1];
@@ -6975,8 +6975,8 @@ var require_formats = __commonJS({
     }
     var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
     function getTime(strictTimeZone) {
-      return function time3(str2) {
-        const matches = TIME.exec(str2);
+      return function time3(str3) {
+        const matches = TIME.exec(str3);
         if (!matches)
           return false;
         const hr = +matches[1];
@@ -7022,8 +7022,8 @@ var require_formats = __commonJS({
     var DATE_TIME_SEPARATOR = /t|\s/i;
     function getDateTime(strictTimeZone) {
       const time3 = getTime(strictTimeZone);
-      return function date_time(str2) {
-        const dateTime = str2.split(DATE_TIME_SEPARATOR);
+      return function date_time(str3) {
+        const dateTime = str3.split(DATE_TIME_SEPARATOR);
         return dateTime.length === 2 && date4(dateTime[0]) && time3(dateTime[1]);
       };
     }
@@ -7048,13 +7048,13 @@ var require_formats = __commonJS({
     }
     var NOT_URI_FRAGMENT = /\/|:/;
     var URI = /^(?:[a-z][a-z0-9+\-.]*:)(?:\/?\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:]|%[0-9a-f]{2})*@)?(?:\[(?:(?:(?:(?:[0-9a-f]{1,4}:){6}|::(?:[0-9a-f]{1,4}:){5}|(?:[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){4}|(?:(?:[0-9a-f]{1,4}:){0,1}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){3}|(?:(?:[0-9a-f]{1,4}:){0,2}[0-9a-f]{1,4})?::(?:[0-9a-f]{1,4}:){2}|(?:(?:[0-9a-f]{1,4}:){0,3}[0-9a-f]{1,4})?::[0-9a-f]{1,4}:|(?:(?:[0-9a-f]{1,4}:){0,4}[0-9a-f]{1,4})?::)(?:[0-9a-f]{1,4}:[0-9a-f]{1,4}|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?))|(?:(?:[0-9a-f]{1,4}:){0,5}[0-9a-f]{1,4})?::[0-9a-f]{1,4}|(?:(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4})?::)|[Vv][0-9a-f]+\.[a-z0-9\-._~!$&'()*+,;=:]+)\]|(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)|(?:[a-z0-9\-._~!$&'()*+,;=]|%[0-9a-f]{2})*)(?::\d*)?(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*|\/(?:(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)?|(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})+(?:\/(?:[a-z0-9\-._~!$&'()*+,;=:@]|%[0-9a-f]{2})*)*)(?:\?(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?(?:#(?:[a-z0-9\-._~!$&'()*+,;=:@/?]|%[0-9a-f]{2})*)?$/i;
-    function uri(str2) {
-      return NOT_URI_FRAGMENT.test(str2) && URI.test(str2);
+    function uri(str3) {
+      return NOT_URI_FRAGMENT.test(str3) && URI.test(str3);
     }
     var BYTE = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/gm;
-    function byte(str2) {
+    function byte(str3) {
       BYTE.lastIndex = 0;
-      return BYTE.test(str2);
+      return BYTE.test(str3);
     }
     var MIN_INT32 = -(2 ** 31);
     var MAX_INT32 = 2 ** 31 - 1;
@@ -7068,11 +7068,11 @@ var require_formats = __commonJS({
       return true;
     }
     var Z_ANCHOR = /[^\\]\\Z/;
-    function regex(str2) {
-      if (Z_ANCHOR.test(str2))
+    function regex(str3) {
+      if (Z_ANCHOR.test(str3))
         return false;
       try {
-        new RegExp(str2);
+        new RegExp(str3);
         return true;
       } catch (e) {
         return false;
@@ -7207,25 +7207,25 @@ var require_content_type = __commonJS({
     var TYPE_REGEXP = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
     exports.format = format;
     exports.parse = parse3;
-    function format(obj2) {
-      if (!obj2 || typeof obj2 !== "object") {
+    function format(obj) {
+      if (!obj || typeof obj !== "object") {
         throw new TypeError("argument obj is required");
       }
-      var parameters = obj2.parameters;
-      var type = obj2.type;
+      var parameters2 = obj.parameters;
+      var type = obj.type;
       if (!type || !TYPE_REGEXP.test(type)) {
         throw new TypeError("invalid type");
       }
       var string4 = type;
-      if (parameters && typeof parameters === "object") {
+      if (parameters2 && typeof parameters2 === "object") {
         var param;
-        var params = Object.keys(parameters).sort();
+        var params = Object.keys(parameters2).sort();
         for (var i = 0; i < params.length; i++) {
           param = params[i];
           if (!TOKEN_REGEXP.test(param)) {
             throw new TypeError("invalid parameter name");
           }
-          string4 += "; " + param + "=" + qstring(parameters[param]);
+          string4 += "; " + param + "=" + qstring(parameters2[param]);
         }
       }
       return string4;
@@ -7243,7 +7243,7 @@ var require_content_type = __commonJS({
       if (!TYPE_REGEXP.test(type)) {
         throw new TypeError("invalid media type");
       }
-      var obj2 = new ContentType(type.toLowerCase());
+      var obj = new ContentType(type.toLowerCase());
       if (index !== -1) {
         var key;
         var match;
@@ -7262,20 +7262,20 @@ var require_content_type = __commonJS({
               value = value.replace(QESC_REGEXP, "$1");
             }
           }
-          obj2.parameters[key] = value;
+          obj.parameters[key] = value;
         }
         if (index !== header.length) {
           throw new TypeError("invalid parameter format");
         }
       }
-      return obj2;
+      return obj;
     }
-    function getcontenttype(obj2) {
+    function getcontenttype(obj) {
       var header;
-      if (typeof obj2.getHeader === "function") {
-        header = obj2.getHeader("content-type");
-      } else if (typeof obj2.headers === "object") {
-        header = obj2.headers && obj2.headers["content-type"];
+      if (typeof obj.getHeader === "function") {
+        header = obj.getHeader("content-type");
+      } else if (typeof obj.headers === "object") {
+        header = obj.headers && obj.headers["content-type"];
       }
       if (typeof header !== "string") {
         throw new TypeError("content-type header is missing from object");
@@ -7283,14 +7283,14 @@ var require_content_type = __commonJS({
       return header;
     }
     function qstring(val) {
-      var str2 = String(val);
-      if (TOKEN_REGEXP.test(str2)) {
-        return str2;
+      var str3 = String(val);
+      if (TOKEN_REGEXP.test(str3)) {
+        return str3;
       }
-      if (str2.length > 0 && !TEXT_REGEXP.test(str2)) {
+      if (str3.length > 0 && !TEXT_REGEXP.test(str3)) {
         throw new TypeError("invalid parameter value");
       }
-      return '"' + str2.replace(QUOTE_REGEXP, "\\$1") + '"';
+      return '"' + str3.replace(QUOTE_REGEXP, "\\$1") + '"';
     }
     function ContentType(type) {
       this.parameters = /* @__PURE__ */ Object.create(null);
@@ -7318,12 +7318,15 @@ function parseConfig(raw, env = process.env) {
       if (user) users[k.trim()] = user;
     }
   }
+  const selfSenders = Array.isArray(c.selfSenders) ? c.selfSenders.map(str).filter((v) => !!v) : [];
   const personal = apiKey.startsWith("rp_");
   return {
     url: url2,
     apiKey,
+    memoryPer: c.memoryPer === "user" ? "user" : "agent",
+    selfSenders,
     users,
-    // A personal token is one person: with no mapping at all, every turn is theirs (single-person install).
+    // A personal token is one memory (the user header is ignored): any non-empty value stands for it.
     defaultUser: str(c.defaultUser) ?? (personal ? "me" : void 0),
     autoRecall: bool(c.autoRecall, true),
     capture: bool(c.capture, true),
@@ -7342,6 +7345,7 @@ var USER_HEADER = "X-Recordare-User";
 var CONVERSATION_HEADER = "X-Recordare-Conversation";
 var MAX_CONTENT_BYTES = 64 * 1024;
 var MAX_MESSAGES_PER_REQUEST = 500;
+var SOURCE_PART_BYTES = 4 * 1024 * 1024;
 function clipUtf8(text, maxBytes = MAX_CONTENT_BYTES, marker = " \u2026[truncated]") {
   const bytes = Buffer.from(text, "utf8");
   if (bytes.length <= maxBytes) return text;
@@ -7368,7 +7372,7 @@ var RecordareUnavailableError = class extends Error {
 };
 var MemoryNotEmptyError = class extends Error {
   constructor() {
-    super("The memory kind can change only while the memory is empty");
+    super("The memory mode can change only while the memory is empty");
     this.name = "MemoryNotEmptyError";
   }
 };
@@ -7601,8 +7605,8 @@ function defineLazy(object3, key, getter) {
     configurable: true
   });
 }
-function objectClone(obj2) {
-  return Object.create(Object.getPrototypeOf(obj2), Object.getOwnPropertyDescriptors(obj2));
+function objectClone(obj) {
+  return Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj));
 }
 function assignProp(target, prop, value) {
   Object.defineProperty(target, prop, {
@@ -7673,10 +7677,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj2, path) {
+function getElementAtPath(obj, path) {
   if (!path)
-    return obj2;
-  return path.reduce((acc, key) => acc?.[key], obj2);
+    return obj;
+  return path.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -7691,14 +7695,14 @@ function promiseAllObject(promisesObj) {
 }
 function randomString(length = 10) {
   const chars = "abcdefghijklmnopqrstuvwxyz";
-  let str2 = "";
+  let str3 = "";
   for (let i = 0; i < length; i++) {
-    str2 += chars[Math.floor(Math.random() * chars.length)];
+    str3 += chars[Math.floor(Math.random() * chars.length)];
   }
-  return str2;
+  return str3;
 }
-function esc(str2) {
-  return JSON.stringify(str2);
+function esc(str3) {
+  return JSON.stringify(str3);
 }
 function slugify(input) {
   return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
@@ -7812,8 +7816,8 @@ var primitiveTypes = /* @__PURE__ */ new Set([
   "symbol",
   "undefined"
 ]);
-function escapeRegex(str2) {
-  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegex(str3) {
+  return str3.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function clone(inst, def, params) {
   const cl = new inst._zod.constr(def ?? inst._zod.def);
@@ -8067,13 +8071,13 @@ function getSizableOrigin(input) {
   return "unknown";
 }
 var highSurrogate = /[\uD800-\uDBFF]/;
-function codePointLength(str2) {
-  const units = str2.length;
-  if (!highSurrogate.test(str2))
+function codePointLength(str3) {
+  const units = str3.length;
+  if (!highSurrogate.test(str3))
     return units;
   let count = units;
   for (let i = 0; i < units - 1; i++) {
-    if ((str2.charCodeAt(i) & 64512) === 55296 && (str2.charCodeAt(i + 1) & 64512) === 56320) {
+    if ((str3.charCodeAt(i) & 64512) === 55296 && (str3.charCodeAt(i + 1) & 64512) === 56320) {
       count--;
       i++;
     }
@@ -8100,9 +8104,9 @@ function parsedType(data) {
       if (Array.isArray(data)) {
         return "array";
       }
-      const obj2 = data;
-      if (obj2 && Object.getPrototypeOf(obj2) !== Object.prototype && "constructor" in obj2 && obj2.constructor) {
-        return obj2.constructor.name;
+      const obj = data;
+      if (obj && Object.getPrototypeOf(obj) !== Object.prototype && "constructor" in obj && obj.constructor) {
+        return obj.constructor.name;
       }
     }
   }
@@ -8120,8 +8124,8 @@ function issue(...args) {
   }
   return { ...iss };
 }
-function cleanEnum(obj2) {
-  return Object.entries(obj2).filter(([k, _]) => {
+function cleanEnum(obj) {
+  return Object.entries(obj).filter(([k, _]) => {
     return Number.isNaN(Number.parseInt(k, 10));
   }).map((el) => el[1]);
 }
@@ -8445,15 +8449,15 @@ var $ZodError = $constructor("$ZodError", initializer);
 var $ZodRealError = $constructor("$ZodError", initializer, void 0, {
   Parent: Error
 });
-function node(obj2, key, make) {
-  if (!Object.prototype.hasOwnProperty.call(obj2, key)) {
+function node(obj, key, make) {
+  if (!Object.prototype.hasOwnProperty.call(obj, key)) {
     if (key === "__proto__") {
-      Object.defineProperty(obj2, key, { value: make(), writable: true, enumerable: true, configurable: true });
+      Object.defineProperty(obj, key, { value: make(), writable: true, enumerable: true, configurable: true });
     } else {
-      obj2[key] = make();
+      obj[key] = make();
     }
   }
-  return obj2[key];
+  return obj[key];
 }
 function flattenError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = {};
@@ -16875,15 +16879,15 @@ function applyElicitationDefaults(schema, data) {
   if (!schema || data === null || typeof data !== "object")
     return;
   if (schema.type === "object" && schema.properties && typeof schema.properties === "object") {
-    const obj2 = data;
+    const obj = data;
     const props = schema.properties;
     for (const key of Object.keys(props)) {
       const propSchema = props[key];
-      if (obj2[key] === void 0 && Object.prototype.hasOwnProperty.call(propSchema, "default")) {
-        obj2[key] = propSchema.default;
+      if (obj[key] === void 0 && Object.prototype.hasOwnProperty.call(propSchema, "default")) {
+        obj[key] = propSchema.default;
       }
-      if (obj2[key] !== void 0) {
-        applyElicitationDefaults(propSchema, obj2[key]);
+      if (obj[key] !== void 0) {
+        applyElicitationDefaults(propSchema, obj[key]);
       }
     }
   }
@@ -19066,7 +19070,7 @@ var RecordareMcp = class {
       },
       requestInit: { headers: { ...this.http.headers(user), [CONVERSATION_HEADER]: conversation } }
     });
-    const client = new Client(this.options.clientInfo ?? { name: "recordare-client", version: "0.1.0" });
+    const client = new Client(this.options.clientInfo ?? { name: "recordare-client", version: "0.2.0" });
     await client.connect(transport);
     return client;
   }
@@ -19092,11 +19096,11 @@ var RecordareClient = class {
     this.http = new Http(options);
     this.mcp = new RecordareMcp(this.http, options.mcp);
   }
-  /** The person behind `user` (auto-provisioned when the client allows it), their consent and kind of memory. */
+  /** The memory behind `user` (auto-provisioned when the client allows it), its mode and gender. */
   me(user) {
     return this.http.request("GET", "api/v1/me", { user });
   }
-  /** The person's settings from the platform: the name (keep it in sync on every rename) and the kind of memory. */
+  /** The memory's settings from the platform: the name (keep it in sync on every rename), the mode and the gender. */
   async updateMe(user, settings) {
     try {
       await this.http.request("PATCH", "api/v1/me", { user, body: settings });
@@ -19107,10 +19111,10 @@ var RecordareClient = class {
   }
   /**
    * Sends messages of one conversation, split into requests of at most MAX_MESSAGES_PER_REQUEST. Idempotent: Recordare
-   * deduplicates on each message's externalId. Before consent nothing is stored (`stored: false`).
+   * deduplicates on each message's externalId. Recordare always stores (D50): the on/off switch is the platform's.
    */
   async ingest(user, req) {
-    const total = { conversationId: null, accepted: 0, duplicates: 0, conflicts: [], stored: true };
+    const total = { conversationId: null, accepted: 0, duplicates: 0, conflicts: [] };
     for (let i = 0; i < req.messages.length; i += MAX_MESSAGES_PER_REQUEST) {
       const last = i + MAX_MESSAGES_PER_REQUEST >= req.messages.length;
       const part = await this.http.request("POST", "api/v1/ingest/messages", {
@@ -19126,7 +19130,6 @@ var RecordareClient = class {
       total.accepted += part.accepted;
       total.duplicates += part.duplicates;
       total.conflicts.push(...part.conflicts);
-      total.stored &&= part.stored;
     }
     return total;
   }
@@ -19138,6 +19141,17 @@ var RecordareClient = class {
   context(user, conversation, query) {
     return this.http.request("POST", "api/v1/context", { user, body: { query }, headers: { [CONVERSATION_HEADER]: conversation } });
   }
+  /**
+   * Stores the turn and returns the memory context for it in one round trip (needs the `ingest` and `read` scopes):
+   * the context is computed for the ingested conversation, from `query` or else the turn's last user message.
+   */
+  contextWithTurn(user, turn, query) {
+    return this.http.request("POST", "api/v1/context", { user, body: { ingest: turn, ...query ? { query } : {} } });
+  }
+  /** The conversation ended (session closed, /new): extraction runs now. A conversation Recordare never had is done. */
+  async endConversation(user, conversation) {
+    await this.gone(this.http.request("POST", `api/v1/ingest/conversations/${enc(conversation)}/end`, { user }));
+  }
   /** An edited message: Recordare re-extracts what depended on it. */
   async editMessage(user, conversation, message, content) {
     await this.http.request("PATCH", `api/v1/ingest/conversations/${enc(conversation)}/messages/${enc(message)}`, { user, body: { content } });
@@ -19150,6 +19164,32 @@ var RecordareClient = class {
   async deleteConversation(user, conversation) {
     await this.gone(this.http.request("DELETE", `api/v1/ingest/conversations/${enc(conversation)}`, { user }));
   }
+  // ── Learned sources (WORK_PLAN 8.9, D49): text the agent learns — the client turns files into text ─────────────
+  /**
+   * The agent learns a text. A big one is sent in parts (at paragraph boundaries, `partBytes` each); any size works.
+   * Sending the same `externalId` again replaces the source; the same first part again is a duplicate.
+   */
+  async learnSource(user, source, partBytes = SOURCE_PART_BYTES) {
+    const [first = "", ...rest] = splitParts(source.text, partBytes);
+    let result = await this.http.request("POST", "api/v1/ingest/sources", { user, body: { ...source, text: first, final: rest.length === 0 } });
+    if (result.duplicate) return result;
+    for (const [i, text] of rest.entries()) {
+      result = await this.http.request(
+        "POST",
+        `api/v1/ingest/sources/${enc(source.externalId)}/parts`,
+        { user, body: { part: i + 1, text, final: i === rest.length - 1 } }
+      );
+    }
+    return result;
+  }
+  /** The agent forgets a source (its text and passages; episodes keep a "forgotten source" marker). One it never had counts as done. */
+  async forgetSource(user, externalId) {
+    await this.http.request("DELETE", `api/v1/ingest/sources/${enc(externalId)}`, { user });
+  }
+  /** What the agent learned, newest first. */
+  sources(user) {
+    return this.http.request("GET", "api/v1/sources", { user });
+  }
   // ── The diary (API.md §4): what Recordare remembers, shown to the person in the platform's UI ──────────────────
   /** The timeline, newest first; pass `nextCursor` back as `cursor` for the next page. */
   episodes(user, query = {}) {
@@ -19202,6 +19242,319 @@ var RecordareClient = class {
     }
   }
 };
+function splitParts(text, maxBytes) {
+  const size = (t) => Buffer.byteLength(t, "utf8");
+  if (size(text) <= maxBytes) return [text];
+  const parts = [];
+  let current = "";
+  const push = (piece) => {
+    const joined = current ? `${current}
+
+${piece}` : piece;
+    if (size(joined) <= maxBytes) {
+      current = joined;
+      return;
+    }
+    if (current) parts.push(current);
+    current = piece;
+  };
+  for (const paragraph of text.split(/\n\s*\n/)) {
+    let rest = paragraph;
+    while (size(rest) > maxBytes) {
+      let end = rest.length;
+      while (end > 0 && size(rest.slice(0, end)) > maxBytes) end = Math.floor(end * 0.9);
+      const space = rest.lastIndexOf(" ", end);
+      let cut = space > end / 2 ? space : end;
+      if (/[\uD800-\uDBFF]/.test(rest.charAt(cut - 1))) cut--;
+      push(rest.slice(0, cut));
+      rest = rest.slice(cut).trimStart();
+    }
+    if (rest) push(rest);
+  }
+  if (current) parts.push(current);
+  return parts;
+}
+
+// ../../packages/client/src/tools.ts
+var TOOLS = [
+  {
+    "name": "correct_episode",
+    "title": "Correct a memory",
+    "description": "Correct a remembered episode (wrong date or detail). The old version is kept as history, never shown as current.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "content": {
+          "type": "string"
+        },
+        "occurred_at": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "date_precision": {
+          "type": "string",
+          "enum": [
+            "day",
+            "month",
+            "year",
+            "approximate"
+          ]
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "forget_episode",
+    "title": "Forget a memory",
+    "description": "Forget an episode, when asked to. It is deleted with its corrections and never recreated.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "learn_source",
+    "title": "Learn a text",
+    "description": "Learn a text as knowledge (a manual, a page, a note \u2014 as plain text; send it again with the same title to replace it). It stays searchable with search_knowledge; the learning becomes a memory of this conversation.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "author": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "document",
+            "page",
+            "note",
+            "book",
+            "own_text"
+          ]
+        },
+        "uri": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "text"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "log_episode",
+    "title": "Note something that happened or is planned",
+    "description": 'Explicit capture ("note that today I serviced the car"). Resolve the date yourself (ISO).',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "content": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string",
+          "enum": [
+            "event",
+            "plan"
+          ]
+        },
+        "occurred_at": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "occurred_until": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "date_precision": {
+          "type": "string",
+          "enum": [
+            "day",
+            "month",
+            "year",
+            "approximate"
+          ]
+        },
+        "people": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "place": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "content"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "remember",
+    "title": "Remember something",
+    "description": 'Explicit "remember that\u2026" about preferences, habits, values, knowledge.',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "content": {
+          "type": "string"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "preference",
+            "habit",
+            "value",
+            "relationship",
+            "knowledge",
+            "profile",
+            "constraint"
+          ]
+        }
+      },
+      "required": [
+        "content"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "resolve_period",
+    "title": "Turn a period expression into dates",
+    "description": 'Deterministic: "questa settimana", "la settimana scorsa", "a febbraio", "lo scorso dicembre", "last week"\u2026 \u2192 {from, to} (ISO, inclusive).',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "expression": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "expression"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "search_episodes",
+    "title": "Search what happened",
+    "description": 'Search your memory of what happened: what you lived, did, planned or learned, and what happened to the people you know (events, plans, changes), with dates and status. Each item has a subject: you (written in the first person), a person by name, someone, or undecided. Use `from`/`to` (ISO dates, inclusive; see resolve_period) for questions about a period. mode: "search" = most relevant, "list" = chronological in the period (overviews, counting), "latest" = most recent first ("when did I last\u2026").',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "description": "What to look for \u2014 pass the question also when listing a period: it ranks the items and finds the matching chat excerpts",
+          "type": "string"
+        },
+        "from": {
+          "description": "Start date, ISO (YYYY-MM-DD or YYYY-MM)",
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "to": {
+          "description": "End date, ISO (YYYY-MM-DD or YYYY-MM), inclusive",
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "search",
+            "list",
+            "latest"
+          ]
+        },
+        "include_plans": {
+          "type": "boolean"
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 50
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "search_knowledge",
+    "title": "Search what you learned",
+    "description": "Search the sources you learned (manuals, documents, pages, notes you were given or wrote): passages of their text, each with its source (title, author, who gave it, when) and the episodes that refer to it. For what happened, use search_episodes.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "What to look up"
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  },
+  {
+    "name": "search_memory",
+    "title": "Search what you know about yourself and others",
+    "description": 'Search your memory of preferences, habits, values, relationships, knowledge and current state (car, home, job\u2026) \u2014 yours and of the people you know; each item has its subject. Use `as_of` (ISO date) for "what was it on that date" questions; each fact comes with its history.',
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Topic"
+        },
+        "as_of": {
+          "description": "ISO date (YYYY-MM-DD); default today",
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+        },
+        "include_pending": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  }
+];
 
 // ../../packages/client/src/delivery.ts
 var DEFAULT_DELIVERY = { maxAttempts: 12, baseDelayMs: 5e3, maxDelayMs: 60 * 60 * 1e3 };
@@ -19218,6 +19571,7 @@ function afterFailure(err, attempts, policy = DEFAULT_DELIVERY, random2 = Math.r
 
 // src/identity.ts
 function resolveUser(cfg, channel, senderId) {
+  if (cfg.memoryPer === "agent") return cfg.defaultUser;
   if (senderId) {
     const mapped = channel ? cfg.users[`${channel}:${senderId}`] : void 0;
     if (mapped) return mapped;
@@ -19225,6 +19579,22 @@ function resolveUser(cfg, channel, senderId) {
   }
   return cfg.defaultUser;
 }
+var senderRef = (channel, senderId) => `${channel ?? "openclaw"}:${senderId}`;
+function senderParticipant(channel, senderId, displayName) {
+  return {
+    ref: senderRef(channel, senderId),
+    role: "other",
+    identity: { channel: channel ?? "openclaw", externalId: senderId },
+    ...displayName ? { displayName } : {}
+  };
+}
+function resolveSpeaker(cfg, channel, senderId, displayName) {
+  if (cfg.memoryPer === "user" || !senderId || cfg.selfSenders.includes(senderRef(channel, senderId))) {
+    return { ref: "holder", role: "user" };
+  }
+  const participant = senderParticipant(channel, senderId, displayName);
+  return { ref: participant.ref, role: "other", participant };
+}
 function conversationId(sessionKey, sessionId) {
   if (!sessionKey && !sessionId) return void 0;
   return `openclaw:${sessionKey ?? "session"}${sessionId ? `/${sessionId}` : ""}`;
@@ -19237,62 +19607,19 @@ function isSystemRun(ctx) {
 }
 
 // src/tools.ts
-var isoDay = { type: "string", pattern: "^\\d{4}-\\d{2}(-\\d{2})?$" };
-var precision = { type: "string", enum: ["day", "month", "year", "approximate"] };
-var uuid2 = { type: "string", description: "The episode id, from search_episodes" };
-var obj = (properties, required2 = []) => ({ type: "object", properties, required: required2 });
-var TOOLS = [
-  {
-    mcpName: "search_episodes",
-    label: "Recordare: search what happened",
-    description: 'Search what the user lived, did or planned (events, plans, changes), with dates and status, in the user\'s long-term memory. Use `from`/`to` (ISO dates, inclusive; see recordare_resolve_period) for questions about a period. mode: "search" = most relevant, "list" = chronological in the period (overviews, counting), "latest" = most recent first.',
-    parameters: obj({
-      query: { type: "string", description: "What to look for \u2014 pass the user's question also when listing a period" },
-      from: { ...isoDay, description: "Start date, ISO (YYYY-MM-DD or YYYY-MM)" },
-      to: { ...isoDay, description: "End date, ISO (YYYY-MM-DD or YYYY-MM), inclusive" },
-      mode: { type: "string", enum: ["search", "list", "latest"] },
-      include_plans: { type: "boolean" },
-      limit: { type: "integer", minimum: 1, maximum: 50 }
-    })
-  },
-  {
-    mcpName: "search_memory",
-    label: "Recordare: search who the user is",
-    description: 'Search the user\'s preferences, habits, values, relationships, knowledge and current state (car, home, job\u2026) in their long-term memory. Use `as_of` (ISO date) for "what was it on that date" questions; each fact comes with its history.',
-    parameters: obj({
-      query: { type: "string", description: "Topic" },
-      as_of: { ...isoDay, description: "ISO date (YYYY-MM-DD); default today" },
-      include_pending: { type: "boolean" }
-    }, ["query"])
-  },
-  {
-    mcpName: "resolve_period",
-    label: "Recordare: period to dates",
-    description: 'Deterministic: "this week", "last week", "in February", "last December", "la settimana scorsa"\u2026 \u2192 {from, to} (ISO, inclusive).',
-    parameters: obj({ expression: { type: "string" } }, ["expression"])
-  },
-  {
-    mcpName: "remember",
-    label: "Recordare: remember",
-    description: `Explicit "remember that\u2026" about the user's preferences, habits, values, knowledge (long-term memory).`,
-    parameters: obj({
-      content: { type: "string" },
-      category: { type: "string", enum: ["preference", "habit", "value", "relationship", "knowledge", "profile", "constraint"] }
-    }, ["content"])
-  },
-  {
-    mcpName: "correct_episode",
-    label: "Recordare: correct a memory",
-    description: "The user corrects a remembered episode (wrong date or detail). The old version is kept as history, never shown as current.",
-    parameters: obj({ id: uuid2, content: { type: "string" }, occurred_at: isoDay, date_precision: precision }, ["id"])
-  },
-  {
-    mcpName: "forget_episode",
-    label: "Recordare: forget a memory",
-    description: "The user asks to forget an episode. It is deleted with its corrections and never recreated.",
-    parameters: obj({ id: uuid2 }, ["id"])
-  }
-];
+var OFFERED = TOOLS.filter((t) => t.name !== "log_episode");
+var NAMES = new RegExp(`\\b(${OFFERED.map((t) => t.name).join("|")})\\b`, "g");
+function parameters(schema) {
+  const { $schema: _ignored, ...rest } = structuredClone(schema);
+  return rest;
+}
+var TOOLS2 = OFFERED.map((t) => ({
+  mcpName: t.name,
+  label: `Recordare: ${t.title.charAt(0).toLowerCase()}${t.title.slice(1)}`,
+  // Tool names the description mentions are the plugin's (`recordare_…`); the memory is the agent's long-term one (D50).
+  description: `${t.description.replace(NAMES, "recordare_$1")} (Recordare: your long-term memory.)`,
+  parameters: parameters(t.inputSchema)
+}));
 var toolName = (spec) => `recordare_${spec.mcpName}`;
 
 // src/transcript.ts
@@ -19333,14 +19660,16 @@ function lastTurn(messages) {
 }
 
 // src/plugin.ts
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 var TOOL_TIMEOUT_MS = 2e4;
 var RETRY = { maxAttempts: 8, baseDelayMs: 2e3, maxDelayMs: 5 * 6e4 };
 var MAX_QUEUE = 500;
 var MAX_TRACKED = 500;
 var MAX_GROUP_BUFFER = 50;
+var MAX_NAMES = 1e3;
 var hash = (s) => createHash("sha256").update(s).digest("hex").slice(0, 16);
 var errName = (err) => err instanceof Error ? err.message : "error";
+var str2 = (v) => typeof v === "string" && v.trim() ? v.trim() : void 0;
 function remember(map, key, value, max = MAX_TRACKED) {
   map.delete(key);
   map.set(key, value);
@@ -19362,12 +19691,19 @@ function registerRecordare(api, cfg, kinds) {
   const slow = new RecordareClient({ baseUrl: cfg.url, apiKey: cfg.apiKey, mcp: { clientInfo, maxSessions: 50 } });
   const headerUser = (user) => cfg.personal ? "" : user;
   const turns = /* @__PURE__ */ new Map();
-  const lastSent = /* @__PURE__ */ new Map();
+  const captured = /* @__PURE__ */ new Map();
   const groupBuffer = /* @__PURE__ */ new Map();
   const groupParticipants = /* @__PURE__ */ new Map();
+  const names = /* @__PURE__ */ new Map();
   const queue = [];
   let timer;
   let stopped = false;
+  if (cfg.memoryPer === "agent" && !cfg.defaultUser) {
+    log.warn("recordare: set defaultUser (the agent's Recordare account) or use a personal token; memory is off");
+  }
+  if (cfg.memoryPer === "agent" && Object.keys(cfg.users).length) {
+    log.warn('recordare: `users` is used only with memoryPer "user"; every sender is a participant of the agent\'s memory');
+  }
   async function deliver(p) {
     try {
       const res = await slow.ingest(headerUser(p.user), p.req);
@@ -19413,14 +19749,18 @@ function registerRecordare(api, cfg, kinds) {
     const user = resolveUser(cfg, channel, ctx.senderId);
     const conversation = conversationId(key, ctx.sessionId);
     if (!user || !conversation) return null;
-    return { user, conversation, channel };
+    const name = ctx.senderId ? names.get(senderRef(channel, ctx.senderId)) : void 0;
+    return { user, conversation, channel, speaker: resolveSpeaker(cfg, channel, ctx.senderId, name) };
   }
   function conversationMeta(w, ctx) {
     const participants = [
-      { ref: "owner", role: "owner" },
+      { ref: "holder", role: "holder" },
       { ref: "assistant", role: "assistant", displayName: ctx.agentId ?? "assistant" },
-      ...ctx.sessionKey ? groupParticipants.get(ctx.sessionKey) ?? [] : []
+      ...w.speaker.participant ? [w.speaker.participant] : []
     ];
+    for (const p of ctx.sessionKey ? groupParticipants.get(ctx.sessionKey) ?? [] : []) {
+      if (!participants.some((q) => q.ref === p.ref)) participants.push(p);
+    }
     return {
       externalId: w.conversation,
       source: "chat",
@@ -19445,20 +19785,26 @@ function registerRecordare(api, cfg, kinds) {
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const id = event.currentUserMessageId ?? ctx.runId ?? hash(`${w.conversation}\0${text}\0${now}`);
       const conversation = conversationMeta(w, ctx);
-      const message = { externalId: `${id}:u`, role: "user", authorRef: "owner", content: clipUtf8(text), sentAt: now };
+      const message = { externalId: `${id}:u`, role: w.speaker.role, authorRef: w.speaker.ref, content: clipUtf8(text), sentAt: now };
       remember(turns, ctx.runId ?? w.conversation, { user: w.user, conversation, message });
-      if (cfg.capture) {
-        const others = takeGroupMessages(ctx.sessionKey, text);
-        try {
-          await fast.ingest(headerUser(w.user), { conversation, messages: [...others, message] });
-        } catch (err) {
-          log.warn(`recordare: ingest before the turn failed (${errName(err)}), will retry`);
-          void send(w.user, { conversation, messages: [...others, message] });
+      if (!cfg.capture) {
+        const ctxRes = await fast.context(headerUser(w.user), w.conversation, text.slice(0, 4e3));
+        return ctxRes.block ? { prependContext: ctxRes.block } : void 0;
+      }
+      const turn = { conversation, messages: [...takeGroupMessages(ctx.sessionKey, text), message] };
+      remember(captured, w.conversation, w.user);
+      try {
+        if (!cfg.autoRecall) {
+          await fast.ingest(headerUser(w.user), turn);
+          return void 0;
         }
+        const ctxRes = await fast.contextWithTurn(headerUser(w.user), turn, text.slice(0, 4e3));
+        return ctxRes.block ? { prependContext: ctxRes.block } : void 0;
+      } catch (err) {
+        log.warn(`recordare: storing the message before the turn failed (${errName(err)}), will retry; no memory context this turn`);
+        void send(w.user, turn);
+        return void 0;
       }
-      if (!cfg.autoRecall) return;
-      const ctxRes = await fast.context(headerUser(w.user), w.conversation, text.slice(0, 4e3));
-      return ctxRes.block ? { prependContext: ctxRes.block } : void 0;
     } catch (err) {
       log.warn(`recordare: memory context unavailable (${errName(err)})`);
       return void 0;
@@ -19476,10 +19822,10 @@ function registerRecordare(api, cfg, kinds) {
       const now = (/* @__PURE__ */ new Date()).toISOString();
       const runId = event.runId ?? ctx.runId ?? hash(`${w.conversation}\0${turn.assistant}`);
       const conversation = conversationMeta(w, ctx);
-      const userMessage = stashed?.message ?? (turn.user ? { externalId: `${runId}:u`, role: "user", authorRef: "owner", content: clipUtf8(turn.user), sentAt: now } : void 0);
+      const userMessage = stashed?.message ?? (turn.user ? { externalId: `${runId}:u`, role: w.speaker.role, authorRef: w.speaker.ref, content: clipUtf8(turn.user), sentAt: now } : void 0);
       const answer = { externalId: `${runId}:a`, role: "assistant", authorRef: "assistant", content: clipUtf8(turn.assistant), sentAt: now };
       const messages = [...userMessage ? [userMessage] : [], answer];
-      remember(lastSent, w.conversation, { user: w.user, conversation, message: answer });
+      remember(captured, w.conversation, w.user);
       await send(w.user, { conversation, messages });
     } catch (err) {
       log.warn(`recordare: capture failed (${errName(err)})`);
@@ -19489,10 +19835,10 @@ function registerRecordare(api, cfg, kinds) {
     try {
       if (!cfg.capture || ["compaction", "shutdown", "restart"].includes(event.reason ?? "")) return;
       const conv = conversationId(event.sessionKey ?? ctx.sessionKey, event.sessionId ?? ctx.sessionId);
-      const last = conv ? lastSent.get(conv) : void 0;
-      if (!conv || !last?.message) return;
-      lastSent.delete(conv);
-      await send(last.user, { conversation: last.conversation, messages: [last.message], hints: { conversationEnded: true } });
+      const user = conv ? captured.get(conv) : void 0;
+      if (!conv || user === void 0) return;
+      captured.delete(conv);
+      await slow.endConversation(headerUser(user), conv);
     } catch (err) {
       log.warn(`recordare: end of conversation not sent (${errName(err)})`);
     }
@@ -19501,18 +19847,22 @@ function registerRecordare(api, cfg, kinds) {
     try {
       const key = event.sessionKey ?? ctx.sessionKey;
       const senderId = event.senderId ?? ctx.senderId;
-      if (!cfg.capture || !cfg.groups || !isGroupSession(key) || !senderId || !event.content?.trim()) return;
-      const ref = `${ctx.channelId}:${senderId}`;
+      if (!senderId) return;
+      const ref = senderRef(ctx.channelId, senderId);
+      const name = str2(event.metadata?.senderName) ?? str2(event.metadata?.senderUsername);
+      if (name) remember(names, ref, name, MAX_NAMES);
+      if (!cfg.capture || !cfg.groups || !isGroupSession(key) || !event.content?.trim()) return;
+      const speaker = cfg.memoryPer === "agent" ? resolveSpeaker(cfg, ctx.channelId, senderId, name) : { ref, role: "other", participant: senderParticipant(ctx.channelId, senderId, name) };
       const members2 = groupParticipants.get(key) ?? [];
-      if (!members2.some((p) => p.ref === ref)) {
-        remember(groupParticipants, key, [...members2, { ref, role: "other", identity: { channel: ctx.channelId, externalId: senderId } }]);
+      if (speaker.participant && !members2.some((p) => p.ref === speaker.ref)) {
+        remember(groupParticipants, key, [...members2, speaker.participant]);
       }
       const at = event.timestamp ? new Date(event.timestamp) : /* @__PURE__ */ new Date();
       const buffered = groupBuffer.get(key) ?? [];
       buffered.push({
         externalId: `msg:${event.messageId ?? ctx.messageId ?? hash(`${ref}\0${event.content}\0${at.toISOString()}`)}`,
-        role: "other",
-        authorRef: ref,
+        role: speaker.role,
+        authorRef: speaker.ref,
         content: clipUtf8(event.content),
         sentAt: at.toISOString()
       });
@@ -19522,7 +19872,7 @@ function registerRecordare(api, cfg, kinds) {
     }
   });
   if (cfg.tools) {
-    for (const spec of TOOLS) {
+    for (const spec of TOOLS2) {
       const name = toolName(spec);
       api.registerTool((ctx) => {
         if (kinds.isIncognito(ctx.sessionKey)) return null;