@nhtio/adk 0.1.0-master-d3feb810 → 0.1.0-master-445a9ed0

package/{common-Od8edUXU.js → common-BJ6V6dsH.js}

@@ -1,12 +1,11 @@
-require("./chunk-KmRHZBOW.js");
-const require_exceptions = require("./exceptions-D5YrO9Vm.js");
-const require_tool_registry = require("./tool_registry-Dkfprsck.js");
-const require_runtime = require("./runtime-BJVkrGQe.js");
-require("./thought-DuN2PgdO.js");
-require("./tool_call-DFgzcVcU.js");
-require("./tool-COSeH8I6.js");
-require("./spooled_artifact-Cm9Te22K.js");
-require("./spooled_markdown_artifact-RRB113sy.js");
+const require_tool_registry = require("./tool_registry-snPjF0zJ.js");
+const require_exceptions = require("./exceptions-CSqzbL1N.js");
+const require_runtime = require("./runtime-BUDWyd-R.js");
+require("./thought-DTsFRGdE.js");
+require("./tool-cwJyEHI9.js");
+const require_spooled_artifact = require("./spooled_artifact-CFstzlqX.js");
+require("./tool_call-3T0xTXlD.js");
+require("./spooled_markdown_artifact-DK-T8Hy6.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/lib/classes/retrievable.ts
 /**
@@ -25,9 +24,13 @@ let _nhtio_validation = require("@nhtio/validation");
 * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)
 * when validation fails.
 */
+var contentSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), _nhtio_validation.validator.custom((value, helpers) => {
+	if (require_tool_registry.Tokenizable.isTokenizable(value) || require_spooled_artifact.SpooledArtifact.isSpooledArtifact(value)) return value;
+	return helpers.error("any.invalid");
+}));
 var rawRetrievableSchema = _nhtio_validation.validator.object({
 	id: _nhtio_validation.validator.string().required(),
-	content: require_tool_registry.Tokenizable.schema.required(),
+	content: contentSchema.required(),
 	trustTier: _nhtio_validation.validator.string().valid("first-party", "third-party-public", "third-party-private").required(),
 	source: _nhtio_validation.validator.string().optional(),
 	kind: _nhtio_validation.validator.string().optional(),
@@ -81,7 +84,7 @@ var Retrievable = class Retrievable {
 			throw new require_runtime.E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: require_tool_registry.isError(err) ? err : void 0 });
 		}
 		this.#id = resolved.id;
-		this.#content = require_tool_registry.Tokenizable.isTokenizable(resolved.content) ? resolved.content : new require_tool_registry.Tokenizable(resolved.content);
+		this.#content = require_tool_registry.Tokenizable.isTokenizable(resolved.content) || require_spooled_artifact.SpooledArtifact.isSpooledArtifact(resolved.content) ? resolved.content : new require_tool_registry.Tokenizable(resolved.content);
 		this.#trustTier = resolved.trustTier;
 		this.#source = resolved.source;
 		this.#kind = resolved.kind;
@@ -131,6 +134,68 @@ var Retrievable = class Retrievable {
 			}
 		});
 	}
+	/**
+	* Estimates the token count of the content under `encoding`.
+	*
+	* @remarks
+	* Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}
+	* (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns
+	* `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the
+	* adapter's token-budget path, which already awaits estimates.
+	*
+	* Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count
+	* tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the
+	* transient allocation at budgeting time.
+	*
+	* @param encoding - The encoding identifier to use for counting.
+	* @returns The estimated token count.
+	*/
+	estimateTokens(encoding) {
+		return this.#content.estimateTokens(encoding);
+	}
+	/**
+	* Returns the content body as a single string.
+	*
+	* @remarks
+	* For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a
+	* {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via
+	* {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one
+	* code path; render helpers `await` it at the point the trust-tier envelope is built.
+	*
+	* @returns The full content body as a string.
+	*/
+	async contentString() {
+		return require_spooled_artifact.SpooledArtifact.isSpooledArtifact(this.#content) ? this.#content.asString() : this.#content.toString();
+	}
+};
+//#endregion
+//#region src/lib/contracts/byte_store.ts
+/**
+* Validator schema used to validate a {@link ByteStore} value.
+*
+* @remarks
+* Because `ByteStore` is a structural interface with no associated constructor, validation is
+* duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable
+* properties. Arity is not enforced — implementations may add optional parameters beyond the
+* contract. The reader type `R` cannot be checked structurally here; conformance of the reader is
+* the caller's concern at the point of use.
+*/
+var byteStoreSchema = _nhtio_validation.validator.any().custom((value, helpers) => {
+	if (value !== null && value !== void 0 && typeof value.write === "function" && typeof value.read === "function" && typeof value.delete === "function") return value;
+	return helpers.error("any.invalid");
+});
+/**
+* Returns `true` if `value` implements the {@link ByteStore} interface.
+*
+* @remarks
+* Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable
+* functions. Does not use `instanceof` — there is no `ByteStore` constructor.
+*
+* @param value - The value to test.
+* @returns `true` when `value` conforms to the {@link ByteStore} interface.
+*/
+var implementsByteStore = (value) => {
+	return require_exceptions.passesSchema(byteStoreSchema, value);
 };
 //#endregion
 //#region src/lib/helpers/media_readers.ts
@@ -210,6 +275,12 @@ Object.defineProperty(exports, "Retrievable", {
 		return Retrievable;
 	}
 });
+Object.defineProperty(exports, "byteStoreSchema", {
+	enumerable: true,
+	get: function() {
+		return byteStoreSchema;
+	}
+});
 Object.defineProperty(exports, "fromFetch", {
 	enumerable: true,
 	get: function() {
@@ -222,6 +293,12 @@ Object.defineProperty(exports, "fromWebFile", {
 		return fromWebFile;
 	}
 });
+Object.defineProperty(exports, "implementsByteStore", {
+	enumerable: true,
+	get: function() {
+		return implementsByteStore;
+	}
+});
 Object.defineProperty(exports, "inMemoryMediaReader", {
 	enumerable: true,
 	get: function() {
@@ -229,4 +306,4 @@ Object.defineProperty(exports, "inMemoryMediaReader", {
 	}
 });
 
-//# sourceMappingURL=common-Od8edUXU.js.map
+//# sourceMappingURL=common-BJ6V6dsH.js.map

package/common-BJ6V6dsH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-BJ6V6dsH.js","names":["#id","#content","#trustTier","#source","#kind","#score","#createdAt","#updatedAt"],"sources":["../src/lib/classes/retrievable.ts","../src/lib/contracts/byte_store.ts","../src/lib/helpers/media_readers.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { SpooledArtifact } from './spooled_artifact'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_RETRIEVABLE_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { TokenEncoding } from './tokenizable'\n\n/**\n * Trust-tier discriminator declared by the retrieval middleware at construction time. Drives\n * which envelope the LLM battery wraps the record in.\n *\n * @remarks\n * Vocabulary deliberately mirrors the published security-research taxonomy (\"first-party /\n * third-party\" per *Hidden-in-Plain-Text* WWW '26 and *When AI Meets the Web* IEEE S&P 2026)\n * and explicitly avoids the words \"user\" or \"system\" so the names cannot leak into the model's\n * OpenAI-Model-Spec role-tier authority resolution.\n *\n * - `'first-party'` — deployer-vetted corpora (signed internal docs, policy KBs, curated\n *   reference material). Rendered as a `<retrieved_corpus>` parent with per-record nonce-keyed\n *   `<retrieved>` children. The label \"first-party\" never appears in the envelope itself.\n * - `'third-party-public'` — open-web scrapes, search results, public APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-public'`.\n * - `'third-party-private'` — user uploads, pasted attachments, partner APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-private'`.\n */\nexport type RetrievableTrustTier = 'first-party' | 'third-party-public' | 'third-party-private'\n\n/**\n * Plain input object supplied to {@link Retrievable} at construction time.\n *\n * @remarks\n * Validated against `rawRetrievableSchema` before the `Retrievable` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawRetrievable {\n  /**\n   * Stable unique identifier for this retrieved record. Used as the closing-tag nonce in the\n   * rendered envelope, so it must be unguessable from the payload.\n   */\n  id: string\n  /**\n   * The retrieved content. A plain `string` or {@link @nhtio/adk!Tokenizable} for small inline text, or a\n   * {@link @nhtio/adk!SpooledArtifact} when the extracted text is large and lives in a consumer\n   * {@link @nhtio/adk!ByteStore} (persist it via {@link @nhtio/adk!DispatchContext.storeRetrievableBytes}, wrap\n   * the returned reader in a `SpooledArtifact`, and pass it here). Reader-backed content keeps the\n   * body out of the permanent heap, but token estimation and render still materialise it\n   * transiently (see {@link Retrievable.estimateTokens}).\n   */\n  content: string | Tokenizable | SpooledArtifact\n  /**\n   * Trust tier declared by the retrieval middleware at construction time. Required — there is\n   * NO default. The decision must be conscious. See {@link RetrievableTrustTier}.\n   */\n  trustTier: RetrievableTrustTier\n  /** Optional provenance string: URL, document path, knowledge-base id, etc. */\n  source?: string\n  /** Optional semantic label: 'policy' | 'reference' | 'web-page' | 'pdf' | etc. */\n  kind?: string\n  /** Optional relevance / similarity score in `[0, 1]` from the retrieval middleware. */\n  score?: number\n  /** When the source record was created (publication date, upload date, etc.). */\n  createdAt: string | number | Date | DateTime\n  /** When the source record was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawRetrievable} where all fields have been validated and temporal\n * values normalised to Luxon `DateTime` instances.\n */\ninterface ResolvedRetrievable {\n  id: string\n  content: Tokenizable | SpooledArtifact\n  trustTier: RetrievableTrustTier\n  source?: string\n  kind?: string\n  score?: number\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawRetrievable} before constructing a\n * {@link Retrievable}.\n *\n * @remarks\n * - `id` — required non-empty string.\n * - `content` — required {@link @nhtio/adk!Tokenizable.schema}.\n * - `trustTier` — required, one of `'first-party'`, `'third-party-public'`,\n *   `'third-party-private'`. Unknown / missing values reject.\n * - `source` / `kind` — optional strings.\n * - `score` — optional number in `[0, 1]`.\n * - `createdAt` / `updatedAt` — required datetime-parseable values.\n *\n * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)\n * when validation fails.\n */\nconst contentSchema = validator.alternatives(\n  validator.string(),\n  validator.custom((value, helpers) => {\n    if (Tokenizable.isTokenizable(value) || SpooledArtifact.isSpooledArtifact(value)) {\n      return value\n    }\n    return helpers.error('any.invalid')\n  })\n)\n\nconst rawRetrievableSchema = validator.object<RawRetrievable>({\n  id: validator.string().required(),\n  content: contentSchema.required(),\n  trustTier: validator\n    .string()\n    .valid('first-party', 'third-party-public', 'third-party-private')\n    .required(),\n  source: validator.string().optional(),\n  kind: validator.string().optional(),\n  score: validator.number().min(0).max(1).optional(),\n  createdAt: validator.datetime().required(),\n  updatedAt: validator.datetime().required(),\n})\n\n/**\n * An immutable, validated retrieved record (RAG content) held by the agent.\n *\n * @remarks\n * Peer of {@link @nhtio/adk!Memory} / `Message` / `Thought` / `ToolCall`. Carries an explicit `trustTier`\n * that LLM batteries branch on to choose the rendering envelope. The retrieval middleware that\n * produced the record is the only party that knows its provenance — batteries MUST NOT\n * auto-classify or infer the tier from `source`.\n */\nexport class Retrievable {\n  /**\n   * Validator schema that accepts a {@link RawRetrievable} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a retrievable record.\n   */\n  public static schema = rawRetrievableSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Retrievable} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   */\n  public static isRetrievable(value: unknown): value is Retrievable {\n    return isInstanceOf(value, 'Retrievable', Retrievable)\n  }\n\n  /** Stable unique identifier for this retrieved record. */\n  declare readonly id: string\n  /**\n   * The retrieved content: a {@link @nhtio/adk!Tokenizable} (inline text) or a\n   * {@link @nhtio/adk!SpooledArtifact} (reader-backed, large text living in a consumer store). Use\n   * {@link Retrievable.estimateTokens} for budgeting and {@link Retrievable.contentString} to\n   * materialise the body at render time.\n   */\n  declare readonly content: Tokenizable | SpooledArtifact\n  /** Trust tier declared by the retrieval middleware. */\n  declare readonly trustTier: RetrievableTrustTier\n  /** Optional provenance string. */\n  declare readonly source: string | undefined\n  /** Optional semantic label. */\n  declare readonly kind: string | undefined\n  /** Optional relevance / similarity score in `[0, 1]`. */\n  declare readonly score: number | undefined\n  /** When the source record was created. */\n  declare readonly createdAt: DateTime\n  /** When the source record was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable | SpooledArtifact\n  #trustTier: RetrievableTrustTier\n  #source: string | undefined\n  #kind: string | undefined\n  #score: number | undefined\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw retrievable input validated against `rawRetrievableSchema`.\n   * @throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawRetrievable) {\n    let resolved: ResolvedRetrievable\n    try {\n      resolved = validateOrThrow<ResolvedRetrievable>(rawRetrievableSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content =\n      Tokenizable.isTokenizable(resolved.content) ||\n      SpooledArtifact.isSpooledArtifact(resolved.content)\n        ? resolved.content\n        : new Tokenizable(resolved.content)\n    this.#trustTier = resolved.trustTier\n    this.#source = resolved.source\n    this.#kind = resolved.kind\n    this.#score = resolved.score\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      trustTier: {\n        get: () => this.#trustTier,\n        enumerable: true,\n        configurable: false,\n      },\n      source: {\n        get: () => this.#source,\n        enumerable: true,\n        configurable: false,\n      },\n      kind: {\n        get: () => this.#kind,\n        enumerable: true,\n        configurable: false,\n      },\n      score: {\n        get: () => this.#score,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Estimates the token count of the content under `encoding`.\n   *\n   * @remarks\n   * Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}\n   * (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns\n   * `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the\n   * adapter's token-budget path, which already awaits estimates.\n   *\n   * Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count\n   * tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the\n   * transient allocation at budgeting time.\n   *\n   * @param encoding - The encoding identifier to use for counting.\n   * @returns The estimated token count.\n   */\n  estimateTokens(encoding: TokenEncoding): number | Promise<number> {\n    return this.#content.estimateTokens(encoding)\n  }\n\n  /**\n   * Returns the content body as a single string.\n   *\n   * @remarks\n   * For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a\n   * {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via\n   * {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one\n   * code path; render helpers `await` it at the point the trust-tier envelope is built.\n   *\n   * @returns The full content body as a string.\n   */\n  async contentString(): Promise<string> {\n    return SpooledArtifact.isSpooledArtifact(this.#content)\n      ? this.#content.asString()\n      : this.#content.toString()\n  }\n}\n","import { validator } from '@nhtio/validation'\nimport { passesSchema } from '../utils/validation'\nimport type { SpoolReader } from './spool_reader'\nimport type { MediaReader } from './media_reader'\n\n/**\n * Unified \"give bytes, get a reader\" persistence contract.\n *\n * @remarks\n * For the purposes of storage there is no meaningful distinction between text and binary — bytes\n * are bytes. `ByteStore` is the single low-level shape every ADK storage layer implements: hand it\n * bytes under an `id`, get back a replayable reader `R`; read or delete by the same `id` later. The\n * generic `R` is the reader the store hands out — different reader contracts (line-indexed\n * {@link @nhtio/adk!SpoolReader} vs binary-streamed {@link @nhtio/adk!MediaReader}) are\n * distinguished by the `R` instantiation, not by separate store interfaces. See the {@link SpoolStore}\n * and {@link MediaStore} aliases for the two concrete semantics.\n *\n * `write` accepts a `string`, a `Uint8Array`, or a `ReadableStream<Uint8Array>`. The stream form is\n * the point of the contract: a durable store can persist an arbitrarily large payload straight to\n * disk/object storage without first materializing it in memory. **String input is encoded as\n * UTF-8.** The returned reader is only guaranteed readable once the `write` result has resolved.\n *\n * All three methods may be synchronous or asynchronous so that in-memory implementations are not\n * forced to pay promise overhead while I/O-backed implementations stay async. Note that any\n * implementation accepting a `ReadableStream` must return a `Promise` for that input — draining a\n * stream cannot be synchronous.\n */\nexport interface ByteStore<R> {\n  /**\n   * Persists `bytes` under `id` and returns a reader over them.\n   *\n   * @remarks\n   * Re-writing the same `id` replaces the prior entry. `string` input is encoded as UTF-8;\n   * `Uint8Array` and `ReadableStream<Uint8Array>` are stored byte-faithfully. Stream input\n   * necessarily resolves asynchronously.\n   *\n   * @param id - Identifier used to retrieve or delete the bytes later.\n   * @param bytes - The payload, as a `string`, `Uint8Array`, or `ReadableStream<Uint8Array>`.\n   * @returns A reader over the stored bytes (or a `Promise` of one).\n   */\n  write(id: string, bytes: string | Uint8Array | ReadableStream<Uint8Array>): R | Promise<R>\n\n  /**\n   * Returns a reader over the bytes previously written under `id`, or `undefined` if no entry\n   * exists.\n   *\n   * @param id - Identifier supplied to a prior {@link ByteStore.write} call.\n   * @returns A reader over the stored bytes, `undefined`, or a `Promise` of either.\n   */\n  read(id: string): R | undefined | Promise<R | undefined>\n\n  /**\n   * Removes the entry under `id`.\n   *\n   * @param id - Identifier whose entry should be removed.\n   * @returns `true` if an entry existed and was removed; `false` otherwise (or a `Promise` of one).\n   */\n  delete(id: string): boolean | Promise<boolean>\n}\n\n/**\n * A {@link ByteStore} that hands out line-indexed text readers ({@link @nhtio/adk!SpoolReader}).\n *\n * @remarks\n * The store backing tool-output artifacts. Stored bytes are decoded as UTF-8 text for line-oriented\n * reads; binary input is stored byte-faithfully but `SpoolReader.readAll()` interprets it as text,\n * so opaque binary belongs in a {@link MediaStore} / `Media`, not here.\n */\nexport type SpoolStore = ByteStore<SpoolReader>\n\n/**\n * A {@link ByteStore} that hands out binary-streamed readers ({@link @nhtio/adk!MediaReader}).\n *\n * @remarks\n * The store backing persisted media bytes. Stored bytes are opaque and replayable via\n * `MediaReader.stream()`; no text decoding is implied.\n */\nexport type MediaStore = ByteStore<MediaReader>\n\n/**\n * Validator schema used to validate a {@link ByteStore} value.\n *\n * @remarks\n * Because `ByteStore` is a structural interface with no associated constructor, validation is\n * duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable\n * properties. Arity is not enforced — implementations may add optional parameters beyond the\n * contract. The reader type `R` cannot be checked structurally here; conformance of the reader is\n * the caller's concern at the point of use.\n */\nexport const byteStoreSchema = validator.any().custom((value, helpers) => {\n  if (\n    value !== null &&\n    value !== undefined &&\n    typeof (value as any).write === 'function' &&\n    typeof (value as any).read === 'function' &&\n    typeof (value as any).delete === 'function'\n  ) {\n    return value\n  }\n  return helpers.error('any.invalid')\n})\n\n/**\n * Returns `true` if `value` implements the {@link ByteStore} interface.\n *\n * @remarks\n * Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable\n * functions. Does not use `instanceof` — there is no `ByteStore` constructor.\n *\n * @param value - The value to test.\n * @returns `true` when `value` conforms to the {@link ByteStore} interface.\n */\nexport const implementsByteStore = <R = unknown>(value: unknown): value is ByteStore<R> => {\n  return passesSchema(byteStoreSchema, value)\n}\n","import type { MediaReader } from '../contracts/media_reader'\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by an in-memory `Uint8Array`.\n *\n * @remarks\n * Each `stream()` call returns a fresh single-chunk `ReadableStream` over the same buffer. The\n * reader is re-openable by construction — call `stream()` as many times as needed.\n *\n * @param bytes - The buffer to serve.\n * @returns A {@link @nhtio/adk!MediaReader} that re-reads `bytes` on every call.\n */\nexport const inMemoryMediaReader = (bytes: Uint8Array): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(bytes)\n          controller.close()\n        },\n      })\n    },\n    byteLength(): number {\n      return bytes.byteLength\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a fetch call.\n *\n * @remarks\n * Each `stream()` call re-issues the fetch. Tool authors whose underlying source is rate-limited\n * or expensive must cache locally before constructing the reader — the framework cannot make\n * that decision for them.\n *\n * `byteLength()` returns `undefined` because most remote sources do not promise it without an\n * extra HEAD request; consumers that need a byte size should resolve it out-of-band.\n *\n * @param url - The URL to fetch on each call.\n * @param init - Optional `fetch` init forwarded verbatim.\n * @returns A {@link @nhtio/adk!MediaReader} that re-issues `fetch(url, init)` on every call.\n */\nexport const fromFetch = (url: string | URL, init?: RequestInit): MediaReader => {\n  return {\n    async stream(): Promise<ReadableStream<Uint8Array>> {\n      const response = await fetch(url, init)\n      if (!response.ok) {\n        throw new Error(`fromFetch: fetch failed with status ${response.status}`)\n      }\n      if (!response.body) {\n        throw new Error('fromFetch: response has no body')\n      }\n      return response.body as ReadableStream<Uint8Array>\n    },\n    byteLength(): undefined {\n      return undefined\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a browser `File` or `Blob`.\n *\n * @remarks\n * Each `stream()` call re-streams the underlying File via `File.stream()`. `byteLength()`\n * resolves from `file.size`.\n *\n * @param file - The browser `File` or `Blob` to stream.\n * @returns A {@link @nhtio/adk!MediaReader} that re-streams `file` on every call.\n */\nexport const fromWebFile = (file: Blob): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return file.stream() as ReadableStream<Uint8Array>\n    },\n    byteLength(): number {\n      return file.size\n    },\n  }\n}\n"],"mappings":"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"}

package/{common-DeZaonK1.mjs → common-aFmr9Oqs.mjs}

@@ -1,11 +1,11 @@
-import { a as validateOrThrow } from "./exceptions-NrzIHw_R.mjs";
+import { a as validateOrThrow, i as passesSchema } from "./exceptions-NrzIHw_R.mjs";
 import { a as Tokenizable, o as isError, s as isInstanceOf } from "./tool_registry-DqLOyGyG.mjs";
 import { c as E_INVALID_INITIAL_RETRIEVABLE_VALUE } from "./runtime-CrEPIFgr.mjs";
-import "./thought-CDb457b4.mjs";
-import "./tool_call-BKyyxGaZ.mjs";
-import "./tool-D2WB1EA1.mjs";
-import "./spooled_artifact-C5ZtGxuJ.mjs";
-import "./spooled_markdown_artifact-BpUJol0W.mjs";
+import "./thought-DDqjQu3m.mjs";
+import "./tool-q4LskG7K.mjs";
+import { t as SpooledArtifact } from "./spooled_artifact-B_tVDDdB.mjs";
+import "./tool_call-BKIdAAoY.mjs";
+import "./spooled_markdown_artifact-DWWak35I.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/lib/classes/retrievable.ts
 /**
@@ -24,9 +24,13 @@ import { validator } from "@nhtio/validation";
 * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)
 * when validation fails.
 */
+var contentSchema = validator.alternatives(validator.string(), validator.custom((value, helpers) => {
+	if (Tokenizable.isTokenizable(value) || SpooledArtifact.isSpooledArtifact(value)) return value;
+	return helpers.error("any.invalid");
+}));
 var rawRetrievableSchema = validator.object({
 	id: validator.string().required(),
-	content: Tokenizable.schema.required(),
+	content: contentSchema.required(),
 	trustTier: validator.string().valid("first-party", "third-party-public", "third-party-private").required(),
 	source: validator.string().optional(),
 	kind: validator.string().optional(),
@@ -80,7 +84,7 @@ var Retrievable = class Retrievable {
 			throw new E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: isError(err) ? err : void 0 });
 		}
 		this.#id = resolved.id;
-		this.#content = Tokenizable.isTokenizable(resolved.content) ? resolved.content : new Tokenizable(resolved.content);
+		this.#content = Tokenizable.isTokenizable(resolved.content) || SpooledArtifact.isSpooledArtifact(resolved.content) ? resolved.content : new Tokenizable(resolved.content);
 		this.#trustTier = resolved.trustTier;
 		this.#source = resolved.source;
 		this.#kind = resolved.kind;
@@ -130,6 +134,68 @@ var Retrievable = class Retrievable {
 			}
 		});
 	}
+	/**
+	* Estimates the token count of the content under `encoding`.
+	*
+	* @remarks
+	* Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}
+	* (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns
+	* `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the
+	* adapter's token-budget path, which already awaits estimates.
+	*
+	* Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count
+	* tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the
+	* transient allocation at budgeting time.
+	*
+	* @param encoding - The encoding identifier to use for counting.
+	* @returns The estimated token count.
+	*/
+	estimateTokens(encoding) {
+		return this.#content.estimateTokens(encoding);
+	}
+	/**
+	* Returns the content body as a single string.
+	*
+	* @remarks
+	* For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a
+	* {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via
+	* {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one
+	* code path; render helpers `await` it at the point the trust-tier envelope is built.
+	*
+	* @returns The full content body as a string.
+	*/
+	async contentString() {
+		return SpooledArtifact.isSpooledArtifact(this.#content) ? this.#content.asString() : this.#content.toString();
+	}
+};
+//#endregion
+//#region src/lib/contracts/byte_store.ts
+/**
+* Validator schema used to validate a {@link ByteStore} value.
+*
+* @remarks
+* Because `ByteStore` is a structural interface with no associated constructor, validation is
+* duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable
+* properties. Arity is not enforced — implementations may add optional parameters beyond the
+* contract. The reader type `R` cannot be checked structurally here; conformance of the reader is
+* the caller's concern at the point of use.
+*/
+var byteStoreSchema = validator.any().custom((value, helpers) => {
+	if (value !== null && value !== void 0 && typeof value.write === "function" && typeof value.read === "function" && typeof value.delete === "function") return value;
+	return helpers.error("any.invalid");
+});
+/**
+* Returns `true` if `value` implements the {@link ByteStore} interface.
+*
+* @remarks
+* Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable
+* functions. Does not use `instanceof` — there is no `ByteStore` constructor.
+*
+* @param value - The value to test.
+* @returns `true` when `value` conforms to the {@link ByteStore} interface.
+*/
+var implementsByteStore = (value) => {
+	return passesSchema(byteStoreSchema, value);
 };
 //#endregion
 //#region src/lib/helpers/media_readers.ts
@@ -203,6 +269,6 @@ var fromWebFile = (file) => {
 	};
 };
 //#endregion
-export { Retrievable as i, fromWebFile as n, inMemoryMediaReader as r, fromFetch as t };
+export { implementsByteStore as a, byteStoreSchema as i, fromWebFile as n, Retrievable as o, inMemoryMediaReader as r, fromFetch as t };
 
-//# sourceMappingURL=common-DeZaonK1.mjs.map
+//# sourceMappingURL=common-aFmr9Oqs.mjs.map

package/common-aFmr9Oqs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-aFmr9Oqs.mjs","names":["#id","#content","#trustTier","#source","#kind","#score","#createdAt","#updatedAt"],"sources":["../src/lib/classes/retrievable.ts","../src/lib/contracts/byte_store.ts","../src/lib/helpers/media_readers.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { SpooledArtifact } from './spooled_artifact'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_RETRIEVABLE_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { TokenEncoding } from './tokenizable'\n\n/**\n * Trust-tier discriminator declared by the retrieval middleware at construction time. Drives\n * which envelope the LLM battery wraps the record in.\n *\n * @remarks\n * Vocabulary deliberately mirrors the published security-research taxonomy (\"first-party /\n * third-party\" per *Hidden-in-Plain-Text* WWW '26 and *When AI Meets the Web* IEEE S&P 2026)\n * and explicitly avoids the words \"user\" or \"system\" so the names cannot leak into the model's\n * OpenAI-Model-Spec role-tier authority resolution.\n *\n * - `'first-party'` — deployer-vetted corpora (signed internal docs, policy KBs, curated\n *   reference material). Rendered as a `<retrieved_corpus>` parent with per-record nonce-keyed\n *   `<retrieved>` children. The label \"first-party\" never appears in the envelope itself.\n * - `'third-party-public'` — open-web scrapes, search results, public APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-public'`.\n * - `'third-party-private'` — user uploads, pasted attachments, partner APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-private'`.\n */\nexport type RetrievableTrustTier = 'first-party' | 'third-party-public' | 'third-party-private'\n\n/**\n * Plain input object supplied to {@link Retrievable} at construction time.\n *\n * @remarks\n * Validated against `rawRetrievableSchema` before the `Retrievable` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawRetrievable {\n  /**\n   * Stable unique identifier for this retrieved record. Used as the closing-tag nonce in the\n   * rendered envelope, so it must be unguessable from the payload.\n   */\n  id: string\n  /**\n   * The retrieved content. A plain `string` or {@link @nhtio/adk!Tokenizable} for small inline text, or a\n   * {@link @nhtio/adk!SpooledArtifact} when the extracted text is large and lives in a consumer\n   * {@link @nhtio/adk!ByteStore} (persist it via {@link @nhtio/adk!DispatchContext.storeRetrievableBytes}, wrap\n   * the returned reader in a `SpooledArtifact`, and pass it here). Reader-backed content keeps the\n   * body out of the permanent heap, but token estimation and render still materialise it\n   * transiently (see {@link Retrievable.estimateTokens}).\n   */\n  content: string | Tokenizable | SpooledArtifact\n  /**\n   * Trust tier declared by the retrieval middleware at construction time. Required — there is\n   * NO default. The decision must be conscious. See {@link RetrievableTrustTier}.\n   */\n  trustTier: RetrievableTrustTier\n  /** Optional provenance string: URL, document path, knowledge-base id, etc. */\n  source?: string\n  /** Optional semantic label: 'policy' | 'reference' | 'web-page' | 'pdf' | etc. */\n  kind?: string\n  /** Optional relevance / similarity score in `[0, 1]` from the retrieval middleware. */\n  score?: number\n  /** When the source record was created (publication date, upload date, etc.). */\n  createdAt: string | number | Date | DateTime\n  /** When the source record was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawRetrievable} where all fields have been validated and temporal\n * values normalised to Luxon `DateTime` instances.\n */\ninterface ResolvedRetrievable {\n  id: string\n  content: Tokenizable | SpooledArtifact\n  trustTier: RetrievableTrustTier\n  source?: string\n  kind?: string\n  score?: number\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawRetrievable} before constructing a\n * {@link Retrievable}.\n *\n * @remarks\n * - `id` — required non-empty string.\n * - `content` — required {@link @nhtio/adk!Tokenizable.schema}.\n * - `trustTier` — required, one of `'first-party'`, `'third-party-public'`,\n *   `'third-party-private'`. Unknown / missing values reject.\n * - `source` / `kind` — optional strings.\n * - `score` — optional number in `[0, 1]`.\n * - `createdAt` / `updatedAt` — required datetime-parseable values.\n *\n * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)\n * when validation fails.\n */\nconst contentSchema = validator.alternatives(\n  validator.string(),\n  validator.custom((value, helpers) => {\n    if (Tokenizable.isTokenizable(value) || SpooledArtifact.isSpooledArtifact(value)) {\n      return value\n    }\n    return helpers.error('any.invalid')\n  })\n)\n\nconst rawRetrievableSchema = validator.object<RawRetrievable>({\n  id: validator.string().required(),\n  content: contentSchema.required(),\n  trustTier: validator\n    .string()\n    .valid('first-party', 'third-party-public', 'third-party-private')\n    .required(),\n  source: validator.string().optional(),\n  kind: validator.string().optional(),\n  score: validator.number().min(0).max(1).optional(),\n  createdAt: validator.datetime().required(),\n  updatedAt: validator.datetime().required(),\n})\n\n/**\n * An immutable, validated retrieved record (RAG content) held by the agent.\n *\n * @remarks\n * Peer of {@link @nhtio/adk!Memory} / `Message` / `Thought` / `ToolCall`. Carries an explicit `trustTier`\n * that LLM batteries branch on to choose the rendering envelope. The retrieval middleware that\n * produced the record is the only party that knows its provenance — batteries MUST NOT\n * auto-classify or infer the tier from `source`.\n */\nexport class Retrievable {\n  /**\n   * Validator schema that accepts a {@link RawRetrievable} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a retrievable record.\n   */\n  public static schema = rawRetrievableSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Retrievable} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   */\n  public static isRetrievable(value: unknown): value is Retrievable {\n    return isInstanceOf(value, 'Retrievable', Retrievable)\n  }\n\n  /** Stable unique identifier for this retrieved record. */\n  declare readonly id: string\n  /**\n   * The retrieved content: a {@link @nhtio/adk!Tokenizable} (inline text) or a\n   * {@link @nhtio/adk!SpooledArtifact} (reader-backed, large text living in a consumer store). Use\n   * {@link Retrievable.estimateTokens} for budgeting and {@link Retrievable.contentString} to\n   * materialise the body at render time.\n   */\n  declare readonly content: Tokenizable | SpooledArtifact\n  /** Trust tier declared by the retrieval middleware. */\n  declare readonly trustTier: RetrievableTrustTier\n  /** Optional provenance string. */\n  declare readonly source: string | undefined\n  /** Optional semantic label. */\n  declare readonly kind: string | undefined\n  /** Optional relevance / similarity score in `[0, 1]`. */\n  declare readonly score: number | undefined\n  /** When the source record was created. */\n  declare readonly createdAt: DateTime\n  /** When the source record was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable | SpooledArtifact\n  #trustTier: RetrievableTrustTier\n  #source: string | undefined\n  #kind: string | undefined\n  #score: number | undefined\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw retrievable input validated against `rawRetrievableSchema`.\n   * @throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawRetrievable) {\n    let resolved: ResolvedRetrievable\n    try {\n      resolved = validateOrThrow<ResolvedRetrievable>(rawRetrievableSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content =\n      Tokenizable.isTokenizable(resolved.content) ||\n      SpooledArtifact.isSpooledArtifact(resolved.content)\n        ? resolved.content\n        : new Tokenizable(resolved.content)\n    this.#trustTier = resolved.trustTier\n    this.#source = resolved.source\n    this.#kind = resolved.kind\n    this.#score = resolved.score\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      trustTier: {\n        get: () => this.#trustTier,\n        enumerable: true,\n        configurable: false,\n      },\n      source: {\n        get: () => this.#source,\n        enumerable: true,\n        configurable: false,\n      },\n      kind: {\n        get: () => this.#kind,\n        enumerable: true,\n        configurable: false,\n      },\n      score: {\n        get: () => this.#score,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Estimates the token count of the content under `encoding`.\n   *\n   * @remarks\n   * Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}\n   * (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns\n   * `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the\n   * adapter's token-budget path, which already awaits estimates.\n   *\n   * Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count\n   * tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the\n   * transient allocation at budgeting time.\n   *\n   * @param encoding - The encoding identifier to use for counting.\n   * @returns The estimated token count.\n   */\n  estimateTokens(encoding: TokenEncoding): number | Promise<number> {\n    return this.#content.estimateTokens(encoding)\n  }\n\n  /**\n   * Returns the content body as a single string.\n   *\n   * @remarks\n   * For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a\n   * {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via\n   * {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one\n   * code path; render helpers `await` it at the point the trust-tier envelope is built.\n   *\n   * @returns The full content body as a string.\n   */\n  async contentString(): Promise<string> {\n    return SpooledArtifact.isSpooledArtifact(this.#content)\n      ? this.#content.asString()\n      : this.#content.toString()\n  }\n}\n","import { validator } from '@nhtio/validation'\nimport { passesSchema } from '../utils/validation'\nimport type { SpoolReader } from './spool_reader'\nimport type { MediaReader } from './media_reader'\n\n/**\n * Unified \"give bytes, get a reader\" persistence contract.\n *\n * @remarks\n * For the purposes of storage there is no meaningful distinction between text and binary — bytes\n * are bytes. `ByteStore` is the single low-level shape every ADK storage layer implements: hand it\n * bytes under an `id`, get back a replayable reader `R`; read or delete by the same `id` later. The\n * generic `R` is the reader the store hands out — different reader contracts (line-indexed\n * {@link @nhtio/adk!SpoolReader} vs binary-streamed {@link @nhtio/adk!MediaReader}) are\n * distinguished by the `R` instantiation, not by separate store interfaces. See the {@link SpoolStore}\n * and {@link MediaStore} aliases for the two concrete semantics.\n *\n * `write` accepts a `string`, a `Uint8Array`, or a `ReadableStream<Uint8Array>`. The stream form is\n * the point of the contract: a durable store can persist an arbitrarily large payload straight to\n * disk/object storage without first materializing it in memory. **String input is encoded as\n * UTF-8.** The returned reader is only guaranteed readable once the `write` result has resolved.\n *\n * All three methods may be synchronous or asynchronous so that in-memory implementations are not\n * forced to pay promise overhead while I/O-backed implementations stay async. Note that any\n * implementation accepting a `ReadableStream` must return a `Promise` for that input — draining a\n * stream cannot be synchronous.\n */\nexport interface ByteStore<R> {\n  /**\n   * Persists `bytes` under `id` and returns a reader over them.\n   *\n   * @remarks\n   * Re-writing the same `id` replaces the prior entry. `string` input is encoded as UTF-8;\n   * `Uint8Array` and `ReadableStream<Uint8Array>` are stored byte-faithfully. Stream input\n   * necessarily resolves asynchronously.\n   *\n   * @param id - Identifier used to retrieve or delete the bytes later.\n   * @param bytes - The payload, as a `string`, `Uint8Array`, or `ReadableStream<Uint8Array>`.\n   * @returns A reader over the stored bytes (or a `Promise` of one).\n   */\n  write(id: string, bytes: string | Uint8Array | ReadableStream<Uint8Array>): R | Promise<R>\n\n  /**\n   * Returns a reader over the bytes previously written under `id`, or `undefined` if no entry\n   * exists.\n   *\n   * @param id - Identifier supplied to a prior {@link ByteStore.write} call.\n   * @returns A reader over the stored bytes, `undefined`, or a `Promise` of either.\n   */\n  read(id: string): R | undefined | Promise<R | undefined>\n\n  /**\n   * Removes the entry under `id`.\n   *\n   * @param id - Identifier whose entry should be removed.\n   * @returns `true` if an entry existed and was removed; `false` otherwise (or a `Promise` of one).\n   */\n  delete(id: string): boolean | Promise<boolean>\n}\n\n/**\n * A {@link ByteStore} that hands out line-indexed text readers ({@link @nhtio/adk!SpoolReader}).\n *\n * @remarks\n * The store backing tool-output artifacts. Stored bytes are decoded as UTF-8 text for line-oriented\n * reads; binary input is stored byte-faithfully but `SpoolReader.readAll()` interprets it as text,\n * so opaque binary belongs in a {@link MediaStore} / `Media`, not here.\n */\nexport type SpoolStore = ByteStore<SpoolReader>\n\n/**\n * A {@link ByteStore} that hands out binary-streamed readers ({@link @nhtio/adk!MediaReader}).\n *\n * @remarks\n * The store backing persisted media bytes. Stored bytes are opaque and replayable via\n * `MediaReader.stream()`; no text decoding is implied.\n */\nexport type MediaStore = ByteStore<MediaReader>\n\n/**\n * Validator schema used to validate a {@link ByteStore} value.\n *\n * @remarks\n * Because `ByteStore` is a structural interface with no associated constructor, validation is\n * duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable\n * properties. Arity is not enforced — implementations may add optional parameters beyond the\n * contract. The reader type `R` cannot be checked structurally here; conformance of the reader is\n * the caller's concern at the point of use.\n */\nexport const byteStoreSchema = validator.any().custom((value, helpers) => {\n  if (\n    value !== null &&\n    value !== undefined &&\n    typeof (value as any).write === 'function' &&\n    typeof (value as any).read === 'function' &&\n    typeof (value as any).delete === 'function'\n  ) {\n    return value\n  }\n  return helpers.error('any.invalid')\n})\n\n/**\n * Returns `true` if `value` implements the {@link ByteStore} interface.\n *\n * @remarks\n * Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable\n * functions. Does not use `instanceof` — there is no `ByteStore` constructor.\n *\n * @param value - The value to test.\n * @returns `true` when `value` conforms to the {@link ByteStore} interface.\n */\nexport const implementsByteStore = <R = unknown>(value: unknown): value is ByteStore<R> => {\n  return passesSchema(byteStoreSchema, value)\n}\n","import type { MediaReader } from '../contracts/media_reader'\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by an in-memory `Uint8Array`.\n *\n * @remarks\n * Each `stream()` call returns a fresh single-chunk `ReadableStream` over the same buffer. The\n * reader is re-openable by construction — call `stream()` as many times as needed.\n *\n * @param bytes - The buffer to serve.\n * @returns A {@link @nhtio/adk!MediaReader} that re-reads `bytes` on every call.\n */\nexport const inMemoryMediaReader = (bytes: Uint8Array): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(bytes)\n          controller.close()\n        },\n      })\n    },\n    byteLength(): number {\n      return bytes.byteLength\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a fetch call.\n *\n * @remarks\n * Each `stream()` call re-issues the fetch. Tool authors whose underlying source is rate-limited\n * or expensive must cache locally before constructing the reader — the framework cannot make\n * that decision for them.\n *\n * `byteLength()` returns `undefined` because most remote sources do not promise it without an\n * extra HEAD request; consumers that need a byte size should resolve it out-of-band.\n *\n * @param url - The URL to fetch on each call.\n * @param init - Optional `fetch` init forwarded verbatim.\n * @returns A {@link @nhtio/adk!MediaReader} that re-issues `fetch(url, init)` on every call.\n */\nexport const fromFetch = (url: string | URL, init?: RequestInit): MediaReader => {\n  return {\n    async stream(): Promise<ReadableStream<Uint8Array>> {\n      const response = await fetch(url, init)\n      if (!response.ok) {\n        throw new Error(`fromFetch: fetch failed with status ${response.status}`)\n      }\n      if (!response.body) {\n        throw new Error('fromFetch: response has no body')\n      }\n      return response.body as ReadableStream<Uint8Array>\n    },\n    byteLength(): undefined {\n      return undefined\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a browser `File` or `Blob`.\n *\n * @remarks\n * Each `stream()` call re-streams the underlying File via `File.stream()`. `byteLength()`\n * resolves from `file.size`.\n *\n * @param file - The browser `File` or `Blob` to stream.\n * @returns A {@link @nhtio/adk!MediaReader} that re-streams `file` on every call.\n */\nexport const fromWebFile = (file: Blob): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return file.stream() as ReadableStream<Uint8Array>\n    },\n    byteLength(): number {\n      return file.size\n    },\n  }\n}\n"],"mappings":"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"}

package/common.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_tool_registry = require("./tool_registry-Dkfprsck.js");
-const require_thought = require("./thought-DuN2PgdO.js");
-const require_common = require("./common-Od8edUXU.js");
-const require_tool_call = require("./tool_call-DFgzcVcU.js");
-const require_tool = require("./tool-COSeH8I6.js");
-const require_spooled_artifact = require("./spooled_artifact-Cm9Te22K.js");
-const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-RRB113sy.js");
+const require_tool_registry = require("./tool_registry-snPjF0zJ.js");
+const require_thought = require("./thought-DTsFRGdE.js");
+const require_tool = require("./tool-cwJyEHI9.js");
+const require_spooled_artifact = require("./spooled_artifact-CFstzlqX.js");
+const require_common = require("./common-BJ6V6dsH.js");
+const require_tool_call = require("./tool_call-3T0xTXlD.js");
+const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-DK-T8Hy6.js");
 exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
 exports.Identity = require_thought.Identity;
 exports.Media = require_tool_call.Media;
@@ -22,8 +22,10 @@ exports.Tokenizable = require_tool_registry.Tokenizable;
 exports.Tool = require_tool.Tool;
 exports.ToolCall = require_tool_call.ToolCall;
 exports.ToolRegistry = require_tool_registry.ToolRegistry;
+exports.byteStoreSchema = require_common.byteStoreSchema;
 exports.fromFetch = require_common.fromFetch;
 exports.fromWebFile = require_common.fromWebFile;
+exports.implementsByteStore = require_common.implementsByteStore;
 exports.implementsMediaReader = require_tool_call.implementsMediaReader;
 exports.implementsSpoolReader = require_spooled_artifact.implementsSpoolReader;
 exports.inMemoryMediaReader = require_common.inMemoryMediaReader;

package/common.d.ts

@@ -82,6 +82,14 @@ export type { RawTurnGate } from "./lib/classes/turn_gate";
 export { SpooledArtifact } from "./lib/classes/spooled_artifact";
 export { implementsSpoolReader } from "./lib/contracts/spool_reader";
 export type { SpoolReader } from "./lib/contracts/spool_reader";
+/**
+ * @primaryExport
+ */
+export { implementsByteStore, byteStoreSchema } from "./lib/contracts/byte_store";
+/**
+ * @primaryExport
+ */
+export type { ByteStore, SpoolStore, MediaStore } from "./lib/contracts/byte_store";
 /**
  * @primaryExport
  */

package/common.mjs

@@ -1,8 +1,8 @@
 import { a as Tokenizable, i as TokenEncoding, r as Registry, t as ToolRegistry } from "./tool_registry-DqLOyGyG.mjs";
-import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-CDb457b4.mjs";
-import { i as Retrievable, n as fromWebFile, r as inMemoryMediaReader, t as fromFetch } from "./common-DeZaonK1.mjs";
-import { a as mediaReaderSchema, i as implementsMediaReader, n as Media, r as isMedia, t as ToolCall } from "./tool_call-BKyyxGaZ.mjs";
-import { t as Tool } from "./tool-D2WB1EA1.mjs";
-import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-C5ZtGxuJ.mjs";
-import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-BpUJol0W.mjs";
-export { ArtifactTool, Identity, Media, Memory, Message, Registry, Retrievable, SpooledArtifact, SpooledJsonArtifact, SpooledMarkdownArtifact, Thought, TokenEncoding, Tokenizable, Tool, ToolCall, ToolRegistry, fromFetch, fromWebFile, implementsMediaReader, implementsSpoolReader, inMemoryMediaReader, isMedia, mediaReaderSchema };
+import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-DDqjQu3m.mjs";
+import { t as Tool } from "./tool-q4LskG7K.mjs";
+import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-B_tVDDdB.mjs";
+import { a as implementsByteStore, i as byteStoreSchema, n as fromWebFile, o as Retrievable, r as inMemoryMediaReader, t as fromFetch } from "./common-aFmr9Oqs.mjs";
+import { a as mediaReaderSchema, i as implementsMediaReader, n as Media, r as isMedia, t as ToolCall } from "./tool_call-BKIdAAoY.mjs";
+import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-DWWak35I.mjs";
+export { ArtifactTool, Identity, Media, Memory, Message, Registry, Retrievable, SpooledArtifact, SpooledJsonArtifact, SpooledMarkdownArtifact, Thought, TokenEncoding, Tokenizable, Tool, ToolCall, ToolRegistry, byteStoreSchema, fromFetch, fromWebFile, implementsByteStore, implementsMediaReader, implementsSpoolReader, inMemoryMediaReader, isMedia, mediaReaderSchema };

package/{dispatch_runner-CsoH0nld.js → dispatch_runner-BWYNxmnp.js}

@@ -1,11 +1,10 @@
-require("./chunk-KmRHZBOW.js");
-const require_exceptions = require("./exceptions-D5YrO9Vm.js");
-const require_tool_registry = require("./tool_registry-Dkfprsck.js");
-const require_runtime = require("./runtime-BJVkrGQe.js");
+const require_tool_registry = require("./tool_registry-snPjF0zJ.js");
+const require_exceptions = require("./exceptions-CSqzbL1N.js");
+const require_runtime = require("./runtime-BUDWyd-R.js");
 let _nhtio_validation = require("@nhtio/validation");
-let uuid = require("uuid");
 let luxon = require("luxon");
 let js_sha256 = require("js-sha256");
+let uuid = require("uuid");
 let _nhtio_hooks = require("@nhtio/hooks");
 let _nhtio_middleware = require("@nhtio/middleware");
 //#region src/lib/contracts/turn_runner_context.ts
@@ -299,6 +298,18 @@ var TurnContext = class TurnContext {
 				configurable: false,
 				writable: false
 			},
+			storeMediaBytes: {
+				value: (id, bytes) => injected.storeMediaBytes(this, id, bytes),
+				enumerable: true,
+				configurable: false,
+				writable: false
+			},
+			storeRetrievableBytes: {
+				value: (id, bytes) => injected.storeRetrievableBytes(this, id, bytes),
+				enumerable: true,
+				configurable: false,
+				writable: false
+			},
 			emitMessage: {
 				value: injected.emitMessage,
 				enumerable: true,
@@ -381,6 +392,8 @@ var rawDispatchContextSchema = _nhtio_validation.validator.object({
 	storeToolCall: _nhtio_validation.validator.function().required(),
 	mutateToolCall: _nhtio_validation.validator.function().required(),
 	deleteToolCall: _nhtio_validation.validator.function().required(),
+	storeMediaBytes: _nhtio_validation.validator.function().required(),
+	storeRetrievableBytes: _nhtio_validation.validator.function().required(),
 	hooks: _nhtio_validation.validator.object().optional(),
 	waitFor: _nhtio_validation.validator.function().optional()
 });
@@ -445,6 +458,8 @@ var DispatchContext = class DispatchContext {
 	#storeToolCall;
 	#mutateToolCall;
 	#deleteToolCall;
+	#storeMediaBytes;
+	#storeRetrievableBytes;
 	#waitFor;
 	#toolCallChecksums;
 	#signalled;
@@ -503,6 +518,8 @@ var DispatchContext = class DispatchContext {
 		this.#storeToolCall = resolved.storeToolCall;
 		this.#mutateToolCall = resolved.mutateToolCall;
 		this.#deleteToolCall = resolved.deleteToolCall;
+		this.#storeMediaBytes = resolved.storeMediaBytes;
+		this.#storeRetrievableBytes = resolved.storeRetrievableBytes;
 		this.#waitFor = resolved.waitFor;
 		this.#signalled = void 0;
 		this.#nackError = void 0;
@@ -759,6 +776,18 @@ var DispatchContext = class DispatchContext {
 				configurable: false,
 				writable: false
 			},
+			storeMediaBytes: {
+				value: (id, bytes) => this.#storeMediaBytes(this, id, bytes),
+				enumerable: true,
+				configurable: false,
+				writable: false
+			},
+			storeRetrievableBytes: {
+				value: (id, bytes) => this.#storeRetrievableBytes(this, id, bytes),
+				enumerable: true,
+				configurable: false,
+				writable: false
+			},
 			emitMessage: {
 				value: (content) => {
 					this.#hooks.runner("message").run(content);
@@ -1187,6 +1216,8 @@ var DispatchRunner = class DispatchRunner {
 				storeToolCall: (_c, v) => source.storeToolCall(v),
 				mutateToolCall: (_c, v) => source.mutateToolCall(v),
 				deleteToolCall: (_c, id) => source.deleteToolCall(id),
+				storeMediaBytes: (_c, id, bytes) => source.storeMediaBytes(id, bytes),
+				storeRetrievableBytes: (_c, id, bytes) => source.storeRetrievableBytes(id, bytes),
 				waitFor: source.waitFor
 			});
 		}
@@ -1624,4 +1655,4 @@ Object.defineProperty(exports, "TurnContext", {
 	}
 });
 
-//# sourceMappingURL=dispatch_runner-CsoH0nld.js.map
+//# sourceMappingURL=dispatch_runner-BWYNxmnp.js.map