@maximem/synap-js-sdk 0.5.9 → 0.5.11

package/dist/index.cjs

@@ -39,7 +39,8 @@ var _chunkZKOJDUN4cjs = require('./chunk-ZKOJDUN4.cjs');
 
 
 
-var _chunkT372OL3Qcjs = require('./chunk-T372OL3Q.cjs');
+
+var _chunkUXNVTP4Dcjs = require('./chunk-UXNVTP4D.cjs');
 
 // src/transport/endpoints.ts
 var ENDPOINTS = {
@@ -102,7 +103,7 @@ function shouldRetry(input) {
   if (attempt >= policy.maxAttempts) {
     return { retry: false, delaySeconds: 0, reason: "max_attempts_exhausted" };
   }
-  if (!_chunkT372OL3Qcjs.isSynapError.call(void 0, error) || !error.transient) {
+  if (!_chunkUXNVTP4Dcjs.isSynapError.call(void 0, error) || !error.transient) {
     return { retry: false, delaySeconds: 0, reason: "not_transient" };
   }
   const idempotent = _nullishCoalesce(input.idempotent, () => ( IDEMPOTENT_METHODS.has(method.toUpperCase())));
@@ -120,7 +121,7 @@ function shouldRetry(input) {
   };
 }
 function backoffDelay(error, attempt, policy) {
-  if (error instanceof _chunkT372OL3Qcjs.RateLimitError && error.retryAfterSeconds != null) {
+  if (error instanceof _chunkUXNVTP4Dcjs.RateLimitError && error.retryAfterSeconds != null) {
     return Math.min(error.retryAfterSeconds, policy.backoffMax);
   }
   const exponential = policy.backoffBase * 2 ** (attempt - 1);
@@ -194,9 +195,7 @@ 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 (0, _chunkT372OL3Qcjs.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)}.`
-  );
+  throw new (0, _chunkUXNVTP4Dcjs.CustomerIdNotAcceptedError)(where, String(customerId), instanceId);
 }
 
 // src/transport/http.ts
@@ -219,7 +218,7 @@ var HttpTransport = (_class2 = class {
   
   
   __init2() {this.closed = false}
-  constructor(options) {;_class2.prototype.__init2.call(this);_class2.prototype.__init3.call(this);
+  constructor(options) {;_class2.prototype.__init2.call(this);_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);
     this.#credentials = options.credentials;
     this.baseUrl = (_nullishCoalesce(options.baseUrl, () => ( DEFAULT_BASE_URL))).replace(/\/+$/, "");
     this.timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
@@ -267,8 +266,24 @@ var HttpTransport = (_class2 = class {
    * deployment older than the field, and must mean "enforce nothing".
    */
   __init3() {this.userContextIsolation = void 0}
-  /** Refuse a customer_id on a B2C instance, at the call site. */
-  checkCustomerId(customerId, where) {
+  /**
+   * Set by the client to its identity resolution (`initialize()`'s whoami).
+   * Python refuses every call before `initialize()`; here the first request
+   * runs it instead, so a caller who skips it gets the same identity-dependent
+   * behaviour (client-scope cache hits, the B2C check) rather than an error.
+   */
+  __init4() {this.identityResolver = void 0}
+  /** Resolve identity once, before the first request. Never throws. */
+  async ready() {
+    if (this.identityResolver !== void 0) await this.identityResolver();
+  }
+  /**
+   * Refuse a customer_id on a B2C instance, at the call site. Resolves identity
+   * first: the isolation comes from whoami, so on the first call of a client
+   * that skipped initialize() the check would otherwise see nothing and pass.
+   */
+  async checkCustomerId(customerId, where) {
+    await this.ready();
     checkCustomerId(
       this.userContextIsolation,
       customerId,
@@ -296,8 +311,9 @@ var HttpTransport = (_class2 = class {
   }
   async request(name, options = {}) {
     const spec = ENDPOINTS[name];
-    const correlationId = _nullishCoalesce(options.correlationId, () => ( _chunkT372OL3Qcjs.newCorrelationId.call(void 0, )));
+    const correlationId = _nullishCoalesce(options.correlationId, () => ( _chunkUXNVTP4Dcjs.newCorrelationId.call(void 0, )));
     const idempotent = _nullishCoalesce(options.idempotent, () => ( spec.idempotent));
+    if (name !== "whoami") await this.ready();
     let attempt = 0;
     let last = null;
     while (attempt < this.retryPolicy.maxAttempts) {
@@ -318,7 +334,7 @@ var HttpTransport = (_class2 = class {
         await sleep(decision.delaySeconds * 1e3, options.signal);
       }
     }
-    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _9 => _9.error]), () => ( new (0, _chunkT372OL3Qcjs.SynapError)("Request failed with no recorded error")));
+    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _9 => _9.error]), () => ( new (0, _chunkUXNVTP4Dcjs.SynapError)("Request failed with no recorded error")));
   }
   async attempt(name, options, correlationId) {
     const spec = ENDPOINTS[name];
@@ -351,7 +367,7 @@ var HttpTransport = (_class2 = class {
     try {
       return JSON.parse(text);
     } catch (e3) {
-      throw new (0, _chunkT372OL3Qcjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
+      throw new (0, _chunkUXNVTP4Dcjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
     }
   }
   buildUrl(path, query) {
@@ -385,14 +401,14 @@ var HttpTransport = (_class2 = class {
   }
 }, _class2);
 function isOutcomeUnknown(error) {
-  if (error instanceof _chunkT372OL3Qcjs.RateLimitError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.ServiceUnavailableError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.AuthenticationError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.InvalidInputError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.ConflictError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.InsufficientCreditsError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.ContextNotFoundError) return false;
-  if (error instanceof _chunkT372OL3Qcjs.NetworkTimeoutError) return true;
+  if (error instanceof _chunkUXNVTP4Dcjs.RateLimitError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.ServiceUnavailableError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.AuthenticationError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.InvalidInputError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.ConflictError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.InsufficientCreditsError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.ContextNotFoundError) return false;
+  if (error instanceof _chunkUXNVTP4Dcjs.NetworkTimeoutError) return true;
   if (isConnectionRefusal(error)) return false;
   return true;
 }
@@ -401,12 +417,12 @@ function isConnectionRefusal(error) {
   return code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "EAI_AGAIN" || code === "ECONNRESET" || code === "EHOSTUNREACH";
 }
 function toTransportError(error, correlationId) {
-  if (error instanceof _chunkT372OL3Qcjs.SynapError) return error;
+  if (error instanceof _chunkUXNVTP4Dcjs.SynapError) return error;
   const name = _optionalChain([error, 'optionalAccess', _13 => _13.name]);
   if (name === "AbortError" || name === "TimeoutError") {
-    return new (0, _chunkT372OL3Qcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
+    return new (0, _chunkUXNVTP4Dcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
   }
-  return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(
+  return new (0, _chunkUXNVTP4Dcjs.ServiceUnavailableError)(
     `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _14 => _14.message]), () => ( String(error)))}`,
     { correlationId, cause: error }
   );
@@ -436,15 +452,15 @@ async function toHttpError(response, correlationId) {
   switch (response.status) {
     case 400:
     case 422:
-      return new (0, _chunkT372OL3Qcjs.InvalidInputError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(message, opts);
     case 401:
     case 403:
-      return new (0, _chunkT372OL3Qcjs.AuthenticationError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.AuthenticationError)(message, opts);
     case 404:
-      return new (0, _chunkT372OL3Qcjs.ContextNotFoundError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.ContextNotFoundError)(message, opts);
     case 402: {
       const credit = creditPayload(parsed, detailObject);
-      return new (0, _chunkT372OL3Qcjs.InsufficientCreditsError)(message, {
+      return new (0, _chunkUXNVTP4Dcjs.InsufficientCreditsError)(message, {
         ...opts,
         balanceCredits: numberOrNull(credit["balance_credits"]),
         requiredCredits: _nullishCoalesce(numberOrNull(credit["minimum_required_credits"]), () => ( numberOrNull(credit["required_credits"]))),
@@ -456,14 +472,14 @@ async function toHttpError(response, correlationId) {
     }
     case 409:
       if (detailObject !== null && detailObject["code"] === "transcript_conflict") {
-        return new (0, _chunkT372OL3Qcjs.TranscriptConflictError)(message, opts);
+        return new (0, _chunkUXNVTP4Dcjs.TranscriptConflictError)(message, opts);
       }
-      return new (0, _chunkT372OL3Qcjs.ConflictError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.ConflictError)(message, opts);
     case 429: {
       const header = response.headers.get("retry-after");
       const retryAfter = header !== null && header.trim() !== "" ? Number(header) : null;
       const credit = creditPayload(parsed, detailObject);
-      return new (0, _chunkT372OL3Qcjs.RateLimitError)(message, {
+      return new (0, _chunkUXNVTP4Dcjs.RateLimitError)(message, {
         ...opts,
         retryAfterSeconds: retryAfter !== null && Number.isFinite(retryAfter) ? retryAfter : null,
         reason: creditReason(credit),
@@ -472,12 +488,12 @@ async function toHttpError(response, correlationId) {
       });
     }
     case 503:
-      return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.ServiceUnavailableError)(message, opts);
     case 504:
-      return new (0, _chunkT372OL3Qcjs.AgentUnavailableError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.AgentUnavailableError)(message, opts);
     default:
-      if (response.status >= 500) return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(message, opts);
-      return new (0, _chunkT372OL3Qcjs.SynapError)(message, opts);
+      if (response.status >= 500) return new (0, _chunkUXNVTP4Dcjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunkUXNVTP4Dcjs.SynapError)(message, opts);
   }
 }
 function numberOrNull(v) {
@@ -490,7 +506,7 @@ function withTimeout(ms, external) {
   const controller = new AbortController();
   const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _15 => _15.reason]));
   const timer = setTimeout(() => {
-    controller.abort(new (0, _chunkT372OL3Qcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
+    controller.abort(new (0, _chunkUXNVTP4Dcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
   }, ms);
   _optionalChain([timer, 'access', _16 => _16.unref, 'optionalCall', _17 => _17()]);
   if (external) {
@@ -619,16 +635,15 @@ function buildFetchRequest(scope, options) {
   const conversationId = opt(options, "conversation_id", "conversationId");
   const searchQuery = opt(options, "search_query", "searchQuery");
   const maxResults = _nullishCoalesce(opt(options, "max_results", "maxResults"), () => ( 10));
-  const precisionLevel = _nullishCoalesce(opt(options, "precision_level", "precisionLevel"), () => ( "high"));
   const queryDate = opt(options, "query_date", "queryDate");
   const perQuery = opt(options, "max_results_per_query", "maxResultsPerQuery");
   const responseShape = responseShapeOf(options);
-  const mode = _nullishCoalesce(options.mode, () => ( "fast"));
+  const { mode, precisionLevel } = retrievalOptionsOf(options);
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("search_query must be an array when provided");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("search_query must be an array when provided");
   }
   if (options.types !== void 0 && !Array.isArray(options.types)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("types must be an array when provided");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("types must be an array when provided");
   }
   const body = {
     conversation_id: _nullishCoalesce(conversationId, () => ( null)),
@@ -644,25 +659,27 @@ function buildFetchRequest(scope, options) {
   if (options.include_conversation_context === false) {
     body["include_conversation_context"] = false;
   }
+  const scopePath = opt(options, "scope_path", "scopePath");
+  if (scopePath !== void 0 && scopePath !== null && Object.keys(scopePath).length > 0) {
+    body["scope"] = scopePath;
+  }
   switch (scope) {
     case "user":
       {
-        if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+        if (!userId) throw new (0, _chunkUXNVTP4Dcjs.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 = _nullishCoalesce(opt(options, "context_mode", "contextMode"), () => ( "in-conversation"));
         if (!VALID_CONTEXT_MODES.includes(contextMode)) {
-          throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+          throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
             `Invalid context_mode '${contextMode}'. Must be one of: ${VALID_CONTEXT_MODES.join(", ")}`
           );
         }
         const lastN = _nullishCoalesce(opt(options, "last_n_conversations", "lastNConversations"), () => ( 1));
         if (!Number.isInteger(lastN)) {
-          throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("last_n_conversations must be an integer");
+          throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be an integer");
         }
         if (lastN < 0 || lastN > 20) {
-          throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
+          throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
         }
         if (contextMode === "conversation-summary") {
           body["context_mode"] = contextMode;
@@ -674,11 +691,11 @@ function buildFetchRequest(scope, options) {
       }
       break;
     case "customer":
-      if (!customerId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("customer_id is required");
       body["customer_id"] = customerId;
       break;
     case "conversation":
-      if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+      if (!conversationId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
       if (userId !== void 0) body["user_id"] = userId;
       if (customerId !== void 0) body["customer_id"] = customerId;
       break;
@@ -691,25 +708,44 @@ var VALID_CONTEXT_MODES = ["in-conversation", "conversation-summary"];
 function responseShapeOf(options) {
   const shape = _nullishCoalesce(opt(options, "response_shape", "responseShape"), () => ( "by_type"));
   if (!RESPONSE_SHAPES.includes(shape)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `Invalid response_shape '${shape}'. Must be one of: ${RESPONSE_SHAPES.join(", ")}`
     );
   }
   return shape;
 }
+var VALID_MODES = ["fast", "accurate"];
+var VALID_PRECISION = ["high", "medium"];
+function retrievalOptionsOf(options) {
+  const mode = _nullishCoalesce(options.mode, () => ( "fast"));
+  if (!VALID_MODES.includes(mode)) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
+      `Invalid mode '${mode}'. Must be one of: ${VALID_MODES.join(", ")}`
+    );
+  }
+  const precisionLevel = _nullishCoalesce(opt(options, "precision_level", "precisionLevel"), () => ( "high"));
+  if (!VALID_PRECISION.includes(precisionLevel)) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
+      `Invalid precision_level '${precisionLevel}'. Must be one of: ${VALID_PRECISION.join(", ")}`
+    );
+  }
+  return { mode, precisionLevel };
+}
 async function fetchContext(transport, scope, options = {}, hooks = {}) {
   const startedAt = Date.now();
-  transport.checkCustomerId(
+  await _optionalChain([transport, 'access', _25 => _25.ready, 'optionalCall', _26 => _26()]);
+  await transport.checkCustomerId(
     opt(options, "customer_id", "customerId"),
     `${scope}.context.fetch`
   );
   const responseShape = responseShapeOf(options);
+  retrievalOptionsOf(options);
   const network = async () => {
     const { endpoint, body } = buildFetchRequest(scope, options);
     const result = await transport.request(endpoint, { body });
-    return applyResponseShape(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _25 => _25["context"]]), () => ( {})), responseShape);
+    return applyResponseShape(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _27 => _27["context"]]), () => ( {})), responseShape);
   };
-  const anticipated = await _asyncNullishCoalesce(await _optionalChain([hooks, 'access', _26 => _26.beforeFetch, 'optionalCall', _27 => _27(scope, options)]), async () => ( null));
+  const anticipated = await _asyncNullishCoalesce(await _optionalChain([hooks, 'access', _28 => _28.beforeFetch, 'optionalCall', _29 => _29(scope, options)]), async () => ( null));
   if (anticipated !== null && anticipated.borderline) {
     const pending = network();
     pending.catch(() => void 0);
@@ -720,17 +756,17 @@ async function fetchContext(transport, scope, options = {}, hooks = {}) {
     const won = await Promise.race([pending.then((r) => r, () => null), late]);
     if (timer !== void 0) clearTimeout(timer);
     if (won !== null) {
-      _optionalChain([hooks, 'access', _28 => _28.onAssembled, 'optionalCall', _29 => _29(scope, options, won, startedAt)]);
+      _optionalChain([hooks, 'access', _30 => _30.onAssembled, 'optionalCall', _31 => _31(scope, options, won, startedAt)]);
       return won;
     }
   }
   if (anticipated !== null) {
-    _optionalChain([hooks, 'access', _30 => _30.onServedFromCache, 'optionalCall', _31 => _31(scope, options, anticipated)]);
-    _optionalChain([hooks, 'access', _32 => _32.onAssembled, 'optionalCall', _33 => _33(scope, options, anticipated.response, startedAt)]);
+    _optionalChain([hooks, 'access', _32 => _32.onServedFromCache, 'optionalCall', _33 => _33(scope, options, anticipated)]);
+    _optionalChain([hooks, 'access', _34 => _34.onAssembled, 'optionalCall', _35 => _35(scope, options, anticipated.response, startedAt)]);
     return applyResponseShape(anticipated.response, responseShape);
   }
   const response = await network();
-  _optionalChain([hooks, 'access', _34 => _34.onAssembled, 'optionalCall', _35 => _35(scope, options, response, startedAt)]);
+  _optionalChain([hooks, 'access', _36 => _36.onAssembled, 'optionalCall', _37 => _37(scope, options, response, startedAt)]);
   return response;
 }
 
@@ -985,17 +1021,17 @@ function isoOrNull(v) {
   return v instanceof Date ? v.toISOString() : v;
 }
 function buildCreateBody(options) {
-  if (!options.document) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("document is required");
+  if (!options.document) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("document is required");
   const o2 = options;
   const documentType = _nullishCoalesce(either(o2, "document_type", "documentType"), () => ( DEFAULT_DOCUMENT_TYPE));
   const mode = _nullishCoalesce(options.mode, () => ( DEFAULT_INGEST_MODE));
   if (!DOCUMENT_TYPES.includes(documentType)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `Invalid document_type '${documentType}'. Expected one of: ${DOCUMENT_TYPES.join(", ")}`
     );
   }
   if (!INGEST_MODES.includes(mode)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `Invalid mode '${mode}'. Expected one of: ${INGEST_MODES.join(", ")}`
     );
   }
@@ -1022,13 +1058,13 @@ 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 (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `description must be between ${FORGET_DESCRIPTION_MIN} and ${FORGET_DESCRIPTION_MAX} characters`
     );
   }
   const mode = _nullishCoalesce(options.mode, () => ( "preview"));
   if (!FORGET_MODES.includes(mode)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `Invalid mode '${mode}'. Expected one of: ${FORGET_MODES.join(", ")}`
     );
   }
@@ -1046,13 +1082,13 @@ function createMemoriesInterface(transport, onForgotten) {
   return {
     async create(options) {
       const o2 = options;
-      transport.checkCustomerId(_nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])), "memories.create");
+      await transport.checkCustomerId(_nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])), "memories.create");
       return transport.request("memories_create", { body: buildCreateBody(options) });
     },
     async batch_create(options) {
       const docs = options.documents;
       if (!Array.isArray(docs) || docs.length === 0) {
-        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("documents must be a non-empty array");
+        throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("documents must be a non-empty array");
       }
       const failFast = _nullishCoalesce(_nullishCoalesce(options.fail_fast, () => ( options.failFast)), () => ( false));
       return transport.request("memories_batch", {
@@ -1062,15 +1098,15 @@ function createMemoriesInterface(transport, onForgotten) {
     async create_from_file(options) {
       const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
       const customerId = _nullishCoalesce(options.customer_id, () => ( options.customerId));
-      if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
-      transport.checkCustomerId(customerId, "memories.create_from_file");
+      if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
+      await transport.checkCustomerId(customerId, "memories.create_from_file");
       const filePath = _nullishCoalesce(options.file_path, () => ( options.filePath));
       const sources = [filePath, options.file, options.text].filter((v) => v !== void 0);
       if (sources.length === 0) {
-        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("One of file_path, file, or text must be provided.");
+        throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("One of file_path, file, or text must be provided.");
       }
       if (sources.length > 1) {
-        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+        throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
           "Provide exactly one of file_path, file, or text, not several."
         );
       }
@@ -1101,13 +1137,13 @@ function createMemoriesInterface(transport, onForgotten) {
       });
     },
     async get(memoryId) {
-      if (!memoryId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("memory_id is required");
+      if (!memoryId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("memory_id is required");
       return transport.request("memories_get", { pathParams: { memory_id: memoryId } });
     },
     async update(options) {
       const memoryId = _nullishCoalesce(options.memory_id, () => ( options.memoryId));
-      if (!memoryId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("memory_id is required");
-      if (!options.document) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("document is required");
+      if (!memoryId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("memory_id is required");
+      if (!options.document) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("document is required");
       const body = {
         document: options.document,
         merge_strategy: _nullishCoalesce(_nullishCoalesce(options.merge_strategy, () => ( options.mergeStrategy)), () => ( "smart-merge"))
@@ -1122,7 +1158,7 @@ function createMemoriesInterface(transport, onForgotten) {
     },
     async delete(memoryId) {
       if (!memoryId) {
-        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+        throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
           "memory_id is required. Deleting by user is no longer supported: the previous implementation tracked ids in process memory, so it silently deleted nothing in any serverless or multi-process deployment while reporting success."
         );
       }
@@ -1130,10 +1166,10 @@ function createMemoriesInterface(transport, onForgotten) {
     },
     async forget(options) {
       const o2 = options;
-      transport.checkCustomerId(_nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])), "memories.forget");
+      await transport.checkCustomerId(_nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])), "memories.forget");
       const body = buildForgetBody(options);
       const result = await transport.request("memories_forget", { body });
-      const removed = !!_optionalChain([result, 'optionalAccess', _36 => _36.deleted_ids, 'optionalAccess', _37 => _37.length]) || _optionalChain([result, 'optionalAccess', _38 => _38.status]) === "deleted" || _optionalChain([result, 'optionalAccess', _39 => _39.status]) === "partial";
+      const removed = !!_optionalChain([result, 'optionalAccess', _38 => _38.deleted_ids, 'optionalAccess', _39 => _39.length]) || _optionalChain([result, 'optionalAccess', _40 => _40.status]) === "deleted" || _optionalChain([result, 'optionalAccess', _41 => _41.status]) === "partial";
       if (removed && onForgotten) {
         try {
           onForgotten({
@@ -1146,13 +1182,13 @@ function createMemoriesInterface(transport, onForgotten) {
       return result;
     },
     async status(ingestionId) {
-      if (!ingestionId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("ingestion_id is required");
       return transport.request("memories_status", {
         pathParams: { ingestion_id: ingestionId }
       });
     },
     async wait_for_completion(ingestionId, options = {}) {
-      if (!ingestionId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("ingestion_id is required");
       const timeoutMs = (_nullishCoalesce(_nullishCoalesce(options.timeout_seconds, () => ( options.timeoutSeconds)), () => ( 300))) * 1e3;
       const pollMs = (_nullishCoalesce(_nullishCoalesce(options.poll_interval_seconds, () => ( options.pollIntervalSeconds)), () => ( 2))) * 1e3;
       const deadline = Date.now() + timeoutMs;
@@ -1173,14 +1209,14 @@ function sleep2(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _40 => _40.removeEventListener, 'call', _41 => _41("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _42 => _42.removeEventListener, 'call', _43 => _43("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _42 => _42.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _44 => _44.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _43 => _43.addEventListener, 'call', _44 => _44("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _45 => _45.addEventListener, 'call', _46 => _46("abort", onAbort, { once: true })]);
   });
 }
 
@@ -1190,13 +1226,13 @@ var UUID_RE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9
 function validateConversationId(conversationId) {
   if (conversationId === void 0 || conversationId === null || conversationId === "") return;
   if (typeof conversationId !== "string" || !UUID_RE.test(conversationId)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidConversationIdError)(`Invalid conversation ID: ${String(conversationId)}`);
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidConversationIdError)(`Invalid conversation ID: ${String(conversationId)}`);
   }
 }
 function validateInstanceId(instanceId) {
   if (instanceId === void 0 || instanceId === null || instanceId === "") return;
   if (typeof instanceId !== "string" || !INSTANCE_ID_RE.test(instanceId)) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
   }
 }
 
@@ -1246,13 +1282,13 @@ function buildRecordMessageBody(options) {
   const conversationId = either2(o2, "conversation_id", "conversationId");
   const userId = either2(o2, "user_id", "userId");
   const customerId = either2(o2, "customer_id", "customerId");
-  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
   validateConversationId(conversationId);
-  if (!options.role) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("role is required");
+  if (!options.role) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("role is required");
   if (options.content === void 0 || options.content === null) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("content is required");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("content is required");
   }
-  if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+  if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
   const body = {
     conversation_id: conversationId,
     role: options.role,
@@ -1272,10 +1308,10 @@ function buildIngestTranscriptBody(options) {
   const o2 = options;
   const conversationId = either2(o2, "conversation_id", "conversationId");
   const userId = either2(o2, "user_id", "userId");
-  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
-  if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+  if (!conversationId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
+  if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
   if (options.transcript === void 0 || options.transcript === null) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("transcript is required");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("transcript is required");
   }
   const body = {
     conversation_id: conversationId,
@@ -1299,7 +1335,7 @@ function buildIngestTranscriptBody(options) {
 function buildCompactBody(options) {
   const o2 = options;
   const conversationId = either2(o2, "conversation_id", "conversationId");
-  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
   validateConversationId(conversationId);
   const body = { conversation_id: conversationId, force: _nullishCoalesce(options.force, () => ( false)) };
   const strategy = _nullishCoalesce(options.strategy, () => ( either2(o2, "compaction_level", "compactionLevel")));
@@ -1353,7 +1389,7 @@ function storedBatchRows(bodies, result) {
   const r = _nullishCoalesce(result, () => ( {}));
   const results = Array.isArray(r["results"]) ? r["results"] : [];
   const errors = Array.isArray(r["errors"]) ? r["errors"] : [];
-  const failed = new Set(errors.map((e) => _optionalChain([e, 'optionalAccess', _45 => _45["index"]])));
+  const failed = new Set(errors.map((e) => _optionalChain([e, 'optionalAccess', _47 => _47["index"]])));
   const stored = bodies.filter((_, index) => !failed.has(index));
   if (stored.length !== results.length) return [];
   const pairs = [];
@@ -1395,13 +1431,13 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
   };
   const convId = (v) => {
     const id = typeof v === "string" ? v : _nullishCoalesce(v.conversation_id, () => ( v.conversationId));
-    if (!id) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+    if (!id) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
     validateConversationId(id);
     return id;
   };
   return {
     async record_message(options) {
-      transport.checkCustomerId(
+      await transport.checkCustomerId(
         _nullishCoalesce(options["customer_id"], () => ( options["customerId"])),
         "conversation.record_message"
       );
@@ -1429,11 +1465,11 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
     },
     async record_messages_batch(messages) {
       if (!Array.isArray(messages) || messages.length === 0) {
-        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("messages must be a non-empty array");
+        throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("messages must be a non-empty array");
       }
       for (const m of messages) {
         const mo = m;
-        transport.checkCustomerId(
+        await transport.checkCustomerId(
           _nullishCoalesce(mo["customer_id"], () => ( mo["customerId"])),
           "conversation.record_messages_batch"
         );
@@ -1499,8 +1535,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
           pathParams: { conversation_id: id },
           query: { style: _nullishCoalesce(options.style, () => ( "structured")) }
         });
-        const response = _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _46 => _46["context_for_prompt"]]), () => ( result)), () => ( {}));
-        _optionalChain([localShortTerm, 'access', _47 => _47.reseed, 'optionalCall', _48 => _48(id, response)]);
+        const response = _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _48 => _48["context_for_prompt"]]), () => ( result)), () => ( {}));
+        _optionalChain([localShortTerm, 'access', _49 => _49.reseed, 'optionalCall', _50 => _50(id, response)]);
         return withHistory(response);
       },
       async compact(options) {
@@ -1540,8 +1576,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
        * Returns an idempotent unsubscribe thunk, matching Python.
        */
       subscribe_to_compaction_updates(conversationId, callback) {
-        if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
-        if (typeof callback !== "function") throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("callback is required");
+        if (!conversationId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("conversation_id is required");
+        if (typeof callback !== "function") throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("callback is required");
         return subscribers.add(conversationId, callback);
       },
       /** Remove subscribers for one conversation, or all of them. Returns the count removed. */
@@ -1557,7 +1593,7 @@ function createUserNamespace(transport, hooks = {}) {
   return {
     async get_profile(options) {
       const userId = typeof options === "string" ? options : _nullishCoalesce(options.user_id, () => ( options.userId));
-      if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
       const customerId = typeof options === "string" ? void 0 : _nullishCoalesce(options.customer_id, () => ( options.customerId));
       return transport.request("user_profile", {
         pathParams: { user_id: userId },
@@ -1606,7 +1642,7 @@ function createCreditsNamespace(transport) {
       });
     },
     async redeem(code) {
-      if (!code) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("code is required");
+      if (!code) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("code is required");
       return transport.request("credits_redeem", { body: { code } });
     }
   };
@@ -1617,11 +1653,11 @@ function createCacheNamespace(cache) {
   return {
     clear: () => cache.clear(),
     clear_user: (userId) => {
-      if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
       cache.dropEntity(userId);
     },
     clear_customer: (customerId) => {
-      if (!customerId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("customer_id is required");
       cache.dropEntity(customerId);
     },
     stats: () => ({ bundles: cache.size, items: cache.itemCount })
@@ -1693,8 +1729,8 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
   let onConversationState = null;
   const internals = {
     onCompactionUpdate(conversationId, bundle) {
-      _optionalChain([applyCompaction, 'optionalCall', _49 => _49(bundle)]);
-      _optionalChain([dispatchCompaction, 'optionalCall', _50 => _50(conversationId, bundle)]);
+      _optionalChain([applyCompaction, 'optionalCall', _51 => _51(bundle)]);
+      _optionalChain([dispatchCompaction, 'optionalCall', _52 => _52(conversationId, bundle)]);
     },
     setCompactionApplier(apply) {
       applyCompaction = apply;
@@ -1706,10 +1742,10 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       onConversationState = handle;
     },
     sendContextUsed(event) {
-      _optionalChain([client, 'optionalAccess', _51 => _51.sendContextUsed, 'call', _52 => _52(event)]);
+      _optionalChain([client, 'optionalAccess', _53 => _53.sendContextUsed, 'call', _54 => _54(event)]);
     },
     sendContextAssembled(event) {
-      _optionalChain([client, 'optionalAccess', _53 => _53.sendContextAssembled, 'call', _54 => _54(event)]);
+      _optionalChain([client, 'optionalAccess', _55 => _55.sendContextAssembled, 'call', _56 => _56(event)]);
     },
     setCompactionDispatcher(dispatch) {
       dispatchCompaction = dispatch;
@@ -1721,7 +1757,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
   function ensureSession(conversationId, userId, customerId) {
     if (!conversationId || !userId || client === null) return;
     if (openSessions.has(conversationId)) return;
-    const sessionId = _chunkT372OL3Qcjs.newCorrelationId.call(void 0, );
+    const sessionId = _chunkUXNVTP4Dcjs.newCorrelationId.call(void 0, );
     try {
       client.sendSessionControl({
         action: "start",
@@ -1737,13 +1773,13 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
   const namespace = {
     async listen(options = {}) {
       if (client !== null) {
-        throw new (0, _chunkT372OL3Qcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
+        throw new (0, _chunkUXNVTP4Dcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
       }
       try {
-        _optionalChain([onListen, 'optionalCall', _55 => _55()]);
+        _optionalChain([onListen, 'optionalCall', _57 => _57()]);
       } catch (e10) {
       }
-      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-L6OQPZN7.cjs")));
+      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-5GYUWETN.cjs")));
       const onContext = _nullishCoalesce(options.on_context, () => ( options.onContext));
       const onDisconnect = _nullishCoalesce(options.on_disconnect, () => ( options.onDisconnect));
       const onReconnect = _nullishCoalesce(options.on_reconnect, () => ( options.onReconnect));
@@ -1758,17 +1794,17 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
           internals.onCompactionUpdate(conversationId, bundle);
         },
         onConversationState: (conversationId, messageCount) => {
-          _optionalChain([onConversationState, 'optionalCall', _56 => _56(conversationId, messageCount)]);
+          _optionalChain([onConversationState, 'optionalCall', _58 => _58(conversationId, messageCount)]);
         },
         onStateChange: (state) => {
           if (state !== "connected") openSessions.clear();
           if (state === "reconnecting") {
             reconnectAttempts += 1;
-            _optionalChain([onReconnect, 'optionalCall', _57 => _57(reconnectAttempts)]);
+            _optionalChain([onReconnect, 'optionalCall', _59 => _59(reconnectAttempts)]);
           } else if (state === "disconnected") {
-            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _58 => _58.lastError]), () => ( null));
+            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _60 => _60.lastError]), () => ( null));
             const reason = stopped === null ? "stream disconnected" : `credit_stop:${_nullishCoalesce(stopped.reason, () => ( "unknown"))}`;
-            _optionalChain([onDisconnect, 'optionalCall', _59 => _59(reason)]);
+            _optionalChain([onDisconnect, 'optionalCall', _61 => _61(reason)]);
           }
         }
       });
@@ -1776,9 +1812,9 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       try {
         await created.connect();
       } catch (error) {
-        if (error instanceof _chunkT372OL3Qcjs.SynapError) throw error;
-        throw new (0, _chunkT372OL3Qcjs.SynapError)(
-          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _60 => _60.message]), () => ( String(error)))}`,
+        if (error instanceof _chunkUXNVTP4Dcjs.SynapError) throw error;
+        throw new (0, _chunkUXNVTP4Dcjs.SynapError)(
+          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _62 => _62.message]), () => ( String(error)))}`,
           { cause: error }
         );
       }
@@ -1807,13 +1843,13 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       }
     },
     async send_message(options) {
-      if (client === null) throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunkUXNVTP4Dcjs.ListeningNotActiveError)("Listening is not active");
       if (options.content === void 0) {
-        throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("content is required");
+        throw new (0, _chunkUXNVTP4Dcjs.ListeningNotActiveError)("content is required");
       }
       const eventType = _nullishCoalesce(_nullishCoalesce(options.event_type, () => ( options.eventType)), () => ( "user_message"));
       if (!KNOWN_EVENT_TYPES.has(eventType)) {
-        throw new (0, _chunkT372OL3Qcjs.SynapError)(
+        throw new (0, _chunkUXNVTP4Dcjs.SynapError)(
           `unknown event_type '${eventType}'. Expected one of: ` + [...KNOWN_EVENT_TYPES].sort().join(", ")
         );
       }
@@ -1824,7 +1860,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
         _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( ""))
       );
       if (eventType === "user_message" || eventType === "assistant_message") {
-        _optionalChain([onTurn, 'optionalCall', _61 => _61({
+        _optionalChain([onTurn, 'optionalCall', _63 => _63({
           conversationId,
           role: _nullishCoalesce(options.role, () => ( "user")),
           content: options.content
@@ -1870,7 +1906,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
     async record_tool_result(options) {
       const conversationId = _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( ""));
       if (conversationId) {
-        _optionalChain([onToolResult, 'optionalCall', _62 => _62({ conversationId, result: options.result, toolName: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")) })]);
+        _optionalChain([onToolResult, 'optionalCall', _64 => _64({ conversationId, result: options.result, toolName: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")) })]);
       }
       await namespace.send_message({
         content: "",
@@ -1887,7 +1923,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       });
     },
     async record_thinking(options) {
-      if (client === null) throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunkUXNVTP4Dcjs.ListeningNotActiveError)("Listening is not active");
       const conversationId = _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( ""));
       ensureSession(
         conversationId,
@@ -1922,7 +1958,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.9";
+var SDK_VERSION = "0.5.11";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2269,13 +2305,13 @@ function bytesOf(text) {
 }
 var TurnStore = (_class3 = class {
   
-  __init4() {this.onDisk = false}
+  __init5() {this.onDisk = false}
   #now;
   #seq = 0;
   #writes = 0;
   #conversations = /* @__PURE__ */ new Map();
   #vectors = /* @__PURE__ */ new Map();
-  constructor(options = {}) {;_class3.prototype.__init4.call(this);
+  constructor(options = {}) {;_class3.prototype.__init5.call(this);
     this.limits = _nullishCoalesce(options.limits, () => ( { ..._chunkICUFS3B5cjs.HISTORY_SEARCH.store_limits }));
     this.#now = _nullishCoalesce(options.now, () => ( (() => Date.now() / 1e3)));
   }
@@ -2390,7 +2426,7 @@ var TurnStore = (_class3 = class {
   }
   /** Turns the server also holds: archived tool results are local only. Python: `count`. */
   count(conversationId) {
-    return (_nullishCoalesce(_optionalChain([this, 'access', _63 => _63.#conversations, 'access', _64 => _64.get, 'call', _65 => _65(conversationId), 'optionalAccess', _66 => _66.turns]), () => ( []))).filter((t) => t.role !== "tool").length;
+    return (_nullishCoalesce(_optionalChain([this, 'access', _65 => _65.#conversations, 'access', _66 => _66.get, 'call', _67 => _67(conversationId), 'optionalAccess', _68 => _68.turns]), () => ( []))).filter((t) => t.role !== "tool").length;
   }
   sizeBytes() {
     let n2 = 0;
@@ -2569,7 +2605,7 @@ function askedKinds(query) {
 }
 function asksHowItStarted(query) {
   const spec = _chunkICUFS3B5cjs.HISTORY_SEARCH.early_query;
-  if (!_optionalChain([spec, 'optionalAccess', _67 => _67.pattern])) return false;
+  if (!_optionalChain([spec, 'optionalAccess', _69 => _69.pattern])) return false;
   return new RegExp(spec.pattern, (_nullishCoalesce(spec.flags, () => ( ""))).includes("i") ? "i" : "").test(_nullishCoalesce(query, () => ( "")));
 }
 async function searchTurns(turns, query, options = {}) {
@@ -3585,7 +3621,7 @@ function buildTool(target, options = {}, onWarning = () => {
   const scope = String(_nullishCoalesce(options.scope, () => ( "user"))).toLowerCase();
   if (!VALID_SCOPES.includes(scope)) {
     const sorted = [...VALID_SCOPES].sort();
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       `scope must be one of ['${sorted.join("', '")}'], got '${String(options.scope)}'`
     );
   }
@@ -3593,10 +3629,10 @@ function buildTool(target, options = {}, onWarning = () => {
   const customerId = _nullishCoalesce(options.customer_id, () => ( options.customerId));
   const conversationId = _nullishCoalesce(options.conversation_id, () => ( options.conversationId));
   if (scope === "user" && (userId === void 0 || userId === "")) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("scope='user' requires user_id");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("scope='user' requires user_id");
   }
   if (scope === "customer" && (customerId === void 0 || customerId === "")) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("scope='customer' requires customer_id");
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("scope='customer' requires customer_id");
   }
   if (scope === "conversation" && (userId === void 0 || userId === "")) {
     onWarning(
@@ -3605,7 +3641,7 @@ function buildTool(target, options = {}, onWarning = () => {
   }
   const style = String(_nullishCoalesce(options.style, () => ( "openai")));
   if (style !== "openai" && style !== "anthropic") {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(`style must be 'openai' or 'anthropic', got '${style}'`);
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(`style must be 'openai' or 'anthropic', got '${style}'`);
   }
   const toolName = _nullishCoalesce(options.name, () => ( `synap_fetch_${scope}_context`));
   const toolDesc = _nullishCoalesce(options.description, () => ( defaultToolDescription(scope)));
@@ -3648,6 +3684,7 @@ var SynapClient = (_class4 = class _SynapClient {
   
   #closed = false;
   #initialized = false;
+  #identity;
   #registryKeys;
   #compactionSubscribers;
   #shortTerm;
@@ -3698,6 +3735,7 @@ var SynapClient = (_class4 = class _SynapClient {
       userAgent: `@maximem/synap-js-sdk/${SDK_VERSION}`
     });
     if (options.heartbeat) this.#transport.startHeartbeat();
+    this.#transport.identityResolver = () => this.#resolveIdentity();
     this.#anticipationCache = new (0, _chunkICUFS3B5cjs.AnticipationCache)();
     this.#fetchHooks = {
       beforeFetch: async (scope, options2) => {
@@ -3757,7 +3795,7 @@ var SynapClient = (_class4 = class _SynapClient {
     this.#localEncoder = _nullishCoalesce(_nullishCoalesce(options.history_search_encoder, () => ( options.historySearchEncoder)), () => ( null));
     const modelOption = options.history_search_model !== void 0 ? options.history_search_model : options.historySearchModel;
     this.#localModelName = modelOption === void 0 ? "auto" : modelOption;
-    if (_optionalChain([this, 'access', _68 => _68.#localEncoder, 'optionalAccess', _69 => _69.model]) === _chunkICUFS3B5cjs.SEMANTIC_MATCH.model) this.#anticipationCache.setEncoder(this.#localEncoder);
+    if (_optionalChain([this, 'access', _70 => _70.#localEncoder, 'optionalAccess', _71 => _71.model]) === _chunkICUFS3B5cjs.SEMANTIC_MATCH.model) this.#anticipationCache.setEncoder(this.#localEncoder);
     this.#turns = new TurnCounter();
     this.conversation = createConversationNamespace(
       this.#transport,
@@ -3851,9 +3889,9 @@ var SynapClient = (_class4 = class _SynapClient {
    */
   async searchMemory(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
     if (options.query === void 0 || options.query === null) {
-      throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("query is required");
+      throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("query is required");
     }
     const context = await fetchContext(this.#transport, "user", {
       user_id: userId,
@@ -3874,7 +3912,7 @@ var SynapClient = (_class4 = class _SynapClient {
    */
   async getMemories(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
     const context = await fetchContext(this.#transport, "user", {
       user_id: userId,
       ...pick3(options, "customer_id", "customerId") !== void 0 ? { customer_id: pick3(options, "customer_id", "customerId") } : {},
@@ -3903,19 +3941,30 @@ var SynapClient = (_class4 = class _SynapClient {
   /**
    * Resolve `client_id` and `instance_id` from the API key.
    *
-   * Mirrors Python's `initialize()`. Calling it is optional here (unlike
-   * Python, which raises "SDK not initialized" from `_ensure_initialized`)
-   * because every HTTP route authenticates on the API key alone. It matters
-   * for the anticipation cache: a bundle shared at client scope is filtered on
-   * `client_id`, and an empty one fails that filter for every bundle. That was
-   * a silent cache-scope bug in Python before whoami bootstrapping existed.
+   * Mirrors Python's `initialize()`. Python raises "SDK not initialized" on
+   * any call made before it; here the first request runs the same resolution
+   * instead (`identityResolver` on the transport), so skipping this call costs
+   * nothing and breaks no existing caller. It matters for the anticipation
+   * cache: a bundle shared at client scope is filtered on `client_id`, and an
+   * empty one fails that filter for every bundle.
+   *
+   * Calling it explicitly still locks `configure()`, as in Python. Resolving
+   * on first use does not, because a caller who never called it could always
+   * configure after a request, and that keeps working.
    *
    * Best-effort and idempotent. A whoami failure leaves whatever the
    * constructor resolved and is not fatal.
    */
   async initialize() {
-    if (this.#initialized) return;
     this.#initialized = true;
+    await this.#resolveIdentity();
+  }
+  /** Runs whoami at most once, however many calls arrive together. */
+  #resolveIdentity() {
+    this.#identity ??= this.#whoami();
+    return this.#identity;
+  }
+  async #whoami() {
     const credentials = this.#transport.currentCredentials();
     if (credentials.clientId !== "" && credentials.instanceId !== "") return;
     try {
@@ -3968,7 +4017,7 @@ var SynapClient = (_class4 = class _SynapClient {
    */
   configure(options = {}) {
     if (this.#initialized) {
-      throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("Cannot reconfigure after initialization");
+      throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("Cannot reconfigure after initialization");
     }
     if (options.timeouts !== void 0) this.#transport.setTimeouts(options.timeouts);
     if (options.retryPolicy !== void 0 || options.retry_policy !== void 0) {
@@ -4019,6 +4068,7 @@ var SynapClient = (_class4 = class _SynapClient {
       last_n_conversations: lastNConversations = 1,
       response_shape: responseShape = "by_type"
     } = options;
+    await this.#transport.checkCustomerId(customerId, "sdk.fetch");
     validateConversationId(conversationId);
     responseShapeOf({ response_shape: responseShape });
     const wants = (scope) => scopes === void 0 || scopes.includes(scope);
@@ -4086,7 +4136,7 @@ var SynapClient = (_class4 = class _SynapClient {
         successful.push([label, result.value]);
         continue;
       }
-      if (result.reason instanceof _chunkT372OL3Qcjs.InvalidInputError) throw result.reason;
+      if (result.reason instanceof _chunkUXNVTP4Dcjs.InvalidInputError) throw result.reason;
       this.#warn(`Scope '${label}' fetch failed in unified fetch (non-fatal): ${String(result.reason)}`);
     }
     const merged = mergeScopeResults(successful);
@@ -4165,7 +4215,7 @@ var SynapClient = (_class4 = class _SynapClient {
       if (!this.instance.is_listening) return;
       this.instance._internal.sendContextAssembled({
         ...buildAssembledEvent({
-          correlationId: _chunkT372OL3Qcjs.newCorrelationId.call(void 0, ),
+          correlationId: _chunkUXNVTP4Dcjs.newCorrelationId.call(void 0, ),
           response,
           conversationId: _nullishCoalesce(options["conversation_id"], () => ( options["conversationId"])),
           userId: _nullishCoalesce(options["user_id"], () => ( options["userId"])),
@@ -4236,14 +4286,14 @@ var SynapClient = (_class4 = class _SynapClient {
       }))
     );
     const entry = this.#shortTerm.get(conversationId);
-    const total = Math.max(Number(_nullishCoalesce(r["total_message_count"], () => ( 0))) || 0, Number(_nullishCoalesce(_optionalChain([entry, 'optionalAccess', _70 => _70.serverMessageCount]), () => ( 0))) || 0);
+    const total = Math.max(Number(_nullishCoalesce(r["total_message_count"], () => ( 0))) || 0, Number(_nullishCoalesce(_optionalChain([entry, 'optionalAccess', _72 => _72.serverMessageCount]), () => ( 0))) || 0);
     this.#maybeBackfillTurns(conversationId, total);
     if (!r["context_block"]) return response;
     const turns = store.turns(conversationId);
     let q = query;
     if (!q) {
       const latest = [...recent].reverse().find((m) => m["role"] === "user");
-      q = latest ? String(_nullishCoalesce(latest["content"], () => ( ""))) : _nullishCoalesce(_optionalChain([[...turns], 'access', _71 => _71.reverse, 'call', _72 => _72(), 'access', _73 => _73.find, 'call', _74 => _74((t) => t.role === "user"), 'optionalAccess', _75 => _75.content]), () => ( ""));
+      q = latest ? String(_nullishCoalesce(latest["content"], () => ( ""))) : _nullishCoalesce(_optionalChain([[...turns], 'access', _73 => _73.reverse, 'call', _74 => _74(), 'access', _75 => _75.find, 'call', _76 => _76((t) => t.role === "user"), 'optionalAccess', _77 => _77.content]), () => ( ""));
     }
     if (!q) return response;
     const exclude = /* @__PURE__ */ new Set();
@@ -4387,13 +4437,13 @@ function pick3(o2, snake, camel) {
 function resolveBaseUrl(options) {
   const explicit = _nullishCoalesce(options.baseUrl, () => ( options.api_base_url));
   if (explicit !== void 0) return explicit;
-  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _76 => _76.trim, 'call', _77 => _77()]);
+  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _78 => _78.trim, 'call', _79 => _79()]);
   return fromEnv !== void 0 && fromEnv !== "" ? fromEnv : void 0;
 }
 function resolveCredentials(options) {
   const apiKey = _nullishCoalesce(options.apiKey, () => ( _chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_API_KEY")));
   if (!apiKey) {
-    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
       "No Synap API key found. Set SYNAP_API_KEY in your environment, or pass apiKey to the SynapClient constructor."
     );
   }
@@ -4461,5 +4511,6 @@ function resolveCredentials(options) {
 
 
 
-exports.ANY_SCOPE = _chunkICUFS3B5cjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkT372OL3Qcjs.AgentUnavailableError; exports.AnticipationCache = _chunkICUFS3B5cjs.AnticipationCache; exports.AuthenticationError = _chunkT372OL3Qcjs.AuthenticationError; exports.BM25 = _chunkICUFS3B5cjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkICUFS3B5cjs.CONTRACT; exports.ConflictError = _chunkT372OL3Qcjs.ConflictError; exports.ConnectionError = _chunkT372OL3Qcjs.ConnectionError; exports.ContextNotFoundError = _chunkT372OL3Qcjs.ContextNotFoundError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.DEFAULT_DOCUMENT_TYPE = DEFAULT_DOCUMENT_TYPE; exports.DEFAULT_INGEST_MODE = DEFAULT_INGEST_MODE; exports.DEFAULT_RETRY_POLICY = DEFAULT_RETRY_POLICY; exports.DEFAULT_TIMEOUTS = DEFAULT_TIMEOUTS; exports.DOCUMENT_TYPES = DOCUMENT_TYPES; exports.ENDPOINTS = ENDPOINTS; exports.EXCERPT_CATEGORY = EXCERPT_CATEGORY; exports.FORGET_MODES = FORGET_MODES; exports.HttpTransport = HttpTransport; exports.INGEST_MODES = INGEST_MODES; exports.ITEM_COLLECTIONS = ITEM_COLLECTIONS; exports.InsufficientCreditsError = _chunkT372OL3Qcjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunkT372OL3Qcjs.InvalidConversationIdError; exports.InvalidInputError = _chunkT372OL3Qcjs.InvalidInputError; exports.InvalidInstanceIdError = _chunkT372OL3Qcjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunkT372OL3Qcjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunkT372OL3Qcjs.ListeningNotActiveError; exports.MEMORY_TYPES = MEMORY_TYPES; exports.NetworkTimeoutError = _chunkT372OL3Qcjs.NetworkTimeoutError; exports.PermanentError = _chunkT372OL3Qcjs.PermanentError; exports.RESPONSE_SHAPES = RESPONSE_SHAPES; exports.RateLimitError = _chunkT372OL3Qcjs.RateLimitError; exports.SDKError = _chunkT372OL3Qcjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunkT372OL3Qcjs.ServiceUnavailableError; exports.SessionExpiredError = _chunkT372OL3Qcjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunkT372OL3Qcjs.SynapError; exports.SynapPermanentError = _chunkT372OL3Qcjs.SynapPermanentError; exports.SynapTransientError = _chunkT372OL3Qcjs.SynapTransientError; exports.THRESHOLDS = _chunkICUFS3B5cjs.THRESHOLDS; exports.TranscriptConflictError = _chunkT372OL3Qcjs.TranscriptConflictError; exports.TransientError = _chunkT372OL3Qcjs.TransientError; exports.applyResponseShape = applyResponseShape; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkICUFS3B5cjs.isRecallQuery; exports.isSynapError = _chunkT372OL3Qcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.rankItems = rankItems; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkICUFS3B5cjs.stem; exports.tokenize = _chunkICUFS3B5cjs.tokenize; exports.wireRankScore = wireRankScore;
+
+exports.ANY_SCOPE = _chunkICUFS3B5cjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkUXNVTP4Dcjs.AgentUnavailableError; exports.AnticipationCache = _chunkICUFS3B5cjs.AnticipationCache; exports.AuthenticationError = _chunkUXNVTP4Dcjs.AuthenticationError; exports.BM25 = _chunkICUFS3B5cjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkICUFS3B5cjs.CONTRACT; exports.ConflictError = _chunkUXNVTP4Dcjs.ConflictError; exports.ConnectionError = _chunkUXNVTP4Dcjs.ConnectionError; exports.ContextNotFoundError = _chunkUXNVTP4Dcjs.ContextNotFoundError; exports.CustomerIdNotAcceptedError = _chunkUXNVTP4Dcjs.CustomerIdNotAcceptedError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.DEFAULT_DOCUMENT_TYPE = DEFAULT_DOCUMENT_TYPE; exports.DEFAULT_INGEST_MODE = DEFAULT_INGEST_MODE; exports.DEFAULT_RETRY_POLICY = DEFAULT_RETRY_POLICY; exports.DEFAULT_TIMEOUTS = DEFAULT_TIMEOUTS; exports.DOCUMENT_TYPES = DOCUMENT_TYPES; exports.ENDPOINTS = ENDPOINTS; exports.EXCERPT_CATEGORY = EXCERPT_CATEGORY; exports.FORGET_MODES = FORGET_MODES; exports.HttpTransport = HttpTransport; exports.INGEST_MODES = INGEST_MODES; exports.ITEM_COLLECTIONS = ITEM_COLLECTIONS; exports.InsufficientCreditsError = _chunkUXNVTP4Dcjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunkUXNVTP4Dcjs.InvalidConversationIdError; exports.InvalidInputError = _chunkUXNVTP4Dcjs.InvalidInputError; exports.InvalidInstanceIdError = _chunkUXNVTP4Dcjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunkUXNVTP4Dcjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunkUXNVTP4Dcjs.ListeningNotActiveError; exports.MEMORY_TYPES = MEMORY_TYPES; exports.NetworkTimeoutError = _chunkUXNVTP4Dcjs.NetworkTimeoutError; exports.PermanentError = _chunkUXNVTP4Dcjs.PermanentError; exports.RESPONSE_SHAPES = RESPONSE_SHAPES; exports.RateLimitError = _chunkUXNVTP4Dcjs.RateLimitError; exports.SDKError = _chunkUXNVTP4Dcjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunkUXNVTP4Dcjs.ServiceUnavailableError; exports.SessionExpiredError = _chunkUXNVTP4Dcjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunkUXNVTP4Dcjs.SynapError; exports.SynapPermanentError = _chunkUXNVTP4Dcjs.SynapPermanentError; exports.SynapTransientError = _chunkUXNVTP4Dcjs.SynapTransientError; exports.THRESHOLDS = _chunkICUFS3B5cjs.THRESHOLDS; exports.TranscriptConflictError = _chunkUXNVTP4Dcjs.TranscriptConflictError; exports.TransientError = _chunkUXNVTP4Dcjs.TransientError; exports.applyResponseShape = applyResponseShape; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkICUFS3B5cjs.isRecallQuery; exports.isSynapError = _chunkUXNVTP4Dcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.rankItems = rankItems; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkICUFS3B5cjs.stem; exports.tokenize = _chunkICUFS3B5cjs.tokenize; exports.wireRankScore = wireRankScore;
 //# sourceMappingURL=index.cjs.map