@nhtio/adk 1.20260610.0 → 1.20260610.1

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/embeddings/openai/adapter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_lib_utils_retry = require("../../../lib/utils/retry.cjs");
 const require_batteries_embeddings_openai_exceptions = require("./exceptions.cjs");

package/batteries/embeddings/openai/adapter.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { computeBackoff, parseRetryAfter, sleepWithJitter } from "../../../lib/utils/retry.mjs";
 import { E_OPENAI_EMBEDDINGS_HTTP_ERROR, E_OPENAI_EMBEDDINGS_MALFORMED_RESPONSE, E_OPENAI_EMBEDDINGS_REQUEST_TIMEOUT } from "./exceptions.mjs";

package/batteries/embeddings/webllm/adapter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_batteries_embeddings_openai_helpers = require("../openai/helpers.cjs");
 const require_batteries_embeddings_webllm_exceptions = require("./exceptions.cjs");

package/batteries/embeddings/webllm/adapter.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { applyEmbeddingPrefix } from "../openai/helpers.mjs";
 import { E_INVALID_WEBLLM_EMBEDDINGS_OPTIONS, E_WEBLLM_EMBEDDINGS_ENGINE_ERROR } from "./exceptions.mjs";

package/batteries/llm/ollama/adapter.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
-const require_thought = require("../../../thought-DLwpF7MI.js");
-const require_spooled_artifact = require("../../../spooled_artifact-DX8LLyUX.js");
-require("../../../common-DZl3ADJs.js");
-const require_tool_call = require("../../../tool_call-DixVlW40.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
+const require_thought = require("../../../thought-BSpZK-Q3.js");
+const require_spooled_artifact = require("../../../spooled_artifact-DmZKXhnn.js");
+require("../../../common-CCDLEmQk.js");
+const require_tool_call = require("../../../tool_call-B1VXAAmn.js");
 require("../../../guards.cjs");
 const require_lib_utils_retry = require("../../../lib/utils/retry.cjs");
 const require_batteries_storage_in_memory = require("../../storage/in_memory.cjs");

package/batteries/llm/ollama/adapter.mjs

@@ -1,8 +1,8 @@
-import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-791Vrjtf.mjs";
-import { n as Message, t as Thought } from "../../../thought-B_vxAiKU.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-7eePq7JA.mjs";
-import "../../../common-DYDUi99O.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-B4-_-vjG.mjs";
+import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-D6gaqCO1.mjs";
+import { n as Message, t as Thought } from "../../../thought-Dpvmq9yj.mjs";
+import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-PV0MTlL1.mjs";
+import "../../../common-Bs4H4NOD.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-B2Ty8FuQ.mjs";
 import "../../../guards.mjs";
 import { computeBackoff, linkAbortSignals, parseRetryAfter, sleepWithJitter } from "../../../lib/utils/retry.mjs";
 import { InMemorySpoolStore } from "../../storage/in_memory.mjs";

package/batteries/llm/ollama/helpers.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-require("../../../common-DZl3ADJs.js");
-const require_tool_call = require("../../../tool_call-DixVlW40.js");
+require("../../../common-CCDLEmQk.js");
+const require_tool_call = require("../../../tool_call-B1VXAAmn.js");
 require("../../../guards.cjs");
 const require_helpers = require("../../../helpers-DSTFxTiC.js");
 const require_batteries_llm_ollama_exceptions = require("./exceptions.cjs");

package/batteries/llm/ollama/helpers.mjs

@@ -1,5 +1,5 @@
-import "../../../common-DYDUi99O.mjs";
-import { n as Media } from "../../../tool_call-B4-_-vjG.mjs";
+import "../../../common-Bs4H4NOD.mjs";
+import { n as Media } from "../../../tool_call-B2Ty8FuQ.mjs";
 import "../../../guards.mjs";
 import { A as retrievableToAttrs, C as renderRetrievables, D as renderThought, E as renderThirdPartyPublicRetrievables, M as toolsToChatCompletionsTools, O as renderTrustedContent, S as renderRetrievableSafetyDirective, T as renderThirdPartyPrivateRetrievables, _ as filterThoughts, a as defaultRenderMemories, b as renderFirstPartyRetrievables, c as defaultRenderStandingInstructions, d as defaultRenderThought, f as defaultRenderTrustedContent, g as escapeXmlAttribute, h as descriptionToChatCompletionsJsonSchema, i as defaultRenderFirstPartyRetrievables, k as renderUntrustedContent, l as defaultRenderThirdPartyPrivateRetrievables, m as defaultToolsToChatCompletionsTools, n as defaultFilterThoughts, o as defaultRenderRetrievableSafetyDirective, p as defaultRenderUntrustedContent, r as defaultRenderChatCompletionsSystemPrompt, s as defaultRenderRetrievables, t as defaultDescriptionToChatCompletionsJsonSchema, u as defaultRenderThirdPartyPublicRetrievables, v as memoryToAttrs, w as renderStandingInstructions, x as renderMemories, y as renderChatCompletionsSystemPrompt } from "../../../helpers-xhrQbMAG.mjs";
 import { E_OLLAMA_UNSUPPORTED_MEDIA_MODALITY } from "./exceptions.mjs";

package/batteries/llm/ollama/validation.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_common = require("../../../common-DZl3ADJs.js");
+const require_common = require("../../../common-CCDLEmQk.js");
 require("../../../guards.cjs");
 const require_batteries_llm_ollama_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");

package/batteries/llm/ollama/validation.mjs

@@ -1,4 +1,4 @@
-import { i as byteStoreSchema } from "../../../common-DYDUi99O.mjs";
+import { i as byteStoreSchema } from "../../../common-Bs4H4NOD.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_OLLAMA_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";

package/batteries/llm/openai_chat_completions/adapter.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
-const require_thought = require("../../../thought-DLwpF7MI.js");
-const require_spooled_artifact = require("../../../spooled_artifact-DX8LLyUX.js");
-require("../../../common-DZl3ADJs.js");
-const require_tool_call = require("../../../tool_call-DixVlW40.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
+const require_thought = require("../../../thought-BSpZK-Q3.js");
+const require_spooled_artifact = require("../../../spooled_artifact-DmZKXhnn.js");
+require("../../../common-CCDLEmQk.js");
+const require_tool_call = require("../../../tool_call-B1VXAAmn.js");
 require("../../../guards.cjs");
 const require_lib_utils_retry = require("../../../lib/utils/retry.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");

package/batteries/llm/openai_chat_completions/adapter.mjs

@@ -1,8 +1,8 @@
-import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-791Vrjtf.mjs";
-import { n as Message, t as Thought } from "../../../thought-B_vxAiKU.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-7eePq7JA.mjs";
-import "../../../common-DYDUi99O.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-B4-_-vjG.mjs";
+import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-D6gaqCO1.mjs";
+import { n as Message, t as Thought } from "../../../thought-Dpvmq9yj.mjs";
+import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-PV0MTlL1.mjs";
+import "../../../common-Bs4H4NOD.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-B2Ty8FuQ.mjs";
 import "../../../guards.mjs";
 import { computeBackoff, linkAbortSignals, parseRetryAfter, sleepWithJitter } from "../../../lib/utils/retry.mjs";
 import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED } from "./exceptions.mjs";

package/batteries/llm/openai_chat_completions/helpers.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-require("../../../common-DZl3ADJs.js");
-const require_tool_call = require("../../../tool_call-DixVlW40.js");
+require("../../../common-CCDLEmQk.js");
+const require_tool_call = require("../../../tool_call-B1VXAAmn.js");
 require("../../../guards.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");
 const require_helpers = require("../../../helpers-DSTFxTiC.js");

package/batteries/llm/openai_chat_completions/helpers.mjs

@@ -1,5 +1,5 @@
-import "../../../common-DYDUi99O.mjs";
-import { n as Media } from "../../../tool_call-B4-_-vjG.mjs";
+import "../../../common-Bs4H4NOD.mjs";
+import { n as Media } from "../../../tool_call-B2Ty8FuQ.mjs";
 import "../../../guards.mjs";
 import { E_UNSUPPORTED_MEDIA_MODALITY } from "./exceptions.mjs";
 import { A as retrievableToAttrs, C as renderRetrievables, D as renderThought, E as renderThirdPartyPublicRetrievables, M as toolsToChatCompletionsTools, O as renderTrustedContent, S as renderRetrievableSafetyDirective, T as renderThirdPartyPrivateRetrievables, _ as filterThoughts, a as defaultRenderMemories, b as renderFirstPartyRetrievables, c as defaultRenderStandingInstructions, d as defaultRenderThought, f as defaultRenderTrustedContent, g as escapeXmlAttribute, h as descriptionToChatCompletionsJsonSchema, i as defaultRenderFirstPartyRetrievables, j as sanitiseNameField, k as renderUntrustedContent, l as defaultRenderThirdPartyPrivateRetrievables, m as defaultToolsToChatCompletionsTools, n as defaultFilterThoughts, o as defaultRenderRetrievableSafetyDirective, p as defaultRenderUntrustedContent, r as defaultRenderChatCompletionsSystemPrompt, s as defaultRenderRetrievables, t as defaultDescriptionToChatCompletionsJsonSchema, u as defaultRenderThirdPartyPublicRetrievables, v as memoryToAttrs, w as renderStandingInstructions, x as renderMemories, y as renderChatCompletionsSystemPrompt } from "../../../helpers-xhrQbMAG.mjs";

package/batteries/llm/openai_chat_completions/validation.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_common = require("../../../common-DZl3ADJs.js");
+const require_common = require("../../../common-CCDLEmQk.js");
 require("../../../guards.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");

package/batteries/llm/openai_chat_completions/validation.mjs

@@ -1,4 +1,4 @@
-import { i as byteStoreSchema } from "../../../common-DYDUi99O.mjs";
+import { i as byteStoreSchema } from "../../../common-Bs4H4NOD.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";

package/batteries/llm/webllm_chat_completions/adapter.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
-const require_thought = require("../../../thought-DLwpF7MI.js");
-const require_spooled_artifact = require("../../../spooled_artifact-DX8LLyUX.js");
-require("../../../common-DZl3ADJs.js");
-const require_tool_call = require("../../../tool_call-DixVlW40.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
+const require_thought = require("../../../thought-BSpZK-Q3.js");
+const require_spooled_artifact = require("../../../spooled_artifact-DmZKXhnn.js");
+require("../../../common-CCDLEmQk.js");
+const require_tool_call = require("../../../tool_call-B1VXAAmn.js");
 require("../../../guards.cjs");
 const require_batteries_storage_in_memory = require("../../storage/in_memory.cjs");
 const require_helpers = require("../../../helpers-DSTFxTiC.js");

package/batteries/llm/webllm_chat_completions/adapter.mjs

@@ -1,8 +1,8 @@
-import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-791Vrjtf.mjs";
-import { n as Message, t as Thought } from "../../../thought-B_vxAiKU.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-7eePq7JA.mjs";
-import "../../../common-DYDUi99O.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-B4-_-vjG.mjs";
+import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-D6gaqCO1.mjs";
+import { n as Message, t as Thought } from "../../../thought-Dpvmq9yj.mjs";
+import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-PV0MTlL1.mjs";
+import "../../../common-Bs4H4NOD.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-B2Ty8FuQ.mjs";
 import "../../../guards.mjs";
 import { InMemorySpoolStore } from "../../storage/in_memory.mjs";
 import { a as defaultRenderMemories, c as defaultRenderStandingInstructions, d as defaultRenderThought, f as defaultRenderTrustedContent, i as defaultRenderFirstPartyRetrievables, l as defaultRenderThirdPartyPrivateRetrievables, m as defaultToolsToChatCompletionsTools, n as defaultFilterThoughts, o as defaultRenderRetrievableSafetyDirective, p as defaultRenderUntrustedContent, r as defaultRenderChatCompletionsSystemPrompt, s as defaultRenderRetrievables, t as defaultDescriptionToChatCompletionsJsonSchema, u as defaultRenderThirdPartyPublicRetrievables } from "../../../helpers-xhrQbMAG.mjs";

package/batteries/llm/webllm_chat_completions/validation.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_common = require("../../../common-DZl3ADJs.js");
+const require_common = require("../../../common-CCDLEmQk.js");
 require("../../../guards.cjs");
 const require_batteries_llm_webllm_chat_completions_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");

package/batteries/llm/webllm_chat_completions/validation.mjs

@@ -1,4 +1,4 @@
-import { i as byteStoreSchema } from "../../../common-DYDUi99O.mjs";
+import { i as byteStoreSchema } from "../../../common-Bs4H4NOD.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";

package/batteries/media/contracts.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../tool_registry-qQXq9zs0.js");
 require("../../guards.cjs");
 //#region src/batteries/media/contracts.ts
 /**

package/batteries/media/contracts.mjs

@@ -1,4 +1,4 @@
-import { c as isObject } from "../../tool_registry-791Vrjtf.mjs";
+import { c as isObject } from "../../tool_registry-D6gaqCO1.mjs";
 import "../../guards.mjs";
 //#region src/batteries/media/contracts.ts
 /**

package/batteries/media/engines/audio_decode.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_batteries_media_contracts = require("../contracts.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");

package/batteries/media/engines/audio_decode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"audio_decode.cjs","names":[],"sources":["../../../../src/batteries/media/engines/audio_decode.ts"],"sourcesContent":["/**\n * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}\n * backed by the `audio-decode` package (pure JS/WASM codecs — no ffmpeg, no native bindings;\n * works in Node and browsers).\n *\n * @module @nhtio/adk/batteries/media/engines/audio_decode\n *\n * @remarks\n * Declares one convert capability: audio containers to the virtual `pcm` token (mp3 /\n * m4a-aac / ogg-vorbis / opus / flac / wav), downmixed to mono. The PCM output reports the\n * SOURCE sample rate in `meta.sampleRate` — the pipeline's transcribe step resamples to the\n * 16 kHz transcription engines expect. For exotic containers, compose an ffmpeg-backed\n * engine instead; the capability declaration is the seam.\n *\n * `audio-decode` is an optional peer dependency, lazily imported on first actual use.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { pcmToBytes, PCM_MIME } from '../contracts'\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport type { MediaEngine, ConvertRequest, ConvertResult } from '../contracts'\n\n/**\n * The decoded shapes audio-decode resolves to. Some codecs return an AudioBuffer-compatible\n * object (`numberOfChannels` + `getChannelData`); others (e.g. the wav path in Node) return a\n * plain `{ channelData: Float32Array[], sampleRate }` record. The engine normalizes both.\n */\ninterface AudioBufferLike {\n  numberOfChannels?: number\n  sampleRate: number\n  getChannelData?(channel: number): Float32Array\n  channelData?: Float32Array[]\n}\n\ntype AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>\n\nconst channelsOf = (buffer: AudioBufferLike): Float32Array[] => {\n  if (Array.isArray(buffer.channelData)) return buffer.channelData\n  if (typeof buffer.getChannelData === 'function') {\n    const count = buffer.numberOfChannels ?? 1\n    return Array.from({ length: count }, (_, c) => buffer.getChannelData!(c))\n  }\n  throw new Error('audio-decode returned an unrecognized buffer shape')\n}\n\n/** Options for {@link audioDecodeEngine}. */\nexport interface AudioDecodeEngineOptions {\n  /** Override the module resolution. Default: `import('audio-decode')`. */\n  audioDecode?: () =>\n    | AudioDecodeFn\n    | { default: AudioDecodeFn }\n    | Promise<AudioDecodeFn | { default: AudioDecodeFn }>\n}\n\n/**\n * Construct the audio-decode-backed engine.\n *\n * @param options - Optional module resolver override.\n * @returns The engine.\n */\nexport const audioDecodeEngine = (options: AudioDecodeEngineOptions = {}): MediaEngine => {\n  let fnPromise: Promise<AudioDecodeFn> | undefined\n  const getDecode = (): Promise<AudioDecodeFn> => {\n    fnPromise ??= Promise.resolve(\n      options.audioDecode ? options.audioDecode() : import('audio-decode')\n    )\n      .then((mod) => {\n        const fn = typeof mod === 'function' ? mod : (mod as { default: AudioDecodeFn }).default\n        if (typeof fn !== 'function') {\n          throw new Error('audio-decode did not resolve to a decode function')\n        }\n        return fn\n      })\n      .catch((err) => {\n        const detail = isError(err) ? err.message : String(err)\n        throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n          `the audio-decode engine could not load its peer dependency \"audio-decode\": ${detail} — install it (pnpm add audio-decode)`,\n        ])\n      })\n    return fnPromise\n  }\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const decode = await getDecode()\n    const buffer = await decode(request.bytes)\n    const channels = channelsOf(buffer)\n    let pcm: Float32Array\n    if (channels.length <= 1) {\n      pcm = channels[0]\n    } else {\n      // Downmix to mono by averaging channels.\n      const length = channels[0].length\n      const mono = new Float32Array(length)\n      for (const data of channels) {\n        for (let i = 0; i < length; i++) mono[i] += data[i] / channels.length\n      }\n      pcm = mono\n    }\n    return {\n      outputs: [\n        { bytes: pcmToBytes(pcm), mimeType: PCM_MIME, meta: { sampleRate: buffer.sampleRate } },\n      ],\n    }\n  }\n\n  return {\n    id: 'audio-decode',\n    converts: [\n      {\n        from: [\n          'audio/mpeg',\n          'audio/mp3',\n          'audio/mp4',\n          'audio/aac',\n          'audio/x-m4a',\n          'audio/ogg',\n          'audio/opus',\n          'audio/flac',\n          'audio/x-flac',\n          'audio/wav',\n          'audio/x-wav',\n          'audio/wave',\n        ],\n        to: ['pcm'],\n        convert,\n      },\n    ],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,IAAM,cAAc,WAA4C;CAC9D,IAAI,MAAM,QAAQ,OAAO,WAAW,GAAG,OAAO,OAAO;CACrD,IAAI,OAAO,OAAO,mBAAmB,YAAY;EAC/C,MAAM,QAAQ,OAAO,oBAAoB;EACzC,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,MAAM,OAAO,eAAgB,CAAC,CAAC;CAC1E;CACA,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;AAiBA,IAAa,qBAAqB,UAAoC,CAAC,MAAmB;CACxF,IAAI;CACJ,MAAM,kBAA0C;EAC9C,cAAc,QAAQ,QACpB,QAAQ,cAAc,QAAQ,YAAY,IAAI,OAAO,eACvD,EACG,MAAM,QAAQ;GACb,MAAM,KAAK,OAAO,QAAQ,aAAa,MAAO,IAAmC;GACjF,IAAI,OAAO,OAAO,YAChB,MAAM,IAAI,MAAM,mDAAmD;GAErE,OAAO;EACT,CAAC,EACA,OAAO,QAAQ;GAEd,MAAM,IAAI,mBAAA,gCAAgC,CACxC,8EAFa,sBAAA,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAEiC,sCACvF,CAAC;EACH,CAAC;EACH,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,YAAoD;EAEzE,MAAM,SAAS,OAAM,MADA,UAAU,GACH,QAAQ,KAAK;EACzC,MAAM,WAAW,WAAW,MAAM;EAClC,IAAI;EACJ,IAAI,SAAS,UAAU,GACrB,MAAM,SAAS;OACV;GAEL,MAAM,SAAS,SAAS,GAAG;GAC3B,MAAM,OAAO,IAAI,aAAa,MAAM;GACpC,KAAK,MAAM,QAAQ,UACjB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,KAAK,MAAM,KAAK,KAAK,SAAS;GAEjE,MAAM;EACR;EACA,OAAO,EACL,SAAS,CACP;GAAE,OAAO,kCAAA,WAAW,GAAG;GAAG,UAAU,kCAAA;GAAU,MAAM,EAAE,YAAY,OAAO,WAAW;EAAE,CACxF,EACF;CACF;CAEA,OAAO;EACL,IAAI;EACJ,UAAU,CACR;GACE,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;GACA,IAAI,CAAC,KAAK;GACV;EACF,CACF;CACF;AACF"}
+{"version":3,"file":"audio_decode.cjs","names":[],"sources":["../../../../src/batteries/media/engines/audio_decode.ts"],"sourcesContent":["/**\n * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}\n * backed by the `audio-decode` package (pure JS/WASM codecs — no ffmpeg, no native bindings;\n * works in Node and browsers).\n *\n * @module @nhtio/adk/batteries/media/engines/audio_decode\n *\n * @remarks\n * Declares one convert capability: audio containers to the virtual `pcm` token (mp3 /\n * m4a-aac / ogg-vorbis / opus / flac / wav), downmixed to mono. The PCM output reports the\n * SOURCE sample rate in `meta.sampleRate` — the pipeline's transcribe step resamples to the\n * 16 kHz transcription engines expect. For exotic containers, compose an ffmpeg-backed\n * engine instead; the capability declaration is the seam.\n *\n * `audio-decode` is an optional peer dependency, lazily imported on first actual use.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { pcmToBytes, PCM_MIME } from '../contracts'\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport type { MediaEngine, ConvertRequest, ConvertResult } from '../contracts'\n\n/**\n * The decoded shapes audio-decode resolves to. Some codecs return an AudioBuffer-compatible\n * object (`numberOfChannels` + `getChannelData`); others (e.g. the wav path in Node) return a\n * plain `{ channelData: Float32Array[], sampleRate }` record. The engine normalizes both.\n */\nexport interface AudioBufferLike {\n  /** Channel count when the AudioBuffer-compatible shape is returned. */\n  numberOfChannels?: number\n  /** Sample rate of the decoded audio, in Hz. Present on both shapes. */\n  sampleRate: number\n  /** Per-channel sample accessor on the AudioBuffer-compatible shape. */\n  getChannelData?(channel: number): Float32Array\n  /** Raw per-channel sample arrays on the plain-record shape. */\n  channelData?: Float32Array[]\n}\n\n/** The decode function shape the `audio-decode` package exports. */\nexport type AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>\n\nconst channelsOf = (buffer: AudioBufferLike): Float32Array[] => {\n  if (Array.isArray(buffer.channelData)) return buffer.channelData\n  if (typeof buffer.getChannelData === 'function') {\n    const count = buffer.numberOfChannels ?? 1\n    return Array.from({ length: count }, (_, c) => buffer.getChannelData!(c))\n  }\n  throw new Error('audio-decode returned an unrecognized buffer shape')\n}\n\n/** Options for {@link audioDecodeEngine}. */\nexport interface AudioDecodeEngineOptions {\n  /** Override the module resolution. Default: `import('audio-decode')`. */\n  audioDecode?: () =>\n    | AudioDecodeFn\n    | { default: AudioDecodeFn }\n    | Promise<AudioDecodeFn | { default: AudioDecodeFn }>\n}\n\n/**\n * Construct the audio-decode-backed engine.\n *\n * @param options - Optional module resolver override.\n * @returns The engine.\n */\nexport const audioDecodeEngine = (options: AudioDecodeEngineOptions = {}): MediaEngine => {\n  let fnPromise: Promise<AudioDecodeFn> | undefined\n  const getDecode = (): Promise<AudioDecodeFn> => {\n    fnPromise ??= Promise.resolve(\n      options.audioDecode ? options.audioDecode() : import('audio-decode')\n    )\n      .then((mod) => {\n        const fn = typeof mod === 'function' ? mod : (mod as { default: AudioDecodeFn }).default\n        if (typeof fn !== 'function') {\n          throw new Error('audio-decode did not resolve to a decode function')\n        }\n        return fn\n      })\n      .catch((err) => {\n        const detail = isError(err) ? err.message : String(err)\n        throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n          `the audio-decode engine could not load its peer dependency \"audio-decode\": ${detail} — install it (pnpm add audio-decode)`,\n        ])\n      })\n    return fnPromise\n  }\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const decode = await getDecode()\n    const buffer = await decode(request.bytes)\n    const channels = channelsOf(buffer)\n    let pcm: Float32Array\n    if (channels.length <= 1) {\n      pcm = channels[0]\n    } else {\n      // Downmix to mono by averaging channels.\n      const length = channels[0].length\n      const mono = new Float32Array(length)\n      for (const data of channels) {\n        for (let i = 0; i < length; i++) mono[i] += data[i] / channels.length\n      }\n      pcm = mono\n    }\n    return {\n      outputs: [\n        { bytes: pcmToBytes(pcm), mimeType: PCM_MIME, meta: { sampleRate: buffer.sampleRate } },\n      ],\n    }\n  }\n\n  return {\n    id: 'audio-decode',\n    converts: [\n      {\n        from: [\n          'audio/mpeg',\n          'audio/mp3',\n          'audio/mp4',\n          'audio/aac',\n          'audio/x-m4a',\n          'audio/ogg',\n          'audio/opus',\n          'audio/flac',\n          'audio/x-flac',\n          'audio/wav',\n          'audio/x-wav',\n          'audio/wave',\n        ],\n        to: ['pcm'],\n        convert,\n      },\n    ],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyCA,IAAM,cAAc,WAA4C;CAC9D,IAAI,MAAM,QAAQ,OAAO,WAAW,GAAG,OAAO,OAAO;CACrD,IAAI,OAAO,OAAO,mBAAmB,YAAY;EAC/C,MAAM,QAAQ,OAAO,oBAAoB;EACzC,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,MAAM,OAAO,eAAgB,CAAC,CAAC;CAC1E;CACA,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;AAiBA,IAAa,qBAAqB,UAAoC,CAAC,MAAmB;CACxF,IAAI;CACJ,MAAM,kBAA0C;EAC9C,cAAc,QAAQ,QACpB,QAAQ,cAAc,QAAQ,YAAY,IAAI,OAAO,eACvD,EACG,MAAM,QAAQ;GACb,MAAM,KAAK,OAAO,QAAQ,aAAa,MAAO,IAAmC;GACjF,IAAI,OAAO,OAAO,YAChB,MAAM,IAAI,MAAM,mDAAmD;GAErE,OAAO;EACT,CAAC,EACA,OAAO,QAAQ;GAEd,MAAM,IAAI,mBAAA,gCAAgC,CACxC,8EAFa,sBAAA,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAEiC,sCACvF,CAAC;EACH,CAAC;EACH,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,YAAoD;EAEzE,MAAM,SAAS,OAAM,MADA,UAAU,GACH,QAAQ,KAAK;EACzC,MAAM,WAAW,WAAW,MAAM;EAClC,IAAI;EACJ,IAAI,SAAS,UAAU,GACrB,MAAM,SAAS;OACV;GAEL,MAAM,SAAS,SAAS,GAAG;GAC3B,MAAM,OAAO,IAAI,aAAa,MAAM;GACpC,KAAK,MAAM,QAAQ,UACjB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,KAAK,MAAM,KAAK,KAAK,SAAS;GAEjE,MAAM;EACR;EACA,OAAO,EACL,SAAS,CACP;GAAE,OAAO,kCAAA,WAAW,GAAG;GAAG,UAAU,kCAAA;GAAU,MAAM,EAAE,YAAY,OAAO,WAAW;EAAE,CACxF,EACF;CACF;CAEA,OAAO;EACL,IAAI;EACJ,UAAU,CACR;GACE,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;GACA,IAAI,CAAC,KAAK;GACV;EACF,CACF;CACF;AACF"}

package/batteries/media/engines/audio_decode.d.ts

@@ -20,13 +20,18 @@ import type { MediaEngine } from "../contracts";
  * object (`numberOfChannels` + `getChannelData`); others (e.g. the wav path in Node) return a
  * plain `{ channelData: Float32Array[], sampleRate }` record. The engine normalizes both.
  */
-interface AudioBufferLike {
+export interface AudioBufferLike {
+    /** Channel count when the AudioBuffer-compatible shape is returned. */
     numberOfChannels?: number;
+    /** Sample rate of the decoded audio, in Hz. Present on both shapes. */
     sampleRate: number;
+    /** Per-channel sample accessor on the AudioBuffer-compatible shape. */
     getChannelData?(channel: number): Float32Array;
+    /** Raw per-channel sample arrays on the plain-record shape. */
     channelData?: Float32Array[];
 }
-type AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>;
+/** The decode function shape the `audio-decode` package exports. */
+export type AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>;
 /** Options for {@link audioDecodeEngine}. */
 export interface AudioDecodeEngineOptions {
     /** Override the module resolution. Default: `import('audio-decode')`. */
@@ -43,4 +48,3 @@ export interface AudioDecodeEngineOptions {
  * @returns The engine.
  */
 export declare const audioDecodeEngine: (options?: AudioDecodeEngineOptions) => MediaEngine;
-export {};

package/batteries/media/engines/audio_decode.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { PCM_MIME, pcmToBytes } from "../contracts.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";

package/batteries/media/engines/audio_decode.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"audio_decode.mjs","names":[],"sources":["../../../../src/batteries/media/engines/audio_decode.ts"],"sourcesContent":["/**\n * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}\n * backed by the `audio-decode` package (pure JS/WASM codecs — no ffmpeg, no native bindings;\n * works in Node and browsers).\n *\n * @module @nhtio/adk/batteries/media/engines/audio_decode\n *\n * @remarks\n * Declares one convert capability: audio containers to the virtual `pcm` token (mp3 /\n * m4a-aac / ogg-vorbis / opus / flac / wav), downmixed to mono. The PCM output reports the\n * SOURCE sample rate in `meta.sampleRate` — the pipeline's transcribe step resamples to the\n * 16 kHz transcription engines expect. For exotic containers, compose an ffmpeg-backed\n * engine instead; the capability declaration is the seam.\n *\n * `audio-decode` is an optional peer dependency, lazily imported on first actual use.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { pcmToBytes, PCM_MIME } from '../contracts'\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport type { MediaEngine, ConvertRequest, ConvertResult } from '../contracts'\n\n/**\n * The decoded shapes audio-decode resolves to. Some codecs return an AudioBuffer-compatible\n * object (`numberOfChannels` + `getChannelData`); others (e.g. the wav path in Node) return a\n * plain `{ channelData: Float32Array[], sampleRate }` record. The engine normalizes both.\n */\ninterface AudioBufferLike {\n  numberOfChannels?: number\n  sampleRate: number\n  getChannelData?(channel: number): Float32Array\n  channelData?: Float32Array[]\n}\n\ntype AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>\n\nconst channelsOf = (buffer: AudioBufferLike): Float32Array[] => {\n  if (Array.isArray(buffer.channelData)) return buffer.channelData\n  if (typeof buffer.getChannelData === 'function') {\n    const count = buffer.numberOfChannels ?? 1\n    return Array.from({ length: count }, (_, c) => buffer.getChannelData!(c))\n  }\n  throw new Error('audio-decode returned an unrecognized buffer shape')\n}\n\n/** Options for {@link audioDecodeEngine}. */\nexport interface AudioDecodeEngineOptions {\n  /** Override the module resolution. Default: `import('audio-decode')`. */\n  audioDecode?: () =>\n    | AudioDecodeFn\n    | { default: AudioDecodeFn }\n    | Promise<AudioDecodeFn | { default: AudioDecodeFn }>\n}\n\n/**\n * Construct the audio-decode-backed engine.\n *\n * @param options - Optional module resolver override.\n * @returns The engine.\n */\nexport const audioDecodeEngine = (options: AudioDecodeEngineOptions = {}): MediaEngine => {\n  let fnPromise: Promise<AudioDecodeFn> | undefined\n  const getDecode = (): Promise<AudioDecodeFn> => {\n    fnPromise ??= Promise.resolve(\n      options.audioDecode ? options.audioDecode() : import('audio-decode')\n    )\n      .then((mod) => {\n        const fn = typeof mod === 'function' ? mod : (mod as { default: AudioDecodeFn }).default\n        if (typeof fn !== 'function') {\n          throw new Error('audio-decode did not resolve to a decode function')\n        }\n        return fn\n      })\n      .catch((err) => {\n        const detail = isError(err) ? err.message : String(err)\n        throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n          `the audio-decode engine could not load its peer dependency \"audio-decode\": ${detail} — install it (pnpm add audio-decode)`,\n        ])\n      })\n    return fnPromise\n  }\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const decode = await getDecode()\n    const buffer = await decode(request.bytes)\n    const channels = channelsOf(buffer)\n    let pcm: Float32Array\n    if (channels.length <= 1) {\n      pcm = channels[0]\n    } else {\n      // Downmix to mono by averaging channels.\n      const length = channels[0].length\n      const mono = new Float32Array(length)\n      for (const data of channels) {\n        for (let i = 0; i < length; i++) mono[i] += data[i] / channels.length\n      }\n      pcm = mono\n    }\n    return {\n      outputs: [\n        { bytes: pcmToBytes(pcm), mimeType: PCM_MIME, meta: { sampleRate: buffer.sampleRate } },\n      ],\n    }\n  }\n\n  return {\n    id: 'audio-decode',\n    converts: [\n      {\n        from: [\n          'audio/mpeg',\n          'audio/mp3',\n          'audio/mp4',\n          'audio/aac',\n          'audio/x-m4a',\n          'audio/ogg',\n          'audio/opus',\n          'audio/flac',\n          'audio/x-flac',\n          'audio/wav',\n          'audio/x-wav',\n          'audio/wave',\n        ],\n        to: ['pcm'],\n        convert,\n      },\n    ],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,IAAM,cAAc,WAA4C;CAC9D,IAAI,MAAM,QAAQ,OAAO,WAAW,GAAG,OAAO,OAAO;CACrD,IAAI,OAAO,OAAO,mBAAmB,YAAY;EAC/C,MAAM,QAAQ,OAAO,oBAAoB;EACzC,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,MAAM,OAAO,eAAgB,CAAC,CAAC;CAC1E;CACA,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;AAiBA,IAAa,qBAAqB,UAAoC,CAAC,MAAmB;CACxF,IAAI;CACJ,MAAM,kBAA0C;EAC9C,cAAc,QAAQ,QACpB,QAAQ,cAAc,QAAQ,YAAY,IAAI,OAAO,eACvD,EACG,MAAM,QAAQ;GACb,MAAM,KAAK,OAAO,QAAQ,aAAa,MAAO,IAAmC;GACjF,IAAI,OAAO,OAAO,YAChB,MAAM,IAAI,MAAM,mDAAmD;GAErE,OAAO;EACT,CAAC,EACA,OAAO,QAAQ;GAEd,MAAM,IAAI,gCAAgC,CACxC,8EAFa,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAEiC,sCACvF,CAAC;EACH,CAAC;EACH,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,YAAoD;EAEzE,MAAM,SAAS,OAAM,MADA,UAAU,GACH,QAAQ,KAAK;EACzC,MAAM,WAAW,WAAW,MAAM;EAClC,IAAI;EACJ,IAAI,SAAS,UAAU,GACrB,MAAM,SAAS;OACV;GAEL,MAAM,SAAS,SAAS,GAAG;GAC3B,MAAM,OAAO,IAAI,aAAa,MAAM;GACpC,KAAK,MAAM,QAAQ,UACjB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,KAAK,MAAM,KAAK,KAAK,SAAS;GAEjE,MAAM;EACR;EACA,OAAO,EACL,SAAS,CACP;GAAE,OAAO,WAAW,GAAG;GAAG,UAAU;GAAU,MAAM,EAAE,YAAY,OAAO,WAAW;EAAE,CACxF,EACF;CACF;CAEA,OAAO;EACL,IAAI;EACJ,UAAU,CACR;GACE,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;GACA,IAAI,CAAC,KAAK;GACV;EACF,CACF;CACF;AACF"}
+{"version":3,"file":"audio_decode.mjs","names":[],"sources":["../../../../src/batteries/media/engines/audio_decode.ts"],"sourcesContent":["/**\n * A cross-environment audio-decoding {@link @nhtio/adk/batteries/media/contracts!MediaEngine}\n * backed by the `audio-decode` package (pure JS/WASM codecs — no ffmpeg, no native bindings;\n * works in Node and browsers).\n *\n * @module @nhtio/adk/batteries/media/engines/audio_decode\n *\n * @remarks\n * Declares one convert capability: audio containers to the virtual `pcm` token (mp3 /\n * m4a-aac / ogg-vorbis / opus / flac / wav), downmixed to mono. The PCM output reports the\n * SOURCE sample rate in `meta.sampleRate` — the pipeline's transcribe step resamples to the\n * 16 kHz transcription engines expect. For exotic containers, compose an ffmpeg-backed\n * engine instead; the capability declaration is the seam.\n *\n * `audio-decode` is an optional peer dependency, lazily imported on first actual use.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { pcmToBytes, PCM_MIME } from '../contracts'\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport type { MediaEngine, ConvertRequest, ConvertResult } from '../contracts'\n\n/**\n * The decoded shapes audio-decode resolves to. Some codecs return an AudioBuffer-compatible\n * object (`numberOfChannels` + `getChannelData`); others (e.g. the wav path in Node) return a\n * plain `{ channelData: Float32Array[], sampleRate }` record. The engine normalizes both.\n */\nexport interface AudioBufferLike {\n  /** Channel count when the AudioBuffer-compatible shape is returned. */\n  numberOfChannels?: number\n  /** Sample rate of the decoded audio, in Hz. Present on both shapes. */\n  sampleRate: number\n  /** Per-channel sample accessor on the AudioBuffer-compatible shape. */\n  getChannelData?(channel: number): Float32Array\n  /** Raw per-channel sample arrays on the plain-record shape. */\n  channelData?: Float32Array[]\n}\n\n/** The decode function shape the `audio-decode` package exports. */\nexport type AudioDecodeFn = (bytes: Uint8Array | ArrayBuffer) => Promise<AudioBufferLike>\n\nconst channelsOf = (buffer: AudioBufferLike): Float32Array[] => {\n  if (Array.isArray(buffer.channelData)) return buffer.channelData\n  if (typeof buffer.getChannelData === 'function') {\n    const count = buffer.numberOfChannels ?? 1\n    return Array.from({ length: count }, (_, c) => buffer.getChannelData!(c))\n  }\n  throw new Error('audio-decode returned an unrecognized buffer shape')\n}\n\n/** Options for {@link audioDecodeEngine}. */\nexport interface AudioDecodeEngineOptions {\n  /** Override the module resolution. Default: `import('audio-decode')`. */\n  audioDecode?: () =>\n    | AudioDecodeFn\n    | { default: AudioDecodeFn }\n    | Promise<AudioDecodeFn | { default: AudioDecodeFn }>\n}\n\n/**\n * Construct the audio-decode-backed engine.\n *\n * @param options - Optional module resolver override.\n * @returns The engine.\n */\nexport const audioDecodeEngine = (options: AudioDecodeEngineOptions = {}): MediaEngine => {\n  let fnPromise: Promise<AudioDecodeFn> | undefined\n  const getDecode = (): Promise<AudioDecodeFn> => {\n    fnPromise ??= Promise.resolve(\n      options.audioDecode ? options.audioDecode() : import('audio-decode')\n    )\n      .then((mod) => {\n        const fn = typeof mod === 'function' ? mod : (mod as { default: AudioDecodeFn }).default\n        if (typeof fn !== 'function') {\n          throw new Error('audio-decode did not resolve to a decode function')\n        }\n        return fn\n      })\n      .catch((err) => {\n        const detail = isError(err) ? err.message : String(err)\n        throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n          `the audio-decode engine could not load its peer dependency \"audio-decode\": ${detail} — install it (pnpm add audio-decode)`,\n        ])\n      })\n    return fnPromise\n  }\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const decode = await getDecode()\n    const buffer = await decode(request.bytes)\n    const channels = channelsOf(buffer)\n    let pcm: Float32Array\n    if (channels.length <= 1) {\n      pcm = channels[0]\n    } else {\n      // Downmix to mono by averaging channels.\n      const length = channels[0].length\n      const mono = new Float32Array(length)\n      for (const data of channels) {\n        for (let i = 0; i < length; i++) mono[i] += data[i] / channels.length\n      }\n      pcm = mono\n    }\n    return {\n      outputs: [\n        { bytes: pcmToBytes(pcm), mimeType: PCM_MIME, meta: { sampleRate: buffer.sampleRate } },\n      ],\n    }\n  }\n\n  return {\n    id: 'audio-decode',\n    converts: [\n      {\n        from: [\n          'audio/mpeg',\n          'audio/mp3',\n          'audio/mp4',\n          'audio/aac',\n          'audio/x-m4a',\n          'audio/ogg',\n          'audio/opus',\n          'audio/flac',\n          'audio/x-flac',\n          'audio/wav',\n          'audio/x-wav',\n          'audio/wave',\n        ],\n        to: ['pcm'],\n        convert,\n      },\n    ],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyCA,IAAM,cAAc,WAA4C;CAC9D,IAAI,MAAM,QAAQ,OAAO,WAAW,GAAG,OAAO,OAAO;CACrD,IAAI,OAAO,OAAO,mBAAmB,YAAY;EAC/C,MAAM,QAAQ,OAAO,oBAAoB;EACzC,OAAO,MAAM,KAAK,EAAE,QAAQ,MAAM,IAAI,GAAG,MAAM,OAAO,eAAgB,CAAC,CAAC;CAC1E;CACA,MAAM,IAAI,MAAM,oDAAoD;AACtE;;;;;;;AAiBA,IAAa,qBAAqB,UAAoC,CAAC,MAAmB;CACxF,IAAI;CACJ,MAAM,kBAA0C;EAC9C,cAAc,QAAQ,QACpB,QAAQ,cAAc,QAAQ,YAAY,IAAI,OAAO,eACvD,EACG,MAAM,QAAQ;GACb,MAAM,KAAK,OAAO,QAAQ,aAAa,MAAO,IAAmC;GACjF,IAAI,OAAO,OAAO,YAChB,MAAM,IAAI,MAAM,mDAAmD;GAErE,OAAO;EACT,CAAC,EACA,OAAO,QAAQ;GAEd,MAAM,IAAI,gCAAgC,CACxC,8EAFa,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAEiC,sCACvF,CAAC;EACH,CAAC;EACH,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,YAAoD;EAEzE,MAAM,SAAS,OAAM,MADA,UAAU,GACH,QAAQ,KAAK;EACzC,MAAM,WAAW,WAAW,MAAM;EAClC,IAAI;EACJ,IAAI,SAAS,UAAU,GACrB,MAAM,SAAS;OACV;GAEL,MAAM,SAAS,SAAS,GAAG;GAC3B,MAAM,OAAO,IAAI,aAAa,MAAM;GACpC,KAAK,MAAM,QAAQ,UACjB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,KAAK,KAAK,MAAM,KAAK,KAAK,SAAS;GAEjE,MAAM;EACR;EACA,OAAO,EACL,SAAS,CACP;GAAE,OAAO,WAAW,GAAG;GAAG,UAAU;GAAU,MAAM,EAAE,YAAY,OAAO,WAAW;EAAE,CACxF,EACF;CACF;CAEA,OAAO;EACL,IAAI;EACJ,UAAU,CACR;GACE,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;GACA,IAAI,CAAC,KAAK;GACV;EACF,CACF;CACF;AACF"}

package/batteries/media/engines/execa_executor.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
 //#region src/batteries/media/engines/execa_executor.ts

package/batteries/media/engines/execa_executor.mjs

@@ -1,4 +1,4 @@
-import { c as isObject, o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { c as isObject, o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
 //#region src/batteries/media/engines/execa_executor.ts

package/batteries/media/engines/fs_workspace.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
 //#region src/batteries/media/engines/fs_workspace.ts

package/batteries/media/engines/fs_workspace.mjs

@@ -1,4 +1,4 @@
-import { o as isError, s as isInstanceOf } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError, s as isInstanceOf } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
 //#region src/batteries/media/engines/fs_workspace.ts

package/batteries/media/engines/jimp.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
 //#region src/batteries/media/engines/jimp.ts

package/batteries/media/engines/jimp.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
 //#region src/batteries/media/engines/jimp.ts

package/batteries/media/engines/sharp.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
 //#region src/batteries/media/engines/sharp.ts

package/batteries/media/engines/sharp.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
 //#region src/batteries/media/engines/sharp.ts

package/batteries/media/engines/tesseract_js.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
 //#region src/batteries/media/engines/tesseract_js.ts

package/batteries/media/engines/tesseract_js.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
 //#region src/batteries/media/engines/tesseract_js.ts

package/batteries/media/engines/transformers_asr.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_tool_registry = require("../../../tool_registry-qQXq9zs0.js");
 require("../../../guards.cjs");
 const require_batteries_media_contracts = require("../contracts.cjs");
 const require_exceptions = require("../../../exceptions-CQi_lNs1.js");

package/batteries/media/engines/transformers_asr.mjs

@@ -1,4 +1,4 @@
-import { o as isError } from "../../../tool_registry-791Vrjtf.mjs";
+import { o as isError } from "../../../tool_registry-D6gaqCO1.mjs";
 import "../../../guards.mjs";
 import { PCM_MIME, bytesToPcm } from "../contracts.mjs";
 import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";

package/batteries/media/forge.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-CKJPze3j.js");
-const require_tool = require("../../tool-D5WGVIcI.js");
-require("../../common-DZl3ADJs.js");
-const require_tool_call = require("../../tool_call-DixVlW40.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-ClX72lek.js");
+const require_tool_registry = require("../../tool_registry-qQXq9zs0.js");
+const require_tool = require("../../tool-aEQQxXve.js");
+require("../../common-CCDLEmQk.js");
+const require_tool_call = require("../../tool_call-B1VXAAmn.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-CyedUE_d.js");
 require("../../guards.cjs");
 const require_exceptions = require("../../exceptions-CQi_lNs1.js");
-const require_validate = require("../../validate-BFaUYHDN.js");
+const require_validate = require("../../validate-DUnMQTt1.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/media/forge.ts
 /**

package/batteries/media/forge.mjs

@@ -1,11 +1,11 @@
-import { o as isError } from "../../tool_registry-791Vrjtf.mjs";
-import { t as Tool } from "../../tool-wMYMVl60.mjs";
-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 { o as isError } from "../../tool_registry-D6gaqCO1.mjs";
+import { t as Tool } from "../../tool-AaLCDVjO.mjs";
+import "../../common-Bs4H4NOD.mjs";
+import { n as Media } from "../../tool_call-B2Ty8FuQ.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-IcqG7qmv.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 { m as toPipe, o as VERB_INDEX, s as foldVerb, t as availableVerbs } from "../../validate-DokBgtG-.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/media/forge.ts
 /**

package/batteries/media/index.d.ts

@@ -46,7 +46,7 @@ import type { EngineSelectionMiddlewareFn } from "./registry";
 import type { MediaEngine, EngineResolver } from "./contracts";
 import type { StepPayload, PlanResult, MediaStepMiddlewareFn } from "./runtime";
 export { MediaChain } from "./builder";
-export type { ChainInput, MediaChainRef, CellUpdate, ResizeOptions, SheetNamespace, SlidesNamespace, ImageNamespace, AudioNamespace, } from "./builder";
+export type { ChainExecutor, ChainInput, MediaChainRef, CellUpdate, ResizeOptions, SheetNamespace, SlidesNamespace, ImageNamespace, AudioNamespace, } from "./builder";
 export { toPipe, toOps, fromOps, isMediaRef, isRegExpRef } from "./plan";
 export type { MediaPlan, MediaStep, MediaOp, MediaArgValue, MediaArgScalar, MediaArgJson, MediaRef, RegExpRef, SourceSpan, } from "./plan";
 export { parsePipeRaw, lowerSegments } from "./pipe";
@@ -68,7 +68,7 @@ export type MediaRefResolver = (id: string) => StepPayload | Promise<StepPayload
 export interface RunOptions {
     /** Abort signal threaded into steps and engines. */
     signal?: AbortSignal;
-    /** Per-run media-ref resolution, overriding the construction-time resolver (the agent forge uses this to resolve @id refs against the current turn). */
+    /** Per-run media-ref resolution, overriding the construction-time resolver (the agent forge uses this to resolve `@id` refs against the current turn). */
     resolveRef?: MediaRefResolver;
 }
 /** Configuration for {@link createMediaPipeline}. */

package/batteries/media/lint.cjs

@@ -306,7 +306,7 @@ var rules = {
 var plugin = {
 	meta: {
 		name: "@nhtio/adk/batteries/media/lint",
-		version: "1.20260610.0"
+		version: "1.20260610.1"
 	},
 	rules
 };