@anuma/sdk 9.1.11 → 10.0.0

package/dist/index.mjs

@@ -684,8 +684,8 @@ var createClient = (config = {}) => {
             data = await response[parseAs]();
             break;
           case "json": {
-            const text2 = await response.text();
-            data = text2 ? JSON.parse(text2) : {};
+            const text3 = await response.text();
+            data = text3 ? JSON.parse(text3) : {};
             break;
           }
           case "stream":
@@ -1125,8 +1125,8 @@ var ATTACHED_FILES_OPEN_TAG = "<attached_files>";
 var ATTACHED_FILES_CLOSE_TAG = "</attached_files>";
 var ATTACHED_FILES_PREFIX = `${ATTACHED_FILES_OPEN_TAG}
 The user attached the following file(s) to this message. Their extracted contents are below; when the user refers to "the attached file", "this file" or "the document", they mean these.`;
-function isAttachedFilesText(text2) {
-  return typeof text2 === "string" && text2.startsWith(ATTACHED_FILES_PREFIX) && text2.endsWith(ATTACHED_FILES_CLOSE_TAG);
+function isAttachedFilesText(text3) {
+  return typeof text3 === "string" && text3.startsWith(ATTACHED_FILES_PREFIX) && text3.endsWith(ATTACHED_FILES_CLOSE_TAG);
 }
 function buildAttachedFilesText(fileContext) {
   return `${ATTACHED_FILES_PREFIX}
@@ -1739,6 +1739,7 @@ function createNearbyRequest(options, apiPath = "/api/private-memories") {
         }
         throw error;
       }
+      if (response.status === 204) return null;
       return await response.json();
     } catch (error) {
       if (timedOut) throw new RemoteMemoryError("Nearby request timed out", 408, "timeout");
@@ -1766,6 +1767,16 @@ var ChatStoreError = class extends Error {
 // src/lib/chatStore/remote.ts
 var kinds = /* @__PURE__ */ new Set(["conversation", "message", "summary", "project", "memory_links"]);
 var cipherPattern = /^enc:v\d+:(?:[0-9a-f]{2}){28,}$/i;
+var maxPayload = 2 * 1024 * 1024;
+var storedDims = 1536;
+var maxRequestCiphertext = 8 * 1024 * 1024;
+var maxGetRefs = 50;
+var maxImportRecords = 100;
+var maxVerifyRevisions = 1e3;
+var maxChunksPerRecord = 16;
+var maxChunksPerRequest = 200;
+var maxAttachmentBytes = 50 * 1024 * 1024;
+var attachmentIdPattern = /^[0-9a-f]{32}$/;
 var metadata = [
   "kind",
   "id",
@@ -1808,7 +1819,62 @@ function validRecord(value) {
   ))
     return false;
   const root = value.kind === "conversation" || value.kind === "project";
-  return root ? value.conversationId === "" && value.sortKey === 0 : id(value.conversationId);
+  return root ? value.conversationId === "" : id(value.conversationId);
+}
+function embeddings(write) {
+  if (write.embeddings === void 0) return true;
+  return Array.isArray(write.embeddings) && !write.record.isDeleted && (write.record.kind === "message" || write.record.kind === "summary") && write.embeddings.length <= maxChunksPerRecord && (write.embeddingModel === void 0 || typeof write.embeddingModel === "string" && write.embeddingModel.length <= 256) && Array.from({ length: write.embeddings.length }, (_, i) => i).every(
+    (i) => vector(write.embeddings?.[i])
+  );
+}
+function vector(v) {
+  if (!Array.isArray(v) || v.length !== 1536 && v.length !== 4096) return false;
+  let nonZero = false;
+  for (let i = 0; i < v.length; i++) {
+    const x = v[i];
+    if (typeof x !== "number" || !Number.isFinite(x)) return false;
+    if (i < storedDims && x !== 0) nonZero = true;
+  }
+  return nonZero;
+}
+function vectorFields(write) {
+  return {
+    ...write.embeddings !== void 0 ? { embeddings: write.embeddings.map((v) => v.slice(0, storedDims)) } : {},
+    ...write.embeddingModel !== void 0 ? { embedding_model: write.embeddingModel } : {}
+  };
+}
+function text2(value) {
+  return typeof value === "string";
+}
+function timestamp(value) {
+  return typeof value === "string" && Number.isFinite(Date.parse(value));
+}
+function presigned(value) {
+  if (!object(value) || !text2(value.url) || !/^https:\/\//.test(value.url) || !text2(value.method) || !object(value.headers) || !Object.values(value.headers).every(text2) || !timestamp(value.expires_at))
+    invalid();
+  return {
+    url: value.url,
+    method: value.method,
+    headers: value.headers,
+    expiresAt: value.expires_at
+  };
+}
+function attachment(value) {
+  if (!object(value) || !text2(value.attachment_id) || !attachmentIdPattern.test(value.attachment_id) || !integer(value.size_bytes, 1) || value.state !== "pending" && value.state !== "committed" || value.owner_kind !== void 0 && value.owner_kind !== "message" && value.owner_kind !== "summary" || value.owner_id !== void 0 && !id(value.owner_id) || !timestamp(value.created_at) || value.committed_at !== void 0 && !timestamp(value.committed_at))
+    invalid();
+  return {
+    id: value.attachment_id,
+    sizeBytes: value.size_bytes,
+    state: value.state,
+    ...value.owner_kind !== void 0 ? { ownerKind: value.owner_kind } : {},
+    ...value.owner_id !== void 0 ? { ownerId: value.owner_id } : {},
+    createdAt: value.created_at,
+    ...value.committed_at !== void 0 ? { committedAt: value.committed_at } : {}
+  };
+}
+function ref(value) {
+  if (!object(value) || !text2(value.kind) || !kinds.has(value.kind) || !id(value.id)) invalid();
+  return { kind: value.kind, id: value.id };
 }
 function sameMetadata(a, b) {
   return metadata.every((key) => a[key] === b[key]);
@@ -1864,8 +1930,11 @@ async function createRemoteChatStore(options) {
       isDeleted: r.is_deleted,
       data: {}
     };
-    if (!validRecord(plain) || typeof r.payload !== "string" || r.payload.length > 2 * 1024 * 1024 || !cipherPattern.test(r.payload))
+    if (!validRecord(plain) || typeof r.payload !== "string" || r.payload.length > maxPayload)
       invalid();
+    if (plain.isDeleted && r.payload === "")
+      return { record: plain, version: value.version, serverUpdatedAt: value.server_updated_at };
+    if (!cipherPattern.test(r.payload)) invalid();
     const envelope = JSON.parse(await decrypt(r.payload));
     if (!object(envelope) || envelope.schema !== 1 || envelope.account_id !== accountId || envelope.key_id !== keyId || !validRecord(envelope.record) || !sameMetadata(plain, envelope.record))
       invalid();
@@ -1875,30 +1944,46 @@ async function createRemoteChatStore(options) {
       serverUpdatedAt: value.server_updated_at
     };
   };
-  const putMany = async (writes, signal) => {
-    if (!Array.isArray(writes) || writes.length < 1 || writes.length > 25) invalid();
+  const seal = async (record2, signal) => {
+    if (record2.isDeleted) return "";
+    const payload = await encrypt(
+      JSON.stringify({ schema: 1, account_id: accountId, key_id: keyId, record: record2 })
+    );
+    signal?.throwIfAborted();
+    if (!cipherPattern.test(payload) || payload.length > maxPayload) invalid();
+    return payload;
+  };
+  const capture = (items, max, signal) => {
+    if (!Array.isArray(items) || items.length < 1 || items.length > max) invalid();
     const seen = /* @__PURE__ */ new Set();
-    const captured = writes.map((write) => {
+    let chunks = 0;
+    return items.map((item) => {
       signal?.throwIfAborted();
-      if (!validRecord(write.record) || !integer(write.expectedVersion)) invalid();
-      const record2 = JSON.parse(JSON.stringify(write.record));
-      const recordKey = `${record2.kind}/${record2.id}`;
+      if (!validRecord(item.record) || !embeddings(item)) invalid();
+      chunks += item.embeddings?.length ?? 0;
+      if (chunks > maxChunksPerRequest) invalid();
+      const copy = JSON.parse(JSON.stringify(item));
+      const recordKey = `${copy.record.kind}/${copy.record.id}`;
       if (seen.has(recordKey)) invalid();
       seen.add(recordKey);
-      return { record: record2, expectedVersion: write.expectedVersion };
+      return copy;
     });
+  };
+  const putMany = async (writes, signal) => {
+    if (Array.isArray(writes) && writes.some((w) => !integer(w.expectedVersion)))
+      invalid();
+    const captured = capture(writes, 25, signal);
     let bytes = 0;
     const prepared = [];
     for (const write of captured) {
-      const record2 = write.record;
-      const payload = await encrypt(
-        JSON.stringify({ schema: 1, account_id: accountId, key_id: keyId, record: record2 })
-      );
-      signal?.throwIfAborted();
-      if (!cipherPattern.test(payload) || payload.length > 2 * 1024 * 1024) invalid();
+      const payload = await seal(write.record, signal);
       bytes += payload.length;
-      if (bytes > 8 * 1024 * 1024) invalid();
-      prepared.push({ record: wire(record2, payload), expected_version: write.expectedVersion });
+      if (bytes > maxRequestCiphertext) invalid();
+      prepared.push({
+        record: wire(write.record, payload),
+        expected_version: write.expectedVersion,
+        ...vectorFields(write)
+      });
     }
     const result = await request(
       "/records/batch",
@@ -1913,7 +1998,8 @@ async function createRemoteChatStore(options) {
     const out = [];
     for (let i = 0; i < result.items.length; i++) {
       const value = result.items[i];
-      if (!object(value) || value.version !== prepared[i].expected_version + 1 || !object(value.record) || value.record.payload !== prepared[i].record.payload)
+      const deleted = prepared[i].record.is_deleted;
+      if (!object(value) || !object(value.record) || value.record.kind !== prepared[i].record.kind || value.record.id !== prepared[i].record.id || value.record.payload !== prepared[i].record.payload || (deleted ? value.record.is_deleted !== true || !integer(value.version, 1) : value.version !== prepared[i].expected_version + 1))
         invalid();
       out.push(await decode(value));
     }
@@ -1942,7 +2028,7 @@ async function createRemoteChatStore(options) {
     async list(query) {
       const limit = query.limit ?? 20;
       const parent = query.conversationId ?? "";
-      if (!kinds.has(query.kind) || !integer(limit, 1) || query.includeDeleted !== void 0 && typeof query.includeDeleted !== "boolean" || limit > 50 || (query.cursor?.length ?? 0) > 2048 || (query.kind === "conversation" || query.kind === "project" ? parent !== "" : !id(parent)))
+      if (!kinds.has(query.kind) || !integer(limit, 1) || query.includeDeleted !== void 0 && typeof query.includeDeleted !== "boolean" || limit > (query.kind === "message" ? 200 : 50) || (query.cursor?.length ?? 0) > 2048 || (query.kind === "conversation" || query.kind === "project" ? parent !== "" : !id(parent)))
         invalid();
       const params = new URLSearchParams({
         account_id: String(accountId),
@@ -1953,7 +2039,7 @@ async function createRemoteChatStore(options) {
       });
       if (query.cursor) params.set("cursor", query.cursor);
       const value = await request(`/records?${params}`, {}, query.signal);
-      if (!object(value) || !Array.isArray(value.items) || value.items.length > limit || value.next_cursor !== void 0 && (typeof value.next_cursor !== "string" || value.next_cursor.length > 2048))
+      if (!object(value) || !Array.isArray(value.items) || value.items.length > limit || value.next_cursor !== void 0 && (typeof value.next_cursor !== "string" || value.next_cursor.length > 2048) || value.total !== void 0 && !integer(value.total))
         invalid();
       const items = [];
       for (const item of value.items) {
@@ -1963,11 +2049,258 @@ async function createRemoteChatStore(options) {
         items.push(result);
       }
       query.signal?.throwIfAborted();
-      return { items, ...value.next_cursor ? { nextCursor: value.next_cursor } : {} };
+      return {
+        items,
+        ...value.next_cursor ? { nextCursor: value.next_cursor } : {},
+        ...value.total !== void 0 ? { total: value.total } : {}
+      };
+    },
+    putMany,
+    async getMany(refs, signal) {
+      if (!Array.isArray(refs)) invalid();
+      const wanted = /* @__PURE__ */ new Map();
+      for (const r of refs) {
+        const checked = ref(r);
+        wanted.set(`${checked.kind}/${checked.id}`, checked);
+      }
+      const found = /* @__PURE__ */ new Map();
+      let pending = [...wanted.values()];
+      while (pending.length > 0) {
+        const batch = pending.slice(0, maxGetRefs);
+        pending = pending.slice(maxGetRefs);
+        const value = await request(
+          "/records/get",
+          { method: "POST", body: JSON.stringify({ account_id: accountId, refs: batch }) },
+          signal
+        );
+        if (!object(value) || !Array.isArray(value.items) || value.remaining !== void 0 && !Array.isArray(value.remaining))
+          invalid();
+        const asked = new Set(batch.map((r) => `${r.kind}/${r.id}`));
+        for (const item of value.items) {
+          const snapshot = await decode(item);
+          const key = `${snapshot.record.kind}/${snapshot.record.id}`;
+          if (!asked.has(key) || found.has(key)) invalid();
+          found.set(key, snapshot);
+        }
+        const remaining = (value.remaining ?? []).map(ref);
+        if (remaining.some((r) => !asked.has(`${r.kind}/${r.id}`) || found.has(`${r.kind}/${r.id}`)))
+          invalid();
+        if (remaining.length > 0 && value.items.length === 0) invalid();
+        pending = [...remaining, ...pending];
+      }
+      signal?.throwIfAborted();
+      return [...wanted.keys()].flatMap((key) => {
+        const snapshot = found.get(key);
+        return snapshot ? [snapshot] : [];
+      });
+    },
+    async account(signal) {
+      const value = await request("/account", {}, signal);
+      if (!object(value) || value.account_id !== accountId || !text2(value.key_id) || value.state !== "none" && value.state !== "migrating" && value.state !== "active" || !integer(value.record_count) || !integer(value.storage_bytes) || !integer(value.vector_count))
+        invalid();
+      if (value.key_id && value.key_id !== keyId)
+        throw new ChatStoreError("Canonical chat key does not match", 409, "key_mismatch");
+      const out = {
+        keyId: value.key_id,
+        state: value.state,
+        recordCount: value.record_count,
+        storageBytes: value.storage_bytes,
+        vectorCount: value.vector_count
+      };
+      return out;
+    },
+    async importRecords(records, signal) {
+      const captured = capture(records, maxImportRecords, signal);
+      let bytes = 0;
+      const prepared = [];
+      for (const item of captured) {
+        const payload = await seal(item.record, signal);
+        bytes += payload.length;
+        if (bytes > maxRequestCiphertext) invalid();
+        prepared.push({ record: wire(item.record, payload), ...vectorFields(item) });
+      }
+      const value = await request(
+        "/import",
+        {
+          method: "POST",
+          body: JSON.stringify({ account_id: accountId, key_id: keyId, records: prepared })
+        },
+        signal
+      );
+      if (!object(value) || !integer(value.written) || value.written > prepared.length) invalid();
+      return value.written;
+    },
+    async verify(revisions, signal) {
+      if (!Array.isArray(revisions) || revisions.length > maxVerifyRevisions) invalid();
+      const asked = /* @__PURE__ */ new Set();
+      const wireRevisions = revisions.map((r) => {
+        const checked = ref(r);
+        if (!integer(r.updatedAt, 1) || typeof r.isDeleted !== "boolean") invalid();
+        asked.add(`${checked.kind}/${checked.id}`);
+        return {
+          kind: checked.kind,
+          id: checked.id,
+          updated_at: r.updatedAt,
+          is_deleted: r.isDeleted
+        };
+      });
+      if (wireRevisions.length === 0) return [];
+      const value = await request(
+        "/verify",
+        {
+          method: "POST",
+          body: JSON.stringify({ account_id: accountId, revisions: wireRevisions })
+        },
+        signal
+      );
+      if (!object(value) || !Array.isArray(value.missing)) invalid();
+      const missing = value.missing.map(ref);
+      if (missing.some((r) => !asked.has(`${r.kind}/${r.id}`))) invalid();
+      return missing;
+    },
+    async activate(signal) {
+      const value = await request(
+        "/account",
+        { method: "PUT", body: JSON.stringify({ account_id: accountId, state: "active" }) },
+        signal
+      );
+      if (!object(value) || value.state !== "active" || typeof value.transitioned !== "boolean")
+        invalid();
+      return value.transitioned;
+    },
+    async changes(cursor, options2) {
+      const limit = options2?.limit ?? 100;
+      if (!integer(limit, 1) || limit > 200 || cursor !== void 0 && (!text2(cursor) || cursor.length > 2048))
+        invalid();
+      const params = new URLSearchParams({ account_id: String(accountId), limit: String(limit) });
+      if (cursor) params.set("cursor", cursor);
+      const value = await request(`/changes?${params}`, {}, options2?.signal);
+      if (!object(value) || !Array.isArray(value.items) || value.items.length > limit || value.next_cursor !== void 0 && !text2(value.next_cursor) || value.changes_cursor !== void 0 && !text2(value.changes_cursor))
+        invalid();
+      const items = [];
+      for (const item of value.items) items.push(await decode(item));
+      options2?.signal?.throwIfAborted();
+      return {
+        items,
+        ...value.next_cursor ? { nextCursor: value.next_cursor } : {},
+        changesCursor: value.changes_cursor ?? cursor ?? ""
+      };
+    },
+    async search(embedding, options2) {
+      const limit = options2?.limit ?? 20;
+      const kindsFilter = options2?.kinds;
+      if (!Array.isArray(embedding) || !embeddings({
+        record: { ...emptyMessage, isDeleted: false },
+        embeddings: [embedding]
+      }) || !integer(limit, 1) || limit > 50 || kindsFilter !== void 0 && (!Array.isArray(kindsFilter) || kindsFilter.length === 0 || kindsFilter.some((k) => k !== "message" && k !== "summary")) || options2?.conversationId !== void 0 && !id(options2.conversationId))
+        invalid();
+      const value = await request(
+        "/search",
+        {
+          method: "POST",
+          body: JSON.stringify({
+            account_id: accountId,
+            embedding: embedding.slice(0, storedDims),
+            limit,
+            ...kindsFilter ? { kinds: kindsFilter } : {},
+            ...options2?.conversationId ? { conversation_id: options2.conversationId } : {}
+          })
+        },
+        options2?.signal
+      );
+      if (!object(value) || !Array.isArray(value.items) || value.items.length > limit) invalid();
+      const hits = [];
+      for (const item of value.items) {
+        if (!object(item) || !integer(item.chunk) || typeof item.score !== "number" || !Number.isFinite(item.score))
+          invalid();
+        const snapshot = await decode(item);
+        if (snapshot.record.isDeleted || kindsFilter !== void 0 && !kindsFilter.includes(snapshot.record.kind) || snapshot.record.kind !== "message" && snapshot.record.kind !== "summary" || options2?.conversationId !== void 0 && snapshot.record.conversationId !== options2.conversationId)
+          invalid();
+        hits.push({ ...snapshot, chunk: item.chunk, score: item.score });
+      }
+      options2?.signal?.throwIfAborted();
+      return hits;
+    },
+    async deleteAll(signal) {
+      const value = await request(`/records?account_id=${accountId}`, { method: "DELETE" }, signal);
+      if (!object(value) || !integer(value.deleted)) invalid();
+      return value.deleted;
     },
-    putMany
+    attachments: {
+      async create(sizeBytes, signal) {
+        if (!integer(sizeBytes, 1) || sizeBytes > maxAttachmentBytes) invalid();
+        const value = await request(
+          "/attachments",
+          {
+            method: "POST",
+            body: JSON.stringify({ account_id: accountId, size_bytes: sizeBytes })
+          },
+          signal
+        );
+        if (!object(value)) invalid();
+        const created = attachment(value.attachment);
+        if (created.sizeBytes !== sizeBytes || created.state !== "pending") invalid();
+        return { attachment: created, upload: presigned(value.upload) };
+      },
+      async commit(attachmentId, owner, signal) {
+        if (!attachmentIdPattern.test(attachmentId) || !object(owner) || owner.kind !== "message" && owner.kind !== "summary" || !id(owner.id))
+          invalid();
+        const value = await request(
+          `/attachments/${attachmentId}/commit`,
+          {
+            method: "POST",
+            body: JSON.stringify({
+              account_id: accountId,
+              owner_kind: owner.kind,
+              owner_id: owner.id
+            })
+          },
+          signal
+        );
+        if (!object(value)) invalid();
+        const committed = attachment(value.attachment);
+        if (committed.id !== attachmentId || committed.state !== "committed" || committed.ownerKind !== owner.kind || committed.ownerId !== owner.id)
+          invalid();
+        return committed;
+      },
+      async get(attachmentId, signal) {
+        if (!attachmentIdPattern.test(attachmentId)) invalid();
+        let value;
+        try {
+          value = await request(`/attachments/${attachmentId}?account_id=${accountId}`, {}, signal);
+        } catch (error) {
+          if (error instanceof ChatStoreError && error.status === 404) return null;
+          throw error;
+        }
+        if (!object(value)) invalid();
+        const found = attachment(value.attachment);
+        if (found.id !== attachmentId) invalid();
+        return {
+          attachment: found,
+          ...value.download !== void 0 ? { download: presigned(value.download) } : {}
+        };
+      },
+      async delete(attachmentId, signal) {
+        if (!attachmentIdPattern.test(attachmentId)) invalid();
+        await request(
+          `/attachments/${attachmentId}?account_id=${accountId}`,
+          { method: "DELETE" },
+          signal
+        );
+      }
+    }
   };
 }
+var emptyMessage = {
+  kind: "message",
+  id: "query",
+  conversationId: "query",
+  sortKey: 0,
+  createdAt: 1,
+  updatedAt: 1,
+  isDeleted: false,
+  data: {}
+};
 
 // src/lib/db/chat/lazyDecrypt.ts
 var LRU_CAPACITY = 256;
@@ -2081,19 +2414,19 @@ function base64ToUint8Array(base64) {
 // src/lib/memoryEngine/vectorEncoding.ts
 var BYTES_PER_FLOAT32 = 4;
 var CANONICAL_BASE64 = /^[A-Za-z0-9+/]+={0,2}$/;
-function encodeChunkVector(vector) {
-  const f32 = vector instanceof Float32Array ? vector : Float32Array.from(vector);
+function encodeChunkVector(vector2) {
+  const f32 = vector2 instanceof Float32Array ? vector2 : Float32Array.from(vector2);
   return uint8ArrayToBase64(new Uint8Array(f32.buffer, f32.byteOffset, f32.byteLength));
 }
-function decodeChunkVector(vector, onMalformed) {
-  if (!vector || vector.length === 0) return new Float32Array(0);
-  if (typeof vector !== "string") return Float32Array.from(vector);
-  if (vector.length % 4 !== 0 || !CANONICAL_BASE64.test(vector)) {
+function decodeChunkVector(vector2, onMalformed) {
+  if (!vector2 || vector2.length === 0) return new Float32Array(0);
+  if (typeof vector2 !== "string") return Float32Array.from(vector2);
+  if (vector2.length % 4 !== 0 || !CANONICAL_BASE64.test(vector2)) {
     onMalformed?.();
     return new Float32Array(0);
   }
   try {
-    const bytes = base64ToUint8Array(vector);
+    const bytes = base64ToUint8Array(vector2);
     if (bytes.byteLength === 0 || bytes.byteLength % BYTES_PER_FLOAT32 !== 0) {
       onMalformed?.();
       return new Float32Array(0);
@@ -2109,49 +2442,49 @@ function decodeChunkVector(vector, onMalformed) {
 var DEFAULT_CHUNK_SIZE = 400;
 var DEFAULT_CHUNK_OVERLAP = 50;
 var DEFAULT_MIN_CHUNK_SIZE = 50;
-function splitIntoSentences(text2) {
+function splitIntoSentences(text3) {
   const sentenceRegex = /[.!?]+[\s"')}\]]*(?=\s|$)/g;
   const sentences = [];
   let lastIndex = 0;
   let match;
-  while ((match = sentenceRegex.exec(text2)) !== null) {
+  while ((match = sentenceRegex.exec(text3)) !== null) {
     const endIndex = match.index + match[0].length;
-    const sentence = text2.slice(lastIndex, endIndex).trim();
+    const sentence = text3.slice(lastIndex, endIndex).trim();
     if (sentence) {
       sentences.push(sentence);
     }
     lastIndex = endIndex;
   }
-  const remaining = text2.slice(lastIndex).trim();
+  const remaining = text3.slice(lastIndex).trim();
   if (remaining) {
     sentences.push(remaining);
   }
   return sentences;
 }
-function chunkText(text2, options) {
+function chunkText(text3, options) {
   const {
     chunkSize = DEFAULT_CHUNK_SIZE,
     chunkOverlap: requestedOverlap = DEFAULT_CHUNK_OVERLAP,
     minChunkSize = DEFAULT_MIN_CHUNK_SIZE
   } = options ?? {};
   const chunkOverlap = Math.min(requestedOverlap, chunkSize - 1);
-  if (text2.length <= chunkSize) {
+  if (text3.length <= chunkSize) {
     return [
       {
-        text: text2.trim(),
+        text: text3.trim(),
         startOffset: 0,
-        endOffset: text2.length
+        endOffset: text3.length
       }
     ];
   }
-  const sentences = splitIntoSentences(text2);
+  const sentences = splitIntoSentences(text3);
   const chunks = [];
   let currentChunkSentences = [];
   let currentChunkStart = 0;
   let currentOffset = 0;
   for (let i = 0; i < sentences.length; i++) {
     const sentence = sentences[i];
-    let sentenceStart = text2.indexOf(sentence, currentOffset);
+    let sentenceStart = text3.indexOf(sentence, currentOffset);
     if (sentenceStart === -1) {
       sentenceStart = currentOffset;
     }
@@ -2198,7 +2531,7 @@ function chunkText(text2, options) {
       if (overlapSentences.length > 0) {
         currentChunkSentences = [...overlapSentences, sentence];
         const overlapText = overlapSentences[0];
-        const overlapStart = text2.lastIndexOf(overlapText, currentOffset);
+        const overlapStart = text3.lastIndexOf(overlapText, currentOffset);
         currentChunkStart = overlapStart === -1 ? sentenceStart : overlapStart;
       } else {
         currentChunkSentences = [sentence];
@@ -2218,18 +2551,18 @@ function chunkText(text2, options) {
       chunks.push({
         text: chunkText2,
         startOffset: currentChunkStart,
-        endOffset: text2.length
+        endOffset: text3.length
       });
     }
   }
   if (chunks.length === 0) {
-    const trimmedText = text2.trim();
+    const trimmedText = text3.trim();
     if (trimmedText.length > 0) {
       return [
         {
           text: trimmedText,
           startOffset: 0,
-          endOffset: text2.length
+          endOffset: text3.length
         }
       ];
     }
@@ -2342,22 +2675,22 @@ 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(text2, options) {
+async function generateEmbedding(text3, options) {
   const total = options.totalTimeoutMs;
-  if (total === void 0) return embedOne(text2, options, void 0);
-  return withDeadline((signal) => embedOne(text2, options, signal), total, "embedding");
+  if (total === void 0) return embedOne(text3, options, void 0);
+  return withDeadline((signal) => embedOne(text3, options, signal), total, "embedding");
 }
 var { inFlightByCache, cachedEmbeddingModels } = getEmbeddingCacheState();
-async function embedOne(text2, options, outer) {
+async function embedOne(text3, options, outer) {
   const { cache } = options;
-  if (!cache) return Array.from(await requestEmbedding(text2, options, outer));
+  if (!cache) return Array.from(await requestEmbedding(text3, options, outer));
   const model = options.model ?? DEFAULT_API_EMBEDDING_MODEL;
-  const cached = cache.get(text2);
+  const cached = cache.get(text3);
   const cachedModel = cached && cachedEmbeddingModels.get(cached);
   if (cached && (cachedModel === void 0 || cachedModel === model)) return Array.from(cached);
   const inFlight = inFlightByCache.get(cache) ?? /* @__PURE__ */ new Map();
   inFlightByCache.set(cache, inFlight);
-  const requestKey = JSON.stringify([model, text2]);
+  const requestKey = JSON.stringify([model, text3]);
   const pending = inFlight.get(requestKey);
   if (pending) {
     try {
@@ -2366,18 +2699,18 @@ async function embedOne(text2, options, outer) {
       if (outer?.aborted) throw err;
     }
   }
-  const request = requestEmbedding(text2, options, outer);
+  const request = requestEmbedding(text3, options, outer);
   inFlight.set(requestKey, request);
   try {
     const embedding = await request;
     cachedEmbeddingModels.set(embedding, model);
-    cache.set(text2, embedding);
+    cache.set(text3, embedding);
     return Array.from(embedding);
   } finally {
     if (inFlight.get(requestKey) === request) inFlight.delete(requestKey);
   }
 }
-async function requestEmbedding(text2, options, outer) {
+async function requestEmbedding(text3, options, outer) {
   const { baseUrl = BASE_URL, model } = options;
   const timeoutMs = options.timeoutMs ?? DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS;
   const headers = {
@@ -2389,7 +2722,7 @@ async function requestEmbedding(text2, options, outer) {
       (signal) => postApiV1Embeddings({
         baseUrl,
         body: {
-          input: options.maskInput ? options.maskInput(text2) : text2,
+          input: options.maskInput ? options.maskInput(text3) : text3,
           model: model ?? DEFAULT_API_EMBEDDING_MODEL
         },
         headers,
@@ -2628,9 +2961,9 @@ function extractUserMessages(messages, maxCount, documentPattern) {
   }
   return result.reverse();
 }
-function truncateAtWordBoundary(text2, maxLength) {
-  if (text2.length <= maxLength) return text2;
-  const truncated = text2.slice(0, maxLength);
+function truncateAtWordBoundary(text3, maxLength) {
+  if (text3.length <= maxLength) return text3;
+  const truncated = text3.slice(0, maxLength);
   const lastSpace = truncated.lastIndexOf(" ");
   return lastSpace > maxLength * 0.5 ? truncated.slice(0, lastSpace) : truncated;
 }
@@ -2755,12 +3088,12 @@ function buildSystemPrompt(ctx, options) {
   let prompt = "";
   const activeSections = [];
   for (const section of sections) {
-    const text2 = section.render(ctx);
-    if (text2 === null) continue;
-    if (maxLength > 0 && prompt.length + text2.length > maxLength) {
+    const text3 = section.render(ctx);
+    if (text3 === null) continue;
+    if (maxLength > 0 && prompt.length + text3.length > maxLength) {
       continue;
     }
-    prompt += text2;
+    prompt += text3;
     activeSections.push(section.key);
   }
   return { prompt, activeSections };
@@ -2967,15 +3300,15 @@ var PiiRedactor = class {
    * (sequential, per-pattern) and the async {@link collectRegexSpans} (span)
    * paths so the detection rules live in exactly one place.
    */
-  findMatches(text2, pattern) {
+  findMatches(text3, pattern) {
     const regex = new RegExp(pattern.regex.source, pattern.regex.flags);
     const found = [];
     let m;
-    while ((m = regex.exec(text2)) !== null) {
+    while ((m = regex.exec(text3)) !== null) {
       const value = m[0];
       if (pattern.validate && !pattern.validate(value)) continue;
       if (pattern.context) {
-        const before = text2.slice(Math.max(0, m.index - 40), m.index);
+        const before = text3.slice(Math.max(0, m.index - 40), m.index);
         if (!pattern.context.test(before)) continue;
       }
       found.push({ match: value, index: m.index });
@@ -2991,9 +3324,9 @@ var PiiRedactor = class {
    * earlier patterns, so an earlier (more specific) pattern claims a region
    * before a later one can — placeholders are inert and match no pattern.
    */
-  scan(text2, makeReplacement) {
+  scan(text3, makeReplacement) {
     const matches = [];
-    let redacted = text2;
+    let redacted = text3;
     for (const pattern of this.patterns) {
       const found = this.findMatches(redacted, pattern);
       if (found.length === 0) continue;
@@ -3014,8 +3347,8 @@ var PiiRedactor = class {
    * Scan and redact PII from a single text string, using numbered, reversible
    * placeholders ([EMAIL_1], …) tracked on this instance.
    */
-  redactText(text2) {
-    return this.scan(text2, (category, value) => this.getPlaceholder(category, value));
+  redactText(text3) {
+    return this.scan(text3, (category, value) => this.getPlaceholder(category, value));
   }
   /**
    * Mask PII with unnumbered, NON-reversible tokens ([EMAIL], [SSN], …) without
@@ -3024,15 +3357,15 @@ var PiiRedactor = class {
    * embeddings endpoint while staying deterministic, so the same content always
    * masks identically and search stays consistent across conversations.
    */
-  maskText(text2) {
-    return this.scan(text2, (category) => `[${category}]`).text;
+  maskText(text3) {
+    return this.scan(text3, (category) => `[${category}]`).text;
   }
   /** All regex matches as spans on the ORIGINAL text (priority 0). Uses the
    *  same {@link findMatches} guards as the sync scan. */
-  collectRegexSpans(text2) {
+  collectRegexSpans(text3) {
     const spans = [];
     this.patterns.forEach((pattern, patternIndex) => {
-      for (const { match, index } of this.findMatches(text2, pattern)) {
+      for (const { match, index } of this.findMatches(text3, pattern)) {
         spans.push({
           start: index,
           end: index + match.length,
@@ -3051,16 +3384,16 @@ var PiiRedactor = class {
    * of "Stripe") from producing a corrupting partial placeholder like
    * `[ORG_1]e`.
    */
-  normalizeNerSpans(text2, raw) {
+  normalizeNerSpans(text3, raw) {
     if (!Array.isArray(raw)) return [];
     const out = [];
     raw.forEach((s, i) => {
       if (!Number.isFinite(s.start) || !Number.isFinite(s.end)) return;
-      let start = Math.max(0, Math.min(Math.trunc(s.start), text2.length));
-      let end = Math.max(0, Math.min(Math.trunc(s.end), text2.length));
+      let start = Math.max(0, Math.min(Math.trunc(s.start), text3.length));
+      let end = Math.max(0, Math.min(Math.trunc(s.end), text3.length));
       if (end <= start) return;
-      while (start > 0 && isWordChar(text2[start - 1])) start--;
-      while (end < text2.length && isWordChar(text2[end])) end++;
+      while (start > 0 && isWordChar(text3[start - 1])) start--;
+      while (end < text3.length && isWordChar(text3[end])) end++;
       const category = String(s.category ?? "").trim();
       if (!category) return;
       out.push({ start, end, category, priority: 1, order: i });
@@ -3069,10 +3402,10 @@ var PiiRedactor = class {
   }
   /** Run the configured detector defensively: failures degrade to regex-only
    *  (fail-open on detection, not on protection) with a one-time warning. */
-  async detectNerSpans(text2) {
+  async detectNerSpans(text3) {
     if (!this.nerDetector) return [];
     try {
-      return this.normalizeNerSpans(text2, await this.nerDetector.detect(text2));
+      return this.normalizeNerSpans(text3, await this.nerDetector.detect(text3));
     } catch (err) {
       this.warnNerFailure(err);
       return [];
@@ -3105,11 +3438,11 @@ var PiiRedactor = class {
    * in pattern then document order, matching the sync scan's numbering). The
    * string is then EMITTED in document order.
    */
-  rebuildSpans(text2, spans, makeReplacement) {
+  rebuildSpans(text3, spans, makeReplacement) {
     const placeholderByStart = /* @__PURE__ */ new Map();
     const matches = [];
     for (const s of spans) {
-      const value = text2.slice(s.start, s.end);
+      const value = text3.slice(s.start, s.end);
       const placeholder = makeReplacement(s.category, value);
       placeholderByStart.set(s.start, placeholder);
       matches.push({ category: s.category, original: value, placeholder });
@@ -3118,16 +3451,16 @@ var PiiRedactor = class {
     let result = "";
     let cursor = 0;
     for (const s of emitOrder) {
-      result += text2.slice(cursor, s.start) + (placeholderByStart.get(s.start) ?? "");
+      result += text3.slice(cursor, s.start) + (placeholderByStart.get(s.start) ?? "");
       cursor = s.end;
     }
-    result += text2.slice(cursor);
+    result += text3.slice(cursor);
     return { text: result, matches };
   }
   /** Merge regex + NER spans for `text` into a resolved, non-overlapping set. */
-  async detectAllSpans(text2) {
-    const nerPromise = this.detectNerSpans(text2);
-    const regexSpans = this.collectRegexSpans(text2);
+  async detectAllSpans(text3) {
+    const nerPromise = this.detectNerSpans(text3);
+    const regexSpans = this.collectRegexSpans(text3);
     const ner = await nerPromise;
     return this.resolveOverlaps([...regexSpans, ...ner]);
   }
@@ -3136,11 +3469,11 @@ var PiiRedactor = class {
    * unstructured PII (the configured {@link NerDetector}) with numbered,
    * reversible placeholders. With no detector, identical to `redactText`.
    */
-  async redactTextAsync(text2) {
-    if (!this.nerDetector) return this.redactText(text2);
-    const spans = await this.detectAllSpans(text2);
+  async redactTextAsync(text3) {
+    if (!this.nerDetector) return this.redactText(text3);
+    const spans = await this.detectAllSpans(text3);
     return this.rebuildSpans(
-      text2,
+      text3,
       spans,
       (category, value) => this.getPlaceholder(category, value)
     );
@@ -3149,10 +3482,10 @@ var PiiRedactor = class {
    * Async counterpart to {@link maskText}: stateless `[CATEGORY]` masking over
    * regex + NER matches. With no detector, identical to `maskText`.
    */
-  async maskTextAsync(text2) {
-    if (!this.nerDetector) return this.maskText(text2);
-    const spans = await this.detectAllSpans(text2);
-    return this.rebuildSpans(text2, spans, (category) => `[${category}]`).text;
+  async maskTextAsync(text3) {
+    if (!this.nerDetector) return this.maskText(text3);
+    const spans = await this.detectAllSpans(text3);
+    return this.rebuildSpans(text3, spans, (category) => `[${category}]`).text;
   }
   /**
    * Async counterpart to {@link redactMessages}. Text parts are redacted
@@ -3238,9 +3571,9 @@ var PiiRedactor = class {
    * {@link restoreForStorage} instead, which tolerates the mangled echoes the
    * extraction models produce.
    */
-  deAnonymize(text2) {
-    if (!text2.includes("[")) return text2;
-    let restored = text2;
+  deAnonymize(text3) {
+    if (!text3.includes("[")) return text3;
+    let restored = text3;
     for (const [placeholder, original] of this.placeholderToValue) {
       if (restored.includes(placeholder)) {
         restored = restored.split(placeholder).join(original);
@@ -3265,15 +3598,15 @@ var PiiRedactor = class {
    * - `unresolved` is derived from the lookup miss during this pass, not from a
    *   regex re-scan of the output — so it can't trip over a restored value.
    */
-  restoreForStorage(text2) {
+  restoreForStorage(text3) {
     if (this.storagePattern === void 0) this.storagePattern = this.buildStoragePattern();
     if (!this.storagePattern || this.placeholderToValue.size === 0) {
-      return { text: text2, unresolved: false };
+      return { text: text3, unresolved: false };
     }
     this.storageLookup ?? (this.storageLookup = this.buildStorageLookup());
     const { exact, ci, ciCollisions } = this.storageLookup;
     let unresolved = false;
-    const restored = text2.replace(
+    const restored = text3.replace(
       this.storagePattern,
       (match, bracketed, bare) => {
         const body = bracketed ?? bare ?? "";
@@ -3769,7 +4102,7 @@ function findMatchingTools(promptEmbeddings, tools, options) {
   if (!tools || tools.length === 0) {
     return [];
   }
-  const embeddings = Array.isArray(promptEmbeddings[0]) ? promptEmbeddings : [promptEmbeddings];
+  const embeddings2 = Array.isArray(promptEmbeddings[0]) ? promptEmbeddings : [promptEmbeddings];
   const results = [];
   for (const tool of tools) {
     if (!tool.embedding || tool.embedding.length === 0) {
@@ -3777,7 +4110,7 @@ function findMatchingTools(promptEmbeddings, tools, options) {
     }
     try {
       let maxSimilarity = -Infinity;
-      for (const embedding of embeddings) {
+      for (const embedding of embeddings2) {
         const similarity = cosineSimilarity(embedding, tool.embedding);
         if (similarity > maxSimilarity) {
           maxSimilarity = similarity;
@@ -3808,12 +4141,12 @@ function scoreTools(promptEmbeddings, tools) {
   const scores = /* @__PURE__ */ new Map();
   if (!promptEmbeddings || promptEmbeddings.length === 0) return scores;
   if (!tools || tools.length === 0) return scores;
-  const embeddings = Array.isArray(promptEmbeddings[0]) ? promptEmbeddings : [promptEmbeddings];
+  const embeddings2 = Array.isArray(promptEmbeddings[0]) ? promptEmbeddings : [promptEmbeddings];
   for (const tool of tools) {
     if (!tool.embedding || tool.embedding.length === 0) continue;
     let maxSimilarity = -Infinity;
     try {
-      for (const embedding of embeddings) {
+      for (const embedding of embeddings2) {
         const similarity = cosineSimilarity(embedding, tool.embedding);
         if (similarity > maxSimilarity) maxSimilarity = similarity;
       }
@@ -4035,13 +4368,13 @@ function createServerToolsFilter(options = {}) {
   const exclude = new Set(options.excludeTools ?? []);
   const sets = options.toolSets ?? [];
   const matchOpts = options.matchOptions;
-  const filter = (embeddings, tools) => {
-    const matches = findMatchingTools(embeddings, tools, matchOpts);
+  const filter = (embeddings2, tools) => {
+    const matches = findMatchingTools(embeddings2, tools, matchOpts);
     if (matches.length === 0) return [];
     const matchedNames = new Set(matches.map((m) => m.tool.name));
     let finalNames;
     if (sets.length > 0) {
-      const scores = scoreTools(embeddings, tools);
+      const scores = scoreTools(embeddings2, tools);
       const selectedScores = new Map(
         [...scores].filter(([name]) => matchedNames.has(name) && !exclude.has(name))
       );