@nhtio/adk 0.1.0-master-2025e9b2 → 0.1.0-master-0c6ed4ad

package/CHANGELOG.md

@@ -9,6 +9,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **Importable ESLint plugin (`@nhtio/adk/eslint`).** The harness's documented contracts are now
+  machine-checkable: a flat-config plugin that flags footguns the TypeScript compiler cannot see
+  because they live in runtime validators or conventions, not types. Five rules ship —
+  `require-validator-any-required` (a `validator.any()` chain with no explicit
+  `.required()`/`.optional()`/`.default()`/`.forbidden()` silently admits null/undefined),
+  `thought-payload-requires-replay-tag` (a `Thought` with a vendor `payload` but no
+  `replayCompatibility` can never be safely replayed), `token-encoding-requires-context-window` (a
+  Chat Completions adapter that counts tokens with no budget never runs its overflow guard),
+  `artifact-tool-forbids-artifact-constructor` (an `ArtifactTool` that wraps another artifact
+  recurses forever), and `no-model-in-tool-handler` (a model call inside a tool handler hides an
+  unmanaged dispatch — unless the handler runs its own scoped sub-agent via `new TurnRunner(...)` or
+  `DispatchRunner.dispatch(...)`). Import the assembled plugin
+  from `@nhtio/adk/eslint` (or `adk.configs.recommended` for all five), or individual rules from
+  `@nhtio/adk/eslint/rules/<name>`. `eslint` and `@typescript-eslint/utils` are **optional peers** —
+  installed only by consumers who lint with the plugin. Rules are report-only with inline
+  `eslint-disable` carve-outs. See the new **Developer Tools** docs section, which also now houses
+  the ADK Assembly MCP guide.
+
 - **Vector conformance harness is now public (`@nhtio/adk/batteries/vector/conformance`).** The
   `runVectorStoreConformance` suite (plus `stubEncoder` / `paddedStubEncoder`) that the 29 shipped
   adapters test against is now an exported, deep-import-only subpath, so anyone writing their own

package/batteries/vector/chroma.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/chroma/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/chroma

package/batteries/vector/chroma.mjs

@@ -1,8 +1,8 @@
 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";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/chroma/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/chroma

package/batteries/vector/clickhouse.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/clickhouse/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/clickhouse

package/batteries/vector/clickhouse.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/clickhouse/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/clickhouse

package/batteries/vector/cloudflare.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/cloudflare/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/cloudflare

package/batteries/vector/cloudflare.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } from "./filters.mjs";
-import { normalizeScore } from "./helpers.mjs";
 import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/cloudflare/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/cloudflare

package/batteries/vector/couchbase.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/couchbase/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/couchbase

package/batteries/vector/couchbase.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/couchbase/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/couchbase

package/batteries/vector/duckdb.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/duckdb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/duckdb

package/batteries/vector/duckdb.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/duckdb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/duckdb

package/batteries/vector/elasticsearch.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/elasticsearch/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/elasticsearch

package/batteries/vector/elasticsearch.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 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_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/elasticsearch/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/elasticsearch

package/batteries/vector/hnswlib.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/hnswlib/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/hnswlib

package/batteries/vector/hnswlib.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } from "./filters.mjs";
-import { normalizeScore } from "./helpers.mjs";
 import { E_VECTOR_STORE_COLLECTION_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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/hnswlib/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/hnswlib

package/batteries/vector/in_memory.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/in_memory/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/in_memory

package/batteries/vector/in_memory.mjs

@@ -1,8 +1,8 @@
 import { evaluateFilter } from "./filters.mjs";
-import { normalizeScore } from "./helpers.mjs";
 import { E_VECTOR_STORE_DIMENSION_MISMATCH } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/in_memory/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/in_memory

package/batteries/vector/lancedb.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/lancedb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/lancedb

package/batteries/vector/lancedb.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/lancedb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/lancedb

package/batteries/vector/mariadb.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/mariadb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/mariadb

package/batteries/vector/mariadb.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/mariadb/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/mariadb

package/batteries/vector/milvus.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/milvus/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/milvus

package/batteries/vector/milvus.mjs

@@ -1,8 +1,8 @@
 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";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/milvus/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/milvus

package/batteries/vector/opensearch.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/opensearch/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/opensearch

package/batteries/vector/opensearch.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 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_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/opensearch/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/opensearch

package/batteries/vector/oracle23ai.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/oracle23ai/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/oracle23ai

package/batteries/vector/oracle23ai.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/oracle23ai/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/oracle23ai

package/batteries/vector/orama.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/orama/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/orama

package/batteries/vector/orama.mjs

@@ -1,8 +1,8 @@
 import { evaluateFilter } from "./filters.mjs";
-import { clamp01 } from "./helpers.mjs";
 import { E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { clamp01 } from "./helpers.mjs";
 //#region src/batteries/vector/orama/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/orama

package/batteries/vector/pgvector.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/pgvector/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/pgvector

package/batteries/vector/pgvector.mjs

@@ -1,8 +1,8 @@
 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_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/pgvector/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/pgvector

package/batteries/vector/pinecone.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/pinecone/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/pinecone

package/batteries/vector/pinecone.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter, isFilterCondition, isFilterGroup, isRawFilter } from "./filters.mjs";
-import { normalizeScore } from "./helpers.mjs";
 import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/pinecone/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/pinecone

package/batteries/vector/qdrant.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/qdrant/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/qdrant

package/batteries/vector/qdrant.mjs

@@ -1,9 +1,9 @@
 import { i as __require } from "../../chunk-Bpcn9VDT.mjs";
 import { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.mjs";
-import { normalizeScore } from "./helpers.mjs";
 import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/qdrant/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/qdrant

package/batteries/vector/redis.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/redis/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/redis

package/batteries/vector/redis.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 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_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/redis/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/redis

package/batteries/vector/s3vectors.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/s3vectors/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/s3vectors

package/batteries/vector/s3vectors.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/s3vectors/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/s3vectors

package/batteries/vector/sqlite_vec.cjs

@@ -1,10 +1,10 @@
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/sqlite_vec/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/sqlite_vec

package/batteries/vector/sqlite_vec.mjs

@@ -1,8 +1,8 @@
 import { evaluateFilter } 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_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/sqlite_vec/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/sqlite_vec

package/batteries/vector/typesense.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/typesense/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/typesense

package/batteries/vector/typesense.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/typesense/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/typesense

package/batteries/vector/vespa.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 //#region src/batteries/vector/vespa/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/vespa

package/batteries/vector/vespa.mjs

@@ -1,10 +1,10 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
 import { evaluateFilter } 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_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
+import { normalizeScore } from "./helpers.mjs";
 //#region src/batteries/vector/vespa/index.ts
 /**
 * @module @nhtio/adk/batteries/vector/vespa

package/batteries/vector/weaviate.cjs

@@ -3,10 +3,10 @@ require("../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
 require("../../guards.cjs");
 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");
+const require_batteries_vector_helpers = require("./helpers.cjs");
 let js_sha256 = require("js-sha256");
 //#region src/batteries/vector/weaviate/index.ts
 /**