@anvia/core 1.17.0 → 1.17.2

package/dist/skills/index.js

@@ -16,31 +16,32 @@ import "../chunk-JMJFK3A4.js";
 import "../chunk-BX52ILPM.js";
 import "../chunk-WACXVXGU.js";
 import "../chunk-4AW2633B.js";
-import "../chunk-ZQC5V2AM.js";
-import "../chunk-L2UPWQQZ.js";
+import "../chunk-NVCMX4KM.js";
+import "../chunk-HPN3GZ2E.js";
 import "../chunk-3FIX7GLM.js";
+import "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import "../chunk-CB2L2NIQ.js";
 import "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-Z5WMW4NP.js";
 import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   SkillValidationError,
   loadSkills,

package/dist/skills/load.js

@@ -8,31 +8,32 @@ import "../chunk-JMJFK3A4.js";
 import "../chunk-BX52ILPM.js";
 import "../chunk-WACXVXGU.js";
 import "../chunk-4AW2633B.js";
-import "../chunk-ZQC5V2AM.js";
-import "../chunk-L2UPWQQZ.js";
+import "../chunk-NVCMX4KM.js";
+import "../chunk-HPN3GZ2E.js";
 import "../chunk-3FIX7GLM.js";
+import "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import "../chunk-CB2L2NIQ.js";
 import "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-Z5WMW4NP.js";
 import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   loadSkills
 };

package/dist/skills/tools.js

@@ -6,31 +6,32 @@ import "../chunk-JMJFK3A4.js";
 import "../chunk-BX52ILPM.js";
 import "../chunk-WACXVXGU.js";
 import "../chunk-4AW2633B.js";
-import "../chunk-ZQC5V2AM.js";
-import "../chunk-L2UPWQQZ.js";
+import "../chunk-NVCMX4KM.js";
+import "../chunk-HPN3GZ2E.js";
 import "../chunk-3FIX7GLM.js";
+import "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import "../chunk-CB2L2NIQ.js";
 import "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-Z5WMW4NP.js";
 import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   createSkillTools
 };

package/dist/tool/create-tool.js

@@ -5,9 +5,9 @@ import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 export {
   createTool
 };

package/dist/tool/dynamic-tools.js

@@ -2,31 +2,32 @@ import {
   createToolIndex,
   embedTools,
   isToolIndex
-} from "../chunk-ZQC5V2AM.js";
-import "../chunk-L2UPWQQZ.js";
+} from "../chunk-NVCMX4KM.js";
+import "../chunk-HPN3GZ2E.js";
 import "../chunk-3FIX7GLM.js";
+import "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import "../chunk-CB2L2NIQ.js";
 import "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-Z5WMW4NP.js";
 import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   createToolIndex,
   embedTools,

package/dist/tool/index.js

@@ -15,17 +15,21 @@ import {
   createToolIndex,
   embedTools,
   isToolIndex
-} from "../chunk-ZQC5V2AM.js";
-import "../chunk-L2UPWQQZ.js";
+} from "../chunk-NVCMX4KM.js";
+import "../chunk-HPN3GZ2E.js";
 import "../chunk-3FIX7GLM.js";
+import "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import "../chunk-CB2L2NIQ.js";
 import "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import {
   createTool
@@ -44,14 +48,11 @@ import {
   ToolJsonError,
   ToolNotFoundError
 } from "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   DEFAULT_QUESTION_TOOL_DESCRIPTION,
   DEFAULT_QUESTION_TOOL_NAME,

package/dist/tool/question-tool.js

@@ -9,9 +9,9 @@ import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 export {
   DEFAULT_QUESTION_TOOL_DESCRIPTION,
   DEFAULT_QUESTION_TOOL_NAME,

package/dist/tool/think-tool.js

@@ -6,9 +6,9 @@ import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 export {
   createThinkTool
 };

package/dist/vector-store/index.d.ts

@@ -39,6 +39,25 @@ type IngestVectorDocumentsResult<Metadata extends VectorMetadata = VectorMetadat
 declare function ingestVectorText<Metadata extends VectorMetadata = VectorMetadata>(options: IngestVectorTextOptions<Metadata>): Promise<IngestVectorDocumentsResult<Metadata>>;
 declare function ingestVectorDocuments<Metadata extends VectorMetadata = VectorMetadata>(options: IngestVectorDocumentsOptions<Metadata>): Promise<IngestVectorDocumentsResult<Metadata>>;
 
+/**
+ * Error thrown when a vector-store inspect cursor cannot be parsed.
+ *
+ * Extends `RangeError` (so existing `RangeError` handling keeps working) with
+ * a stable `name` hosts can use to map invalid cursors to a client error
+ * without matching on the message or catching unrelated `RangeError`s.
+ */
+declare class VectorInspectCursorError extends RangeError {
+    constructor(cursor: string);
+    /**
+     * Identify an invalid-cursor failure without matching on the message, so
+     * unrelated `RangeError`s are never mistaken for one. Uses a structural
+     * check (rather than `instanceof`) so it also works across duplicated
+     * module instances.
+     */
+    static isCursorError(error: unknown): error is VectorInspectCursorError;
+}
+declare function parseVectorInspectCursor(cursor: string | undefined): number;
+
 declare function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(options: RetrieveDocumentsOptions<T, Metadata>): Promise<Array<VectorSearchResult<T, Metadata>>>;
 declare function retrieveDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(options: RetrieveHybridDocumentsOptions<T, Metadata>): Promise<Array<VectorSearchResult<T, Metadata>>>;
 
@@ -93,4 +112,4 @@ declare function createVectorSearchTool<T, Metadata extends VectorMetadata>(opti
     topK?: number;
 }, Array<VectorSearchResult<T, Metadata>>>;
 
-export { InMemoryVectorStore, type InMemoryVectorStoreFromDocumentsOptions, type InMemoryVectorStoreOptions, IndexStrategy, type IngestVectorDocumentsOptions, type IngestVectorDocumentsResult, type IngestVectorTextOptions, RetrieveDocumentsOptions, RetrieveHybridDocumentsOptions, VectorFilter, VectorInspectPage, VectorInspectRequest, VectorMetric, VectorSearchRequest, VectorSearchResult, VectorSearchToolOptions, VectorStore, VectorStoreUpsertOptions, createVectorSearchTool, ingestVectorDocuments, ingestVectorText, matchesVectorFilter, retrieveDocuments, vectorFilter };
+export { InMemoryVectorStore, type InMemoryVectorStoreFromDocumentsOptions, type InMemoryVectorStoreOptions, IndexStrategy, type IngestVectorDocumentsOptions, type IngestVectorDocumentsResult, type IngestVectorTextOptions, RetrieveDocumentsOptions, RetrieveHybridDocumentsOptions, VectorFilter, VectorInspectCursorError, VectorInspectPage, VectorInspectRequest, VectorMetric, VectorSearchRequest, VectorSearchResult, VectorSearchToolOptions, VectorStore, VectorStoreUpsertOptions, createVectorSearchTool, ingestVectorDocuments, ingestVectorText, matchesVectorFilter, parseVectorInspectCursor, retrieveDocuments, vectorFilter };

package/dist/vector-store/index.js

@@ -1,11 +1,15 @@
 import {
   InMemoryVectorStore,
   createVectorSearchTool
-} from "../chunk-L2UPWQQZ.js";
+} from "../chunk-HPN3GZ2E.js";
 import {
   ingestVectorDocuments,
   ingestVectorText
 } from "../chunk-3FIX7GLM.js";
+import {
+  VectorInspectCursorError,
+  parseVectorInspectCursor
+} from "../chunk-6VVHLRUD.js";
 import "../chunk-ESOFEAYK.js";
 import {
   retrieveDocuments
@@ -15,30 +19,32 @@ import {
   vectorFilter
 } from "../chunk-2O3MLES7.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
+import "../chunk-KO5NMTAM.js";
+import "../chunk-TFIOU6UR.js";
+import "../chunk-GPVXCY5I.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-Z5WMW4NP.js";
 import "../chunk-6YYZ7VJQ.js";
 import "../chunk-YZVFIW5D.js";
 import "../chunk-TMSWHXYQ.js";
 import "../chunk-J6S6MT7O.js";
-import "../chunk-SQAAVYJG.js";
 import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
+import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
-import "../chunk-KO5NMTAM.js";
-import "../chunk-TFIOU6UR.js";
-import "../chunk-GPVXCY5I.js";
 export {
   InMemoryVectorStore,
+  VectorInspectCursorError,
   createVectorSearchTool,
   ingestVectorDocuments,
   ingestVectorText,
   matchesVectorFilter,
+  parseVectorInspectCursor,
   retrieveDocuments,
   vectorFilter
 };

package/dist/vector-store/ingest.js

@@ -3,15 +3,15 @@ import {
   ingestVectorText
 } from "../chunk-3FIX7GLM.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
-import "../chunk-POXHJF3H.js";
-import "../chunk-USRKPEQN.js";
 import "../chunk-KO5NMTAM.js";
 import "../chunk-TFIOU6UR.js";
 import "../chunk-GPVXCY5I.js";
+import "../chunk-POXHJF3H.js";
+import "../chunk-USRKPEQN.js";
 export {
   ingestVectorDocuments,
   ingestVectorText

package/dist/vector-store/inspect-cursor.js

@@ -0,0 +1,9 @@
+import {
+  VectorInspectCursorError,
+  parseVectorInspectCursor
+} from "../chunk-6VVHLRUD.js";
+export {
+  VectorInspectCursorError,
+  parseVectorInspectCursor
+};
+//# sourceMappingURL=inspect-cursor.js.map

package/dist/vector-store/inspect-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/vector-store/retrieve.js

@@ -2,10 +2,10 @@ import {
   retrieveDocuments
 } from "../chunk-CB2L2NIQ.js";
 import "../chunk-ERN7P6Q4.js";
+import "../chunk-7F53DOML.js";
 import "../chunk-YCTXTOOQ.js";
 import "../chunk-DU4WA6LQ.js";
 import "../chunk-4FIVU53H.js";
-import "../chunk-7F53DOML.js";
 import "../chunk-5V533R7F.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/core",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "Core runtime primitives for context-aware Anvia agents.",
   "author": "anvia",
   "license": "MIT",
@@ -122,7 +122,7 @@
   },
   "peerDependencies": {
     "@valibot/to-json-schema": "^1.8.0",
-    "zod": "^4.6.5"
+    "zod": "^4.6.7"
   },
   "peerDependenciesMeta": {
     "@valibot/to-json-schema": {
@@ -136,7 +136,7 @@
     "typescript": "^5.9.3",
     "valibot": "^1.5.0",
     "vitest": "^4.1.11",
-    "zod": "^4.6.5"
+    "zod": "^4.6.7"
   },
   "scripts": {
     "build": "tsup",

package/dist/chunk-L2UPWQQZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/vector-store/index.ts"],"sourcesContent":["import { z } from \"zod\";\nimport {\n  cosineSimilarity,\n  dotProduct,\n  type EmbeddedDocument,\n  type Embedding,\n  euclideanDistance,\n  type VectorMetadata,\n} from \"../embeddings\";\nimport { assertFiniteMinScore, assertPositiveSearchLimit } from \"../internal/vector-search-options\";\nimport { createTool } from \"../tool/create-tool\";\nimport type { Tool } from \"../tool/tool\";\nimport { matchesVectorFilter } from \"./filter\";\nimport { LshIndex } from \"./lsh\";\nimport { retrieveDocuments } from \"./retrieve\";\nimport type {\n  IndexStrategy,\n  VectorInspectItem,\n  VectorInspectPage,\n  VectorInspectRequest,\n  VectorMetric,\n  VectorSearchRequest,\n  VectorSearchResult,\n  VectorSearchToolOptions,\n  VectorStore,\n  VectorStoreUpsertOptions,\n} from \"./types\";\n\nexport { matchesVectorFilter, vectorFilter } from \"./filter\";\nexport * from \"./ingest\";\nexport { retrieveDocuments } from \"./retrieve\";\nexport type * from \"./types\";\n\nconst VECTOR_METRICS: ReadonlySet<VectorMetric> = new Set([\"cosine\", \"euclidean\", \"dotProduct\"]);\n\ntype StoredDocument<T, Metadata extends VectorMetadata> = EmbeddedDocument<T, Metadata>;\n\nexport type InMemoryVectorStoreOptions = {\n  dimensions?: number | undefined;\n  index?: IndexStrategy | undefined;\n  /**\n   * Similarity metric used to score documents. Defaults to `\"cosine\"`.\n   *\n   * Scores are always \"higher is better\": `\"cosine\"` returns cosine similarity,\n   * `\"dotProduct\"` returns the raw inner product, and `\"euclidean\"` returns the\n   * negated Euclidean distance (matching the pgvector, Chroma, LanceDB, and Milvus\n   * adapters), so the nearest document ranks first and `minScore` is a negative\n   * distance threshold.\n   *\n   * With an `{ type: \"lsh\" }` index, non-cosine metrics are approximate because LSH\n   * buckets are angle-based; `{ type: \"bruteForce\" }` (the default) is exact.\n   */\n  metric?: VectorMetric | undefined;\n};\n\nexport type InMemoryVectorStoreFromDocumentsOptions<\n  T,\n  Metadata extends VectorMetadata = VectorMetadata,\n> = InMemoryVectorStoreOptions & {\n  documents: Array<EmbeddedDocument<T, Metadata>>;\n};\n\nexport class InMemoryVectorStore<\n  T,\n  Metadata extends VectorMetadata = VectorMetadata,\n> implements VectorStore<T, Metadata> {\n  private readonly documents = new Map<string, StoredDocument<T, Metadata>>();\n  private readonly indexStrategy: IndexStrategy;\n  private readonly metric: VectorMetric;\n  private lshIndex: LshIndex | undefined;\n  private embeddingDimension: number | undefined;\n\n  constructor(options: InMemoryVectorStoreOptions = {}) {\n    this.indexStrategy = options.index ?? { type: \"bruteForce\" };\n    this.metric = options.metric ?? \"cosine\";\n    if (!VECTOR_METRICS.has(this.metric)) {\n      throw new TypeError(`Unsupported vector metric: ${String(this.metric)}`);\n    }\n    if (\n      options.dimensions !== undefined &&\n      (!Number.isSafeInteger(options.dimensions) || options.dimensions < 1)\n    ) {\n      throw new RangeError(\"Vector dimensions must be a positive safe integer.\");\n    }\n    this.embeddingDimension = options.dimensions;\n  }\n\n  static fromDocuments<T, Metadata extends VectorMetadata = VectorMetadata>(\n    options: InMemoryVectorStoreFromDocumentsOptions<T, Metadata>,\n  ): InMemoryVectorStore<T, Metadata> {\n    const store = new InMemoryVectorStore<T, Metadata>(options);\n    store.replaceDocuments(options.documents);\n    return store;\n  }\n\n  async ensure(): Promise<void> {}\n  async validate(): Promise<void> {}\n\n  async upsert(options: VectorStoreUpsertOptions<T, Metadata>): Promise<void> {\n    this.replaceDocuments(options.documents);\n  }\n\n  get(options: { id: string }): StoredDocument<T, Metadata> | undefined {\n    return this.documents.get(options.id);\n  }\n\n  values(): Array<StoredDocument<T, Metadata>> {\n    return [...this.documents.values()];\n  }\n\n  len(): number {\n    return this.documents.size;\n  }\n\n  isEmpty(): boolean {\n    return this.documents.size === 0;\n  }\n\n  async search(request: VectorSearchRequest): Promise<Array<VectorSearchResult<T, Metadata>>> {\n    throwIfAborted(request.abortSignal);\n    assertPositiveSearchLimit(request.topK);\n    assertFiniteMinScore(request.minScore);\n    const queryEmbedding: Embedding = { document: \"\", vector: request.vector };\n    const results = this.candidates(queryEmbedding)\n      .filter((document) => matchesVectorFilter(document.metadata, request.filter))\n      .flatMap((document) => {\n        const score = bestScore(queryEmbedding, document.embeddings, this.metric);\n        if (score === undefined || (request.minScore !== undefined && score < request.minScore)) {\n          return [];\n        }\n        let result: VectorSearchResult<T, Metadata> = {\n          score,\n          id: document.id,\n          document: document.document,\n        };\n        if (document.metadata !== undefined) {\n          result = { ...result, metadata: document.metadata };\n        }\n        return [result];\n      })\n      .sort((left, right) => right.score - left.score)\n      .slice(0, request.topK);\n    throwIfAborted(request.abortSignal);\n    return results;\n  }\n\n  async inspect(request: VectorInspectRequest): Promise<VectorInspectPage<T, Metadata>> {\n    throwIfAborted(request.abortSignal);\n    const limit = assertPositiveSearchLimit(request.limit);\n    const start = Math.max(0, Math.trunc(Number(request.cursor ?? \"0\")));\n    const documents = this.values().filter((document) =>\n      matchesVectorFilter(document.metadata, request.filter),\n    );\n    const page = documents.slice(start, start + limit);\n    const nextOffset = start + page.length;\n    const result: VectorInspectPage<T, Metadata> = {\n      items: page.map((document): VectorInspectItem<T, Metadata> => {\n        let item: VectorInspectItem<T, Metadata> = {\n          id: document.id,\n          document: document.document,\n        };\n        if (document.metadata !== undefined) {\n          item = { ...item, metadata: document.metadata };\n        }\n        return item;\n      }),\n      totalCount: documents.length,\n    };\n    if (nextOffset < documents.length) result.nextCursor = String(nextOffset);\n    throwIfAborted(request.abortSignal);\n    return result;\n  }\n\n  private replaceDocuments(documents: Array<EmbeddedDocument<T, Metadata>>): void {\n    const ids = new Set<string>();\n    for (const document of documents) {\n      if (ids.has(document.id)) throw new TypeError(`Duplicate vector document id: ${document.id}`);\n      ids.add(document.id);\n      if (document.embeddings.length === 0) {\n        throw new TypeError(`Vector document ${document.id} must contain at least one embedding.`);\n      }\n      for (const embedding of document.embeddings)\n        assertFiniteVector(embedding.vector, document.id);\n    }\n    this.validateDocumentDimensions(documents);\n    for (const document of documents) this.documents.set(document.id, document);\n    this.rebuildLshIndex();\n  }\n\n  private candidates(queryEmbedding: Embedding): Array<StoredDocument<T, Metadata>> {\n    this.validateQueryDimension(queryEmbedding);\n    if (this.indexStrategy.type !== \"lsh\" || this.lshIndex === undefined) return this.values();\n    const candidateIds = this.lshIndex.query(queryEmbedding.vector);\n    if (candidateIds.size === 0) return this.values();\n    return [...candidateIds].flatMap((id) => {\n      const document = this.documents.get(id);\n      return document === undefined ? [] : [document];\n    });\n  }\n\n  private rebuildLshIndex(): void {\n    if (this.indexStrategy.type !== \"lsh\") {\n      this.lshIndex = undefined;\n      return;\n    }\n    const firstEmbedding = this.values().flatMap((document) => document.embeddings)[0];\n    if (firstEmbedding === undefined) {\n      this.lshIndex = undefined;\n      return;\n    }\n    const index = new LshIndex(firstEmbedding.vector.length, this.indexStrategy);\n    for (const document of this.documents.values()) {\n      for (const embedding of document.embeddings) index.insert(document.id, embedding.vector);\n    }\n    this.lshIndex = index;\n  }\n\n  private validateDocumentDimensions(documents: Array<EmbeddedDocument<T, Metadata>>): void {\n    let dimension = this.embeddingDimension;\n    for (const document of documents) {\n      for (const embedding of document.embeddings) {\n        dimension = validateEmbeddingDimension(dimension, embedding, document.id);\n      }\n    }\n    this.embeddingDimension = dimension;\n  }\n\n  private validateQueryDimension(queryEmbedding: Embedding): void {\n    if (this.embeddingDimension !== undefined) {\n      validateEmbeddingDimension(this.embeddingDimension, queryEmbedding, \"query\");\n    }\n  }\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted) {\n    const error = new Error(\"The operation was aborted.\");\n    error.name = \"AbortError\";\n    throw error;\n  }\n}\n\nexport function createVectorSearchTool<T, Metadata extends VectorMetadata>(\n  options: VectorSearchToolOptions<T, Metadata>,\n): Tool<{ query: string; topK?: number }, Array<VectorSearchResult<T, Metadata>>> {\n  const configuredTopK = assertPositiveSearchLimit(options.topK ?? 5);\n  assertFiniteMinScore(options.minScore);\n  return createTool({\n    name: options.name,\n    description:\n      options.description ?? \"Search a vector store for documents relevant to the provided query.\",\n    inputSchema: z.object({\n      query: z.string().min(1).describe(\"The query string to search for relevant documents.\"),\n      topK: z.number().int().positive().optional().describe(\"The maximum number of results.\"),\n    }),\n    outputSchema: z.array(\n      z.object({\n        score: z.number(),\n        id: z.string(),\n        document: z.any(),\n        metadata: z\n          .record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))\n          .optional(),\n      }),\n    ),\n    execute: ({ query, topK }, context) => {\n      const request = {\n        query,\n        topK: topK ?? configuredTopK,\n        minScore: options.minScore,\n        filter: options.filter,\n        retries: options.retries,\n        abortSignal: context.abortSignal,\n      };\n      return \"models\" in options && options.models !== undefined\n        ? retrieveDocuments({\n            ...request,\n            store: options.store,\n            models: options.models,\n            fusion: options.fusion,\n          })\n        : retrieveDocuments({ ...request, store: options.store, model: options.model });\n    },\n  }) as Tool<{ query: string; topK?: number }, Array<VectorSearchResult<T, Metadata>>>;\n}\n\nfunction bestScore(\n  queryEmbedding: Embedding,\n  embeddings: Embedding[],\n  metric: VectorMetric,\n): number | undefined {\n  let best: number | undefined;\n  for (const embedding of embeddings) {\n    const score = metricScore(queryEmbedding.vector, embedding.vector, metric);\n    best = best === undefined ? score : Math.max(best, score);\n  }\n  return best;\n}\n\nfunction metricScore(left: number[], right: number[], metric: VectorMetric): number {\n  switch (metric) {\n    case \"euclidean\": {\n      const distance = euclideanDistance(left, right);\n      return distance === 0 ? 0 : -distance;\n    }\n    case \"dotProduct\":\n      return dotProduct(left, right);\n    default:\n      return cosineSimilarity(left, right);\n  }\n}\n\nfunction validateEmbeddingDimension(\n  expectedDimension: number | undefined,\n  embedding: Embedding,\n  id: string,\n): number {\n  assertFiniteVector(embedding.vector, id);\n  if (expectedDimension === undefined) return embedding.vector.length;\n  if (embedding.vector.length !== expectedDimension) {\n    throw new Error(\n      `Vector dimension mismatch: expected ${expectedDimension} dimensions but received ${embedding.vector.length} for ${id}`,\n    );\n  }\n  return expectedDimension;\n}\n\nfunction assertFiniteVector(vector: number[], id: string): void {\n  if (vector.length === 0) throw new TypeError(`Vector for ${id} must not be empty.`);\n  if (!vector.every(Number.isFinite)) {\n    throw new TypeError(`Vector for ${id} must contain only finite numbers.`);\n  }\n}\n"],"mappings":"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","names":[]}