@maximem/synap-js-sdk 0.4.3 → 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,
@@ -229,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 ?? {};
@@ -285,9 +285,16 @@ var HttpTransport = class {
   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;
@@ -435,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") {
@@ -462,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);
@@ -536,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");
@@ -554,6 +589,7 @@ 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(
@@ -959,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;
@@ -1229,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", {
@@ -1317,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;
@@ -1377,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 ?? []
       });
@@ -2422,8 +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 iso2 = whoami["user_context_isolation"];
-      this.#transport.userContextIsolation = typeof iso2 === "string" ? iso2 : void 0;
+      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 } : {}
@@ -2712,6 +2774,7 @@ export {
   AnticipationCache,
   AuthenticationError,
   BM25,
+  COMPACTION_LEVELS,
   CONTRACT,
   ConflictError,
   ConnectionError,