@nhtio/adk 0.1.0-master-2025e9b2 → 0.1.0-master-517e90a5

package/CHANGELOG.md

@@ -9,6 +9,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **SoDK — a mental-model doc that teaches the loop in human terms.** A new page,
+  `docs/sodk.md` ("Society Development Kit"), retells [How agents work](https://adk.nht.io/how-agents-work)
+  and [What ADK is](https://adk.nht.io/what-adk-is) with exactly one noun swapped: where ADK says
+  *model*, SoDK says *person*. It is a teaching device for the reader who can't yet see why an agent
+  is the loop, not the LLM — role↔agent, task↔turn, briefing↔context, request↔tool, process↔middleware,
+  "say where things get filed"↔the required storage callbacks. The human-facing prose plays it
+  straight; the `<llm-only>` block names the metaphor outright and carries the full 1:1 map, so an
+  agent answering a question can explain a concept *through* the framing or translate either way. Wired
+  into the sidebar and home listing, and cross-linked from both source docs. Docs only — no code, types,
+  or package surface change.
+
+- **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/arangodb.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/arangodb/index.ts

package/batteries/vector/arangodb.mjs

@@ -1,7 +1,7 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
-import { evaluateFilter } from "./filters.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 { evaluateFilter } from "./filters.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
 //#region src/batteries/vector/arangodb/index.ts

package/batteries/vector/builder.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
 //#region src/batteries/vector/builder.ts
 /**
 * Knex-style chainable query builder for the vector storage battery.

package/batteries/vector/builder.mjs

@@ -1,5 +1,5 @@
-import { isFilterCondition, isRawFilter } from "./filters.mjs";
 import { E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR } from "./exceptions.mjs";
+import { isFilterCondition, isRawFilter } from "./filters.mjs";
 //#region src/batteries/vector/builder.ts
 /**
 * Knex-style chainable query builder for the vector storage battery.

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_filters = require("./filters.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 { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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/meilisearch.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/meilisearch/index.ts

package/batteries/vector/meilisearch.mjs

@@ -1,7 +1,7 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
-import { evaluateFilter } from "./filters.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 { evaluateFilter } from "./filters.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
 //#region src/batteries/vector/meilisearch/index.ts

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_filters = require("./filters.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 { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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/mongodb.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/mongodb/index.ts

package/batteries/vector/mongodb.mjs

@@ -1,7 +1,7 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
-import { evaluateFilter } from "./filters.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 { evaluateFilter } from "./filters.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
 //#region src/batteries/vector/mongodb/index.ts

package/batteries/vector/neo4j.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/neo4j/index.ts

package/batteries/vector/neo4j.mjs

@@ -1,7 +1,7 @@
 import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
 import "../../guards.mjs";
-import { evaluateFilter } from "./filters.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 { evaluateFilter } from "./filters.mjs";
 import { BaseVectorStore } from "./contract.mjs";
 import { validateRecords } from "./validation.mjs";
 //#region src/batteries/vector/neo4j/index.ts

package/batteries/vector/opensearch.cjs

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter } from "./filters.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_filters = require("./filters.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 { evaluateFilter } from "./filters.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_filters = require("./filters.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 { isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 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_filters = require("./filters.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 { evaluateFilter, isFilterCondition, isFilterGroup, isRawFilter } from "./filters.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