@maximem/synap-js-sdk 0.4.3 → 0.4.5

package/dist/index.cjs

@@ -22,7 +22,7 @@
 
 
 
-var _chunkHR5Y3KXScjs = require('./chunk-HR5Y3KXS.cjs');
+var _chunk2TVL5IPQcjs = require('./chunk-2TVL5IPQ.cjs');
 
 
 
@@ -113,7 +113,7 @@ function shouldRetry(input) {
   if (attempt >= policy.maxAttempts) {
     return { retry: false, delaySeconds: 0, reason: "max_attempts_exhausted" };
   }
-  if (!_chunkHR5Y3KXScjs.isSynapError.call(void 0, error) || !error.transient) {
+  if (!_chunk2TVL5IPQcjs.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())));
@@ -131,7 +131,7 @@ function shouldRetry(input) {
   };
 }
 function backoffDelay(error, attempt, policy) {
-  if (error instanceof _chunkHR5Y3KXScjs.RateLimitError && error.retryAfterSeconds != null) {
+  if (error instanceof _chunk2TVL5IPQcjs.RateLimitError && error.retryAfterSeconds != null) {
     return Math.min(error.retryAfterSeconds, policy.backoffMax);
   }
   const exponential = policy.backoffBase * 2 ** (attempt - 1);
@@ -205,14 +205,19 @@ 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, _chunkHR5Y3KXScjs.InvalidInputError)(
+  throw new (0, _chunk2TVL5IPQcjs.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)}.`
   );
 }
 
 // src/transport/http.ts
 var DEFAULT_BASE_URL = "https://synap-cloud-prod.maximem.ai";
-var DEFAULT_TIMEOUTS = { connect: 5, read: 30, write: 10 };
+var DEFAULT_TIMEOUTS = {
+  connect: 5,
+  read: 30,
+  write: 10,
+  streamIdle: 60
+};
 var HttpTransport = (_class2 = class {
   
   // Mutable so `configure()` can adjust them before the first request, and so
@@ -229,7 +234,7 @@ var HttpTransport = (_class2 = class {
     this.#credentials = options.credentials;
     this.baseUrl = (_nullishCoalesce(options.baseUrl, () => ( DEFAULT_BASE_URL))).replace(/\/+$/, "");
     this.timeouts = { ...DEFAULT_TIMEOUTS, ...options.timeouts };
-    this.retryPolicy = { ...DEFAULT_RETRY_POLICY, ...options.retryPolicy };
+    this.retryPolicy = options.retryPolicy === null ? { ...DEFAULT_RETRY_POLICY, maxAttempts: 1 } : { ...DEFAULT_RETRY_POLICY, ...options.retryPolicy };
     this.userAgent = _nullishCoalesce(options.userAgent, () => ( "@maximem/synap-js-sdk"));
     this.fetchImpl = _nullishCoalesce(options.fetchImpl, () => ( globalThis.fetch.bind(globalThis)));
     this.keepAliveOptions = _nullishCoalesce(options.keepAlive, () => ( {}));
@@ -285,9 +290,16 @@ var HttpTransport = (_class2 = class {
   setTimeouts(timeouts) {
     this.timeouts = { ...this.timeouts, ...timeouts };
   }
-  /** `null` restores the default policy, matching Python's `retry_policy=None`. */
+  /**
+   * `null` DISABLES retries, matching Python.
+   *
+   * Python's `SDKConfig(retry_policy=None)` leaves `self.retry_policy` unset and
+   * `max_attempts` falls to 1 (http_client.py:180). We restored the default
+   * policy instead, so a caller following the "Disabling Retries" documentation
+   * got three attempts and no way to turn them off.
+   */
   setRetryPolicy(policy) {
-    this.retryPolicy = policy === null ? { ...DEFAULT_RETRY_POLICY } : { ...this.retryPolicy, ...policy };
+    this.retryPolicy = policy === null ? { ...DEFAULT_RETRY_POLICY, maxAttempts: 1 } : { ...this.retryPolicy, ...policy };
   }
   close() {
     this.closed = true;
@@ -317,7 +329,7 @@ var HttpTransport = (_class2 = class {
         await sleep(decision.delaySeconds * 1e3, options.signal);
       }
     }
-    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _10 => _10.error]), () => ( new (0, _chunkHR5Y3KXScjs.SynapError)("Request failed with no recorded error")));
+    throw _nullishCoalesce(_optionalChain([last, 'optionalAccess', _10 => _10.error]), () => ( new (0, _chunk2TVL5IPQcjs.SynapError)("Request failed with no recorded error")));
   }
   async attempt(name, options, correlationId) {
     const spec = ENDPOINTS[name];
@@ -350,7 +362,7 @@ var HttpTransport = (_class2 = class {
     try {
       return JSON.parse(text);
     } catch (e3) {
-      throw new (0, _chunkHR5Y3KXScjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
+      throw new (0, _chunk2TVL5IPQcjs.SynapError)(`Malformed JSON in response from ${url}`, { correlationId });
     }
   }
   buildUrl(path, query) {
@@ -384,14 +396,14 @@ var HttpTransport = (_class2 = class {
   }
 }, _class2);
 function isOutcomeUnknown(error) {
-  if (error instanceof _chunkHR5Y3KXScjs.RateLimitError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.ServiceUnavailableError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.AuthenticationError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.InvalidInputError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.ConflictError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.InsufficientCreditsError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.ContextNotFoundError) return false;
-  if (error instanceof _chunkHR5Y3KXScjs.NetworkTimeoutError) return true;
+  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 (isConnectionRefusal(error)) return false;
   return true;
 }
@@ -400,12 +412,12 @@ function isConnectionRefusal(error) {
   return code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "EAI_AGAIN" || code === "ECONNRESET" || code === "EHOSTUNREACH";
 }
 function toTransportError(error, correlationId) {
-  if (error instanceof _chunkHR5Y3KXScjs.SynapError) return error;
+  if (error instanceof _chunk2TVL5IPQcjs.SynapError) return error;
   const name = _optionalChain([error, 'optionalAccess', _14 => _14.name]);
   if (name === "AbortError" || name === "TimeoutError") {
-    return new (0, _chunkHR5Y3KXScjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
+    return new (0, _chunk2TVL5IPQcjs.NetworkTimeoutError)("Request timed out", { correlationId, cause: error });
   }
-  return new (0, _chunkHR5Y3KXScjs.ServiceUnavailableError)(
+  return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(
     `Network request failed: ${_nullishCoalesce(_optionalChain([error, 'optionalAccess', _15 => _15.message]), () => ( String(error)))}`,
     { correlationId, cause: error }
   );
@@ -425,48 +437,53 @@ async function toHttpError(response, correlationId) {
   switch (response.status) {
     case 400:
     case 422:
-      return new (0, _chunkHR5Y3KXScjs.InvalidInputError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.InvalidInputError)(message, opts);
     case 401:
     case 403:
-      return new (0, _chunkHR5Y3KXScjs.AuthenticationError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.AuthenticationError)(message, opts);
     case 404:
-      return new (0, _chunkHR5Y3KXScjs.ContextNotFoundError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.ContextNotFoundError)(message, opts);
     case 402:
-      return new (0, _chunkHR5Y3KXScjs.InsufficientCreditsError)(message, {
+      return new (0, _chunk2TVL5IPQcjs.InsufficientCreditsError)(message, {
         ...opts,
         balanceCredits: numberOrNull(parsed["balance_credits"]),
-        requiredCredits: numberOrNull(parsed["required_credits"])
+        requiredCredits: _nullishCoalesce(numberOrNull(parsed["minimum_required_credits"]), () => ( numberOrNull(parsed["required_credits"]))),
+        recoveryUrl: stringOrNull(parsed["recovery_url"]),
+        redeemUrl: stringOrNull(parsed["redeem_url"])
       });
     case 409:
       if (detailObject !== null && detailObject["code"] === "transcript_conflict") {
-        return new (0, _chunkHR5Y3KXScjs.TranscriptConflictError)(message, opts);
+        return new (0, _chunk2TVL5IPQcjs.TranscriptConflictError)(message, opts);
       }
-      return new (0, _chunkHR5Y3KXScjs.ConflictError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.ConflictError)(message, opts);
     case 429: {
       const header = response.headers.get("retry-after");
       const retryAfter = header !== null && header.trim() !== "" ? Number(header) : null;
-      return new (0, _chunkHR5Y3KXScjs.RateLimitError)(message, {
+      return new (0, _chunk2TVL5IPQcjs.RateLimitError)(message, {
         ...opts,
         retryAfterSeconds: retryAfter !== null && Number.isFinite(retryAfter) ? retryAfter : null
       });
     }
     case 503:
-      return new (0, _chunkHR5Y3KXScjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(message, opts);
     case 504:
-      return new (0, _chunkHR5Y3KXScjs.AgentUnavailableError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.AgentUnavailableError)(message, opts);
     default:
-      if (response.status >= 500) return new (0, _chunkHR5Y3KXScjs.ServiceUnavailableError)(message, opts);
-      return new (0, _chunkHR5Y3KXScjs.SynapError)(message, opts);
+      if (response.status >= 500) return new (0, _chunk2TVL5IPQcjs.ServiceUnavailableError)(message, opts);
+      return new (0, _chunk2TVL5IPQcjs.SynapError)(message, opts);
   }
 }
 function numberOrNull(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : null;
 }
+function stringOrNull(v) {
+  return typeof v === "string" && v !== "" ? v : null;
+}
 function withTimeout(ms, external) {
   const controller = new AbortController();
   const onExternalAbort = () => controller.abort(_optionalChain([external, 'optionalAccess', _16 => _16.reason]));
   const timer = setTimeout(() => {
-    controller.abort(new (0, _chunkHR5Y3KXScjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
+    controller.abort(new (0, _chunk2TVL5IPQcjs.NetworkTimeoutError)(`Timed out after ${ms}ms`));
   }, ms);
   _optionalChain([timer, 'access', _17 => _17.unref, 'optionalCall', _18 => _18()]);
   if (external) {
@@ -518,10 +535,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, _chunkHR5Y3KXScjs.InvalidInputError)("search_query must be an array when provided");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("search_query must be an array when provided");
   }
   if (options.types !== void 0 && !Array.isArray(options.types)) {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("types must be an array when provided");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("types must be an array when provided");
   }
   const body = {
     conversation_id: _nullishCoalesce(conversationId, () => ( null)),
@@ -536,16 +553,39 @@ function buildFetchRequest(scope, options) {
   }
   switch (scope) {
     case "user":
-      if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
-      body["user_id"] = userId;
-      if (customerId !== void 0) body["customer_id"] = customerId;
+      {
+        if (!userId) throw new (0, _chunk2TVL5IPQcjs.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)(
+            `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");
+        }
+        if (lastN < 0 || lastN > 20) {
+          throw new (0, _chunk2TVL5IPQcjs.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));
+          body["last_n_conversations"] = lastN;
+        }
+        if (customerId !== void 0) body["customer_id"] = customerId;
+        break;
+      }
       break;
     case "customer":
-      if (!customerId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("customer_id is required");
       body["customer_id"] = customerId;
       break;
     case "conversation":
-      if (!conversationId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
+      if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
       if (userId !== void 0) body["user_id"] = userId;
       if (customerId !== void 0) body["customer_id"] = customerId;
       break;
@@ -554,6 +594,7 @@ function buildFetchRequest(scope, options) {
   }
   return { endpoint: ENDPOINT_BY_SCOPE[scope], body };
 }
+var VALID_CONTEXT_MODES = ["in-conversation", "conversation-summary"];
 async function fetchContext(transport, scope, options = {}, hooks = {}) {
   const startedAt = Date.now();
   transport.checkCustomerId(
@@ -789,17 +830,17 @@ function isoOrNull(v) {
   return v instanceof Date ? v.toISOString() : v;
 }
 function buildCreateBody(options) {
-  if (!options.document) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("document is required");
+  if (!options.document) throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInputError)(
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
       `Invalid document_type '${documentType}'. Expected one of: ${DOCUMENT_TYPES.join(", ")}`
     );
   }
   if (!INGEST_MODES.includes(mode)) {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)(
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
       `Invalid mode '${mode}'. Expected one of: ${INGEST_MODES.join(", ")}`
     );
   }
@@ -827,7 +868,7 @@ function createMemoriesInterface(transport) {
     async batch_create(options) {
       const docs = options.documents;
       if (!Array.isArray(docs) || docs.length === 0) {
-        throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("documents must be a non-empty array");
+        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("documents must be a non-empty array");
       }
       const failFast = _nullishCoalesce(_nullishCoalesce(options.fail_fast, () => ( options.failFast)), () => ( false));
       return transport.request("memories_batch", {
@@ -837,15 +878,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, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInputError)("One of file_path, file, or text must be provided.");
+        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("One of file_path, file, or text must be provided.");
       }
       if (sources.length > 1) {
-        throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)(
+        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
           "Provide exactly one of file_path, file, or text, not several."
         );
       }
@@ -876,13 +917,13 @@ function createMemoriesInterface(transport) {
       });
     },
     async get(memoryId) {
-      if (!memoryId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("memory_id is required");
+      if (!memoryId) throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInputError)("memory_id is required");
-      if (!options.document) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("document is required");
+      if (!memoryId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("memory_id is required");
+      if (!options.document) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("document is required");
       const body = {
         document: options.document,
         merge_strategy: _nullishCoalesce(_nullishCoalesce(options.merge_strategy, () => ( options.mergeStrategy)), () => ( "smart-merge"))
@@ -897,20 +938,20 @@ function createMemoriesInterface(transport) {
     },
     async delete(memoryId) {
       if (!memoryId) {
-        throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)(
+        throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInputError)("ingestion_id is required");
+      if (!ingestionId) throw new (0, _chunk2TVL5IPQcjs.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;
@@ -948,17 +989,26 @@ 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, _chunkHR5Y3KXScjs.InvalidConversationIdError)(`Invalid conversation ID: ${String(conversationId)}`);
+    throw new (0, _chunk2TVL5IPQcjs.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, _chunkHR5Y3KXScjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInstanceIdError)(`Invalid instance ID: ${String(instanceId)}`);
   }
 }
 
 // src/conversation/interface.ts
+var COMPACTION_LEVELS = [
+  "low",
+  "medium",
+  "high",
+  "adaptive",
+  "aggressive",
+  "balanced",
+  "conservative"
+];
 function either2(o2, snake, camel) {
   const a = o2[snake];
   if (a !== void 0) return a;
@@ -974,13 +1024,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, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
   validateConversationId(conversationId);
-  if (!options.role) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("role is required");
+  if (!options.role) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("role is required");
   if (options.content === void 0 || options.content === null) {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("content is required");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("content is required");
   }
-  if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+  if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
   const body = {
     conversation_id: conversationId,
     role: options.role,
@@ -998,10 +1048,10 @@ function buildIngestTranscriptBody(options) {
   const o2 = options;
   const conversationId = either2(o2, "conversation_id", "conversationId");
   const userId = either2(o2, "user_id", "userId");
-  if (!conversationId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
-  if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+  if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+  if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
   if (options.transcript === void 0 || options.transcript === null) {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("transcript is required");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("transcript is required");
   }
   const body = {
     conversation_id: conversationId,
@@ -1023,7 +1073,7 @@ function buildIngestTranscriptBody(options) {
 function buildCompactBody(options) {
   const o2 = options;
   const conversationId = either2(o2, "conversation_id", "conversationId");
-  if (!conversationId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
+  if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.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")));
@@ -1076,10 +1126,10 @@ var CompactionSubscribers = class {
 function createConversationNamespace(transport, subscribers = new CompactionSubscribers(), onWrite = () => {
 }, onTurn = () => {
 }, onFetched = () => {
-}) {
+}, localShortTerm = { prompt: () => null, compacted: () => null }) {
   const convId = (v) => {
     const id = typeof v === "string" ? v : _nullishCoalesce(v.conversation_id, () => ( v.conversationId));
-    if (!id) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
+    if (!id) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
     validateConversationId(id);
     return id;
   };
@@ -1105,7 +1155,7 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
     },
     async record_messages_batch(messages) {
       if (!Array.isArray(messages) || messages.length === 0) {
-        throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("messages must be a non-empty array");
+        throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("messages must be a non-empty array");
       }
       for (const m of messages) {
         const mo = m;
@@ -1157,6 +1207,8 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       },
       get_context_for_prompt: async (options = {}) => {
         const id = convId(options);
+        const local = localShortTerm.prompt(id, _nullishCoalesce(options.style, () => ( "structured")));
+        if (local !== null) return local;
         const result = await transport.request("context_for_prompt", {
           pathParams: { conversation_id: id },
           query: { style: _nullishCoalesce(options.style, () => ( "structured")) }
@@ -1168,6 +1220,10 @@ function createConversationNamespace(transport, subscribers = new CompactionSubs
       },
       get_compacted: async (options) => {
         const id = convId(options);
+        if (options.version === void 0) {
+          const local = localShortTerm.compacted(id, _nullishCoalesce(options.format, () => ( "structured")));
+          if (local !== null) return local;
+        }
         const query = { format: _nullishCoalesce(options.format, () => ( "structured")) };
         if (options.version !== void 0) query["version"] = options.version;
         try {
@@ -1196,8 +1252,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, _chunkHR5Y3KXScjs.InvalidInputError)("conversation_id is required");
-        if (typeof callback !== "function") throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("callback is required");
+        if (!conversationId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("conversation_id is required");
+        if (typeof callback !== "function") throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("callback is required");
         return subscribers.add(conversationId, callback);
       },
       /** Remove subscribers for one conversation, or all of them. Returns the count removed. */
@@ -1213,7 +1269,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, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunk2TVL5IPQcjs.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 },
@@ -1229,15 +1285,26 @@ function createUserNamespace(transport, hooks = {}) {
 }
 
 // src/credits/interface.ts
+function iso2(v) {
+  return v instanceof Date ? v.toISOString() : v;
+}
 function createCreditsNamespace(transport) {
   return {
     async get_balance() {
       return transport.request("credits_balance");
     },
     async get_ledger(options = {}) {
-      return transport.request("credits_ledger", {
-        query: { limit: _nullishCoalesce(options.limit, () => ( 50)), offset: _nullishCoalesce(options.offset, () => ( 0)) }
-      });
+      const query = {
+        limit: _nullishCoalesce(options.limit, () => ( 100)),
+        offset: _nullishCoalesce(options.offset, () => ( 0))
+      };
+      const entryType = _nullishCoalesce(options.entry_type, () => ( options.entryType));
+      if (entryType !== void 0) query["entry_type"] = entryType;
+      const from = _nullishCoalesce(options.from_time, () => ( options.fromTime));
+      if (from !== void 0) query["from"] = iso2(from);
+      const to = _nullishCoalesce(options.to_time, () => ( options.toTime));
+      if (to !== void 0) query["to"] = iso2(to);
+      return transport.request("credits_ledger", { query });
     },
     async estimate(options) {
       return transport.request("credits_estimate", {
@@ -1251,7 +1318,7 @@ function createCreditsNamespace(transport) {
       });
     },
     async redeem(code) {
-      if (!code) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("code is required");
+      if (!code) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("code is required");
       return transport.request("credits_redeem", { body: { code } });
     }
   };
@@ -1262,11 +1329,11 @@ function createCacheNamespace(cache) {
   return {
     clear: () => cache.clear(),
     clear_user: (userId) => {
-      if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+      if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
       cache.dropEntity(userId);
     },
     clear_customer: (customerId) => {
-      if (!customerId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("customer_id is required");
+      if (!customerId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("customer_id is required");
       cache.dropEntity(customerId);
     },
     stats: () => ({ bundles: cache.size, items: cache.itemCount })
@@ -1287,6 +1354,18 @@ function envTls() {
   if (raw === void 0 || raw === "") return void 0;
   return !["0", "false", "no", "off"].includes(raw.trim().toLowerCase());
 }
+function thinkingMetadata(options) {
+  const md = { ..._nullishCoalesce(options.metadata, () => ( {})) };
+  const step = _nullishCoalesce(options.step_index, () => ( options.stepIndex));
+  if (step !== void 0 && md["step_index"] === void 0) {
+    md["step_index"] = String(step);
+  }
+  const kind = _nullishCoalesce(options.thought_type, () => ( options.thoughtType));
+  if (kind && md["thought_type"] === void 0) {
+    md["thought_type"] = kind;
+  }
+  return md;
+}
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
   let dispatchCompaction = null;
@@ -1315,9 +1394,9 @@ function createInstanceNamespace(credentials, cache, onTurn) {
   const namespace = {
     async listen(options = {}) {
       if (client !== null) {
-        throw new (0, _chunkHR5Y3KXScjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
+        throw new (0, _chunk2TVL5IPQcjs.ListeningAlreadyActiveError)("Listening is already active on this instance");
       }
-      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-ZN6ADZBR.cjs")));
+      const { GrpcStreamClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./stream-client-PRTOH62B.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));
@@ -1342,8 +1421,8 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       try {
         await created.connect();
       } catch (error) {
-        if (error instanceof _chunkHR5Y3KXScjs.SynapError) throw error;
-        throw new (0, _chunkHR5Y3KXScjs.SynapError)(
+        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)))}`,
           { cause: error }
         );
@@ -1357,9 +1436,9 @@ function createInstanceNamespace(credentials, cache, onTurn) {
       await active.disconnect();
     },
     async send_message(options) {
-      if (client === null) throw new (0, _chunkHR5Y3KXScjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("Listening is not active");
       if (options.content === void 0) {
-        throw new (0, _chunkHR5Y3KXScjs.ListeningNotActiveError)("content is required");
+        throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("content is required");
       }
       const conversationId = _nullishCoalesce(_nullishCoalesce(options.conversation_id, () => ( options.conversationId)), () => ( ""));
       _optionalChain([onTurn, 'optionalCall', _50 => _50({
@@ -1377,12 +1456,18 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         session_id: _nullishCoalesce(_nullishCoalesce(options.session_id, () => ( options.sessionId)), () => ( "")),
         metadata: _nullishCoalesce(options.metadata, () => ( {})),
         timestamp_ms: Date.now(),
+        tool_name: _nullishCoalesce(_nullishCoalesce(options.tool_name, () => ( options.toolName)), () => ( "")),
+        // Python serialises tool_args with json.dumps into tool_args_json.
+        tool_args_json: (() => {
+          const a = _nullishCoalesce(options.tool_args, () => ( options.toolArgs));
+          return a === void 0 ? "" : JSON.stringify(a);
+        })(),
         search_queries: _nullishCoalesce(_nullishCoalesce(options.search_queries, () => ( options.searchQueries)), () => ( [])),
         context_types: _nullishCoalesce(_nullishCoalesce(options.context_types, () => ( options.contextTypes)), () => ( []))
       });
     },
     async record_thinking(options) {
-      if (client === null) throw new (0, _chunkHR5Y3KXScjs.ListeningNotActiveError)("Listening is not active");
+      if (client === null) throw new (0, _chunk2TVL5IPQcjs.ListeningNotActiveError)("Listening is not active");
       client.sendConversationEvent({
         // Python emits reasoning as an `agent_thinking` conversation event.
         event_type: "agent_thinking",
@@ -1392,7 +1477,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         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, () => ( {})),
+        metadata: thinkingMetadata(options),
         timestamp_ms: Date.now()
       });
     },
@@ -1575,11 +1660,11 @@ var ShortTermStore = class {
 // src/context/overlay.ts
 var MAX_TURNS = 20;
 var TOKEN_BUDGET = 2e3;
-function verbatimOverlayEnabled() {
+function verbatimOverlayEnabled(configured) {
   const raw = (_nullishCoalesce(_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_ST_VERBATIM_OVERLAY"), () => ( ""))).trim().toLowerCase();
   if (["0", "false", "no", "off"].includes(raw)) return false;
   if (["1", "true", "yes", "on"].includes(raw)) return true;
-  return true;
+  return _nullishCoalesce(configured, () => ( true));
 }
 function estimateTokens(turn) {
   return Math.max(1, Math.floor(String(_nullishCoalesce(turn.content, () => ( ""))).length / 4));
@@ -1593,13 +1678,13 @@ function budgetRecentTurns(turns) {
   }
   return windowed;
 }
-function overlayLocalRecentTurns(response, store, conversationId) {
+function overlayLocalRecentTurns(response, store, conversationId, configured) {
   if (conversationId === void 0 || conversationId === "") return;
   try {
     const entry = store.get(conversationId);
     if (entry === null) return;
     const existing = _nullishCoalesce(response.conversation_context, () => ( null));
-    if (existing !== null && !verbatimOverlayEnabled()) return;
+    if (existing !== null && !verbatimOverlayEnabled(configured)) return;
     const localTurns = budgetRecentTurns(entry.recentTurns);
     const serverField = (name) => existing === null ? void 0 : existing[name];
     const orLocal = (name, local) => {
@@ -1621,6 +1706,158 @@ function overlayLocalRecentTurns(response, store, conversationId) {
   }
 }
 
+// src/context/local-prompt.ts
+var SUPPORTED_STYLES = ["structured", "narrative", "bullet_points"];
+var DEFAULT_STYLE = "structured";
+function stringify(value) {
+  if (value === null || value === void 0) return "";
+  const t = typeof value;
+  if (t === "string" || t === "number" || t === "boolean") return String(value);
+  try {
+    return _nullishCoalesce(JSON.stringify(value), () => ( ""));
+  } catch (e6) {
+    return String(value);
+  }
+}
+function asListOfObjects(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) {
+    const out = [];
+    for (const v of value) {
+      if (v && typeof v === "object" && !Array.isArray(v)) out.push(v);
+      else if (typeof v === "string") out.push({ content: v });
+    }
+    return out;
+  }
+  if (typeof value === "object") return [value];
+  return [];
+}
+function itemText(item) {
+  return item["content"] || item["text"] || stringify(item);
+}
+function buildRecentMessages(turns) {
+  return (_nullishCoalesce(turns, () => ( []))).map((t, idx) => ({
+    role: t.role || "user",
+    content: _nullishCoalesce(t.content, () => ( "")),
+    timestamp: t.timestamp,
+    message_id: `local-${idx}`
+  }));
+}
+function compactedMessageCount(_entry) {
+  return 0;
+}
+function formatStructured(entry, recent) {
+  const parts = [];
+  if (entry.summary) {
+    parts.push("## Summary");
+    parts.push(entry.summary.trim());
+  }
+  if (entry.factualParagraph) {
+    parts.push("## Facts");
+    parts.push(entry.factualParagraph.trim());
+  }
+  if (entry.conversationalParagraph) {
+    parts.push("## Conversation");
+    parts.push(entry.conversationalParagraph.trim());
+  }
+  const cs = _nullishCoalesce(entry.currentState, () => ( {}));
+  if (Object.keys(cs).length > 0) {
+    parts.push("## Current State");
+    for (const [k, v] of Object.entries(cs)) parts.push(`- ${k}: ${stringify(v)}`);
+  }
+  const ke = _nullishCoalesce(entry.keyExtractions, () => ( {}));
+  if (Object.keys(ke).length > 0) {
+    parts.push("## Key Extractions");
+    for (const [cat, items] of Object.entries(ke)) {
+      if (!items) continue;
+      parts.push(`### ${cat}`);
+      for (const it of asListOfObjects(items)) parts.push(`- ${itemText(it)}`);
+    }
+  }
+  if (recent.length > 0) {
+    parts.push(`## Recent Turns (${recent.length})`);
+    for (const m of recent) parts.push(`**${m.role}**: ${m.content}`);
+  }
+  return parts.filter(Boolean).join("\n\n").trim();
+}
+function formatNarrative(entry, recent) {
+  const parts = [];
+  if (entry.summary) parts.push(entry.summary.trim());
+  if (entry.conversationalParagraph) parts.push(entry.conversationalParagraph.trim());
+  else if (entry.factualParagraph) parts.push(entry.factualParagraph.trim());
+  if (recent.length > 0) {
+    const tail = recent.map((m) => `${m.role}: ${m.content}`).join("\n");
+    parts.push(`Recent exchanges:
+${tail}`);
+  }
+  return parts.filter(Boolean).join("\n\n").trim();
+}
+function formatBullets(entry, recent) {
+  const parts = [];
+  if (entry.summary) parts.push(`- Summary: ${entry.summary.trim()}`);
+  for (const [k, v] of Object.entries(_nullishCoalesce(entry.currentState, () => ( {})))) {
+    parts.push(`- ${k}: ${stringify(v)}`);
+  }
+  for (const [cat, items] of Object.entries(_nullishCoalesce(entry.keyExtractions, () => ( {})))) {
+    for (const it of asListOfObjects(items)) parts.push(`- (${cat}) ${itemText(it)}`);
+  }
+  for (const m of recent) parts.push(`- ${m.role}: ${m.content}`);
+  return parts.join("\n").trim();
+}
+function formatBlock(entry, recent, style) {
+  if (style === "narrative") return formatNarrative(entry, recent);
+  if (style === "bullet_points") return formatBullets(entry, recent);
+  return formatStructured(entry, recent);
+}
+function renderForPrompt(entry, style = DEFAULT_STYLE, now = Date.now) {
+  const chosen = SUPPORTED_STYLES.includes(style) ? style : DEFAULT_STYLE;
+  const recent = buildRecentMessages(entry.recentTurns);
+  const formatted = formatBlock(entry, recent, chosen);
+  const available = entry.compactionId !== null || entry.recentTurns.length > 0;
+  let compactionAge = null;
+  if (entry.compactedAt !== null) {
+    const parsed = Date.parse(entry.compactedAt);
+    if (!Number.isNaN(parsed)) compactionAge = Math.floor((now() - parsed) / 1e3);
+  }
+  const compacted = compactedMessageCount(entry);
+  return {
+    formatted_context: available ? formatted : null,
+    available,
+    is_stale: false,
+    compression_ratio: null,
+    validation_score: null,
+    compaction_age_seconds: compactionAge,
+    quality_warning: false,
+    recent_messages: recent,
+    recent_message_count: recent.length,
+    compacted_message_count: compacted,
+    total_message_count: recent.length + compacted
+  };
+}
+function renderCompacted(entry, format = "structured", correlationId = "") {
+  if (entry.compactionId === null) return null;
+  const formatted = formatBlock(
+    entry,
+    buildRecentMessages(entry.recentTurns),
+    format === "narrative" ? "narrative" : "structured"
+  );
+  return {
+    compacted_context: formatted,
+    compaction_id: entry.compactionId,
+    compacted_at: entry.compactedAt,
+    conversation_id: entry.conversationId,
+    current_state: entry.currentState,
+    correlation_id: correlationId,
+    original_token_count: null,
+    compacted_token_count: null,
+    compression_ratio: null,
+    level_applied: null,
+    validation_score: null,
+    validation_passed: null,
+    quality_warning: false
+  };
+}
+
 // src/context/user-summary.ts
 var USER_SUMMARY_INTERVAL = 5;
 var MAX_SUMMARY_ITEMS = 3;
@@ -1751,7 +1988,7 @@ function tryServeFromCache(cache, scope, params, maxItems) {
     });
     if (hit === null) return { response: null, hit: null };
     return { response: buildAnticipationResponse(hit), hit };
-  } catch (e6) {
+  } catch (e7) {
     return { response: null, hit: null };
   }
 }
@@ -2146,7 +2383,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, _chunkHR5Y3KXScjs.InvalidInputError)(
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
       `scope must be one of ['${sorted.join("', '")}'], got '${String(options.scope)}'`
     );
   }
@@ -2154,10 +2391,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, _chunkHR5Y3KXScjs.InvalidInputError)("scope='user' requires user_id");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("scope='user' requires user_id");
   }
   if (scope === "customer" && (customerId === void 0 || customerId === "")) {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("scope='customer' requires customer_id");
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("scope='customer' requires customer_id");
   }
   if (scope === "conversation" && (userId === void 0 || userId === "")) {
     onWarning(
@@ -2166,7 +2403,7 @@ function buildTool(target, options = {}, onWarning = () => {
   }
   const style = String(_nullishCoalesce(options.style, () => ( "openai")));
   if (style !== "openai" && style !== "anthropic") {
-    throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)(`style must be 'openai' or 'anthropic', got '${style}'`);
+    throw new (0, _chunk2TVL5IPQcjs.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)));
@@ -2209,6 +2446,9 @@ var SynapClient = class {
   #registryKeys;
   #compactionSubscribers;
   #shortTerm;
+  #stVerbatimOverlay;
+  #logger;
+  #stAuthoritative;
   #turns;
   #fetchHooks;
   constructor(options = {}) {
@@ -2279,6 +2519,9 @@ var SynapClient = class {
     this.client = { context: { fetch: async (o2 = {}) => fetchContext(this.#transport, "client", o2, this.#fetchHooks) } };
     this.#compactionSubscribers = new CompactionSubscribers();
     this.#shortTerm = new ShortTermStore();
+    this.#stVerbatimOverlay = _nullishCoalesce(options.st_verbatim_overlay, () => ( options.stVerbatimOverlay));
+    this.#logger = options.logger;
+    this.#stAuthoritative = _nullishCoalesce(options.sdk_st_authoritative, () => ( options.sdkStAuthoritative));
     this.#turns = new TurnCounter();
     this.conversation = createConversationNamespace(
       this.#transport,
@@ -2299,8 +2542,12 @@ var SynapClient = class {
         this.#shortTerm.appendTurn(conversationId, role, content, timestamp);
       },
       (response, conversationId, userId) => {
-        overlayLocalRecentTurns(response, this.#shortTerm, conversationId);
+        overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
         this.#injectUserSummary(response, conversationId, userId);
+      },
+      {
+        prompt: (conversationId, style) => this.#localPrompt(conversationId, style),
+        compacted: (conversationId, format) => this.#localCompacted(conversationId, format)
       }
     );
     this.memories = createMemoriesInterface(this.#transport);
@@ -2351,9 +2598,9 @@ var SynapClient = class {
    */
   async searchMemory(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("user_id is required");
     if (options.query === void 0 || options.query === null) {
-      throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("query is required");
+      throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)("query is required");
     }
     const context = await fetchContext(this.#transport, "user", {
       user_id: userId,
@@ -2374,7 +2621,7 @@ var SynapClient = class {
    */
   async getMemories(options) {
     const userId = _nullishCoalesce(options.user_id, () => ( options.userId));
-    if (!userId) throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("user_id is required");
+    if (!userId) throw new (0, _chunk2TVL5IPQcjs.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") } : {},
@@ -2422,8 +2669,8 @@ var SynapClient = class {
       const whoami = await this.#transport.request("whoami", {});
       const resolvedClientId = String(_nullishCoalesce(whoami["client_id"], () => ( "")));
       const resolvedInstanceId = String(_nullishCoalesce(whoami["instance_id"], () => ( "")));
-      const iso2 = whoami["user_context_isolation"];
-      this.#transport.userContextIsolation = typeof iso2 === "string" ? iso2 : void 0;
+      const iso3 = whoami["user_context_isolation"];
+      this.#transport.userContextIsolation = typeof iso3 === "string" ? iso3 : void 0;
       this.#transport.updateCredentials({
         ...resolvedClientId !== "" && credentials.clientId === "" ? { clientId: resolvedClientId } : {},
         ...resolvedInstanceId !== "" && credentials.instanceId === "" ? { instanceId: resolvedInstanceId } : {}
@@ -2433,7 +2680,7 @@ var SynapClient = class {
           this.#registryKeys.push(resolvedInstanceId);
         }
       }
-    } catch (e7) {
+    } catch (e8) {
     }
   }
   /**
@@ -2459,20 +2706,22 @@ var SynapClient = class {
    * initialization: the transport and cache are already built by then and a
    * half-applied config is worse than a rejected one.
    *
-   * The Python-only keys (`storage_path`, `cache_backend`,
-   * `session_timeout_minutes`, `logger`) are accepted and ignored rather than
-   * rejected, because this SDK has no SQLite cache backend and no global
-   * logger to swap. Ignoring them keeps a shared config object portable
-   * between the two SDKs.
+   * `logger` is honoured here as well as on the constructor. The remaining
+   * Python-only keys (`storage_path`, `cache_backend`,
+   * `session_timeout_minutes`, `log_level`) are accepted and ignored rather
+   * than rejected, because this SDK has no SQLite cache backend and no global
+   * logging framework whose level there would be to set. Ignoring them keeps
+   * a shared config object portable between the two SDKs.
    */
   configure(options = {}) {
     if (this.#initialized) {
-      throw new (0, _chunkHR5Y3KXScjs.InvalidInputError)("Cannot reconfigure after initialization");
+      throw new (0, _chunk2TVL5IPQcjs.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) {
       this.#transport.setRetryPolicy(_nullishCoalesce(_nullishCoalesce(options.retryPolicy, () => ( options.retry_policy)), () => ( null)));
     }
+    if (options.logger !== void 0) this.#logger = options.logger;
   }
   /**
    * Fetch and merge context across every scope with an identifier, in one call.
@@ -2565,19 +2814,19 @@ var SynapClient = class {
         successful.push([label, result.value]);
         continue;
       }
-      if (result.reason instanceof _chunkHR5Y3KXScjs.InvalidInputError) throw result.reason;
+      if (result.reason instanceof _chunk2TVL5IPQcjs.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);
+      overlayLocalRecentTurns(response, this.#shortTerm, conversationId, this.#stVerbatimOverlay);
     }
     if (includeConversationContext && conversationId !== void 0 && conversationId !== "") {
       try {
         merged.conversation_context = await this.conversation.context.get_context_for_prompt({
           conversation_id: conversationId
         });
-      } catch (e8) {
+      } catch (e9) {
       }
     }
     merged.formatted_context = formatForPrompt(merged, {
@@ -2624,7 +2873,7 @@ var SynapClient = class {
         source_bundle_ids: served.bundleId ? [served.bundleId] : [],
         timestamp_ms: Date.now()
       });
-    } catch (e9) {
+    } catch (e10) {
     }
   }
   /**
@@ -2649,7 +2898,7 @@ var SynapClient = class {
         }),
         scope
       });
-    } catch (e10) {
+    } catch (e11) {
     }
   }
   /**
@@ -2667,8 +2916,44 @@ var SynapClient = class {
     if (summary === null) return;
     mergeUserSummary(response, summary);
   }
-  /** Python logs via `logger.warning`; here it is one overridable seam. */
+  /**
+   * Whether the SDK is authoritative for short-term context.
+   *
+   * Resolution order matches Python's `_is_st_authoritative`: the explicit
+   * option first, then `SYNAP_SDK_ST_AUTHORITATIVE` (truthy strings only).
+   * Defaults to false, so nothing changes for a caller who never sets it.
+   */
+  #isStAuthoritative() {
+    if (this.#stAuthoritative === true) return true;
+    const raw = (_nullishCoalesce(_chunkZKOJDUN4cjs.getEnv.call(void 0, "SYNAP_SDK_ST_AUTHORITATIVE"), () => ( ""))).trim().toLowerCase();
+    return ["1", "true", "yes", "on"].includes(raw);
+  }
+  /**
+   * Render `get_context_for_prompt` from the local store, or null to fall
+   * through to the network. Warm means a compaction landed OR raw turns are
+   * buffered: with neither there is nothing to render and the server's answer
+   * is the only real one.
+   */
+  #localPrompt(conversationId, style) {
+    if (!this.#isStAuthoritative()) return null;
+    const entry = this.#shortTerm.get(conversationId);
+    if (entry === null) return null;
+    if (entry.compactionId === null && entry.recentTurns.length === 0) return null;
+    return renderForPrompt(entry, style);
+  }
+  /** Same, for `get_compacted`. Requires an actual compaction, not just turns. */
+  #localCompacted(conversationId, format) {
+    if (!this.#isStAuthoritative()) return null;
+    const entry = this.#shortTerm.get(conversationId);
+    if (entry === null || entry.compactionId === null) return null;
+    return renderCompacted(entry, format);
+  }
+  /** Every diagnostic the SDK emits passes through here. */
   #warn(message) {
+    if (this.#logger !== void 0) {
+      this.#logger("warn", message);
+      return;
+    }
     console.warn(`[synap] ${message}`);
   }
   /** Release timers and connections. Safe to call more than once. */
@@ -2689,14 +2974,15 @@ function pick3(o2, snake, camel) {
   return a !== void 0 ? a : o2[camel];
 }
 function resolveBaseUrl(options) {
-  if (options.baseUrl !== void 0) return options.baseUrl;
+  const explicit = _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()]);
   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, _chunkHR5Y3KXScjs.InvalidInputError)(
+    throw new (0, _chunk2TVL5IPQcjs.InvalidInputError)(
       "No Synap API key found. Set SYNAP_API_KEY in your environment, or pass apiKey to the SynapClient constructor."
     );
   }
@@ -2756,5 +3042,6 @@ function resolveCredentials(options) {
 
 
 
-exports.ANY_SCOPE = _chunkRB57I2IQcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunkHR5Y3KXScjs.AgentUnavailableError; exports.AnticipationCache = _chunkRB57I2IQcjs.AnticipationCache; exports.AuthenticationError = _chunkHR5Y3KXScjs.AuthenticationError; exports.BM25 = _chunkRB57I2IQcjs.BM25; exports.CONTRACT = _chunkRB57I2IQcjs.CONTRACT; exports.ConflictError = _chunkHR5Y3KXScjs.ConflictError; exports.ConnectionError = _chunkHR5Y3KXScjs.ConnectionError; exports.ContextNotFoundError = _chunkHR5Y3KXScjs.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 = _chunkHR5Y3KXScjs.InsufficientCreditsError; exports.InvalidConversationIdError = _chunkHR5Y3KXScjs.InvalidConversationIdError; exports.InvalidInputError = _chunkHR5Y3KXScjs.InvalidInputError; exports.InvalidInstanceIdError = _chunkHR5Y3KXScjs.InvalidInstanceIdError; exports.ListeningAlreadyActiveError = _chunkHR5Y3KXScjs.ListeningAlreadyActiveError; exports.ListeningNotActiveError = _chunkHR5Y3KXScjs.ListeningNotActiveError; exports.NetworkTimeoutError = _chunkHR5Y3KXScjs.NetworkTimeoutError; exports.PermanentError = _chunkHR5Y3KXScjs.PermanentError; exports.RateLimitError = _chunkHR5Y3KXScjs.RateLimitError; exports.SDKError = _chunkHR5Y3KXScjs.SDKError; exports.SDK_VERSION = SDK_VERSION; exports.ServiceUnavailableError = _chunkHR5Y3KXScjs.ServiceUnavailableError; exports.SessionExpiredError = _chunkHR5Y3KXScjs.SessionExpiredError; exports.SynapClient = SynapClient; exports.SynapError = _chunkHR5Y3KXScjs.SynapError; exports.SynapPermanentError = _chunkHR5Y3KXScjs.SynapPermanentError; exports.SynapTransientError = _chunkHR5Y3KXScjs.SynapTransientError; exports.THRESHOLDS = _chunkRB57I2IQcjs.THRESHOLDS; exports.TranscriptConflictError = _chunkHR5Y3KXScjs.TranscriptConflictError; exports.TransientError = _chunkHR5Y3KXScjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkRB57I2IQcjs.isRecallQuery; exports.isSynapError = _chunkHR5Y3KXScjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkRB57I2IQcjs.stem; exports.tokenize = _chunkRB57I2IQcjs.tokenize;
+
+exports.ANY_SCOPE = _chunkRB57I2IQcjs.ANY_SCOPE; exports.AgentUnavailableError = _chunk2TVL5IPQcjs.AgentUnavailableError; exports.AnticipationCache = _chunkRB57I2IQcjs.AnticipationCache; exports.AuthenticationError = _chunk2TVL5IPQcjs.AuthenticationError; exports.BM25 = _chunkRB57I2IQcjs.BM25; exports.COMPACTION_LEVELS = COMPACTION_LEVELS; exports.CONTRACT = _chunkRB57I2IQcjs.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 = _chunkRB57I2IQcjs.THRESHOLDS; exports.TranscriptConflictError = _chunk2TVL5IPQcjs.TranscriptConflictError; exports.TransientError = _chunk2TVL5IPQcjs.TransientError; exports.flattenContextItems = flattenContextItems; exports.formatForPrompt = formatForPrompt; exports.isOutcomeUnknown = isOutcomeUnknown; exports.isRecallQuery = _chunkRB57I2IQcjs.isRecallQuery; exports.isSynapError = _chunk2TVL5IPQcjs.isSynapError; exports.mergeScopeResults = mergeScopeResults; exports.resolvePath = resolvePath; exports.shouldRetry = shouldRetry; exports.stem = _chunkRB57I2IQcjs.stem; exports.tokenize = _chunkRB57I2IQcjs.tokenize;
 //# sourceMappingURL=index.cjs.map