wontopos 2.2.9 → 2.2.11

package/README.md

@@ -131,6 +131,9 @@ const mem = new Client({ apiKey: "...", baseUrl: "https://wos.your-host.com" });
 
 ## Changelog
 
+- **2.2.10** — `Memory` fix: the relevance field is `similarity` (not `score`,
+  which was never in the response); added typed `importance`, `category`,
+  `is_superseded`, `superseded_by`, `created_at`, `event_date`.
 - **2.2.9** — typed responses for every method (index-signature friendly) +
   typed `SearchOptions`; security round 2: 64MB response cap, key/model-name
   hygiene, `Client.fromEnv()`.

package/dist/wontopos.d.ts

@@ -46,9 +46,22 @@ export interface Usage {
 export interface Memory {
     id?: string;
     content?: string;
-    score?: number;
-    /** Month bucket the memory belongs to (e.g. "2026-07"). */
+    /** Cognitive category, e.g. "general". */
+    category?: string;
+    /** Semantic relevance to the query — higher is closer. This IS the relevance score; there is no `score` field. */
+    similarity?: number;
+    /** Learned importance weight of the memory. */
+    importance?: number;
+    /** Month bucket the memory belongs to (e.g. "2026-07"). Omitted when temporal fields are stripped. */
     time_bucket?: string;
+    /** True if a later memory has superseded this one. */
+    is_superseded?: boolean;
+    /** Id of the memory that superseded this one, or null. */
+    superseded_by?: string | null;
+    /** When the memory was stored (RFC3339). Omitted when temporal fields are stripped. */
+    created_at?: string;
+    /** When the content actually happened (RFC3339), if known. */
+    event_date?: string;
     /** WHO said it: "me" (the assistant) or a registered person's name. Absent = untagged. */
     speaker?: string;
     [key: string]: unknown;
@@ -110,6 +123,14 @@ export interface StatsResult {
     short_term_turns?: number;
     [key: string]: unknown;
 }
+/** `listMemories` → one page of a store's raw memories (original text + metadata, no vector). */
+export interface MemoryPage {
+    memories: Memory[];
+    count: number;
+    /** Pass back as `cursor` for the next page; `null` on the last page. */
+    next_cursor: string | null;
+    [key: string]: unknown;
+}
 export interface ModelInfo {
     id: string;
     name: string;
@@ -222,6 +243,22 @@ export declare class Client {
     history(userId?: string): Promise<HistoryTurn[]>;
     /** Memory counts for a store: { total_memories, short_term_turns }. */
     stats(userId?: string): Promise<StatsResult>;
+    /** List a store's stored memories — the original text plus metadata, never the
+     * vector. Paginated: pass the returned `next_cursor` back as `cursor` for the next
+     * page; a `null` cursor means the last page. Use it to browse or export a store.
+     *
+     *     let cursor: string | null = null;
+     *     const all: Memory[] = [];
+     *     do {
+     *       const page = await mem.listMemories(undefined, { cursor: cursor ?? undefined });
+     *       all.push(...page.memories);
+     *       cursor = page.next_cursor;
+     *     } while (cursor);
+     */
+    listMemories(userId?: string, opts?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<MemoryPage>;
     /** Available models: `[{ id, name, available, memory }, ...]`. Needs no API key. */
     listModels(): Promise<ModelInfo[]>;
     /** Create a store — the `userId` you read and write under. Stores are explicit:

package/dist/wontopos.js

@@ -32,7 +32,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.9";
+const VERSION = "2.2.11";
 const USER_AGENT = `wontopos-node/${VERSION}`;
 const DEFAULT_BASE_URL = "https://api.wontopos.com";
 const DEFAULT_MODEL = "tablet-1";
@@ -197,6 +197,24 @@ export class Client {
     stats(userId) {
         return this.post("/api/v1/memory/stats", { user_id: this.uid(userId) });
     }
+    /** List a store's stored memories — the original text plus metadata, never the
+     * vector. Paginated: pass the returned `next_cursor` back as `cursor` for the next
+     * page; a `null` cursor means the last page. Use it to browse or export a store.
+     *
+     *     let cursor: string | null = null;
+     *     const all: Memory[] = [];
+     *     do {
+     *       const page = await mem.listMemories(undefined, { cursor: cursor ?? undefined });
+     *       all.push(...page.memories);
+     *       cursor = page.next_cursor;
+     *     } while (cursor);
+     */
+    listMemories(userId, opts = {}) {
+        const body = { user_id: this.uid(userId), limit: opts.limit ?? 100 };
+        if (opts.cursor)
+            body.cursor = opts.cursor;
+        return this.post("/api/v1/memory/list", body);
+    }
     // ----- models -----
     /** Available models: `[{ id, name, available, memory }, ...]`. Needs no API key. */
     async listModels() {

package/package.json

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