@maximem/synap-js-sdk 0.5.11 → 0.5.13

package/dist/index.cjs

@@ -408,22 +408,40 @@ function isOutcomeUnknown(error) {
   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;
+  if (error instanceof _chunkUXNVTP4Dcjs.NetworkTimeoutError) return true;
   return true;
 }
+var CONNECTION_REFUSAL_CODES = /* @__PURE__ */ new Set([
+  "ECONNREFUSED",
+  "ENOTFOUND",
+  "EAI_AGAIN",
+  "ECONNRESET",
+  "EHOSTUNREACH"
+]);
 function isConnectionRefusal(error) {
-  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _10 => _10.cause, 'optionalAccess', _11 => _11.code]), () => ( _optionalChain([error, 'optionalAccess', _12 => _12.code])));
-  return code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "EAI_AGAIN" || code === "ECONNRESET" || code === "EHOSTUNREACH";
+  let cur = error;
+  for (let depth = 0; depth < 4 && cur !== null && typeof cur === "object"; depth += 1) {
+    const code = cur.code;
+    if (typeof code === "string" && CONNECTION_REFUSAL_CODES.has(code)) return true;
+    cur = cur.cause;
+  }
+  return false;
 }
 function toTransportError(error, correlationId) {
   if (error instanceof _chunkUXNVTP4Dcjs.SynapError) return error;
-  const name = _optionalChain([error, 'optionalAccess', _13 => _13.name]);
+  const name = _optionalChain([error, 'optionalAccess', _10 => _10.name]);
   if (name === "AbortError" || name === "TimeoutError") {
     return new (0, _chunkUXNVTP4Dcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
   }
+  if (isConnectionRefusal(error)) {
+    return new (0, _chunkUXNVTP4Dcjs.NetworkTimeoutError)(
+      `Connection failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _11 => _11.message]), () => ( String(error)))}`,
+      { correlationId, cause: error }
+    );
+  }
   return new (0, _chunkUXNVTP4Dcjs.ServiceUnavailableError)(
-    `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _14 => _14.message]), () => ( String(error)))}`,
+    `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _12 => _12.message]), () => ( String(error)))}`,
     { correlationId, cause: error }
   );
 }
@@ -504,11 +522,11 @@ function stringOrNull(v) {
 }
 function withTimeout(ms, external) {
   const controller = new AbortController();
-  const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _15 => _15.reason]));
+  const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _13 => _13.reason]));
   const timer = setTimeout(() => {
     controller.abort(new (0, _chunkUXNVTP4Dcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
   }, ms);
-  _optionalChain([timer, 'access', _16 => _16.unref, 'optionalCall', _17 => _17()]);
+  _optionalChain([timer, 'access', _14 => _14.unref, 'optionalCall', _15 => _15()]);
   if (external) {
     if (external.aborted) onExternalAbort();
     else external.addEventListener("abort", onExternalAbort, { once: true });
@@ -517,7 +535,7 @@ function withTimeout(ms, external) {
     signal: controller.signal,
     dispose() {
       clearTimeout(timer);
-      _optionalChain([external, 'optionalAccess', _18 => _18.removeEventListener, 'call', _19 => _19("abort", onExternalAbort)]);
+      _optionalChain([external, 'optionalAccess', _16 => _16.removeEventListener, 'call', _17 => _17("abort", onExternalAbort)]);
     }
   };
 }
@@ -525,14 +543,14 @@ function sleep(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _20 => _20.removeEventListener, 'call', _21 => _21("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _18 => _18.removeEventListener, 'call', _19 => _19("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _22 => _22.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _20 => _20.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _23 => _23.addEventListener, 'call', _24 => _24("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _21 => _21.addEventListener, 'call', _22 => _22("abort", onAbort, { once: true })]);
   });
 }
 
@@ -639,6 +657,7 @@ function buildFetchRequest(scope, options) {
   const perQuery = opt(options, "max_results_per_query", "maxResultsPerQuery");
   const responseShape = responseShapeOf(options);
   const { mode, precisionLevel } = retrievalOptionsOf(options);
+  const { contextMode, lastN } = scopeOptionsOf(scope, options);
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
     throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("search_query must be an array when provided");
   }
@@ -666,21 +685,7 @@ function buildFetchRequest(scope, options) {
   switch (scope) {
     case "user":
       {
-        if (!userId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("user_id is required");
         body["user_id"] = userId;
-        const contextMode = _nullishCoalesce(opt(options, "context_mode", "contextMode"), () => ( "in-conversation"));
-        if (!VALID_CONTEXT_MODES.includes(contextMode)) {
-          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, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be an integer");
-        }
-        if (lastN < 0 || lastN > 20) {
-          throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
-        }
         if (contextMode === "conversation-summary") {
           body["context_mode"] = contextMode;
           body["include_profile"] = _nullishCoalesce(opt(options, "include_profile", "includeProfile"), () => ( true));
@@ -691,11 +696,9 @@ function buildFetchRequest(scope, options) {
       }
       break;
     case "customer":
-      if (!customerId) throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("customer_id is required");
       body["customer_id"] = customerId;
       break;
     case "conversation":
-      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;
@@ -714,6 +717,33 @@ function responseShapeOf(options) {
   }
   return shape;
 }
+var REQUIRED_ID = {
+  user: ["user_id", "userId"],
+  customer: ["customer_id", "customerId"],
+  conversation: ["conversation_id", "conversationId"],
+  client: null
+};
+function scopeOptionsOf(scope, options) {
+  const required = REQUIRED_ID[scope];
+  if (required !== null && !opt(options, required[0], required[1])) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(`${required[0]} is required`);
+  }
+  const contextMode = _nullishCoalesce(opt(options, "context_mode", "contextMode"), () => ( "in-conversation"));
+  const lastN = _nullishCoalesce(opt(options, "last_n_conversations", "lastNConversations"), () => ( 1));
+  if (scope !== "user") return { contextMode, lastN };
+  if (!VALID_CONTEXT_MODES.includes(contextMode)) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)(
+      `Invalid context_mode '${contextMode}'. Must be one of: ${VALID_CONTEXT_MODES.join(", ")}`
+    );
+  }
+  if (!Number.isInteger(lastN)) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be an integer");
+  }
+  if (lastN < 0 || lastN > 20) {
+    throw new (0, _chunkUXNVTP4Dcjs.InvalidInputError)("last_n_conversations must be between 0 and 20");
+  }
+  return { contextMode, lastN };
+}
 var VALID_MODES = ["fast", "accurate"];
 var VALID_PRECISION = ["high", "medium"];
 function retrievalOptionsOf(options) {
@@ -733,19 +763,30 @@ function retrievalOptionsOf(options) {
 }
 async function fetchContext(transport, scope, options = {}, hooks = {}) {
   const startedAt = Date.now();
-  await _optionalChain([transport, 'access', _25 => _25.ready, 'optionalCall', _26 => _26()]);
+  await _optionalChain([transport, 'access', _23 => _23.ready, 'optionalCall', _24 => _24()]);
   await transport.checkCustomerId(
     opt(options, "customer_id", "customerId"),
     `${scope}.context.fetch`
   );
   const responseShape = responseShapeOf(options);
   retrievalOptionsOf(options);
+  const { contextMode } = scopeOptionsOf(scope, options);
+  const summaryMode = scope === "user" && contextMode === "conversation-summary";
+  const finish = (response2) => {
+    _optionalChain([hooks, 'access', _25 => _25.onResponse, 'optionalCall', _26 => _26(scope, options, response2)]);
+    return response2;
+  };
+  const conversationId = opt(options, "conversation_id", "conversationId");
+  const skipServerSt = conversationId ? _optionalChain([hooks, 'access', _27 => _27.skipServerShortTerm, 'optionalCall', _28 => _28(conversationId)]) === true : false;
   const network = async () => {
-    const { endpoint, body } = buildFetchRequest(scope, options);
+    const { endpoint, body } = buildFetchRequest(
+      scope,
+      skipServerSt ? { ...options, include_conversation_context: false } : options
+    );
     const result = await transport.request(endpoint, { body });
-    return applyResponseShape(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _27 => _27["context"]]), () => ( {})), responseShape);
+    return applyResponseShape(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _29 => _29["context"]]), () => ( {})), responseShape);
   };
-  const anticipated = await _asyncNullishCoalesce(await _optionalChain([hooks, 'access', _28 => _28.beforeFetch, 'optionalCall', _29 => _29(scope, options)]), async () => ( null));
+  const anticipated = summaryMode ? null : await _asyncNullishCoalesce(await _optionalChain([hooks, 'access', _30 => _30.beforeFetch, 'optionalCall', _31 => _31(scope, options)]), async () => ( null));
   if (anticipated !== null && anticipated.borderline) {
     const pending = network();
     pending.catch(() => void 0);
@@ -756,18 +797,18 @@ 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', _30 => _30.onAssembled, 'optionalCall', _31 => _31(scope, options, won, startedAt)]);
-      return won;
+      _optionalChain([hooks, 'access', _32 => _32.onAssembled, 'optionalCall', _33 => _33(scope, options, won, startedAt)]);
+      return finish(won);
     }
   }
   if (anticipated !== null) {
-    _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);
+    _optionalChain([hooks, 'access', _34 => _34.onServedFromCache, 'optionalCall', _35 => _35(scope, options, anticipated)]);
+    _optionalChain([hooks, 'access', _36 => _36.onAssembled, 'optionalCall', _37 => _37(scope, options, anticipated.response, startedAt)]);
+    return finish(applyResponseShape(anticipated.response, responseShape));
   }
   const response = await network();
-  _optionalChain([hooks, 'access', _36 => _36.onAssembled, 'optionalCall', _37 => _37(scope, options, response, startedAt)]);
-  return response;
+  _optionalChain([hooks, 'access', _38 => _38.onAssembled, 'optionalCall', _39 => _39(scope, options, response, startedAt)]);
+  return finish(response);
 }
 
 // src/context/normalize.ts
@@ -1169,7 +1210,7 @@ function createMemoriesInterface(transport, onForgotten) {
       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', _38 => _38.deleted_ids, 'optionalAccess', _39 => _39.length]) || _optionalChain([result, 'optionalAccess', _40 => _40.status]) === "deleted" || _optionalChain([result, 'optionalAccess', _41 => _41.status]) === "partial";
+      const removed = !!_optionalChain([result, 'optionalAccess', _40 => _40.deleted_ids, 'optionalAccess', _41 => _41.length]) || _optionalChain([result, 'optionalAccess', _42 => _42.status]) === "deleted" || _optionalChain([result, 'optionalAccess', _43 => _43.status]) === "partial";
       if (removed && onForgotten) {
         try {
           onForgotten({
@@ -1209,14 +1250,14 @@ function sleep2(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
-      _optionalChain([signal, 'optionalAccess', _42 => _42.removeEventListener, 'call', _43 => _43("abort", onAbort)]);
+      _optionalChain([signal, 'optionalAccess', _44 => _44.removeEventListener, 'call', _45 => _45("abort", onAbort)]);
       resolve();
     }, ms);
     function onAbort() {
       clearTimeout(timer);
-      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _44 => _44.reason]), () => ( new Error("Aborted"))));
+      reject(_nullishCoalesce(_optionalChain([signal, 'optionalAccess', _46 => _46.reason]), () => ( new Error("Aborted"))));
     }
-    _optionalChain([signal, 'optionalAccess', _45 => _45.addEventListener, 'call', _46 => _46("abort", onAbort, { once: true })]);
+    _optionalChain([signal, 'optionalAccess', _47 => _47.addEventListener, 'call', _48 => _48("abort", onAbort, { once: true })]);
   });
 }
 
@@ -1389,7 +1430,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', _47 => _47["index"]])));
+  const failed = new Set(errors.map((e) => _optionalChain([e, 'optionalAccess', _49 => _49["index"]])));
   const stored = bodies.filter((_, index) => !failed.has(index));
   if (stored.length !== results.length) return [];
   const pairs = [];
@@ -1402,7 +1443,7 @@ function storedBatchRows(bodies, result) {
 function createConversationNamespace(transport, subscribers = new CompactionSubscribers(), onWrite = () => {
 }, onTurn = () => {
 }, onFetched = () => {
-}, localShortTerm = { prompt: () => null, compacted: () => null }, agentModel = () => ({})) {
+}, localShortTerm = { prompt: () => null, compacted: () => null }, agentModel = () => ({}), fetchHooks = {}) {
   const writesInFlight = /* @__PURE__ */ new Map();
   const withTurnModel = (body, options) => {
     const metadata = withAgentModel(
@@ -1509,7 +1550,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       async fetch(options = {}) {
         const id = _nullishCoalesce(options.conversation_id, () => ( options.conversationId));
         validateConversationId(id);
-        const response = await fetchContext(transport, "conversation", options);
+        const response = await fetchContext(transport, "conversation", options, fetchHooks);
         onFetched(
           response,
           id,
@@ -1535,8 +1576,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
           pathParams: { conversation_id: id },
           query: { style: _nullishCoalesce(options.style, () => ( "structured")) }
         });
-        const response = _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _48 => _48["context_for_prompt"]]), () => ( result)), () => ( {}));
-        _optionalChain([localShortTerm, 'access', _49 => _49.reseed, 'optionalCall', _50 => _50(id, response)]);
+        const response = _nullishCoalesce(_nullishCoalesce(_optionalChain([result, 'optionalAccess', _50 => _50["context_for_prompt"]]), () => ( result)), () => ( {}));
+        _optionalChain([localShortTerm, 'access', _51 => _51.reseed, 'optionalCall', _52 => _52(id, response)]);
         return withHistory(response);
       },
       async compact(options) {
@@ -1729,8 +1770,8 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
   let onConversationState = null;
   const internals = {
     onCompactionUpdate(conversationId, bundle) {
-      _optionalChain([applyCompaction, 'optionalCall', _51 => _51(bundle)]);
-      _optionalChain([dispatchCompaction, 'optionalCall', _52 => _52(conversationId, bundle)]);
+      _optionalChain([applyCompaction, 'optionalCall', _53 => _53(bundle)]);
+      _optionalChain([dispatchCompaction, 'optionalCall', _54 => _54(conversationId, bundle)]);
     },
     setCompactionApplier(apply) {
       applyCompaction = apply;
@@ -1742,10 +1783,10 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       onConversationState = handle;
     },
     sendContextUsed(event) {
-      _optionalChain([client, 'optionalAccess', _53 => _53.sendContextUsed, 'call', _54 => _54(event)]);
+      _optionalChain([client, 'optionalAccess', _55 => _55.sendContextUsed, 'call', _56 => _56(event)]);
     },
     sendContextAssembled(event) {
-      _optionalChain([client, 'optionalAccess', _55 => _55.sendContextAssembled, 'call', _56 => _56(event)]);
+      _optionalChain([client, 'optionalAccess', _57 => _57.sendContextAssembled, 'call', _58 => _58(event)]);
     },
     setCompactionDispatcher(dispatch) {
       dispatchCompaction = dispatch;
@@ -1776,7 +1817,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
         throw new (0, _chunkUXNVTP4Dcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
       }
       try {
-        _optionalChain([onListen, 'optionalCall', _57 => _57()]);
+        _optionalChain([onListen, 'optionalCall', _59 => _59()]);
       } catch (e10) {
       }
       const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-5GYUWETN.cjs")));
@@ -1794,17 +1835,17 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
           internals.onCompactionUpdate(conversationId, bundle);
         },
         onConversationState: (conversationId, messageCount) => {
-          _optionalChain([onConversationState, 'optionalCall', _58 => _58(conversationId, messageCount)]);
+          _optionalChain([onConversationState, 'optionalCall', _60 => _60(conversationId, messageCount)]);
         },
         onStateChange: (state) => {
           if (state !== "connected") openSessions.clear();
           if (state === "reconnecting") {
             reconnectAttempts += 1;
-            _optionalChain([onReconnect, 'optionalCall', _59 => _59(reconnectAttempts)]);
+            _optionalChain([onReconnect, 'optionalCall', _61 => _61(reconnectAttempts)]);
           } else if (state === "disconnected") {
-            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _60 => _60.lastError]), () => ( null));
+            const stopped = _nullishCoalesce(_optionalChain([stream, 'optionalAccess', _62 => _62.lastError]), () => ( null));
             const reason = stopped === null ? "stream disconnected" : `credit_stop:${_nullishCoalesce(stopped.reason, () => ( "unknown"))}`;
-            _optionalChain([onDisconnect, 'optionalCall', _61 => _61(reason)]);
+            _optionalChain([onDisconnect, 'optionalCall', _63 => _63(reason)]);
           }
         }
       });
@@ -1814,7 +1855,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
       } catch (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)))}`,
+          `Could not open the Synap anticipation stream: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _64 => _64.message]), () => ( String(error)))}`,
           { cause: error }
         );
       }
@@ -1860,7 +1901,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
         _nullishCoalesce(_nullishCoalesce(options.customer_id, () => ( options.customerId)), () => ( ""))
       );
       if (eventType === "user_message" || eventType === "assistant_message") {
-        _optionalChain([onTurn, 'optionalCall', _63 => _63({
+        _optionalChain([onTurn, 'optionalCall', _65 => _65({
           conversationId,
           role: _nullishCoalesce(options.role, () => ( "user")),
           content: options.content
@@ -1906,7 +1947,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', _64 => _64({ conversationId, result: options.result, toolName: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")) })]);
+        _optionalChain([onToolResult, 'optionalCall', _66 => _66({ conversationId, result: options.result, toolName: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")) })]);
       }
       await namespace.send_message({
         content: "",
@@ -1958,7 +1999,7 @@ function createInstanceNamespace(credentials, cache, onTurn, agentModel = () =>
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.11";
+var SDK_VERSION = "0.5.13";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2426,7 +2467,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', _65 => _65.#conversations, 'access', _66 => _66.get, 'call', _67 => _67(conversationId), 'optionalAccess', _68 => _68.turns]), () => ( []))).filter((t) => t.role !== "tool").length;
+    return (_nullishCoalesce(_optionalChain([this, 'access', _67 => _67.#conversations, 'access', _68 => _68.get, 'call', _69 => _69(conversationId), 'optionalAccess', _70 => _70.turns]), () => ( []))).filter((t) => t.role !== "tool").length;
   }
   sizeBytes() {
     let n2 = 0;
@@ -2605,7 +2646,7 @@ function askedKinds(query) {
 }
 function asksHowItStarted(query) {
   const spec = _chunkICUFS3B5cjs.HISTORY_SEARCH.early_query;
-  if (!_optionalChain([spec, 'optionalAccess', _69 => _69.pattern])) return false;
+  if (!_optionalChain([spec, 'optionalAccess', _71 => _71.pattern])) return false;
   return new RegExp(spec.pattern, (_nullishCoalesce(spec.flags, () => ( ""))).includes("i") ? "i" : "").test(_nullishCoalesce(query, () => ( "")));
 }
 async function searchTurns(turns, query, options = {}) {
@@ -3776,6 +3817,29 @@ var SynapClient = (_class4 = class _SynapClient {
       },
       onServedFromCache: (_scope, options2, served) => {
         this.#emitContextUsed(options2, _scope, served);
+      },
+      // The periodic user-summary splice, as Python runs it at the end of the
+      // user, customer and client fetches (the conversation fetch does its own
+      // through `onFetched`). Until 0.5.12 only the conversation fetch had it,
+      // so the same usage gave the model different context in JS.
+      // Python's `_should_skip_server_st`: when this process already holds the
+      // conversation's compaction and every turn after it, the server is told
+      // not to assemble them again.
+      skipServerShortTerm: (conversationId) => {
+        if (!this.#isStAuthoritative()) return false;
+        const entry = this.#shortTerm.get(conversationId);
+        return entry !== null && entry.compactionId !== null && isComplete(entry);
+      },
+      onResponse: (scope, options2, response) => {
+        if (scope === "conversation") return;
+        const o2 = options2;
+        const owner = scope === "user" ? _nullishCoalesce(o2["user_id"], () => ( o2["userId"])) : scope === "customer" ? _nullishCoalesce(o2["customer_id"], () => ( o2["customerId"])) : "_client";
+        this.#injectUserSummary(
+          response,
+          _nullishCoalesce(o2["conversation_id"], () => ( o2["conversationId"])),
+          owner,
+          _chunkICUFS3B5cjs.rungKey.call(void 0, _nullishCoalesce(o2["scope_path"], () => ( o2["scopePath"])))
+        );
       }
     };
     this.user = createUserNamespace(this.#transport, this.#fetchHooks);
@@ -3795,7 +3859,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', _70 => _70.#localEncoder, 'optionalAccess', _71 => _71.model]) === _chunkICUFS3B5cjs.SEMANTIC_MATCH.model) this.#anticipationCache.setEncoder(this.#localEncoder);
+    if (_optionalChain([this, 'access', _72 => _72.#localEncoder, 'optionalAccess', _73 => _73.model]) === _chunkICUFS3B5cjs.SEMANTIC_MATCH.model) this.#anticipationCache.setEncoder(this.#localEncoder);
     this.#turns = new TurnCounter();
     this.conversation = createConversationNamespace(
       this.#transport,
@@ -3829,7 +3893,12 @@ var SynapClient = (_class4 = class _SynapClient {
         reseed: (conversationId, response) => this.#reseedShortTerm(conversationId, response),
         historyExcerpts: (conversationId, response, query) => this.#withHistoryExcerpts(conversationId, response, query)
       },
-      () => this.#agentModel
+      () => this.#agentModel,
+      // The same hooks as the other three scopes: the anticipation cache first,
+      // as Python's conversation fetch does, and the audit events. Until 0.5.13
+      // the conversation fetch was built without them, so every JS conversation
+      // fetch was a billed round trip, including ones the stream had answered.
+      this.#fetchHooks
     );
     this.memories = createMemoriesInterface(this.#transport, ({ userId, customerId }) => {
       for (const id of /* @__PURE__ */ new Set([userId, customerId])) {
@@ -4286,14 +4355,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', _72 => _72.serverMessageCount]), () => ( 0))) || 0);
+    const total = Math.max(Number(_nullishCoalesce(r["total_message_count"], () => ( 0))) || 0, Number(_nullishCoalesce(_optionalChain([entry, 'optionalAccess', _74 => _74.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', _73 => _73.reverse, 'call', _74 => _74(), 'access', _75 => _75.find, 'call', _76 => _76((t) => t.role === "user"), 'optionalAccess', _77 => _77.content]), () => ( ""));
+      q = latest ? String(_nullishCoalesce(latest["content"], () => ( ""))) : _nullishCoalesce(_optionalChain([[...turns], 'access', _75 => _75.reverse, 'call', _76 => _76(), 'access', _77 => _77.find, 'call', _78 => _78((t) => t.role === "user"), 'optionalAccess', _79 => _79.content]), () => ( ""));
     }
     if (!q) return response;
     const exclude = /* @__PURE__ */ new Set();
@@ -4437,13 +4506,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', _78 => _78.trim, 'call', _79 => _79()]);
+  const fromEnv = _optionalChain([_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_BASE_URL"), 'optionalAccess', _80 => _80.trim, 'call', _81 => _81()]);
   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, _chunkUXNVTP4Dcjs.InvalidInputError)(
+    throw new (0, _chunkUXNVTP4Dcjs.AuthenticationError)(
       "No Synap API key found. Set SYNAP_API_KEY in your environment, or pass apiKey to the SynapClient constructor."
     );
   }