@nhtio/adk 0.1.0-master-f0aa531d

package/common-Od8edUXU.js

@@ -0,0 +1,232 @@
+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");
+let _nhtio_validation = require("@nhtio/validation");
+//#region src/lib/classes/retrievable.ts
+/**
+* Validator schema used to validate a {@link RawRetrievable} before constructing a
+* {@link Retrievable}.
+*
+* @remarks
+* - `id` — required non-empty string.
+* - `content` — required {@link @nhtio/adk!Tokenizable.schema}.
+* - `trustTier` — required, one of `'first-party'`, `'third-party-public'`,
+*   `'third-party-private'`. Unknown / missing values reject.
+* - `source` / `kind` — optional strings.
+* - `score` — optional number in `[0, 1]`.
+* - `createdAt` / `updatedAt` — required datetime-parseable values.
+*
+* Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)
+* when validation fails.
+*/
+var rawRetrievableSchema = _nhtio_validation.validator.object({
+	id: _nhtio_validation.validator.string().required(),
+	content: require_tool_registry.Tokenizable.schema.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(),
+	score: _nhtio_validation.validator.number().min(0).max(1).optional(),
+	createdAt: _nhtio_validation.validator.datetime().required(),
+	updatedAt: _nhtio_validation.validator.datetime().required()
+});
+/**
+* An immutable, validated retrieved record (RAG content) held by the agent.
+*
+* @remarks
+* Peer of {@link @nhtio/adk!Memory} / `Message` / `Thought` / `ToolCall`. Carries an explicit `trustTier`
+* that LLM batteries branch on to choose the rendering envelope. The retrieval middleware that
+* produced the record is the only party that knows its provenance — batteries MUST NOT
+* auto-classify or infer the tier from `source`.
+*/
+var Retrievable = class Retrievable {
+	/**
+	* Validator schema that accepts a {@link RawRetrievable} object.
+	*
+	* @remarks
+	* Reusable fragment for any schema that needs to validate or nest a retrievable record.
+	*/
+	static schema = rawRetrievableSchema;
+	/**
+	* Returns `true` if `value` is a {@link Retrievable} instance.
+	*
+	* @remarks
+	* Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.
+	*/
+	static isRetrievable(value) {
+		return require_tool_registry.isInstanceOf(value, "Retrievable", Retrievable);
+	}
+	#id;
+	#content;
+	#trustTier;
+	#source;
+	#kind;
+	#score;
+	#createdAt;
+	#updatedAt;
+	/**
+	* @param raw - The raw retrievable input validated against `rawRetrievableSchema`.
+	* @throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} when `raw` does not satisfy the schema.
+	*/
+	constructor(raw) {
+		let resolved;
+		try {
+			resolved = require_exceptions.validateOrThrow(rawRetrievableSchema, raw, true);
+		} catch (err) {
+			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.#trustTier = resolved.trustTier;
+		this.#source = resolved.source;
+		this.#kind = resolved.kind;
+		this.#score = resolved.score;
+		this.#createdAt = resolved.createdAt;
+		this.#updatedAt = resolved.updatedAt;
+		Object.defineProperties(this, {
+			id: {
+				get: () => this.#id,
+				enumerable: true,
+				configurable: false
+			},
+			content: {
+				get: () => this.#content,
+				enumerable: true,
+				configurable: false
+			},
+			trustTier: {
+				get: () => this.#trustTier,
+				enumerable: true,
+				configurable: false
+			},
+			source: {
+				get: () => this.#source,
+				enumerable: true,
+				configurable: false
+			},
+			kind: {
+				get: () => this.#kind,
+				enumerable: true,
+				configurable: false
+			},
+			score: {
+				get: () => this.#score,
+				enumerable: true,
+				configurable: false
+			},
+			createdAt: {
+				get: () => this.#createdAt,
+				enumerable: true,
+				configurable: false
+			},
+			updatedAt: {
+				get: () => this.#updatedAt,
+				enumerable: true,
+				configurable: false
+			}
+		});
+	}
+};
+//#endregion
+//#region src/lib/helpers/media_readers.ts
+/**
+* Constructs a {@link @nhtio/adk!MediaReader} backed by an in-memory `Uint8Array`.
+*
+* @remarks
+* Each `stream()` call returns a fresh single-chunk `ReadableStream` over the same buffer. The
+* reader is re-openable by construction — call `stream()` as many times as needed.
+*
+* @param bytes - The buffer to serve.
+* @returns A {@link @nhtio/adk!MediaReader} that re-reads `bytes` on every call.
+*/
+var inMemoryMediaReader = (bytes) => {
+	return {
+		stream() {
+			return new ReadableStream({ start(controller) {
+				controller.enqueue(bytes);
+				controller.close();
+			} });
+		},
+		byteLength() {
+			return bytes.byteLength;
+		}
+	};
+};
+/**
+* Constructs a {@link @nhtio/adk!MediaReader} backed by a fetch call.
+*
+* @remarks
+* Each `stream()` call re-issues the fetch. Tool authors whose underlying source is rate-limited
+* or expensive must cache locally before constructing the reader — the framework cannot make
+* that decision for them.
+*
+* `byteLength()` returns `undefined` because most remote sources do not promise it without an
+* extra HEAD request; consumers that need a byte size should resolve it out-of-band.
+*
+* @param url - The URL to fetch on each call.
+* @param init - Optional `fetch` init forwarded verbatim.
+* @returns A {@link @nhtio/adk!MediaReader} that re-issues `fetch(url, init)` on every call.
+*/
+var fromFetch = (url, init) => {
+	return {
+		async stream() {
+			const response = await fetch(url, init);
+			if (!response.ok) throw new Error(`fromFetch: fetch failed with status ${response.status}`);
+			if (!response.body) throw new Error("fromFetch: response has no body");
+			return response.body;
+		},
+		byteLength() {}
+	};
+};
+/**
+* Constructs a {@link @nhtio/adk!MediaReader} backed by a browser `File` or `Blob`.
+*
+* @remarks
+* Each `stream()` call re-streams the underlying File via `File.stream()`. `byteLength()`
+* resolves from `file.size`.
+*
+* @param file - The browser `File` or `Blob` to stream.
+* @returns A {@link @nhtio/adk!MediaReader} that re-streams `file` on every call.
+*/
+var fromWebFile = (file) => {
+	return {
+		stream() {
+			return file.stream();
+		},
+		byteLength() {
+			return file.size;
+		}
+	};
+};
+//#endregion
+Object.defineProperty(exports, "Retrievable", {
+	enumerable: true,
+	get: function() {
+		return Retrievable;
+	}
+});
+Object.defineProperty(exports, "fromFetch", {
+	enumerable: true,
+	get: function() {
+		return fromFetch;
+	}
+});
+Object.defineProperty(exports, "fromWebFile", {
+	enumerable: true,
+	get: function() {
+		return fromWebFile;
+	}
+});
+Object.defineProperty(exports, "inMemoryMediaReader", {
+	enumerable: true,
+	get: function() {
+		return inMemoryMediaReader;
+	}
+});
+
+//# sourceMappingURL=common-Od8edUXU.js.map

package/common-Od8edUXU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-Od8edUXU.js","names":["#id","#content","#trustTier","#source","#kind","#score","#createdAt","#updatedAt"],"sources":["../src/lib/classes/retrievable.ts","../src/lib/helpers/media_readers.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\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'\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  /** The retrieved content as a plain string or an existing {@link @nhtio/adk!Tokenizable} instance. */\n  content: string | Tokenizable\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\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 rawRetrievableSchema = validator.object<RawRetrievable>({\n  id: validator.string().required(),\n  content: Tokenizable.schema.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  /** The retrieved content as a {@link @nhtio/adk!Tokenizable} for inline token estimation. */\n  declare readonly content: Tokenizable\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\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 = Tokenizable.isTokenizable(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","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

@@ -0,0 +1,31 @@
+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");
+exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
+exports.Identity = require_thought.Identity;
+exports.Media = require_tool_call.Media;
+exports.Memory = require_thought.Memory;
+exports.Message = require_thought.Message;
+exports.Registry = require_tool_registry.Registry;
+exports.Retrievable = require_common.Retrievable;
+exports.SpooledArtifact = require_spooled_artifact.SpooledArtifact;
+exports.SpooledJsonArtifact = require_spooled_markdown_artifact.SpooledJsonArtifact;
+exports.SpooledMarkdownArtifact = require_spooled_markdown_artifact.SpooledMarkdownArtifact;
+exports.Thought = require_thought.Thought;
+exports.TokenEncoding = require_tool_registry.TokenEncoding;
+exports.Tokenizable = require_tool_registry.Tokenizable;
+exports.Tool = require_tool.Tool;
+exports.ToolCall = require_tool_call.ToolCall;
+exports.ToolRegistry = require_tool_registry.ToolRegistry;
+exports.fromFetch = require_common.fromFetch;
+exports.fromWebFile = require_common.fromWebFile;
+exports.implementsMediaReader = require_tool_call.implementsMediaReader;
+exports.implementsSpoolReader = require_spooled_artifact.implementsSpoolReader;
+exports.inMemoryMediaReader = require_common.inMemoryMediaReader;
+exports.isMedia = require_tool_call.isMedia;
+exports.mediaReaderSchema = require_tool_call.mediaReaderSchema;

package/common.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Core value classes, runtime primitives, media helpers, and their companion input types.
+ *
+ * @module @nhtio/adk/common
+ *
+ * @remarks
+ * A convenience barrel that re-exports the data primitives most consumers reach for: the
+ * value classes ({@link @nhtio/adk!Tokenizable}, {@link @nhtio/adk!Registry}, {@link @nhtio/adk!Identity}, {@link @nhtio/adk!Memory},
+ * {@link @nhtio/adk!Message}, {@link @nhtio/adk!Thought}, {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Tool}, {@link @nhtio/adk!ToolRegistry},
+ * and the spooled artifact family) plus their `Raw*` constructor inputs and small companion
+ * types. {@link @nhtio/adk!TurnGate} is exported as a **type only** — it is constructed internally by the
+ * runner and only surfaced to observers, never instantiated by user code.
+ *
+ * Use this barrel when you want one import for the everyday primitives without pulling the
+ * runners or context surfaces. Per-class barrels remain available when you want narrower imports.
+ */
+/**
+ * @primaryExport
+ */
+export { Tokenizable, TokenEncoding } from "./lib/classes/tokenizable";
+/**
+ * @primaryExport
+ */
+export { Registry } from "./lib/classes/registry";
+/**
+ * @primaryExport
+ */
+export { Identity } from "./lib/classes/identity";
+/**
+ * @primaryExport
+ */
+export type { RawIdentity } from "./lib/classes/identity";
+/**
+ * @primaryExport
+ */
+export { Memory } from "./lib/classes/memory";
+/**
+ * @primaryExport
+ */
+export type { RawMemory } from "./lib/classes/memory";
+/**
+ * @primaryExport
+ */
+export { Retrievable } from "./lib/classes/retrievable";
+/**
+ * @primaryExport
+ */
+export type { RawRetrievable, RetrievableTrustTier } from "./lib/classes/retrievable";
+/**
+ * @primaryExport
+ */
+export { Message } from "./lib/classes/message";
+/**
+ * @primaryExport
+ */
+export type { RawMessage, MessageRole } from "./lib/classes/message";
+/**
+ * @primaryExport
+ */
+export { Thought } from "./lib/classes/thought";
+/**
+ * @primaryExport
+ */
+export type { RawThought } from "./lib/classes/thought";
+export { ToolCall } from "./lib/classes/tool_call";
+export type { RawToolCall, ToolCallResults } from "./lib/classes/tool_call";
+export { Tool } from "./lib/classes/tool";
+export type { RawTool, ToolHandler } from "./lib/classes/tool";
+export type { SpooledArtifactConstructor, ToolMethodDescriptor, } from "./lib/classes/spooled_artifact";
+export { ArtifactTool } from "./lib/classes/artifact_tool";
+export type { RawArtifactTool, ArtifactToolHandler } from "./lib/classes/artifact_tool";
+export { ToolRegistry } from "./lib/classes/tool_registry";
+export type { MergeOptions } from "./lib/classes/tool_registry";
+/**
+ * @primaryExport
+ */
+export type { TurnGate } from "./lib/classes/turn_gate";
+/**
+ * @primaryExport
+ */
+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 { Media, isMedia } from "./lib/classes/media";
+/**
+ * @primaryExport
+ */
+export type { RawMedia, SerializedMedia, MediaKind, MediaTrustTier, MediaModalityHazard, MediaStashEntry, } from "./lib/classes/media";
+/**
+ * @primaryExport
+ */
+export { implementsMediaReader, mediaReaderSchema } from "./lib/contracts/media_reader";
+/**
+ * @primaryExport
+ */
+export type { MediaReader } from "./lib/contracts/media_reader";
+/**
+ * @primaryExport
+ */
+export { inMemoryMediaReader, fromFetch, fromWebFile } from "./lib/helpers/media_readers";
+export { SpooledJsonArtifact } from "./lib/classes/spooled_json_artifact";
+export type { JsonArtifactFormat } from "./lib/classes/spooled_json_artifact";
+export { SpooledMarkdownArtifact } from "./lib/classes/spooled_markdown_artifact";
+export type { MarkdownHeadingEntry, MarkdownCodeEntry, MarkdownSection, } from "./lib/classes/spooled_markdown_artifact";

package/common.mjs

@@ -0,0 +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 };