@nhtio/adk 1.20260612.0 → 1.20260624.1

package/CHANGELOG.md

@@ -15,6 +15,75 @@ you *when* you got it, not *what changed*: a `^` range will float across battery
 breaking changes, so pin an exact version if you need stability and read the entry before
 upgrading.
 
+## 2026-06-24
+
+### Added
+
+- **Serialization: the ADK primitives now round-trip through [`@nhtio/encoder`](https://encoder.nht.io).**
+  Encode an entire conversation graph — `Message`s with nested `Identity`, `Tokenizable`, and `Media`;
+  `ToolCall`s with their results; `Memory`, `Thought`, `Retrievable`, `Registry` — to a string with
+  `encode()` and rebuild it (instances, not plain objects) with `decode()`. Every primitive implements
+  the encoder's custom-class contract via raw `Symbol.for()` keys, so **the contract adds zero
+  dependency to the core** — `@nhtio/encoder` is an optional peer, pulled in only by the new battery.
+- **New opt-in battery `@nhtio/adk/batteries/encoding`.** Call `registerAdkEncodables()` once at startup,
+  before your first `decode()` — it registers every primitive with the decoder and auto-registers the
+  binding-free reader resolvers (in-memory, fetch). This is the only code that imports `@nhtio/encoder`.
+- **Reader handles round-trip, not bytes.** `Media` and `SpooledArtifact` serialize the *handle* — a
+  tagged, re-openable locator — via a new optional `describe()` method on the `MediaReader` /
+  `SpoolReader` contracts. On decode, a tag→reader resolver registry (`registerMediaReaderResolver` /
+  `registerSpoolReaderResolver`) re-binds the handle to a live reader; for durable stores (flydrive,
+  OPFS) the consumer registers the resolver carrying the live `Disk`/root the locator cannot itself
+  carry. In-memory readers inline their buffer; the fetch reader captures its URL.
+- **New exceptions** `E_READER_NOT_DESCRIBABLE` (encoding a primitive whose reader has no `describe()` —
+  e.g. a `fromWebFile`-backed `Media`) and `E_NO_READER_RESOLVER` (decoding a handle whose tag has no
+  registered resolver), both exported from `@nhtio/adk/exceptions`.
+
+#### Not encodable, by design
+
+- **`TurnGate`** wraps a live pending Promise + `AbortController` — there is no serialized form of "a
+  thing some caller is awaiting", so it deliberately does not implement the contract.
+- **`Tool` handlers serialize by source text only.** A handler that closes over `ctx`, service clients,
+  or config loses those bindings on decode (the captured variables read back `undefined`); a `.bind()`-ed
+  or native handler cannot be serialized at all. `Tool.inputSchema` round-trips losslessly via
+  `@nhtio/validation`'s own `encode`/`decode`. Tools are rarely serialized; when they are, reconstruct
+  dependencies inside the handler body rather than closing over them.
+- **`fromWebFile`-backed `Media`** is not encodable — a browser `Blob` has no re-openable locator and the
+  synchronous encoder cannot drain it. Persist to a media/spool store and wrap in a describable reader
+  first.
+
+This release is **additive — no major bump** (per the `<major>.<YYYYMMDD>.<n>` scheme, the major moves
+only on core-contract breaks). The symbol methods are new surface; the new optional `describe()` on the
+reader contracts is backward-compatible (optional method, duck-typed schemas unchanged); no existing
+primitive constructor or field changed.
+
+### Fixed
+
+- **`Message` with empty `attachments` is no longer mis-rejected by its own serializer.** The
+  newly-added `Message` encode path emitted `attachments: []` for text-only messages, which the message
+  schema's "at least one of content/attachments, and a present `attachments` must be non-empty"
+  cross-field rule then rejected on `decode()`. The encode snapshot now omits `attachments` entirely when
+  empty. Only reachable via the new serialization path — no impact on existing construction.
+
+## 2026-06-23
+
+### Fixed
+
+- **`Tokenizable` now caches the tiktoken encoder instead of rebuilding it per call**
+  (reported against `1.20260612.0` from a Node/AdonisJS host embedding the ADK). `js-tiktoken`'s
+  `getEncoding` has no internal cache — every call does `new Tiktoken(<ranks>)`, parsing the full
+  BPE rank table (~800 ms for `o200k_base`), which is ~1000× the cost of the `encode()` that
+  follows. The tiktoken backend was the one estimator that never got the lazy-singleton treatment
+  the Gemini and Llama backends already had, so a fresh encoder was constructed on **every**
+  `estimateTokens` invocation that missed the per-value memo. On a tool-heavy turn — where a
+  battery re-measures an accumulating dispatch context once per iteration — this rebuilt the BPE
+  table O(results × iterations) times, saturating a single-threaded host's event loop (CPU pegged,
+  RSS oscillating multi-GB under GC of the repeatedly-allocated vocabulary, co-tenant HTTP
+  starved). The encoder is now memoized in a module-level `Map<TokenEncoding, Tiktoken>`, mirroring
+  the existing Gemini/Llama singletons; construction drops to once per encoding per process.
+  Behaviour-preserving (`Tiktoken` instances are stateless and reusable), benefits every
+  tokenization path ADK-wide, and is the single highest-leverage change against the reported
+  event-loop starvation.
+
 ## 2026-06-12
 
 ### Added

package/batteries/embeddings/openai/adapter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Cek0wNdY.js");
-const require_tool_registry = require("../../../tool_registry-bWKC6jt1.js");
+const require_tool_registry = require("../../../tool_registry-CIIfbY_w.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-QKQYr8Tp.mjs";
+import { c as isError } from "../../../tool_registry-FeMMz993.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-Cek0wNdY.js");
-const require_tool_registry = require("../../../tool_registry-bWKC6jt1.js");
+const require_tool_registry = require("../../../tool_registry-CIIfbY_w.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-QKQYr8Tp.mjs";
+import { c as isError } from "../../../tool_registry-FeMMz993.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/encoding/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Opt-in serialization battery: make the ADK primitives round-trip through `@nhtio/encoder`.
+ *
+ * @module @nhtio/adk/batteries/encoding
+ *
+ * @remarks
+ * The ADK primitives already carry the `@nhtio/encoder` custom-class contract — they implement the
+ * `Symbol.for('@nhtio/encoder:toEncoded' | ':fromEncoded')` methods with **zero dependency** on the
+ * encoder. That half works whether or not `@nhtio/encoder` is installed. This battery wires up the
+ * *other* half — the part that genuinely needs the encoder — and nothing else imports it:
+ *
+ * 1. `registerAdkEncodables()` — tells the decoder how to map each `custom:<ClassName>` wire tag back to
+ *    its constructor. Call it **once, before your first `decode()`**. Without it, `encode()` still works
+ *    but `decode()` throws on every ADK primitive.
+ * 2. Auto-registers the **in-memory** and **fetch** reader resolvers (they carry no live binding, so they
+ *    need nothing from you). Durable-store resolvers — flydrive `Disk`, OPFS root — you register yourself
+ *    with {@link registerSpoolReaderResolver} / {@link registerMediaReaderResolver}, because only you hold
+ *    the live binding the serialised locator cannot carry.
+ *
+ * ::: what this battery does NOT do
+ * It serialises the **conversation graph**, not your storage. It does not persist anything — it turns a
+ * live object tree into a string and back. It does not conjure live bindings: a reader handle decodes to
+ * a working reader only if you registered a resolver for its tag. It does not make closures portable: a
+ * {@link @nhtio/adk!Tool} handler serialises by source text only (see {@link @nhtio/adk!Tool}). And it
+ * cannot serialise a {@link @nhtio/adk!TurnGate} — a live pending Promise has no serialised form.
+ * :::
+ *
+ * @example Register once at startup, then encode/decode freely.
+ * ```typescript
+ * import { encode, decode } from '@nhtio/encoder'
+ * import { registerAdkEncodables } from '@nhtio/adk/batteries/encoding'
+ *
+ * registerAdkEncodables()
+ *
+ * const wire = encode(message)            // a Message with nested Identity / Tokenizable / Media
+ * const restored = decode<Message>(wire)  // instanceof Message, nested primitives intact
+ * ```
+ *
+ * @example Durable-store media/artifacts need a resolver carrying the live binding.
+ * ```typescript
+ * import { Disk } from 'flydrive'
+ * import { FlydriveSpoolReader } from '@nhtio/adk/batteries/storage/flydrive'
+ * import { registerAdkEncodables, registerSpoolReaderResolver } from '@nhtio/adk/batteries/encoding'
+ *
+ * registerAdkEncodables()
+ * const disk = new Disk(myDriver)
+ * registerSpoolReaderResolver('spool:flydrive', (locator) => {
+ *   const { key, streamThresholdBytes } = locator as { key: string; streamThresholdBytes?: number }
+ *   return new FlydriveSpoolReader(disk, key, { streamThresholdBytes })
+ * })
+ * ```
+ */
+/**
+ * Re-export the resolver-registration functions so consumers wire durable-store bindings from one place.
+ */
+export { registerMediaReaderResolver, registerSpoolReaderResolver, resolveMediaReader, resolveSpoolReader, } from "../../common";
+export type { ReaderDescriptor, LocatorValue, MediaReaderResolver, SpoolReaderResolver, } from "../../common";
+/**
+ * Register every ADK primitive with the `@nhtio/encoder` decoder, and auto-register the binding-free
+ * reader resolvers (in-memory, fetch).
+ *
+ * @remarks
+ * Idempotent — safe to call more than once (re-registering a class is a no-op overwrite). Call it once at
+ * application startup, before the first `decode()`. Encoding never needs this; only decoding does,
+ * because the decoder must map a `custom:<ClassName>` tag back to a constructor.
+ *
+ * Durable-store reader resolvers (flydrive, OPFS) are NOT registered here — they need the live `Disk` /
+ * OPFS root only you hold. Register them yourself with {@link registerSpoolReaderResolver}.
+ */
+export declare const registerAdkEncodables: () => void;

package/batteries/encoding.cjs

@@ -0,0 +1,135 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../chunk-Cek0wNdY.js");
+const require_tool_registry = require("../tool_registry-CIIfbY_w.js");
+const require_thought = require("../thought-CU7PYkB1.js");
+const require_tool = require("../tool-Bt6tmFXT.js");
+const require_spooled_artifact = require("../spooled_artifact-MbMz6NXX.js");
+const require_common = require("../common-CpcsEqPY.js");
+const require_tool_call = require("../tool_call-BixyvnWZ.js");
+const require_spooled_markdown_artifact = require("../spooled_markdown_artifact-Gj0ruiLJ.js");
+require("../index.cjs");
+const require_batteries_storage_in_memory = require("./storage/in_memory.cjs");
+let _nhtio_encoder = require("@nhtio/encoder");
+//#region src/batteries/encoding/index.ts
+/**
+* Opt-in serialization battery: make the ADK primitives round-trip through `@nhtio/encoder`.
+*
+* @module @nhtio/adk/batteries/encoding
+*
+* @remarks
+* The ADK primitives already carry the `@nhtio/encoder` custom-class contract — they implement the
+* `Symbol.for('@nhtio/encoder:toEncoded' | ':fromEncoded')` methods with **zero dependency** on the
+* encoder. That half works whether or not `@nhtio/encoder` is installed. This battery wires up the
+* *other* half — the part that genuinely needs the encoder — and nothing else imports it:
+*
+* 1. `registerAdkEncodables()` — tells the decoder how to map each `custom:<ClassName>` wire tag back to
+*    its constructor. Call it **once, before your first `decode()`**. Without it, `encode()` still works
+*    but `decode()` throws on every ADK primitive.
+* 2. Auto-registers the **in-memory** and **fetch** reader resolvers (they carry no live binding, so they
+*    need nothing from you). Durable-store resolvers — flydrive `Disk`, OPFS root — you register yourself
+*    with {@link registerSpoolReaderResolver} / {@link registerMediaReaderResolver}, because only you hold
+*    the live binding the serialised locator cannot carry.
+*
+* ::: what this battery does NOT do
+* It serialises the **conversation graph**, not your storage. It does not persist anything — it turns a
+* live object tree into a string and back. It does not conjure live bindings: a reader handle decodes to
+* a working reader only if you registered a resolver for its tag. It does not make closures portable: a
+* {@link @nhtio/adk!Tool} handler serialises by source text only (see {@link @nhtio/adk!Tool}). And it
+* cannot serialise a {@link @nhtio/adk!TurnGate} — a live pending Promise has no serialised form.
+* :::
+*
+* @example Register once at startup, then encode/decode freely.
+* ```typescript
+* import { encode, decode } from '@nhtio/encoder'
+* import { registerAdkEncodables } from '@nhtio/adk/batteries/encoding'
+*
+* registerAdkEncodables()
+*
+* const wire = encode(message)            // a Message with nested Identity / Tokenizable / Media
+* const restored = decode<Message>(wire)  // instanceof Message, nested primitives intact
+* ```
+*
+* @example Durable-store media/artifacts need a resolver carrying the live binding.
+* ```typescript
+* import { Disk } from 'flydrive'
+* import { FlydriveSpoolReader } from '@nhtio/adk/batteries/storage/flydrive'
+* import { registerAdkEncodables, registerSpoolReaderResolver } from '@nhtio/adk/batteries/encoding'
+*
+* registerAdkEncodables()
+* const disk = new Disk(myDriver)
+* registerSpoolReaderResolver('spool:flydrive', (locator) => {
+*   const { key, streamThresholdBytes } = locator as { key: string; streamThresholdBytes?: number }
+*   return new FlydriveSpoolReader(disk, key, { streamThresholdBytes })
+* })
+* ```
+*/
+/**
+* Every ADK primitive that opts in to the `@nhtio/encoder` custom-class contract.
+*
+* @remarks
+* `TurnGate` is intentionally absent — it wraps a live pending Promise and `AbortController` that cannot
+* survive serialisation. Each entry must expose a static `[DECODE_METHOD]`, which `registerClass`
+* requires.
+*/
+var ENCODABLE_CLASSES = [
+	require_tool_registry.Tokenizable,
+	require_tool_registry.Registry,
+	require_thought.Identity,
+	require_thought.Memory,
+	require_thought.Message,
+	require_common.Retrievable,
+	require_thought.Thought,
+	require_tool_call.ToolCall,
+	require_tool.Tool,
+	require_spooled_artifact.ArtifactTool,
+	require_tool_registry.ToolRegistry,
+	require_spooled_artifact.SpooledArtifact,
+	require_spooled_markdown_artifact.SpooledJsonArtifact,
+	require_spooled_markdown_artifact.SpooledMarkdownArtifact,
+	require_tool_call.Media
+];
+var autoResolversRegistered = false;
+/**
+* Auto-register the resolvers that need no live binding: in-memory (bytes inlined in the locator) and
+* fetch (URL re-issued on read). Idempotent.
+*/
+var registerBindingFreeResolvers = () => {
+	if (autoResolversRegistered) return;
+	autoResolversRegistered = true;
+	require_spooled_artifact.registerMediaReaderResolver(require_common.MEDIA_READER_TAG_IN_MEMORY, (locator) => {
+		const { bytesBase64 } = locator;
+		return require_common.inMemoryMediaReader(require_tool_call.decodeBase64(bytesBase64));
+	});
+	require_spooled_artifact.registerMediaReaderResolver(require_common.MEDIA_READER_TAG_FETCH, (locator) => {
+		const { url, init } = locator;
+		return require_common.fromFetch(url, init);
+	});
+	require_spooled_artifact.registerSpoolReaderResolver(require_batteries_storage_in_memory.SPOOL_READER_TAG_IN_MEMORY, (locator) => {
+		const { content } = locator;
+		return new require_batteries_storage_in_memory.InMemorySpoolReader(content);
+	});
+};
+/**
+* Register every ADK primitive with the `@nhtio/encoder` decoder, and auto-register the binding-free
+* reader resolvers (in-memory, fetch).
+*
+* @remarks
+* Idempotent — safe to call more than once (re-registering a class is a no-op overwrite). Call it once at
+* application startup, before the first `decode()`. Encoding never needs this; only decoding does,
+* because the decoder must map a `custom:<ClassName>` tag back to a constructor.
+*
+* Durable-store reader resolvers (flydrive, OPFS) are NOT registered here — they need the live `Disk` /
+* OPFS root only you hold. Register them yourself with {@link registerSpoolReaderResolver}.
+*/
+var registerAdkEncodables = () => {
+	for (const ctor of ENCODABLE_CLASSES) (0, _nhtio_encoder.registerClass)(ctor);
+	registerBindingFreeResolvers();
+};
+//#endregion
+exports.registerAdkEncodables = registerAdkEncodables;
+exports.registerMediaReaderResolver = require_spooled_artifact.registerMediaReaderResolver;
+exports.registerSpoolReaderResolver = require_spooled_artifact.registerSpoolReaderResolver;
+exports.resolveMediaReader = require_spooled_artifact.resolveMediaReader;
+exports.resolveSpoolReader = require_spooled_artifact.resolveSpoolReader;
+
+//# sourceMappingURL=encoding.cjs.map

package/batteries/encoding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.cjs","names":[],"sources":["../../src/batteries/encoding/index.ts"],"sourcesContent":["/**\n * Opt-in serialization battery: make the ADK primitives round-trip through `@nhtio/encoder`.\n *\n * @module @nhtio/adk/batteries/encoding\n *\n * @remarks\n * The ADK primitives already carry the `@nhtio/encoder` custom-class contract — they implement the\n * `Symbol.for('@nhtio/encoder:toEncoded' | ':fromEncoded')` methods with **zero dependency** on the\n * encoder. That half works whether or not `@nhtio/encoder` is installed. This battery wires up the\n * *other* half — the part that genuinely needs the encoder — and nothing else imports it:\n *\n * 1. `registerAdkEncodables()` — tells the decoder how to map each `custom:<ClassName>` wire tag back to\n *    its constructor. Call it **once, before your first `decode()`**. Without it, `encode()` still works\n *    but `decode()` throws on every ADK primitive.\n * 2. Auto-registers the **in-memory** and **fetch** reader resolvers (they carry no live binding, so they\n *    need nothing from you). Durable-store resolvers — flydrive `Disk`, OPFS root — you register yourself\n *    with {@link registerSpoolReaderResolver} / {@link registerMediaReaderResolver}, because only you hold\n *    the live binding the serialised locator cannot carry.\n *\n * ::: what this battery does NOT do\n * It serialises the **conversation graph**, not your storage. It does not persist anything — it turns a\n * live object tree into a string and back. It does not conjure live bindings: a reader handle decodes to\n * a working reader only if you registered a resolver for its tag. It does not make closures portable: a\n * {@link @nhtio/adk!Tool} handler serialises by source text only (see {@link @nhtio/adk!Tool}). And it\n * cannot serialise a {@link @nhtio/adk!TurnGate} — a live pending Promise has no serialised form.\n * :::\n *\n * @example Register once at startup, then encode/decode freely.\n * ```typescript\n * import { encode, decode } from '@nhtio/encoder'\n * import { registerAdkEncodables } from '@nhtio/adk/batteries/encoding'\n *\n * registerAdkEncodables()\n *\n * const wire = encode(message)            // a Message with nested Identity / Tokenizable / Media\n * const restored = decode<Message>(wire)  // instanceof Message, nested primitives intact\n * ```\n *\n * @example Durable-store media/artifacts need a resolver carrying the live binding.\n * ```typescript\n * import { Disk } from 'flydrive'\n * import { FlydriveSpoolReader } from '@nhtio/adk/batteries/storage/flydrive'\n * import { registerAdkEncodables, registerSpoolReaderResolver } from '@nhtio/adk/batteries/encoding'\n *\n * registerAdkEncodables()\n * const disk = new Disk(myDriver)\n * registerSpoolReaderResolver('spool:flydrive', (locator) => {\n *   const { key, streamThresholdBytes } = locator as { key: string; streamThresholdBytes?: number }\n *   return new FlydriveSpoolReader(disk, key, { streamThresholdBytes })\n * })\n * ```\n */\n\nimport { registerClass } from '@nhtio/encoder'\nimport {\n  InMemorySpoolReader,\n  SPOOL_READER_TAG_IN_MEMORY,\n} from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  registerMediaReaderResolver,\n  registerSpoolReaderResolver,\n  inMemoryMediaReader,\n  fromFetch,\n  decodeBase64,\n  MEDIA_READER_TAG_IN_MEMORY,\n  MEDIA_READER_TAG_FETCH,\n} from '@nhtio/adk/common'\nimport {\n  Tokenizable,\n  Registry,\n  Identity,\n  Memory,\n  Message,\n  Retrievable,\n  Thought,\n  ToolCall,\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  SpooledArtifact,\n  SpooledJsonArtifact,\n  SpooledMarkdownArtifact,\n  Media,\n} from '@nhtio/adk'\nimport type { LocatorValue } from '@nhtio/adk/common'\n\n/**\n * Re-export the resolver-registration functions so consumers wire durable-store bindings from one place.\n */\nexport {\n  registerMediaReaderResolver,\n  registerSpoolReaderResolver,\n  resolveMediaReader,\n  resolveSpoolReader,\n} from '@nhtio/adk/common'\nexport type {\n  ReaderDescriptor,\n  LocatorValue,\n  MediaReaderResolver,\n  SpoolReaderResolver,\n} from '@nhtio/adk/common'\n\n/**\n * Every ADK primitive that opts in to the `@nhtio/encoder` custom-class contract.\n *\n * @remarks\n * `TurnGate` is intentionally absent — it wraps a live pending Promise and `AbortController` that cannot\n * survive serialisation. Each entry must expose a static `[DECODE_METHOD]`, which `registerClass`\n * requires.\n */\nconst ENCODABLE_CLASSES = [\n  Tokenizable,\n  Registry,\n  Identity,\n  Memory,\n  Message,\n  Retrievable,\n  Thought,\n  ToolCall,\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  SpooledArtifact,\n  SpooledJsonArtifact,\n  SpooledMarkdownArtifact,\n  Media,\n] as const\n\nlet autoResolversRegistered = false\n\n/**\n * Auto-register the resolvers that need no live binding: in-memory (bytes inlined in the locator) and\n * fetch (URL re-issued on read). Idempotent.\n */\nconst registerBindingFreeResolvers = (): void => {\n  if (autoResolversRegistered) return\n  autoResolversRegistered = true\n\n  registerMediaReaderResolver(MEDIA_READER_TAG_IN_MEMORY, (locator: LocatorValue) => {\n    const { bytesBase64 } = locator as { bytesBase64: string }\n    return inMemoryMediaReader(decodeBase64(bytesBase64))\n  })\n\n  registerMediaReaderResolver(MEDIA_READER_TAG_FETCH, (locator: LocatorValue) => {\n    const { url, init } = locator as unknown as { url: string; init?: RequestInit }\n    return fromFetch(url, init)\n  })\n\n  registerSpoolReaderResolver(SPOOL_READER_TAG_IN_MEMORY, (locator: LocatorValue) => {\n    const { content } = locator as { content: string }\n    return new InMemorySpoolReader(content)\n  })\n}\n\n/**\n * Register every ADK primitive with the `@nhtio/encoder` decoder, and auto-register the binding-free\n * reader resolvers (in-memory, fetch).\n *\n * @remarks\n * Idempotent — safe to call more than once (re-registering a class is a no-op overwrite). Call it once at\n * application startup, before the first `decode()`. Encoding never needs this; only decoding does,\n * because the decoder must map a `custom:<ClassName>` tag back to a constructor.\n *\n * Durable-store reader resolvers (flydrive, OPFS) are NOT registered here — they need the live `Disk` /\n * OPFS root only you hold. Register them yourself with {@link registerSpoolReaderResolver}.\n */\nexport const registerAdkEncodables = (): void => {\n  for (const ctor of ENCODABLE_CLASSES) {\n    // The ADK primitives implement the contract via raw `Symbol.for()` keys (zero-dep \"Option B\"), so\n    // their static `[DECODE_METHOD]` is keyed by a symbol nominally distinct from the encoder's own\n    // `unique symbol` — identical at runtime (`Symbol.for('@nhtio/encoder:fromEncoded')`), but not\n    // structurally assignable to `DecodableConstructor` at the type level. The cast bridges that gap.\n    registerClass(ctor as unknown as Parameters<typeof registerClass>[0])\n  }\n  registerBindingFreeResolvers()\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8GA,IAAM,oBAAoB;CACxB,sBAAA;CACA,sBAAA;CACA,gBAAA;CACA,gBAAA;CACA,gBAAA;CACA,eAAA;CACA,gBAAA;CACA,kBAAA;CACA,aAAA;CACA,yBAAA;CACA,sBAAA;CACA,yBAAA;CACA,kCAAA;CACA,kCAAA;CACA,kBAAA;AACF;AAEA,IAAI,0BAA0B;;;;;AAM9B,IAAM,qCAA2C;CAC/C,IAAI,yBAAyB;CAC7B,0BAA0B;CAE1B,yBAAA,4BAA4B,eAAA,6BAA6B,YAA0B;EACjF,MAAM,EAAE,gBAAgB;EACxB,OAAO,eAAA,oBAAoB,kBAAA,aAAa,WAAW,CAAC;CACtD,CAAC;CAED,yBAAA,4BAA4B,eAAA,yBAAyB,YAA0B;EAC7E,MAAM,EAAE,KAAK,SAAS;EACtB,OAAO,eAAA,UAAU,KAAK,IAAI;CAC5B,CAAC;CAED,yBAAA,4BAA4B,oCAAA,6BAA6B,YAA0B;EACjF,MAAM,EAAE,YAAY;EACpB,OAAO,IAAI,oCAAA,oBAAoB,OAAO;CACxC,CAAC;AACH;;;;;;;;;;;;;AAcA,IAAa,8BAAoC;CAC/C,KAAK,MAAM,QAAQ,mBAKjB,CAAA,GAAA,eAAA,eAAc,IAAsD;CAEtE,6BAA6B;AAC/B"}

package/batteries/encoding.mjs

@@ -0,0 +1,129 @@
+import { a as Tokenizable, r as Registry, t as ToolRegistry } from "../tool_registry-FeMMz993.mjs";
+import { i as Identity, n as Message, r as Memory, t as Thought } from "../thought-DmcfCRAw.mjs";
+import { t as Tool } from "../tool-C_uxdxjp.mjs";
+import { a as resolveMediaReader, c as ArtifactTool, i as registerSpoolReaderResolver, o as resolveSpoolReader, r as registerMediaReaderResolver, t as SpooledArtifact } from "../spooled_artifact-fgc1lutm.mjs";
+import { a as inMemoryMediaReader, c as Retrievable, n as MEDIA_READER_TAG_IN_MEMORY, r as fromFetch, t as MEDIA_READER_TAG_FETCH } from "../common-0CmrSKNb.mjs";
+import { n as Media, o as decodeBase64, t as ToolCall } from "../tool_call-pfvAsgkY.mjs";
+import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "../spooled_markdown_artifact-3sK6HFRw.mjs";
+import "../index.mjs";
+import { InMemorySpoolReader, SPOOL_READER_TAG_IN_MEMORY } from "./storage/in_memory.mjs";
+import { registerClass } from "@nhtio/encoder";
+//#region src/batteries/encoding/index.ts
+/**
+* Opt-in serialization battery: make the ADK primitives round-trip through `@nhtio/encoder`.
+*
+* @module @nhtio/adk/batteries/encoding
+*
+* @remarks
+* The ADK primitives already carry the `@nhtio/encoder` custom-class contract — they implement the
+* `Symbol.for('@nhtio/encoder:toEncoded' | ':fromEncoded')` methods with **zero dependency** on the
+* encoder. That half works whether or not `@nhtio/encoder` is installed. This battery wires up the
+* *other* half — the part that genuinely needs the encoder — and nothing else imports it:
+*
+* 1. `registerAdkEncodables()` — tells the decoder how to map each `custom:<ClassName>` wire tag back to
+*    its constructor. Call it **once, before your first `decode()`**. Without it, `encode()` still works
+*    but `decode()` throws on every ADK primitive.
+* 2. Auto-registers the **in-memory** and **fetch** reader resolvers (they carry no live binding, so they
+*    need nothing from you). Durable-store resolvers — flydrive `Disk`, OPFS root — you register yourself
+*    with {@link registerSpoolReaderResolver} / {@link registerMediaReaderResolver}, because only you hold
+*    the live binding the serialised locator cannot carry.
+*
+* ::: what this battery does NOT do
+* It serialises the **conversation graph**, not your storage. It does not persist anything — it turns a
+* live object tree into a string and back. It does not conjure live bindings: a reader handle decodes to
+* a working reader only if you registered a resolver for its tag. It does not make closures portable: a
+* {@link @nhtio/adk!Tool} handler serialises by source text only (see {@link @nhtio/adk!Tool}). And it
+* cannot serialise a {@link @nhtio/adk!TurnGate} — a live pending Promise has no serialised form.
+* :::
+*
+* @example Register once at startup, then encode/decode freely.
+* ```typescript
+* import { encode, decode } from '@nhtio/encoder'
+* import { registerAdkEncodables } from '@nhtio/adk/batteries/encoding'
+*
+* registerAdkEncodables()
+*
+* const wire = encode(message)            // a Message with nested Identity / Tokenizable / Media
+* const restored = decode<Message>(wire)  // instanceof Message, nested primitives intact
+* ```
+*
+* @example Durable-store media/artifacts need a resolver carrying the live binding.
+* ```typescript
+* import { Disk } from 'flydrive'
+* import { FlydriveSpoolReader } from '@nhtio/adk/batteries/storage/flydrive'
+* import { registerAdkEncodables, registerSpoolReaderResolver } from '@nhtio/adk/batteries/encoding'
+*
+* registerAdkEncodables()
+* const disk = new Disk(myDriver)
+* registerSpoolReaderResolver('spool:flydrive', (locator) => {
+*   const { key, streamThresholdBytes } = locator as { key: string; streamThresholdBytes?: number }
+*   return new FlydriveSpoolReader(disk, key, { streamThresholdBytes })
+* })
+* ```
+*/
+/**
+* Every ADK primitive that opts in to the `@nhtio/encoder` custom-class contract.
+*
+* @remarks
+* `TurnGate` is intentionally absent — it wraps a live pending Promise and `AbortController` that cannot
+* survive serialisation. Each entry must expose a static `[DECODE_METHOD]`, which `registerClass`
+* requires.
+*/
+var ENCODABLE_CLASSES = [
+	Tokenizable,
+	Registry,
+	Identity,
+	Memory,
+	Message,
+	Retrievable,
+	Thought,
+	ToolCall,
+	Tool,
+	ArtifactTool,
+	ToolRegistry,
+	SpooledArtifact,
+	SpooledJsonArtifact,
+	SpooledMarkdownArtifact,
+	Media
+];
+var autoResolversRegistered = false;
+/**
+* Auto-register the resolvers that need no live binding: in-memory (bytes inlined in the locator) and
+* fetch (URL re-issued on read). Idempotent.
+*/
+var registerBindingFreeResolvers = () => {
+	if (autoResolversRegistered) return;
+	autoResolversRegistered = true;
+	registerMediaReaderResolver(MEDIA_READER_TAG_IN_MEMORY, (locator) => {
+		const { bytesBase64 } = locator;
+		return inMemoryMediaReader(decodeBase64(bytesBase64));
+	});
+	registerMediaReaderResolver(MEDIA_READER_TAG_FETCH, (locator) => {
+		const { url, init } = locator;
+		return fromFetch(url, init);
+	});
+	registerSpoolReaderResolver(SPOOL_READER_TAG_IN_MEMORY, (locator) => {
+		const { content } = locator;
+		return new InMemorySpoolReader(content);
+	});
+};
+/**
+* Register every ADK primitive with the `@nhtio/encoder` decoder, and auto-register the binding-free
+* reader resolvers (in-memory, fetch).
+*
+* @remarks
+* Idempotent — safe to call more than once (re-registering a class is a no-op overwrite). Call it once at
+* application startup, before the first `decode()`. Encoding never needs this; only decoding does,
+* because the decoder must map a `custom:<ClassName>` tag back to a constructor.
+*
+* Durable-store reader resolvers (flydrive, OPFS) are NOT registered here — they need the live `Disk` /
+* OPFS root only you hold. Register them yourself with {@link registerSpoolReaderResolver}.
+*/
+var registerAdkEncodables = () => {
+	for (const ctor of ENCODABLE_CLASSES) registerClass(ctor);
+	registerBindingFreeResolvers();
+};
+//#endregion
+export { registerAdkEncodables, registerMediaReaderResolver, registerSpoolReaderResolver, resolveMediaReader, resolveSpoolReader };
+
+//# sourceMappingURL=encoding.mjs.map

package/batteries/encoding.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.mjs","names":[],"sources":["../../src/batteries/encoding/index.ts"],"sourcesContent":["/**\n * Opt-in serialization battery: make the ADK primitives round-trip through `@nhtio/encoder`.\n *\n * @module @nhtio/adk/batteries/encoding\n *\n * @remarks\n * The ADK primitives already carry the `@nhtio/encoder` custom-class contract — they implement the\n * `Symbol.for('@nhtio/encoder:toEncoded' | ':fromEncoded')` methods with **zero dependency** on the\n * encoder. That half works whether or not `@nhtio/encoder` is installed. This battery wires up the\n * *other* half — the part that genuinely needs the encoder — and nothing else imports it:\n *\n * 1. `registerAdkEncodables()` — tells the decoder how to map each `custom:<ClassName>` wire tag back to\n *    its constructor. Call it **once, before your first `decode()`**. Without it, `encode()` still works\n *    but `decode()` throws on every ADK primitive.\n * 2. Auto-registers the **in-memory** and **fetch** reader resolvers (they carry no live binding, so they\n *    need nothing from you). Durable-store resolvers — flydrive `Disk`, OPFS root — you register yourself\n *    with {@link registerSpoolReaderResolver} / {@link registerMediaReaderResolver}, because only you hold\n *    the live binding the serialised locator cannot carry.\n *\n * ::: what this battery does NOT do\n * It serialises the **conversation graph**, not your storage. It does not persist anything — it turns a\n * live object tree into a string and back. It does not conjure live bindings: a reader handle decodes to\n * a working reader only if you registered a resolver for its tag. It does not make closures portable: a\n * {@link @nhtio/adk!Tool} handler serialises by source text only (see {@link @nhtio/adk!Tool}). And it\n * cannot serialise a {@link @nhtio/adk!TurnGate} — a live pending Promise has no serialised form.\n * :::\n *\n * @example Register once at startup, then encode/decode freely.\n * ```typescript\n * import { encode, decode } from '@nhtio/encoder'\n * import { registerAdkEncodables } from '@nhtio/adk/batteries/encoding'\n *\n * registerAdkEncodables()\n *\n * const wire = encode(message)            // a Message with nested Identity / Tokenizable / Media\n * const restored = decode<Message>(wire)  // instanceof Message, nested primitives intact\n * ```\n *\n * @example Durable-store media/artifacts need a resolver carrying the live binding.\n * ```typescript\n * import { Disk } from 'flydrive'\n * import { FlydriveSpoolReader } from '@nhtio/adk/batteries/storage/flydrive'\n * import { registerAdkEncodables, registerSpoolReaderResolver } from '@nhtio/adk/batteries/encoding'\n *\n * registerAdkEncodables()\n * const disk = new Disk(myDriver)\n * registerSpoolReaderResolver('spool:flydrive', (locator) => {\n *   const { key, streamThresholdBytes } = locator as { key: string; streamThresholdBytes?: number }\n *   return new FlydriveSpoolReader(disk, key, { streamThresholdBytes })\n * })\n * ```\n */\n\nimport { registerClass } from '@nhtio/encoder'\nimport {\n  InMemorySpoolReader,\n  SPOOL_READER_TAG_IN_MEMORY,\n} from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  registerMediaReaderResolver,\n  registerSpoolReaderResolver,\n  inMemoryMediaReader,\n  fromFetch,\n  decodeBase64,\n  MEDIA_READER_TAG_IN_MEMORY,\n  MEDIA_READER_TAG_FETCH,\n} from '@nhtio/adk/common'\nimport {\n  Tokenizable,\n  Registry,\n  Identity,\n  Memory,\n  Message,\n  Retrievable,\n  Thought,\n  ToolCall,\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  SpooledArtifact,\n  SpooledJsonArtifact,\n  SpooledMarkdownArtifact,\n  Media,\n} from '@nhtio/adk'\nimport type { LocatorValue } from '@nhtio/adk/common'\n\n/**\n * Re-export the resolver-registration functions so consumers wire durable-store bindings from one place.\n */\nexport {\n  registerMediaReaderResolver,\n  registerSpoolReaderResolver,\n  resolveMediaReader,\n  resolveSpoolReader,\n} from '@nhtio/adk/common'\nexport type {\n  ReaderDescriptor,\n  LocatorValue,\n  MediaReaderResolver,\n  SpoolReaderResolver,\n} from '@nhtio/adk/common'\n\n/**\n * Every ADK primitive that opts in to the `@nhtio/encoder` custom-class contract.\n *\n * @remarks\n * `TurnGate` is intentionally absent — it wraps a live pending Promise and `AbortController` that cannot\n * survive serialisation. Each entry must expose a static `[DECODE_METHOD]`, which `registerClass`\n * requires.\n */\nconst ENCODABLE_CLASSES = [\n  Tokenizable,\n  Registry,\n  Identity,\n  Memory,\n  Message,\n  Retrievable,\n  Thought,\n  ToolCall,\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  SpooledArtifact,\n  SpooledJsonArtifact,\n  SpooledMarkdownArtifact,\n  Media,\n] as const\n\nlet autoResolversRegistered = false\n\n/**\n * Auto-register the resolvers that need no live binding: in-memory (bytes inlined in the locator) and\n * fetch (URL re-issued on read). Idempotent.\n */\nconst registerBindingFreeResolvers = (): void => {\n  if (autoResolversRegistered) return\n  autoResolversRegistered = true\n\n  registerMediaReaderResolver(MEDIA_READER_TAG_IN_MEMORY, (locator: LocatorValue) => {\n    const { bytesBase64 } = locator as { bytesBase64: string }\n    return inMemoryMediaReader(decodeBase64(bytesBase64))\n  })\n\n  registerMediaReaderResolver(MEDIA_READER_TAG_FETCH, (locator: LocatorValue) => {\n    const { url, init } = locator as unknown as { url: string; init?: RequestInit }\n    return fromFetch(url, init)\n  })\n\n  registerSpoolReaderResolver(SPOOL_READER_TAG_IN_MEMORY, (locator: LocatorValue) => {\n    const { content } = locator as { content: string }\n    return new InMemorySpoolReader(content)\n  })\n}\n\n/**\n * Register every ADK primitive with the `@nhtio/encoder` decoder, and auto-register the binding-free\n * reader resolvers (in-memory, fetch).\n *\n * @remarks\n * Idempotent — safe to call more than once (re-registering a class is a no-op overwrite). Call it once at\n * application startup, before the first `decode()`. Encoding never needs this; only decoding does,\n * because the decoder must map a `custom:<ClassName>` tag back to a constructor.\n *\n * Durable-store reader resolvers (flydrive, OPFS) are NOT registered here — they need the live `Disk` /\n * OPFS root only you hold. Register them yourself with {@link registerSpoolReaderResolver}.\n */\nexport const registerAdkEncodables = (): void => {\n  for (const ctor of ENCODABLE_CLASSES) {\n    // The ADK primitives implement the contract via raw `Symbol.for()` keys (zero-dep \"Option B\"), so\n    // their static `[DECODE_METHOD]` is keyed by a symbol nominally distinct from the encoder's own\n    // `unique symbol` — identical at runtime (`Symbol.for('@nhtio/encoder:fromEncoded')`), but not\n    // structurally assignable to `DecodableConstructor` at the type level. The cast bridges that gap.\n    registerClass(ctor as unknown as Parameters<typeof registerClass>[0])\n  }\n  registerBindingFreeResolvers()\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8GA,IAAM,oBAAoB;CACxB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,IAAI,0BAA0B;;;;;AAM9B,IAAM,qCAA2C;CAC/C,IAAI,yBAAyB;CAC7B,0BAA0B;CAE1B,4BAA4B,6BAA6B,YAA0B;EACjF,MAAM,EAAE,gBAAgB;EACxB,OAAO,oBAAoB,aAAa,WAAW,CAAC;CACtD,CAAC;CAED,4BAA4B,yBAAyB,YAA0B;EAC7E,MAAM,EAAE,KAAK,SAAS;EACtB,OAAO,UAAU,KAAK,IAAI;CAC5B,CAAC;CAED,4BAA4B,6BAA6B,YAA0B;EACjF,MAAM,EAAE,YAAY;EACpB,OAAO,IAAI,oBAAoB,OAAO;CACxC,CAAC;AACH;;;;;;;;;;;;;AAcA,IAAa,8BAAoC;CAC/C,KAAK,MAAM,QAAQ,mBAKjB,cAAc,IAAsD;CAEtE,6BAA6B;AAC/B"}

package/batteries/llm/ollama/adapter.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Cek0wNdY.js");
-const require_tool_registry = require("../../../tool_registry-bWKC6jt1.js");
-const require_thought = require("../../../thought-c4d-q-3R.js");
-const require_spooled_artifact = require("../../../spooled_artifact-xA7Te-kE.js");
-require("../../../common-6WOPAB3-.js");
-const require_tool_call = require("../../../tool_call-Bua8qpko.js");
+const require_tool_registry = require("../../../tool_registry-CIIfbY_w.js");
+const require_thought = require("../../../thought-CU7PYkB1.js");
+const require_spooled_artifact = require("../../../spooled_artifact-MbMz6NXX.js");
+require("../../../common-CpcsEqPY.js");
+const require_tool_call = require("../../../tool_call-BixyvnWZ.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-QKQYr8Tp.mjs";
-import { n as Message, t as Thought } from "../../../thought-DXnh31HJ.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-CmL5ci5Z.mjs";
-import "../../../common-_77pbLLS.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-D69JEDXJ.mjs";
+import { a as Tokenizable, c as isError, l as isInstanceOf, n as canonicalStringify, t as ToolRegistry, u as isObject } from "../../../tool_registry-FeMMz993.mjs";
+import { n as Message, t as Thought } from "../../../thought-DmcfCRAw.mjs";
+import { c as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-fgc1lutm.mjs";
+import "../../../common-0CmrSKNb.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-pfvAsgkY.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-Cek0wNdY.js");
-require("../../../common-6WOPAB3-.js");
-const require_tool_call = require("../../../tool_call-Bua8qpko.js");
+require("../../../common-CpcsEqPY.js");
+const require_tool_call = require("../../../tool_call-BixyvnWZ.js");
 require("../../../guards.cjs");
 const require_helpers = require("../../../helpers-1okZzNCa.js");
 const require_batteries_llm_ollama_exceptions = require("./exceptions.cjs");

package/batteries/llm/ollama/helpers.mjs

@@ -1,5 +1,5 @@
-import "../../../common-_77pbLLS.mjs";
-import { n as Media } from "../../../tool_call-D69JEDXJ.mjs";
+import "../../../common-0CmrSKNb.mjs";
+import { n as Media } from "../../../tool_call-pfvAsgkY.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-BCyDAn_R.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-Cek0wNdY.js");
-const require_common = require("../../../common-6WOPAB3-.js");
+const require_common = require("../../../common-CpcsEqPY.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-_77pbLLS.mjs";
+import { o as byteStoreSchema } from "../../../common-0CmrSKNb.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-Cek0wNdY.js");
-const require_tool_registry = require("../../../tool_registry-bWKC6jt1.js");
-const require_thought = require("../../../thought-c4d-q-3R.js");
-const require_spooled_artifact = require("../../../spooled_artifact-xA7Te-kE.js");
-require("../../../common-6WOPAB3-.js");
-const require_tool_call = require("../../../tool_call-Bua8qpko.js");
+const require_tool_registry = require("../../../tool_registry-CIIfbY_w.js");
+const require_thought = require("../../../thought-CU7PYkB1.js");
+const require_spooled_artifact = require("../../../spooled_artifact-MbMz6NXX.js");
+require("../../../common-CpcsEqPY.js");
+const require_tool_call = require("../../../tool_call-BixyvnWZ.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-QKQYr8Tp.mjs";
-import { n as Message, t as Thought } from "../../../thought-DXnh31HJ.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-CmL5ci5Z.mjs";
-import "../../../common-_77pbLLS.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-D69JEDXJ.mjs";
+import { a as Tokenizable, c as isError, l as isInstanceOf, n as canonicalStringify, t as ToolRegistry, u as isObject } from "../../../tool_registry-FeMMz993.mjs";
+import { n as Message, t as Thought } from "../../../thought-DmcfCRAw.mjs";
+import { c as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-fgc1lutm.mjs";
+import "../../../common-0CmrSKNb.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-pfvAsgkY.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-Cek0wNdY.js");
-require("../../../common-6WOPAB3-.js");
-const require_tool_call = require("../../../tool_call-Bua8qpko.js");
+require("../../../common-CpcsEqPY.js");
+const require_tool_call = require("../../../tool_call-BixyvnWZ.js");
 require("../../../guards.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");
 const require_helpers = require("../../../helpers-1okZzNCa.js");

package/batteries/llm/openai_chat_completions/helpers.mjs

@@ -1,5 +1,5 @@
-import "../../../common-_77pbLLS.mjs";
-import { n as Media } from "../../../tool_call-D69JEDXJ.mjs";
+import "../../../common-0CmrSKNb.mjs";
+import { n as Media } from "../../../tool_call-pfvAsgkY.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-BCyDAn_R.mjs";

package/batteries/llm/openai_chat_completions/validation.cjs

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