@nhtio/adk 0.1.0-master-f0aa531d

package/exceptions.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Core ADK exception classes and reusable runtime error constructors.
+ *
+ * Every exception has a stable `E_*` code. The `fatal` flag on each code controls whether it
+ * throws synchronously (programming error — no recovery path) or is emitted on the observability
+ * `error` bus (runtime failure — `run()` still resolves).
+ *
+ * @groupDescription Turn Runner Construction
+ * Exceptions thrown when a {@link @nhtio/adk!TurnRunner} is misconfigured at construction time. Fatal —
+ * a misconfigured runner cannot execute turns.
+ *
+ * @groupDescription Turn Input Validation
+ * Exceptions thrown when the raw turn context supplied to `runner.run()` fails validation. Fatal
+ * and synchronous — thrown before `turnStart` is emitted.
+ *
+ * @groupDescription Pipelines
+ * Non-fatal pipeline errors emitted on the observability `error` bus when middleware throws or
+ * a pipeline short-circuits. `run()` resolves; `turnEnd` still fires.
+ *
+ * @groupDescription Dispatch
+ * Exceptions from the dispatch loop and its executor. A mix of fatal (programming errors) and
+ * non-fatal (runtime failures that nack the dispatch). The loop terminates as `'ack'`, `'nack'`,
+ * or `'aborted'` — inspect `dispatchEnd.status` to classify.
+ *
+ * @groupDescription Gates
+ * Exceptions from {@link @nhtio/adk!TurnGate} construction and settlement. All four settlement outcomes
+ * (resolved, invalid-resolution, aborted, timed-out) also emit `turnGateClosed` on the
+ * observability bus.
+ *
+ * @groupDescription Tools
+ * Exceptions from tool construction, registration, argument validation, and handler execution.
+ * `E_TOOL_DOWNSTREAM_ERROR` wraps handler throws — the original error is on `.cause`.
+ *
+ * @groupDescription Primitive Validation
+ * Fatal exceptions thrown at construction time when a primitive ({@link @nhtio/adk!Message}, {@link @nhtio/adk!Memory},
+ * {@link @nhtio/adk!Thought}, {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Retrievable}, {@link @nhtio/adk!Identity}, {@link @nhtio/adk!Registry})
+ * receives an invalid initial value. If a primitive constructed, it is valid.
+ *
+ * @groupDescription Artifacts
+ * Exceptions from spool and media artifact construction. Fatal — wrap-site validation that the
+ * supplied value implements the required reader interface.
+ *
+ * @module @nhtio/adk/exceptions
+ */
+/**
+ * @primaryExport
+ */
+export { ValidationException } from "./lib/utils/validation";
+/**
+ * @primaryExport
+ */
+export { E_INVALID_TURN_RUNNER_CONFIG, E_INVALID_TURN_CONTEXT, E_INPUT_PIPELINE_ERROR, E_OUTPUT_PIPELINE_ERROR, E_PIPELINE_SHORT_CIRCUITED, E_INVALID_INITIAL_REGISTRY_VALUE, E_INVALID_INITIAL_MEMORY_VALUE, E_INVALID_INITIAL_MESSAGE_VALUE, E_INVALID_INITIAL_IDENTITY_VALUE, E_INVALID_INITIAL_THOUGHT_VALUE, E_INVALID_INITIAL_RETRIEVABLE_VALUE, E_INVALID_INITIAL_MEDIA_VALUE, E_NOT_A_MEDIA_READER, E_INVALID_INITIAL_TURN_GATE_VALUE, E_INVALID_TURN_GATE_RESOLUTION, E_TURN_GATE_TIMEOUT, E_TURN_GATE_ABORTED, E_NOT_A_SPOOL_READER, E_INVALID_INITIAL_TOOL_CALL_VALUE, E_INVALID_INITIAL_TOOL_VALUE, E_INVALID_TOOL_ARGS, E_TOOL_DOWNSTREAM_ERROR, E_TOOL_ALREADY_REGISTERED, E_INVALID_LLM_EXECUTION_CONTEXT, E_LLM_EXECUTION_GATE_NOT_SUPPORTED, E_LLM_EXECUTION_ALREADY_SIGNALLED, E_INVALID_LLM_DISPATCH_INPUT, E_DISPATCH_PIPELINE_ERROR, E_LLM_EXECUTION_EXECUTOR_ERROR, } from "./lib/exceptions/runtime";

package/exceptions.mjs

@@ -0,0 +1,3 @@
+import { n as ValidationException } from "./exceptions-NrzIHw_R.mjs";
+import { C as E_NOT_A_SPOOL_READER, D as E_TOOL_DOWNSTREAM_ERROR, E as E_TOOL_ALREADY_REGISTERED, O as E_TURN_GATE_ABORTED, S as E_NOT_A_MEDIA_READER, T as E_PIPELINE_SHORT_CIRCUITED, _ as E_INVALID_TURN_GATE_RESOLUTION, a as E_INVALID_INITIAL_MEMORY_VALUE, b as E_LLM_EXECUTION_EXECUTOR_ERROR, c as E_INVALID_INITIAL_RETRIEVABLE_VALUE, d as E_INVALID_INITIAL_TOOL_VALUE, f as E_INVALID_INITIAL_TURN_GATE_VALUE, g as E_INVALID_TURN_CONTEXT, h as E_INVALID_TOOL_ARGS, i as E_INVALID_INITIAL_MEDIA_VALUE, k as E_TURN_GATE_TIMEOUT, l as E_INVALID_INITIAL_THOUGHT_VALUE, m as E_INVALID_LLM_EXECUTION_CONTEXT, n as E_INPUT_PIPELINE_ERROR, o as E_INVALID_INITIAL_MESSAGE_VALUE, p as E_INVALID_LLM_DISPATCH_INPUT, r as E_INVALID_INITIAL_IDENTITY_VALUE, s as E_INVALID_INITIAL_REGISTRY_VALUE, t as E_DISPATCH_PIPELINE_ERROR, u as E_INVALID_INITIAL_TOOL_CALL_VALUE, v as E_INVALID_TURN_RUNNER_CONFIG, w as E_OUTPUT_PIPELINE_ERROR, x as E_LLM_EXECUTION_GATE_NOT_SUPPORTED, y as E_LLM_EXECUTION_ALREADY_SIGNALLED } from "./runtime-CrEPIFgr.mjs";
+export { E_DISPATCH_PIPELINE_ERROR, E_INPUT_PIPELINE_ERROR, E_INVALID_INITIAL_IDENTITY_VALUE, E_INVALID_INITIAL_MEDIA_VALUE, E_INVALID_INITIAL_MEMORY_VALUE, E_INVALID_INITIAL_MESSAGE_VALUE, E_INVALID_INITIAL_REGISTRY_VALUE, E_INVALID_INITIAL_RETRIEVABLE_VALUE, E_INVALID_INITIAL_THOUGHT_VALUE, E_INVALID_INITIAL_TOOL_CALL_VALUE, E_INVALID_INITIAL_TOOL_VALUE, E_INVALID_INITIAL_TURN_GATE_VALUE, E_INVALID_LLM_DISPATCH_INPUT, E_INVALID_LLM_EXECUTION_CONTEXT, E_INVALID_TOOL_ARGS, E_INVALID_TURN_CONTEXT, E_INVALID_TURN_GATE_RESOLUTION, E_INVALID_TURN_RUNNER_CONFIG, E_LLM_EXECUTION_ALREADY_SIGNALLED, E_LLM_EXECUTION_EXECUTOR_ERROR, E_LLM_EXECUTION_GATE_NOT_SUPPORTED, E_NOT_A_MEDIA_READER, E_NOT_A_SPOOL_READER, E_OUTPUT_PIPELINE_ERROR, E_PIPELINE_SHORT_CIRCUITED, E_TOOL_ALREADY_REGISTERED, E_TOOL_DOWNSTREAM_ERROR, E_TURN_GATE_ABORTED, E_TURN_GATE_TIMEOUT, ValidationException };

package/factories.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_exceptions = require("./exceptions-D5YrO9Vm.js");
+exports.BaseException = require_exceptions.BaseException;
+exports.createException = require_exceptions.createException;

package/factories.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Factory helpers for creating configured runtime values and exception classes.
+ *
+ * @module @nhtio/adk/factories
+ *
+ * @remarks
+ * Public factory surface for the ADK. A "factory" here means a function that produces a
+ * configured runtime value — typically a class or a class instance — rather than a value
+ * primitive. The ADK's data primitives (value classes plus their `Raw*` companion types)
+ * live in `@nhtio/adk/common`; the ADK's exception classes that are part of the core
+ * contract live in `@nhtio/adk/exceptions`. This barrel hosts the factory helpers that
+ * downstream consumers (including in-tree batteries) use to mint their own configured
+ * runtime values.
+ *
+ * Today the only factory exposed here is {@link @nhtio/adk/factories!createException}, which mints a named
+ * {@link @nhtio/adk!BaseException} subclass with a fixed printf-style message template, error code,
+ * HTTP status, and fatality flag. The `BaseException` class itself is re-exported so
+ * consumers writing patterns the factory does not cover (e.g. richer constructor signatures
+ * carrying structured context payloads) can extend it directly.
+ *
+ * Battery-scoped exceptions belong in their own battery's barrel — `createException`
+ * imported from here is what battery code calls to mint them. The ADK's core exception
+ * module (`@nhtio/adk/exceptions`) does not grow a new symbol every time a battery is added.
+ *
+ * Future factories (middleware factories, helper-builder factories, etc.) will be added
+ * here as they appear.
+ */
+/**
+ * @primaryExport
+ */
+export { createException } from "./lib/utils/exceptions";
+/**
+ * @primaryExport
+ */
+export { BaseException } from "./lib/classes/base_exception";
+/**
+ * @primaryExport
+ */
+export type { ExceptionOptions, CreatedException } from "./lib/utils/exceptions";

package/factories.mjs

@@ -0,0 +1,2 @@
+import { o as BaseException, t as createException } from "./exceptions-NrzIHw_R.mjs";
+export { BaseException, createException };

package/forge.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_tool_registry = require("./tool_registry-Dkfprsck.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");
+exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
+exports.Tool = require_tool.Tool;
+exports.ToolCall = require_tool_call.ToolCall;
+exports.ToolRegistry = require_tool_registry.ToolRegistry;

package/forge.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Schema-first tool construction, invocation records, artifact tools, and registries.
+ *
+ * @module @nhtio/adk/forge
+ *
+ * @remarks
+ * The forge — where tools are made. Schema-first primitives consumers compose into a working
+ * tool surface: {@link @nhtio/adk!Tool} (the standard tool definition), {@link @nhtio/adk!ArtifactTool} (the
+ * artifact-bound variant for custom spooled-artifact query tools), {@link @nhtio/adk!ToolCall} (the
+ * persisted record of an invocation), and {@link @nhtio/adk!ToolRegistry} (the collection of tools
+ * available within a turn). These are almost always used together — a runner registers tools,
+ * the model emits tool calls, the executor invokes them via the registry, and the resulting
+ * record is persisted as a `ToolCall`.
+ *
+ * Pairs with `@nhtio/adk/batteries/tools`, which ships ready-made tool *instances* built with
+ * this forge. The forge defines what a tool is; the batteries provide tools already made.
+ */
+/**
+ * @primaryExport
+ */
+export { Tool } from "./lib/classes/tool";
+/**
+ * @primaryExport
+ */
+export type { RawTool, ToolHandler } from "./lib/classes/tool";
+/**
+ * @primaryExport
+ */
+export type { SpooledArtifactConstructor } from "./lib/classes/spooled_artifact";
+/**
+ * @primaryExport
+ */
+export { ArtifactTool } from "./lib/classes/artifact_tool";
+/**
+ * @primaryExport
+ */
+export type { RawArtifactTool, ArtifactToolHandler } from "./lib/classes/artifact_tool";
+/**
+ * @primaryExport
+ */
+export { ToolCall } from "./lib/classes/tool_call";
+/**
+ * @primaryExport
+ */
+export type { RawToolCall } from "./lib/classes/tool_call";
+/**
+ * @primaryExport
+ */
+export { ToolRegistry } from "./lib/classes/tool_registry";

package/forge.mjs

@@ -0,0 +1,5 @@
+import { t as ToolRegistry } from "./tool_registry-DqLOyGyG.mjs";
+import { t as ToolCall } from "./tool_call-BKyyxGaZ.mjs";
+import { t as Tool } from "./tool-D2WB1EA1.mjs";
+import { i as ArtifactTool } from "./spooled_artifact-C5ZtGxuJ.mjs";
+export { ArtifactTool, Tool, ToolCall, ToolRegistry };

package/guards.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_exceptions = require("./exceptions-D5YrO9Vm.js");
+const require_tool_registry = require("./tool_registry-Dkfprsck.js");
+const require_thought = require("./thought-DuN2PgdO.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_dispatch_runner = require("./dispatch_runner-CsoH0nld.js");
+const require_turn_runner = require("./turn_runner-CMm2BHdX.js");
+//#region src/guards.ts
+/**
+* Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.
+*
+* @module @nhtio/adk/guards
+*
+* @remarks
+* Type guards for every value-bearing primitive in the ADK. Each `is*` function is a
+* freestanding TypeScript type predicate (returns `value is X`) that delegates to the
+* cross-realm-safe {@link @nhtio/adk!isInstanceOf} helper.
+*
+* For internal primitives that are not exported as runtime classes (`BaseException`,
+* `TurnContext`, `DispatchContext`), the freestanding guard here is the canonical runtime
+* detection. For user-constructable classes (`Memory`, `Tool`, etc.) these freestanding guards
+* complement the static `ClassName.isClassName(value)` methods already on each class.
+*/
+/** Returns `true` if `value` is a {@link @nhtio/adk!BaseException} instance. */
+var isBaseException = (value) => require_exceptions.BaseException.isBaseException(value);
+/** Returns `true` if `value` is an {@link @nhtio/adk!Identity} instance. */
+var isIdentity = (value) => require_thought.Identity.isIdentity(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Memory} instance. */
+var isMemory = (value) => require_thought.Memory.isMemory(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Message} instance. */
+var isMessage = (value) => require_thought.Message.isMessage(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Registry} instance. */
+var isRegistry = (value) => require_tool_registry.Registry.isRegistry(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Thought} instance. */
+var isThought = (value) => require_thought.Thought.isThought(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tokenizable} instance. */
+var isTokenizable = (value) => require_tool_registry.Tokenizable.isTokenizable(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tool} instance. */
+var isTool = (value) => require_tool.Tool.isTool(value);
+/** Returns `true` if `value` is an {@link @nhtio/adk!ArtifactTool} instance. */
+var isArtifactTool = (value) => require_spooled_artifact.ArtifactTool.isArtifactTool(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolCall} instance. */
+var isToolCall = (value) => require_tool_call.ToolCall.isToolCall(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolRegistry} instance. */
+var isToolRegistry = (value) => require_tool_registry.ToolRegistry.isToolRegistry(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnGate} instance. */
+var isTurnGate = (value) => require_turn_runner.TurnGate.isTurnGate(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledArtifact} instance. */
+var isSpooledArtifact = (value) => require_spooled_artifact.SpooledArtifact.isSpooledArtifact(value);
+/**
+* Returns `true` if `value` is a constructor function for {@link @nhtio/adk!SpooledArtifact} or any of
+* its subclasses (including `SpooledArtifact` itself).
+*/
+var isSpooledArtifactConstructor = (value) => require_spooled_artifact.SpooledArtifact.isSpooledArtifactConstructor(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledJsonArtifact} instance. */
+var isSpooledJsonArtifact = (value) => require_spooled_markdown_artifact.SpooledJsonArtifact.isSpooledJsonArtifact(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledMarkdownArtifact} instance. */
+var isSpooledMarkdownArtifact = (value) => require_spooled_markdown_artifact.SpooledMarkdownArtifact.isSpooledMarkdownArtifact(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnContext} instance. */
+var isTurnContext = (value) => require_dispatch_runner.TurnContext.isTurnContext(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnRunner} instance. */
+var isTurnRunner = (value) => require_turn_runner.TurnRunner.isTurnRunner(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchContext} instance. */
+var isDispatchContext = (value) => require_dispatch_runner.DispatchContext.isDispatchContext(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchRunner} instance. */
+var isDispatchRunner = (value) => require_dispatch_runner.DispatchRunner.isDispatchRunner(value);
+//#endregion
+exports.implementsSpoolReader = require_spooled_artifact.implementsSpoolReader;
+exports.isArtifactTool = isArtifactTool;
+exports.isBaseException = isBaseException;
+exports.isDispatchContext = isDispatchContext;
+exports.isDispatchRunner = isDispatchRunner;
+exports.isError = require_tool_registry.isError;
+exports.isIdentity = isIdentity;
+exports.isInstanceOf = require_tool_registry.isInstanceOf;
+exports.isMemory = isMemory;
+exports.isMessage = isMessage;
+exports.isObject = require_tool_registry.isObject;
+exports.isRegistry = isRegistry;
+exports.isSpooledArtifact = isSpooledArtifact;
+exports.isSpooledArtifactConstructor = isSpooledArtifactConstructor;
+exports.isSpooledJsonArtifact = isSpooledJsonArtifact;
+exports.isSpooledMarkdownArtifact = isSpooledMarkdownArtifact;
+exports.isThought = isThought;
+exports.isTokenizable = isTokenizable;
+exports.isTool = isTool;
+exports.isToolCall = isToolCall;
+exports.isToolRegistry = isToolRegistry;
+exports.isTurnContext = isTurnContext;
+exports.isTurnGate = isTurnGate;
+exports.isTurnRunner = isTurnRunner;
+
+//# sourceMappingURL=guards.cjs.map

package/guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.cjs","names":[],"sources":["../src/guards.ts"],"sourcesContent":["/**\n * Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.\n *\n * @module @nhtio/adk/guards\n *\n * @remarks\n * Type guards for every value-bearing primitive in the ADK. Each `is*` function is a\n * freestanding TypeScript type predicate (returns `value is X`) that delegates to the\n * cross-realm-safe {@link @nhtio/adk!isInstanceOf} helper.\n *\n * For internal primitives that are not exported as runtime classes (`BaseException`,\n * `TurnContext`, `DispatchContext`), the freestanding guard here is the canonical runtime\n * detection. For user-constructable classes (`Memory`, `Tool`, etc.) these freestanding guards\n * complement the static `ClassName.isClassName(value)` methods already on each class.\n */\n\nimport { Tool } from './lib/classes/tool'\nimport { Memory } from './lib/classes/memory'\nimport { TurnRunner } from './lib/turn_runner'\nimport { Message } from './lib/classes/message'\nimport { Thought } from './lib/classes/thought'\nimport { Registry } from './lib/classes/registry'\nimport { Identity } from './lib/classes/identity'\nimport { TurnGate } from './lib/classes/turn_gate'\nimport { ToolCall } from './lib/classes/tool_call'\nimport { DispatchRunner } from './lib/dispatch_runner'\nimport { Tokenizable } from './lib/classes/tokenizable'\nimport { ArtifactTool } from './lib/classes/artifact_tool'\nimport { ToolRegistry } from './lib/classes/tool_registry'\nimport { BaseException } from './lib/classes/base_exception'\nimport { SpooledArtifact } from './lib/classes/spooled_artifact'\nimport { TurnContext } from './lib/contracts/turn_runner_context'\nimport { DispatchContext } from './lib/contracts/dispatch_context'\nimport { SpooledJsonArtifact } from './lib/classes/spooled_json_artifact'\nimport { SpooledMarkdownArtifact } from './lib/classes/spooled_markdown_artifact'\nimport type { SpooledArtifactConstructor } from './lib/classes/spooled_artifact'\n\n/**\n * @primaryExport\n */\nexport { isInstanceOf, isError, isObject } from './lib/utils/guards'\nexport { implementsSpoolReader } from './lib/contracts/spool_reader'\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!BaseException} instance. */\nexport const isBaseException = (value: unknown): value is BaseException =>\n  BaseException.isBaseException(value)\n\n/** Returns `true` if `value` is an {@link @nhtio/adk!Identity} instance. */\nexport const isIdentity = (value: unknown): value is Identity => Identity.isIdentity(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Memory} instance. */\nexport const isMemory = (value: unknown): value is Memory => Memory.isMemory(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Message} instance. */\nexport const isMessage = (value: unknown): value is Message => Message.isMessage(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Registry} instance. */\nexport const isRegistry = (value: unknown): value is Registry => Registry.isRegistry(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Thought} instance. */\nexport const isThought = (value: unknown): value is Thought => Thought.isThought(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Tokenizable} instance. */\nexport const isTokenizable = (value: unknown): value is Tokenizable =>\n  Tokenizable.isTokenizable(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Tool} instance. */\nexport const isTool = (value: unknown): value is Tool => Tool.isTool(value)\n\n/** Returns `true` if `value` is an {@link @nhtio/adk!ArtifactTool} instance. */\nexport const isArtifactTool = (value: unknown): value is ArtifactTool =>\n  ArtifactTool.isArtifactTool(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!ToolCall} instance. */\nexport const isToolCall = (value: unknown): value is ToolCall => ToolCall.isToolCall(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!ToolRegistry} instance. */\nexport const isToolRegistry = (value: unknown): value is ToolRegistry =>\n  ToolRegistry.isToolRegistry(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnGate} instance. */\nexport const isTurnGate = (value: unknown): value is TurnGate => TurnGate.isTurnGate(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledArtifact} instance. */\nexport const isSpooledArtifact = (value: unknown): value is SpooledArtifact =>\n  SpooledArtifact.isSpooledArtifact(value)\n\n/**\n * Returns `true` if `value` is a constructor function for {@link @nhtio/adk!SpooledArtifact} or any of\n * its subclasses (including `SpooledArtifact` itself).\n */\nexport const isSpooledArtifactConstructor = (\n  value: unknown\n): value is SpooledArtifactConstructor<SpooledArtifact> =>\n  SpooledArtifact.isSpooledArtifactConstructor(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledJsonArtifact} instance. */\nexport const isSpooledJsonArtifact = (value: unknown): value is SpooledJsonArtifact =>\n  SpooledJsonArtifact.isSpooledJsonArtifact(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledMarkdownArtifact} instance. */\nexport const isSpooledMarkdownArtifact = (value: unknown): value is SpooledMarkdownArtifact =>\n  SpooledMarkdownArtifact.isSpooledMarkdownArtifact(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnContext} instance. */\nexport const isTurnContext = (value: unknown): value is TurnContext =>\n  TurnContext.isTurnContext(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnRunner} instance. */\nexport const isTurnRunner = (value: unknown): value is TurnRunner => TurnRunner.isTurnRunner(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchContext} instance. */\nexport const isDispatchContext = (value: unknown): value is DispatchContext =>\n  DispatchContext.isDispatchContext(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchRunner} instance. */\nexport const isDispatchRunner = (value: unknown): value is DispatchRunner =>\n  DispatchRunner.isDispatchRunner(value)\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,IAAa,mBAAmB,UAC9B,mBAAA,cAAc,gBAAgB,KAAK;;AAGrC,IAAa,cAAc,UAAsC,gBAAA,SAAS,WAAW,KAAK;;AAG1F,IAAa,YAAY,UAAoC,gBAAA,OAAO,SAAS,KAAK;;AAGlF,IAAa,aAAa,UAAqC,gBAAA,QAAQ,UAAU,KAAK;;AAGtF,IAAa,cAAc,UAAsC,sBAAA,SAAS,WAAW,KAAK;;AAG1F,IAAa,aAAa,UAAqC,gBAAA,QAAQ,UAAU,KAAK;;AAGtF,IAAa,iBAAiB,UAC5B,sBAAA,YAAY,cAAc,KAAK;;AAGjC,IAAa,UAAU,UAAkC,aAAA,KAAK,OAAO,KAAK;;AAG1E,IAAa,kBAAkB,UAC7B,yBAAA,aAAa,eAAe,KAAK;;AAGnC,IAAa,cAAc,UAAsC,kBAAA,SAAS,WAAW,KAAK;;AAG1F,IAAa,kBAAkB,UAC7B,sBAAA,aAAa,eAAe,KAAK;;AAGnC,IAAa,cAAc,UAAsC,oBAAA,SAAS,WAAW,KAAK;;AAG1F,IAAa,qBAAqB,UAChC,yBAAA,gBAAgB,kBAAkB,KAAK;;;;;AAMzC,IAAa,gCACX,UAEA,yBAAA,gBAAgB,6BAA6B,KAAK;;AAGpD,IAAa,yBAAyB,UACpC,kCAAA,oBAAoB,sBAAsB,KAAK;;AAGjD,IAAa,6BAA6B,UACxC,kCAAA,wBAAwB,0BAA0B,KAAK;;AAGzD,IAAa,iBAAiB,UAC5B,wBAAA,YAAY,cAAc,KAAK;;AAGjC,IAAa,gBAAgB,UAAwC,oBAAA,WAAW,aAAa,KAAK;;AAGlG,IAAa,qBAAqB,UAChC,wBAAA,gBAAgB,kBAAkB,KAAK;;AAGzC,IAAa,oBAAoB,UAC/B,wBAAA,eAAe,iBAAiB,KAAK"}

package/guards.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.
+ *
+ * @module @nhtio/adk/guards
+ *
+ * @remarks
+ * Type guards for every value-bearing primitive in the ADK. Each `is*` function is a
+ * freestanding TypeScript type predicate (returns `value is X`) that delegates to the
+ * cross-realm-safe {@link @nhtio/adk!isInstanceOf} helper.
+ *
+ * For internal primitives that are not exported as runtime classes (`BaseException`,
+ * `TurnContext`, `DispatchContext`), the freestanding guard here is the canonical runtime
+ * detection. For user-constructable classes (`Memory`, `Tool`, etc.) these freestanding guards
+ * complement the static `ClassName.isClassName(value)` methods already on each class.
+ */
+import { Tool } from "./lib/classes/tool";
+import { Memory } from "./lib/classes/memory";
+import { TurnRunner } from "./lib/turn_runner";
+import { Message } from "./lib/classes/message";
+import { Thought } from "./lib/classes/thought";
+import { Registry } from "./lib/classes/registry";
+import { Identity } from "./lib/classes/identity";
+import { TurnGate } from "./lib/classes/turn_gate";
+import { ToolCall } from "./lib/classes/tool_call";
+import { DispatchRunner } from "./lib/dispatch_runner";
+import { Tokenizable } from "./lib/classes/tokenizable";
+import { ArtifactTool } from "./lib/classes/artifact_tool";
+import { ToolRegistry } from "./lib/classes/tool_registry";
+import { BaseException } from "./lib/classes/base_exception";
+import { SpooledArtifact } from "./lib/classes/spooled_artifact";
+import { TurnContext } from "./lib/contracts/turn_runner_context";
+import { DispatchContext } from "./lib/contracts/dispatch_context";
+import { SpooledJsonArtifact } from "./lib/classes/spooled_json_artifact";
+import { SpooledMarkdownArtifact } from "./lib/classes/spooled_markdown_artifact";
+import type { SpooledArtifactConstructor } from "./lib/classes/spooled_artifact";
+/**
+ * @primaryExport
+ */
+export { isInstanceOf, isError, isObject } from "./lib/utils/guards";
+export { implementsSpoolReader } from "./lib/contracts/spool_reader";
+/** Returns `true` if `value` is a {@link @nhtio/adk!BaseException} instance. */
+export declare const isBaseException: (value: unknown) => value is BaseException;
+/** Returns `true` if `value` is an {@link @nhtio/adk!Identity} instance. */
+export declare const isIdentity: (value: unknown) => value is Identity;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Memory} instance. */
+export declare const isMemory: (value: unknown) => value is Memory;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Message} instance. */
+export declare const isMessage: (value: unknown) => value is Message;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Registry} instance. */
+export declare const isRegistry: (value: unknown) => value is Registry;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Thought} instance. */
+export declare const isThought: (value: unknown) => value is Thought;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tokenizable} instance. */
+export declare const isTokenizable: (value: unknown) => value is Tokenizable;
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tool} instance. */
+export declare const isTool: (value: unknown) => value is Tool;
+/** Returns `true` if `value` is an {@link @nhtio/adk!ArtifactTool} instance. */
+export declare const isArtifactTool: (value: unknown) => value is ArtifactTool;
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolCall} instance. */
+export declare const isToolCall: (value: unknown) => value is ToolCall;
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolRegistry} instance. */
+export declare const isToolRegistry: (value: unknown) => value is ToolRegistry;
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnGate} instance. */
+export declare const isTurnGate: (value: unknown) => value is TurnGate;
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledArtifact} instance. */
+export declare const isSpooledArtifact: (value: unknown) => value is SpooledArtifact;
+/**
+ * Returns `true` if `value` is a constructor function for {@link @nhtio/adk!SpooledArtifact} or any of
+ * its subclasses (including `SpooledArtifact` itself).
+ */
+export declare const isSpooledArtifactConstructor: (value: unknown) => value is SpooledArtifactConstructor<SpooledArtifact>;
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledJsonArtifact} instance. */
+export declare const isSpooledJsonArtifact: (value: unknown) => value is SpooledJsonArtifact;
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledMarkdownArtifact} instance. */
+export declare const isSpooledMarkdownArtifact: (value: unknown) => value is SpooledMarkdownArtifact;
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnContext} instance. */
+export declare const isTurnContext: (value: unknown) => value is TurnContext;
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnRunner} instance. */
+export declare const isTurnRunner: (value: unknown) => value is TurnRunner;
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchContext} instance. */
+export declare const isDispatchContext: (value: unknown) => value is DispatchContext;
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchRunner} instance. */
+export declare const isDispatchRunner: (value: unknown) => value is DispatchRunner;

package/guards.mjs

@@ -0,0 +1,72 @@
+import { o as BaseException } from "./exceptions-NrzIHw_R.mjs";
+import { a as Tokenizable, c as isObject, o as isError, r as Registry, s as isInstanceOf, 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 { 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";
+import { n as DispatchContext, r as TurnContext, t as DispatchRunner } from "./dispatch_runner-9j6bXHL3.mjs";
+import { n as TurnGate, t as TurnRunner } from "./turn_runner-y7eyEcJH.mjs";
+//#region src/guards.ts
+/**
+* Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.
+*
+* @module @nhtio/adk/guards
+*
+* @remarks
+* Type guards for every value-bearing primitive in the ADK. Each `is*` function is a
+* freestanding TypeScript type predicate (returns `value is X`) that delegates to the
+* cross-realm-safe {@link @nhtio/adk!isInstanceOf} helper.
+*
+* For internal primitives that are not exported as runtime classes (`BaseException`,
+* `TurnContext`, `DispatchContext`), the freestanding guard here is the canonical runtime
+* detection. For user-constructable classes (`Memory`, `Tool`, etc.) these freestanding guards
+* complement the static `ClassName.isClassName(value)` methods already on each class.
+*/
+/** Returns `true` if `value` is a {@link @nhtio/adk!BaseException} instance. */
+var isBaseException = (value) => BaseException.isBaseException(value);
+/** Returns `true` if `value` is an {@link @nhtio/adk!Identity} instance. */
+var isIdentity = (value) => Identity.isIdentity(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Memory} instance. */
+var isMemory = (value) => Memory.isMemory(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Message} instance. */
+var isMessage = (value) => Message.isMessage(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Registry} instance. */
+var isRegistry = (value) => Registry.isRegistry(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Thought} instance. */
+var isThought = (value) => Thought.isThought(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tokenizable} instance. */
+var isTokenizable = (value) => Tokenizable.isTokenizable(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!Tool} instance. */
+var isTool = (value) => Tool.isTool(value);
+/** Returns `true` if `value` is an {@link @nhtio/adk!ArtifactTool} instance. */
+var isArtifactTool = (value) => ArtifactTool.isArtifactTool(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolCall} instance. */
+var isToolCall = (value) => ToolCall.isToolCall(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!ToolRegistry} instance. */
+var isToolRegistry = (value) => ToolRegistry.isToolRegistry(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnGate} instance. */
+var isTurnGate = (value) => TurnGate.isTurnGate(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledArtifact} instance. */
+var isSpooledArtifact = (value) => SpooledArtifact.isSpooledArtifact(value);
+/**
+* Returns `true` if `value` is a constructor function for {@link @nhtio/adk!SpooledArtifact} or any of
+* its subclasses (including `SpooledArtifact` itself).
+*/
+var isSpooledArtifactConstructor = (value) => SpooledArtifact.isSpooledArtifactConstructor(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledJsonArtifact} instance. */
+var isSpooledJsonArtifact = (value) => SpooledJsonArtifact.isSpooledJsonArtifact(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledMarkdownArtifact} instance. */
+var isSpooledMarkdownArtifact = (value) => SpooledMarkdownArtifact.isSpooledMarkdownArtifact(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnContext} instance. */
+var isTurnContext = (value) => TurnContext.isTurnContext(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!TurnRunner} instance. */
+var isTurnRunner = (value) => TurnRunner.isTurnRunner(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchContext} instance. */
+var isDispatchContext = (value) => DispatchContext.isDispatchContext(value);
+/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchRunner} instance. */
+var isDispatchRunner = (value) => DispatchRunner.isDispatchRunner(value);
+//#endregion
+export { implementsSpoolReader, isArtifactTool, isBaseException, isDispatchContext, isDispatchRunner, isError, isIdentity, isInstanceOf, isMemory, isMessage, isObject, isRegistry, isSpooledArtifact, isSpooledArtifactConstructor, isSpooledJsonArtifact, isSpooledMarkdownArtifact, isThought, isTokenizable, isTool, isToolCall, isToolRegistry, isTurnContext, isTurnGate, isTurnRunner };
+
+//# sourceMappingURL=guards.mjs.map

package/guards.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.mjs","names":[],"sources":["../src/guards.ts"],"sourcesContent":["/**\n * Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.\n *\n * @module @nhtio/adk/guards\n *\n * @remarks\n * Type guards for every value-bearing primitive in the ADK. Each `is*` function is a\n * freestanding TypeScript type predicate (returns `value is X`) that delegates to the\n * cross-realm-safe {@link @nhtio/adk!isInstanceOf} helper.\n *\n * For internal primitives that are not exported as runtime classes (`BaseException`,\n * `TurnContext`, `DispatchContext`), the freestanding guard here is the canonical runtime\n * detection. For user-constructable classes (`Memory`, `Tool`, etc.) these freestanding guards\n * complement the static `ClassName.isClassName(value)` methods already on each class.\n */\n\nimport { Tool } from './lib/classes/tool'\nimport { Memory } from './lib/classes/memory'\nimport { TurnRunner } from './lib/turn_runner'\nimport { Message } from './lib/classes/message'\nimport { Thought } from './lib/classes/thought'\nimport { Registry } from './lib/classes/registry'\nimport { Identity } from './lib/classes/identity'\nimport { TurnGate } from './lib/classes/turn_gate'\nimport { ToolCall } from './lib/classes/tool_call'\nimport { DispatchRunner } from './lib/dispatch_runner'\nimport { Tokenizable } from './lib/classes/tokenizable'\nimport { ArtifactTool } from './lib/classes/artifact_tool'\nimport { ToolRegistry } from './lib/classes/tool_registry'\nimport { BaseException } from './lib/classes/base_exception'\nimport { SpooledArtifact } from './lib/classes/spooled_artifact'\nimport { TurnContext } from './lib/contracts/turn_runner_context'\nimport { DispatchContext } from './lib/contracts/dispatch_context'\nimport { SpooledJsonArtifact } from './lib/classes/spooled_json_artifact'\nimport { SpooledMarkdownArtifact } from './lib/classes/spooled_markdown_artifact'\nimport type { SpooledArtifactConstructor } from './lib/classes/spooled_artifact'\n\n/**\n * @primaryExport\n */\nexport { isInstanceOf, isError, isObject } from './lib/utils/guards'\nexport { implementsSpoolReader } from './lib/contracts/spool_reader'\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!BaseException} instance. */\nexport const isBaseException = (value: unknown): value is BaseException =>\n  BaseException.isBaseException(value)\n\n/** Returns `true` if `value` is an {@link @nhtio/adk!Identity} instance. */\nexport const isIdentity = (value: unknown): value is Identity => Identity.isIdentity(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Memory} instance. */\nexport const isMemory = (value: unknown): value is Memory => Memory.isMemory(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Message} instance. */\nexport const isMessage = (value: unknown): value is Message => Message.isMessage(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Registry} instance. */\nexport const isRegistry = (value: unknown): value is Registry => Registry.isRegistry(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Thought} instance. */\nexport const isThought = (value: unknown): value is Thought => Thought.isThought(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Tokenizable} instance. */\nexport const isTokenizable = (value: unknown): value is Tokenizable =>\n  Tokenizable.isTokenizable(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!Tool} instance. */\nexport const isTool = (value: unknown): value is Tool => Tool.isTool(value)\n\n/** Returns `true` if `value` is an {@link @nhtio/adk!ArtifactTool} instance. */\nexport const isArtifactTool = (value: unknown): value is ArtifactTool =>\n  ArtifactTool.isArtifactTool(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!ToolCall} instance. */\nexport const isToolCall = (value: unknown): value is ToolCall => ToolCall.isToolCall(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!ToolRegistry} instance. */\nexport const isToolRegistry = (value: unknown): value is ToolRegistry =>\n  ToolRegistry.isToolRegistry(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnGate} instance. */\nexport const isTurnGate = (value: unknown): value is TurnGate => TurnGate.isTurnGate(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledArtifact} instance. */\nexport const isSpooledArtifact = (value: unknown): value is SpooledArtifact =>\n  SpooledArtifact.isSpooledArtifact(value)\n\n/**\n * Returns `true` if `value` is a constructor function for {@link @nhtio/adk!SpooledArtifact} or any of\n * its subclasses (including `SpooledArtifact` itself).\n */\nexport const isSpooledArtifactConstructor = (\n  value: unknown\n): value is SpooledArtifactConstructor<SpooledArtifact> =>\n  SpooledArtifact.isSpooledArtifactConstructor(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledJsonArtifact} instance. */\nexport const isSpooledJsonArtifact = (value: unknown): value is SpooledJsonArtifact =>\n  SpooledJsonArtifact.isSpooledJsonArtifact(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!SpooledMarkdownArtifact} instance. */\nexport const isSpooledMarkdownArtifact = (value: unknown): value is SpooledMarkdownArtifact =>\n  SpooledMarkdownArtifact.isSpooledMarkdownArtifact(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnContext} instance. */\nexport const isTurnContext = (value: unknown): value is TurnContext =>\n  TurnContext.isTurnContext(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!TurnRunner} instance. */\nexport const isTurnRunner = (value: unknown): value is TurnRunner => TurnRunner.isTurnRunner(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchContext} instance. */\nexport const isDispatchContext = (value: unknown): value is DispatchContext =>\n  DispatchContext.isDispatchContext(value)\n\n/** Returns `true` if `value` is a {@link @nhtio/adk!DispatchRunner} instance. */\nexport const isDispatchRunner = (value: unknown): value is DispatchRunner =>\n  DispatchRunner.isDispatchRunner(value)\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,IAAa,mBAAmB,UAC9B,cAAc,gBAAgB,KAAK;;AAGrC,IAAa,cAAc,UAAsC,SAAS,WAAW,KAAK;;AAG1F,IAAa,YAAY,UAAoC,OAAO,SAAS,KAAK;;AAGlF,IAAa,aAAa,UAAqC,QAAQ,UAAU,KAAK;;AAGtF,IAAa,cAAc,UAAsC,SAAS,WAAW,KAAK;;AAG1F,IAAa,aAAa,UAAqC,QAAQ,UAAU,KAAK;;AAGtF,IAAa,iBAAiB,UAC5B,YAAY,cAAc,KAAK;;AAGjC,IAAa,UAAU,UAAkC,KAAK,OAAO,KAAK;;AAG1E,IAAa,kBAAkB,UAC7B,aAAa,eAAe,KAAK;;AAGnC,IAAa,cAAc,UAAsC,SAAS,WAAW,KAAK;;AAG1F,IAAa,kBAAkB,UAC7B,aAAa,eAAe,KAAK;;AAGnC,IAAa,cAAc,UAAsC,SAAS,WAAW,KAAK;;AAG1F,IAAa,qBAAqB,UAChC,gBAAgB,kBAAkB,KAAK;;;;;AAMzC,IAAa,gCACX,UAEA,gBAAgB,6BAA6B,KAAK;;AAGpD,IAAa,yBAAyB,UACpC,oBAAoB,sBAAsB,KAAK;;AAGjD,IAAa,6BAA6B,UACxC,wBAAwB,0BAA0B,KAAK;;AAGzD,IAAa,iBAAiB,UAC5B,YAAY,cAAc,KAAK;;AAGjC,IAAa,gBAAgB,UAAwC,WAAW,aAAa,KAAK;;AAGlG,IAAa,qBAAqB,UAChC,gBAAgB,kBAAkB,KAAK;;AAGzC,IAAa,oBAAoB,UAC/B,eAAe,iBAAiB,KAAK"}

package/index.cjs

@@ -0,0 +1,107 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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_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_dispatch_runner = require("./dispatch_runner-CsoH0nld.js");
+require("./dispatch_runner.cjs");
+require("./exceptions.cjs");
+const require_turn_runner = require("./turn_runner-CMm2BHdX.js");
+const require_guards = require("./guards.cjs");
+require("./turn_runner.cjs");
+//#region src/index.ts
+/**
+* Root convenience barrel for the ADK's core runtime values and public TypeScript contracts.
+*
+* @module @nhtio/adk
+*/
+/**
+* The current version of the package.
+*
+* @tip This is a constant that is replaced during the build process with the actual version of the package.
+*/
+var version = "0.1.0-master-f0aa531d";
+//#endregion
+exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
+exports.DispatchRunner = require_dispatch_runner.DispatchRunner;
+exports.E_DISPATCH_PIPELINE_ERROR = require_runtime.E_DISPATCH_PIPELINE_ERROR;
+exports.E_INPUT_PIPELINE_ERROR = require_runtime.E_INPUT_PIPELINE_ERROR;
+exports.E_INVALID_INITIAL_IDENTITY_VALUE = require_runtime.E_INVALID_INITIAL_IDENTITY_VALUE;
+exports.E_INVALID_INITIAL_MEMORY_VALUE = require_runtime.E_INVALID_INITIAL_MEMORY_VALUE;
+exports.E_INVALID_INITIAL_MESSAGE_VALUE = require_runtime.E_INVALID_INITIAL_MESSAGE_VALUE;
+exports.E_INVALID_INITIAL_REGISTRY_VALUE = require_runtime.E_INVALID_INITIAL_REGISTRY_VALUE;
+exports.E_INVALID_INITIAL_THOUGHT_VALUE = require_runtime.E_INVALID_INITIAL_THOUGHT_VALUE;
+exports.E_INVALID_INITIAL_TOOL_CALL_VALUE = require_runtime.E_INVALID_INITIAL_TOOL_CALL_VALUE;
+exports.E_INVALID_INITIAL_TOOL_VALUE = require_runtime.E_INVALID_INITIAL_TOOL_VALUE;
+exports.E_INVALID_INITIAL_TURN_GATE_VALUE = require_runtime.E_INVALID_INITIAL_TURN_GATE_VALUE;
+exports.E_INVALID_LLM_DISPATCH_INPUT = require_runtime.E_INVALID_LLM_DISPATCH_INPUT;
+exports.E_INVALID_LLM_EXECUTION_CONTEXT = require_runtime.E_INVALID_LLM_EXECUTION_CONTEXT;
+exports.E_INVALID_TOOL_ARGS = require_runtime.E_INVALID_TOOL_ARGS;
+exports.E_INVALID_TURN_CONTEXT = require_runtime.E_INVALID_TURN_CONTEXT;
+exports.E_INVALID_TURN_GATE_RESOLUTION = require_runtime.E_INVALID_TURN_GATE_RESOLUTION;
+exports.E_INVALID_TURN_RUNNER_CONFIG = require_runtime.E_INVALID_TURN_RUNNER_CONFIG;
+exports.E_LLM_EXECUTION_ALREADY_SIGNALLED = require_runtime.E_LLM_EXECUTION_ALREADY_SIGNALLED;
+exports.E_LLM_EXECUTION_EXECUTOR_ERROR = require_runtime.E_LLM_EXECUTION_EXECUTOR_ERROR;
+exports.E_LLM_EXECUTION_GATE_NOT_SUPPORTED = require_runtime.E_LLM_EXECUTION_GATE_NOT_SUPPORTED;
+exports.E_NOT_A_SPOOL_READER = require_runtime.E_NOT_A_SPOOL_READER;
+exports.E_OUTPUT_PIPELINE_ERROR = require_runtime.E_OUTPUT_PIPELINE_ERROR;
+exports.E_PIPELINE_SHORT_CIRCUITED = require_runtime.E_PIPELINE_SHORT_CIRCUITED;
+exports.E_TOOL_ALREADY_REGISTERED = require_runtime.E_TOOL_ALREADY_REGISTERED;
+exports.E_TOOL_DOWNSTREAM_ERROR = require_runtime.E_TOOL_DOWNSTREAM_ERROR;
+exports.E_TURN_GATE_ABORTED = require_runtime.E_TURN_GATE_ABORTED;
+exports.E_TURN_GATE_TIMEOUT = require_runtime.E_TURN_GATE_TIMEOUT;
+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.TurnRunner = require_turn_runner.TurnRunner;
+exports.ValidationException = require_exceptions.ValidationException;
+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.isArtifactTool = require_guards.isArtifactTool;
+exports.isBaseException = require_guards.isBaseException;
+exports.isDispatchContext = require_guards.isDispatchContext;
+exports.isDispatchRunner = require_guards.isDispatchRunner;
+exports.isError = require_tool_registry.isError;
+exports.isIdentity = require_guards.isIdentity;
+exports.isInstanceOf = require_tool_registry.isInstanceOf;
+exports.isMedia = require_tool_call.isMedia;
+exports.isMemory = require_guards.isMemory;
+exports.isMessage = require_guards.isMessage;
+exports.isObject = require_tool_registry.isObject;
+exports.isRegistry = require_guards.isRegistry;
+exports.isSpooledArtifact = require_guards.isSpooledArtifact;
+exports.isSpooledArtifactConstructor = require_guards.isSpooledArtifactConstructor;
+exports.isSpooledJsonArtifact = require_guards.isSpooledJsonArtifact;
+exports.isSpooledMarkdownArtifact = require_guards.isSpooledMarkdownArtifact;
+exports.isThought = require_guards.isThought;
+exports.isTokenizable = require_guards.isTokenizable;
+exports.isTool = require_guards.isTool;
+exports.isToolCall = require_guards.isToolCall;
+exports.isToolRegistry = require_guards.isToolRegistry;
+exports.isTurnContext = require_guards.isTurnContext;
+exports.isTurnGate = require_guards.isTurnGate;
+exports.isTurnRunner = require_guards.isTurnRunner;
+exports.mediaReaderSchema = require_tool_call.mediaReaderSchema;
+exports.version = version;
+
+//# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Root convenience barrel for the ADK's core runtime values and public TypeScript contracts.\n *\n * @module @nhtio/adk\n */\n\n/**\n * The current version of the package.\n *\n * @tip This is a constant that is replaced during the build process with the actual version of the package.\n */\nexport const version = __VERSION__\n\n// ── Data primitives (value classes + Raw* types) ──────────────────────────────\n\nexport {\n  Tokenizable,\n  TokenEncoding,\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  implementsSpoolReader,\n  Media,\n  isMedia,\n  implementsMediaReader,\n  mediaReaderSchema,\n  inMemoryMediaReader,\n  fromFetch,\n  fromWebFile,\n} from './common'\n\nexport type {\n  RawMedia,\n  SerializedMedia,\n  MediaKind,\n  MediaTrustTier,\n  MediaModalityHazard,\n  MediaStashEntry,\n  MediaReader,\n} from './common'\n\n// ── Runners (the entry points for executing turns and dispatches) ─────────────\n\nexport { TurnRunner } from './turn_runner'\nexport { DispatchRunner } from './dispatch_runner'\n\n// ── Freestanding guards ───────────────────────────────────────────────────────\n\nexport {\n  isInstanceOf,\n  isError,\n  isObject,\n  isBaseException,\n  isIdentity,\n  isMemory,\n  isMessage,\n  isRegistry,\n  isThought,\n  isTokenizable,\n  isTool,\n  isArtifactTool,\n  isToolCall,\n  isToolRegistry,\n  isTurnGate,\n  isSpooledArtifact,\n  isSpooledArtifactConstructor,\n  isSpooledJsonArtifact,\n  isSpooledMarkdownArtifact,\n  isTurnContext,\n  isTurnRunner,\n  isDispatchContext,\n  isDispatchRunner,\n} from './guards'\n\n// ── Exceptions ────────────────────────────────────────────────────────────────\n\nexport {\n  ValidationException,\n  E_INVALID_TURN_RUNNER_CONFIG,\n  E_INVALID_TURN_CONTEXT,\n  E_INPUT_PIPELINE_ERROR,\n  E_OUTPUT_PIPELINE_ERROR,\n  E_PIPELINE_SHORT_CIRCUITED,\n  E_INVALID_INITIAL_REGISTRY_VALUE,\n  E_INVALID_INITIAL_MEMORY_VALUE,\n  E_INVALID_INITIAL_MESSAGE_VALUE,\n  E_INVALID_INITIAL_IDENTITY_VALUE,\n  E_INVALID_INITIAL_THOUGHT_VALUE,\n  E_INVALID_INITIAL_TURN_GATE_VALUE,\n  E_INVALID_TURN_GATE_RESOLUTION,\n  E_TURN_GATE_TIMEOUT,\n  E_TURN_GATE_ABORTED,\n  E_NOT_A_SPOOL_READER,\n  E_INVALID_INITIAL_TOOL_CALL_VALUE,\n  E_INVALID_INITIAL_TOOL_VALUE,\n  E_INVALID_TOOL_ARGS,\n  E_TOOL_DOWNSTREAM_ERROR,\n  E_TOOL_ALREADY_REGISTERED,\n  E_INVALID_LLM_EXECUTION_CONTEXT,\n  E_LLM_EXECUTION_GATE_NOT_SUPPORTED,\n  E_LLM_EXECUTION_ALREADY_SIGNALLED,\n  E_INVALID_LLM_DISPATCH_INPUT,\n  E_DISPATCH_PIPELINE_ERROR,\n  E_LLM_EXECUTION_EXECUTOR_ERROR,\n} from './exceptions'\n\n// ── Types (re-exported via `export type *` form) ──────────────────────────────\n\nexport type {\n  BaseException,\n  TurnContext,\n  DispatchContext,\n  TurnGate,\n  RawIdentity,\n  RawMemory,\n  RawMessage,\n  MessageRole,\n  RawThought,\n  RawToolCall,\n  RawTool,\n  ToolHandler,\n  RawArtifactTool,\n  ArtifactToolHandler,\n  MergeOptions,\n  SpooledArtifactConstructor,\n  ToolMethodDescriptor,\n  RawTurnGate,\n  SpoolReader,\n  JsonArtifactFormat,\n  MarkdownHeadingEntry,\n  MarkdownCodeEntry,\n  MarkdownSection,\n  RawTurnContext,\n  ResolvedTurnContext,\n  MemoryRetrievalFn,\n  MessageRetrievalFn,\n  ThoughtRetrievalFn,\n  ToolCallRetrievalFn,\n  ToolsRetrievalFn,\n  RetrievableRetrievalFn,\n  StandingInstructionsRefreshFn,\n  StandingInstructionStoreFn,\n  StandingInstructionMutateFn,\n  StandingInstructionDeleteFn,\n  MemoryStoreFn,\n  MemoryMutateFn,\n  MemoryDeleteFn,\n  MessageStoreFn,\n  MessageMutateFn,\n  MessageDeleteFn,\n  ThoughtStoreFn,\n  ThoughtMutateFn,\n  ThoughtDeleteFn,\n  ToolCallStoreFn,\n  ToolCallMutateFn,\n  ToolCallDeleteFn,\n  RetrievableStoreFn,\n  RetrievableMutateFn,\n  RetrievableDeleteFn,\n  TurnRunnerConfig,\n  ResolvedTurnRunnerConfig,\n  TurnPipelineMiddlewareFn,\n  TurnStreamableContent,\n  TurnToolCallContent,\n  TurnStartEvent,\n  TurnEndEvent,\n  TurnGateClosedEvent,\n  ToolExecutionStartEvent,\n  ToolExecutionEndEvent,\n  EmitMessageFn,\n  EmitThoughtFn,\n  EmitToolCallFn,\n  EmitToolExecutionStartFn,\n  EmitToolExecutionEndFn,\n  OpenGateFn,\n  TurnEvents,\n  TurnEvent,\n  TurnEventListener,\n  TurnObservabilityEvents,\n  TurnObservabilityEvent,\n  TurnObservabilityEventListener,\n  RawDispatchContext,\n  DispatchMemoryRetrievalFn,\n  DispatchMessageRetrievalFn,\n  DispatchThoughtRetrievalFn,\n  DispatchToolCallRetrievalFn,\n  DispatchToolsRetrievalFn,\n  DispatchStandingInstructionsRefreshFn,\n  DispatchStandingInstructionStoreFn,\n  DispatchStandingInstructionMutateFn,\n  DispatchStandingInstructionDeleteFn,\n  DispatchMemoryStoreFn,\n  DispatchMemoryMutateFn,\n  DispatchMemoryDeleteFn,\n  DispatchMessageStoreFn,\n  DispatchMessageMutateFn,\n  DispatchMessageDeleteFn,\n  DispatchThoughtStoreFn,\n  DispatchThoughtMutateFn,\n  DispatchThoughtDeleteFn,\n  DispatchToolCallStoreFn,\n  DispatchToolCallMutateFn,\n  DispatchToolCallDeleteFn,\n  DispatchContextHooks,\n  DispatchContextHookRegistrations,\n  RawDispatchRunnerInput,\n  DispatchPipelineMiddlewareFn,\n  DispatchExecutorFn,\n  DispatchExecutorHelpers,\n  DispatchExecutorLogChannel,\n  DispatchExecutorLogEntry,\n  DispatchExecutorLogLevel,\n  LogEvent,\n  DispatchStartEvent,\n  DispatchEndEvent,\n  IterationStartEvent,\n  IterationEndEvent,\n  DispatchRunnerFunctionalHooks,\n  DispatchRunnerObservabilityHooks,\n  DispatchRunnerFunctionalHookRegistrations,\n  DispatchRunnerObservabilityHookRegistrations,\n} from './types'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,IAAa,UAAA"}

package/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Root convenience barrel for the ADK's core runtime values and public TypeScript contracts.
+ *
+ * @module @nhtio/adk
+ */
+/**
+ * The current version of the package.
+ *
+ * @tip This is a constant that is replaced during the build process with the actual version of the package.
+ */
+export declare const version: string;
+export { Tokenizable, TokenEncoding, Registry, Identity, Memory, Message, Retrievable, Thought, ToolCall, Tool, ArtifactTool, ToolRegistry, SpooledArtifact, SpooledJsonArtifact, SpooledMarkdownArtifact, implementsSpoolReader, Media, isMedia, implementsMediaReader, mediaReaderSchema, inMemoryMediaReader, fromFetch, fromWebFile, } from "./common";
+export type { RawMedia, SerializedMedia, MediaKind, MediaTrustTier, MediaModalityHazard, MediaStashEntry, MediaReader, } from "./common";
+export { TurnRunner } from "./turn_runner";
+export { DispatchRunner } from "./dispatch_runner";
+export { isInstanceOf, isError, isObject, isBaseException, isIdentity, isMemory, isMessage, isRegistry, isThought, isTokenizable, isTool, isArtifactTool, isToolCall, isToolRegistry, isTurnGate, isSpooledArtifact, isSpooledArtifactConstructor, isSpooledJsonArtifact, isSpooledMarkdownArtifact, isTurnContext, isTurnRunner, isDispatchContext, isDispatchRunner, } from "./guards";
+export { ValidationException, E_INVALID_TURN_RUNNER_CONFIG, E_INVALID_TURN_CONTEXT, E_INPUT_PIPELINE_ERROR, E_OUTPUT_PIPELINE_ERROR, E_PIPELINE_SHORT_CIRCUITED, E_INVALID_INITIAL_REGISTRY_VALUE, E_INVALID_INITIAL_MEMORY_VALUE, E_INVALID_INITIAL_MESSAGE_VALUE, E_INVALID_INITIAL_IDENTITY_VALUE, E_INVALID_INITIAL_THOUGHT_VALUE, E_INVALID_INITIAL_TURN_GATE_VALUE, E_INVALID_TURN_GATE_RESOLUTION, E_TURN_GATE_TIMEOUT, E_TURN_GATE_ABORTED, E_NOT_A_SPOOL_READER, E_INVALID_INITIAL_TOOL_CALL_VALUE, E_INVALID_INITIAL_TOOL_VALUE, E_INVALID_TOOL_ARGS, E_TOOL_DOWNSTREAM_ERROR, E_TOOL_ALREADY_REGISTERED, E_INVALID_LLM_EXECUTION_CONTEXT, E_LLM_EXECUTION_GATE_NOT_SUPPORTED, E_LLM_EXECUTION_ALREADY_SIGNALLED, E_INVALID_LLM_DISPATCH_INPUT, E_DISPATCH_PIPELINE_ERROR, E_LLM_EXECUTION_EXECUTOR_ERROR, } from "./exceptions";
+export type { BaseException, TurnContext, DispatchContext, TurnGate, RawIdentity, RawMemory, RawMessage, MessageRole, RawThought, RawToolCall, RawTool, ToolHandler, RawArtifactTool, ArtifactToolHandler, MergeOptions, SpooledArtifactConstructor, ToolMethodDescriptor, RawTurnGate, SpoolReader, JsonArtifactFormat, MarkdownHeadingEntry, MarkdownCodeEntry, MarkdownSection, RawTurnContext, ResolvedTurnContext, MemoryRetrievalFn, MessageRetrievalFn, ThoughtRetrievalFn, ToolCallRetrievalFn, ToolsRetrievalFn, RetrievableRetrievalFn, StandingInstructionsRefreshFn, StandingInstructionStoreFn, StandingInstructionMutateFn, StandingInstructionDeleteFn, MemoryStoreFn, MemoryMutateFn, MemoryDeleteFn, MessageStoreFn, MessageMutateFn, MessageDeleteFn, ThoughtStoreFn, ThoughtMutateFn, ThoughtDeleteFn, ToolCallStoreFn, ToolCallMutateFn, ToolCallDeleteFn, RetrievableStoreFn, RetrievableMutateFn, RetrievableDeleteFn, TurnRunnerConfig, ResolvedTurnRunnerConfig, TurnPipelineMiddlewareFn, TurnStreamableContent, TurnToolCallContent, TurnStartEvent, TurnEndEvent, TurnGateClosedEvent, ToolExecutionStartEvent, ToolExecutionEndEvent, EmitMessageFn, EmitThoughtFn, EmitToolCallFn, EmitToolExecutionStartFn, EmitToolExecutionEndFn, OpenGateFn, TurnEvents, TurnEvent, TurnEventListener, TurnObservabilityEvents, TurnObservabilityEvent, TurnObservabilityEventListener, RawDispatchContext, DispatchMemoryRetrievalFn, DispatchMessageRetrievalFn, DispatchThoughtRetrievalFn, DispatchToolCallRetrievalFn, DispatchToolsRetrievalFn, DispatchStandingInstructionsRefreshFn, DispatchStandingInstructionStoreFn, DispatchStandingInstructionMutateFn, DispatchStandingInstructionDeleteFn, DispatchMemoryStoreFn, DispatchMemoryMutateFn, DispatchMemoryDeleteFn, DispatchMessageStoreFn, DispatchMessageMutateFn, DispatchMessageDeleteFn, DispatchThoughtStoreFn, DispatchThoughtMutateFn, DispatchThoughtDeleteFn, DispatchToolCallStoreFn, DispatchToolCallMutateFn, DispatchToolCallDeleteFn, DispatchContextHooks, DispatchContextHookRegistrations, RawDispatchRunnerInput, DispatchPipelineMiddlewareFn, DispatchExecutorFn, DispatchExecutorHelpers, DispatchExecutorLogChannel, DispatchExecutorLogEntry, DispatchExecutorLogLevel, LogEvent, DispatchStartEvent, DispatchEndEvent, IterationStartEvent, IterationEndEvent, DispatchRunnerFunctionalHooks, DispatchRunnerObservabilityHooks, DispatchRunnerFunctionalHookRegistrations, DispatchRunnerObservabilityHookRegistrations, } from "./types";