@maximem/synap-js-sdk 0.5.2 → 0.5.6

package/dist/index.js

@@ -49,6 +49,7 @@ var ENDPOINTS = {
   memories_get: { method: "GET", path: "/api/v1/memories/{memory_id}", idempotent: true },
   memories_update: { method: "PATCH", path: "/api/v1/memories/{memory_id}", idempotent: false },
   memories_delete: { method: "DELETE", path: "/api/v1/memories/{memory_id}", idempotent: true },
+  memories_forget: { method: "POST", path: "/api/v1/memories/forget", idempotent: false },
   context_fetch_user: { method: "POST", path: "/v1/context/user/fetch", idempotent: true },
   context_fetch_customer: { method: "POST", path: "/v1/context/customer/fetch", idempotent: true },
   context_fetch_client: { method: "POST", path: "/v1/context/client/fetch", idempotent: true },
@@ -536,6 +537,8 @@ function buildFetchRequest(scope, options) {
   const searchQuery = opt(options, "search_query", "searchQuery");
   const maxResults = opt(options, "max_results", "maxResults") ?? 10;
   const precisionLevel = opt(options, "precision_level", "precisionLevel") ?? "high";
+  const queryDate = opt(options, "query_date", "queryDate");
+  const perQuery = opt(options, "max_results_per_query", "maxResultsPerQuery");
   const mode = options.mode ?? "fast";
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
     throw new InvalidInputError("search_query must be an array when provided");
@@ -551,6 +554,8 @@ function buildFetchRequest(scope, options) {
     mode
   };
   if (precisionLevel !== "high") body["precision_level"] = precisionLevel;
+  if (queryDate) body["query_date"] = queryDate;
+  if (perQuery) body["max_results_per_query"] = perQuery;
   if (options.include_conversation_context === false) {
     body["include_conversation_context"] = false;
   }
@@ -626,6 +631,10 @@ function pick(...values) {
   return pickDefined(...values);
 }
 var obj = (v) => v ?? {};
+function matchedQueries(item = {}) {
+  const raw = item["matchedQueries"] ?? item.matched_queries;
+  return Array.isArray(raw) ? raw : [];
+}
 function normalizeTemporalFields(item = {}) {
   return {
     eventDate: pick(item["eventDate"], item.event_date, null),
@@ -642,7 +651,8 @@ function normalizeFact(item = {}) {
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizePreference(item = {}) {
@@ -654,7 +664,8 @@ function normalizePreference(item = {}) {
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeEpisode(item = {}) {
@@ -665,7 +676,8 @@ function normalizeEpisode(item = {}) {
     significance: pick(item["significance"], item.confidence, 0),
     participants: item["participants"] || [],
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeEmotion(item = {}) {
@@ -676,7 +688,8 @@ function normalizeEmotion(item = {}) {
     detectedAt: pick(item["detectedAt"], item["detected_at"], null),
     context: item["context"] || "",
     metadata: obj(item.metadata),
-    ...normalizeTemporalFields(item)
+    ...normalizeTemporalFields(item),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeTemporalEvent(item = {}) {
@@ -690,7 +703,8 @@ function normalizeTemporalEvent(item = {}) {
     confidence: pick(item.confidence, 0),
     source: item.source || "",
     extractedAt: pick(item["extractedAt"], item.extracted_at, null),
-    metadata: obj(item.metadata)
+    metadata: obj(item.metadata),
+    matchedQueries: matchedQueries(item)
   };
 }
 function normalizeContextMetadata(metadata = {}) {
@@ -864,8 +878,33 @@ function buildCreateBody(options) {
     metadata: options.metadata ?? {}
   };
 }
+var FORGET_MODES = ["preview", "direct"];
+var FORGET_DESCRIPTION_MIN = 3;
+var FORGET_DESCRIPTION_MAX = 500;
+function buildForgetBody(options) {
+  const description = options.description;
+  if (typeof description !== "string" || description.length < FORGET_DESCRIPTION_MIN || description.length > FORGET_DESCRIPTION_MAX) {
+    throw new InvalidInputError(
+      `description must be between ${FORGET_DESCRIPTION_MIN} and ${FORGET_DESCRIPTION_MAX} characters`
+    );
+  }
+  const mode = options.mode ?? "preview";
+  if (!FORGET_MODES.includes(mode)) {
+    throw new InvalidInputError(
+      `Invalid mode '${mode}'. Expected one of: ${FORGET_MODES.join(", ")}`
+    );
+  }
+  const o2 = options;
+  return {
+    description,
+    user_id: either(o2, "user_id", "userId") ?? null,
+    customer_id: either(o2, "customer_id", "customerId") ?? null,
+    scope: options.scope ?? null,
+    mode
+  };
+}
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "error", "cancelled"]);
-function createMemoriesInterface(transport) {
+function createMemoriesInterface(transport, onForgotten) {
   return {
     async create(options) {
       const o2 = options;
@@ -951,6 +990,23 @@ function createMemoriesInterface(transport) {
       }
       return transport.request("memories_delete", { pathParams: { memory_id: memoryId } });
     },
+    async forget(options) {
+      const o2 = options;
+      transport.checkCustomerId(o2["customer_id"] ?? o2["customerId"], "memories.forget");
+      const body = buildForgetBody(options);
+      const result = await transport.request("memories_forget", { body });
+      const removed = !!result?.deleted_ids?.length || result?.status === "deleted" || result?.status === "partial";
+      if (removed && onForgotten) {
+        try {
+          onForgotten({
+            userId: body["user_id"] ?? null,
+            customerId: body["customer_id"] ?? null
+          });
+        } catch {
+        }
+      }
+      return result;
+    },
     async status(ingestionId) {
       if (!ingestionId) throw new InvalidInputError("ingestion_id is required");
       return transport.request("memories_status", {
@@ -1391,7 +1447,22 @@ var KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
 ]);
 function toolResultJson(result) {
   if (result === void 0 || result === null) return "";
-  return typeof result === "string" ? result : JSON.stringify(result);
+  return typeof result === "string" ? result : jsonOrText(result);
+}
+function jsonOrText(value) {
+  try {
+    const out = JSON.stringify(
+      value,
+      (_k, v) => typeof v === "bigint" ? String(v) : v
+    );
+    return out === void 0 ? String(value) : out;
+  } catch {
+    try {
+      return String(value);
+    } catch {
+      return "";
+    }
+  }
 }
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
@@ -1440,7 +1511,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       if (client !== null) {
         throw new ListeningAlreadyActiveError("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await import("./stream-client-5CGJNTH4.js");
+      const { GrpcStreamClient } = await import("./stream-client-Y5NFAMIH.js");
       const onContext = options.on_context ?? options.onContext;
       const onDisconnect = options.on_disconnect ?? options.onDisconnect;
       const onReconnect = options.on_reconnect ?? options.onReconnect;
@@ -1538,7 +1609,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         // Python serialises tool_args with json.dumps into tool_args_json.
         tool_args_json: (() => {
           const a = options.tool_args ?? options.toolArgs;
-          return a === void 0 ? "" : JSON.stringify(a);
+          return a === void 0 ? "" : jsonOrText(a);
         })(),
         tool_result_json: toolResultJson(options.tool_result ?? options.toolResult),
         tool_call_id: options.tool_call_id ?? options.toolCallId ?? "",
@@ -1612,7 +1683,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.2";
+var SDK_VERSION = "0.5.6";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2115,6 +2186,10 @@ function tryServeFromCache(cache, scope, params, maxItems) {
     return { response: null, hit: null };
   }
 }
+function distinctQueryCount(searchQuery) {
+  if (!Array.isArray(searchQuery)) return 0;
+  return new Set(searchQuery.filter((q) => typeof q === "string" && q.length > 0)).size;
+}
 
 // src/context/assembled.ts
 var COLLECTIONS2 = ["facts", "preferences", "episodes", "emotions", "temporal_events"];
@@ -2611,6 +2686,8 @@ var SynapClient = class {
     this.#fetchHooks = {
       beforeFetch: (scope, options2) => {
         const o2 = options2;
+        if (o2["query_date"] ?? o2["queryDate"]) return null;
+        if (o2["max_results_per_query"] ?? o2["maxResultsPerQuery"]) return null;
         const attempt = tryServeFromCache(
           this.#anticipationCache,
           scope,
@@ -2681,7 +2758,11 @@ var SynapClient = class {
         compacted: (conversationId, format) => this.#localCompacted(conversationId, format)
       }
     );
-    this.memories = createMemoriesInterface(this.#transport);
+    this.memories = createMemoriesInterface(this.#transport, ({ userId, customerId }) => {
+      for (const id of /* @__PURE__ */ new Set([userId, customerId])) {
+        if (id) this.#anticipationCache.dropEntity(id);
+      }
+    });
     this.credits = createCreditsNamespace(this.#transport);
     this.cache = createCacheNamespace(this.#anticipationCache);
     this.instance = createInstanceNamespace(
@@ -2879,6 +2960,8 @@ var SynapClient = class {
       types,
       mode = "fast",
       precision_level: precisionLevel = "high",
+      query_date: queryDate,
+      max_results_per_query: maxResultsPerQuery,
       include_conversation_context: includeConversationContext = true,
       scopes,
       include_scope_labels: includeScopeLabels = false,
@@ -2893,7 +2976,12 @@ var SynapClient = class {
       max_results: maxResults,
       types,
       mode,
-      precision_level: precisionLevel
+      precision_level: precisionLevel,
+      // In `shared` so it reaches all four branches at once. The Python edit
+      // threaded three call sites by hand and missed the client branch, which
+      // sits one indent deeper; spreading removes that whole class of miss.
+      query_date: queryDate,
+      max_results_per_query: maxResultsPerQuery
     };
     const labels = [];
     const tasks = [];
@@ -3003,7 +3091,12 @@ var SynapClient = class {
         served_item_ids: served.servedItemIds,
         scope,
         source_bundle_ids: served.bundleId ? [served.bundleId] : [],
-        timestamp_ms: Date.now()
+        timestamp_ms: Date.now(),
+        // How many distinct search queries the fetch carried. A hit never
+        // reaches the fetch route, so this event is how the server learns it
+        // happened and what it is charged by. The count only: this event must
+        // not carry the caller's words.
+        query_count: distinctQueryCount(options["search_query"] ?? options["searchQuery"])
       });
     } catch {
     }
@@ -3142,6 +3235,7 @@ export {
   DEFAULT_TIMEOUTS,
   DOCUMENT_TYPES,
   ENDPOINTS,
+  FORGET_MODES,
   HttpTransport,
   INGEST_MODES,
   ITEM_COLLECTIONS,