@anuma/sdk 3.0.0 → 3.1.1

package/dist/index.mjs

@@ -1462,6 +1462,201 @@ var getHealth = (options) => {
   });
 };
 
+// src/lib/memoryEngine/constants.ts
+var DEFAULT_API_EMBEDDING_MODEL = "qwen/qwen3-embedding-8b";
+
+// src/lib/memoryEngine/generate.ts
+var EMBED_MAX_ATTEMPTS = 4;
+async function withEmbeddingRetry(call) {
+  let last;
+  let lastThrown;
+  let threw = false;
+  for (let attempt = 1; attempt <= EMBED_MAX_ATTEMPTS; attempt++) {
+    try {
+      threw = false;
+      last = await call();
+      if (!last.error) return last;
+      const status = last.response?.status;
+      const retryable = status === void 0 || status === 429 || status >= 500;
+      if (!retryable) return last;
+    } catch (err) {
+      threw = true;
+      lastThrown = err;
+    }
+    if (attempt < EMBED_MAX_ATTEMPTS) {
+      const base = 250 * 2 ** (attempt - 1);
+      await new Promise((r) => setTimeout(r, base + Math.random() * 0.4 * base));
+    }
+  }
+  if (threw) throw lastThrown;
+  return last;
+}
+var EmbeddingHttpError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.name = "EmbeddingHttpError";
+    this.status = status;
+  }
+};
+function embeddingErrorFrom(response) {
+  const message = typeof response.error === "object" && response.error && "error" in response.error ? response.error.error : "API embedding failed";
+  return new EmbeddingHttpError(message, response.response?.status);
+}
+async function generateEmbedding(text, options) {
+  const { baseUrl = BASE_URL, getToken, apiKey, model, cache } = options;
+  if (cache) {
+    const cached = cache.get(text);
+    if (cached) return Array.from(cached);
+  }
+  let headers;
+  if (apiKey) {
+    headers = { "X-API-Key": apiKey };
+  } else if (getToken) {
+    const token = await getToken();
+    if (!token) {
+      throw new Error("No token available for embedding generation");
+    }
+    headers = { Authorization: `Bearer ${token}` };
+  } else {
+    throw new Error("Either apiKey or getToken must be provided");
+  }
+  const response = await withEmbeddingRetry(
+    () => postApiV1Embeddings({
+      baseUrl,
+      body: {
+        // Mask PII from the request body only — the cache above still keys on
+        // the original `text`, so callers keep their original values.
+        input: options.maskInput ? options.maskInput(text) : text,
+        model: model ?? DEFAULT_API_EMBEDDING_MODEL
+      },
+      headers
+    })
+  );
+  if (response.error) {
+    throw embeddingErrorFrom(response);
+  }
+  if (!response.data?.data?.[0]?.embedding) {
+    throw new Error("No embedding returned from API");
+  }
+  const embedding = response.data.data[0].embedding;
+  if (options.onUsage && response.data.usage) {
+    options.onUsage({
+      promptTokens: response.data.usage.prompt_tokens ?? 0,
+      totalTokens: response.data.usage.total_tokens ?? 0
+    });
+  }
+  const f32Embedding = Float32Array.from(embedding);
+  if (cache) {
+    cache.set(text, f32Embedding);
+  }
+  return Array.from(f32Embedding);
+}
+var DEFAULT_EMBEDDING_BATCH_SIZE = 100;
+var DEFAULT_EMBEDDING_BATCH_CONCURRENCY = 3;
+async function generateEmbeddingsBatch(texts, headers, baseUrl, model, onUsage, maskInput) {
+  const response = await withEmbeddingRetry(
+    () => postApiV1Embeddings({
+      baseUrl,
+      // Mask PII from the request body only; cache/order still key on originals.
+      body: { input: maskInput ? texts.map(maskInput) : texts, model },
+      headers
+    })
+  );
+  if (response.error) {
+    throw embeddingErrorFrom(response);
+  }
+  if (!response.data?.data) {
+    throw new Error("No embeddings returned from API");
+  }
+  if (onUsage && response.data.usage) {
+    onUsage({
+      promptTokens: response.data.usage.prompt_tokens ?? 0,
+      totalTokens: response.data.usage.total_tokens ?? 0
+    });
+  }
+  return response.data.data.map((item) => item.embedding ?? []);
+}
+async function generateEmbeddings(texts, options) {
+  if (texts.length === 0) return [];
+  const { baseUrl = BASE_URL, getToken, apiKey, model, batchSize, cache } = options;
+  const chunkSize = batchSize ?? DEFAULT_EMBEDDING_BATCH_SIZE;
+  const results = new Array(texts.length).fill(null);
+  const uncachedIndices = [];
+  const uncachedTexts = [];
+  for (let i = 0; i < texts.length; i++) {
+    if (cache) {
+      const cached = cache.get(texts[i]);
+      if (cached) {
+        results[i] = Array.from(cached);
+        continue;
+      }
+    }
+    uncachedIndices.push(i);
+    uncachedTexts.push(texts[i]);
+  }
+  if (uncachedTexts.length === 0) {
+    return results;
+  }
+  let headers;
+  if (apiKey) {
+    headers = { "X-API-Key": apiKey };
+  } else if (getToken) {
+    const token = await getToken();
+    if (!token) {
+      throw new Error("No token available for embedding generation");
+    }
+    headers = { Authorization: `Bearer ${token}` };
+  } else {
+    throw new Error("Either apiKey or getToken must be provided");
+  }
+  const embeddingModel = model ?? DEFAULT_API_EMBEDDING_MODEL;
+  let newEmbeddings;
+  if (uncachedTexts.length <= chunkSize) {
+    newEmbeddings = await generateEmbeddingsBatch(
+      uncachedTexts,
+      headers,
+      baseUrl,
+      embeddingModel,
+      options.onUsage,
+      options.maskInput
+    );
+  } else {
+    const chunks = [];
+    for (let i = 0; i < uncachedTexts.length; i += chunkSize) {
+      chunks.push(uncachedTexts.slice(i, i + chunkSize));
+    }
+    const allEmbeddings = new Array(chunks.length);
+    let nextIndex = 0;
+    const worker = async () => {
+      while (nextIndex < chunks.length) {
+        const idx = nextIndex++;
+        allEmbeddings[idx] = await generateEmbeddingsBatch(
+          chunks[idx],
+          headers,
+          baseUrl,
+          embeddingModel,
+          options.onUsage,
+          options.maskInput
+        );
+      }
+    };
+    const workers = Array.from(
+      { length: Math.min(DEFAULT_EMBEDDING_BATCH_CONCURRENCY, chunks.length) },
+      () => worker()
+    );
+    await Promise.all(workers);
+    newEmbeddings = allEmbeddings.flat();
+  }
+  for (let i = 0; i < uncachedIndices.length; i++) {
+    const f32Embedding = Float32Array.from(newEmbeddings[i]);
+    results[uncachedIndices[i]] = Array.from(f32Embedding);
+    if (cache) {
+      cache.set(uncachedTexts[i], f32Embedding);
+    }
+  }
+  return results;
+}
+
 // src/tools/appBuilderPrompt.ts
 var APP_BUILDER_PROMPT = `App Builder tools (create_file, patch_file, and the rest described below) are available this turn, but they are OPTIONAL \u2014 having them does not mean you should build anything.
 
@@ -1679,395 +1874,64 @@ function chunkText(text, options) {
         overlapSentences.unshift(currentChunkSentences[j]);
         overlapLength += currentChunkSentences[j].length + 1;
       }
-      if (overlapSentences.length > 0) {
-        currentChunkSentences = [...overlapSentences, sentence];
-        const overlapText = overlapSentences[0];
-        const overlapStart = text.lastIndexOf(overlapText, currentOffset);
-        currentChunkStart = overlapStart === -1 ? sentenceStart : overlapStart;
-      } else {
-        currentChunkSentences = [sentence];
-        currentChunkStart = sentenceStart;
-      }
-    } else {
-      if (currentChunkSentences.length === 0) {
-        currentChunkStart = sentenceStart;
-      }
-      currentChunkSentences.push(sentence);
-    }
-    currentOffset = sentenceEnd;
-  }
-  if (currentChunkSentences.length > 0) {
-    const chunkText2 = currentChunkSentences.join(" ");
-    if (chunkText2.length >= minChunkSize) {
-      chunks.push({
-        text: chunkText2,
-        startOffset: currentChunkStart,
-        endOffset: text.length
-      });
-    }
-  }
-  if (chunks.length === 0) {
-    const trimmedText = text.trim();
-    if (trimmedText.length > 0) {
-      return [
-        {
-          text: trimmedText,
-          startOffset: 0,
-          endOffset: text.length
-        }
-      ];
-    }
-  }
-  return chunks;
-}
-function shouldChunkMessage(content, chunkSize = DEFAULT_CHUNK_SIZE) {
-  return content.length > chunkSize;
-}
-
-// src/react/useEncryption.ts
-var encryptionKeyStore = /* @__PURE__ */ new Map();
-var cryptoKeyCache = /* @__PURE__ */ new Map();
-var clearAllEncryptionStateCallbacks = /* @__PURE__ */ new Set();
-function onClearAllEncryptionState(callback) {
-  clearAllEncryptionStateCallbacks.add(callback);
-  return () => {
-    clearAllEncryptionStateCallbacks.delete(callback);
-  };
-}
-function getStoredKey(address) {
-  const keys = encryptionKeyStore.get(address);
-  return keys?.current ?? null;
-}
-function getStoredKeyByVersion(address, version) {
-  const keys = encryptionKeyStore.get(address);
-  if (!keys) return null;
-  return version === "v2" ? keys.legacy : keys.current;
-}
-function hexToBytes(hex) {
-  const cleanHex = hex.startsWith("0x") ? hex.slice(2) : hex;
-  const bytes = new Uint8Array(cleanHex.length / 2);
-  for (let i = 0; i < cleanHex.length; i += 2) {
-    bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
-  }
-  return bytes;
-}
-var SHARED_TEXT_ENCODER = new TextEncoder();
-var SHARED_TEXT_DECODER = new TextDecoder();
-async function getEncryptionKey(address, version = "v3") {
-  const cacheKey = `${address}:${version}`;
-  const cachedKey = cryptoKeyCache.get(cacheKey);
-  if (cachedKey) {
-    return cachedKey;
-  }
-  const keyHex = getStoredKeyByVersion(address, version);
-  if (!keyHex) {
-    throw new Error(
-      "Encryption key not found. Please sign a message to generate your encryption key."
-    );
-  }
-  const keyBytes = hexToBytes(keyHex);
-  const cryptoKey = await crypto.subtle.importKey(
-    "raw",
-    keyBytes.buffer,
-    { name: "AES-GCM" },
-    false,
-    ["encrypt", "decrypt"]
-  );
-  cryptoKeyCache.set(cacheKey, cryptoKey);
-  return cryptoKey;
-}
-async function decryptData(encryptedHex, address, version = "v3") {
-  const key = await getEncryptionKey(address, version);
-  return decryptDataWithKey(encryptedHex, key);
-}
-function hasEncryptionKey(address) {
-  return getStoredKey(address) !== null;
-}
-async function decryptDataWithKey(encryptedHex, key) {
-  const combined = hexToBytes(encryptedHex);
-  const iv = combined.subarray(0, 12);
-  const encryptedData = combined.subarray(12);
-  const decryptedData = await crypto.subtle.decrypt(
-    {
-      name: "AES-GCM",
-      iv
-    },
-    key,
-    encryptedData
-  );
-  return SHARED_TEXT_DECODER.decode(decryptedData);
-}
-
-// src/lib/memoryEngine/vector.ts
-function cosineSimilarity(a, b) {
-  if (a.length !== b.length) return 0;
-  let dot = 0;
-  let normA = 0;
-  let normB = 0;
-  for (let i = 0; i < a.length; i++) {
-    dot += a[i] * b[i];
-    normA += a[i] * a[i];
-    normB += b[i] * b[i];
-  }
-  const denom = Math.sqrt(normA) * Math.sqrt(normB);
-  return denom === 0 ? 0 : dot / denom;
-}
-
-// src/lib/db/encryption-utils.ts
-function isEncrypted(value) {
-  const prefix = value.startsWith("enc:v3:") ? "enc:v3:" : value.startsWith("enc:v2:") ? "enc:v2:" : null;
-  if (!prefix) return false;
-  const payload = value.slice(prefix.length);
-  return payload.length >= 56 && /^[0-9a-f]+$/i.test(payload);
-}
-function detectEncryptionVersion(value) {
-  if (value.startsWith("enc:v3:")) {
-    return { version: "v3", encryptedData: value.slice("enc:v3:".length) };
-  }
-  if (value.startsWith("enc:v2:")) {
-    return { version: "v2", encryptedData: value.slice("enc:v2:".length) };
-  }
-  return null;
-}
-async function decryptField(value, address) {
-  if (!value) return value;
-  const detected = detectEncryptionVersion(value);
-  if (!detected) return value;
-  if (detected.encryptedData.length < 56 || !/^[0-9a-f]+$/i.test(detected.encryptedData)) {
-    return value;
-  }
-  try {
-    return await decryptData(detected.encryptedData, address, detected.version);
-  } catch (error) {
-    getLogger().warn("Failed to decrypt field, returning as-is:", error);
-    return value;
-  }
-}
-
-// src/lib/chat/useChat/strategies/types.ts
-function isChatCompletionResponse(r) {
-  if (r.object === "response") return false;
-  if (Array.isArray(r.output)) return false;
-  return true;
-}
-function getToolCallEvents(r) {
-  if (isChatCompletionResponse(r)) {
-    return r.portal?.tool_call_events ?? r.tool_call_events;
-  }
-  return r.tool_call_events;
-}
-function getCostMicroUsd(r) {
-  if (isChatCompletionResponse(r)) {
-    return r.portal?.cost_micro_usd ?? r.usage?.cost_micro_usd;
-  }
-  return r.usage?.cost_micro_usd;
-}
-function getCreditsUsed(r) {
-  if (isChatCompletionResponse(r)) {
-    return r.portal?.credits_used ?? r.usage?.credits_used;
-  }
-  return r.usage?.credits_used;
-}
-function getImageModel(r) {
-  if (isChatCompletionResponse(r)) {
-    return r.portal?.image_model ?? r.image_model;
-  }
-  return r.image_model;
-}
-
-// src/lib/memoryEngine/constants.ts
-var DEFAULT_API_EMBEDDING_MODEL = "qwen/qwen3-embedding-8b";
-
-// src/lib/memoryEngine/embeddings.ts
-var EMBED_MAX_ATTEMPTS = 4;
-async function withEmbeddingRetry(call) {
-  let last;
-  let lastThrown;
-  let threw = false;
-  for (let attempt = 1; attempt <= EMBED_MAX_ATTEMPTS; attempt++) {
-    try {
-      threw = false;
-      last = await call();
-      if (!last.error) return last;
-      const status = last.response?.status;
-      const retryable = status === void 0 || status === 429 || status >= 500;
-      if (!retryable) return last;
-    } catch (err) {
-      threw = true;
-      lastThrown = err;
-    }
-    if (attempt < EMBED_MAX_ATTEMPTS) {
-      const base = 250 * 2 ** (attempt - 1);
-      await new Promise((r) => setTimeout(r, base + Math.random() * 0.4 * base));
-    }
-  }
-  if (threw) throw lastThrown;
-  return last;
-}
-var EmbeddingHttpError = class extends Error {
-  constructor(message, status) {
-    super(message);
-    this.name = "EmbeddingHttpError";
-    this.status = status;
-  }
-};
-function embeddingErrorFrom(response) {
-  const message = typeof response.error === "object" && response.error && "error" in response.error ? response.error.error : "API embedding failed";
-  return new EmbeddingHttpError(message, response.response?.status);
-}
-async function generateEmbedding(text, options) {
-  const { baseUrl = BASE_URL, getToken, apiKey, model, cache } = options;
-  if (cache) {
-    const cached = cache.get(text);
-    if (cached) return Array.from(cached);
-  }
-  let headers;
-  if (apiKey) {
-    headers = { "X-API-Key": apiKey };
-  } else if (getToken) {
-    const token = await getToken();
-    if (!token) {
-      throw new Error("No token available for embedding generation");
-    }
-    headers = { Authorization: `Bearer ${token}` };
-  } else {
-    throw new Error("Either apiKey or getToken must be provided");
-  }
-  const response = await withEmbeddingRetry(
-    () => postApiV1Embeddings({
-      baseUrl,
-      body: {
-        // Mask PII from the request body only — the cache above still keys on
-        // the original `text`, so callers keep their original values.
-        input: options.maskInput ? options.maskInput(text) : text,
-        model: model ?? DEFAULT_API_EMBEDDING_MODEL
-      },
-      headers
-    })
-  );
-  if (response.error) {
-    throw embeddingErrorFrom(response);
-  }
-  if (!response.data?.data?.[0]?.embedding) {
-    throw new Error("No embedding returned from API");
-  }
-  const embedding = response.data.data[0].embedding;
-  if (options.onUsage && response.data.usage) {
-    options.onUsage({
-      promptTokens: response.data.usage.prompt_tokens ?? 0,
-      totalTokens: response.data.usage.total_tokens ?? 0
-    });
-  }
-  const f32Embedding = Float32Array.from(embedding);
-  if (cache) {
-    cache.set(text, f32Embedding);
-  }
-  return Array.from(f32Embedding);
-}
-var DEFAULT_EMBEDDING_BATCH_SIZE = 100;
-var DEFAULT_EMBEDDING_BATCH_CONCURRENCY = 3;
-async function generateEmbeddingsBatch(texts, headers, baseUrl, model, onUsage, maskInput) {
-  const response = await withEmbeddingRetry(
-    () => postApiV1Embeddings({
-      baseUrl,
-      // Mask PII from the request body only; cache/order still key on originals.
-      body: { input: maskInput ? texts.map(maskInput) : texts, model },
-      headers
-    })
-  );
-  if (response.error) {
-    throw embeddingErrorFrom(response);
-  }
-  if (!response.data?.data) {
-    throw new Error("No embeddings returned from API");
-  }
-  if (onUsage && response.data.usage) {
-    onUsage({
-      promptTokens: response.data.usage.prompt_tokens ?? 0,
-      totalTokens: response.data.usage.total_tokens ?? 0
-    });
-  }
-  return response.data.data.map((item) => item.embedding ?? []);
-}
-async function generateEmbeddings(texts, options) {
-  if (texts.length === 0) return [];
-  const { baseUrl = BASE_URL, getToken, apiKey, model, batchSize, cache } = options;
-  const chunkSize = batchSize ?? DEFAULT_EMBEDDING_BATCH_SIZE;
-  const results = new Array(texts.length).fill(null);
-  const uncachedIndices = [];
-  const uncachedTexts = [];
-  for (let i = 0; i < texts.length; i++) {
-    if (cache) {
-      const cached = cache.get(texts[i]);
-      if (cached) {
-        results[i] = Array.from(cached);
-        continue;
+      if (overlapSentences.length > 0) {
+        currentChunkSentences = [...overlapSentences, sentence];
+        const overlapText = overlapSentences[0];
+        const overlapStart = text.lastIndexOf(overlapText, currentOffset);
+        currentChunkStart = overlapStart === -1 ? sentenceStart : overlapStart;
+      } else {
+        currentChunkSentences = [sentence];
+        currentChunkStart = sentenceStart;
       }
+    } else {
+      if (currentChunkSentences.length === 0) {
+        currentChunkStart = sentenceStart;
+      }
+      currentChunkSentences.push(sentence);
     }
-    uncachedIndices.push(i);
-    uncachedTexts.push(texts[i]);
-  }
-  if (uncachedTexts.length === 0) {
-    return results;
+    currentOffset = sentenceEnd;
   }
-  let headers;
-  if (apiKey) {
-    headers = { "X-API-Key": apiKey };
-  } else if (getToken) {
-    const token = await getToken();
-    if (!token) {
-      throw new Error("No token available for embedding generation");
+  if (currentChunkSentences.length > 0) {
+    const chunkText2 = currentChunkSentences.join(" ");
+    if (chunkText2.length >= minChunkSize) {
+      chunks.push({
+        text: chunkText2,
+        startOffset: currentChunkStart,
+        endOffset: text.length
+      });
     }
-    headers = { Authorization: `Bearer ${token}` };
-  } else {
-    throw new Error("Either apiKey or getToken must be provided");
   }
-  const embeddingModel = model ?? DEFAULT_API_EMBEDDING_MODEL;
-  let newEmbeddings;
-  if (uncachedTexts.length <= chunkSize) {
-    newEmbeddings = await generateEmbeddingsBatch(
-      uncachedTexts,
-      headers,
-      baseUrl,
-      embeddingModel,
-      options.onUsage,
-      options.maskInput
-    );
-  } else {
-    const chunks = [];
-    for (let i = 0; i < uncachedTexts.length; i += chunkSize) {
-      chunks.push(uncachedTexts.slice(i, i + chunkSize));
+  if (chunks.length === 0) {
+    const trimmedText = text.trim();
+    if (trimmedText.length > 0) {
+      return [
+        {
+          text: trimmedText,
+          startOffset: 0,
+          endOffset: text.length
+        }
+      ];
     }
-    const allEmbeddings = new Array(chunks.length);
-    let nextIndex = 0;
-    const worker = async () => {
-      while (nextIndex < chunks.length) {
-        const idx = nextIndex++;
-        allEmbeddings[idx] = await generateEmbeddingsBatch(
-          chunks[idx],
-          headers,
-          baseUrl,
-          embeddingModel,
-          options.onUsage,
-          options.maskInput
-        );
-      }
-    };
-    const workers = Array.from(
-      { length: Math.min(DEFAULT_EMBEDDING_BATCH_CONCURRENCY, chunks.length) },
-      () => worker()
-    );
-    await Promise.all(workers);
-    newEmbeddings = allEmbeddings.flat();
   }
-  for (let i = 0; i < uncachedIndices.length; i++) {
-    const f32Embedding = Float32Array.from(newEmbeddings[i]);
-    results[uncachedIndices[i]] = Array.from(f32Embedding);
-    if (cache) {
-      cache.set(uncachedTexts[i], f32Embedding);
-    }
+  return chunks;
+}
+function shouldChunkMessage(content, chunkSize = DEFAULT_CHUNK_SIZE) {
+  return content.length > chunkSize;
+}
+
+// src/lib/memoryEngine/vector.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length) return 0;
+  let dot = 0;
+  let normA = 0;
+  let normB = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    normA += a[i] * a[i];
+    normB += b[i] * b[i];
   }
-  return results;
+  const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  return denom === 0 ? 0 : dot / denom;
 }
 
 // src/lib/tools/serverTools.ts
@@ -2134,7 +1998,7 @@ function getCachedServerTools() {
     if (!cached) return null;
     const parsed = JSON.parse(cached);
     if (parsed.version !== CACHE_VERSION) {
-      clearServerToolsCache();
+      removeLocalStorageCache();
       return null;
     }
     return parsed;
@@ -2146,24 +2010,31 @@ function isCacheExpired(cache, expirationMs = DEFAULT_CACHE_EXPIRATION_MS) {
   if (!cache) return true;
   return Date.now() - cache.timestamp > expirationMs;
 }
-function cacheServerTools(tools, checksum) {
-  if (typeof localStorage === "undefined") return;
-  const cacheData = {
+function buildCacheEntry(tools, checksum) {
+  return {
     tools,
     timestamp: Date.now(),
     version: CACHE_VERSION,
     ...checksum && { checksum }
   };
+}
+function writeLocalStorageCache(entry) {
+  if (typeof localStorage === "undefined") return;
   try {
-    localStorage.setItem(SERVER_TOOLS_CACHE_KEY, JSON.stringify(cacheData));
+    localStorage.setItem(SERVER_TOOLS_CACHE_KEY, JSON.stringify(entry));
   } catch (error) {
     getLogger().warn("[serverTools] Failed to cache tools:", error);
   }
 }
-function clearServerToolsCache() {
+function removeLocalStorageCache() {
   if (typeof localStorage === "undefined") return;
   localStorage.removeItem(SERVER_TOOLS_CACHE_KEY);
 }
+var localStorageToolsCache = {
+  get: getCachedServerTools,
+  set: writeLocalStorageCache,
+  clear: removeLocalStorageCache
+};
 async function fetchServerToolsFromApi(baseUrl, token) {
   const response = await fetch(`${baseUrl}/api/v1/tools`, {
     method: "GET",
@@ -2184,9 +2055,23 @@ async function getServerTools(options) {
     cacheExpirationMs = DEFAULT_CACHE_EXPIRATION_MS,
     forceRefresh = false,
     getToken,
-    apiKey
+    apiKey,
+    cache = localStorageToolsCache
   } = options;
-  const cached = getCachedServerTools();
+  const persistCache = async (entry) => {
+    try {
+      await cache.set(entry);
+    } catch (error) {
+      getLogger().warn("[serverTools] Cache write failed (non-fatal):", error);
+    }
+  };
+  let rawCached = null;
+  try {
+    rawCached = await cache.get();
+  } catch (error) {
+    getLogger().warn("[serverTools] Cache read failed; falling through to server fetch:", error);
+  }
+  const cached = rawCached && rawCached.version === CACHE_VERSION ? rawCached : null;
   const cacheValid = !isCacheExpired(cached, cacheExpirationMs);
   if (cached && cacheValid && !forceRefresh) {
     return cached.tools;
@@ -2207,7 +2092,7 @@ async function getServerTools(options) {
       }
       const data = await response.json();
       const { tools: tools2, checksum: checksum2 } = convertServerToolsResponse(data);
-      cacheServerTools(tools2, checksum2);
+      await persistCache(buildCacheEntry(tools2, checksum2));
       return tools2;
     }
     if (!getToken) {
@@ -2220,7 +2105,7 @@ async function getServerTools(options) {
       return cached?.tools ?? [];
     }
     const { tools, checksum } = await fetchServerToolsFromApi(effectiveBaseUrl, token);
-    cacheServerTools(tools, checksum);
+    await persistCache(buildCacheEntry(tools, checksum));
     return tools;
   } catch (error) {
     getLogger().error("[serverTools] Failed to fetch server tools:", error);
@@ -3078,6 +2963,142 @@ function buildSystemPrompt(ctx, options) {
   return { prompt, activeSections };
 }
 
+// src/react/useEncryption.ts
+var encryptionKeyStore = /* @__PURE__ */ new Map();
+var cryptoKeyCache = /* @__PURE__ */ new Map();
+var clearAllEncryptionStateCallbacks = /* @__PURE__ */ new Set();
+function onClearAllEncryptionState(callback) {
+  clearAllEncryptionStateCallbacks.add(callback);
+  return () => {
+    clearAllEncryptionStateCallbacks.delete(callback);
+  };
+}
+function getStoredKey(address) {
+  const keys = encryptionKeyStore.get(address);
+  return keys?.current ?? null;
+}
+function getStoredKeyByVersion(address, version) {
+  const keys = encryptionKeyStore.get(address);
+  if (!keys) return null;
+  return version === "v2" ? keys.legacy : keys.current;
+}
+function hexToBytes(hex) {
+  const cleanHex = hex.startsWith("0x") ? hex.slice(2) : hex;
+  const bytes = new Uint8Array(cleanHex.length / 2);
+  for (let i = 0; i < cleanHex.length; i += 2) {
+    bytes[i / 2] = parseInt(cleanHex.slice(i, i + 2), 16);
+  }
+  return bytes;
+}
+var SHARED_TEXT_ENCODER = new TextEncoder();
+var SHARED_TEXT_DECODER = new TextDecoder();
+async function getEncryptionKey(address, version = "v3") {
+  const cacheKey = `${address}:${version}`;
+  const cachedKey = cryptoKeyCache.get(cacheKey);
+  if (cachedKey) {
+    return cachedKey;
+  }
+  const keyHex = getStoredKeyByVersion(address, version);
+  if (!keyHex) {
+    throw new Error(
+      "Encryption key not found. Please sign a message to generate your encryption key."
+    );
+  }
+  const keyBytes = hexToBytes(keyHex);
+  const cryptoKey = await crypto.subtle.importKey(
+    "raw",
+    keyBytes.buffer,
+    { name: "AES-GCM" },
+    false,
+    ["encrypt", "decrypt"]
+  );
+  cryptoKeyCache.set(cacheKey, cryptoKey);
+  return cryptoKey;
+}
+async function decryptData(encryptedHex, address, version = "v3") {
+  const key = await getEncryptionKey(address, version);
+  return decryptDataWithKey(encryptedHex, key);
+}
+function hasEncryptionKey(address) {
+  return getStoredKey(address) !== null;
+}
+async function decryptDataWithKey(encryptedHex, key) {
+  const combined = hexToBytes(encryptedHex);
+  const iv = combined.subarray(0, 12);
+  const encryptedData = combined.subarray(12);
+  const decryptedData = await crypto.subtle.decrypt(
+    {
+      name: "AES-GCM",
+      iv
+    },
+    key,
+    encryptedData
+  );
+  return SHARED_TEXT_DECODER.decode(decryptedData);
+}
+
+// src/lib/db/encryption-utils.ts
+function isEncrypted(value) {
+  const prefix = value.startsWith("enc:v3:") ? "enc:v3:" : value.startsWith("enc:v2:") ? "enc:v2:" : null;
+  if (!prefix) return false;
+  const payload = value.slice(prefix.length);
+  return payload.length >= 56 && /^[0-9a-f]+$/i.test(payload);
+}
+function detectEncryptionVersion(value) {
+  if (value.startsWith("enc:v3:")) {
+    return { version: "v3", encryptedData: value.slice("enc:v3:".length) };
+  }
+  if (value.startsWith("enc:v2:")) {
+    return { version: "v2", encryptedData: value.slice("enc:v2:".length) };
+  }
+  return null;
+}
+async function decryptField(value, address) {
+  if (!value) return value;
+  const detected = detectEncryptionVersion(value);
+  if (!detected) return value;
+  if (detected.encryptedData.length < 56 || !/^[0-9a-f]+$/i.test(detected.encryptedData)) {
+    return value;
+  }
+  try {
+    return await decryptData(detected.encryptedData, address, detected.version);
+  } catch (error) {
+    getLogger().warn("Failed to decrypt field, returning as-is:", error);
+    return value;
+  }
+}
+
+// src/lib/chat/useChat/strategies/types.ts
+function isChatCompletionResponse(r) {
+  if (r.object === "response") return false;
+  if (Array.isArray(r.output)) return false;
+  return true;
+}
+function getToolCallEvents(r) {
+  if (isChatCompletionResponse(r)) {
+    return r.portal?.tool_call_events ?? r.tool_call_events;
+  }
+  return r.tool_call_events;
+}
+function getCostMicroUsd(r) {
+  if (isChatCompletionResponse(r)) {
+    return r.portal?.cost_micro_usd ?? r.usage?.cost_micro_usd;
+  }
+  return r.usage?.cost_micro_usd;
+}
+function getCreditsUsed(r) {
+  if (isChatCompletionResponse(r)) {
+    return r.portal?.credits_used ?? r.usage?.credits_used;
+  }
+  return r.usage?.credits_used;
+}
+function getImageModel(r) {
+  if (isChatCompletionResponse(r)) {
+    return r.portal?.image_model ?? r.image_model;
+  }
+  return r.image_model;
+}
+
 // src/lib/memoryEngine/quantization.ts
 var INT8_MAX = 127;
 function quantizeEmbedding(v) {