@nhtio/adk 0.1.0-master-0e75bb0f → 0.1.0-master-f9535eb7

package/CHANGELOG.md

@@ -83,6 +83,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `pdf-lib`, `pdf-parse`, `mammoth`, `exceljs`, `jszip`, `jimp`, `sharp`, `audio-decode`,
   `@huggingface/transformers`, `tesseract.js`, `execa`.
 
+### Fixed
+
+- **API documentation gaps closed.** Several types referenced by public API surfaces were not
+  themselves exported, so their doc pages didn't exist and links to them dangled:
+  `EngineSummary` (referenced by the media lint plugin's `BUNDLED_SUMMARIES`), `ChainExecutor`
+  (the media chain's executor seam), and `AudioDecodeFn`/`AudioBufferLike` (the audio-decode
+  engine's override surface) are now exported and documented. The web-retrieval docs' links to
+  `RawRetrievable` now point at `@nhtio/adk/common`, where the type actually lives, and
+  `ScrapperBaseConfig` is re-exported from the scrapper barrel. Cosmetic prose fixes in the
+  media docs ride along. No runtime behavior changes.
+
 ## 2026-06-09
 
 ### Fixed

package/batteries/media/engines/audio_decode.cjs

@@ -3,7 +3,7 @@ require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
 const require_batteries_media_contracts = require("../contracts.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/audio_decode.ts
 /**
 * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/audio_decode.mjs

@@ -1,7 +1,7 @@
 import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
 import { PCM_MIME, pcmToBytes } from "../contracts.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/audio_decode.ts
 /**
 * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/execa_executor.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/execa_executor.ts
 /**
 * A {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor} implementation that runs

package/batteries/media/engines/execa_executor.mjs

@@ -1,6 +1,6 @@
 import { c as isObject, o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/execa_executor.ts
 /**
 * A {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor} implementation that runs

package/batteries/media/engines/fs_workspace.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/fs_workspace.ts
 /**
 * A {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} implementation backed by the

package/batteries/media/engines/fs_workspace.mjs

@@ -1,6 +1,6 @@
 import { o as isError, s as isInstanceOf } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/fs_workspace.ts
 /**
 * A {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} implementation backed by the

package/batteries/media/engines/jimp.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/jimp.ts
 /**
 * A cross-environment image {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/jimp.mjs

@@ -1,6 +1,6 @@
 import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/jimp.ts
 /**
 * A cross-environment image {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/sharp.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/sharp.ts
 /**
 * A Node-native image {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/sharp.mjs

@@ -1,6 +1,6 @@
 import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/sharp.ts
 /**
 * A Node-native image {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/soffice.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_batteries_media_contracts = require("../contracts.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/soffice.ts
 /**
 * The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,

package/batteries/media/engines/soffice.mjs

@@ -1,5 +1,5 @@
 import { implementsBinaryExecutor, implementsScratchWorkspace } from "../contracts.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/soffice.ts
 /**
 * The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,

package/batteries/media/engines/tesseract_js.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/tesseract_js.ts
 /**
 * A cross-environment OCR {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/tesseract_js.mjs

@@ -1,6 +1,6 @@
 import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/tesseract_js.ts
 /**
 * A cross-environment OCR {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/transformers_asr.cjs

@@ -3,7 +3,7 @@ require("../../../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
 require("../../../guards.cjs");
 const require_batteries_media_contracts = require("../contracts.cjs");
-const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+const require_exceptions = require("../../../exceptions-FVwv_Wv0.js");
 //#region src/batteries/media/engines/transformers_asr.ts
 /**
 * A cross-environment transcription {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/engines/transformers_asr.mjs

@@ -1,7 +1,7 @@
 import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
 import "../../../guards.mjs";
 import { PCM_MIME, bytesToPcm } from "../contracts.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-CHnK37jw.mjs";
 //#region src/batteries/media/engines/transformers_asr.ts
 /**
 * A cross-environment transcription {@link @nhtio/adk/batteries/media/contracts!MediaEngine}

package/batteries/media/forge.cjs

@@ -6,8 +6,8 @@ require("../../common-DZl3ADJs.js");
 const require_tool_call = require("../../tool_call-DixVlW40.js");
 const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-ClX72lek.js");
 require("../../guards.cjs");
-const require_exceptions = require("../../exceptions-CQi_lNs1.js");
-const require_validate = require("../../validate-BFaUYHDN.js");
+const require_validate = require("../../validate-B2u04pKh.js");
+const require_exceptions = require("../../exceptions-FVwv_Wv0.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/media/forge.ts
 /**

package/batteries/media/forge.mjs

@@ -4,8 +4,8 @@ import "../../common-DYDUi99O.mjs";
 import { n as Media } from "../../tool_call-B4-_-vjG.mjs";
 import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-wkrBF3oX.mjs";
 import "../../guards.mjs";
-import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../exceptions-C7FSHEnV.mjs";
-import { m as toPipe, o as VERB_INDEX, s as foldVerb, t as availableVerbs } from "../../validate-DSZ3wicB.mjs";
+import { f as VERB_INDEX, l as toPipe, p as foldVerb, t as availableVerbs } from "../../validate-CeJSWy3t.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../exceptions-CHnK37jw.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/media/forge.ts
 /**

package/batteries/media/lint.cjs

@@ -306,7 +306,7 @@ var rules = {
 var plugin = {
 	meta: {
 		name: "@nhtio/adk/batteries/media/lint",
-		version: "0.1.0-master-0e75bb0f"
+		version: "0.1.0-master-f9535eb7"
 	},
 	rules
 };

package/batteries/media/lint.mjs

@@ -302,7 +302,7 @@ var rules = {
 var plugin = {
 	meta: {
 		name: "@nhtio/adk/batteries/media/lint",
-		version: "0.1.0-master-0e75bb0f"
+		version: "0.1.0-master-f9535eb7"
 	},
 	rules
 };

package/batteries/media.cjs

@@ -3,8 +3,8 @@ const require_chunk = require("../chunk-Ble4zEEl.js");
 const require_tool_registry = require("../tool_registry-CKJPze3j.js");
 require("../guards.cjs");
 const require_batteries_media_contracts = require("./media/contracts.cjs");
-const require_exceptions = require("../exceptions-CQi_lNs1.js");
-const require_validate = require("../validate-BFaUYHDN.js");
+const require_validate = require("../validate-B2u04pKh.js");
+const require_exceptions = require("../exceptions-FVwv_Wv0.js");
 let _nhtio_validation = require("@nhtio/validation");
 let _nhtio_middleware = require("@nhtio/middleware");
 let moo = require("moo");

package/batteries/media.mjs

@@ -1,8 +1,8 @@
 import { c as isObject, o as isError, s as isInstanceOf } from "../tool_registry-791Vrjtf.mjs";
 import "../guards.mjs";
 import { PCM_MIME, bytesToPcm, implementsMediaEngine, pcmToBytes } from "./media/contracts.mjs";
-import { a as E_MEDIA_NOT_PIPE_EXPRESSIBLE, c as E_MEDIA_STEP_UNAVAILABLE, d as E_MEDIA_UNSUPPORTED_OP, i as E_MEDIA_MISSING_ARG, l as E_MEDIA_UNKNOWN_ARG, n as E_MEDIA_BAD_ARG, o as E_MEDIA_PIPE_SYNTAX, r as E_MEDIA_ENGINE_REQUIRED, s as E_MEDIA_STEP_FAILED, t as E_INVALID_MEDIA_PIPELINE_CONFIG, u as E_MEDIA_UNKNOWN_VERB } from "../exceptions-C7FSHEnV.mjs";
-import { a as VERBS, c as suggestVerbs, d as isMediaRef, f as isRegExpRef, i as FOLDED_VERBS, l as canonicalFlags, m as toPipe, n as validateOps, o as VERB_INDEX, p as toOps, r as validateSegments, s as foldVerb, t as availableVerbs, u as fromOps } from "../validate-DSZ3wicB.mjs";
+import { a as fromOps, c as toOps, d as VERBS, f as VERB_INDEX, i as canonicalFlags, l as toPipe, m as suggestVerbs, n as validateOps, o as isMediaRef, p as foldVerb, r as validateSegments, s as isRegExpRef, t as availableVerbs, u as FOLDED_VERBS } from "../validate-CeJSWy3t.mjs";
+import { a as E_MEDIA_NOT_PIPE_EXPRESSIBLE, c as E_MEDIA_STEP_UNAVAILABLE, d as E_MEDIA_UNSUPPORTED_OP, i as E_MEDIA_MISSING_ARG, l as E_MEDIA_UNKNOWN_ARG, n as E_MEDIA_BAD_ARG, o as E_MEDIA_PIPE_SYNTAX, r as E_MEDIA_ENGINE_REQUIRED, s as E_MEDIA_STEP_FAILED, t as E_INVALID_MEDIA_PIPELINE_CONFIG, u as E_MEDIA_UNKNOWN_VERB } from "../exceptions-CHnK37jw.mjs";
 import { validator } from "@nhtio/validation";
 import { Middleware } from "@nhtio/middleware";
 import moo from "moo";

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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/arangodb/index.ts

package/batteries/vector/arangodb.mjs

@@ -1,7 +1,7 @@
 import { s as isInstanceOf } from "../../tool_registry-791Vrjtf.mjs";
 import "../../guards.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 { 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";
 //#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_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.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 { 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";
+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";
 //#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_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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 { 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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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 { E_VECTOR_STORE_DIMENSION_MISMATCH } from "./exceptions.mjs";
 import { evaluateFilter } from "./filters.mjs";
+import { E_VECTOR_STORE_DIMENSION_MISMATCH } from "./exceptions.mjs";
+import { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_helpers = require("./helpers.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-791Vrjtf.mjs";
 import "../../guards.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 { 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 { normalizeScore } from "./helpers.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-CKJPze3j.js");
 require("../../guards.cjs");
-const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
 const require_batteries_vector_contract = require("./contract.cjs");
 const require_batteries_vector_validation = require("./validation.cjs");
 //#region src/batteries/vector/meilisearch/index.ts