@nhtio/adk 1.20260607.2 → 1.20260609.1

package/{dispatch_runner-BHBNupqp.js → dispatch_runner-nHDKkxye.js}

@@ -1,7 +1,7 @@
 require("./chunk-Ble4zEEl.js");
-const require_exceptions = require("./exceptions-CitH5wZI.js");
-const require_tool_registry = require("./tool_registry-DYUYqXvo.js");
-const require_runtime = require("./runtime-MFFcJrRv.js");
+const require_exceptions = require("./exceptions-BRXrUKiW.js");
+const require_tool_registry = require("./tool_registry-CKJPze3j.js");
+const require_runtime = require("./runtime-DslE1aBw.js");
 let _nhtio_validation = require("@nhtio/validation");
 let luxon = require("luxon");
 let js_sha256 = require("js-sha256");
@@ -1101,6 +1101,12 @@ var dispatchInputSchema = _nhtio_validation.validator.object({
 * the guard at runtime.
 */
 var CONSTRUCT_TOKEN = Symbol("DispatchRunner.construct");
+/**
+* Runs a single dispatch iteration of an agentic turn: it drives the executor through the
+* input/output middleware pipelines, emitting functional and observability hook events along the
+* way. Construction is gated — obtain one via the static {@link DispatchRunner.dispatch} entry
+* point rather than `new`.
+*/
 var DispatchRunner = class DispatchRunner {
 	#functionalHooks;
 	#observabilityHooks;
@@ -1108,6 +1114,12 @@ var DispatchRunner = class DispatchRunner {
 	#outputPipeline;
 	#sourceCtx;
 	#deltaQueue;
+	/**
+	* Construction is gated by an internal sentinel `token` — call the static
+	* {@link DispatchRunner.dispatch} entry point instead of `new`.
+	*
+	* @internal
+	*/
 	constructor(token, sourceCtx, turnInputPipeline, turnOutputPipeline, hooks, observers) {
 		if (token !== CONSTRUCT_TOKEN) throw new require_runtime.E_INVALID_LLM_DISPATCH_INPUT();
 		this.#sourceCtx = sourceCtx;
@@ -1402,6 +1414,15 @@ var DispatchRunner = class DispatchRunner {
 			warn: makeLogEmitter("warn"),
 			error: makeLogEmitter("error")
 		};
+		const reportGenerationStats = (stats) => {
+			const event = {
+				...stats,
+				dispatchId: ctx.dispatchId,
+				iteration: ctx.iteration,
+				emittedAt: luxon.DateTime.now()
+			};
+			observabilityHooks.runner("generationStats").run(event);
+		};
 		const messageStreams = /* @__PURE__ */ new Map();
 		const thoughtStreams = /* @__PURE__ */ new Map();
 		const toolCallStreams = /* @__PURE__ */ new Map();
@@ -1473,7 +1494,8 @@ var DispatchRunner = class DispatchRunner {
 				};
 				ctx.emitToolCall(content);
 			},
-			log
+			log,
+			reportGenerationStats
 		};
 	}
 	async #runDispatch(llmCtx, executor) {
@@ -1656,4 +1678,4 @@ Object.defineProperty(exports, "TurnContext", {
 	}
 });
 
-//# sourceMappingURL=dispatch_runner-BHBNupqp.js.map
+//# sourceMappingURL=dispatch_runner-nHDKkxye.js.map