wontopos 2.2.19 → 2.2.21

package/README.md

@@ -8,6 +8,10 @@ npm install wontopos
 import { Client } from "wontopos";
 
 const mem = new Client({ apiKey: "wos-..." });
+
+// Each end-user / agent / topic gets its own store — create it once.
+// (A `default` store already exists, so you can skip this and omit the id.)
+await mem.createStore("alice");
 await mem.add("she prefers tea over coffee", "alice");
 
 // one call → short-term + long-term + context, ready for your LLM prompt

package/dist/wontopos.js

@@ -37,7 +37,7 @@
  * runtime's (never disabled by this SDK; Node 18+ floors TLS at 1.2). Prefer
  * `Client.fromEnv()` over keys in source code.
  */
-const VERSION = "2.2.19";
+const VERSION = "2.2.21";
 /** Runtime info helps support debug a report ("node 18 on Windows...") —
  * platform only, never anything identifying. Browsers have no `process` (and
  * silently drop the UA header anyway). */
@@ -129,6 +129,13 @@ function parseRateLimit(h) {
 // that isn't actually an array/object to the empty value.
 const asList = (x) => (Array.isArray(x) ? x : []);
 const asObj = (x) => (x != null && typeof x === "object" && !Array.isArray(x) ? x : {});
+// A list of API records (memories, turns, models...) — every element is an object
+// by contract. `asList` only fixes the CONTAINER: a hostile/broken server sending
+// `{"memories": [null, 1, "x", {...}]}` still handed the caller those non-objects,
+// typed as Memory[], and the first `m.content` threw a raw TypeError from inside
+// user code. Drop elements that aren't objects and keep the valid records, so one
+// bad element never poisons the batch (and never destroys it).
+const asRecords = (x) => asList(x).filter((m) => m != null && typeof m === "object" && !Array.isArray(m));
 // Attach a delivery-form override (memoir/archive) + tz to a body, the way search
 // passes them; on Scroll 1.2+ this renders each returned memory's time in that form.
 function withForm(body, form, tz) {
@@ -343,7 +350,7 @@ export class Client {
         // Reserved fields win over ...opts: an app that forwards untrusted input as
         // opts must not be able to override the store (user_id), query, or limit.
         const r = await this.post("/api/v1/memory/search", { ...opts, user_id: this.uid(userId), query, max_results: limit });
-        return asList(r.memories);
+        return asRecords(r.memories);
     }
     /** Search a self-memory model (Scroll 1.2+): both lanes from ONE call. Returns
      * `{ memories, self_memories }` — `memories` is the main lane (what others said /
@@ -352,7 +359,7 @@ export class Client {
      * without a self lane, `self_memories` is `[]`. `userId` optional (default store). */
     async searchSelf(query, userId, limit = 10, opts = {}) {
         const r = await this.post("/api/v1/memory/search", { ...opts, user_id: this.uid(userId), query, max_results: limit });
-        return { memories: asList(r.memories), self_memories: asList(r.self_memories) };
+        return { memories: asRecords(r.memories), self_memories: asRecords(r.self_memories) };
     }
     /** One-call LLM context: short-term turns + long-term matches + surrounding context.
      * `form` ("memoir"/"archive", Scroll 1.2+) renders each long-term memory's time in
@@ -368,7 +375,7 @@ export class Client {
     /** Recent conversation turns (short-term memory). */
     async history(userId) {
         const r = await this.post("/api/v1/memory/history", { user_id: this.uid(userId) });
-        return asList(r.turns);
+        return asRecords(r.turns);
     }
     /** Memory counts for a store: { total_memories, short_term_turns }. */
     stats(userId) {
@@ -416,7 +423,7 @@ export class Client {
         // server that mints a FRESH cursor every page forever — bound the walk.
         for (let page = 0; page < MAX_PAGES; page++) {
             const p = await this.listMemories(userId, { limit: opts.pageSize ?? 100, cursor });
-            for (const m of asList(p.memories))
+            for (const m of asRecords(p.memories))
                 yield m;
             const next = p.next_cursor ?? undefined;
             if (!next || seen.has(next))
@@ -443,7 +450,7 @@ export class Client {
     /** Available models: `[{ id, name, available, memory }, ...]`. Needs no API key. */
     async listModels() {
         const data = await this.request("GET", "/api/v1/models");
-        return asList(data.models);
+        return asRecords(data.models);
     }
     // ----- stores -----
     /** Create a store — the `userId` you read and write under. Stores are explicit:
@@ -456,7 +463,7 @@ export class Client {
     /** List your stores: `[{ user_id, created_at }, ...]` (`default` first). */
     async listStores() {
         const r = await this.request("GET", "/api/v1/memory/collections");
-        return asList(r.collections);
+        return asRecords(r.collections);
     }
     /** Delete a store and ALL its memories. Returns `{ user_id, status }`. */
     deleteStore(userId) {

package/package.json

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