@nhtio/adk 1.20260604.0 → 1.20260607.0

package/batteries/vector/chroma.cjs

@@ -0,0 +1,305 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_helpers = require("./helpers.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_contract = require("./contract.cjs");
+const require_batteries_vector_validation = require("./validation.cjs");
+//#region src/batteries/vector/chroma/index.ts
+/**
+* @module @nhtio/adk/batteries/vector/chroma
+*/
+var getChromaClient = async () => {
+	try {
+		return (await import("chromadb")).ChromaClient;
+	} catch {
+		throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DRIVER_UNAVAILABLE(["chromadb"]);
+	}
+};
+var getSpace = (metric) => {
+	if (metric === "cosine") return "cosine";
+	if (metric === "euclidean") return "l2";
+	if (metric === "dot") return "ip";
+	return "cosine";
+};
+var translateChromaWhere = (filter) => {
+	if (!filter) return void 0;
+	if (require_batteries_vector_filters.isRawFilter(filter)) {
+		if (filter.$dialect === "chroma") return filter.$raw;
+		throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", String(filter.$dialect)]);
+	}
+	if (require_batteries_vector_filters.isFilterCondition(filter)) {
+		const { field, op, value } = filter;
+		if (value === void 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+		if (op === "eq") return { [field]: { $eq: value } };
+		if (op === "ne") return { [field]: { $ne: value } };
+		if (op === "gt") return { [field]: { $gt: value } };
+		if (op === "gte") return { [field]: { $gte: value } };
+		if (op === "lt") return { [field]: { $lt: value } };
+		if (op === "lte") return { [field]: { $lte: value } };
+		if (op === "in") return { [field]: { $in: value } };
+		if (op === "nin") return { [field]: { $nin: value } };
+		if (op === "exists" || op === "contains") throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+		throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+	}
+	if (require_batteries_vector_filters.isFilterGroup(filter)) {
+		const { and, or, not } = filter;
+		if (and) {
+			const children = and.map((f) => translateChromaWhere(f)).filter((c) => c !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return { $and: children };
+		}
+		if (or) {
+			const children = or.map((f) => translateChromaWhere(f)).filter((c) => c !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return { $or: children };
+		}
+		if (not) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", "not"]);
+		return;
+	}
+};
+var ChromaVectorStore = class extends require_batteries_vector_contract.BaseVectorStore {
+	capabilities = {
+		transactions: false,
+		namedVectors: false,
+		rename: true,
+		rawSql: false,
+		builtInEncoding: false,
+		consistency: {
+			configurable: false,
+			default: "strong",
+			modes: ["strong"]
+		}
+	};
+	#client = null;
+	#collectionCache = /* @__PURE__ */ new Map();
+	get #opts() {
+		return this.options;
+	}
+	static isAvailable() {
+		return typeof process !== "undefined";
+	}
+	isAvailable() {
+		return typeof process !== "undefined";
+	}
+	async connect() {
+		if (this.#client) return;
+		const ChromaClient = await getChromaClient();
+		const c = this.#opts.connection || {};
+		let host;
+		let port;
+		let ssl = false;
+		if (c.url) {
+			const url = new URL(c.url);
+			host = url.hostname;
+			port = url.port ? Number.parseInt(url.port, 10) : url.protocol === "https:" ? 443 : 80;
+			ssl = url.protocol === "https:";
+		} else {
+			host = c.host;
+			port = c.port;
+			ssl = c.ssl || false;
+		}
+		const path = host && port !== void 0 ? `${ssl ? "https://" : "http://"}${host}${port === 80 || port === 443 ? "" : ":" + port}` : void 0;
+		try {
+			this.#client = new ChromaClient({ path });
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_CONNECTION_FAILED([String(err)]);
+		}
+	}
+	async close() {
+		this.#client = null;
+		this.#collectionCache.clear();
+	}
+	async getCollection(name) {
+		let collection = this.#collectionCache.get(name);
+		if (collection) return collection;
+		if (!this.#client) await this.connect();
+		const metric = this.#opts.metric ?? "cosine";
+		collection = await this.#client.getOrCreateCollection({
+			name,
+			metadata: { "hnsw:space": getSpace(metric) }
+		});
+		this.#collectionCache.set(name, collection);
+		return collection;
+	}
+	async createCollection(spec, ifNotExists) {
+		const name = spec.collection;
+		if (ifNotExists && await this.hasCollection(name)) return;
+		if (await this.hasCollection(name)) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["create", "exists"]);
+		try {
+			await this.connect();
+			const metric = spec.vector.metric ?? "cosine";
+			await this.#client.getOrCreateCollection({
+				name,
+				metadata: { "hnsw:space": getSpace(metric) }
+			});
+			this.#collectionCache.set(name, null);
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["createCollection", String(err)]);
+		}
+	}
+	async dropCollection(collection, ifExists) {
+		if (ifExists && !await this.hasCollection(collection)) return;
+		try {
+			await this.connect();
+			await this.#client.deleteCollection({ name: collection });
+			this.#collectionCache.delete(collection);
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["dropCollection", String(err)]);
+		}
+	}
+	async hasCollection(collection) {
+		if (!this.#client) await this.connect();
+		try {
+			const collections = await this.#client.listCollections();
+			for (const c of collections) if (typeof c === "object" ? c.name === collection : c === collection) return true;
+			return false;
+		} catch {
+			return false;
+		}
+	}
+	async renameCollection(from, to) {
+		try {
+			await (await this.getCollection(from)).modify({ name: to });
+			const cached = this.#collectionCache.get(from);
+			this.#collectionCache.delete(from);
+			if (cached) this.#collectionCache.set(to, cached);
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["renameCollection", String(err)]);
+		}
+	}
+	async executeUpsert(plan) {
+		if (plan.records.length === 0) return;
+		require_batteries_vector_validation.validateRecords(plan.records);
+		const collection = await this.getCollection(plan.collection);
+		const expected = this.#opts.dimensions;
+		const ids = [];
+		const embeddings = [];
+		const documents = [];
+		const metadatas = [];
+		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 require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED(["Record missing vector and document"]);
+			if (expected !== void 0 && vector.length !== expected) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length]);
+			ids.push(r.id);
+			embeddings.push(vector);
+			documents.push(r.document ?? "");
+			const md = {
+				...r.metadata ?? {},
+				internalId: r.id
+			};
+			metadatas.push(md);
+		}
+		try {
+			await collection.upsert({
+				ids,
+				embeddings,
+				documents,
+				metadatas
+			});
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED([String(err)]);
+		}
+	}
+	async executeSearch(plan) {
+		const collection = await this.getCollection(plan.collection);
+		const metric = this.#opts.metric ?? "cosine";
+		let queryVector;
+		if (plan.near) {
+			if ("vector" in plan.near) queryVector = plan.near.vector;
+			else if ("serverText" in plan.near) {
+				const [v] = await this.encode([plan.near.serverText], "query");
+				queryVector = v;
+			} else if ("id" in plan.near) {
+				const res = await collection.get({
+					ids: [plan.near.id],
+					include: ["embeddings"]
+				});
+				if (!res.ids || res.ids.length === 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED(["Referenced id not found: " + plan.near.id]);
+				const embeddings = res.embeddings || [];
+				if (!embeddings || embeddings.length === 0 || !embeddings[0]) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED(["Referenced id has no vector: " + plan.near.id]);
+				queryVector = embeddings[0];
+			}
+		}
+		const where = translateChromaWhere(plan.filter);
+		let results;
+		if (queryVector) try {
+			results = await collection.query({
+				queryEmbeddings: [queryVector],
+				nResults: plan.topK,
+				where,
+				include: [
+					"documents",
+					"metadatas",
+					"distances",
+					"embeddings"
+				]
+			});
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+		else try {
+			results = await collection.get({
+				where,
+				limit: plan.topK,
+				include: [
+					"documents",
+					"metadatas",
+					"embeddings"
+				]
+			});
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+		const proj = plan.projection;
+		const out = [];
+		const unwrap = (col) => {
+			if (!col) return [];
+			return queryVector ? col[0] ?? [] : col;
+		};
+		const ids = unwrap(results.ids);
+		const documents = unwrap(results.documents);
+		const metadatas = unwrap(results.metadatas);
+		const embeddings = unwrap(results.embeddings);
+		const distances = unwrap(results.distances);
+		const start = plan.offset || 0;
+		const limit = plan.topK;
+		for (let i = start; i < Math.min(ids.length, start + limit); i++) {
+			const match = {};
+			if (proj.id) match.id = ids[i];
+			if (proj.vector && embeddings[i]) match.vector = embeddings[i];
+			if (proj.document) match.document = documents[i] ?? void 0;
+			if (proj.metadata && metadatas[i]) {
+				const { internalId, ...rest } = metadatas[i];
+				match.metadata = rest;
+			}
+			if (queryVector && distances && distances[i] !== void 0) match.score = require_batteries_vector_helpers.normalizeScore(distances[i], metric, "distance");
+			out.push(match);
+		}
+		return out;
+	}
+	async executeDelete(plan) {
+		const collection = await this.getCollection(plan.collection);
+		try {
+			if (plan.ids) await collection.delete({ ids: plan.ids });
+			else if (plan.filter) {
+				const where = translateChromaWhere(plan.filter);
+				if (where) await collection.delete({ where });
+				else await collection.delete({ where: {} });
+			} else await collection.delete({ where: {} });
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DELETE_FAILED([String(err)]);
+		}
+	}
+};
+//#endregion
+exports.ChromaVectorStore = ChromaVectorStore;
+exports.translateChromaWhere = translateChromaWhere;
+
+//# sourceMappingURL=chroma.cjs.map

package/batteries/vector/chroma.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma.cjs","names":["#opts","#client","#collectionCache"],"sources":["../../../src/batteries/vector/chroma/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/chroma\n */\n\nimport { normalizeScore } from '../helpers'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isFilterCondition, isRawFilter, 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_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  BaseVectorStoreOptions,\n  VectorStoreCapabilities,\n} from '../types'\n\nexport interface ChromaVectorStoreOptions extends BaseVectorStoreOptions {\n  connection?: { url?: string; host?: string; port?: number; ssl?: boolean }\n}\n\nconst getChromaClient = async () => {\n  try {\n    const mod = await import('chromadb')\n    return mod.ChromaClient\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['chromadb'])\n  }\n}\n\nconst getSpace = (metric: string): string => {\n  if (metric === 'cosine') return 'cosine'\n  if (metric === 'euclidean') return 'l2'\n  if (metric === 'dot') return 'ip'\n  return 'cosine'\n}\n\nexport const translateChromaWhere = (\n  filter?: VectorFilter\n): Record<string, unknown> | undefined => {\n  if (!filter) return undefined\n  if (isRawFilter(filter)) {\n    if (filter.$dialect === 'chroma') {\n      return filter.$raw as Record<string, unknown>\n    }\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['chroma', String(filter.$dialect)])\n  }\n  if (isFilterCondition(filter)) {\n    const { field, op, value } = filter\n    if (value === undefined) {\n      throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['chroma', op])\n    }\n    if (op === 'eq') {\n      return { [field]: { $eq: value } }\n    }\n    if (op === 'ne') {\n      return { [field]: { $ne: value } }\n    }\n    if (op === 'gt') {\n      return { [field]: { $gt: value } }\n    }\n    if (op === 'gte') {\n      return { [field]: { $gte: value } }\n    }\n    if (op === 'lt') {\n      return { [field]: { $lt: value } }\n    }\n    if (op === 'lte') {\n      return { [field]: { $lte: value } }\n    }\n    if (op === 'in') {\n      return { [field]: { $in: value } }\n    }\n    if (op === 'nin') {\n      return { [field]: { $nin: value } }\n    }\n    if (op === 'exists' || op === 'contains') {\n      throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['chroma', op])\n    }\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['chroma', op])\n  }\n  if (isFilterGroup(filter)) {\n    const { and, or, not } = filter\n    if (and) {\n      const children = and\n        .map((f) => translateChromaWhere(f) as Record<string, unknown>)\n        .filter((c) => c !== undefined)\n      if (children.length === 0) return undefined\n      if (children.length === 1) return children[0]\n      return { $and: children }\n    }\n    if (or) {\n      const children = or\n        .map((f) => translateChromaWhere(f) as Record<string, unknown>)\n        .filter((c) => c !== undefined)\n      if (children.length === 0) return undefined\n      if (children.length === 1) return children[0]\n      return { $or: children }\n    }\n    if (not) {\n      throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['chroma', 'not'])\n    }\n    return undefined\n  }\n  return undefined\n}\n\nexport class ChromaVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: true,\n    rawSql: false,\n    builtInEncoding: false,\n    // Strongly consistent on resolve; the option is a no-op.\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n  #client: any | null = null\n  #collectionCache: Map<string, any> = new Map()\n  get #opts() {\n    return this.options as ChromaVectorStoreOptions\n  }\n\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#client) return\n    const ChromaClient = await getChromaClient()\n    const c = this.#opts.connection || {}\n    let host: string | undefined\n    let port: number | undefined\n    let ssl: boolean = false\n\n    if (c.url) {\n      const url = new URL(c.url)\n      host = url.hostname\n      port = url.port ? Number.parseInt(url.port, 10) : url.protocol === 'https:' ? 443 : 80\n      ssl = url.protocol === 'https:'\n    } else {\n      host = c.host\n      port = c.port\n      ssl = c.ssl || false\n    }\n\n    const path =\n      host && port !== undefined\n        ? `${ssl ? 'https://' : 'http://'}${host}${port === 80 || port === 443 ? '' : ':' + port}`\n        : undefined\n\n    try {\n      this.#client = new ChromaClient({ path })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    this.#client = null\n    this.#collectionCache.clear()\n  }\n\n  async getCollection(name: string): Promise<any> {\n    let collection = this.#collectionCache.get(name)\n    if (collection) return collection\n    if (!this.#client) await this.connect()\n    const metric = this.#opts.metric ?? 'cosine'\n    collection = await this.#client.getOrCreateCollection({\n      name,\n      metadata: { 'hnsw:space': getSpace(metric) },\n    })\n    this.#collectionCache.set(name, collection)\n    return collection\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const name = spec.collection\n    if (ifNotExists && (await this.hasCollection(name))) return\n    if (await this.hasCollection(name)) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['create', 'exists'])\n    }\n    try {\n      await this.connect()\n      const metric = spec.vector.metric ?? 'cosine'\n      await this.#client!.getOrCreateCollection({\n        name,\n        metadata: { 'hnsw:space': getSpace(metric) },\n      })\n      this.#collectionCache.set(name, null)\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    if (ifExists && !(await this.hasCollection(collection))) return\n    try {\n      await this.connect()\n      await this.#client!.deleteCollection({ name: collection })\n      this.#collectionCache.delete(collection)\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', String(err)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    if (!this.#client) await this.connect()\n    try {\n      const collections = await this.#client!.listCollections()\n      for (const c of collections) {\n        if (typeof c === 'object' ? c.name === collection : c === collection) {\n          return true\n        }\n      }\n      return false\n    } catch {\n      return false\n    }\n  }\n\n  async renameCollection(from: string, to: string): Promise<void> {\n    try {\n      const collection = await this.getCollection(from)\n      await collection.modify({ name: to })\n      const cached = this.#collectionCache.get(from)\n      this.#collectionCache.delete(from)\n      if (cached) {\n        this.#collectionCache.set(to, cached)\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['renameCollection', String(err)])\n    }\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const collection = await this.getCollection(plan.collection)\n    const expected = this.#opts.dimensions\n    const ids: string[] = []\n    const embeddings: number[][] = []\n    const documents: string[] = []\n    const metadatas: VectorMetadata[] = []\n\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) {\n        throw new E_VECTOR_STORE_UPSERT_FAILED(['Record missing vector and document'])\n      }\n      if (expected !== undefined && vector.length !== expected) {\n        throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length])\n      }\n      ids.push(r.id)\n      embeddings.push(vector)\n      documents.push(r.document ?? '')\n      const md = { ...(r.metadata ?? {}), internalId: r.id }\n      metadatas.push(md)\n    }\n\n    try {\n      await collection.upsert({ ids, embeddings, documents, metadatas })\n    } catch (err) {\n      throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)])\n    }\n  }\n\n  async executeSearch(plan: SearchPlan): Promise<VectorMatch[]> {\n    const collection = await this.getCollection(plan.collection)\n    const metric = this.#opts.metric ?? 'cosine'\n    let queryVector: number[] | undefined\n\n    if (plan.near) {\n      if ('vector' in plan.near) {\n        queryVector = plan.near.vector\n      } else if ('serverText' in plan.near) {\n        const [v] = await this.encode([plan.near.serverText], 'query')\n        queryVector = v\n      } else if ('id' in plan.near) {\n        const res = await collection.get({ ids: [plan.near.id], include: ['embeddings'] })\n        if (!res.ids || res.ids.length === 0) {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n        const embeddings = res.embeddings || []\n        if (!embeddings || embeddings.length === 0 || !embeddings[0]) {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id has no vector: ' + plan.near.id])\n        }\n        queryVector = embeddings[0]\n      }\n    }\n\n    const where = translateChromaWhere(plan.filter)\n\n    let results: any\n    if (queryVector) {\n      try {\n        results = await collection.query({\n          queryEmbeddings: [queryVector],\n          nResults: plan.topK,\n          where,\n          include: ['documents', 'metadatas', 'distances', 'embeddings'],\n        })\n      } catch (err) {\n        throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n      }\n    } else {\n      try {\n        results = await collection.get({\n          where,\n          limit: plan.topK,\n          include: ['documents', 'metadatas', 'embeddings'],\n        })\n      } catch (err) {\n        throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n      }\n    }\n\n    const proj = plan.projection\n    const out: VectorMatch[] = []\n    // `query()` returns per-query nested arrays (`ids: [[...]]`); `get()` (the filter-scan path)\n    // returns flat arrays (`ids: [...]`). Unwrap one level only for the query path.\n    const unwrap = (col: any): any[] => {\n      if (!col) return []\n      return queryVector ? (col[0] ?? []) : col\n    }\n    const ids = unwrap(results.ids)\n    const documents = unwrap(results.documents)\n    const metadatas = unwrap(results.metadatas)\n    const embeddings = unwrap(results.embeddings)\n    const distances = unwrap(results.distances)\n\n    const start = plan.offset || 0\n    const limit = plan.topK\n\n    for (let i = start; i < Math.min(ids.length, start + limit); i++) {\n      const match: VectorMatch = {}\n      if (proj.id) {\n        match.id = ids[i]\n      }\n      if (proj.vector && embeddings[i]) {\n        match.vector = embeddings[i]\n      }\n      if (proj.document) {\n        match.document = documents[i] ?? undefined\n      }\n      if (proj.metadata && metadatas[i]) {\n        const rawMeta = metadatas[i] as VectorMetadata\n        const { internalId, ...rest } = rawMeta\n        match.metadata = rest\n      }\n      if (queryVector && distances && distances[i] !== undefined) {\n        match.score = normalizeScore(distances[i], metric, 'distance')\n      }\n      out.push(match)\n    }\n\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const collection = await this.getCollection(plan.collection)\n    try {\n      if (plan.ids) {\n        await collection.delete({ ids: plan.ids })\n      } else if (plan.filter) {\n        const where = translateChromaWhere(plan.filter)\n        if (where) {\n          await collection.delete({ where })\n        } else {\n          await collection.delete({ where: {} })\n        }\n      } else {\n        await collection.delete({ where: {} })\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([String(err)])\n    }\n  }\n}\n"],"mappings":"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"}

package/batteries/vector/chroma.mjs

@@ -0,0 +1,302 @@
+import { 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_UPSERT_FAILED } from "./exceptions.mjs";
+import { BaseVectorStore } from "./contract.mjs";
+import { validateRecords } from "./validation.mjs";
+//#region src/batteries/vector/chroma/index.ts
+/**
+* @module @nhtio/adk/batteries/vector/chroma
+*/
+var getChromaClient = async () => {
+	try {
+		return (await import("chromadb")).ChromaClient;
+	} catch {
+		throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(["chromadb"]);
+	}
+};
+var getSpace = (metric) => {
+	if (metric === "cosine") return "cosine";
+	if (metric === "euclidean") return "l2";
+	if (metric === "dot") return "ip";
+	return "cosine";
+};
+var translateChromaWhere = (filter) => {
+	if (!filter) return void 0;
+	if (isRawFilter(filter)) {
+		if (filter.$dialect === "chroma") return filter.$raw;
+		throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", String(filter.$dialect)]);
+	}
+	if (isFilterCondition(filter)) {
+		const { field, op, value } = filter;
+		if (value === void 0) throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+		if (op === "eq") return { [field]: { $eq: value } };
+		if (op === "ne") return { [field]: { $ne: value } };
+		if (op === "gt") return { [field]: { $gt: value } };
+		if (op === "gte") return { [field]: { $gte: value } };
+		if (op === "lt") return { [field]: { $lt: value } };
+		if (op === "lte") return { [field]: { $lte: value } };
+		if (op === "in") return { [field]: { $in: value } };
+		if (op === "nin") return { [field]: { $nin: value } };
+		if (op === "exists" || op === "contains") throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+		throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", op]);
+	}
+	if (isFilterGroup(filter)) {
+		const { and, or, not } = filter;
+		if (and) {
+			const children = and.map((f) => translateChromaWhere(f)).filter((c) => c !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return { $and: children };
+		}
+		if (or) {
+			const children = or.map((f) => translateChromaWhere(f)).filter((c) => c !== void 0);
+			if (children.length === 0) return void 0;
+			if (children.length === 1) return children[0];
+			return { $or: children };
+		}
+		if (not) throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["chroma", "not"]);
+		return;
+	}
+};
+var ChromaVectorStore = class extends BaseVectorStore {
+	capabilities = {
+		transactions: false,
+		namedVectors: false,
+		rename: true,
+		rawSql: false,
+		builtInEncoding: false,
+		consistency: {
+			configurable: false,
+			default: "strong",
+			modes: ["strong"]
+		}
+	};
+	#client = null;
+	#collectionCache = /* @__PURE__ */ new Map();
+	get #opts() {
+		return this.options;
+	}
+	static isAvailable() {
+		return typeof process !== "undefined";
+	}
+	isAvailable() {
+		return typeof process !== "undefined";
+	}
+	async connect() {
+		if (this.#client) return;
+		const ChromaClient = await getChromaClient();
+		const c = this.#opts.connection || {};
+		let host;
+		let port;
+		let ssl = false;
+		if (c.url) {
+			const url = new URL(c.url);
+			host = url.hostname;
+			port = url.port ? Number.parseInt(url.port, 10) : url.protocol === "https:" ? 443 : 80;
+			ssl = url.protocol === "https:";
+		} else {
+			host = c.host;
+			port = c.port;
+			ssl = c.ssl || false;
+		}
+		const path = host && port !== void 0 ? `${ssl ? "https://" : "http://"}${host}${port === 80 || port === 443 ? "" : ":" + port}` : void 0;
+		try {
+			this.#client = new ChromaClient({ path });
+		} catch (err) {
+			throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)]);
+		}
+	}
+	async close() {
+		this.#client = null;
+		this.#collectionCache.clear();
+	}
+	async getCollection(name) {
+		let collection = this.#collectionCache.get(name);
+		if (collection) return collection;
+		if (!this.#client) await this.connect();
+		const metric = this.#opts.metric ?? "cosine";
+		collection = await this.#client.getOrCreateCollection({
+			name,
+			metadata: { "hnsw:space": getSpace(metric) }
+		});
+		this.#collectionCache.set(name, collection);
+		return collection;
+	}
+	async createCollection(spec, ifNotExists) {
+		const name = spec.collection;
+		if (ifNotExists && await this.hasCollection(name)) return;
+		if (await this.hasCollection(name)) throw new E_VECTOR_STORE_COLLECTION_FAILED(["create", "exists"]);
+		try {
+			await this.connect();
+			const metric = spec.vector.metric ?? "cosine";
+			await this.#client.getOrCreateCollection({
+				name,
+				metadata: { "hnsw:space": getSpace(metric) }
+			});
+			this.#collectionCache.set(name, null);
+		} catch (err) {
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["createCollection", String(err)]);
+		}
+	}
+	async dropCollection(collection, ifExists) {
+		if (ifExists && !await this.hasCollection(collection)) return;
+		try {
+			await this.connect();
+			await this.#client.deleteCollection({ name: collection });
+			this.#collectionCache.delete(collection);
+		} catch (err) {
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["dropCollection", String(err)]);
+		}
+	}
+	async hasCollection(collection) {
+		if (!this.#client) await this.connect();
+		try {
+			const collections = await this.#client.listCollections();
+			for (const c of collections) if (typeof c === "object" ? c.name === collection : c === collection) return true;
+			return false;
+		} catch {
+			return false;
+		}
+	}
+	async renameCollection(from, to) {
+		try {
+			await (await this.getCollection(from)).modify({ name: to });
+			const cached = this.#collectionCache.get(from);
+			this.#collectionCache.delete(from);
+			if (cached) this.#collectionCache.set(to, cached);
+		} catch (err) {
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["renameCollection", String(err)]);
+		}
+	}
+	async executeUpsert(plan) {
+		if (plan.records.length === 0) return;
+		validateRecords(plan.records);
+		const collection = await this.getCollection(plan.collection);
+		const expected = this.#opts.dimensions;
+		const ids = [];
+		const embeddings = [];
+		const documents = [];
+		const metadatas = [];
+		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 (expected !== void 0 && vector.length !== expected) throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length]);
+			ids.push(r.id);
+			embeddings.push(vector);
+			documents.push(r.document ?? "");
+			const md = {
+				...r.metadata ?? {},
+				internalId: r.id
+			};
+			metadatas.push(md);
+		}
+		try {
+			await collection.upsert({
+				ids,
+				embeddings,
+				documents,
+				metadatas
+			});
+		} catch (err) {
+			throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)]);
+		}
+	}
+	async executeSearch(plan) {
+		const collection = await this.getCollection(plan.collection);
+		const metric = this.#opts.metric ?? "cosine";
+		let queryVector;
+		if (plan.near) {
+			if ("vector" in plan.near) queryVector = plan.near.vector;
+			else if ("serverText" in plan.near) {
+				const [v] = await this.encode([plan.near.serverText], "query");
+				queryVector = v;
+			} else if ("id" in plan.near) {
+				const res = await collection.get({
+					ids: [plan.near.id],
+					include: ["embeddings"]
+				});
+				if (!res.ids || res.ids.length === 0) throw new E_VECTOR_STORE_SEARCH_FAILED(["Referenced id not found: " + plan.near.id]);
+				const embeddings = res.embeddings || [];
+				if (!embeddings || embeddings.length === 0 || !embeddings[0]) throw new E_VECTOR_STORE_SEARCH_FAILED(["Referenced id has no vector: " + plan.near.id]);
+				queryVector = embeddings[0];
+			}
+		}
+		const where = translateChromaWhere(plan.filter);
+		let results;
+		if (queryVector) try {
+			results = await collection.query({
+				queryEmbeddings: [queryVector],
+				nResults: plan.topK,
+				where,
+				include: [
+					"documents",
+					"metadatas",
+					"distances",
+					"embeddings"
+				]
+			});
+		} catch (err) {
+			throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+		else try {
+			results = await collection.get({
+				where,
+				limit: plan.topK,
+				include: [
+					"documents",
+					"metadatas",
+					"embeddings"
+				]
+			});
+		} catch (err) {
+			throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+		const proj = plan.projection;
+		const out = [];
+		const unwrap = (col) => {
+			if (!col) return [];
+			return queryVector ? col[0] ?? [] : col;
+		};
+		const ids = unwrap(results.ids);
+		const documents = unwrap(results.documents);
+		const metadatas = unwrap(results.metadatas);
+		const embeddings = unwrap(results.embeddings);
+		const distances = unwrap(results.distances);
+		const start = plan.offset || 0;
+		const limit = plan.topK;
+		for (let i = start; i < Math.min(ids.length, start + limit); i++) {
+			const match = {};
+			if (proj.id) match.id = ids[i];
+			if (proj.vector && embeddings[i]) match.vector = embeddings[i];
+			if (proj.document) match.document = documents[i] ?? void 0;
+			if (proj.metadata && metadatas[i]) {
+				const { internalId, ...rest } = metadatas[i];
+				match.metadata = rest;
+			}
+			if (queryVector && distances && distances[i] !== void 0) match.score = normalizeScore(distances[i], metric, "distance");
+			out.push(match);
+		}
+		return out;
+	}
+	async executeDelete(plan) {
+		const collection = await this.getCollection(plan.collection);
+		try {
+			if (plan.ids) await collection.delete({ ids: plan.ids });
+			else if (plan.filter) {
+				const where = translateChromaWhere(plan.filter);
+				if (where) await collection.delete({ where });
+				else await collection.delete({ where: {} });
+			} else await collection.delete({ where: {} });
+		} catch (err) {
+			throw new E_VECTOR_STORE_DELETE_FAILED([String(err)]);
+		}
+	}
+};
+//#endregion
+export { ChromaVectorStore, translateChromaWhere };
+
+//# sourceMappingURL=chroma.mjs.map