@nhtio/adk 1.20260604.0 → 1.20260607.0

package/batteries/vector/weaviate.mjs

@@ -0,0 +1,322 @@
+import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
+import "../../guards.mjs";
+import { evaluateFilter, isFilterCondition, isFilterGroup, isRawFilter } from "./filters.mjs";
+import { normalizeScore } from "./helpers.mjs";
+import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
+import { BaseVectorStore } from "./contract.mjs";
+import { validateRecords } from "./validation.mjs";
+import { sha256 } from "js-sha256";
+//#region src/batteries/vector/weaviate/index.ts
+/**
+* @module @nhtio/adk/batteries/vector/weaviate
+*
+* @remarks
+* Weaviate-backed vector store adapter using the Weaviate v3 client with lazy driver
+* loading, deterministic object UUIDs, explicit vectors, and in-JS metadata filtering.
+*/
+/**
+* Compiles a neutral {@link VectorFilter} into a Weaviate v3 filter built from a collection's
+* `col.filter` builder (and `weaviate.Filters.and/or` for groups). Pure and dependency-injected
+* (takes the `col` handle and the `weaviate` module), so it is unit-testable with stubs.
+*
+* @throws {@link @nhtio/adk/batteries/vector/exceptions!E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR}
+*   for operators Weaviate cannot express (`nin`, group `not`) or a non-`weaviate` raw dialect.
+*/
+var translateWeaviateFilter = (col, weaviate, filter) => {
+	if (!filter) return void 0;
+	if (isRawFilter(filter)) {
+		if (filter.$dialect === "weaviate") return filter.$raw;
+		throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["weaviate", String(filter.$dialect)]);
+	}
+	if (isFilterCondition(filter)) {
+		const { field, op, value } = filter;
+		if (value === void 0 && op !== "exists") throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["weaviate", op]);
+		const f = col.filter.byProperty(field);
+		if (op === "eq") return f.equal(value);
+		if (op === "ne") return f.notEqual(value);
+		if (op === "gt") return f.greaterThan(value);
+		if (op === "gte") return f.greaterOrEqual(value);
+		if (op === "lt") return f.lessThan(value);
+		if (op === "lte") return f.lessOrEqual(value);
+		if (op === "in") return f.containsAny(value);
+		if (op === "nin") throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["weaviate", "nin"]);
+		if (op === "exists") return f.isNull(value === false);
+		if (op === "contains") return f.containsAny(Array.isArray(value) ? value : [value]);
+		throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["weaviate", op]);
+	}
+	if (isFilterGroup(filter)) {
+		const { and, or, not } = filter;
+		if (and) {
+			const children = and.map((c) => translateWeaviateFilter(col, weaviate, c)).filter((x) => x !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return weaviate.Filters.and(...children);
+		}
+		if (or) {
+			const children = or.map((c) => translateWeaviateFilter(col, weaviate, c)).filter((x) => x !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return weaviate.Filters.or(...children);
+		}
+		if (not) throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["weaviate", "not"]);
+		return;
+	}
+};
+/**
+* Weaviate-backed {@link @nhtio/adk/batteries/vector/contract!VectorStore}. Node-only.
+*
+* @remarks
+* Stores ids/documents/metadata as explicit object properties and all metadata filtering is
+* evaluated in JavaScript for portable behavior across Weaviate schema/index settings.
+*/
+var WeaviateVectorStore = class extends BaseVectorStore {
+	capabilities = {
+		transactions: false,
+		namedVectors: true,
+		rename: false,
+		rawSql: false,
+		builtInEncoding: false,
+		consistency: {
+			configurable: false,
+			default: "strong",
+			modes: ["strong"]
+		}
+	};
+	#client = null;
+	#weaviate = null;
+	#dims = /* @__PURE__ */ new Map();
+	static isAvailable() {
+		return typeof process !== "undefined";
+	}
+	isAvailable() {
+		return typeof process !== "undefined";
+	}
+	async connect() {
+		if (this.#client) return;
+		let weaviate;
+		try {
+			weaviate = (await import("weaviate-client")).default;
+		} catch {
+			throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(["weaviate-client"]);
+		}
+		const c = this.options.connection ?? {};
+		let httpHost = c.host ?? "localhost";
+		let httpPort = c.port ?? 8080;
+		let secure = c.secure;
+		if (c.url) {
+			const u = new URL(c.url);
+			httpHost = u.hostname;
+			httpPort = u.port ? Number(u.port) : u.protocol === "https:" ? 443 : 80;
+			secure = u.protocol === "https:";
+		}
+		try {
+			this.#client = await weaviate.connectToCustom({
+				httpHost,
+				httpPort,
+				httpSecure: !!secure,
+				grpcHost: c.grpcHost ?? httpHost,
+				grpcPort: c.grpcPort ?? 50051,
+				grpcSecure: !!c.grpcSecure,
+				headers: c.apiKey ? { Authorization: "Bearer " + c.apiKey } : void 0
+			});
+			this.#weaviate = weaviate;
+		} catch (e) {
+			throw new E_VECTOR_STORE_CONNECTION_FAILED([e?.message ?? String(e)]);
+		}
+	}
+	async close() {
+		await this.#client?.close?.();
+		this.#client = null;
+		this.#weaviate = null;
+	}
+	async createCollection(spec, ifNotExists) {
+		await this.connect();
+		const c = this.#cls(spec.collection);
+		try {
+			if (await this.#client.collections.exists(c)) {
+				if (ifNotExists) return;
+				throw new E_VECTOR_STORE_COLLECTION_FAILED(["create", "collection exists"]);
+			}
+			await this.#client.collections.create({
+				name: c,
+				vectorizers: this.#weaviate.configure.vectorizer.none(),
+				properties: [
+					{
+						name: "__id",
+						dataType: "text"
+					},
+					{
+						name: "__document",
+						dataType: "text"
+					},
+					{
+						name: "__metadata",
+						dataType: "text"
+					}
+				]
+			});
+			this.#dims.set(spec.collection, spec.vector.dimensions);
+		} catch (e) {
+			if (isInstanceOf(e, "E_VECTOR_STORE_COLLECTION_FAILED", E_VECTOR_STORE_COLLECTION_FAILED)) throw e;
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["create", e?.message ?? String(e)]);
+		}
+	}
+	async dropCollection(collection, ifExists) {
+		await this.connect();
+		const c = this.#cls(collection);
+		try {
+			if (!await this.#client.collections.exists(c)) {
+				if (!ifExists) throw new E_VECTOR_STORE_COLLECTION_FAILED(["drop", "collection does not exist"]);
+				return;
+			}
+			await this.#client.collections.delete(c);
+			this.#dims.delete(collection);
+		} catch (e) {
+			if (isInstanceOf(e, "E_VECTOR_STORE_COLLECTION_FAILED", E_VECTOR_STORE_COLLECTION_FAILED)) throw e;
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["drop", e?.message ?? String(e)]);
+		}
+	}
+	async hasCollection(collection) {
+		await this.connect();
+		return await this.#client.collections.exists(this.#cls(collection));
+	}
+	async renameCollection(_from, _to) {
+		throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(["renameCollection", "weaviate"]);
+	}
+	async executeUpsert(plan) {
+		await this.connect();
+		validateRecords(plan.records);
+		const dims = this.#dims.get(plan.collection) ?? this.options.dimensions;
+		const col = this.#client.collections.get(this.#cls(plan.collection));
+		try {
+			const objects = [];
+			for (const r of plan.records) {
+				let vector = r.vector;
+				if (!vector && r.document) {
+					const [v] = await this.encode([r.document], "document");
+					vector = v;
+				}
+				if (!vector) throw new E_VECTOR_STORE_UPSERT_FAILED(["Record missing vector and document"]);
+				if (dims !== void 0 && vector.length !== dims) throw new E_VECTOR_STORE_DIMENSION_MISMATCH([dims, vector.length]);
+				objects.push({
+					id: this.#uuidFromId(r.id),
+					properties: {
+						__id: r.id,
+						__document: r.document ?? "",
+						__metadata: JSON.stringify(r.metadata ?? {})
+					},
+					vectors: vector
+				});
+			}
+			if (objects.length > 0) await col.data.insertMany(objects);
+		} catch (e) {
+			if (isInstanceOf(e, "E_VECTOR_STORE_DIMENSION_MISMATCH", E_VECTOR_STORE_DIMENSION_MISMATCH)) throw e;
+			if (isInstanceOf(e, "E_VECTOR_STORE_UPSERT_FAILED", E_VECTOR_STORE_UPSERT_FAILED)) throw e;
+			throw new E_VECTOR_STORE_UPSERT_FAILED([e?.message ?? String(e)]);
+		}
+	}
+	async executeSearch(plan) {
+		await this.connect();
+		const col = this.#client.collections.get(this.#cls(plan.collection));
+		const metric = this.options.metric ?? "cosine";
+		try {
+			let qvec;
+			if (plan.near) {
+				if ("vector" in plan.near) qvec = plan.near.vector;
+				else if ("serverText" in plan.near) {
+					const [v] = await this.encode([plan.near.serverText], "query");
+					qvec = v;
+				} else if ("id" in plan.near) {
+					const ref = await col.query.fetchObjectById(this.#uuidFromId(plan.near.id), { includeVector: true });
+					qvec = this.#extractVector(ref?.vectors);
+				}
+			}
+			let res;
+			if (qvec) res = await col.query.nearVector(qvec, {
+				limit: (plan.topK + (plan.offset ?? 0)) * 4,
+				returnMetadata: ["distance"],
+				includeVector: !!plan.projection.vector,
+				returnProperties: [
+					"__id",
+					"__document",
+					"__metadata"
+				]
+			});
+			else res = await col.query.fetchObjects({
+				limit: 1e4,
+				includeVector: !!plan.projection.vector,
+				returnProperties: [
+					"__id",
+					"__document",
+					"__metadata"
+				]
+			});
+			const filtered = (res.objects ?? []).filter((obj) => {
+				const metadata = this.#parseMetadata(obj);
+				return !plan.filter || evaluateFilter(plan.filter, metadata);
+			});
+			const start = plan.offset ?? 0;
+			return filtered.slice(start, start + plan.topK).map((obj) => this.#project(obj, plan, !!qvec, metric));
+		} catch (e) {
+			throw new E_VECTOR_STORE_SEARCH_FAILED([e?.message ?? String(e)]);
+		}
+	}
+	async executeDelete(plan) {
+		await this.connect();
+		const col = this.#client.collections.get(this.#cls(plan.collection));
+		try {
+			if (plan.ids && plan.ids.length > 0) {
+				for (const id of plan.ids) await col.data.deleteById(this.#uuidFromId(id));
+				return;
+			}
+			const res = await col.query.fetchObjects({
+				limit: 1e4,
+				returnProperties: [
+					"__id",
+					"__document",
+					"__metadata"
+				]
+			});
+			for (const obj of res.objects ?? []) {
+				const id = obj.properties?.__id;
+				if (!id) continue;
+				if (!plan.filter || evaluateFilter(plan.filter, this.#parseMetadata(obj))) await col.data.deleteById(this.#uuidFromId(id));
+			}
+		} catch (e) {
+			throw new E_VECTOR_STORE_DELETE_FAILED([e?.message ?? String(e)]);
+		}
+	}
+	#cls(name) {
+		return name.charAt(0).toUpperCase() + name.slice(1);
+	}
+	#uuidFromId(id) {
+		const h = sha256(id);
+		return h.slice(0, 8) + "-" + h.slice(8, 12) + "-4" + h.slice(13, 16) + "-8" + h.slice(17, 20) + "-" + h.slice(20, 32);
+	}
+	#parseMetadata(obj) {
+		try {
+			return JSON.parse(obj.properties?.__metadata || "{}");
+		} catch {
+			return {};
+		}
+	}
+	#extractVector(vectors) {
+		if (Array.isArray(vectors)) return vectors;
+		if (vectors?.default) return vectors.default;
+		if (vectors && typeof vectors === "object") return Object.values(vectors)[0];
+	}
+	#project(obj, plan, scored, metric) {
+		const out = {};
+		const props = obj.properties ?? {};
+		if (plan.projection.id) out.id = props.__id;
+		if (plan.projection.document) out.document = props.__document;
+		if (plan.projection.metadata) out.metadata = this.#parseMetadata(obj);
+		if (plan.projection.vector) out.vector = this.#extractVector(obj.vectors);
+		if (scored) out.score = normalizeScore(Number(obj.metadata?.distance ?? 0), metric, "distance");
+		return out;
+	}
+};
+//#endregion
+export { WeaviateVectorStore, translateWeaviateFilter };
+
+//# sourceMappingURL=weaviate.mjs.map

package/batteries/vector/weaviate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaviate.mjs","names":["#client","#weaviate","#cls","#dims","#uuidFromId","#extractVector","#parseMetadata","#project"],"sources":["../../../src/batteries/vector/weaviate/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/weaviate\n *\n * @remarks\n * Weaviate-backed vector store adapter using the Weaviate v3 client with lazy driver\n * loading, deterministic object UUIDs, explicit vectors, and in-JS metadata filtering.\n */\n\nimport { sha256 } from 'js-sha256'\nimport { normalizeScore } from '../helpers'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { evaluateFilter, isRawFilter, isFilterCondition, isFilterGroup } from '../filters'\nimport {\n  E_VECTOR_STORE_DRIVER_UNAVAILABLE,\n  E_VECTOR_STORE_CONNECTION_FAILED,\n  E_VECTOR_STORE_COLLECTION_FAILED,\n  E_VECTOR_STORE_UPSERT_FAILED,\n  E_VECTOR_STORE_SEARCH_FAILED,\n  E_VECTOR_STORE_DELETE_FAILED,\n  E_VECTOR_STORE_DIMENSION_MISMATCH,\n  E_VECTOR_STORE_UNSUPPORTED_OPERATION,\n  E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR,\n} from '../exceptions'\nimport type { VectorFilter } from '../filters'\nimport type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from '../plan'\nimport type {\n  VectorMatch,\n  VectorMetadata,\n  VectorStoreCapabilities,\n  BaseVectorStoreOptions,\n} from '../types'\n\n/**\n * Connection options for {@link WeaviateVectorStore}.\n */\nexport interface WeaviateVectorStoreOptions extends BaseVectorStoreOptions {\n  connection?: {\n    url?: string\n    host?: string\n    port?: number\n    grpcHost?: string\n    grpcPort?: number\n    apiKey?: string\n    secure?: boolean\n    grpcSecure?: boolean\n  }\n}\n\n/**\n * Compiles a neutral {@link VectorFilter} into a Weaviate v3 filter built from a collection's\n * `col.filter` builder (and `weaviate.Filters.and/or` for groups). Pure and dependency-injected\n * (takes the `col` handle and the `weaviate` module), so it is unit-testable with stubs.\n *\n * @throws {@link @nhtio/adk/batteries/vector/exceptions!E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR}\n *   for operators Weaviate cannot express (`nin`, group `not`) or a non-`weaviate` raw dialect.\n */\nexport const translateWeaviateFilter = (col: any, weaviate: any, filter?: VectorFilter): any => {\n  if (!filter) return undefined\n  if (isRawFilter(filter)) {\n    if (filter.$dialect === 'weaviate') return filter.$raw\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['weaviate', String(filter.$dialect)])\n  }\n  if (isFilterCondition(filter)) {\n    const { field, op, value } = filter\n    if (value === undefined && op !== 'exists') {\n      throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['weaviate', op])\n    }\n    const f = col.filter.byProperty(field)\n    if (op === 'eq') return f.equal(value)\n    if (op === 'ne') return f.notEqual(value)\n    if (op === 'gt') return f.greaterThan(value)\n    if (op === 'gte') return f.greaterOrEqual(value)\n    if (op === 'lt') return f.lessThan(value)\n    if (op === 'lte') return f.lessOrEqual(value)\n    if (op === 'in') return f.containsAny(value)\n    if (op === 'nin') throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['weaviate', 'nin'])\n    if (op === 'exists') return f.isNull(value === false)\n    if (op === 'contains') return f.containsAny(Array.isArray(value) ? value : [value])\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['weaviate', op])\n  }\n  if (isFilterGroup(filter)) {\n    const { and, or, not } = filter\n    if (and) {\n      const children = and\n        .map((c: VectorFilter) => translateWeaviateFilter(col, weaviate, c))\n        .filter((x: any) => x !== undefined)\n      if (children.length === 0) return undefined\n      if (children.length === 1) return children[0]\n      return weaviate.Filters.and(...children)\n    }\n    if (or) {\n      const children = or\n        .map((c: VectorFilter) => translateWeaviateFilter(col, weaviate, c))\n        .filter((x: any) => x !== undefined)\n      if (children.length === 0) return undefined\n      if (children.length === 1) return children[0]\n      return weaviate.Filters.or(...children)\n    }\n    if (not) throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['weaviate', 'not'])\n    return undefined\n  }\n  return undefined\n}\n\n/**\n * Weaviate-backed {@link @nhtio/adk/batteries/vector/contract!VectorStore}. Node-only.\n *\n * @remarks\n * Stores ids/documents/metadata as explicit object properties and all metadata filtering is\n * evaluated in JavaScript for portable behavior across Weaviate schema/index settings.\n */\nexport class WeaviateVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: true,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    // Single-node Weaviate is strongly consistent on resolve; the option is a no-op here.\n    // (A future multi-node adapter variant would set configurable:true.)\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #client: any = null\n  #weaviate: any = null\n  #dims = new Map<string, number>()\n\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#client) return\n    let weaviate: any\n    try {\n      const weaviateMod = await import('weaviate-client')\n      weaviate = weaviateMod.default\n    } catch {\n      throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['weaviate-client'])\n    }\n    const c = (this.options as WeaviateVectorStoreOptions).connection ?? {}\n    let httpHost = c.host ?? 'localhost'\n    let httpPort = c.port ?? 8080\n    let secure = c.secure\n    if (c.url) {\n      const u = new URL(c.url)\n      httpHost = u.hostname\n      httpPort = u.port ? Number(u.port) : u.protocol === 'https:' ? 443 : 80\n      secure = u.protocol === 'https:'\n    }\n    try {\n      this.#client = await weaviate.connectToCustom({\n        httpHost,\n        httpPort,\n        httpSecure: !!secure,\n        grpcHost: c.grpcHost ?? httpHost,\n        grpcPort: c.grpcPort ?? 50051,\n        grpcSecure: !!c.grpcSecure,\n        headers: c.apiKey ? { Authorization: 'Bearer ' + c.apiKey } : undefined,\n      })\n      this.#weaviate = weaviate\n    } catch (e: any) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([e?.message ?? String(e)])\n    }\n  }\n\n  async close(): Promise<void> {\n    await this.#client?.close?.()\n    this.#client = null\n    this.#weaviate = null\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    await this.connect()\n    const c = this.#cls(spec.collection)\n    try {\n      if (await this.#client.collections.exists(c)) {\n        if (ifNotExists) return\n        throw new E_VECTOR_STORE_COLLECTION_FAILED(['create', 'collection exists'])\n      }\n      await this.#client.collections.create({\n        name: c,\n        vectorizers: this.#weaviate.configure.vectorizer.none(),\n        properties: [\n          { name: '__id', dataType: 'text' },\n          { name: '__document', dataType: 'text' },\n          { name: '__metadata', dataType: 'text' },\n        ],\n      })\n      this.#dims.set(spec.collection, spec.vector.dimensions)\n    } catch (e: any) {\n      if (isInstanceOf(e, 'E_VECTOR_STORE_COLLECTION_FAILED', E_VECTOR_STORE_COLLECTION_FAILED))\n        throw e\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['create', e?.message ?? String(e)])\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    await this.connect()\n    const c = this.#cls(collection)\n    try {\n      const exists = await this.#client.collections.exists(c)\n      if (!exists) {\n        if (!ifExists)\n          throw new E_VECTOR_STORE_COLLECTION_FAILED(['drop', 'collection does not exist'])\n        return\n      }\n      await this.#client.collections.delete(c)\n      this.#dims.delete(collection)\n    } catch (e: any) {\n      if (isInstanceOf(e, 'E_VECTOR_STORE_COLLECTION_FAILED', E_VECTOR_STORE_COLLECTION_FAILED))\n        throw e\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['drop', e?.message ?? String(e)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    await this.connect()\n    return await this.#client.collections.exists(this.#cls(collection))\n  }\n\n  async renameCollection(_from: string, _to: string): Promise<void> {\n    throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(['renameCollection', 'weaviate'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    await this.connect()\n    validateRecords(plan.records)\n    const dims = this.#dims.get(plan.collection) ?? this.options.dimensions\n    const col = this.#client.collections.get(this.#cls(plan.collection))\n    try {\n      const objects = []\n      for (const r of plan.records) {\n        let vector = r.vector\n        if (!vector && r.document) {\n          const [v] = await this.encode([r.document], 'document')\n          vector = v\n        }\n        if (!vector) throw new E_VECTOR_STORE_UPSERT_FAILED(['Record missing vector and document'])\n        if (dims !== undefined && vector.length !== dims) {\n          throw new E_VECTOR_STORE_DIMENSION_MISMATCH([dims, vector.length])\n        }\n        objects.push({\n          id: this.#uuidFromId(r.id),\n          properties: {\n            __id: r.id,\n            __document: r.document ?? '',\n            __metadata: JSON.stringify(r.metadata ?? {}),\n          },\n          vectors: vector,\n        })\n      }\n      if (objects.length > 0) await col.data.insertMany(objects)\n    } catch (e: any) {\n      if (isInstanceOf(e, 'E_VECTOR_STORE_DIMENSION_MISMATCH', E_VECTOR_STORE_DIMENSION_MISMATCH))\n        throw e\n      if (isInstanceOf(e, 'E_VECTOR_STORE_UPSERT_FAILED', E_VECTOR_STORE_UPSERT_FAILED)) throw e\n      throw new E_VECTOR_STORE_UPSERT_FAILED([e?.message ?? String(e)])\n    }\n  }\n\n  async executeSearch(plan: SearchPlan): Promise<VectorMatch[]> {\n    await this.connect()\n    const col = this.#client.collections.get(this.#cls(plan.collection))\n    const metric = this.options.metric ?? 'cosine'\n    try {\n      let qvec: number[] | undefined\n      if (plan.near) {\n        if ('vector' in plan.near) qvec = plan.near.vector\n        else if ('serverText' in plan.near) {\n          const [v] = await this.encode([plan.near.serverText], 'query')\n          qvec = v\n        } else if ('id' in plan.near) {\n          const ref = await col.query.fetchObjectById(this.#uuidFromId(plan.near.id), {\n            includeVector: true,\n          })\n          qvec = this.#extractVector(ref?.vectors)\n        }\n      }\n      let res: any\n      if (qvec) {\n        res = await col.query.nearVector(qvec, {\n          limit: (plan.topK + (plan.offset ?? 0)) * 4,\n          returnMetadata: ['distance'],\n          includeVector: !!plan.projection.vector,\n          returnProperties: ['__id', '__document', '__metadata'],\n        })\n      } else {\n        res = await col.query.fetchObjects({\n          limit: 10000,\n          includeVector: !!plan.projection.vector,\n          returnProperties: ['__id', '__document', '__metadata'],\n        })\n      }\n      const filtered = (res.objects ?? []).filter((obj: any) => {\n        const metadata = this.#parseMetadata(obj)\n        return !plan.filter || evaluateFilter(plan.filter, metadata)\n      })\n      const start = plan.offset ?? 0\n      return filtered\n        .slice(start, start + plan.topK)\n        .map((obj: any) => this.#project(obj, plan, !!qvec, metric))\n    } catch (e: any) {\n      throw new E_VECTOR_STORE_SEARCH_FAILED([e?.message ?? String(e)])\n    }\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    await this.connect()\n    const col = this.#client.collections.get(this.#cls(plan.collection))\n    try {\n      if (plan.ids && plan.ids.length > 0) {\n        for (const id of plan.ids) await col.data.deleteById(this.#uuidFromId(id))\n        return\n      }\n      const res = await col.query.fetchObjects({\n        limit: 10000,\n        returnProperties: ['__id', '__document', '__metadata'],\n      })\n      for (const obj of res.objects ?? []) {\n        const id = obj.properties?.__id\n        if (!id) continue\n        if (!plan.filter || evaluateFilter(plan.filter, this.#parseMetadata(obj))) {\n          await col.data.deleteById(this.#uuidFromId(id))\n        }\n      }\n    } catch (e: any) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([e?.message ?? String(e)])\n    }\n  }\n\n  #cls(name: string): string {\n    return name.charAt(0).toUpperCase() + name.slice(1)\n  }\n\n  #uuidFromId(id: string): string {\n    const h = sha256(id)\n    return (\n      h.slice(0, 8) +\n      '-' +\n      h.slice(8, 12) +\n      '-4' +\n      h.slice(13, 16) +\n      '-8' +\n      h.slice(17, 20) +\n      '-' +\n      h.slice(20, 32)\n    )\n  }\n\n  #parseMetadata(obj: any): VectorMetadata {\n    try {\n      return JSON.parse(obj.properties?.__metadata || '{}') as VectorMetadata\n    } catch {\n      return {}\n    }\n  }\n\n  #extractVector(vectors: any): number[] | undefined {\n    if (Array.isArray(vectors)) return vectors as number[]\n    if (vectors?.default) return vectors.default as number[]\n    if (vectors && typeof vectors === 'object')\n      return Object.values(vectors)[0] as number[] | undefined\n    return undefined\n  }\n\n  #project(obj: any, plan: SearchPlan, scored: boolean, metric: string): VectorMatch {\n    const out: VectorMatch = {}\n    const props = obj.properties ?? {}\n    if (plan.projection.id) out.id = props.__id\n    if (plan.projection.document) out.document = props.__document\n    if (plan.projection.metadata) out.metadata = this.#parseMetadata(obj)\n    if (plan.projection.vector) out.vector = this.#extractVector(obj.vectors)\n    if (scored)\n      out.score = normalizeScore(Number(obj.metadata?.distance ?? 0), metric as any, 'distance')\n    return out\n  }\n}\n"],"mappings":"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"}

package/batteries/vector.cjs

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../chunk-Ble4zEEl.js");
+const require_batteries_vector_filters = require("./vector/filters.cjs");
+const require_batteries_vector_helpers = require("./vector/helpers.cjs");
+const require_batteries_vector_exceptions = require("./vector/exceptions.cjs");
+const require_batteries_vector_builder = require("./vector/builder.cjs");
+const require_batteries_vector_schema = require("./vector/schema.cjs");
+const require_batteries_vector_migrate = require("./vector/migrate.cjs");
+const require_batteries_vector_contract = require("./vector/contract.cjs");
+const require_batteries_vector_vector_store_constructor = require("./vector/vector_store_constructor.cjs");
+const require_batteries_vector_validation = require("./vector/validation.cjs");
+const require_batteries_vector_factory = require("./vector/factory.cjs");
+const require_batteries_vector_retrievable = require("./vector/retrievable.cjs");
+const require_batteries_vector_in_memory = require("./vector/in_memory.cjs");
+const require_batteries_vector_orama = require("./vector/orama.cjs");
+exports.BaseVectorStore = require_batteries_vector_contract.BaseVectorStore;
+exports.CollectionBuilder = require_batteries_vector_schema.CollectionBuilder;
+exports.E_INVALID_VECTOR_RECORD = require_batteries_vector_exceptions.E_INVALID_VECTOR_RECORD;
+exports.E_INVALID_VECTOR_STORE_CONFIG = require_batteries_vector_exceptions.E_INVALID_VECTOR_STORE_CONFIG;
+exports.E_VECTOR_STORE_COLLECTION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED;
+exports.E_VECTOR_STORE_CONNECTION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_CONNECTION_FAILED;
+exports.E_VECTOR_STORE_CONSISTENCY_TIMEOUT = require_batteries_vector_exceptions.E_VECTOR_STORE_CONSISTENCY_TIMEOUT;
+exports.E_VECTOR_STORE_DELETE_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_DELETE_FAILED;
+exports.E_VECTOR_STORE_DIMENSION_MISMATCH = require_batteries_vector_exceptions.E_VECTOR_STORE_DIMENSION_MISMATCH;
+exports.E_VECTOR_STORE_DRIVER_UNAVAILABLE = require_batteries_vector_exceptions.E_VECTOR_STORE_DRIVER_UNAVAILABLE;
+exports.E_VECTOR_STORE_ENCODER_REQUIRED = require_batteries_vector_exceptions.E_VECTOR_STORE_ENCODER_REQUIRED;
+exports.E_VECTOR_STORE_MIGRATION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_MIGRATION_FAILED;
+exports.E_VECTOR_STORE_PROJECTION_REQUIRED = require_batteries_vector_exceptions.E_VECTOR_STORE_PROJECTION_REQUIRED;
+exports.E_VECTOR_STORE_QUERY_CONFLICT = require_batteries_vector_exceptions.E_VECTOR_STORE_QUERY_CONFLICT;
+exports.E_VECTOR_STORE_RAW_BINDING_MISMATCH = require_batteries_vector_exceptions.E_VECTOR_STORE_RAW_BINDING_MISMATCH;
+exports.E_VECTOR_STORE_SEARCH_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED;
+exports.E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = require_batteries_vector_exceptions.E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED;
+exports.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR;
+exports.E_VECTOR_STORE_UNSUPPORTED_OPERATION = require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_OPERATION;
+exports.E_VECTOR_STORE_UPSERT_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED;
+exports.FilterBuilder = require_batteries_vector_builder.FilterBuilder;
+exports.InMemoryVectorStore = require_batteries_vector_in_memory.InMemoryVectorStore;
+exports.OramaVectorStore = require_batteries_vector_orama.OramaVectorStore;
+exports.VectorMigrator = require_batteries_vector_migrate.VectorMigrator;
+exports.VectorQueryBuilder = require_batteries_vector_builder.VectorQueryBuilder;
+exports.VectorSchemaBuilder = require_batteries_vector_schema.VectorSchemaBuilder;
+exports.baseVectorStoreOptionsSchema = require_batteries_vector_validation.baseVectorStoreOptionsSchema;
+exports.clamp01 = require_batteries_vector_helpers.clamp01;
+exports.createVectorRetrievableCallbacks = require_batteries_vector_retrievable.createVectorRetrievableCallbacks;
+exports.createVectorStore = require_batteries_vector_factory.createVectorStore;
+exports.dimensionsMatch = require_batteries_vector_helpers.dimensionsMatch;
+exports.encoderFromEmbeddings = require_batteries_vector_factory.encoderFromEmbeddings;
+exports.evaluateFilter = require_batteries_vector_filters.evaluateFilter;
+exports.implementsVectorStoreConstructor = require_batteries_vector_vector_store_constructor.implementsVectorStoreConstructor;
+exports.isFilterCondition = require_batteries_vector_filters.isFilterCondition;
+exports.isFilterGroup = require_batteries_vector_filters.isFilterGroup;
+exports.isFiniteVector = require_batteries_vector_helpers.isFiniteVector;
+exports.isRawExpr = require_batteries_vector_filters.isRawExpr;
+exports.isRawFilter = require_batteries_vector_filters.isRawFilter;
+exports.mapMetric = require_batteries_vector_helpers.mapMetric;
+exports.normalizeScore = require_batteries_vector_helpers.normalizeScore;
+exports.raw = require_batteries_vector_filters.raw;
+exports.resolveClientCtor = require_batteries_vector_validation.resolveClientCtor;
+exports.validateCreateConfig = require_batteries_vector_validation.validateCreateConfig;
+exports.validateRecords = require_batteries_vector_validation.validateRecords;
+exports.vectorFilterSchema = require_batteries_vector_filters.vectorFilterSchema;
+exports.vectorRecordSchema = require_batteries_vector_validation.vectorRecordSchema;
+exports.vectorStoreConstructorSchema = require_batteries_vector_vector_store_constructor.vectorStoreConstructorSchema;

package/batteries/vector.mjs

@@ -0,0 +1,14 @@
+import { evaluateFilter, isFilterCondition, isFilterGroup, isRawExpr, isRawFilter, raw, vectorFilterSchema } from "./vector/filters.mjs";
+import { clamp01, dimensionsMatch, isFiniteVector, mapMetric, normalizeScore } from "./vector/helpers.mjs";
+import { E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_ENCODER_REQUIRED, E_VECTOR_STORE_MIGRATION_FAILED, E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./vector/exceptions.mjs";
+import { FilterBuilder, VectorQueryBuilder } from "./vector/builder.mjs";
+import { CollectionBuilder, VectorSchemaBuilder } from "./vector/schema.mjs";
+import { VectorMigrator } from "./vector/migrate.mjs";
+import { BaseVectorStore } from "./vector/contract.mjs";
+import { implementsVectorStoreConstructor, vectorStoreConstructorSchema } from "./vector/vector_store_constructor.mjs";
+import { baseVectorStoreOptionsSchema, resolveClientCtor, validateCreateConfig, validateRecords, vectorRecordSchema } from "./vector/validation.mjs";
+import { createVectorStore, encoderFromEmbeddings } from "./vector/factory.mjs";
+import { createVectorRetrievableCallbacks } from "./vector/retrievable.mjs";
+import { InMemoryVectorStore } from "./vector/in_memory.mjs";
+import { OramaVectorStore } from "./vector/orama.mjs";
+export { BaseVectorStore, CollectionBuilder, E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_ENCODER_REQUIRED, E_VECTOR_STORE_MIGRATION_FAILED, E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED, FilterBuilder, InMemoryVectorStore, OramaVectorStore, VectorMigrator, VectorQueryBuilder, VectorSchemaBuilder, baseVectorStoreOptionsSchema, clamp01, createVectorRetrievableCallbacks, createVectorStore, dimensionsMatch, encoderFromEmbeddings, evaluateFilter, implementsVectorStoreConstructor, isFilterCondition, isFilterGroup, isFiniteVector, isRawExpr, isRawFilter, mapMetric, normalizeScore, raw, resolveClientCtor, validateCreateConfig, validateRecords, vectorFilterSchema, vectorRecordSchema, vectorStoreConstructorSchema };

package/batteries.cjs

@@ -34,8 +34,26 @@ const require_batteries_embeddings_openai_validation = require("./batteries/embe
 const require_batteries_embeddings_openai_helpers = require("./batteries/embeddings/openai/helpers.cjs");
 const require_batteries_embeddings_openai_adapter = require("./batteries/embeddings/openai/adapter.cjs");
 require("./batteries/embeddings.cjs");
+const require_batteries_vector_filters = require("./batteries/vector/filters.cjs");
+const require_batteries_vector_helpers = require("./batteries/vector/helpers.cjs");
+const require_batteries_vector_exceptions = require("./batteries/vector/exceptions.cjs");
+const require_batteries_vector_builder = require("./batteries/vector/builder.cjs");
+const require_batteries_vector_schema = require("./batteries/vector/schema.cjs");
+const require_batteries_vector_migrate = require("./batteries/vector/migrate.cjs");
+const require_batteries_vector_contract = require("./batteries/vector/contract.cjs");
+const require_batteries_vector_vector_store_constructor = require("./batteries/vector/vector_store_constructor.cjs");
+const require_batteries_vector_validation = require("./batteries/vector/validation.cjs");
+const require_batteries_vector_factory = require("./batteries/vector/factory.cjs");
+const require_batteries_vector_retrievable = require("./batteries/vector/retrievable.cjs");
+const require_batteries_vector_in_memory = require("./batteries/vector/in_memory.cjs");
+const require_batteries_vector_orama = require("./batteries/vector/orama.cjs");
+require("./batteries/vector.cjs");
+exports.BaseVectorStore = require_batteries_vector_contract.BaseVectorStore;
+exports.CollectionBuilder = require_batteries_vector_schema.CollectionBuilder;
 exports.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_openai_chat_completions_exceptions.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS;
 exports.E_INVALID_OPENAI_EMBEDDINGS_OPTIONS = require_batteries_embeddings_openai_exceptions.E_INVALID_OPENAI_EMBEDDINGS_OPTIONS;
+exports.E_INVALID_VECTOR_RECORD = require_batteries_vector_exceptions.E_INVALID_VECTOR_RECORD;
+exports.E_INVALID_VECTOR_STORE_CONFIG = require_batteries_vector_exceptions.E_INVALID_VECTOR_STORE_CONFIG;
 exports.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_webllm_chat_completions_exceptions.E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS;
 exports.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
 exports.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR;
@@ -46,16 +64,40 @@ exports.E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED = require_batteries_llm_openai_
 exports.E_OPENAI_EMBEDDINGS_HTTP_ERROR = require_batteries_embeddings_openai_exceptions.E_OPENAI_EMBEDDINGS_HTTP_ERROR;
 exports.E_OPENAI_EMBEDDINGS_MALFORMED_RESPONSE = require_batteries_embeddings_openai_exceptions.E_OPENAI_EMBEDDINGS_MALFORMED_RESPONSE;
 exports.E_OPENAI_EMBEDDINGS_REQUEST_TIMEOUT = require_batteries_embeddings_openai_exceptions.E_OPENAI_EMBEDDINGS_REQUEST_TIMEOUT;
+exports.E_VECTOR_STORE_COLLECTION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED;
+exports.E_VECTOR_STORE_CONNECTION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_CONNECTION_FAILED;
+exports.E_VECTOR_STORE_CONSISTENCY_TIMEOUT = require_batteries_vector_exceptions.E_VECTOR_STORE_CONSISTENCY_TIMEOUT;
+exports.E_VECTOR_STORE_DELETE_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_DELETE_FAILED;
+exports.E_VECTOR_STORE_DIMENSION_MISMATCH = require_batteries_vector_exceptions.E_VECTOR_STORE_DIMENSION_MISMATCH;
+exports.E_VECTOR_STORE_DRIVER_UNAVAILABLE = require_batteries_vector_exceptions.E_VECTOR_STORE_DRIVER_UNAVAILABLE;
+exports.E_VECTOR_STORE_ENCODER_REQUIRED = require_batteries_vector_exceptions.E_VECTOR_STORE_ENCODER_REQUIRED;
+exports.E_VECTOR_STORE_MIGRATION_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_MIGRATION_FAILED;
+exports.E_VECTOR_STORE_PROJECTION_REQUIRED = require_batteries_vector_exceptions.E_VECTOR_STORE_PROJECTION_REQUIRED;
+exports.E_VECTOR_STORE_QUERY_CONFLICT = require_batteries_vector_exceptions.E_VECTOR_STORE_QUERY_CONFLICT;
+exports.E_VECTOR_STORE_RAW_BINDING_MISMATCH = require_batteries_vector_exceptions.E_VECTOR_STORE_RAW_BINDING_MISMATCH;
+exports.E_VECTOR_STORE_SEARCH_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED;
+exports.E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = require_batteries_vector_exceptions.E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED;
+exports.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR;
+exports.E_VECTOR_STORE_UNSUPPORTED_OPERATION = require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_OPERATION;
+exports.E_VECTOR_STORE_UPSERT_FAILED = require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED;
 exports.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
 exports.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS;
 exports.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR = require_batteries_llm_webllm_chat_completions_exceptions.E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR;
+exports.FilterBuilder = require_batteries_vector_builder.FilterBuilder;
+exports.InMemoryVectorStore = require_batteries_vector_in_memory.InMemoryVectorStore;
 exports.OpenAIChatCompletionsAdapter = require_batteries_llm_openai_chat_completions_adapter.OpenAIChatCompletionsAdapter;
 exports.OpenAIEmbeddingsAdapter = require_batteries_embeddings_openai_adapter.OpenAIEmbeddingsAdapter;
+exports.OramaVectorStore = require_batteries_vector_orama.OramaVectorStore;
+exports.VectorMigrator = require_batteries_vector_migrate.VectorMigrator;
+exports.VectorQueryBuilder = require_batteries_vector_builder.VectorQueryBuilder;
+exports.VectorSchemaBuilder = require_batteries_vector_schema.VectorSchemaBuilder;
 exports.WebLLMChatCompletionsAdapter = require_batteries_llm_webllm_chat_completions_adapter.WebLLMChatCompletionsAdapter;
 exports.addStandingInstructionTool = require_batteries_tools_standing_instructions.addStandingInstructionTool;
 exports.applyEmbeddingPrefix = require_batteries_embeddings_openai_helpers.applyEmbeddingPrefix;
+exports.baseVectorStoreOptionsSchema = require_batteries_vector_validation.baseVectorStoreOptionsSchema;
 exports.buildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.buildChatCompletionsHistory;
 exports.calculateTool = require_batteries_tools_math.calculateTool;
+exports.clamp01 = require_batteries_vector_helpers.clamp01;
 exports.colorAdjustTool = require_batteries_tools_color.colorAdjustTool;
 exports.colorContrastTool = require_batteries_tools_color.colorContrastTool;
 exports.colorSchemeTool = require_batteries_tools_color.colorSchemeTool;
@@ -64,6 +106,8 @@ exports.compareValuesTool = require_batteries_tools_comparison.compareValuesTool
 exports.convertTimeTool = require_batteries_tools_time.convertTimeTool;
 exports.convertUnitTool = require_batteries_tools_unit_conversion.convertUnitTool;
 exports.createChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.createChatCompletionsToolCallDeltaAccumulator;
+exports.createVectorRetrievableCallbacks = require_batteries_vector_retrievable.createVectorRetrievableCallbacks;
+exports.createVectorStore = require_batteries_vector_factory.createVectorStore;
 exports.dateAddTool = require_batteries_tools_datetime_math.dateAddTool;
 exports.dateBusinessDaysTool = require_batteries_tools_datetime_extended.dateBusinessDaysTool;
 exports.dateCalendarInfoTool = require_batteries_tools_datetime_extended.dateCalendarInfoTool;
@@ -93,8 +137,11 @@ exports.deleteMemoryTool = require_batteries_tools_memory.deleteMemoryTool;
 exports.deleteRetrievableTool = require_batteries_tools_retrievables.deleteRetrievableTool;
 exports.descriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.descriptionToChatCompletionsJsonSchema;
 exports.detectDelimiterTool = require_batteries_tools_parsing.detectDelimiterTool;
+exports.dimensionsMatch = require_batteries_vector_helpers.dimensionsMatch;
 exports.durationFormatTool = require_batteries_tools_datetime_math.durationFormatTool;
 exports.encodeTextTool = require_batteries_tools_encoding.encodeTextTool;
+exports.encoderFromEmbeddings = require_batteries_vector_factory.encoderFromEmbeddings;
+exports.evaluateFilter = require_batteries_vector_filters.evaluateFilter;
 exports.evaluateKatexTool = require_batteries_tools_math.evaluateKatexTool;
 exports.extractReasoningFields = require_batteries_llm_openai_chat_completions_helpers.extractReasoningFields;
 exports.filterThoughts = require_batteries_llm_openai_chat_completions_helpers.filterThoughts;
@@ -105,17 +152,26 @@ exports.geoBboxContainsTool = require_batteries_tools_geo_basics.geoBboxContains
 exports.geoDistanceTool = require_batteries_tools_geo_basics.geoDistanceTool;
 exports.geoWithinRadiusTool = require_batteries_tools_geo_basics.geoWithinRadiusTool;
 exports.getCurrentTimeTool = require_batteries_tools_time.getCurrentTimeTool;
+exports.implementsVectorStoreConstructor = require_batteries_vector_vector_store_constructor.implementsVectorStoreConstructor;
+exports.isFilterCondition = require_batteries_vector_filters.isFilterCondition;
+exports.isFilterGroup = require_batteries_vector_filters.isFilterGroup;
+exports.isFiniteVector = require_batteries_vector_helpers.isFiniteVector;
+exports.isRawExpr = require_batteries_vector_filters.isRawExpr;
+exports.isRawFilter = require_batteries_vector_filters.isRawFilter;
 exports.jsonFormatTool = require_batteries_tools_structured_data.jsonFormatTool;
 exports.jsonTransformTool = require_batteries_tools_data_structure.jsonTransformTool;
 exports.listMemoriesTool = require_batteries_tools_memory.listMemoriesTool;
 exports.listRetrievablesTool = require_batteries_tools_retrievables.listRetrievablesTool;
 exports.listStandingInstructionsTool = require_batteries_tools_standing_instructions.listStandingInstructionsTool;
+exports.mapMetric = require_batteries_vector_helpers.mapMetric;
 exports.memoryTools = require_batteries_tools_memory.memoryTools;
+exports.normalizeScore = require_batteries_vector_helpers.normalizeScore;
 exports.openAIChatCompletionsOptionsSchema = require_batteries_llm_openai_chat_completions_validation.openAIChatCompletionsOptionsSchema;
 exports.openAIEmbeddingsOptionsSchema = require_batteries_embeddings_openai_validation.openAIEmbeddingsOptionsSchema;
 exports.parseCsvTool = require_batteries_tools_parsing.parseCsvTool;
 exports.parseKvTool = require_batteries_tools_parsing.parseKvTool;
 exports.parseYamlTool = require_batteries_tools_parsing.parseYamlTool;
+exports.raw = require_batteries_vector_filters.raw;
 exports.removeStandingInstructionTool = require_batteries_tools_standing_instructions.removeStandingInstructionTool;
 exports.renderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsSystemPrompt;
 exports.renderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsToolCallResult;
@@ -130,6 +186,7 @@ exports.renderThought = require_batteries_llm_openai_chat_completions_helpers.re
 exports.renderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.renderTimelineMessage;
 exports.renderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderTrustedContent;
 exports.renderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderUntrustedContent;
+exports.resolveClientCtor = require_batteries_vector_validation.resolveClientCtor;
 exports.retrievableTools = require_batteries_tools_retrievables.retrievableTools;
 exports.setOperationsTool = require_batteries_tools_data_structure.setOperationsTool;
 exports.standingInstructionTools = require_batteries_tools_standing_instructions.standingInstructionTools;
@@ -150,8 +207,13 @@ exports.toolsToChatCompletionsTools = require_batteries_llm_openai_chat_completi
 exports.unicodeNormalizeTool = require_batteries_tools_encoding.unicodeNormalizeTool;
 exports.updateMemoryTool = require_batteries_tools_memory.updateMemoryTool;
 exports.updateRetrievableTool = require_batteries_tools_retrievables.updateRetrievableTool;
+exports.validateCreateConfig = require_batteries_vector_validation.validateCreateConfig;
 exports.validateFormatTool = require_batteries_tools_structured_data.validateFormatTool;
 exports.validateOpenAIEmbeddingsOptions = require_batteries_embeddings_openai_validation.validateOptions;
 exports.validateOptions = require_batteries_llm_openai_chat_completions_validation.validateOptions;
+exports.validateRecords = require_batteries_vector_validation.validateRecords;
 exports.validateWebLLMChatCompletionsOptions = require_batteries_llm_webllm_chat_completions_validation.validateOptions;
+exports.vectorFilterSchema = require_batteries_vector_filters.vectorFilterSchema;
+exports.vectorRecordSchema = require_batteries_vector_validation.vectorRecordSchema;
+exports.vectorStoreConstructorSchema = require_batteries_vector_vector_store_constructor.vectorStoreConstructorSchema;
 exports.webLLMChatCompletionsOptionsSchema = require_batteries_llm_webllm_chat_completions_validation.webLLMChatCompletionsOptionsSchema;

package/batteries.mjs

@@ -32,4 +32,18 @@ import { openAIEmbeddingsOptionsSchema, validateOptions } from "./batteries/embe
 import { applyEmbeddingPrefix } from "./batteries/embeddings/openai/helpers.mjs";
 import { OpenAIEmbeddingsAdapter } from "./batteries/embeddings/openai/adapter.mjs";
 import "./batteries/embeddings.mjs";
-export { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_INVALID_OPENAI_EMBEDDINGS_OPTIONS, E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED, E_OPENAI_EMBEDDINGS_HTTP_ERROR, E_OPENAI_EMBEDDINGS_MALFORMED_RESPONSE, E_OPENAI_EMBEDDINGS_REQUEST_TIMEOUT, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR, OpenAIChatCompletionsAdapter, OpenAIEmbeddingsAdapter, WebLLMChatCompletionsAdapter, addStandingInstructionTool, applyEmbeddingPrefix, buildChatCompletionsHistory, calculateTool, colorAdjustTool, colorContrastTool, colorSchemeTool, compareRecordsTool, compareValuesTool, convertTimeTool, convertUnitTool, createChatCompletionsToolCallDeltaAccumulator, dateAddTool, dateBusinessDaysTool, dateCalendarInfoTool, dateDiffTool, dateNthWeekdayTool, dateParseTool, datePeriodTool, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, deleteMemoryTool, deleteRetrievableTool, descriptionToChatCompletionsJsonSchema, detectDelimiterTool, durationFormatTool, encodeTextTool, evaluateKatexTool, extractReasoningFields, filterThoughts, formatListTool, formatNumberTool, formatTableTool, geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool, getCurrentTimeTool, jsonFormatTool, jsonTransformTool, listMemoriesTool, listRetrievablesTool, listStandingInstructionsTool, memoryTools, openAIChatCompletionsOptionsSchema, openAIEmbeddingsOptionsSchema, parseCsvTool, parseKvTool, parseYamlTool, removeStandingInstructionTool, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, retrievableTools, setOperationsTool, standingInstructionTools, statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool, storeMemoryTool, storeRetrievableTool, stringExtractTool, stringSimilarityTool, stringTransformTool, textAnalyzeTool, textDiffTool, textEscapeTool, textLinesTool, toolsToChatCompletionsTools, unicodeNormalizeTool, updateMemoryTool, updateRetrievableTool, validateFormatTool, validateOptions as validateOpenAIEmbeddingsOptions, validateOptions$1 as validateOptions, validateOptions$2 as validateWebLLMChatCompletionsOptions, webLLMChatCompletionsOptionsSchema };
+import { evaluateFilter, isFilterCondition, isFilterGroup, isRawExpr, isRawFilter, raw, vectorFilterSchema } from "./batteries/vector/filters.mjs";
+import { clamp01, dimensionsMatch, isFiniteVector, mapMetric, normalizeScore } from "./batteries/vector/helpers.mjs";
+import { E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_ENCODER_REQUIRED, E_VECTOR_STORE_MIGRATION_FAILED, E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./batteries/vector/exceptions.mjs";
+import { FilterBuilder, VectorQueryBuilder } from "./batteries/vector/builder.mjs";
+import { CollectionBuilder, VectorSchemaBuilder } from "./batteries/vector/schema.mjs";
+import { VectorMigrator } from "./batteries/vector/migrate.mjs";
+import { BaseVectorStore } from "./batteries/vector/contract.mjs";
+import { implementsVectorStoreConstructor, vectorStoreConstructorSchema } from "./batteries/vector/vector_store_constructor.mjs";
+import { baseVectorStoreOptionsSchema, resolveClientCtor, validateCreateConfig, validateRecords, vectorRecordSchema } from "./batteries/vector/validation.mjs";
+import { createVectorStore, encoderFromEmbeddings } from "./batteries/vector/factory.mjs";
+import { createVectorRetrievableCallbacks } from "./batteries/vector/retrievable.mjs";
+import { InMemoryVectorStore } from "./batteries/vector/in_memory.mjs";
+import { OramaVectorStore } from "./batteries/vector/orama.mjs";
+import "./batteries/vector.mjs";
+export { BaseVectorStore, CollectionBuilder, E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_INVALID_OPENAI_EMBEDDINGS_OPTIONS, E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED, E_OPENAI_EMBEDDINGS_HTTP_ERROR, E_OPENAI_EMBEDDINGS_MALFORMED_RESPONSE, E_OPENAI_EMBEDDINGS_REQUEST_TIMEOUT, E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_ENCODER_REQUIRED, E_VECTOR_STORE_MIGRATION_FAILED, E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR, FilterBuilder, InMemoryVectorStore, OpenAIChatCompletionsAdapter, OpenAIEmbeddingsAdapter, OramaVectorStore, VectorMigrator, VectorQueryBuilder, VectorSchemaBuilder, WebLLMChatCompletionsAdapter, addStandingInstructionTool, applyEmbeddingPrefix, baseVectorStoreOptionsSchema, buildChatCompletionsHistory, calculateTool, clamp01, colorAdjustTool, colorContrastTool, colorSchemeTool, compareRecordsTool, compareValuesTool, convertTimeTool, convertUnitTool, createChatCompletionsToolCallDeltaAccumulator, createVectorRetrievableCallbacks, createVectorStore, dateAddTool, dateBusinessDaysTool, dateCalendarInfoTool, dateDiffTool, dateNthWeekdayTool, dateParseTool, datePeriodTool, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, deleteMemoryTool, deleteRetrievableTool, descriptionToChatCompletionsJsonSchema, detectDelimiterTool, dimensionsMatch, durationFormatTool, encodeTextTool, encoderFromEmbeddings, evaluateFilter, evaluateKatexTool, extractReasoningFields, filterThoughts, formatListTool, formatNumberTool, formatTableTool, geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool, getCurrentTimeTool, implementsVectorStoreConstructor, isFilterCondition, isFilterGroup, isFiniteVector, isRawExpr, isRawFilter, jsonFormatTool, jsonTransformTool, listMemoriesTool, listRetrievablesTool, listStandingInstructionsTool, mapMetric, memoryTools, normalizeScore, openAIChatCompletionsOptionsSchema, openAIEmbeddingsOptionsSchema, parseCsvTool, parseKvTool, parseYamlTool, raw, removeStandingInstructionTool, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, resolveClientCtor, retrievableTools, setOperationsTool, standingInstructionTools, statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool, storeMemoryTool, storeRetrievableTool, stringExtractTool, stringSimilarityTool, stringTransformTool, textAnalyzeTool, textDiffTool, textEscapeTool, textLinesTool, toolsToChatCompletionsTools, unicodeNormalizeTool, updateMemoryTool, updateRetrievableTool, validateCreateConfig, validateFormatTool, validateOptions as validateOpenAIEmbeddingsOptions, validateOptions$1 as validateOptions, validateRecords, validateOptions$2 as validateWebLLMChatCompletionsOptions, vectorFilterSchema, vectorRecordSchema, vectorStoreConstructorSchema, webLLMChatCompletionsOptionsSchema };