memorysync-sdk 1.9.0 → 1.9.1

package/dist/index.d.mts

@@ -1317,13 +1317,33 @@ declare class MemorySyncClient {
     }): Promise<Record<string, unknown>>;
     /** Counts and coverage for the knowledge base. */
     knowledgeStats(): Promise<Record<string, unknown>>;
-    /** Add a conversation turn and extract memories from it. */
+    /**
+     * Store one conversational turn VERBATIM (episodic ingestion).
+     *
+     * The sibling of the extraction-gated fact store: nothing is rewritten,
+     * deduped by meaning, or judged for value — the text is stored exactly as
+     * supplied and embedded so it is retrievable. Empty text is the only
+     * refusal. `speaker` and `occurredAt` join the server's idempotency seed,
+     * so resending an identical payload is recognised (`already_exists: true`)
+     * rather than stored twice. `syncEmbed: true` embeds inline so the row is
+     * immediately queryable. `sessionId` is recorded into `metadata` under
+     * `"session_id"`.
+     *
+     * A `messages` array is not accepted: this endpoint stores exactly one
+     * turn. Earlier releases sent `messages`, which the server has not
+     * accepted since the episodic rewrite — every such call failed with a
+     * 422, so the mistake is now caught client-side with a real explanation.
+     */
     addTurn(req: {
         tenantId: string;
         userId: string;
-        messages: Array<Record<string, unknown>>;
-        sessionId?: string;
+        text: string;
+        speaker?: string;
+        occurredAt?: string;
         metadata?: Record<string, unknown>;
+        source?: string;
+        syncEmbed?: boolean;
+        sessionId?: string;
     }): Promise<Record<string, unknown>>;
     /**
      * Build a prompt-ready context block for an LLM call.

package/dist/index.d.ts

@@ -1317,13 +1317,33 @@ declare class MemorySyncClient {
     }): Promise<Record<string, unknown>>;
     /** Counts and coverage for the knowledge base. */
     knowledgeStats(): Promise<Record<string, unknown>>;
-    /** Add a conversation turn and extract memories from it. */
+    /**
+     * Store one conversational turn VERBATIM (episodic ingestion).
+     *
+     * The sibling of the extraction-gated fact store: nothing is rewritten,
+     * deduped by meaning, or judged for value — the text is stored exactly as
+     * supplied and embedded so it is retrievable. Empty text is the only
+     * refusal. `speaker` and `occurredAt` join the server's idempotency seed,
+     * so resending an identical payload is recognised (`already_exists: true`)
+     * rather than stored twice. `syncEmbed: true` embeds inline so the row is
+     * immediately queryable. `sessionId` is recorded into `metadata` under
+     * `"session_id"`.
+     *
+     * A `messages` array is not accepted: this endpoint stores exactly one
+     * turn. Earlier releases sent `messages`, which the server has not
+     * accepted since the episodic rewrite — every such call failed with a
+     * 422, so the mistake is now caught client-side with a real explanation.
+     */
     addTurn(req: {
         tenantId: string;
         userId: string;
-        messages: Array<Record<string, unknown>>;
-        sessionId?: string;
+        text: string;
+        speaker?: string;
+        occurredAt?: string;
         metadata?: Record<string, unknown>;
+        source?: string;
+        syncEmbed?: boolean;
+        sessionId?: string;
     }): Promise<Record<string, unknown>>;
     /**
      * Build a prompt-ready context block for an LLM call.

package/dist/index.js

@@ -576,7 +576,7 @@ var IntegrationsNamespace = class extends Namespace {
 };
 
 // src/control-plane.ts
-var SDK_VERSION = "1.9.0";
+var SDK_VERSION = "1.9.1";
 function safeJson(text) {
   try {
     return JSON.parse(text);
@@ -1148,7 +1148,7 @@ function asSkipped(raw, defaultReason) {
   }
   return null;
 }
-var SDK_VERSION2 = "1.9.0";
+var SDK_VERSION2 = "1.9.1";
 function camelToSnakeKey(key) {
   return key.replace(/([A-Z])/g, "_$1").toLowerCase();
 }
@@ -1866,15 +1866,46 @@ var MemorySyncClient = class {
     return await this.request("GET", "/memory/knowledge/stats") ?? {};
   }
   // ── v1 data plane ──────────────────────────────────────────────────
-  /** Add a conversation turn and extract memories from it. */
+  /**
+   * Store one conversational turn VERBATIM (episodic ingestion).
+   *
+   * The sibling of the extraction-gated fact store: nothing is rewritten,
+   * deduped by meaning, or judged for value — the text is stored exactly as
+   * supplied and embedded so it is retrievable. Empty text is the only
+   * refusal. `speaker` and `occurredAt` join the server's idempotency seed,
+   * so resending an identical payload is recognised (`already_exists: true`)
+   * rather than stored twice. `syncEmbed: true` embeds inline so the row is
+   * immediately queryable. `sessionId` is recorded into `metadata` under
+   * `"session_id"`.
+   *
+   * A `messages` array is not accepted: this endpoint stores exactly one
+   * turn. Earlier releases sent `messages`, which the server has not
+   * accepted since the episodic rewrite — every such call failed with a
+   * 422, so the mistake is now caught client-side with a real explanation.
+   */
   async addTurn(req) {
+    if (req.messages !== void 0) {
+      throw new ValidationError(
+        "addTurn() stores exactly one verbatim turn and takes text, not messages. Format the turn as a string (e.g. 'user: I always fly with the window seat.') and pass it as text, with the author in speaker."
+      );
+    }
+    if (!req.text?.trim()) {
+      throw new ValidationError("addTurn() requires non-empty text");
+    }
+    let metadata = req.metadata;
+    if (req.sessionId !== void 0) {
+      metadata = { ...req.metadata ?? {}, session_id: req.sessionId };
+    }
     const body = {
       tenant_id: req.tenantId,
       user_id: req.userId,
-      messages: req.messages
+      source: req.source ?? "chat",
+      text: req.text
     };
-    if (req.sessionId !== void 0) body.session_id = req.sessionId;
-    if (req.metadata !== void 0) body.metadata = req.metadata;
+    if (req.speaker !== void 0) body.speaker = req.speaker;
+    if (req.occurredAt !== void 0) body.occurred_at = req.occurredAt;
+    if (metadata !== void 0) body.metadata = metadata;
+    if (req.syncEmbed) body.sync_embed = true;
     return await this.request("POST", "/v1/memory/add_turn", { body }) ?? {};
   }
   /**