@maximem/synap-js-sdk 0.4.2 → 0.4.4

package/dist/index.js

@@ -22,7 +22,7 @@ import {
   TranscriptConflictError,
   TransientError,
   isSynapError
-} from "./chunk-T3NZBIV2.js";
+} from "./chunk-OCMM2Z5P.js";
 import {
   ANY_SCOPE,
   AnticipationCache,
@@ -200,6 +200,16 @@ var Heartbeat = class {
   }
 };
 
+// src/scoping.ts
+var B2C_ISOLATION = "equals_customer";
+function checkCustomerId(isolation, customerId, where, instanceId) {
+  if (customerId === void 0 || customerId === null || customerId === "") return;
+  if (isolation !== B2C_ISOLATION) return;
+  throw new InvalidInputError(
+    `${where}: customer_id is not accepted on this instance${instanceId ? ` (${instanceId})` : ""}, which is B2C (user_context_isolation='${B2C_ISOLATION}'). Send user_id only; it is the whole identity, and the server files and reads your data under it. Received customer_id=${JSON.stringify(customerId)}.`
+  );
+}
+
 // src/transport/http.ts
 var DEFAULT_BASE_URL = "https://synap-cloud-prod.maximem.ai";
 var DEFAULT_TIMEOUTS = { connect: 5, read: 30, write: 10 };
@@ -219,7 +229,7 @@ var HttpTransport = class {
     this.#credentials = options.credentials;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
-    this.retryPolicy = { ...DEFAULT_RETRY_POLICY, ...options.retryPolicy };
+    this.retryPolicy = options.retryPolicy === null ? { ...DEFAULT_RETRY_POLICY, maxAttempts: 1 } : { ...DEFAULT_RETRY_POLICY, ...options.retryPolicy };
     this.userAgent = options.userAgent ?? "@maximem/synap-js-sdk";
     this.fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
     this.keepAliveOptions = options.keepAlive ?? {};
@@ -253,12 +263,38 @@ var HttpTransport = class {
   updateCredentials(patch) {
     this.#credentials = { ...this.#credentials, ...patch };
   }
+  /**
+   * The instance's scoping mode, from whoami. Lives here rather than on the
+   * client because every interface factory already receives the transport,
+   * and it is per-client, so a module-level global would be wrong the moment a
+   * process holds two clients.
+   *
+   * undefined means the server did not report it, which is true of any
+   * deployment older than the field, and must mean "enforce nothing".
+   */
+  userContextIsolation = void 0;
+  /** Refuse a customer_id on a B2C instance, at the call site. */
+  checkCustomerId(customerId, where) {
+    checkCustomerId(
+      this.userContextIsolation,
+      customerId,
+      where,
+      this.#credentials.instanceId
+    );
+  }
   setTimeouts(timeouts) {
     this.timeouts = { ...this.timeouts, ...timeouts };
   }
-  /** `null` restores the default policy, matching Python's `retry_policy=None`. */
+  /**
+   * `null` DISABLES retries, matching Python.
+   *
+   * Python's `SDKConfig(retry_policy=None)` leaves `self.retry_policy` unset and
+   * `max_attempts` falls to 1 (http_client.py:180). We restored the default
+   * policy instead, so a caller following the "Disabling Retries" documentation
+   * got three attempts and no way to turn them off.
+   */
   setRetryPolicy(policy) {
-    this.retryPolicy = policy === null ? { ...DEFAULT_RETRY_POLICY } : { ...this.retryPolicy, ...policy };
+    this.retryPolicy = policy === null ? { ...DEFAULT_RETRY_POLICY, maxAttempts: 1 } : { ...this.retryPolicy, ...policy };
   }
   close() {
     this.closed = true;
@@ -406,7 +442,9 @@ async function toHttpError(response, correlationId) {
       return new InsufficientCreditsError(message, {
         ...opts,
         balanceCredits: numberOrNull(parsed["balance_credits"]),
-        requiredCredits: numberOrNull(parsed["required_credits"])
+        requiredCredits: numberOrNull(parsed["minimum_required_credits"]) ?? numberOrNull(parsed["required_credits"]),
+        recoveryUrl: stringOrNull(parsed["recovery_url"]),
+        redeemUrl: stringOrNull(parsed["redeem_url"])
       });
     case 409:
       if (detailObject !== null && detailObject["code"] === "transcript_conflict") {
@@ -433,6 +471,9 @@ async function toHttpError(response, correlationId) {
 function numberOrNull(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : null;
 }
+function stringOrNull(v) {
+  return typeof v === "string" && v !== "" ? v : null;
+}
 function withTimeout(ms, external) {
   const controller = new AbortController();
   const onExternalAbort = () => controller.abort(external?.reason);
@@ -507,9 +548,32 @@ function buildFetchRequest(scope, options) {
   }
   switch (scope) {
     case "user":
-      if (!userId) throw new InvalidInputError("user_id is required");
-      body["user_id"] = userId;
-      if (customerId !== void 0) body["customer_id"] = customerId;
+      {
+        if (!userId) throw new InvalidInputError("user_id is required");
+        body["user_id"] = userId;
+        const scopePath = opt(options, "scope_path", "scopePath");
+        if (scopePath !== void 0) body["scope"] = scopePath;
+        const contextMode = opt(options, "context_mode", "contextMode") ?? "in-conversation";
+        if (!VALID_CONTEXT_MODES.includes(contextMode)) {
+          throw new InvalidInputError(
+            `Invalid context_mode '${contextMode}'. Must be one of: ${VALID_CONTEXT_MODES.join(", ")}`
+          );
+        }
+        const lastN = opt(options, "last_n_conversations", "lastNConversations") ?? 1;
+        if (!Number.isInteger(lastN)) {
+          throw new InvalidInputError("last_n_conversations must be an integer");
+        }
+        if (lastN < 0 || lastN > 20) {
+          throw new InvalidInputError("last_n_conversations must be between 0 and 20");
+        }
+        if (contextMode === "conversation-summary") {
+          body["context_mode"] = contextMode;
+          body["include_profile"] = opt(options, "include_profile", "includeProfile") ?? true;
+          body["last_n_conversations"] = lastN;
+        }
+        if (customerId !== void 0) body["customer_id"] = customerId;
+        break;
+      }
       break;
     case "customer":
       if (!customerId) throw new InvalidInputError("customer_id is required");
@@ -525,8 +589,13 @@ function buildFetchRequest(scope, options) {
   }
   return { endpoint: ENDPOINT_BY_SCOPE[scope], body };
 }
+var VALID_CONTEXT_MODES = ["in-conversation", "conversation-summary"];
 async function fetchContext(transport, scope, options = {}, hooks = {}) {
   const startedAt = Date.now();
+  transport.checkCustomerId(
+    opt(options, "customer_id", "customerId"),
+    `${scope}.context.fetch`
+  );
   const anticipated = hooks.beforeFetch?.(scope, options) ?? null;
   if (anticipated !== null) {
     hooks.onServedFromCache?.(scope, options, anticipated);
@@ -787,6 +856,8 @@ var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "error",
 function createMemoriesInterface(transport) {
   return {
     async create(options) {
+      const o2 = options;
+      transport.checkCustomerId(o2["customer_id"] ?? o2["customerId"], "memories.create");
       return transport.request("memories_create", { body: buildCreateBody(options) });
     },
     async batch_create(options) {
@@ -803,7 +874,7 @@ function createMemoriesInterface(transport) {
       const userId = options.user_id ?? options.userId;
       const customerId = options.customer_id ?? options.customerId;
       if (!userId) throw new InvalidInputError("user_id is required");
-      if (!customerId) throw new InvalidInputError("customer_id is required");
+      transport.checkCustomerId(customerId, "memories.create_from_file");
       const filePath = options.file_path ?? options.filePath;
       const sources = [filePath, options.file, options.text].filter((v) => v !== void 0);
       if (sources.length === 0) {
@@ -924,6 +995,15 @@ function validateInstanceId(instanceId) {
 }
 
 // src/conversation/interface.ts
+var COMPACTION_LEVELS = [
+  "low",
+  "medium",
+  "high",
+  "adaptive",
+  "aggressive",
+  "balanced",
+  "conservative"
+];
 function either2(o2, snake, camel) {
   const a = o2[snake];
   if (a !== void 0) return a;
@@ -946,7 +1026,6 @@ function buildRecordMessageBody(options) {
     throw new InvalidInputError("content is required");
   }
   if (!userId) throw new InvalidInputError("user_id is required");
-  if (!customerId) throw new InvalidInputError("customer_id is required");
   const body = {
     conversation_id: conversationId,
     role: options.role,
@@ -1051,6 +1130,10 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
   };
   return {
     async record_message(options) {
+      transport.checkCustomerId(
+        options["customer_id"] ?? options["customerId"],
+        "conversation.record_message"
+      );
       const body = buildRecordMessageBody(options);
       const result = await transport.request("conversations_messages", { body });
       onTurn({
@@ -1069,6 +1152,13 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       if (!Array.isArray(messages) || messages.length === 0) {
         throw new InvalidInputError("messages must be a non-empty array");
       }
+      for (const m of messages) {
+        const mo = m;
+        transport.checkCustomerId(
+          mo["customer_id"] ?? mo["customerId"],
+          "conversation.record_messages_batch"
+        );
+      }
       const bodies = messages.map(buildRecordMessageBody);
       const result = await transport.request("conversations_messages_batch", {
         body: { messages: bodies }
@@ -1184,15 +1274,26 @@ function createUserNamespace(transport, hooks = {}) {
 }
 
 // src/credits/interface.ts
+function iso2(v) {
+  return v instanceof Date ? v.toISOString() : v;
+}
 function createCreditsNamespace(transport) {
   return {
     async get_balance() {
       return transport.request("credits_balance");
     },
     async get_ledger(options = {}) {
-      return transport.request("credits_ledger", {
-        query: { limit: options.limit ?? 50, offset: options.offset ?? 0 }
-      });
+      const query = {
+        limit: options.limit ?? 100,
+        offset: options.offset ?? 0
+      };
+      const entryType = options.entry_type ?? options.entryType;
+      if (entryType !== void 0) query["entry_type"] = entryType;
+      const from = options.from_time ?? options.fromTime;
+      if (from !== void 0) query["from"] = iso2(from);
+      const to = options.to_time ?? options.toTime;
+      if (to !== void 0) query["to"] = iso2(to);
+      return transport.request("credits_ledger", { query });
     },
     async estimate(options) {
       return transport.request("credits_estimate", {
@@ -1272,7 +1373,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-ME5N5NK4.js");
+      const { GrpcStreamClient } = await import("./stream-client-6V4FGKZ3.js");
       const onContext = options.on_context ?? options.onContext;
       const onDisconnect = options.on_disconnect ?? options.onDisconnect;
       const onReconnect = options.on_reconnect ?? options.onReconnect;
@@ -1332,6 +1433,12 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         session_id: options.session_id ?? options.sessionId ?? "",
         metadata: options.metadata ?? {},
         timestamp_ms: Date.now(),
+        tool_name: options.tool_name ?? options.toolName ?? "",
+        // 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);
+        })(),
         search_queries: options.search_queries ?? options.searchQueries ?? [],
         context_types: options.context_types ?? options.contextTypes ?? []
       });
@@ -2377,6 +2484,8 @@ var SynapClient = class {
       const whoami = await this.#transport.request("whoami", {});
       const resolvedClientId = String(whoami["client_id"] ?? "");
       const resolvedInstanceId = String(whoami["instance_id"] ?? "");
+      const iso3 = whoami["user_context_isolation"];
+      this.#transport.userContextIsolation = typeof iso3 === "string" ? iso3 : void 0;
       this.#transport.updateCredentials({
         ...resolvedClientId !== "" && credentials.clientId === "" ? { clientId: resolvedClientId } : {},
         ...resolvedInstanceId !== "" && credentials.instanceId === "" ? { instanceId: resolvedInstanceId } : {}
@@ -2665,6 +2774,7 @@ export {
   AnticipationCache,
   AuthenticationError,
   BM25,
+  COMPACTION_LEVELS,
   CONTRACT,
   ConflictError,
   ConnectionError,