@maximem/synap-js-sdk 0.4.3 → 0.4.5

package/dist/index.js

@@ -22,7 +22,7 @@ import {
   TranscriptConflictError,
   TransientError,
   isSynapError
-} from "./chunk-T3NZBIV2.js";
+} from "./chunk-OCMM2Z5P.js";
 import {
   ANY_SCOPE,
   AnticipationCache,
@@ -212,7 +212,12 @@ function checkCustomerId(isolation, customerId, where, instanceId) {
 
 // src/transport/http.ts
 var DEFAULT_BASE_URL = "https://synap-cloud-prod.maximem.ai";
-var DEFAULT_TIMEOUTS = { connect: 5, read: 30, write: 10 };
+var DEFAULT_TIMEOUTS = {
+  connect: 5,
+  read: 30,
+  write: 10,
+  streamIdle: 60
+};
 var HttpTransport = class {
   baseUrl;
   // Mutable so `configure()` can adjust them before the first request, and so
@@ -229,7 +234,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 +290,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 +447,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 +476,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 +553,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 +594,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 +1000,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;
@@ -1076,7 +1126,7 @@ var CompactionSubscribers = class {
 function createConversationNamespace(transport, subscribers = new CompactionSubscribers(), onWrite = () => {
 }, onTurn = () => {
 }, onFetched = () => {
-}) {
+}, localShortTerm = { prompt: () => null, compacted: () => null }) {
   const convId = (v) => {
     const id = typeof v === "string" ? v : v.conversation_id ?? v.conversationId;
     if (!id) throw new InvalidInputError("conversation_id is required");
@@ -1157,6 +1207,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       },
       get_context_for_prompt: async (options = {}) => {
         const id = convId(options);
+        const local = localShortTerm.prompt(id, options.style ?? "structured");
+        if (local !== null) return local;
         const result = await transport.request("context_for_prompt", {
           pathParams: { conversation_id: id },
           query: { style: options.style ?? "structured" }
@@ -1168,6 +1220,10 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       },
       get_compacted: async (options) => {
         const id = convId(options);
+        if (options.version === void 0) {
+          const local = localShortTerm.compacted(id, options.format ?? "structured");
+          if (local !== null) return local;
+        }
         const query = { format: options.format ?? "structured" };
         if (options.version !== void 0) query["version"] = options.version;
         try {
@@ -1229,15 +1285,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", {
@@ -1287,6 +1354,18 @@ function envTls() {
   if (raw === void 0 || raw === "") return void 0;
   return !["0", "false", "no", "off"].includes(raw.trim().toLowerCase());
 }
+function thinkingMetadata(options) {
+  const md = { ...options.metadata ?? {} };
+  const step = options.step_index ?? options.stepIndex;
+  if (step !== void 0 && md["step_index"] === void 0) {
+    md["step_index"] = String(step);
+  }
+  const kind = options.thought_type ?? options.thoughtType;
+  if (kind && md["thought_type"] === void 0) {
+    md["thought_type"] = kind;
+  }
+  return md;
+}
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
   let dispatchCompaction = null;
@@ -1317,7 +1396,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 +1456,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 ?? []
       });
@@ -1392,7 +1477,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         user_id: options.user_id ?? options.userId ?? "",
         customer_id: options.customer_id ?? options.customerId ?? "",
         session_id: options.session_id ?? options.sessionId ?? "",
-        metadata: options.metadata ?? {},
+        metadata: thinkingMetadata(options),
         timestamp_ms: Date.now()
       });
     },
@@ -1575,11 +1660,11 @@ var ShortTermStore = class {
 // src/context/overlay.ts
 var MAX_TURNS = 20;
 var TOKEN_BUDGET = 2e3;
-function verbatimOverlayEnabled() {
+function verbatimOverlayEnabled(configured) {
   const raw = (getEnv("SYNAP_ST_VERBATIM_OVERLAY") ?? "").trim().toLowerCase();
   if (["0", "false", "no", "off"].includes(raw)) return false;
   if (["1", "true", "yes", "on"].includes(raw)) return true;
-  return true;
+  return configured ?? true;
 }
 function estimateTokens(turn) {
   return Math.max(1, Math.floor(String(turn.content ?? "").length / 4));
@@ -1593,13 +1678,13 @@ function budgetRecentTurns(turns) {
   }
   return windowed;
 }
-function overlayLocalRecentTurns(response, store, conversationId) {
+function overlayLocalRecentTurns(response, store, conversationId, configured) {
   if (conversationId === void 0 || conversationId === "") return;
   try {
     const entry = store.get(conversationId);
     if (entry === null) return;
     const existing = response.conversation_context ?? null;
-    if (existing !== null && !verbatimOverlayEnabled()) return;
+    if (existing !== null && !verbatimOverlayEnabled(configured)) return;
     const localTurns = budgetRecentTurns(entry.recentTurns);
     const serverField = (name) => existing === null ? void 0 : existing[name];
     const orLocal = (name, local) => {
@@ -1621,6 +1706,158 @@ function overlayLocalRecentTurns(response, store, conversationId) {
   }
 }
 
+// src/context/local-prompt.ts
+var SUPPORTED_STYLES = ["structured", "narrative", "bullet_points"];
+var DEFAULT_STYLE = "structured";
+function stringify(value) {
+  if (value === null || value === void 0) return "";
+  const t = typeof value;
+  if (t === "string" || t === "number" || t === "boolean") return String(value);
+  try {
+    return JSON.stringify(value) ?? "";
+  } catch {
+    return String(value);
+  }
+}
+function asListOfObjects(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) {
+    const out = [];
+    for (const v of value) {
+      if (v && typeof v === "object" && !Array.isArray(v)) out.push(v);
+      else if (typeof v === "string") out.push({ content: v });
+    }
+    return out;
+  }
+  if (typeof value === "object") return [value];
+  return [];
+}
+function itemText(item) {
+  return item["content"] || item["text"] || stringify(item);
+}
+function buildRecentMessages(turns) {
+  return (turns ?? []).map((t, idx) => ({
+    role: t.role || "user",
+    content: t.content ?? "",
+    timestamp: t.timestamp,
+    message_id: `local-${idx}`
+  }));
+}
+function compactedMessageCount(_entry) {
+  return 0;
+}
+function formatStructured(entry, recent) {
+  const parts = [];
+  if (entry.summary) {
+    parts.push("## Summary");
+    parts.push(entry.summary.trim());
+  }
+  if (entry.factualParagraph) {
+    parts.push("## Facts");
+    parts.push(entry.factualParagraph.trim());
+  }
+  if (entry.conversationalParagraph) {
+    parts.push("## Conversation");
+    parts.push(entry.conversationalParagraph.trim());
+  }
+  const cs = entry.currentState ?? {};
+  if (Object.keys(cs).length > 0) {
+    parts.push("## Current State");
+    for (const [k, v] of Object.entries(cs)) parts.push(`- ${k}: ${stringify(v)}`);
+  }
+  const ke = entry.keyExtractions ?? {};
+  if (Object.keys(ke).length > 0) {
+    parts.push("## Key Extractions");
+    for (const [cat, items] of Object.entries(ke)) {
+      if (!items) continue;
+      parts.push(`### ${cat}`);
+      for (const it of asListOfObjects(items)) parts.push(`- ${itemText(it)}`);
+    }
+  }
+  if (recent.length > 0) {
+    parts.push(`## Recent Turns (${recent.length})`);
+    for (const m of recent) parts.push(`**${m.role}**: ${m.content}`);
+  }
+  return parts.filter(Boolean).join("\n\n").trim();
+}
+function formatNarrative(entry, recent) {
+  const parts = [];
+  if (entry.summary) parts.push(entry.summary.trim());
+  if (entry.conversationalParagraph) parts.push(entry.conversationalParagraph.trim());
+  else if (entry.factualParagraph) parts.push(entry.factualParagraph.trim());
+  if (recent.length > 0) {
+    const tail = recent.map((m) => `${m.role}: ${m.content}`).join("\n");
+    parts.push(`Recent exchanges:
+${tail}`);
+  }
+  return parts.filter(Boolean).join("\n\n").trim();
+}
+function formatBullets(entry, recent) {
+  const parts = [];
+  if (entry.summary) parts.push(`- Summary: ${entry.summary.trim()}`);
+  for (const [k, v] of Object.entries(entry.currentState ?? {})) {
+    parts.push(`- ${k}: ${stringify(v)}`);
+  }
+  for (const [cat, items] of Object.entries(entry.keyExtractions ?? {})) {
+    for (const it of asListOfObjects(items)) parts.push(`- (${cat}) ${itemText(it)}`);
+  }
+  for (const m of recent) parts.push(`- ${m.role}: ${m.content}`);
+  return parts.join("\n").trim();
+}
+function formatBlock(entry, recent, style) {
+  if (style === "narrative") return formatNarrative(entry, recent);
+  if (style === "bullet_points") return formatBullets(entry, recent);
+  return formatStructured(entry, recent);
+}
+function renderForPrompt(entry, style = DEFAULT_STYLE, now = Date.now) {
+  const chosen = SUPPORTED_STYLES.includes(style) ? style : DEFAULT_STYLE;
+  const recent = buildRecentMessages(entry.recentTurns);
+  const formatted = formatBlock(entry, recent, chosen);
+  const available = entry.compactionId !== null || entry.recentTurns.length > 0;
+  let compactionAge = null;
+  if (entry.compactedAt !== null) {
+    const parsed = Date.parse(entry.compactedAt);
+    if (!Number.isNaN(parsed)) compactionAge = Math.floor((now() - parsed) / 1e3);
+  }
+  const compacted = compactedMessageCount(entry);
+  return {
+    formatted_context: available ? formatted : null,
+    available,
+    is_stale: false,
+    compression_ratio: null,
+    validation_score: null,
+    compaction_age_seconds: compactionAge,
+    quality_warning: false,
+    recent_messages: recent,
+    recent_message_count: recent.length,
+    compacted_message_count: compacted,
+    total_message_count: recent.length + compacted
+  };
+}
+function renderCompacted(entry, format = "structured", correlationId = "") {
+  if (entry.compactionId === null) return null;
+  const formatted = formatBlock(
+    entry,
+    buildRecentMessages(entry.recentTurns),
+    format === "narrative" ? "narrative" : "structured"
+  );
+  return {
+    compacted_context: formatted,
+    compaction_id: entry.compactionId,
+    compacted_at: entry.compactedAt,
+    conversation_id: entry.conversationId,
+    current_state: entry.currentState,
+    correlation_id: correlationId,
+    original_token_count: null,
+    compacted_token_count: null,
+    compression_ratio: null,
+    level_applied: null,
+    validation_score: null,
+    validation_passed: null,
+    quality_warning: false
+  };
+}
+
 // src/context/user-summary.ts
 var USER_SUMMARY_INTERVAL = 5;
 var MAX_SUMMARY_ITEMS = 3;
@@ -2209,6 +2446,9 @@ var SynapClient = class {
   #registryKeys;
   #compactionSubscribers;
   #shortTerm;
+  #stVerbatimOverlay;
+  #logger;
+  #stAuthoritative;
   #turns;
   #fetchHooks;
   constructor(options = {}) {
@@ -2279,6 +2519,9 @@ var SynapClient = class {
     this.client = { context: { fetch: async (o2 = {}) => fetchContext(this.#transport, "client", o2, this.#fetchHooks) } };
     this.#compactionSubscribers = new CompactionSubscribers();
     this.#shortTerm = new ShortTermStore();
+    this.#stVerbatimOverlay = options.st_verbatim_overlay ?? options.stVerbatimOverlay;
+    this.#logger = options.logger;
+    this.#stAuthoritative = options.sdk_st_authoritative ?? options.sdkStAuthoritative;
     this.#turns = new TurnCounter();
     this.conversation = createConversationNamespace(
       this.#transport,
@@ -2299,8 +2542,12 @@ var SynapClient = class {
         this.#shortTerm.appendTurn(conversationId, role, content, timestamp);
       },
       (response, conversationId, userId) => {
-        overlayLocalRecentTurns(response, this.#shortTerm, conversationId);
+        overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
         this.#injectUserSummary(response, conversationId, userId);
+      },
+      {
+        prompt: (conversationId, style) => this.#localPrompt(conversationId, style),
+        compacted: (conversationId, format) => this.#localCompacted(conversationId, format)
       }
     );
     this.memories = createMemoriesInterface(this.#transport);
@@ -2422,8 +2669,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 } : {}
@@ -2459,11 +2706,12 @@ var SynapClient = class {
    * initialization: the transport and cache are already built by then and a
    * half-applied config is worse than a rejected one.
    *
-   * The Python-only keys (`storage_path`, `cache_backend`,
-   * `session_timeout_minutes`, `logger`) are accepted and ignored rather than
-   * rejected, because this SDK has no SQLite cache backend and no global
-   * logger to swap. Ignoring them keeps a shared config object portable
-   * between the two SDKs.
+   * `logger` is honoured here as well as on the constructor. The remaining
+   * Python-only keys (`storage_path`, `cache_backend`,
+   * `session_timeout_minutes`, `log_level`) are accepted and ignored rather
+   * than rejected, because this SDK has no SQLite cache backend and no global
+   * logging framework whose level there would be to set. Ignoring them keeps
+   * a shared config object portable between the two SDKs.
    */
   configure(options = {}) {
     if (this.#initialized) {
@@ -2473,6 +2721,7 @@ var SynapClient = class {
     if (options.retryPolicy !== void 0 || options.retry_policy !== void 0) {
       this.#transport.setRetryPolicy(options.retryPolicy ?? options.retry_policy ?? null);
     }
+    if (options.logger !== void 0) this.#logger = options.logger;
   }
   /**
    * Fetch and merge context across every scope with an identifier, in one call.
@@ -2570,7 +2819,7 @@ var SynapClient = class {
     }
     const merged = mergeScopeResults(successful);
     for (const [, response] of successful) {
-      overlayLocalRecentTurns(response, this.#shortTerm, conversationId);
+      overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
     }
     if (includeConversationContext && conversationId !== void 0 && conversationId !== "") {
       try {
@@ -2667,8 +2916,44 @@ var SynapClient = class {
     if (summary === null) return;
     mergeUserSummary(response, summary);
   }
-  /** Python logs via `logger.warning`; here it is one overridable seam. */
+  /**
+   * Whether the SDK is authoritative for short-term context.
+   *
+   * Resolution order matches Python's `_is_st_authoritative`: the explicit
+   * option first, then `SYNAP_SDK_ST_AUTHORITATIVE` (truthy strings only).
+   * Defaults to false, so nothing changes for a caller who never sets it.
+   */
+  #isStAuthoritative() {
+    if (this.#stAuthoritative === true) return true;
+    const raw = (getEnv("SYNAP_SDK_ST_AUTHORITATIVE") ?? "").trim().toLowerCase();
+    return ["1", "true", "yes", "on"].includes(raw);
+  }
+  /**
+   * Render `get_context_for_prompt` from the local store, or null to fall
+   * through to the network. Warm means a compaction landed OR raw turns are
+   * buffered: with neither there is nothing to render and the server's answer
+   * is the only real one.
+   */
+  #localPrompt(conversationId, style) {
+    if (!this.#isStAuthoritative()) return null;
+    const entry = this.#shortTerm.get(conversationId);
+    if (entry === null) return null;
+    if (entry.compactionId === null && entry.recentTurns.length === 0) return null;
+    return renderForPrompt(entry, style);
+  }
+  /** Same, for `get_compacted`. Requires an actual compaction, not just turns. */
+  #localCompacted(conversationId, format) {
+    if (!this.#isStAuthoritative()) return null;
+    const entry = this.#shortTerm.get(conversationId);
+    if (entry === null || entry.compactionId === null) return null;
+    return renderCompacted(entry, format);
+  }
+  /** Every diagnostic the SDK emits passes through here. */
   #warn(message) {
+    if (this.#logger !== void 0) {
+      this.#logger("warn", message);
+      return;
+    }
     console.warn(`[synap] ${message}`);
   }
   /** Release timers and connections. Safe to call more than once. */
@@ -2689,7 +2974,8 @@ function pick3(o2, snake, camel) {
   return a !== void 0 ? a : o2[camel];
 }
 function resolveBaseUrl(options) {
-  if (options.baseUrl !== void 0) return options.baseUrl;
+  const explicit = options.baseUrl ?? options.api_base_url;
+  if (explicit !== void 0) return explicit;
   const fromEnv = getEnv("SYNAP_BASE_URL")?.trim();
   return fromEnv !== void 0 && fromEnv !== "" ? fromEnv : void 0;
 }
@@ -2712,6 +2998,7 @@ export {
   AnticipationCache,
   AuthenticationError,
   BM25,
+  COMPACTION_LEVELS,
   CONTRACT,
   ConflictError,
   ConnectionError,