@maximem/synap-js-sdk 0.5.4 → 0.5.7

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 },
@@ -537,6 +538,7 @@ function buildFetchRequest(scope, options) {
   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");
@@ -553,6 +555,7 @@ function buildFetchRequest(scope, options) {
   };
   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;
   }
@@ -628,9 +631,14 @@ 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),
+    saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, null),
     temporalConfidence: pick(item["temporalConfidence"], item.temporal_confidence, 0)
@@ -644,7 +652,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 = {}) {
@@ -656,7 +665,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 = {}) {
@@ -667,7 +677,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 = {}) {
@@ -678,7 +689,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 = {}) {
@@ -686,13 +698,15 @@ function normalizeTemporalEvent(item = {}) {
     id: item.id || "",
     content: item.content || "",
     eventDate: pick(item["eventDate"], item.event_date, null),
+    saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, ""),
     temporalConfidence: pick(item["temporalConfidence"], item.temporal_confidence, 0),
     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 = {}) {
@@ -748,6 +762,7 @@ var dt = (v) => v ? String(v) : null;
 function temporal(item) {
   return {
     event_date: dt(item["event_date"]),
+    said_at: dt(item["said_at"]),
     valid_until: dt(item["valid_until"]),
     temporal_category: item["temporal_category"] ?? null,
     temporal_confidence: n(item["temporal_confidence"], 0)
@@ -866,8 +881,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;
@@ -953,6 +993,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", {
@@ -1457,7 +1514,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-VWKINE47.js");
       const onContext = options.on_context ?? options.onContext;
       const onDisconnect = options.on_disconnect ?? options.onDisconnect;
       const onReconnect = options.on_reconnect ?? options.onReconnect;
@@ -1629,7 +1686,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.4";
+var SDK_VERSION = "0.5.7";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2058,6 +2115,7 @@ function normalise(item) {
     detected_at: pick2(item, "detected_at", "extracted_at", "created_at") ?? null,
     metadata: pick2(item, "metadata") ?? {},
     event_date: pick2(item, "event_date") ?? null,
+    said_at: pick2(item, "said_at") ?? null,
     valid_until: pick2(item, "valid_until") ?? null,
     temporal_category: pick2(item, "temporal_category") ?? null,
     temporal_confidence: Number(pick2(item, "temporal_confidence") ?? 0)
@@ -2132,6 +2190,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"];
@@ -2629,6 +2691,7 @@ var SynapClient = class {
       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,
@@ -2699,7 +2762,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(
@@ -2898,6 +2965,7 @@ var SynapClient = class {
       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,
@@ -2916,7 +2984,8 @@ var SynapClient = class {
       // 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
+      query_date: queryDate,
+      max_results_per_query: maxResultsPerQuery
     };
     const labels = [];
     const tasks = [];
@@ -3026,7 +3095,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 {
     }
@@ -3165,6 +3239,7 @@ export {
   DEFAULT_TIMEOUTS,
   DOCUMENT_TYPES,
   ENDPOINTS,
+  FORGET_MODES,
   HttpTransport,
   INGEST_MODES,
   ITEM_COLLECTIONS,