@maximem/synap-js-sdk 0.4.8 → 0.5.2

package/dist/index.cjs

@@ -8,8 +8,10 @@
 
 
 
+var _chunkT6U5PVADcjs = require('./chunk-T6U5PVAD.cjs');
 
 
+var _chunkZKOJDUN4cjs = require('./chunk-ZKOJDUN4.cjs');
 
 
 
@@ -22,7 +24,6 @@
 
 
 
-var _chunk2TVL5IPQcjs = require('./chunk-2TVL5IPQ.cjs');
 
 
 
@@ -33,27 +34,10 @@ var _chunk2TVL5IPQcjs = require('./chunk-2TVL5IPQ.cjs');
 
 
 
-var _chunkT6U5PVADcjs = require('./chunk-T6U5PVAD.cjs');
 
 
-var _chunkZKOJDUN4cjs = require('./chunk-ZKOJDUN4.cjs');
 
-// src/util/correlation.ts
-function newCorrelationId() {
-  const c = globalThis.crypto;
-  if (typeof _optionalChain([c, 'optionalAccess', _ => _.randomUUID]) === "function") return c.randomUUID();
-  if (typeof _optionalChain([c, 'optionalAccess', _2 => _2.getRandomValues]) === "function") {
-    const b = c.getRandomValues(new Uint8Array(16));
-    b[6] = (_nullishCoalesce(b[6], () => ( 0))) & 15 | 64;
-    b[8] = (_nullishCoalesce(b[8], () => ( 0))) & 63 | 128;
-    const h = Array.from(b, (x) => x.toString(16).padStart(2, "0")).join("");
-    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
-  }
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (ch) => {
-    const r = Math.random() * 16 | 0;
-    return (ch === "x" ? r : r & 3 | 8).toString(16);
-  });
-}
+var _chunkT372OL3Qcjs = require('./chunk-T372OL3Q.cjs');
 
 // src/transport/endpoints.ts
 var ENDPOINTS = {
@@ -114,7 +98,7 @@ function shouldRetry(input) {
   if (attempt >= policy.maxAttempts) {
     return { retry: false, delaySeconds: 0, reason: "max_attempts_exhausted" };
   }
-  if (!_chunk2TVL5IPQcjs.isSynapError.call(void 0, error) || !error.transient) {
+  if (!_chunkT372OL3Qcjs.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())));
@@ -132,7 +116,7 @@ function shouldRetry(input) {
   };
 }
 function backoffDelay(error, attempt, policy) {
-  if (error instanceof _chunk2TVL5IPQcjs.RateLimitError && error.retryAfterSeconds != null) {
+  if (error instanceof _chunkT372OL3Qcjs.RateLimitError && error.retryAfterSeconds != null) {
     return Math.min(error.retryAfterSeconds, policy.backoffMax);
   }
   const exponential = policy.backoffBase * 2 ** (attempt - 1);
@@ -147,7 +131,7 @@ var HEARTBEAT_INTERVAL_MS = 24e4;
 var MAX_CONNECTIONS = 20;
 var cached;
 function supportsDispatcher() {
-  return typeof process !== "undefined" && _optionalChain([process, 'access', _3 => _3.versions, 'optionalAccess', _4 => _4.node]) !== void 0 && // Edge builds of Next expose a partial `process` shim, but no real Node.
+  return typeof process !== "undefined" && _optionalChain([process, 'access', _ => _.versions, 'optionalAccess', _2 => _2.node]) !== void 0 && // Edge builds of Next expose a partial `process` shim, but no real Node.
   typeof globalThis.EdgeRuntime === "undefined";
 }
 async function getKeepAliveDispatcher(options = {}) {
@@ -188,7 +172,7 @@ var Heartbeat = (_class = class {
       void Promise.resolve(this.ping()).catch(() => {
       });
     }, this.intervalMs);
-    _optionalChain([this, 'access', _5 => _5.timer, 'access', _6 => _6.unref, 'optionalCall', _7 => _7()]);
+    _optionalChain([this, 'access', _3 => _3.timer, 'access', _4 => _4.unref, 'optionalCall', _5 => _5()]);
   }
   stop() {
     if (this.timer !== null) {
@@ -206,7 +190,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, _chunk2TVL5IPQcjs.InvalidInputError)(
+  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)}.`
   );
 }
@@ -241,7 +225,7 @@ var HttpTransport = (_class2 = class {
     this.keepAliveOptions = _nullishCoalesce(options.keepAlive, () => ( {}));
     this.heartbeat = new Heartbeat(
       () => this.pingHealth(),
-      _nullishCoalesce(_optionalChain([options, 'access', _8 => _8.keepAlive, 'optionalAccess', _9 => _9.heartbeatIntervalMs]), () => ( HEARTBEAT_INTERVAL_MS))
+      _nullishCoalesce(_optionalChain([options, 'access', _6 => _6.keepAlive, 'optionalAccess', _7 => _7.heartbeatIntervalMs]), () => ( HEARTBEAT_INTERVAL_MS))
     );
   }
   /** Start keeping the connection warm. Opt-in: it is pointless in serverless. */
@@ -308,7 +292,7 @@ var HttpTransport = (_class2 = class {
   }
   async request(name, options = {}) {
     const spec = ENDPOINTS[name];
-    const correlationId = _nullishCoalesce(options.correlationId, () => ( newCorrelationId()));
+    const correlationId = _nullishCoalesce(options.correlationId, () => ( _chunkT372OL3Qcjs.newCorrelationId.call(void 0, )));
     const idempotent = _nullishCoalesce(options.idempotent, () => ( spec.idempotent));
     let attempt = 0;
     let last = null;
@@ -330,7 +314,7 @@ var HttpTransport = (_class2 = class {
         await sleep(decision.delaySeconds * 1e3, options.signal);
       }
     }
-    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _10 => _10.error]), () => ( new (0, _chunk2TVL5IPQcjs.SynapError)("Request failed with no recorded error")));
+    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _8 => _8.error]), () => ( new (0, _chunkT372OL3Qcjs.SynapError)("Request failed with no recorded error")));
   }
   async attempt(name, options, correlationId) {
     const spec = ENDPOINTS[name];
@@ -363,7 +347,7 @@ var HttpTransport = (_class2 = class {
     try {
       return JSON.parse(text);
     } catch (e3) {
-      throw new (0, _chunk2TVL5IPQcjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
+      throw new (0, _chunkT372OL3Qcjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
     }
   }
   buildUrl(path, query) {
@@ -397,32 +381,42 @@ var HttpTransport = (_class2 = class {
   }
 }, _class2);
 function isOutcomeUnknown(error) {
-  if (error instanceof _chunk2TVL5IPQcjs.RateLimitError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.ServiceUnavailableError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.AuthenticationError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.InvalidInputError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.ConflictError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.InsufficientCreditsError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.ContextNotFoundError) return false;
-  if (error instanceof _chunk2TVL5IPQcjs.NetworkTimeoutError) return true;
+  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 (isConnectionRefusal(error)) return false;
   return true;
 }
 function isConnectionRefusal(error) {
-  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _11 => _11.cause, 'optionalAccess', _12 => _12.code]), () => ( _optionalChain([error, 'optionalAccess', _13 => _13.code])));
+  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _9 => _9.cause, 'optionalAccess', _10 => _10.code]), () => ( _optionalChain([error, 'optionalAccess', _11 => _11.code])));
   return code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "EAI_AGAIN" || code === "ECONNRESET" || code === "EHOSTUNREACH";
 }
 function toTransportError(error, correlationId) {
-  if (error instanceof _chunk2TVL5IPQcjs.SynapError) return error;
-  const name = _optionalChain([error, 'optionalAccess', _14 => _14.name]);
+  if (error instanceof _chunkT372OL3Qcjs.SynapError) return error;
+  const name = _optionalChain([error, 'optionalAccess', _12 => _12.name]);
   if (name === "AbortError" || name === "TimeoutError") {
-    return new (0, _chunk2TVL5IPQcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
+    return new (0, _chunkT372OL3Qcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
   }
-  return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(
-    `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _15 => _15.message]), () => ( String(error)))}`,
+  return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(
+    `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _13 => _13.message]), () => ( String(error)))}`,
     { correlationId, cause: error }
   );
 }
+var CREDIT_ERRORS = /* @__PURE__ */ new Set(["insufficient_credits", "trial_limit_reached"]);
+function creditPayload(parsed, detailObject) {
+  return _nullishCoalesce(detailObject, () => ( parsed));
+}
+function creditReason(payload) {
+  const reason = stringOrNull(payload["reason"]);
+  if (reason !== null) return reason;
+  const error = stringOrNull(payload["error"]);
+  return error !== null && CREDIT_ERRORS.has(error) ? error : null;
+}
 async function toHttpError(response, correlationId) {
   const body = await response.text().catch(() => "");
   let parsed = {};
@@ -438,40 +432,48 @@ async function toHttpError(response, correlationId) {
   switch (response.status) {
     case 400:
     case 422:
-      return new (0, _chunk2TVL5IPQcjs.InvalidInputError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.InvalidInputError)(message, opts);
     case 401:
     case 403:
-      return new (0, _chunk2TVL5IPQcjs.AuthenticationError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.AuthenticationError)(message, opts);
     case 404:
-      return new (0, _chunk2TVL5IPQcjs.ContextNotFoundError)(message, opts);
-    case 402:
-      return new (0, _chunk2TVL5IPQcjs.InsufficientCreditsError)(message, {
+      return new (0, _chunkT372OL3Qcjs.ContextNotFoundError)(message, opts);
+    case 402: {
+      const credit = creditPayload(parsed, detailObject);
+      return new (0, _chunkT372OL3Qcjs.InsufficientCreditsError)(message, {
         ...opts,
-        balanceCredits: numberOrNull(parsed["balance_credits"]),
-        requiredCredits: _nullishCoalesce(numberOrNull(parsed["minimum_required_credits"]), () => ( numberOrNull(parsed["required_credits"]))),
-        recoveryUrl: stringOrNull(parsed["recovery_url"]),
-        redeemUrl: stringOrNull(parsed["redeem_url"])
+        balanceCredits: numberOrNull(credit["balance_credits"]),
+        requiredCredits: _nullishCoalesce(numberOrNull(credit["minimum_required_credits"]), () => ( numberOrNull(credit["required_credits"]))),
+        recoveryUrl: stringOrNull(credit["recovery_url"]),
+        redeemUrl: stringOrNull(credit["redeem_url"]),
+        reason: creditReason(credit),
+        manageUrl: stringOrNull(credit["manage_url"])
       });
+    }
     case 409:
       if (detailObject !== null && detailObject["code"] === "transcript_conflict") {
-        return new (0, _chunk2TVL5IPQcjs.TranscriptConflictError)(message, opts);
+        return new (0, _chunkT372OL3Qcjs.TranscriptConflictError)(message, opts);
       }
-      return new (0, _chunk2TVL5IPQcjs.ConflictError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.ConflictError)(message, opts);
     case 429: {
       const header = response.headers.get("retry-after");
       const retryAfter = header !== null && header.trim() !== "" ? Number(header) : null;
-      return new (0, _chunk2TVL5IPQcjs.RateLimitError)(message, {
+      const credit = creditPayload(parsed, detailObject);
+      return new (0, _chunkT372OL3Qcjs.RateLimitError)(message, {
         ...opts,
-        retryAfterSeconds: retryAfter !== null && Number.isFinite(retryAfter) ? retryAfter : null
+        retryAfterSeconds: retryAfter !== null && Number.isFinite(retryAfter) ? retryAfter : null,
+        reason: creditReason(credit),
+        upgradeUrl: stringOrNull(credit["upgrade_url"]),
+        manageUrl: stringOrNull(credit["manage_url"])
       });
     }
     case 503:
-      return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(message, opts);
     case 504:
-      return new (0, _chunk2TVL5IPQcjs.AgentUnavailableError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.AgentUnavailableError)(message, opts);
     default:
-      if (response.status >= 500) return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(message, opts);
-      return new (0, _chunk2TVL5IPQcjs.SynapError)(message, opts);
+      if (response.status >= 500) return new (0, _chunkT372OL3Qcjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunkT372OL3Qcjs.SynapError)(message, opts);
   }
 }
 function numberOrNull(v) {
@@ -482,11 +484,11 @@ function stringOrNull(v) {
 }
 function withTimeout(ms, external) {
   const controller = new AbortController();
-  const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _16 => _16.reason]));
+  const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _14 => _14.reason]));
   const timer = setTimeout(() => {
-    controller.abort(new (0, _chunk2TVL5IPQcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
+    controller.abort(new (0, _chunkT372OL3Qcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
   }, ms);
-  _optionalChain([timer, 'access', _17 => _17.unref, 'optionalCall', _18 => _18()]);
+  _optionalChain([timer, 'access', _15 => _15.unref, 'optionalCall', _16 => _16()]);
   if (external) {
     if (external.aborted) onExternalAbort();
     else external.addEventListener("abort", onExternalAbort, { once: true });
@@ -495,7 +497,7 @@ function withTimeout(ms, external) {
     signal: controller.signal,
     dispose() {
       clearTimeout(timer);
-      _optionalChain([external, 'optionalAccess', _19 => _19.removeEventListener, 'call', _20 => _20("abort", onExternalAbort)]);
+      _optionalChain([external, 'optionalAccess', _17 => _17.removeEventListener, 'call', _18 => _18("abort", onExternalAbort)]);
     }
   };
 }
@@ -503,14 +505,14 @@ function sleep(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _21 => _21.removeEventListener, 'call', _22 => _22("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _19 => _19.removeEventListener, 'call', _20 => _20("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _23 => _23.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _21 => _21.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _24 => _24.addEventListener, 'call', _25 => _25("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _22 => _22.addEventListener, 'call', _23 => _23("abort", onAbort, { once: true })]);
   });
 }
 
@@ -536,10 +538,10 @@ function buildFetchRequest(scope, options) {
   const precisionLevel = _nullishCoalesce(opt(options, "precision_level", "precisionLevel"), () => ( "high"));
   const mode = _nullishCoalesce(options.mode, () => ( "fast"));
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("search_query must be an array when provided");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("search_query must be an array when provided");
   }
   if (options.types !== void 0 && !Array.isArray(options.types)) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("types must be an array when provided");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("types must be an array when provided");
   }
   const body = {
     conversation_id: _nullishCoalesce(conversationId, () => ( null)),
@@ -555,22 +557,22 @@ function buildFetchRequest(scope, options) {
   switch (scope) {
     case "user":
       {
-        if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+        if (!userId) throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInputError)(
+          throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInputError)("last_n_conversations must be an integer");
+          throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("last_n_conversations must be an integer");
         }
         if (lastN < 0 || lastN > 20) {
-          throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
+          throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
         }
         if (contextMode === "conversation-summary") {
           body["context_mode"] = contextMode;
@@ -582,11 +584,11 @@ function buildFetchRequest(scope, options) {
       }
       break;
     case "customer":
-      if (!customerId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("customer_id is required");
       body["customer_id"] = customerId;
       break;
     case "conversation":
-      if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+      if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
       if (userId !== void 0) body["user_id"] = userId;
       if (customerId !== void 0) body["customer_id"] = customerId;
       break;
@@ -602,16 +604,16 @@ async function fetchContext(transport, scope, options = {}, hooks = {}) {
     opt(options, "customer_id", "customerId"),
     `${scope}.context.fetch`
   );
-  const anticipated = _nullishCoalesce(_optionalChain([hooks, 'access', _26 => _26.beforeFetch, 'optionalCall', _27 => _27(scope, options)]), () => ( null));
+  const anticipated = _nullishCoalesce(_optionalChain([hooks, 'access', _24 => _24.beforeFetch, 'optionalCall', _25 => _25(scope, options)]), () => ( null));
   if (anticipated !== null) {
-    _optionalChain([hooks, 'access', _28 => _28.onServedFromCache, 'optionalCall', _29 => _29(scope, options, anticipated)]);
-    _optionalChain([hooks, 'access', _30 => _30.onAssembled, 'optionalCall', _31 => _31(scope, options, anticipated.response, startedAt)]);
+    _optionalChain([hooks, 'access', _26 => _26.onServedFromCache, 'optionalCall', _27 => _27(scope, options, anticipated)]);
+    _optionalChain([hooks, 'access', _28 => _28.onAssembled, 'optionalCall', _29 => _29(scope, options, anticipated.response, startedAt)]);
     return anticipated.response;
   }
   const { endpoint, body } = buildFetchRequest(scope, options);
   const result = await transport.request(endpoint, { body });
-  const response = _nullishCoalesce(_optionalChain([result, 'optionalAccess', _32 => _32["context"]]), () => ( {}));
-  _optionalChain([hooks, 'access', _33 => _33.onAssembled, 'optionalCall', _34 => _34(scope, options, response, startedAt)]);
+  const response = _nullishCoalesce(_optionalChain([result, 'optionalAccess', _30 => _30["context"]]), () => ( {}));
+  _optionalChain([hooks, 'access', _31 => _31.onAssembled, 'optionalCall', _32 => _32(scope, options, response, startedAt)]);
   return response;
 }
 
@@ -831,17 +833,17 @@ function isoOrNull(v) {
   return v instanceof Date ? v.toISOString() : v;
 }
 function buildCreateBody(options) {
-  if (!options.document) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("document is required");
+  if (!options.document) throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInputError)(
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
       `Invalid document_type '${documentType}'. Expected one of: ${DOCUMENT_TYPES.join(", ")}`
     );
   }
   if (!INGEST_MODES.includes(mode)) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
       `Invalid mode '${mode}'. Expected one of: ${INGEST_MODES.join(", ")}`
     );
   }
@@ -873,7 +875,7 @@ function createMemoriesInterface(transport) {
     async batch_create(options) {
       const docs = options.documents;
       if (!Array.isArray(docs) || docs.length === 0) {
-        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("documents must be a non-empty array");
+        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("documents must be a non-empty array");
       }
       const failFast = _nullishCoalesce(_nullishCoalesce(options.fail_fast, () => ( options.failFast)), () => ( false));
       return transport.request("memories_batch", {
@@ -883,15 +885,15 @@ function createMemoriesInterface(transport) {
     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, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
       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, _chunk2TVL5IPQcjs.InvalidInputError)("One of file_path, file, or text must be provided.");
+        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("One of file_path, file, or text must be provided.");
       }
       if (sources.length > 1) {
-        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
+        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
           "Provide exactly one of file_path, file, or text, not several."
         );
       }
@@ -922,13 +924,13 @@ function createMemoriesInterface(transport) {
       });
     },
     async get(memoryId) {
-      if (!memoryId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("memory_id is required");
+      if (!memoryId) throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInputError)("memory_id is required");
-      if (!options.document) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("document is required");
+      if (!memoryId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("memory_id is required");
+      if (!options.document) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("document is required");
       const body = {
         document: options.document,
         merge_strategy: _nullishCoalesce(_nullishCoalesce(options.merge_strategy, () => ( options.mergeStrategy)), () => ( "smart-merge"))
@@ -943,20 +945,20 @@ function createMemoriesInterface(transport) {
     },
     async delete(memoryId) {
       if (!memoryId) {
-        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
+        throw new (0, _chunkT372OL3Qcjs.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."
         );
       }
       return transport.request("memories_delete", { pathParams: { memory_id: memoryId } });
     },
     async status(ingestionId) {
-      if (!ingestionId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunkT372OL3Qcjs.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;
@@ -977,14 +979,14 @@ function sleep2(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _35 => _35.removeEventListener, 'call', _36 => _36("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _33 => _33.removeEventListener, 'call', _34 => _34("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _37 => _37.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _35 => _35.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _38 => _38.addEventListener, 'call', _39 => _39("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _36 => _36.addEventListener, 'call', _37 => _37("abort", onAbort, { once: true })]);
   });
 }
 
@@ -994,13 +996,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, _chunk2TVL5IPQcjs.InvalidConversationIdError)(`Invalid conversation ID: ${String(conversationId)}`);
+    throw new (0, _chunkT372OL3Qcjs.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, _chunk2TVL5IPQcjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
+    throw new (0, _chunkT372OL3Qcjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
   }
 }
 
@@ -1029,13 +1031,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, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
   validateConversationId(conversationId);
-  if (!options.role) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("role is required");
+  if (!options.role) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("role is required");
   if (options.content === void 0 || options.content === null) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("content is required");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("content is required");
   }
-  if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+  if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
   const body = {
     conversation_id: conversationId,
     role: options.role,
@@ -1047,16 +1049,18 @@ function buildRecordMessageBody(options) {
   };
   const sessionId = either2(o2, "session_id", "sessionId");
   if (sessionId !== void 0) body["session_id"] = sessionId;
+  const scopePath = either2(o2, "scope_path", "scopePath");
+  if (scopePath !== void 0) body["scope"] = scopePath;
   return body;
 }
 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, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
-  if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+  if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
   if (options.transcript === void 0 || options.transcript === null) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("transcript is required");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("transcript is required");
   }
   const body = {
     conversation_id: conversationId,
@@ -1073,12 +1077,14 @@ function buildIngestTranscriptBody(options) {
   if (options.metadata !== void 0) body["metadata"] = options.metadata;
   if (startedAt !== void 0) body["started_at"] = startedAt;
   if (endedAt !== void 0) body["ended_at"] = endedAt;
+  const scopePath = either2(o2, "scope_path", "scopePath");
+  if (scopePath !== void 0) body["scope"] = scopePath;
   return body;
 }
 function buildCompactBody(options) {
   const o2 = options;
   const conversationId = either2(o2, "conversation_id", "conversationId");
-  if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunkT372OL3Qcjs.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")));
@@ -1134,7 +1140,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
 }, localShortTerm = { prompt: () => null, compacted: () => null }) {
   const convId = (v) => {
     const id = typeof v === "string" ? v : _nullishCoalesce(v.conversation_id, () => ( v.conversationId));
-    if (!id) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+    if (!id) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
     validateConversationId(id);
     return id;
   };
@@ -1160,7 +1166,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
     },
     async record_messages_batch(messages) {
       if (!Array.isArray(messages) || messages.length === 0) {
-        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("messages must be a non-empty array");
+        throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("messages must be a non-empty array");
       }
       for (const m of messages) {
         const mo = m;
@@ -1219,7 +1225,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
           pathParams: { conversation_id: id },
           query: { style: _nullishCoalesce(options.style, () => ( "structured")) }
         });
-        return _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _40 => _40["context_for_prompt"]]), () => ( result)), () => ( {}));
+        return _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _38 => _38["context_for_prompt"]]), () => ( result)), () => ( {}));
       },
       async compact(options) {
         return transport.request("conversations_compact", { body: buildCompactBody(options) });
@@ -1258,8 +1264,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, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
-        if (typeof callback !== "function") throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("callback is required");
+        if (!conversationId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("conversation_id is required");
+        if (typeof callback !== "function") throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("callback is required");
         return subscribers.add(conversationId, callback);
       },
       /** Remove subscribers for one conversation, or all of them. Returns the count removed. */
@@ -1275,7 +1281,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, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunkT372OL3Qcjs.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 },
@@ -1324,7 +1330,7 @@ function createCreditsNamespace(transport) {
       });
     },
     async redeem(code) {
-      if (!code) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("code is required");
+      if (!code) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("code is required");
       return transport.request("credits_redeem", { body: { code } });
     }
   };
@@ -1335,11 +1341,11 @@ function createCacheNamespace(cache) {
   return {
     clear: () => cache.clear(),
     clear_user: (userId) => {
-      if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
       cache.dropEntity(userId);
     },
     clear_customer: (customerId) => {
-      if (!customerId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("customer_id is required");
       cache.dropEntity(customerId);
     },
     stats: () => ({ bundles: cache.size, items: cache.itemCount })
@@ -1372,23 +1378,39 @@ function thinkingMetadata(options) {
   }
   return md;
 }
+var KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "user_message",
+  "assistant_message",
+  "tool_call",
+  "tool_result",
+  "agent_thinking",
+  "context_request",
+  "context_fetch",
+  "session_start",
+  "session_end"
+]);
+function toolResultJson(result) {
+  if (result === void 0 || result === null) return "";
+  return typeof result === "string" ? result : JSON.stringify(result);
+}
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
+  const openSessions = /* @__PURE__ */ new Map();
   let dispatchCompaction = null;
   let applyCompaction = null;
   const internals = {
     onCompactionUpdate(conversationId, bundle) {
-      _optionalChain([applyCompaction, 'optionalCall', _41 => _41(bundle)]);
-      _optionalChain([dispatchCompaction, 'optionalCall', _42 => _42(conversationId, bundle)]);
+      _optionalChain([applyCompaction, 'optionalCall', _39 => _39(bundle)]);
+      _optionalChain([dispatchCompaction, 'optionalCall', _40 => _40(conversationId, bundle)]);
     },
     setCompactionApplier(apply) {
       applyCompaction = apply;
     },
     sendContextUsed(event) {
-      _optionalChain([client, 'optionalAccess', _43 => _43.sendContextUsed, 'call', _44 => _44(event)]);
+      _optionalChain([client, 'optionalAccess', _41 => _41.sendContextUsed, 'call', _42 => _42(event)]);
     },
     sendContextAssembled(event) {
-      _optionalChain([client, 'optionalAccess', _45 => _45.sendContextAssembled, 'call', _46 => _46(event)]);
+      _optionalChain([client, 'optionalAccess', _43 => _43.sendContextAssembled, 'call', _44 => _44(event)]);
     },
     setCompactionDispatcher(dispatch) {
       dispatchCompaction = dispatch;
@@ -1397,16 +1419,33 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       return client !== null && client.isConnected;
     }
   };
+  function ensureSession(conversationId, userId, customerId) {
+    if (!conversationId || !userId || client === null) return;
+    if (openSessions.has(conversationId)) return;
+    const sessionId = _chunkT372OL3Qcjs.newCorrelationId.call(void 0, );
+    try {
+      client.sendSessionControl({
+        action: "start",
+        session_id: sessionId,
+        conversation_id: conversationId,
+        ...userId ? { user_id: userId } : {},
+        ...customerId ? { customer_id: customerId } : {}
+      });
+      openSessions.set(conversationId, sessionId);
+    } catch (e5) {
+    }
+  }
   const namespace = {
     async listen(options = {}) {
       if (client !== null) {
-        throw new (0, _chunk2TVL5IPQcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
+        throw new (0, _chunkT372OL3Qcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-GPU37E6F.cjs")));
+      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-GJM4YSXW.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));
       let reconnectAttempts = 0;
+      let stream = null;
       const created = new GrpcStreamClient(credentials(), cache, {
         host: _nullishCoalesce(_nullishCoalesce(options.host, () => ( _chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_GRPC_HOST"))), () => ( DEFAULT_GRPC_HOST)),
         port: _nullishCoalesce(_nullishCoalesce(options.port, () => ( envPort())), () => ( DEFAULT_GRPC_PORT)),
@@ -1416,20 +1455,24 @@ function createInstanceNamespace(credentials, cache, onTurn) {
           internals.onCompactionUpdate(conversationId, bundle);
         },
         onStateChange: (state) => {
+          if (state !== "connected") openSessions.clear();
           if (state === "reconnecting") {
             reconnectAttempts += 1;
-            _optionalChain([onReconnect, 'optionalCall', _47 => _47(reconnectAttempts)]);
+            _optionalChain([onReconnect, 'optionalCall', _45 => _45(reconnectAttempts)]);
           } else if (state === "disconnected") {
-            _optionalChain([onDisconnect, 'optionalCall', _48 => _48("stream disconnected")]);
+            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _46 => _46.lastError]), () => ( null));
+            const reason = stopped === null ? "stream disconnected" : `credit_stop:${_nullishCoalesce(stopped.reason, () => ( "unknown"))}`;
+            _optionalChain([onDisconnect, 'optionalCall', _47 => _47(reason)]);
           }
         }
       });
+      stream = created;
       try {
         await created.connect();
       } catch (error) {
-        if (error instanceof _chunk2TVL5IPQcjs.SynapError) throw error;
-        throw new (0, _chunk2TVL5IPQcjs.SynapError)(
-          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _49 => _49.message]), () => ( String(error)))}`,
+        if (error instanceof _chunkT372OL3Qcjs.SynapError) throw error;
+        throw new (0, _chunkT372OL3Qcjs.SynapError)(
+          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _48 => _48.message]), () => ( String(error)))}`,
           { cause: error }
         );
       }
@@ -1437,29 +1480,58 @@ function createInstanceNamespace(credentials, cache, onTurn) {
     },
     async stop_listening() {
       if (client === null) return;
+      for (const conversationId of [...openSessions.keys()]) {
+        await namespace.end_session(conversationId);
+      }
       const active = client;
       client = null;
       await active.disconnect();
     },
+    async end_session(conversationId) {
+      const sessionId = openSessions.get(conversationId);
+      if (sessionId === void 0 || client === null) return;
+      openSessions.delete(conversationId);
+      try {
+        client.sendSessionControl({
+          action: "end",
+          session_id: sessionId,
+          conversation_id: conversationId
+        });
+      } catch (e6) {
+      }
+    },
     async send_message(options) {
-      if (client === null) throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("Listening is not active");
       if (options.content === void 0) {
-        throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("content is required");
+        throw new (0, _chunkT372OL3Qcjs.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)(
+          `unknown event_type '${eventType}'. Expected one of: ` + [...KNOWN_EVENT_TYPES].sort().join(", ")
+        );
       }
       const conversationId = _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( ""));
-      _optionalChain([onTurn, 'optionalCall', _50 => _50({
+      ensureSession(
         conversationId,
-        role: _nullishCoalesce(options.role, () => ( "user")),
-        content: options.content
-      })]);
+        _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
+        _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( ""))
+      );
+      if (eventType === "user_message" || eventType === "assistant_message") {
+        _optionalChain([onTurn, 'optionalCall', _49 => _49({
+          conversationId,
+          role: _nullishCoalesce(options.role, () => ( "user")),
+          content: options.content
+        })]);
+      }
       client.sendConversationEvent({
-        event_type: _nullishCoalesce(_nullishCoalesce(options.event_type, () => ( options.eventType)), () => ( "user_message")),
+        event_type: eventType,
         content: options.content,
         role: _nullishCoalesce(options.role, () => ( "user")),
         conversation_id: _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( "")),
         user_id: _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
         customer_id: _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( "")),
-        session_id: _nullishCoalesce(_nullishCoalesce(options.session_id, () => ( options.sessionId)), () => ( "")),
+        session_id: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(options.session_id, () => ( options.sessionId)), () => ( openSessions.get(conversationId))), () => ( "")),
         metadata: _nullishCoalesce(options.metadata, () => ( {})),
         timestamp_ms: Date.now(),
         tool_name: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")),
@@ -1468,17 +1540,61 @@ function createInstanceNamespace(credentials, cache, onTurn) {
           const a = _nullishCoalesce(options.tool_args, () => ( options.toolArgs));
           return a === void 0 ? "" : JSON.stringify(a);
         })(),
+        tool_result_json: toolResultJson(_nullishCoalesce(options.tool_result, () => ( options.toolResult))),
+        tool_call_id: _nullishCoalesce(_nullishCoalesce(options.tool_call_id, () => ( options.toolCallId)), () => ( "")),
         search_queries: _nullishCoalesce(_nullishCoalesce(options.search_queries, () => ( options.searchQueries)), () => ( [])),
         context_types: _nullishCoalesce(_nullishCoalesce(options.context_types, () => ( options.contextTypes)), () => ( []))
       });
     },
+    async record_tool_call(options) {
+      await namespace.send_message({
+        content: "",
+        role: "assistant",
+        event_type: "tool_call",
+        tool_name: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")),
+        ..._nullishCoalesce(options.tool_args, () => ( options.toolArgs)) ? { tool_args: _nullishCoalesce(options.tool_args, () => ( options.toolArgs)) } : {},
+        tool_call_id: _nullishCoalesce(_nullishCoalesce(options.tool_call_id, () => ( options.toolCallId)), () => ( "")),
+        conversation_id: _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( "")),
+        user_id: _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
+        customer_id: _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( "")),
+        session_id: _nullishCoalesce(_nullishCoalesce(options.session_id, () => ( options.sessionId)), () => ( "")),
+        metadata: _nullishCoalesce(options.metadata, () => ( {}))
+      });
+    },
+    async record_tool_result(options) {
+      await namespace.send_message({
+        content: "",
+        role: "tool",
+        event_type: "tool_result",
+        tool_result: options.result,
+        tool_name: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")),
+        tool_call_id: _nullishCoalesce(_nullishCoalesce(options.tool_call_id, () => ( options.toolCallId)), () => ( "")),
+        conversation_id: _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( "")),
+        user_id: _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
+        customer_id: _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( "")),
+        session_id: _nullishCoalesce(_nullishCoalesce(options.session_id, () => ( options.sessionId)), () => ( "")),
+        metadata: _nullishCoalesce(options.metadata, () => ( {}))
+      });
+    },
     async record_thinking(options) {
-      if (client === null) throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunkT372OL3Qcjs.ListeningNotActiveError)("Listening is not active");
+      const conversationId = _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( ""));
+      ensureSession(
+        conversationId,
+        _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
+        _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( ""))
+      );
       client.sendConversationEvent({
         // Python emits reasoning as an `agent_thinking` conversation event.
         event_type: "agent_thinking",
         content: options.content,
-        role: "assistant",
+        // Deliberately no role. A thought is not the assistant's reply, and
+        // this went out as 'assistant' from the day it shipped: the server
+        // checked role before event_type, so every reasoning step any client
+        // sent was filed as the final answer and the reasoning path never ran.
+        // Sending no role is correct against both the fixed server and one that
+        // has not been updated yet.
+        role: "",
         conversation_id: _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( "")),
         user_id: _nullishCoalesce(_nullishCoalesce(options.user_id, () => ( options.userId)), () => ( "")),
         customer_id: _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( "")),
@@ -1496,7 +1612,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.4.7";
+var SDK_VERSION = "0.5.2";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -1685,7 +1801,7 @@ function budgetRecentTurns(turns) {
   return windowed;
 }
 function overlayLocalRecentTurns(response, store, conversationId, configured) {
-  if (conversationId === void 0 || conversationId === "") return;
+  if (conversationId === void 0 || conversationId === null || conversationId === "") return;
   try {
     const entry = store.get(conversationId);
     if (entry === null) return;
@@ -1708,7 +1824,7 @@ function overlayLocalRecentTurns(response, store, conversationId, configured) {
       compacted_at: orLocal("compacted_at", entry.compactedAt),
       conversation_id: conversationId
     };
-  } catch (e5) {
+  } catch (e7) {
   }
 }
 
@@ -1721,7 +1837,7 @@ function stringify(value) {
   if (t === "string" || t === "number" || t === "boolean") return String(value);
   try {
     return _nullishCoalesce(JSON.stringify(value), () => ( ""));
-  } catch (e6) {
+  } catch (e8) {
     return String(value);
   }
 }
@@ -1995,7 +2111,7 @@ function tryServeFromCache(cache, scope, params, maxItems) {
     });
     if (hit === null) return { response: null, hit: null };
     return { response: buildAnticipationResponse(hit), hit };
-  } catch (e7) {
+  } catch (e9) {
     return { response: null, hit: null };
   }
 }
@@ -2390,7 +2506,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, _chunk2TVL5IPQcjs.InvalidInputError)(
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
       `scope must be one of ['${sorted.join("', '")}'], got '${String(options.scope)}'`
     );
   }
@@ -2398,10 +2514,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, _chunk2TVL5IPQcjs.InvalidInputError)("scope='user' requires user_id");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("scope='user' requires user_id");
   }
   if (scope === "customer" && (customerId === void 0 || customerId === "")) {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("scope='customer' requires customer_id");
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("scope='customer' requires customer_id");
   }
   if (scope === "conversation" && (userId === void 0 || userId === "")) {
     onWarning(
@@ -2410,7 +2526,7 @@ function buildTool(target, options = {}, onWarning = () => {
   }
   const style = String(_nullishCoalesce(options.style, () => ( "openai")));
   if (style !== "openai" && style !== "anthropic") {
-    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(`style must be 'openai' or 'anthropic', got '${style}'`);
+    throw new (0, _chunkT372OL3Qcjs.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)));
@@ -2613,9 +2729,9 @@ var SynapClient = class {
    */
   async searchMemory(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("user_id is required");
     if (options.query === void 0 || options.query === null) {
-      throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("query is required");
+      throw new (0, _chunkT372OL3Qcjs.InvalidInputError)("query is required");
     }
     const context = await fetchContext(this.#transport, "user", {
       user_id: userId,
@@ -2636,7 +2752,7 @@ var SynapClient = class {
    */
   async getMemories(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunkT372OL3Qcjs.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") } : {},
@@ -2695,7 +2811,7 @@ var SynapClient = class {
           this.#registryKeys.push(resolvedInstanceId);
         }
       }
-    } catch (e8) {
+    } catch (e10) {
     }
   }
   /**
@@ -2730,7 +2846,7 @@ var SynapClient = class {
    */
   configure(options = {}) {
     if (this.#initialized) {
-      throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("Cannot reconfigure after initialization");
+      throw new (0, _chunkT372OL3Qcjs.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) {
@@ -2781,7 +2897,8 @@ var SynapClient = class {
     };
     const labels = [];
     const tasks = [];
-    if (conversationId !== void 0 && conversationId !== "" && wants("conversation")) {
+    const present = (v) => v !== void 0 && v !== null && v !== "";
+    if (present(conversationId) && wants("conversation")) {
       labels.push("conversation");
       tasks.push(this.conversation.context.fetch({
         conversation_id: conversationId,
@@ -2790,7 +2907,7 @@ var SynapClient = class {
         customer_id: customerId
       }));
     }
-    if (userId !== void 0 && userId !== "" && wants("user")) {
+    if (present(userId) && wants("user")) {
       labels.push("user");
       tasks.push(this.user.context.fetch({
         user_id: userId,
@@ -2802,7 +2919,7 @@ var SynapClient = class {
         last_n_conversations: lastNConversations
       }));
     }
-    if (customerId !== void 0 && customerId !== "" && wants("customer")) {
+    if (present(customerId) && wants("customer")) {
       labels.push("customer");
       tasks.push(this.customer.context.fetch({
         customer_id: customerId,
@@ -2829,19 +2946,19 @@ var SynapClient = class {
         successful.push([label, result.value]);
         continue;
       }
-      if (result.reason instanceof _chunk2TVL5IPQcjs.InvalidInputError) throw result.reason;
+      if (result.reason instanceof _chunkT372OL3Qcjs.InvalidInputError) throw result.reason;
       this.#warn(`Scope '${label}' fetch failed in unified fetch (non-fatal): ${String(result.reason)}`);
     }
     const merged = mergeScopeResults(successful);
     for (const [, response] of successful) {
       overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
     }
-    if (includeConversationContext && conversationId !== void 0 && conversationId !== "") {
+    if (includeConversationContext && present(conversationId)) {
       try {
         merged.conversation_context = await this.conversation.context.get_context_for_prompt({
           conversation_id: conversationId
         });
-      } catch (e9) {
+      } catch (e11) {
       }
     }
     merged.formatted_context = formatForPrompt(merged, {
@@ -2888,7 +3005,7 @@ var SynapClient = class {
         source_bundle_ids: served.bundleId ? [served.bundleId] : [],
         timestamp_ms: Date.now()
       });
-    } catch (e10) {
+    } catch (e12) {
     }
   }
   /**
@@ -2903,7 +3020,7 @@ var SynapClient = class {
       if (!this.instance.is_listening) return;
       this.instance._internal.sendContextAssembled({
         ...buildAssembledEvent({
-          correlationId: newCorrelationId(),
+          correlationId: _chunkT372OL3Qcjs.newCorrelationId.call(void 0, ),
           response,
           conversationId: _nullishCoalesce(options["conversation_id"], () => ( options["conversationId"])),
           userId: _nullishCoalesce(options["user_id"], () => ( options["userId"])),
@@ -2913,7 +3030,7 @@ var SynapClient = class {
         }),
         scope
       });
-    } catch (e11) {
+    } catch (e13) {
     }
   }
   /**
@@ -2991,13 +3108,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', _51 => _51.trim, 'call', _52 => _52()]);
+  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _50 => _50.trim, 'call', _51 => _51()]);
   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, _chunk2TVL5IPQcjs.InvalidInputError)(
+    throw new (0, _chunkT372OL3Qcjs.InvalidInputError)(
       "No Synap API key found. Set SYNAP_API_KEY in your environment, or pass apiKey to the SynapClient constructor."
     );
   }
@@ -3058,5 +3175,5 @@ function resolveCredentials(options) {
 
 
 
-exports.ANY_SCOPE = _chunkT6U5PVADcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunk2TVL5IPQcjs.AgentUnavailableError; exports.AnticipationCache = _chunkT6U5PVADcjs.AnticipationCache; exports.AuthenticationError = _chunk2TVL5IPQcjs.AuthenticationError; exports.BM25 = _chunkT6U5PVADcjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkT6U5PVADcjs.CONTRACT; exports.ConflictError = _chunk2TVL5IPQcjs.ConflictError; exports.ConnectionError = _chunk2TVL5IPQcjs.ConnectionError; exports.ContextNotFoundError = _chunk2TVL5IPQcjs.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.HttpTransport = HttpTransport; exports.INGEST_MODES = INGEST_MODES; exports.ITEM_COLLECTIONS = ITEM_COLLECTIONS; exports.InsufficientCreditsError = _chunk2TVL5IPQcjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunk2TVL5IPQcjs.InvalidConversationIdError; exports.InvalidInputError = _chunk2TVL5IPQcjs.InvalidInputError; exports.InvalidInstanceIdError = _chunk2TVL5IPQcjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunk2TVL5IPQcjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunk2TVL5IPQcjs.ListeningNotActiveError; exports.NetworkTimeoutError = _chunk2TVL5IPQcjs.NetworkTimeoutError; exports.PermanentError = _chunk2TVL5IPQcjs.PermanentError; exports.RateLimitError = _chunk2TVL5IPQcjs.RateLimitError; exports.SDKError = _chunk2TVL5IPQcjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunk2TVL5IPQcjs.ServiceUnavailableError; exports.SessionExpiredError = _chunk2TVL5IPQcjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunk2TVL5IPQcjs.SynapError; exports.SynapPermanentError = _chunk2TVL5IPQcjs.SynapPermanentError; exports.SynapTransientError = _chunk2TVL5IPQcjs.SynapTransientError; exports.THRESHOLDS = _chunkT6U5PVADcjs.THRESHOLDS; exports.TranscriptConflictError = _chunk2TVL5IPQcjs.TranscriptConflictError; exports.TransientError = _chunk2TVL5IPQcjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkT6U5PVADcjs.isRecallQuery; exports.isSynapError = _chunk2TVL5IPQcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkT6U5PVADcjs.stem; exports.tokenize = _chunkT6U5PVADcjs.tokenize;
+exports.ANY_SCOPE = _chunkT6U5PVADcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkT372OL3Qcjs.AgentUnavailableError; exports.AnticipationCache = _chunkT6U5PVADcjs.AnticipationCache; exports.AuthenticationError = _chunkT372OL3Qcjs.AuthenticationError; exports.BM25 = _chunkT6U5PVADcjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkT6U5PVADcjs.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.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.NetworkTimeoutError = _chunkT372OL3Qcjs.NetworkTimeoutError; exports.PermanentError = _chunkT372OL3Qcjs.PermanentError; 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 = _chunkT6U5PVADcjs.THRESHOLDS; exports.TranscriptConflictError = _chunkT372OL3Qcjs.TranscriptConflictError; exports.TransientError = _chunkT372OL3Qcjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkT6U5PVADcjs.isRecallQuery; exports.isSynapError = _chunkT372OL3Qcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkT6U5PVADcjs.stem; exports.tokenize = _chunkT6U5PVADcjs.tokenize;
 //# sourceMappingURL=index.cjs.map