memorysync-sdk 1.7.3 → 1.8.0

package/dist/index.d.mts

@@ -807,6 +807,17 @@ interface AddRequest {
     sessionId?: string;
     metadata?: Record<string, unknown>;
     endUserId?: string;
+    /**
+     * Your own identifier for this record, at most 128 characters.
+     *
+     * Send it and re-sending the record is recognised rather than stored a second
+     * time: the call resolves to an {@link AddSkippedResponse} with reason
+     * `already_ingested` and the ids the first write produced. That makes an
+     * interrupted write safe to retry without first checking whether it landed.
+     * Near-duplicate detection is always on but compares *meaning*, so it is a
+     * filter and not a guarantee.
+     */
+    clientRef?: string;
 }
 interface MemoryRecord {
     id: number;
@@ -832,6 +843,16 @@ interface AddSkippedResponse {
 type AddResponse = MemoryRecord | AddSkippedResponse;
 interface BulkAddItem {
     text: string;
+    /**
+     * Your own identifier for this record, at most 128 characters.
+     *
+     * Send it and re-submitting the record is recognised rather than stored a
+     * second time: the item comes back `skipped` with reason `already_ingested`
+     * and the ids the first submission produced. This is what makes a large import
+     * safe to re-run. Near-duplicate detection is always on but compares
+     * *meaning*, so it is a filter and not a guarantee.
+     */
+    clientRef?: string;
     source?: string;
     eventType?: string;
     tags?: string[];

package/dist/index.d.ts

@@ -807,6 +807,17 @@ interface AddRequest {
     sessionId?: string;
     metadata?: Record<string, unknown>;
     endUserId?: string;
+    /**
+     * Your own identifier for this record, at most 128 characters.
+     *
+     * Send it and re-sending the record is recognised rather than stored a second
+     * time: the call resolves to an {@link AddSkippedResponse} with reason
+     * `already_ingested` and the ids the first write produced. That makes an
+     * interrupted write safe to retry without first checking whether it landed.
+     * Near-duplicate detection is always on but compares *meaning*, so it is a
+     * filter and not a guarantee.
+     */
+    clientRef?: string;
 }
 interface MemoryRecord {
     id: number;
@@ -832,6 +843,16 @@ interface AddSkippedResponse {
 type AddResponse = MemoryRecord | AddSkippedResponse;
 interface BulkAddItem {
     text: string;
+    /**
+     * Your own identifier for this record, at most 128 characters.
+     *
+     * Send it and re-submitting the record is recognised rather than stored a
+     * second time: the item comes back `skipped` with reason `already_ingested`
+     * and the ids the first submission produced. This is what makes a large import
+     * safe to re-run. Near-duplicate detection is always on but compares
+     * *meaning*, so it is a filter and not a guarantee.
+     */
+    clientRef?: string;
     source?: string;
     eventType?: string;
     tags?: string[];

package/dist/index.js

@@ -576,7 +576,7 @@ var IntegrationsNamespace = class extends Namespace {
 };
 
 // src/control-plane.ts
-var SDK_VERSION = "1.7.3";
+var SDK_VERSION = "1.8.0";
 function safeJson(text) {
   try {
     return JSON.parse(text);
@@ -1148,7 +1148,7 @@ function asSkipped(raw, defaultReason) {
   }
   return null;
 }
-var SDK_VERSION2 = "1.7.3";
+var SDK_VERSION2 = "1.8.0";
 function camelToSnakeKey(key) {
   return key.replace(/([A-Z])/g, "_$1").toLowerCase();
 }
@@ -1315,6 +1315,7 @@ var MemorySyncClient = class {
     if (req.sessionId !== void 0) body.session_id = req.sessionId;
     if (req.metadata !== void 0) body.metadata = req.metadata;
     if (req.endUserId !== void 0) body.end_user_id = req.endUserId;
+    if (req.clientRef !== void 0) body.client_ref = req.clientRef;
     const raw = await this.request("POST", "/memory/add", {
       body,
       endUserOverride: req.endUserId
@@ -1335,6 +1336,7 @@ var MemorySyncClient = class {
         if (i.metadata !== void 0) o.metadata = i.metadata;
         if (i.importance !== void 0) o.importance = i.importance;
         if (i.endUserId !== void 0) o.end_user_id = i.endUserId;
+        if (i.clientRef !== void 0) o.client_ref = i.clientRef;
         return o;
       }),
       deduplicate: opts.deduplicate ?? true