wontopos 2.2.5 → 2.2.7

package/README.md

@@ -24,21 +24,26 @@ 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.
+person's name. Speakers are explicit, like stores: register a person once,
+then store under their name — a typo can never silently become a new person.
+Search accepts a speaker too, to recall one person's words only.
 
 ```ts
+await mem.addSpeaker("Bob", "alice");        // once per person
 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.
+`listSpeakers()` shows the registered people with per-person memory counts;
+`removeSpeaker()` unregisters (memories stay, the tag goes). A store registers
+up to 50 people to start (a limit we plan to raise); `"me"` never needs
+registration and never counts against it.
 
 ## Recall caching
 

package/dist/wontopos.d.ts

@@ -121,6 +121,14 @@ export declare class Client {
     }>>;
     /** Delete a store and ALL its memories. Returns `{ user_id, status }`. */
     deleteStore(userId: string): Promise<any>;
+    /** Register a person for this store. Speakers are explicit: register once, then
+     * store with `{ speaker }`. `"me"` (the assistant itself) never needs
+     * registration. A store registers up to 50 people to start. */
+    addSpeaker(speaker: string, userId?: string): Promise<any>;
+    /** The store's registered people, each with its memory count. */
+    listSpeakers(userId?: string): Promise<any>;
+    /** Unregister a person. Their memories stay; the name tag goes. */
+    removeSpeaker(speaker: string, userId?: string): Promise<any>;
     /** Delete a single memory by id. `userId` optional (uses the default store). */
     delete(userId: string | undefined, memoryId: string): Promise<any>;
     /** Delete ALL memories for a store (GDPR erase). `userId` is required on purpose -

package/dist/wontopos.js

@@ -146,6 +146,21 @@ export class Client {
     deleteStore(userId) {
         return this.request("DELETE", "/api/v1/memory/collection", { user_id: userId });
     }
+    // ----- speakers (who said it) -----
+    /** Register a person for this store. Speakers are explicit: register once, then
+     * store with `{ speaker }`. `"me"` (the assistant itself) never needs
+     * registration. A store registers up to 50 people to start. */
+    addSpeaker(speaker, userId) {
+        return this.post("/api/v1/memory/speakers", { user_id: this.uid(userId), speaker });
+    }
+    /** The store's registered people, each with its memory count. */
+    listSpeakers(userId) {
+        return this.request("GET", `/api/v1/memory/speakers?user_id=${encodeURIComponent(this.uid(userId))}`);
+    }
+    /** Unregister a person. Their memories stay; the name tag goes. */
+    removeSpeaker(speaker, userId) {
+        return this.request("DELETE", "/api/v1/memory/speakers", { user_id: this.uid(userId), speaker });
+    }
     // ----- delete -----
     /** Delete a single memory by id. `userId` optional (uses the default store). */
     delete(userId, memoryId) {

package/package.json

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