wontopos 2.2.16 → 2.2.18

package/dist/wontopos.d.ts

@@ -171,6 +171,13 @@ export interface MemoryPage {
     next_cursor: string | null;
     [key: string]: unknown;
 }
+/** `searchSelf` result: the main lane plus the assistant's own words, split. */
+export interface SelfSearchResult {
+    /** Main lane — what others said / general memories. */
+    memories: Memory[];
+    /** The assistant's own words (stored with speaker "me"); `[]` on non-self models. */
+    self_memories: Memory[];
+}
 export interface ModelInfo {
     id: string;
     name: string;
@@ -273,7 +280,7 @@ export declare class Client {
     withTimeout(timeoutMs: number): Client;
     /** A client with a different retry budget (everything else kept). 0 disables retries. */
     withRetries(maxRetries: number): Client;
-    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }).
+    /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01T00:00:00Z" } — RFC3339).
      * `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<StoreResult>;
     /** Alias of `add` — store one memory. Same surface as the Python SDK's `store`. */
@@ -286,6 +293,12 @@ export declare class Client {
     update(oldMemoryId: string, newContent: string, userId?: string): Promise<UpdateResult>;
     /** Semantic search over a store's memories. Returns memories, most relevant first. */
     search(query: string, userId?: string, limit?: number, opts?: SearchOptions): Promise<Memory[]>;
+    /** 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 /
+     * general memories), `self_memories` is the assistant's OWN words (stored with
+     * speaker "me"), kept separate so the reader never confuses who said what. On a model
+     * without a self lane, `self_memories` is `[]`. `userId` optional (default store). */
+    searchSelf(query: string, userId?: string, limit?: number, opts?: SearchOptions): Promise<SelfSearchResult>;
     /** One-call LLM context: short-term turns + long-term matches + surrounding context. */
     recall(query: string, userId?: string): Promise<RecallResult>;
     /** Run a built-in engram ("deep_recall" | "timeline" | "gather"). Returns the merged result. */

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.16";
+const VERSION = "2.2.17";
 /** 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). */
@@ -298,7 +298,7 @@ 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-01T00:00:00Z" } — RFC3339).
      * `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 });
@@ -330,6 +330,15 @@ export class Client {
         const r = await this.post("/api/v1/memory/search", { ...opts, user_id: this.uid(userId), query, max_results: limit });
         return (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 /
+     * general memories), `self_memories` is the assistant's OWN words (stored with
+     * speaker "me"), kept separate so the reader never confuses who said what. On a model
+     * 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: (r.memories ?? []), self_memories: (r.self_memories ?? []) };
+    }
     /** One-call LLM context: short-term turns + long-term matches + surrounding context. */
     recall(query, userId) {
         return this.post("/api/v1/memory/recall", { user_id: this.uid(userId), query });
@@ -625,15 +634,24 @@ export class Client {
                 throw errorFor(res.status, msg, requestId);
             }
             if (!text)
-                return null;
+                return {};
+            let data;
             try {
-                return JSON.parse(text);
+                data = JSON.parse(text);
             }
             catch (e) {
                 // A 2xx with a corrupt body is a real failure — surface it, don't leak
                 // a raw SyntaxError (parity with the Rust SDK).
                 throw new WosError(res.status, `invalid JSON in response: ${e?.message ?? e}`);
             }
+            // Enforce a JSON OBJECT: every method reads the result with `.field`, so a
+            // body that parses to null / a number / a string / an array (a broken or
+            // hostile server) must be a clean WosError, not a `null.memories` TypeError.
+            if (data === null || typeof data !== "object" || Array.isArray(data)) {
+                const got = data === null ? "null" : Array.isArray(data) ? "array" : typeof data;
+                throw new WosError(res.status, `expected a JSON object in the response, got ${got}`);
+            }
+            return data;
         }
         throw new WosError(0, "retries exhausted"); // unreachable; keeps the compiler happy
     }

package/package.json

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