wontopos 2.1.0 → 2.2.0

package/dist/wontopos.d.ts

@@ -9,9 +9,9 @@
  *   const hits = await mem.search("what does alice drink?", "alice");
  *
  * The API key picks *which memory* (your account); `model` picks *which engine*
- * reads it — like Claude's `model`. All models share one memory, so you can store
+ * reads it. All models share one memory, so you can store
  * with one and recall with another. Set a default in the constructor, or override
- * a single call with `mem.withModel("scroll").recall(...)`.
+ * a single call with `mem.withModel("tablet-1").recall(...)`.
  *
  * Pure semantic retrieval — no keyword/BM25 matching, so it works the SAME in every
  * language. Storing and searching call no LLM; you only pay for embeddings.
@@ -67,7 +67,7 @@ export declare class Client {
     /**
      * A client that uses `model` (sent as `X-WOS-Model`). Use it to set the default
      * (`new Client({ apiKey, model })`) or to override one call
-     * (`client.withModel("scroll").recall(...)`).
+     * (`client.withModel("tablet-1").recall(...)`).
      */
     withModel(model: string): Client;
     /** Store one memory. `metadata` optional (e.g. { event_date: "2026-03-01" }). */
@@ -82,6 +82,8 @@ export declare class Client {
     search(query: string, userId: string, limit?: number, opts?: Record<string, unknown>): Promise<Memory[]>;
     /** 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. */
+    engram(name: string, query: string, userId: string): Promise<unknown>;
     /** Recent conversation turns (short-term memory). */
     history(userId: string): Promise<unknown[]>;
     /** Memory counts for a user: { total_memories, short_term_turns }. */

package/dist/wontopos.js

@@ -9,9 +9,9 @@
  *   const hits = await mem.search("what does alice drink?", "alice");
  *
  * The API key picks *which memory* (your account); `model` picks *which engine*
- * reads it — like Claude's `model`. All models share one memory, so you can store
+ * reads it. All models share one memory, so you can store
  * with one and recall with another. Set a default in the constructor, or override
- * a single call with `mem.withModel("scroll").recall(...)`.
+ * a single call with `mem.withModel("tablet-1").recall(...)`.
  *
  * Pure semantic retrieval — no keyword/BM25 matching, so it works the SAME in every
  * language. Storing and searching call no LLM; you only pay for embeddings.
@@ -46,7 +46,7 @@ export class Client {
     /**
      * A client that uses `model` (sent as `X-WOS-Model`). Use it to set the default
      * (`new Client({ apiKey, model })`) or to override one call
-     * (`client.withModel("scroll").recall(...)`).
+     * (`client.withModel("tablet-1").recall(...)`).
      */
     withModel(model) {
         return new Client({ apiKey: this.apiKey, baseUrl: this.base, timeoutMs: this.timeoutMs, model });
@@ -81,6 +81,10 @@ export class Client {
     recall(query, userId) {
         return this.post("/api/v1/memory/recall", { user_id: userId, query });
     }
+    /** Run a built-in engram ("deep_recall" | "timeline" | "gather"). Returns the merged result. */
+    engram(name, query, userId) {
+        return this.post("/api/v1/engram/run", { name, user_id: userId, query });
+    }
     /** Recent conversation turns (short-term memory). */
     async history(userId) {
         const r = await this.post("/api/v1/memory/history", { user_id: userId });

package/package.json

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