@nhtio/adk 0.1.0-master-2a4e1bd2 → 0.1.0-master-cd595e6f

package/batteries/vector/conformance.cjs

@@ -1,15 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-let vitest = require("vitest");
 //#region src/batteries/vector/conformance/index.ts
-/**
-* Shared conformance suite for vector-store adapters. Drive any adapter through
-* {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.
-* Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`) — it imports `vitest`, an
-* optional peer you install to run the suite; it is never pulled in by the battery barrel.
-*
-* @module @nhtio/adk/batteries/vector/conformance
-*/
 /** A deterministic stub encoder producing a 3-dim vector from simple text features. */
 var stubEncoder = async (texts, _kind) => texts.map((tx) => [
 	tx.length,
@@ -45,14 +36,93 @@ var padVector = (v, dim) => {
 * @param dim - Vector dimensionality the harness pads to (default 3).
 * @param opts - Per-`it` retry/timeout overrides.
 */
-var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
+var assert = (condition, message) => {
+	if (!condition) throw new Error(message);
+};
+var equal = (actual, expected) => {
+	if (actual === expected) return true;
+	if (actual === null || expected === null || typeof actual !== "object" || typeof expected !== "object") return false;
+	if (Array.isArray(actual) !== Array.isArray(expected)) return false;
+	const actualRecord = actual;
+	const expectedRecord = expected;
+	const keysA = Object.keys(actualRecord);
+	const keysB = Object.keys(expectedRecord);
+	if (keysA.length !== keysB.length) return false;
+	return keysA.every((key) => Object.hasOwn(expectedRecord, key) && equal(actualRecord[key], expectedRecord[key]));
+};
+var match = (actual, expected) => {
+	if (expected === null || typeof expected !== "object") return equal(actual, expected);
+	if (actual === null || typeof actual !== "object") return false;
+	return Object.entries(expected).every(([key, value]) => match(actual[key], value));
+};
+var expectValue = (actual) => ({
+	toBe: (expected) => assert(equal(actual, expected), `expected ${String(actual)} to be ${String(expected)}`),
+	toEqual: (expected) => assert(equal(actual, expected), "values were not equal"),
+	toMatchObject: (expected) => assert(match(actual, expected), "value did not match expected object"),
+	toBeDefined: () => assert(actual !== void 0, "value was undefined"),
+	toBeUndefined: () => assert(actual === void 0, "value was defined"),
+	toHaveLength: (length) => assert(actual.length === length, "unexpected length"),
+	rejects: { toThrow: async () => {
+		try {
+			await actual;
+		} catch {
+			return;
+		}
+		throw new Error("expected promise to reject");
+	} }
+});
+/**
+* Run the framework-free vector-store conformance suite against a consumer implementation.
+*
+* Each check creates a fresh store through `makeStore`; the returned promise rejects when any
+* contract assertion fails. Consumers can await this function from any test runner without
+* importing a test framework from the conformance module.
+*
+* @param label - Human-readable name used to identify the implementation under test.
+* @param makeStore - Factory returning a fresh, connected store with the `docs` collection.
+* @param dim - Vector dimensionality used by the suite (defaults to 3).
+* @param opts - Retry count and per-attempt timeout in milliseconds for eventually consistent stores.
+*/
+var runVectorStoreConformance = async (label, makeStore, dim = 3, opts = {}) => {
 	const p = (v) => padVector(v, dim);
-	const io = {
-		retry: opts.retry ?? 0,
-		timeout: opts.timeout ?? 5e3
+	const pending = [];
+	const retry = opts.retry ?? 0;
+	const timeout = opts.timeout ?? 5e3;
+	const runCase = async (test) => {
+		let last;
+		for (let attempt = 0; attempt <= retry; attempt++) {
+			let timedOut = false;
+			const operation = Promise.resolve().then(test);
+			let timer;
+			const deadline = new Promise((_, reject) => {
+				timer = setTimeout(() => {
+					timedOut = true;
+					reject(/* @__PURE__ */ new Error(`conformance check timed out after ${timeout}ms`));
+				}, timeout);
+			});
+			try {
+				await Promise.race([operation, deadline]);
+				return;
+			} catch (error) {
+				if (timedOut) {
+					last = error;
+					break;
+				}
+				last = error;
+			} finally {
+				if (timer !== void 0) clearTimeout(timer);
+			}
+		}
+		throw last;
+	};
+	const it = (_name, _io, test) => {
+		pending.push(() => runCase(test));
 	};
-	(0, vitest.describe)("conformance: " + label, () => {
-		(0, vitest.it)("upserts vectors and searches by nearVector with [0,1] score", io, async () => {
+	const describe = (_name, suite) => suite();
+	const expect = expectValue;
+	const io = void 0;
+	describe("conformance: " + label, () => {
+		it("upserts vectors and searches by nearVector with [0,1] score", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([{
 				id: "1",
@@ -76,12 +146,12 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				1,
 				0
 			])).select("id", "score").limit(2);
-			(0, vitest.expect)(res.length).toBe(2);
-			(0, vitest.expect)(res[0].id).toBeDefined();
-			(0, vitest.expect)(typeof res[0].score).toBe("number");
-			(0, vitest.expect)(res[0].score >= 0 && res[0].score <= 1).toBe(true);
+			expect(res.length).toBe(2);
+			expect(res[0].id).toBeDefined();
+			expect(typeof res[0].score).toBe("number");
+			expect(res[0].score >= 0 && res[0].score <= 1).toBe(true);
 		});
-		(0, vitest.it)("encodes text on upsert+nearText when an encoder is configured", io, async () => {
+		it("encodes text on upsert+nearText when an encoder is configured", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([{
 				id: "c",
@@ -89,12 +159,12 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				metadata: {}
 			}]);
 			const res = await vs("docs").nearText("cat").select("id").limit(1);
-			(0, vitest.expect)(res.length).toBe(1);
-			(0, vitest.expect)(res[0].id).toBe("c");
+			expect(res.length).toBe(1);
+			expect(res[0].id).toBe("c");
 		});
-		(0, vitest.it)("requires .select() on reads", io, async () => {
+		it("requires .select() on reads", io, async () => {
 			const vs = await makeStore();
-			await (0, vitest.expect)((async () => {
+			await expect((async () => {
 				await vs("docs").nearVector(p([
 					1,
 					1,
@@ -102,7 +172,7 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				]));
 			})()).rejects.toThrow();
 		});
-		(0, vitest.it)("filter-scan (no near) returns rows without score", io, async () => {
+		it("filter-scan (no near) returns rows without score", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([{
 				id: "1",
@@ -114,10 +184,10 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				metadata: { kind: "x" }
 			}]);
 			const res = await vs("docs").where("kind", "x").select("id", "metadata").limit(10);
-			(0, vitest.expect)(res.length).toBe(1);
-			(0, vitest.expect)(res[0].score).toBeUndefined();
+			expect(res.length).toBe(1);
+			expect(res[0].score).toBeUndefined();
 		});
-		(0, vitest.it)("nested filter A AND (B OR C) selects the right subset", io, async () => {
+		it("nested filter A AND (B OR C) selects the right subset", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([
 				{
@@ -173,9 +243,9 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 					}
 				}
 			]);
-			(0, vitest.expect)((await vs("docs").where("kind", "doc").andWhere((qb) => qb.where("year", ">=", 2024).orWhere("pinned", true)).select("id").limit(10)).map((r) => r.id).sort()).toEqual(["a", "c"]);
+			expect((await vs("docs").where("kind", "doc").andWhere((qb) => qb.where("year", ">=", 2024).orWhere("pinned", true)).select("id").limit(10)).map((r) => r.id).sort()).toEqual(["a", "c"]);
 		});
-		(0, vitest.it)("projection: vector excluded unless selected", io, async () => {
+		it("projection: vector excluded unless selected", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([{
 				id: "1",
@@ -185,7 +255,7 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 					0
 				])
 			}]);
-			(0, vitest.expect)((await vs("docs").nearVector(p([
+			expect((await vs("docs").nearVector(p([
 				1,
 				0,
 				0
@@ -195,9 +265,9 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				0,
 				0
 			])).select("id", "vector").limit(1);
-			(0, vitest.expect)(Array.isArray(withVec[0].vector)).toBe(true);
+			expect(Array.isArray(withVec[0].vector)).toBe(true);
 		});
-		(0, vitest.it)("deletes by id", io, async () => {
+		it("deletes by id", io, async () => {
 			const vs = await makeStore();
 			await vs("docs").upsert([{
 				id: "1",
@@ -215,13 +285,14 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 				])
 			}]);
 			await vs("docs").whereIn("id", ["1"]).delete();
-			(0, vitest.expect)((await vs("docs").select("id").limit(10)).length).toBe(1);
+			expect((await vs("docs").select("id").limit(10)).length).toBe(1);
 		});
-		(0, vitest.it)("throws transaction-unsupported when capabilities.transactions is false", io, async () => {
+		it("throws transaction-unsupported when capabilities.transactions is false", io, async () => {
 			const vs = await makeStore();
-			if (!vs.capabilities.transactions) await (0, vitest.expect)(vs.transaction(async () => {})).rejects.toThrow();
+			if (!vs.capabilities.transactions) await expect(vs.transaction(async () => {})).rejects.toThrow();
 		});
 	});
+	for (const fn of pending) await fn();
 };
 //#endregion
 exports.paddedStubEncoder = paddedStubEncoder;

package/batteries/vector/conformance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.cjs","names":[],"sources":["../../../src/batteries/vector/conformance/index.ts"],"sourcesContent":["/**\n * Shared conformance suite for vector-store adapters. Drive any adapter through\n * {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.\n * Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`) — it imports `vitest`, an\n * optional peer you install to run the suite; it is never pulled in by the battery barrel.\n *\n * @module @nhtio/adk/batteries/vector/conformance\n */\n\nimport { describe, expect, it } from 'vitest'\nimport type { CallableVectorStore } from '../contract'\n\n/** A deterministic stub encoder producing a 3-dim vector from simple text features. */\nexport const stubEncoder = async (\n  texts: string[],\n  _kind: 'query' | 'document'\n): Promise<number[][]> =>\n  texts.map((tx) => [tx.length, tx.includes('cat') ? 1 : 0, tx.includes('dog') ? 1 : 0])\n\n/**\n * A dimension-padding encoder factory: wraps {@link stubEncoder} and zero-extends to `dim`. Used by\n * backends that enforce a minimum dimension (e.g. Cloudflare Vectorize requires 32–1536).\n */\nexport const paddedStubEncoder =\n  (dim: number) =>\n  async (texts: string[], kind: 'query' | 'document'): Promise<number[][]> => {\n    const base = await stubEncoder(texts, kind)\n    return base.map((v) => padVector(v, dim))\n  }\n\n// Zero-extend (or truncate) a vector to exactly `dim` entries. dim===3 (the default) returns the\n// vector unchanged, so existing callers are byte-for-byte identical.\nconst padVector = (v: number[], dim: number): number[] => {\n  if (v.length === dim) return v\n  if (v.length > dim) return v.slice(0, dim)\n  return [...v, ...new Array(dim - v.length).fill(0)]\n}\n\n/**\n * Drive a vector-store adapter through the shared contract suite.\n *\n * @remarks\n * `makeStore` must return an already-connected store whose `'docs'` collection is created at the\n * matching dimension; it is re-invoked per test so retries are self-contained. `dim` defaults to 3\n * — pass a larger value for backends with a dimension floor (the harness pads every test vector to\n * `dim`). `opts.retry` / `opts.timeout` are forwarded to every `it()` (defaults: retry 0, 5s) and\n * exist for aggressively eventually-consistent managed backends whose read-after-write can flap for\n * seconds — a retried attempt re-runs `makeStore()` against an index that has had more time to\n * settle, without weakening any assertion.\n *\n * @param label - Human-readable label for the suite (the adapter name).\n * @param makeStore - Factory returning a fresh, connected store with the `'docs'` collection.\n * @param dim - Vector dimensionality the harness pads to (default 3).\n * @param opts - Per-`it` retry/timeout overrides.\n */\nexport const runVectorStoreConformance = (\n  label: string,\n  makeStore: () => Promise<CallableVectorStore>,\n  dim = 3,\n  opts: { retry?: number; timeout?: number } = {}\n): void => {\n  const p = (v: number[]): number[] => padVector(v, dim)\n  const io = { retry: opts.retry ?? 0, timeout: opts.timeout ?? 5000 }\n  describe('conformance: ' + label, () => {\n    it('upserts vectors and searches by nearVector with [0,1] score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([3, 1, 0]), metadata: { kind: 'animal' } },\n        { id: '2', vector: p([3, 0, 1]), metadata: { kind: 'animal' } },\n      ])\n      const res = await vs('docs')\n        .nearVector(p([3, 1, 0]))\n        .select('id', 'score')\n        .limit(2)\n      expect(res.length).toBe(2)\n      expect(res[0].id).toBeDefined()\n      expect(typeof res[0].score).toBe('number')\n      expect(res[0].score! >= 0 && res[0].score! <= 1).toBe(true)\n    })\n    it('encodes text on upsert+nearText when an encoder is configured', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: 'c', document: 'cat', metadata: {} }])\n      const res = await vs('docs').nearText('cat').select('id').limit(1)\n      expect(res.length).toBe(1)\n      expect(res[0].id).toBe('c')\n    })\n    it('requires .select() on reads', io, async () => {\n      const vs = await makeStore()\n      await expect(\n        (async () => {\n          await vs('docs').nearVector(p([1, 1, 1]))\n        })()\n      ).rejects.toThrow()\n    })\n    it('filter-scan (no near) returns rows without score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]), metadata: { kind: 'x' } }])\n      const res = await vs('docs').where('kind', 'x').select('id', 'metadata').limit(10)\n      expect(res.length).toBe(1)\n      expect(res[0].score).toBeUndefined()\n    })\n    it('nested filter A AND (B OR C) selects the right subset', io, async () => {\n      const vs = await makeStore()\n      // Every record carries all three fields so the test probes nested AND/OR routing, not\n      // backend-specific missing-field semantics (e.g. Chroma's $or excludes records missing a\n      // referenced key, where the JS evaluator treats that clause as merely false).\n      await vs('docs').upsert([\n        { id: 'a', vector: p([1, 0, 0]), metadata: { kind: 'doc', year: 2024, pinned: false } }, // kept (year arm)\n        { id: 'b', vector: p([0, 1, 0]), metadata: { kind: 'doc', year: 2010, pinned: false } }, // dropped (neither arm)\n        { id: 'c', vector: p([0, 0, 1]), metadata: { kind: 'doc', year: 2010, pinned: true } }, // kept (pinned arm)\n        { id: 'd', vector: p([1, 1, 0]), metadata: { kind: 'other', year: 2024, pinned: true } }, // dropped (kind mismatch)\n      ])\n      // kind = 'doc' AND (year >= 2024 OR pinned = true)\n      const res = await vs('docs')\n        .where('kind', 'doc')\n        .andWhere((qb) => qb.where('year', '>=', 2024).orWhere('pinned', true))\n        .select('id')\n        .limit(10)\n      expect(res.map((r) => r.id).sort()).toEqual(['a', 'c'])\n    })\n    it('projection: vector excluded unless selected', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]) }])\n      const noVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id')\n        .limit(1)\n      expect(noVec[0].vector).toBeUndefined()\n      const withVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id', 'vector')\n        .limit(1)\n      expect(Array.isArray(withVec[0].vector)).toBe(true)\n    })\n    it('deletes by id', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([1, 0, 0]) },\n        { id: '2', vector: p([0, 1, 0]) },\n      ])\n      await vs('docs').whereIn('id', ['1']).delete()\n      const all = await vs('docs').select('id').limit(10)\n      expect(all.length).toBe(1)\n    })\n    it('throws transaction-unsupported when capabilities.transactions is false', io, async () => {\n      const vs = await makeStore()\n      if (!vs.capabilities.transactions) {\n        await expect(vs.transaction(async () => {})).rejects.toThrow()\n      }\n    })\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"conformance.cjs","names":[],"sources":["../../../src/batteries/vector/conformance/index.ts"],"sourcesContent":["/**\n * Shared conformance suite for vector-store adapters. Drive any adapter through\n * {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.\n * Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`). The suite has no test-runner\n * dependency: callers invoke it and await the returned promise from any test framework.\n *\n * @module @nhtio/adk/batteries/vector/conformance\n */\n\nimport type { CallableVectorStore } from '../contract'\n\n/** A deterministic stub encoder producing a 3-dim vector from simple text features. */\nexport const stubEncoder = async (\n  texts: string[],\n  _kind: 'query' | 'document'\n): Promise<number[][]> =>\n  texts.map((tx) => [tx.length, tx.includes('cat') ? 1 : 0, tx.includes('dog') ? 1 : 0])\n\n/**\n * A dimension-padding encoder factory: wraps {@link stubEncoder} and zero-extends to `dim`. Used by\n * backends that enforce a minimum dimension (e.g. Cloudflare Vectorize requires 32–1536).\n */\nexport const paddedStubEncoder =\n  (dim: number) =>\n  async (texts: string[], kind: 'query' | 'document'): Promise<number[][]> => {\n    const base = await stubEncoder(texts, kind)\n    return base.map((v) => padVector(v, dim))\n  }\n\n// Zero-extend (or truncate) a vector to exactly `dim` entries. dim===3 (the default) returns the\n// vector unchanged, so existing callers are byte-for-byte identical.\nconst padVector = (v: number[], dim: number): number[] => {\n  if (v.length === dim) return v\n  if (v.length > dim) return v.slice(0, dim)\n  return [...v, ...new Array(dim - v.length).fill(0)]\n}\n\n/**\n * Drive a vector-store adapter through the shared contract suite.\n *\n * @remarks\n * `makeStore` must return an already-connected store whose `'docs'` collection is created at the\n * matching dimension; it is re-invoked per test so retries are self-contained. `dim` defaults to 3\n * — pass a larger value for backends with a dimension floor (the harness pads every test vector to\n * `dim`). `opts.retry` / `opts.timeout` are forwarded to every `it()` (defaults: retry 0, 5s) and\n * exist for aggressively eventually-consistent managed backends whose read-after-write can flap for\n * seconds — a retried attempt re-runs `makeStore()` against an index that has had more time to\n * settle, without weakening any assertion.\n *\n * @param label - Human-readable label for the suite (the adapter name).\n * @param makeStore - Factory returning a fresh, connected store with the `'docs'` collection.\n * @param dim - Vector dimensionality the harness pads to (default 3).\n * @param opts - Per-`it` retry/timeout overrides.\n */\nconst assert: (condition: boolean, message: string) => asserts condition = (condition, message) => {\n  if (!condition) throw new Error(message)\n}\nconst equal = (actual: unknown, expected: unknown): boolean => {\n  if (actual === expected) return true\n  if (\n    actual === null ||\n    expected === null ||\n    typeof actual !== 'object' ||\n    typeof expected !== 'object'\n  )\n    return false\n  if (Array.isArray(actual) !== Array.isArray(expected)) return false\n  const actualRecord = actual as Record<string, unknown>\n  const expectedRecord = expected as Record<string, unknown>\n  const keysA = Object.keys(actualRecord)\n  const keysB = Object.keys(expectedRecord)\n  if (keysA.length !== keysB.length) return false\n  return keysA.every(\n    (key) => Object.hasOwn(expectedRecord, key) && equal(actualRecord[key], expectedRecord[key])\n  )\n}\nconst match = (actual: unknown, expected: unknown): boolean => {\n  if (expected === null || typeof expected !== 'object') return equal(actual, expected)\n  if (actual === null || typeof actual !== 'object') return false\n  return Object.entries(expected).every(([key, value]) =>\n    match((actual as Record<string, unknown>)[key], value)\n  )\n}\nconst expectValue = (actual: unknown) => ({\n  toBe: (expected: unknown) =>\n    assert(equal(actual, expected), `expected ${String(actual)} to be ${String(expected)}`),\n  toEqual: (expected: unknown) => assert(equal(actual, expected), 'values were not equal'),\n  toMatchObject: (expected: unknown) =>\n    assert(match(actual, expected), 'value did not match expected object'),\n  toBeDefined: () => assert(actual !== undefined, 'value was undefined'),\n  toBeUndefined: () => assert(actual === undefined, 'value was defined'),\n  toHaveLength: (length: number) =>\n    assert((actual as { length: number }).length === length, 'unexpected length'),\n  rejects: {\n    toThrow: async () => {\n      try {\n        await (actual as Promise<unknown>)\n      } catch {\n        return\n      }\n      throw new Error('expected promise to reject')\n    },\n  },\n})\n\n/**\n * Run the framework-free vector-store conformance suite against a consumer implementation.\n *\n * Each check creates a fresh store through `makeStore`; the returned promise rejects when any\n * contract assertion fails. Consumers can await this function from any test runner without\n * importing a test framework from the conformance module.\n *\n * @param label - Human-readable name used to identify the implementation under test.\n * @param makeStore - Factory returning a fresh, connected store with the `docs` collection.\n * @param dim - Vector dimensionality used by the suite (defaults to 3).\n * @param opts - Retry count and per-attempt timeout in milliseconds for eventually consistent stores.\n */\nexport const runVectorStoreConformance = async (\n  label: string,\n  makeStore: () => Promise<CallableVectorStore>,\n  dim = 3,\n  opts: { retry?: number; timeout?: number } = {}\n): Promise<void> => {\n  const p = (v: number[]): number[] => padVector(v, dim)\n  const pending: Array<() => Promise<void>> = []\n  const retry = opts.retry ?? 0\n  const timeout = opts.timeout ?? 5000\n  const runCase = async (test: () => Promise<void>): Promise<void> => {\n    let last: unknown\n    for (let attempt = 0; attempt <= retry; attempt++) {\n      let timedOut = false\n      const operation = Promise.resolve().then(test)\n      let timer: ReturnType<typeof setTimeout> | undefined\n      const deadline = new Promise<never>((_, reject) => {\n        timer = setTimeout(() => {\n          timedOut = true\n          reject(new Error(`conformance check timed out after ${timeout}ms`))\n        }, timeout)\n      })\n      try {\n        await Promise.race([operation, deadline])\n        return\n      } catch (error) {\n        // A timeout cannot cancel an arbitrary backend operation. Drain it before retrying so a\n        // late write/read from this attempt cannot race the fresh store made by the next attempt.\n        if (timedOut) {\n          last = error\n          break\n        }\n        last = error\n      } finally {\n        if (timer !== undefined) clearTimeout(timer)\n      }\n    }\n    throw last\n  }\n  const it = (_name: string, _io: unknown, test: () => Promise<void>) => {\n    pending.push(() => runCase(test))\n  }\n  const describe = (_name: string, suite: () => void) => suite()\n  const expect = expectValue\n  const io = undefined\n  describe('conformance: ' + label, () => {\n    it('upserts vectors and searches by nearVector with [0,1] score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([3, 1, 0]), metadata: { kind: 'animal' } },\n        { id: '2', vector: p([3, 0, 1]), metadata: { kind: 'animal' } },\n      ])\n      const res = await vs('docs')\n        .nearVector(p([3, 1, 0]))\n        .select('id', 'score')\n        .limit(2)\n      expect(res.length).toBe(2)\n      expect(res[0].id).toBeDefined()\n      expect(typeof res[0].score).toBe('number')\n      expect(res[0].score! >= 0 && res[0].score! <= 1).toBe(true)\n    })\n    it('encodes text on upsert+nearText when an encoder is configured', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: 'c', document: 'cat', metadata: {} }])\n      const res = await vs('docs').nearText('cat').select('id').limit(1)\n      expect(res.length).toBe(1)\n      expect(res[0].id).toBe('c')\n    })\n    it('requires .select() on reads', io, async () => {\n      const vs = await makeStore()\n      await expect(\n        (async () => {\n          await vs('docs').nearVector(p([1, 1, 1]))\n        })()\n      ).rejects.toThrow()\n    })\n    it('filter-scan (no near) returns rows without score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]), metadata: { kind: 'x' } }])\n      const res = await vs('docs').where('kind', 'x').select('id', 'metadata').limit(10)\n      expect(res.length).toBe(1)\n      expect(res[0].score).toBeUndefined()\n    })\n    it('nested filter A AND (B OR C) selects the right subset', io, async () => {\n      const vs = await makeStore()\n      // Every record carries all three fields so the test probes nested AND/OR routing, not\n      // backend-specific missing-field semantics (e.g. Chroma's $or excludes records missing a\n      // referenced key, where the JS evaluator treats that clause as merely false).\n      await vs('docs').upsert([\n        { id: 'a', vector: p([1, 0, 0]), metadata: { kind: 'doc', year: 2024, pinned: false } }, // kept (year arm)\n        { id: 'b', vector: p([0, 1, 0]), metadata: { kind: 'doc', year: 2010, pinned: false } }, // dropped (neither arm)\n        { id: 'c', vector: p([0, 0, 1]), metadata: { kind: 'doc', year: 2010, pinned: true } }, // kept (pinned arm)\n        { id: 'd', vector: p([1, 1, 0]), metadata: { kind: 'other', year: 2024, pinned: true } }, // dropped (kind mismatch)\n      ])\n      // kind = 'doc' AND (year >= 2024 OR pinned = true)\n      const res = await vs('docs')\n        .where('kind', 'doc')\n        .andWhere((qb) => qb.where('year', '>=', 2024).orWhere('pinned', true))\n        .select('id')\n        .limit(10)\n      expect(res.map((r) => r.id).sort()).toEqual(['a', 'c'])\n    })\n    it('projection: vector excluded unless selected', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]) }])\n      const noVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id')\n        .limit(1)\n      expect(noVec[0].vector).toBeUndefined()\n      const withVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id', 'vector')\n        .limit(1)\n      expect(Array.isArray(withVec[0].vector)).toBe(true)\n    })\n    it('deletes by id', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([1, 0, 0]) },\n        { id: '2', vector: p([0, 1, 0]) },\n      ])\n      await vs('docs').whereIn('id', ['1']).delete()\n      const all = await vs('docs').select('id').limit(10)\n      expect(all.length).toBe(1)\n    })\n    it('throws transaction-unsupported when capabilities.transactions is false', io, async () => {\n      const vs = await makeStore()\n      if (!vs.capabilities.transactions) {\n        await expect(vs.transaction(async () => {})).rejects.toThrow()\n      }\n    })\n  })\n  for (const fn of pending) {\n    await fn()\n  }\n}\n"],"mappings":"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"}

package/batteries/vector/conformance.mjs

@@ -1,13 +1,4 @@
-import { describe, expect, it } from "vitest";
 //#region src/batteries/vector/conformance/index.ts
-/**
-* Shared conformance suite for vector-store adapters. Drive any adapter through
-* {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.
-* Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`) — it imports `vitest`, an
-* optional peer you install to run the suite; it is never pulled in by the battery barrel.
-*
-* @module @nhtio/adk/batteries/vector/conformance
-*/
 /** A deterministic stub encoder producing a 3-dim vector from simple text features. */
 var stubEncoder = async (texts, _kind) => texts.map((tx) => [
 	tx.length,
@@ -43,12 +34,91 @@ var padVector = (v, dim) => {
 * @param dim - Vector dimensionality the harness pads to (default 3).
 * @param opts - Per-`it` retry/timeout overrides.
 */
-var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
+var assert = (condition, message) => {
+	if (!condition) throw new Error(message);
+};
+var equal = (actual, expected) => {
+	if (actual === expected) return true;
+	if (actual === null || expected === null || typeof actual !== "object" || typeof expected !== "object") return false;
+	if (Array.isArray(actual) !== Array.isArray(expected)) return false;
+	const actualRecord = actual;
+	const expectedRecord = expected;
+	const keysA = Object.keys(actualRecord);
+	const keysB = Object.keys(expectedRecord);
+	if (keysA.length !== keysB.length) return false;
+	return keysA.every((key) => Object.hasOwn(expectedRecord, key) && equal(actualRecord[key], expectedRecord[key]));
+};
+var match = (actual, expected) => {
+	if (expected === null || typeof expected !== "object") return equal(actual, expected);
+	if (actual === null || typeof actual !== "object") return false;
+	return Object.entries(expected).every(([key, value]) => match(actual[key], value));
+};
+var expectValue = (actual) => ({
+	toBe: (expected) => assert(equal(actual, expected), `expected ${String(actual)} to be ${String(expected)}`),
+	toEqual: (expected) => assert(equal(actual, expected), "values were not equal"),
+	toMatchObject: (expected) => assert(match(actual, expected), "value did not match expected object"),
+	toBeDefined: () => assert(actual !== void 0, "value was undefined"),
+	toBeUndefined: () => assert(actual === void 0, "value was defined"),
+	toHaveLength: (length) => assert(actual.length === length, "unexpected length"),
+	rejects: { toThrow: async () => {
+		try {
+			await actual;
+		} catch {
+			return;
+		}
+		throw new Error("expected promise to reject");
+	} }
+});
+/**
+* Run the framework-free vector-store conformance suite against a consumer implementation.
+*
+* Each check creates a fresh store through `makeStore`; the returned promise rejects when any
+* contract assertion fails. Consumers can await this function from any test runner without
+* importing a test framework from the conformance module.
+*
+* @param label - Human-readable name used to identify the implementation under test.
+* @param makeStore - Factory returning a fresh, connected store with the `docs` collection.
+* @param dim - Vector dimensionality used by the suite (defaults to 3).
+* @param opts - Retry count and per-attempt timeout in milliseconds for eventually consistent stores.
+*/
+var runVectorStoreConformance = async (label, makeStore, dim = 3, opts = {}) => {
 	const p = (v) => padVector(v, dim);
-	const io = {
-		retry: opts.retry ?? 0,
-		timeout: opts.timeout ?? 5e3
+	const pending = [];
+	const retry = opts.retry ?? 0;
+	const timeout = opts.timeout ?? 5e3;
+	const runCase = async (test) => {
+		let last;
+		for (let attempt = 0; attempt <= retry; attempt++) {
+			let timedOut = false;
+			const operation = Promise.resolve().then(test);
+			let timer;
+			const deadline = new Promise((_, reject) => {
+				timer = setTimeout(() => {
+					timedOut = true;
+					reject(/* @__PURE__ */ new Error(`conformance check timed out after ${timeout}ms`));
+				}, timeout);
+			});
+			try {
+				await Promise.race([operation, deadline]);
+				return;
+			} catch (error) {
+				if (timedOut) {
+					last = error;
+					break;
+				}
+				last = error;
+			} finally {
+				if (timer !== void 0) clearTimeout(timer);
+			}
+		}
+		throw last;
+	};
+	const it = (_name, _io, test) => {
+		pending.push(() => runCase(test));
 	};
+	const describe = (_name, suite) => suite();
+	const expect = expectValue;
+	const io = void 0;
 	describe("conformance: " + label, () => {
 		it("upserts vectors and searches by nearVector with [0,1] score", io, async () => {
 			const vs = await makeStore();
@@ -220,6 +290,7 @@ var runVectorStoreConformance = (label, makeStore, dim = 3, opts = {}) => {
 			if (!vs.capabilities.transactions) await expect(vs.transaction(async () => {})).rejects.toThrow();
 		});
 	});
+	for (const fn of pending) await fn();
 };
 //#endregion
 export { paddedStubEncoder, runVectorStoreConformance, stubEncoder };

package/batteries/vector/conformance.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.mjs","names":[],"sources":["../../../src/batteries/vector/conformance/index.ts"],"sourcesContent":["/**\n * Shared conformance suite for vector-store adapters. Drive any adapter through\n * {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.\n * Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`) — it imports `vitest`, an\n * optional peer you install to run the suite; it is never pulled in by the battery barrel.\n *\n * @module @nhtio/adk/batteries/vector/conformance\n */\n\nimport { describe, expect, it } from 'vitest'\nimport type { CallableVectorStore } from '../contract'\n\n/** A deterministic stub encoder producing a 3-dim vector from simple text features. */\nexport const stubEncoder = async (\n  texts: string[],\n  _kind: 'query' | 'document'\n): Promise<number[][]> =>\n  texts.map((tx) => [tx.length, tx.includes('cat') ? 1 : 0, tx.includes('dog') ? 1 : 0])\n\n/**\n * A dimension-padding encoder factory: wraps {@link stubEncoder} and zero-extends to `dim`. Used by\n * backends that enforce a minimum dimension (e.g. Cloudflare Vectorize requires 32–1536).\n */\nexport const paddedStubEncoder =\n  (dim: number) =>\n  async (texts: string[], kind: 'query' | 'document'): Promise<number[][]> => {\n    const base = await stubEncoder(texts, kind)\n    return base.map((v) => padVector(v, dim))\n  }\n\n// Zero-extend (or truncate) a vector to exactly `dim` entries. dim===3 (the default) returns the\n// vector unchanged, so existing callers are byte-for-byte identical.\nconst padVector = (v: number[], dim: number): number[] => {\n  if (v.length === dim) return v\n  if (v.length > dim) return v.slice(0, dim)\n  return [...v, ...new Array(dim - v.length).fill(0)]\n}\n\n/**\n * Drive a vector-store adapter through the shared contract suite.\n *\n * @remarks\n * `makeStore` must return an already-connected store whose `'docs'` collection is created at the\n * matching dimension; it is re-invoked per test so retries are self-contained. `dim` defaults to 3\n * — pass a larger value for backends with a dimension floor (the harness pads every test vector to\n * `dim`). `opts.retry` / `opts.timeout` are forwarded to every `it()` (defaults: retry 0, 5s) and\n * exist for aggressively eventually-consistent managed backends whose read-after-write can flap for\n * seconds — a retried attempt re-runs `makeStore()` against an index that has had more time to\n * settle, without weakening any assertion.\n *\n * @param label - Human-readable label for the suite (the adapter name).\n * @param makeStore - Factory returning a fresh, connected store with the `'docs'` collection.\n * @param dim - Vector dimensionality the harness pads to (default 3).\n * @param opts - Per-`it` retry/timeout overrides.\n */\nexport const runVectorStoreConformance = (\n  label: string,\n  makeStore: () => Promise<CallableVectorStore>,\n  dim = 3,\n  opts: { retry?: number; timeout?: number } = {}\n): void => {\n  const p = (v: number[]): number[] => padVector(v, dim)\n  const io = { retry: opts.retry ?? 0, timeout: opts.timeout ?? 5000 }\n  describe('conformance: ' + label, () => {\n    it('upserts vectors and searches by nearVector with [0,1] score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([3, 1, 0]), metadata: { kind: 'animal' } },\n        { id: '2', vector: p([3, 0, 1]), metadata: { kind: 'animal' } },\n      ])\n      const res = await vs('docs')\n        .nearVector(p([3, 1, 0]))\n        .select('id', 'score')\n        .limit(2)\n      expect(res.length).toBe(2)\n      expect(res[0].id).toBeDefined()\n      expect(typeof res[0].score).toBe('number')\n      expect(res[0].score! >= 0 && res[0].score! <= 1).toBe(true)\n    })\n    it('encodes text on upsert+nearText when an encoder is configured', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: 'c', document: 'cat', metadata: {} }])\n      const res = await vs('docs').nearText('cat').select('id').limit(1)\n      expect(res.length).toBe(1)\n      expect(res[0].id).toBe('c')\n    })\n    it('requires .select() on reads', io, async () => {\n      const vs = await makeStore()\n      await expect(\n        (async () => {\n          await vs('docs').nearVector(p([1, 1, 1]))\n        })()\n      ).rejects.toThrow()\n    })\n    it('filter-scan (no near) returns rows without score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]), metadata: { kind: 'x' } }])\n      const res = await vs('docs').where('kind', 'x').select('id', 'metadata').limit(10)\n      expect(res.length).toBe(1)\n      expect(res[0].score).toBeUndefined()\n    })\n    it('nested filter A AND (B OR C) selects the right subset', io, async () => {\n      const vs = await makeStore()\n      // Every record carries all three fields so the test probes nested AND/OR routing, not\n      // backend-specific missing-field semantics (e.g. Chroma's $or excludes records missing a\n      // referenced key, where the JS evaluator treats that clause as merely false).\n      await vs('docs').upsert([\n        { id: 'a', vector: p([1, 0, 0]), metadata: { kind: 'doc', year: 2024, pinned: false } }, // kept (year arm)\n        { id: 'b', vector: p([0, 1, 0]), metadata: { kind: 'doc', year: 2010, pinned: false } }, // dropped (neither arm)\n        { id: 'c', vector: p([0, 0, 1]), metadata: { kind: 'doc', year: 2010, pinned: true } }, // kept (pinned arm)\n        { id: 'd', vector: p([1, 1, 0]), metadata: { kind: 'other', year: 2024, pinned: true } }, // dropped (kind mismatch)\n      ])\n      // kind = 'doc' AND (year >= 2024 OR pinned = true)\n      const res = await vs('docs')\n        .where('kind', 'doc')\n        .andWhere((qb) => qb.where('year', '>=', 2024).orWhere('pinned', true))\n        .select('id')\n        .limit(10)\n      expect(res.map((r) => r.id).sort()).toEqual(['a', 'c'])\n    })\n    it('projection: vector excluded unless selected', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]) }])\n      const noVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id')\n        .limit(1)\n      expect(noVec[0].vector).toBeUndefined()\n      const withVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id', 'vector')\n        .limit(1)\n      expect(Array.isArray(withVec[0].vector)).toBe(true)\n    })\n    it('deletes by id', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([1, 0, 0]) },\n        { id: '2', vector: p([0, 1, 0]) },\n      ])\n      await vs('docs').whereIn('id', ['1']).delete()\n      const all = await vs('docs').select('id').limit(10)\n      expect(all.length).toBe(1)\n    })\n    it('throws transaction-unsupported when capabilities.transactions is false', io, async () => {\n      const vs = await makeStore()\n      if (!vs.capabilities.transactions) {\n        await expect(vs.transaction(async () => {})).rejects.toThrow()\n      }\n    })\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"conformance.mjs","names":[],"sources":["../../../src/batteries/vector/conformance/index.ts"],"sourcesContent":["/**\n * Shared conformance suite for vector-store adapters. Drive any adapter through\n * {@link runVectorStoreConformance} to verify it honours the same contract all shipped adapters do.\n * Public, deep-import-only (`@nhtio/adk/batteries/vector/conformance`). The suite has no test-runner\n * dependency: callers invoke it and await the returned promise from any test framework.\n *\n * @module @nhtio/adk/batteries/vector/conformance\n */\n\nimport type { CallableVectorStore } from '../contract'\n\n/** A deterministic stub encoder producing a 3-dim vector from simple text features. */\nexport const stubEncoder = async (\n  texts: string[],\n  _kind: 'query' | 'document'\n): Promise<number[][]> =>\n  texts.map((tx) => [tx.length, tx.includes('cat') ? 1 : 0, tx.includes('dog') ? 1 : 0])\n\n/**\n * A dimension-padding encoder factory: wraps {@link stubEncoder} and zero-extends to `dim`. Used by\n * backends that enforce a minimum dimension (e.g. Cloudflare Vectorize requires 32–1536).\n */\nexport const paddedStubEncoder =\n  (dim: number) =>\n  async (texts: string[], kind: 'query' | 'document'): Promise<number[][]> => {\n    const base = await stubEncoder(texts, kind)\n    return base.map((v) => padVector(v, dim))\n  }\n\n// Zero-extend (or truncate) a vector to exactly `dim` entries. dim===3 (the default) returns the\n// vector unchanged, so existing callers are byte-for-byte identical.\nconst padVector = (v: number[], dim: number): number[] => {\n  if (v.length === dim) return v\n  if (v.length > dim) return v.slice(0, dim)\n  return [...v, ...new Array(dim - v.length).fill(0)]\n}\n\n/**\n * Drive a vector-store adapter through the shared contract suite.\n *\n * @remarks\n * `makeStore` must return an already-connected store whose `'docs'` collection is created at the\n * matching dimension; it is re-invoked per test so retries are self-contained. `dim` defaults to 3\n * — pass a larger value for backends with a dimension floor (the harness pads every test vector to\n * `dim`). `opts.retry` / `opts.timeout` are forwarded to every `it()` (defaults: retry 0, 5s) and\n * exist for aggressively eventually-consistent managed backends whose read-after-write can flap for\n * seconds — a retried attempt re-runs `makeStore()` against an index that has had more time to\n * settle, without weakening any assertion.\n *\n * @param label - Human-readable label for the suite (the adapter name).\n * @param makeStore - Factory returning a fresh, connected store with the `'docs'` collection.\n * @param dim - Vector dimensionality the harness pads to (default 3).\n * @param opts - Per-`it` retry/timeout overrides.\n */\nconst assert: (condition: boolean, message: string) => asserts condition = (condition, message) => {\n  if (!condition) throw new Error(message)\n}\nconst equal = (actual: unknown, expected: unknown): boolean => {\n  if (actual === expected) return true\n  if (\n    actual === null ||\n    expected === null ||\n    typeof actual !== 'object' ||\n    typeof expected !== 'object'\n  )\n    return false\n  if (Array.isArray(actual) !== Array.isArray(expected)) return false\n  const actualRecord = actual as Record<string, unknown>\n  const expectedRecord = expected as Record<string, unknown>\n  const keysA = Object.keys(actualRecord)\n  const keysB = Object.keys(expectedRecord)\n  if (keysA.length !== keysB.length) return false\n  return keysA.every(\n    (key) => Object.hasOwn(expectedRecord, key) && equal(actualRecord[key], expectedRecord[key])\n  )\n}\nconst match = (actual: unknown, expected: unknown): boolean => {\n  if (expected === null || typeof expected !== 'object') return equal(actual, expected)\n  if (actual === null || typeof actual !== 'object') return false\n  return Object.entries(expected).every(([key, value]) =>\n    match((actual as Record<string, unknown>)[key], value)\n  )\n}\nconst expectValue = (actual: unknown) => ({\n  toBe: (expected: unknown) =>\n    assert(equal(actual, expected), `expected ${String(actual)} to be ${String(expected)}`),\n  toEqual: (expected: unknown) => assert(equal(actual, expected), 'values were not equal'),\n  toMatchObject: (expected: unknown) =>\n    assert(match(actual, expected), 'value did not match expected object'),\n  toBeDefined: () => assert(actual !== undefined, 'value was undefined'),\n  toBeUndefined: () => assert(actual === undefined, 'value was defined'),\n  toHaveLength: (length: number) =>\n    assert((actual as { length: number }).length === length, 'unexpected length'),\n  rejects: {\n    toThrow: async () => {\n      try {\n        await (actual as Promise<unknown>)\n      } catch {\n        return\n      }\n      throw new Error('expected promise to reject')\n    },\n  },\n})\n\n/**\n * Run the framework-free vector-store conformance suite against a consumer implementation.\n *\n * Each check creates a fresh store through `makeStore`; the returned promise rejects when any\n * contract assertion fails. Consumers can await this function from any test runner without\n * importing a test framework from the conformance module.\n *\n * @param label - Human-readable name used to identify the implementation under test.\n * @param makeStore - Factory returning a fresh, connected store with the `docs` collection.\n * @param dim - Vector dimensionality used by the suite (defaults to 3).\n * @param opts - Retry count and per-attempt timeout in milliseconds for eventually consistent stores.\n */\nexport const runVectorStoreConformance = async (\n  label: string,\n  makeStore: () => Promise<CallableVectorStore>,\n  dim = 3,\n  opts: { retry?: number; timeout?: number } = {}\n): Promise<void> => {\n  const p = (v: number[]): number[] => padVector(v, dim)\n  const pending: Array<() => Promise<void>> = []\n  const retry = opts.retry ?? 0\n  const timeout = opts.timeout ?? 5000\n  const runCase = async (test: () => Promise<void>): Promise<void> => {\n    let last: unknown\n    for (let attempt = 0; attempt <= retry; attempt++) {\n      let timedOut = false\n      const operation = Promise.resolve().then(test)\n      let timer: ReturnType<typeof setTimeout> | undefined\n      const deadline = new Promise<never>((_, reject) => {\n        timer = setTimeout(() => {\n          timedOut = true\n          reject(new Error(`conformance check timed out after ${timeout}ms`))\n        }, timeout)\n      })\n      try {\n        await Promise.race([operation, deadline])\n        return\n      } catch (error) {\n        // A timeout cannot cancel an arbitrary backend operation. Drain it before retrying so a\n        // late write/read from this attempt cannot race the fresh store made by the next attempt.\n        if (timedOut) {\n          last = error\n          break\n        }\n        last = error\n      } finally {\n        if (timer !== undefined) clearTimeout(timer)\n      }\n    }\n    throw last\n  }\n  const it = (_name: string, _io: unknown, test: () => Promise<void>) => {\n    pending.push(() => runCase(test))\n  }\n  const describe = (_name: string, suite: () => void) => suite()\n  const expect = expectValue\n  const io = undefined\n  describe('conformance: ' + label, () => {\n    it('upserts vectors and searches by nearVector with [0,1] score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([3, 1, 0]), metadata: { kind: 'animal' } },\n        { id: '2', vector: p([3, 0, 1]), metadata: { kind: 'animal' } },\n      ])\n      const res = await vs('docs')\n        .nearVector(p([3, 1, 0]))\n        .select('id', 'score')\n        .limit(2)\n      expect(res.length).toBe(2)\n      expect(res[0].id).toBeDefined()\n      expect(typeof res[0].score).toBe('number')\n      expect(res[0].score! >= 0 && res[0].score! <= 1).toBe(true)\n    })\n    it('encodes text on upsert+nearText when an encoder is configured', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: 'c', document: 'cat', metadata: {} }])\n      const res = await vs('docs').nearText('cat').select('id').limit(1)\n      expect(res.length).toBe(1)\n      expect(res[0].id).toBe('c')\n    })\n    it('requires .select() on reads', io, async () => {\n      const vs = await makeStore()\n      await expect(\n        (async () => {\n          await vs('docs').nearVector(p([1, 1, 1]))\n        })()\n      ).rejects.toThrow()\n    })\n    it('filter-scan (no near) returns rows without score', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]), metadata: { kind: 'x' } }])\n      const res = await vs('docs').where('kind', 'x').select('id', 'metadata').limit(10)\n      expect(res.length).toBe(1)\n      expect(res[0].score).toBeUndefined()\n    })\n    it('nested filter A AND (B OR C) selects the right subset', io, async () => {\n      const vs = await makeStore()\n      // Every record carries all three fields so the test probes nested AND/OR routing, not\n      // backend-specific missing-field semantics (e.g. Chroma's $or excludes records missing a\n      // referenced key, where the JS evaluator treats that clause as merely false).\n      await vs('docs').upsert([\n        { id: 'a', vector: p([1, 0, 0]), metadata: { kind: 'doc', year: 2024, pinned: false } }, // kept (year arm)\n        { id: 'b', vector: p([0, 1, 0]), metadata: { kind: 'doc', year: 2010, pinned: false } }, // dropped (neither arm)\n        { id: 'c', vector: p([0, 0, 1]), metadata: { kind: 'doc', year: 2010, pinned: true } }, // kept (pinned arm)\n        { id: 'd', vector: p([1, 1, 0]), metadata: { kind: 'other', year: 2024, pinned: true } }, // dropped (kind mismatch)\n      ])\n      // kind = 'doc' AND (year >= 2024 OR pinned = true)\n      const res = await vs('docs')\n        .where('kind', 'doc')\n        .andWhere((qb) => qb.where('year', '>=', 2024).orWhere('pinned', true))\n        .select('id')\n        .limit(10)\n      expect(res.map((r) => r.id).sort()).toEqual(['a', 'c'])\n    })\n    it('projection: vector excluded unless selected', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([{ id: '1', vector: p([1, 0, 0]) }])\n      const noVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id')\n        .limit(1)\n      expect(noVec[0].vector).toBeUndefined()\n      const withVec = await vs('docs')\n        .nearVector(p([1, 0, 0]))\n        .select('id', 'vector')\n        .limit(1)\n      expect(Array.isArray(withVec[0].vector)).toBe(true)\n    })\n    it('deletes by id', io, async () => {\n      const vs = await makeStore()\n      await vs('docs').upsert([\n        { id: '1', vector: p([1, 0, 0]) },\n        { id: '2', vector: p([0, 1, 0]) },\n      ])\n      await vs('docs').whereIn('id', ['1']).delete()\n      const all = await vs('docs').select('id').limit(10)\n      expect(all.length).toBe(1)\n    })\n    it('throws transaction-unsupported when capabilities.transactions is false', io, async () => {\n      const vs = await makeStore()\n      if (!vs.capabilities.transactions) {\n        await expect(vs.transaction(async () => {})).rejects.toThrow()\n      }\n    })\n  })\n  for (const fn of pending) {\n    await fn()\n  }\n}\n"],"mappings":"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"}

package/batteries/vector/retrievable.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_retrievable = require("../../retrievable-C5dXuDhD.js");
+const require_retrievable = require("../../retrievable-BTwjmPnl.js");
 require("../../index.cjs");
 //#region src/batteries/vector/retrievable_glue.ts
 /**

package/batteries/vector/retrievable.mjs

@@ -1,4 +1,4 @@
-import { t as Retrievable } from "../../retrievable-gl_TIHnX.mjs";
+import { t as Retrievable } from "../../retrievable-CXTAUuuv.mjs";
 import "../../index.mjs";
 //#region src/batteries/vector/retrievable_glue.ts
 /**

package/batteries.cjs

@@ -3,10 +3,10 @@ require("./chunk-Cek0wNdY.js");
 const require_batteries_context_exceptions = require("./batteries/context/exceptions.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./batteries/llm/openai_chat_completions/exceptions.cjs");
 const require_batteries_llm_openai_chat_completions_validation = require("./batteries/llm/openai_chat_completions/validation.cjs");
-const require_helpers = require("./helpers-Tvvwpx1M.js");
+const require_helpers = require("./helpers-CEjjkXso.js");
 const require_batteries_llm_openai_chat_completions_helpers = require("./batteries/llm/openai_chat_completions/helpers.cjs");
 const require_batteries_llm_openai_chat_completions_adapter = require("./batteries/llm/openai_chat_completions/adapter.cjs");
-const require_chat_common = require("./chat_common-B3O3zz-i.js");
+const require_chat_common = require("./chat_common-Dpan9moo.js");
 const require_batteries_llm_webllm_chat_completions_exceptions = require("./batteries/llm/webllm_chat_completions/exceptions.cjs");
 const require_batteries_llm_webllm_chat_completions_validation = require("./batteries/llm/webllm_chat_completions/validation.cjs");
 const require_batteries_llm_webllm_chat_completions_adapter = require("./batteries/llm/webllm_chat_completions/adapter.cjs");
@@ -41,8 +41,8 @@ const require_batteries_tools_math = require("./batteries/tools/math.cjs");
 const require_batteries_tools_memory = require("./batteries/tools/memory.cjs");
 const require_batteries_tools_parsing = require("./batteries/tools/parsing.cjs");
 const require_batteries_tools_retrievables = require("./batteries/tools/retrievables.cjs");
-const require_scrapper = require("./scrapper-DD6-_2u-.js");
-const require_searxng = require("./searxng-C7GK0Nrz.js");
+const require_scrapper = require("./scrapper-CJexXXK-.js");
+const require_searxng = require("./searxng-DzlGZG4V.js");
 const require_batteries_tools_standing_instructions = require("./batteries/tools/standing_instructions.cjs");
 const require_batteries_tools_statistics = require("./batteries/tools/statistics.cjs");
 const require_batteries_tools_string_processing = require("./batteries/tools/string_processing.cjs");
@@ -106,7 +106,7 @@ const require_batteries_context_thrift_subtractive_pass = require("./batteries/c
 const require_batteries_context_thrift_relevance = require("./batteries/context/thrift/relevance.cjs");
 const require_batteries_context_compact_summarizer = require("./batteries/context/compact/summarizer.cjs");
 require("./batteries/context.cjs");
-const require_isolation = require("./isolation-BQCTQYZ_.js");
+const require_isolation = require("./isolation-7Jrcucgc.js");
 exports.AnthropicMessagesAdapter = require_batteries_llm_anthropic_messages_adapter.AnthropicMessagesAdapter;
 exports.BaseVectorStore = require_batteries_vector_contract.BaseVectorStore;
 exports.COMPACTION_SYSTEM_PROMPT = require_batteries_context_compact_summarizer.COMPACTION_SYSTEM_PROMPT;

package/batteries.mjs

@@ -1,10 +1,10 @@
 import { E_CONTEXT_RESOLVER_MISSING } from "./batteries/context/exceptions.mjs";
 import { E_INVALID_OPENAI_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 } from "./batteries/llm/openai_chat_completions/exceptions.mjs";
 import { openAIChatCompletionsOptionsSchema, validateOptions as validateOptions$9 } from "./batteries/llm/openai_chat_completions/validation.mjs";
-import { A as renderMemories, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, H as sanitizeFilenameForDescription, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, S as floorTrustTier, T as neutraliseDeveloperRulesTag, U as sanitizeMimeType, W as stripEnvelopeSpecialTokens, _ as defaultRenderUntrustedContent, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, k as renderFirstPartyRetrievables, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "./helpers-CDmLDBq5.mjs";
+import { A as renderMemories, F as renderThirdPartyPrivateRetrievables, G as toolsToChatCompletionsTools, H as sanitizeFilenameForDescription, I as renderThirdPartyPublicRetrievables, L as renderThought, M as renderRetrievableSafetyDirective, N as renderRetrievables, O as renderChatCompletionsSystemPrompt, P as renderStandingInstructions, R as renderTrustedContent, S as floorTrustTier, T as neutraliseDeveloperRulesTag, U as sanitizeMimeType, W as stripEnvelopeSpecialTokens, _ as defaultRenderUntrustedContent, c as defaultRenderMemories, d as defaultRenderRetrievables, f as defaultRenderStandingInstructions, g as defaultRenderTrustedContent, h as defaultRenderThought, i as defaultFilterThoughts, k as renderFirstPartyRetrievables, m as defaultRenderThirdPartyPublicRetrievables, o as defaultRenderChatCompletionsSystemPrompt, p as defaultRenderThirdPartyPrivateRetrievables, r as defaultDescriptionToChatCompletionsJsonSchema, s as defaultRenderFirstPartyRetrievables, u as defaultRenderRetrievableSafetyDirective, v as defaultToolsToChatCompletionsTools, x as filterThoughts, y as descriptionToChatCompletionsJsonSchema, z as renderUntrustedContent } from "./helpers-BH7HTtkD.mjs";
 import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultRenderChatCompletionsToolCallResult, defaultRenderTimelineMessage, extractReasoningFields, renderChatCompletionsToolCallResult, renderTimelineMessage } from "./batteries/llm/openai_chat_completions/helpers.mjs";
 import { OpenAIChatCompletionsAdapter } from "./batteries/llm/openai_chat_completions/adapter.mjs";
-import { t as deCollideToolCallIds } from "./chat_common-DbbIESdo.mjs";
+import { t as deCollideToolCallIds } from "./chat_common-CmKV5Dz4.mjs";
 import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR } from "./batteries/llm/webllm_chat_completions/exceptions.mjs";
 import { validateOptions as validateOptions$17, webLLMChatCompletionsOptionsSchema } from "./batteries/llm/webllm_chat_completions/validation.mjs";
 import { WebLLMChatCompletionsAdapter } from "./batteries/llm/webllm_chat_completions/adapter.mjs";
@@ -39,8 +39,8 @@ import { calculateTool, evaluateKatexTool } from "./batteries/tools/math.mjs";
 import { deleteMemoryTool, listMemoriesTool, memoryTools, storeMemoryTool, updateMemoryTool } from "./batteries/tools/memory.mjs";
 import { detectDelimiterTool, parseCsvTool, parseKvTool, parseYamlTool } from "./batteries/tools/parsing.mjs";
 import { deleteRetrievableTool, listRetrievablesTool, retrievableTools, storeRetrievableTool, updateRetrievableTool } from "./batteries/tools/retrievables.mjs";
-import { a as E_INVALID_SCRAPPER_CONFIG, i as createScrapperLinksToolSync, n as createScrapperArticleToolSync, r as createScrapperLinksTool, t as createScrapperArticleTool } from "./scrapper-u_orpxIB.mjs";
-import { n as createSearxngSearchToolSync, r as E_INVALID_SEARXNG_CONFIG, t as createSearxngSearchTool } from "./searxng-fVdJUCK2.mjs";
+import { a as E_INVALID_SCRAPPER_CONFIG, i as createScrapperLinksToolSync, n as createScrapperArticleToolSync, r as createScrapperLinksTool, t as createScrapperArticleTool } from "./scrapper-DiQ5FfDL.mjs";
+import { n as createSearxngSearchToolSync, r as E_INVALID_SEARXNG_CONFIG, t as createSearxngSearchTool } from "./searxng-BFTJ6rTE.mjs";
 import { addStandingInstructionTool, listStandingInstructionsTool, removeStandingInstructionTool, standingInstructionTools } from "./batteries/tools/standing_instructions.mjs";
 import { statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool } from "./batteries/tools/statistics.mjs";
 import { stringExtractTool, stringTransformTool } from "./batteries/tools/string_processing.mjs";
@@ -104,5 +104,5 @@ import { DEFAULT_ENCODING, DEFAULT_RESERVE_FRACTION, DEFAULT_THIS_TURN_RESULT_KE
 import { RELEVANCE_FLOOR_CURVE, RELEVANCE_FLOOR_MAX, RELEVANCE_FLOOR_MIN, argText, contentTokens, groupHistoryIntoTurns, relevanceToQuery, scaledRelevanceFloor, selectNaiveTurns, selectRelevantTurns } from "./batteries/context/thrift/relevance.mjs";
 import { COMPACTION_SYSTEM_PROMPT, DEFAULT_KEEP_VERBATIM, DEFAULT_SUMMARISE_AT_TOKENS, DEFAULT_SUMMARY_MESSAGE_ID, assembleCompactedTurns, summariseTurns } from "./batteries/context/compact/summarizer.mjs";
 import "./batteries/context.mjs";
-import { A as event, C as E_INVALID_ISOLATION_OPTIONS, D as E_ISOLATION_READY_TIMEOUT, E as E_ISOLATION_ENCODER_REQUIRED, M as resolveIsolatedServiceSpec, N as stream, O as E_ISOLATION_UNENCODABLE, S as defineIsolatedServiceValidated, T as E_ISOLATED_TERMINATED, _ as transfer, a as createWorkerTransport, b as nextCorrelationId, c as serveIsolated, d as hasIsolationHook, f as DEFAULT_CRASH_POLICY_MAX_CRASHES, g as registerEncodableClasses, h as isEncoderAvailable, i as isolateFunction, j as method, k as E_ISOLATION_UNSUPPORTED_ENV, l as serveIsolatedOverPort, m as createCrashPolicy, n as E_ISOLATE_FUNCTION_REQUIRES_SOURCE_REHYDRATION, o as spawnIsolated, p as DEFAULT_CRASH_POLICY_WINDOW_MS, r as E_ISOLATE_FUNCTION_UNSERIALIZABLE, s as createIsolatedService, t as E_ISOLATE_FUNCTION_ARG_UNSUPPORTED, u as emitIsolationReport, v as GuestEndpoint, w as E_ISOLATED_CRASHED, x as wireErrorToError, y as HostEndpoint } from "./isolation-7xbkc12r.mjs";
+import { A as event, C as E_INVALID_ISOLATION_OPTIONS, D as E_ISOLATION_READY_TIMEOUT, E as E_ISOLATION_ENCODER_REQUIRED, M as resolveIsolatedServiceSpec, N as stream, O as E_ISOLATION_UNENCODABLE, S as defineIsolatedServiceValidated, T as E_ISOLATED_TERMINATED, _ as transfer, a as createWorkerTransport, b as nextCorrelationId, c as serveIsolated, d as hasIsolationHook, f as DEFAULT_CRASH_POLICY_MAX_CRASHES, g as registerEncodableClasses, h as isEncoderAvailable, i as isolateFunction, j as method, k as E_ISOLATION_UNSUPPORTED_ENV, l as serveIsolatedOverPort, m as createCrashPolicy, n as E_ISOLATE_FUNCTION_REQUIRES_SOURCE_REHYDRATION, o as spawnIsolated, p as DEFAULT_CRASH_POLICY_WINDOW_MS, r as E_ISOLATE_FUNCTION_UNSERIALIZABLE, s as createIsolatedService, t as E_ISOLATE_FUNCTION_ARG_UNSUPPORTED, u as emitIsolationReport, v as GuestEndpoint, w as E_ISOLATED_CRASHED, x as wireErrorToError, y as HostEndpoint } from "./isolation-CO0NiK8R.mjs";
 export { AnthropicMessagesAdapter, BaseVectorStore, COMPACTION_SYSTEM_PROMPT, ClaudeCodeCliAdapter, CollectionBuilder, DEFAULT_CRASH_POLICY_MAX_CRASHES, DEFAULT_CRASH_POLICY_WINDOW_MS, DEFAULT_ENCODING, DEFAULT_KEEP_VERBATIM, DEFAULT_RESERVE_FRACTION, DEFAULT_SUMMARISE_AT_TOKENS, DEFAULT_SUMMARY_MESSAGE_ID, DEFAULT_THIS_TURN_RESULT_KEEP, EDIT_IMAGE_FIELD_NAME, E_ANTHROPIC_MESSAGES_CONTEXT_OVERFLOW, E_ANTHROPIC_MESSAGES_HTTP_ERROR, E_ANTHROPIC_MESSAGES_INVALID_TOOL_CALL_ARGS, E_ANTHROPIC_MESSAGES_REQUEST_TIMEOUT, E_ANTHROPIC_MESSAGES_STREAM_ERROR, E_ANTHROPIC_MESSAGES_STREAM_STALLED, E_ANTHROPIC_MESSAGES_UNSUPPORTED_MEDIA_MODALITY, E_CLAUDE_CODE_CLI_BINARY_NOT_FOUND, E_CLAUDE_CODE_CLI_CONTEXT_OVERFLOW, E_CLAUDE_CODE_CLI_MCP_BRIDGE_STARTUP_FAILED, E_CLAUDE_CODE_CLI_PROCESS_EXITED_NONZERO, E_CLAUDE_CODE_CLI_STARTUP_TIMEOUT, E_CLAUDE_CODE_CLI_STREAM_ERROR, E_CLAUDE_CODE_CLI_STREAM_STALLED, E_CLAUDE_CODE_CLI_TURN_FAILED, E_CLAUDE_CODE_CLI_UNSUPPORTED_MEDIA_MODALITY, E_CLAUDE_CODE_CLI_WRAPPER_CRASHED, E_CLAUDE_CODE_CLI_WRAPPER_SPAWN_ERROR, E_CONTEXT_RESOLVER_MISSING, E_GEMINI_GENERATION_HTTP_ERROR, E_GEMINI_GENERATION_MALFORMED_RESPONSE, E_GEMINI_GENERATION_REQUEST_TIMEOUT, E_INVALID_ANTHROPIC_MESSAGES_OPTIONS, E_INVALID_CLAUDE_CODE_CLI_OPTIONS, E_INVALID_GEMINI_GENERATION_OPTIONS, E_INVALID_ISOLATION_OPTIONS, E_INVALID_LITERT_LM_OPTIONS, E_INVALID_OLLAMA_EMBEDDINGS_OPTIONS, E_INVALID_OLLAMA_OPTIONS, E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_INVALID_OPENAI_EMBEDDINGS_OPTIONS, E_INVALID_OPENAI_GENERATION_OPTIONS, E_INVALID_OPENAI_RESPONSES_OPTIONS, E_INVALID_SCRAPPER_CONFIG, E_INVALID_SEARXNG_CONFIG, E_INVALID_TESSERACT_JS_OCR_OPTIONS, E_INVALID_TRANSFORMERS_JS_CAPTION_OPTIONS, E_INVALID_TRANSFORMERS_JS_EMBEDDINGS_OPTIONS, E_INVALID_TRANSFORMERS_JS_GENERATION_OPTIONS, E_INVALID_TRANSFORMERS_JS_OPTIONS, E_INVALID_TRANSFORMERS_JS_STT_OPTIONS, E_INVALID_TRANSFORMERS_JS_TTS_OPTIONS, E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS, E_ISOLATED_CRASHED, E_ISOLATED_TERMINATED, E_ISOLATE_FUNCTION_ARG_UNSUPPORTED, E_ISOLATE_FUNCTION_REQUIRES_SOURCE_REHYDRATION, E_ISOLATE_FUNCTION_UNSERIALIZABLE, E_ISOLATION_ENCODER_REQUIRED, E_ISOLATION_READY_TIMEOUT, E_ISOLATION_UNENCODABLE, E_ISOLATION_UNSUPPORTED_ENV, E_LITERT_LM_CONTEXT_OVERFLOW, E_LITERT_LM_INVALID_TOOL_CALL_ARGS, E_LITERT_LM_STREAM_ERROR, E_OLLAMA_CONTEXT_OVERFLOW, E_OLLAMA_EMBEDDINGS_HTTP_ERROR, E_OLLAMA_EMBEDDINGS_MALFORMED_RESPONSE, E_OLLAMA_EMBEDDINGS_REQUEST_TIMEOUT, E_OLLAMA_HTTP_ERROR, E_OLLAMA_INVALID_TOOL_CALL_ARGS, E_OLLAMA_REQUEST_TIMEOUT, E_OLLAMA_STREAM_ERROR, E_OLLAMA_STREAM_STALLED, E_OLLAMA_UNSUPPORTED_MEDIA_MODALITY, 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_OPENAI_GENERATION_HTTP_ERROR, E_OPENAI_GENERATION_MALFORMED_RESPONSE, E_OPENAI_GENERATION_REQUEST_TIMEOUT, E_OPENAI_RESPONSES_CONTEXT_OVERFLOW, E_OPENAI_RESPONSES_HTTP_ERROR, E_OPENAI_RESPONSES_INVALID_TOOL_CALL_ARGS, E_OPENAI_RESPONSES_REASONING_REPLAY_REJECTED, E_OPENAI_RESPONSES_REQUEST_TIMEOUT, E_OPENAI_RESPONSES_STREAM_ERROR, E_OPENAI_RESPONSES_STREAM_STALLED, E_OPENAI_RESPONSES_UNSUPPORTED_MEDIA_MODALITY, E_TESSERACT_JS_OCR_ENGINE_ERROR, E_TRANSFORMERS_JS_CAPTION_ENGINE_ERROR, E_TRANSFORMERS_JS_CONTEXT_OVERFLOW, E_TRANSFORMERS_JS_EMBEDDINGS_ENGINE_ERROR, E_TRANSFORMERS_JS_GENERATION_ENGINE_ERROR, E_TRANSFORMERS_JS_GENERATION_UNSUPPORTED_OPERATION, E_TRANSFORMERS_JS_INVALID_TOOL_CALL_ARGS, E_TRANSFORMERS_JS_STREAM_ERROR, E_TRANSFORMERS_JS_STT_ENGINE_ERROR, E_TRANSFORMERS_JS_TOOL_PARSE_FAILED, E_TRANSFORMERS_JS_TTS_ENGINE_ERROR, 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, GeminiGenerationAdapter, GuestEndpoint, HostEndpoint, InMemoryVectorStore, LiteRtLmAdapter, OllamaAdapter, OllamaEmbeddingsAdapter, OpenAIChatCompletionsAdapter, OpenAIEmbeddingsAdapter, OpenAIGenerationAdapter, OpenAIResponsesAdapter, OramaVectorStore, RELEVANCE_FLOOR_CURVE, RELEVANCE_FLOOR_MAX, RELEVANCE_FLOOR_MIN, TesseractJsOcrAdapter, TransformersJsAdapter, TransformersJsCaptionAdapter, TransformersJsEmbeddingsAdapter, TransformersJsGenerationAdapter, TransformersJsSttAdapter, TransformersJsTtsAdapter, VectorMigrator, VectorQueryBuilder, VectorSchemaBuilder, WebLLMChatCompletionsAdapter, addStandingInstructionTool, anthropicMessagesOptionsSchema, applyEmbeddingPrefix, argText, assembleCompactedTurns, baseVectorStoreOptionsSchema, buildChatCompletionsHistory, calculateTool, clamp01, claudeCodeCliOptionsSchema, colorAdjustTool, colorContrastTool, colorSchemeTool, compareRecordsTool, compareValuesTool, contentTokens, convertTimeTool, convertUnitTool, createChatCompletionsToolCallDeltaAccumulator, createCrashPolicy, createIsolatedService, createScrapperArticleTool, createScrapperArticleToolSync, createScrapperLinksTool, createScrapperLinksToolSync, createSearxngSearchTool, createSearxngSearchToolSync, createVectorRetrievableCallbacks, createVectorStore, createWorkerTransport, dateAddTool, dateBusinessDaysTool, dateCalendarInfoTool, dateDiffTool, dateNthWeekdayTool, dateParseTool, datePeriodTool, deCollideToolCallIds, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDecodeAudio, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, defineIsolatedServiceValidated as defineIsolatedService, deleteMemoryTool, deleteRetrievableTool, descriptionToChatCompletionsJsonSchema, detectDelimiterTool, dimensionsMatch, durationFormatTool, emitIsolationReport, encodeTextTool, encoderFromEmbeddings, evaluateFilter, evaluateKatexTool, event, extractReasoningFields, filterThoughts, floorTrustTier, formatListTool, formatNumberTool, formatTableTool, geminiGenerationOptionsSchema, geoBboxContainsTool, geoDistanceTool, geoWithinRadiusTool, getCurrentTimeTool, groupHistoryIntoTurns, hasIsolationHook, implementsVectorStoreConstructor, isEncoderAvailable, isFilterCondition, isFilterGroup, isFiniteVector, isPcmInput, isRawExpr, isRawFilter, isolateFunction, jsonFormatTool, jsonTransformTool, listMemoriesTool, listRetrievablesTool, listStandingInstructionsTool, liteRtLmOptionsSchema, mapMetric, memoryTools, method, neutraliseDeveloperRulesTag, nextCorrelationId, normalizeScore, ollamaEmbeddingsOptionsSchema, ollamaOptionsSchema, openAIChatCompletionsOptionsSchema, openAIEmbeddingsOptionsSchema, openAIGenerationOptionsSchema, openAIResponsesOptionsSchema, parseCsvTool, parseKvTool, parseYamlTool, raw, registerEncodableClasses, relevanceToQuery, removeStandingInstructionTool, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, resolveBudget, resolveClientCtor, resolveIsolatedServiceSpec, retrievableTools, sanitizeFilenameForDescription, sanitizeMetadata, sanitizeMimeType, scaledRelevanceFloor, scrapperArticleToRetrievable, scrapperLinksToRetrievables, searxngResultsToRetrievables, selectNaiveTurns, selectRelevantTurns, serveIsolated, serveIsolatedOverPort, setOperationsTool, spawnIsolated, standingInstructionTools, statsCorrelateTool, statsDescribeTool, statsHistogramTool, statsTransformTool, storeMemoryTool, storeRetrievableTool, storeRetrievables, stream, stringExtractTool, stringSimilarityTool, stringTransformTool, stripEnvelopeSpecialTokens, stripPriorTurnThoughts, subtractToFit, summariseTurns, tesseractJsOcrOptionsSchema, textAnalyzeTool, textDiffTool, textEscapeTool, textLinesTool, toBytes, toBytes$1 as toGenerationBytes, toolsToChatCompletionsTools, transfer, transformersJsCaptionOptionsSchema, transformersJsEmbeddingsOptionsSchema, transformersJsGenerationOptionsSchema, transformersJsOptionsSchema, transformersJsSttAdapterOptionsSchema, transformersJsTtsOptionsSchema, unicodeNormalizeTool, updateMemoryTool, updateRetrievableTool, validateOptions as validateAnthropicMessagesOptions, validateOptions$1 as validateClaudeCodeCliOptions, validateCreateConfig, validateFormatTool, validateOptions$2 as validateGeminiGenerationOptions, validateOptions$3 as validateLiteRtLmOptions, validateOptions$4 as validateOllamaEmbeddingsOptions, validateOptions$5 as validateOllamaOptions, validateOptions$6 as validateOpenAIEmbeddingsOptions, validateOptions$7 as validateOpenAIGenerationOptions, validateOptions$8 as validateOpenAIResponsesOptions, validateOptions$9 as validateOptions, validateRecords, validateOptions$10 as validateTesseractJsOcrOptions, validateOptions$11 as validateTransformersJsCaptionOptions, validateOptions$12 as validateTransformersJsEmbeddingsOptions, validateOptions$13 as validateTransformersJsGenerationOptions, validateOptions$14 as validateTransformersJsOptions, validateOptions$15 as validateTransformersJsSttOptions, validateOptions$16 as validateTransformersJsTtsOptions, validateOptions$17 as validateWebLLMChatCompletionsOptions, vectorFilterSchema, vectorRecordSchema, vectorStoreConstructorSchema, webLLMChatCompletionsOptionsSchema, wireErrorToError };

package/{chat_common-DbbIESdo.mjs → chat_common-CmKV5Dz4.mjs}

@@ -1,5 +1,5 @@
 import "./tool_parsers-DgZhgxV8.mjs";
-import "./helpers-CDmLDBq5.mjs";
+import "./helpers-BH7HTtkD.mjs";
 import "./gpu_budget-Bi2nUUil.mjs";
 import "./lifecycle-C4kwYJ-N.mjs";
 import "./batteries/llm/chat_common/exceptions.mjs";
@@ -37,4 +37,4 @@ var deCollideToolCallIds = (id, ctx) => [...ctx.turnToolCalls].some((tc) => tc.i
 //#endregion
 export { deCollideToolCallIds as t };
 
-//# sourceMappingURL=chat_common-DbbIESdo.mjs.map
+//# sourceMappingURL=chat_common-CmKV5Dz4.mjs.map