wontopos 2.2.4 → 2.2.6

package/README.md

@@ -24,7 +24,32 @@ const ctx = await mem.recall("what does alice drink?", "alice");
 
 `add` · `addTurn` · `addBulk` · `update` · `search` · `recall` · `history` · `stats` · `delete` · `deleteAll`
 
-All methods take `{ userId }`. Memories are isolated per user, then per account.
+All methods take `{ userId }` — it names the **store**: one isolated memory space per end-user, agent, or topic, then per account. WHO said each memory inside a store is the `speaker` tag below — storing the assistant's own words never needs a separate id.
+
+## Who said it (speakers)
+
+Every memory can carry a speaker: `"me"` for the assistant's own words, or a
+person's name. Search accepts a speaker too, to recall one person's words only.
+
+```ts
+await mem.add("I promised to send the report on Friday", "alice", { speaker: "me" });
+await mem.add("Bob said the deadline moved to Tuesday", "alice", { speaker: "Bob" });
+await mem.search("what did Bob say about deadlines?", "alice", 10, { speaker: "Bob" });
+```
+
+A store remembers up to 50 people to start (a limit we plan to raise);
+`"me"` never counts against it.
+
+## Recall caching
+
+Opt in per search and repeated or extended queries reuse the previous result
+at 10% of the normal rate (Tablet and Scroll models):
+
+```ts
+const hits = await mem.search("...the conversation so far...", "alice", 10,
+                              { cache_control: { ttl: "5m" } });  // or "1h"
+```
+
 
 ## Errors
 

package/dist/wontopos.d.ts

@@ -86,7 +86,8 @@ export declare class Client {
     withModel(model: string): Client;
     /** A client bound to `userId` as its default store (everything else kept). */
     withUser(userId: string): Client;
-    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }). */
+    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }).
+     * `metadata.speaker`: "me" = the assistant's own words, or a person's name (up to 50 per store). */
     add(content: string, userId?: string, metadata?: Record<string, unknown>): Promise<any>;
     /** Alias of `add` — store one memory. Same surface as the Python SDK's `store`. */
     store(content: string, userId?: string, metadata?: Record<string, unknown>): Promise<any>;

package/dist/wontopos.js

@@ -73,7 +73,8 @@ export class Client {
     // ----- write -----
     // `userId` is optional in every call below - omit it to use the client's default
     // store (set via `new Client({ apiKey, userId })` or `withUser`).
-    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }). */
+    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }).
+     * `metadata.speaker`: "me" = the assistant's own words, or a person's name (up to 50 per store). */
     add(content, userId, metadata = {}) {
         return this.post("/api/v1/memory/store", { user_id: this.uid(userId), content, metadata });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wontopos",
-  "version": "2.2.4",
+  "version": "2.2.6",
   "description": "Wontopos — long-term memory for AI agents. Pure semantic retrieval, identical recall in every language, ~100× lower LLM bill.",
   "keywords": [
     "memory",