@nhtio/adk 0.1.0-master-e04b0eba → 0.1.0-master-d3e80e7a

package/dispatch_runner.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Ble4zEEl.js");
-const require_dispatch_runner = require("./dispatch_runner-CEFHXRJZ.js");
+const require_dispatch_runner = require("./dispatch_runner-CpuyATj1.js");
 exports.DispatchRunner = require_dispatch_runner.DispatchRunner;

package/dispatch_runner.mjs

@@ -1,2 +1,2 @@
-import { t as DispatchRunner } from "./dispatch_runner-uNtS-XSP.mjs";
+import { t as DispatchRunner } from "./dispatch_runner-CDF3X0nv.mjs";
 export { DispatchRunner };

package/exceptions.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Ble4zEEl.js");
 const require_exceptions = require("./exceptions-CitH5wZI.js");
-const require_runtime = require("./runtime-DyD9oQjH.js");
+const require_runtime = require("./runtime-MFFcJrRv.js");
 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;

package/exceptions.mjs

@@ -1,3 +1,3 @@
 import { n as ValidationException } from "./exceptions-BeWH2FwP.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-CDIZwCT0.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-j92CNi5z.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/forge.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Ble4zEEl.js");
-const require_tool_registry = require("./tool_registry-CKk5ooxm.js");
-const require_tool = require("./tool-DIHzOZiV.js");
-const require_spooled_artifact = require("./spooled_artifact-CHvDDYGA.js");
-const require_tool_call = require("./tool_call-CkOVOhg0.js");
+const require_tool_registry = require("./tool_registry-CtCQ4Xoz.js");
+const require_tool = require("./tool-CX9vNHAw.js");
+const require_spooled_artifact = require("./spooled_artifact-B8gIIn9h.js");
+const require_tool_call = require("./tool_call--7ti-frB.js");
 exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
 exports.Tool = require_tool.Tool;
 exports.ToolCall = require_tool_call.ToolCall;

package/forge.mjs

@@ -1,5 +1,5 @@
-import { t as ToolRegistry } from "./tool_registry-CX3ofUh9.mjs";
-import { t as Tool } from "./tool-CsYuHhiS.mjs";
-import { i as ArtifactTool } from "./spooled_artifact-D-JrpY4W.mjs";
-import { t as ToolCall } from "./tool_call-Bs_Q5LOG.mjs";
+import { t as ToolRegistry } from "./tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "./tool-CRZSUcdP.mjs";
+import { i as ArtifactTool } from "./spooled_artifact-CWoKUDEm.mjs";
+import { t as ToolCall } from "./tool_call-BUeMuCc6.mjs";
 export { ArtifactTool, Tool, ToolCall, ToolRegistry };

package/guards.cjs

@@ -1,14 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Ble4zEEl.js");
 const require_exceptions = require("./exceptions-CitH5wZI.js");
-const require_tool_registry = require("./tool_registry-CKk5ooxm.js");
-const require_thought = require("./thought-DBNsR6l8.js");
-const require_tool = require("./tool-DIHzOZiV.js");
-const require_spooled_artifact = require("./spooled_artifact-CHvDDYGA.js");
-const require_tool_call = require("./tool_call-CkOVOhg0.js");
-const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-BYfPqFvk.js");
-const require_dispatch_runner = require("./dispatch_runner-CEFHXRJZ.js");
-const require_turn_runner = require("./turn_runner-D0qGIrRI.js");
+const require_tool_registry = require("./tool_registry-CtCQ4Xoz.js");
+const require_thought = require("./thought-BD6AkkOr.js");
+const require_tool = require("./tool-CX9vNHAw.js");
+const require_spooled_artifact = require("./spooled_artifact-B8gIIn9h.js");
+const require_tool_call = require("./tool_call--7ti-frB.js");
+const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-DQX0RCdI.js");
+const require_dispatch_runner = require("./dispatch_runner-CpuyATj1.js");
+const require_turn_runner = require("./turn_runner-BJTtAORU.js");
 //#region src/guards.ts
 /**
 * Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.

package/guards.mjs

@@ -1,12 +1,12 @@
 import { o as BaseException } from "./exceptions-BeWH2FwP.mjs";
-import { a as Tokenizable, c as isObject, o as isError, r as Registry, s as isInstanceOf, t as ToolRegistry } from "./tool_registry-CX3ofUh9.mjs";
-import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-D9IS11b5.mjs";
-import { t as Tool } from "./tool-CsYuHhiS.mjs";
-import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-D-JrpY4W.mjs";
-import { t as ToolCall } from "./tool_call-Bs_Q5LOG.mjs";
-import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-B4eWOfCX.mjs";
-import { n as DispatchContext, r as TurnContext, t as DispatchRunner } from "./dispatch_runner-uNtS-XSP.mjs";
-import { n as TurnGate, t as TurnRunner } from "./turn_runner-C1-mup84.mjs";
+import { a as Tokenizable, c as isObject, o as isError, r as Registry, s as isInstanceOf, t as ToolRegistry } from "./tool_registry-BGHg6KTq.mjs";
+import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-B_P8LiB6.mjs";
+import { t as Tool } from "./tool-CRZSUcdP.mjs";
+import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-CWoKUDEm.mjs";
+import { t as ToolCall } from "./tool_call-BUeMuCc6.mjs";
+import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-CNle4jXN.mjs";
+import { n as DispatchContext, r as TurnContext, t as DispatchRunner } from "./dispatch_runner-CDF3X0nv.mjs";
+import { n as TurnGate, t as TurnRunner } from "./turn_runner-C02LZHjt.mjs";
 //#region src/guards.ts
 /**
 * Runtime type guards for ADK primitives, contexts, runners, tools, and artifacts.

package/index.cjs

@@ -1,18 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./chunk-Ble4zEEl.js");
 const require_exceptions = require("./exceptions-CitH5wZI.js");
-const require_tool_registry = require("./tool_registry-CKk5ooxm.js");
-const require_runtime = require("./runtime-DyD9oQjH.js");
-const require_thought = require("./thought-DBNsR6l8.js");
-const require_tool = require("./tool-DIHzOZiV.js");
-const require_spooled_artifact = require("./spooled_artifact-CHvDDYGA.js");
-const require_common = require("./common-DuKWGTVd.js");
-const require_tool_call = require("./tool_call-CkOVOhg0.js");
-const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-BYfPqFvk.js");
-require("./exceptions.cjs");
-const require_dispatch_runner = require("./dispatch_runner-CEFHXRJZ.js");
+const require_tool_registry = require("./tool_registry-CtCQ4Xoz.js");
+const require_runtime = require("./runtime-MFFcJrRv.js");
+const require_thought = require("./thought-BD6AkkOr.js");
+const require_tool = require("./tool-CX9vNHAw.js");
+const require_spooled_artifact = require("./spooled_artifact-B8gIIn9h.js");
+const require_common = require("./common-D_e5zYsG.js");
+const require_tool_call = require("./tool_call--7ti-frB.js");
+const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-DQX0RCdI.js");
+const require_dispatch_runner = require("./dispatch_runner-CpuyATj1.js");
 require("./dispatch_runner.cjs");
-const require_turn_runner = require("./turn_runner-D0qGIrRI.js");
+require("./exceptions.cjs");
+const require_turn_runner = require("./turn_runner-BJTtAORU.js");
 const require_guards = require("./guards.cjs");
 require("./turn_runner.cjs");
 //#region src/index.ts
@@ -26,7 +26,7 @@ require("./turn_runner.cjs");
 *
 * @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-e04b0eba";
+var version = "0.1.0-master-d3e80e7a";
 //#endregion
 exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
 exports.DispatchRunner = require_dispatch_runner.DispatchRunner;

package/index.mjs

@@ -1,16 +1,16 @@
 import { n as ValidationException } from "./exceptions-BeWH2FwP.mjs";
-import { a as Tokenizable, c as isObject, i as TokenEncoding, o as isError, r as Registry, s as isInstanceOf, t as ToolRegistry } from "./tool_registry-CX3ofUh9.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, 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, 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, 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-CDIZwCT0.mjs";
-import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-D9IS11b5.mjs";
-import { t as Tool } from "./tool-CsYuHhiS.mjs";
-import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-D-JrpY4W.mjs";
-import { n as fromWebFile, o as Retrievable, r as inMemoryMediaReader, t as fromFetch } from "./common-ClCHam5-.mjs";
-import { a as mediaReaderSchema, i as implementsMediaReader, n as Media, r as isMedia, t as ToolCall } from "./tool_call-Bs_Q5LOG.mjs";
-import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-B4eWOfCX.mjs";
-import "./exceptions.mjs";
-import { t as DispatchRunner } from "./dispatch_runner-uNtS-XSP.mjs";
+import { a as Tokenizable, c as isObject, i as TokenEncoding, o as isError, r as Registry, s as isInstanceOf, t as ToolRegistry } from "./tool_registry-BGHg6KTq.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, 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, 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, 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-j92CNi5z.mjs";
+import { i as Identity, n as Message, r as Memory, t as Thought } from "./thought-B_P8LiB6.mjs";
+import { t as Tool } from "./tool-CRZSUcdP.mjs";
+import { i as ArtifactTool, r as implementsSpoolReader, t as SpooledArtifact } from "./spooled_artifact-CWoKUDEm.mjs";
+import { n as fromWebFile, o as Retrievable, r as inMemoryMediaReader, t as fromFetch } from "./common-lMrnzoyn.mjs";
+import { a as mediaReaderSchema, i as implementsMediaReader, n as Media, r as isMedia, t as ToolCall } from "./tool_call-BUeMuCc6.mjs";
+import { n as SpooledJsonArtifact, t as SpooledMarkdownArtifact } from "./spooled_markdown_artifact-CNle4jXN.mjs";
+import { t as DispatchRunner } from "./dispatch_runner-CDF3X0nv.mjs";
 import "./dispatch_runner.mjs";
-import { t as TurnRunner } from "./turn_runner-C1-mup84.mjs";
+import "./exceptions.mjs";
+import { t as TurnRunner } from "./turn_runner-C02LZHjt.mjs";
 import { isArtifactTool, isBaseException, isDispatchContext, isDispatchRunner, isIdentity, isMemory, isMessage, isRegistry, isSpooledArtifact, isSpooledArtifactConstructor, isSpooledJsonArtifact, isSpooledMarkdownArtifact, isThought, isTokenizable, isTool, isToolCall, isToolRegistry, isTurnContext, isTurnGate, isTurnRunner } from "./guards.mjs";
 import "./turn_runner.mjs";
 //#region src/index.ts
@@ -24,7 +24,7 @@ import "./turn_runner.mjs";
 *
 * @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-e04b0eba";
+var version = "0.1.0-master-d3e80e7a";
 //#endregion
 export { ArtifactTool, DispatchRunner, E_DISPATCH_PIPELINE_ERROR, E_INPUT_PIPELINE_ERROR, E_INVALID_INITIAL_IDENTITY_VALUE, E_INVALID_INITIAL_MEMORY_VALUE, E_INVALID_INITIAL_MESSAGE_VALUE, E_INVALID_INITIAL_REGISTRY_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_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, Identity, Media, Memory, Message, Registry, Retrievable, SpooledArtifact, SpooledJsonArtifact, SpooledMarkdownArtifact, Thought, TokenEncoding, Tokenizable, Tool, ToolCall, ToolRegistry, TurnRunner, ValidationException, fromFetch, fromWebFile, implementsMediaReader, implementsSpoolReader, inMemoryMediaReader, isArtifactTool, isBaseException, isDispatchContext, isDispatchRunner, isError, isIdentity, isInstanceOf, isMedia, isMemory, isMessage, isObject, isRegistry, isSpooledArtifact, isSpooledArtifactConstructor, isSpooledJsonArtifact, isSpooledMarkdownArtifact, isThought, isTokenizable, isTool, isToolCall, isToolRegistry, isTurnContext, isTurnGate, isTurnRunner, mediaReaderSchema, version };
 

package/lib/exceptions/runtime.d.ts

@@ -5,9 +5,14 @@
  * @remarks
  * Marked fatal — a misconfigured runner must not be allowed to execute turns.
  *
+ * The single printf argument carries the validator's field-level detail (e.g.
+ * `"storeMediaBytesCallback is required"`) so a misconfiguration names the offending field
+ * instead of failing opaquely. The underlying `ValidationError` is also attached on `cause`.
+ *
  * @group Turn Runner Construction
  */
 export declare const E_INVALID_TURN_RUNNER_CONFIG: import("../utils/exceptions").CreatedException<[
+    string
 ]>;
 /**
  * Thrown by {@link @nhtio/adk!TurnRunner} when the {@link @nhtio/adk!TurnContext} supplied to `run` fails schema

package/lib/types/turn_runner.d.ts

@@ -45,13 +45,23 @@ export interface TurnStreamableContent {
  * execution fails, `isError` is `true` and `results` contains the error detail.
  */
 export interface TurnToolCallContent {
-    /** Stable identifier for this tool call; correlates the initial request with its result. */
+    /**
+     * Stable stream id for this tool call; ties the initial request to its result on **this** bus
+     * (the announce emission and the completion emission share it). This is the model/stream id, not
+     * a cross-bus key — to correlate with the observability `toolExecution*` events, use `checksum`.
+     */
     id: string;
     /** Name of the tool the model has requested. */
     tool: string;
     /** Arguments the model supplied for the tool call. */
     args: unknown;
-    /** Integrity checksum over `tool` and `args`; can be used to detect tampering before execution. */
+    /**
+     * `sha256({ tool, args })` over the raw arguments. Doubles as the **cross-bus join key**: equal to
+     * {@link ToolExecutionStartEvent.callId} / {@link ToolExecutionEndEvent.callId} and to
+     * {@link @nhtio/adk!ToolCall.checksum}. Collides by design for identical `(tool, args)` within a
+     * turn — that is what {@link @nhtio/adk!DispatchContext.toolCallCount} counts — so order or
+     * disambiguate repeated calls by `createdAt` / `updatedAt`, not by `checksum` alone.
+     */
     checksum: string;
     /** Timestamp when this tool call was first emitted. */
     createdAt: DateTime;
@@ -109,16 +119,22 @@ export interface TurnEndEvent {
  *
  * @remarks
  * Fired after arg validation passes and immediately before the handler is called.
- * `callId` correlates the event with the {@link @nhtio/adk!ToolCall} record if one is being tracked. Fires
- * for both {@link @nhtio/adk!Tool} and
- * {@link @nhtio/adk!ArtifactTool} invocations — the payload is identical.
+ * `callId` is the cross-bus join key — equal to {@link TurnToolCallContent.checksum} and
+ * {@link @nhtio/adk!ToolCall.checksum}, **not** {@link @nhtio/adk!ToolCall.id}. Fires for both
+ * {@link @nhtio/adk!Tool} and {@link @nhtio/adk!ArtifactTool} invocations — the payload is identical.
  */
 export interface ToolExecutionStartEvent {
     /** Name of the tool being executed. */
     toolName: string;
     /** ID of the turn in which the tool is being executed. */
     turnId: string;
-    /** Correlates with the associated ToolCall id, if known. Empty string when not provided. */
+    /**
+     * Cross-bus join key: `sha256({ tool, args })`, identical to {@link TurnToolCallContent.checksum}
+     * and {@link @nhtio/adk!ToolCall.checksum}. This is **not** {@link @nhtio/adk!ToolCall.id}. It
+     * collides by design for identical `(tool, args)` within a turn — that is what
+     * {@link @nhtio/adk!DispatchContext.toolCallCount} counts. Order or disambiguate repeated calls by
+     * `startedAt`. Empty string when not provided.
+     */
     callId: string;
     /** The validated arguments that will be passed to the handler. */
     args: unknown;
@@ -130,16 +146,22 @@ export interface ToolExecutionStartEvent {
  *
  * @remarks
  * Fired after the handler returns or throws. When `isError` is `true`, the handler threw and the
- * error has been wrapped in {@link @nhtio/adk!E_TOOL_DOWNSTREAM_ERROR}. Fires for both
- * {@link @nhtio/adk!Tool} and
- * {@link @nhtio/adk!ArtifactTool} invocations — the payload is identical.
+ * error has been wrapped in {@link @nhtio/adk!E_TOOL_DOWNSTREAM_ERROR}. `callId` carries the same
+ * cross-bus join key as {@link ToolExecutionStartEvent.callId}. Fires for both
+ * {@link @nhtio/adk!Tool} and {@link @nhtio/adk!ArtifactTool} invocations — the payload is identical.
  */
 export interface ToolExecutionEndEvent {
     /** Name of the tool that was executed. */
     toolName: string;
     /** ID of the turn in which the tool was executed. */
     turnId: string;
-    /** Correlates with the associated ToolCall id, if known. Empty string when not provided. */
+    /**
+     * Cross-bus join key: `sha256({ tool, args })`, identical to {@link TurnToolCallContent.checksum}
+     * and {@link @nhtio/adk!ToolCall.checksum}. This is **not** {@link @nhtio/adk!ToolCall.id}. It
+     * collides by design for identical `(tool, args)` within a turn — that is what
+     * {@link @nhtio/adk!DispatchContext.toolCallCount} counts. Order or disambiguate repeated calls by
+     * `startedAt` / `endedAt`. Empty string when not provided.
+     */
     callId: string;
     /** When execution started. */
     startedAt: DateTime;

package/lib/utils/retry.cjs

@@ -0,0 +1,107 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+//#region src/lib/utils/retry.ts
+/**
+* Exponential backoff with a ceiling: `min(baseDelayMs * 2^(attempt-1), maxDelayMs)`.
+*
+* @param attempt - 1-based attempt number.
+* @param cfg - Carries `baseDelayMs` (default 500) and `maxDelayMs` (default 30_000).
+* @returns The (un-jittered) delay in ms.
+*/
+var computeBackoff = (attempt, cfg) => {
+	const base = cfg.baseDelayMs ?? 500;
+	const max = cfg.maxDelayMs ?? 3e4;
+	return Math.min(base * Math.pow(2, attempt - 1), max);
+};
+/**
+* Abort-aware jittered sleep used for retry backoff.
+*
+* @remarks
+* Resolves (never rejects) the instant `signal` aborts, so an aborted caller does not stay parked
+* in a backoff delay — the caller's retry loop re-checks abort state immediately after and bails.
+* The timer and the abort listener are both torn down on whichever fires first, so nothing leaks.
+*
+* @param ms - Base delay in ms; jittered by ±10%.
+* @param signal - Optional abort signal that short-circuits the sleep.
+*/
+var sleepWithJitter = (ms, signal) => {
+	const jittered = ms * (.9 + Math.random() * .2);
+	return new Promise((resolve) => {
+		if (signal?.aborted) {
+			resolve();
+			return;
+		}
+		let onAbort;
+		const timer = setTimeout(() => {
+			if (onAbort && signal) signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, jittered);
+		if (signal) {
+			onAbort = () => {
+				clearTimeout(timer);
+				resolve();
+			};
+			signal.addEventListener("abort", onAbort, { once: true });
+		}
+	});
+};
+/**
+* Parses an HTTP `Retry-After` header value (delta-seconds or HTTP-date) into milliseconds.
+*
+* @param raw - The header value.
+* @returns Milliseconds to wait, or `0` when the value cannot be parsed or is in the past.
+*/
+var parseRetryAfter = (raw) => {
+	const asNum = Number(raw);
+	if (Number.isFinite(asNum)) return asNum * 1e3;
+	const asDate = Date.parse(raw);
+	if (Number.isFinite(asDate)) return Math.max(0, asDate - Date.now());
+	return 0;
+};
+/**
+* Combines several abort signals into one.
+*
+* @remarks
+* Returns the linked signal plus a `dispose` that detaches any listeners the fallback path
+* attached, so repeated links on a long-lived signal (one per retry attempt) do not accumulate
+* listeners. The native `AbortSignal.any` path self-manages its listeners, so `dispose` is a no-op
+* there.
+*
+* @param signals - The signals to combine.
+* @returns The linked signal and a `dispose` to tear down fallback listeners.
+*/
+var linkAbortSignals = (signals) => {
+	const anyFn = AbortSignal.any;
+	if (typeof anyFn === "function") return {
+		signal: anyFn(signals),
+		dispose: () => {}
+	};
+	const ctrl = new AbortController();
+	const links = [];
+	for (const sig of signals) {
+		if (sig.aborted) {
+			ctrl.abort();
+			break;
+		}
+		const handler = () => ctrl.abort();
+		sig.addEventListener("abort", handler, { once: true });
+		links.push({
+			sig,
+			handler
+		});
+	}
+	return {
+		signal: ctrl.signal,
+		dispose: () => {
+			for (const { sig, handler } of links) sig.removeEventListener("abort", handler);
+			links.length = 0;
+		}
+	};
+};
+//#endregion
+exports.computeBackoff = computeBackoff;
+exports.linkAbortSignals = linkAbortSignals;
+exports.parseRetryAfter = parseRetryAfter;
+exports.sleepWithJitter = sleepWithJitter;
+
+//# sourceMappingURL=retry.cjs.map

package/lib/utils/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","names":[],"sources":["../../../src/lib/utils/retry.ts"],"sourcesContent":["/**\n * Environment-neutral retry/backoff/timeout primitives shared across HTTP-backed batteries.\n *\n * @module @nhtio/adk/lib/utils/retry\n *\n * @remarks\n * These are pure helpers — no DOM, no Node built-ins, only `setTimeout`, `AbortController`, and\n * `AbortSignal`, all of which exist in every target runtime (Node, browser, edge, workers). They\n * are shared (not duplicated) by the OpenAI Chat Completions battery and the OpenAI Embeddings\n * battery so retry behavior stays identical across the bundled batteries. The bundler inlines this\n * module into each consumer, so sharing introduces no build coupling.\n */\n\n/**\n * Minimal backoff configuration shape. Any retry config carrying `baseDelayMs`/`maxDelayMs`\n * satisfies it structurally, so batteries can pass their own richer config objects directly.\n */\nexport interface BackoffConfig {\n  baseDelayMs?: number\n  maxDelayMs?: number\n}\n\n/**\n * Exponential backoff with a ceiling: `min(baseDelayMs * 2^(attempt-1), maxDelayMs)`.\n *\n * @param attempt - 1-based attempt number.\n * @param cfg - Carries `baseDelayMs` (default 500) and `maxDelayMs` (default 30_000).\n * @returns The (un-jittered) delay in ms.\n */\nexport const computeBackoff = (attempt: number, cfg: BackoffConfig): number => {\n  const base = cfg.baseDelayMs ?? 500\n  const max = cfg.maxDelayMs ?? 30_000\n  return Math.min(base * Math.pow(2, attempt - 1), max)\n}\n\n/**\n * Abort-aware jittered sleep used for retry backoff.\n *\n * @remarks\n * Resolves (never rejects) the instant `signal` aborts, so an aborted caller does not stay parked\n * in a backoff delay — the caller's retry loop re-checks abort state immediately after and bails.\n * The timer and the abort listener are both torn down on whichever fires first, so nothing leaks.\n *\n * @param ms - Base delay in ms; jittered by ±10%.\n * @param signal - Optional abort signal that short-circuits the sleep.\n */\nexport const sleepWithJitter = (ms: number, signal?: AbortSignal): Promise<void> => {\n  const jittered = ms * (0.9 + Math.random() * 0.2)\n  return new Promise((resolve) => {\n    if (signal?.aborted) {\n      resolve()\n      return\n    }\n    let onAbort: (() => void) | undefined\n    const timer = setTimeout(() => {\n      if (onAbort && signal) signal.removeEventListener('abort', onAbort)\n      resolve()\n    }, jittered)\n    if (signal) {\n      onAbort = () => {\n        clearTimeout(timer)\n        resolve()\n      }\n      signal.addEventListener('abort', onAbort, { once: true })\n    }\n  })\n}\n\n/**\n * Parses an HTTP `Retry-After` header value (delta-seconds or HTTP-date) into milliseconds.\n *\n * @param raw - The header value.\n * @returns Milliseconds to wait, or `0` when the value cannot be parsed or is in the past.\n */\nexport const parseRetryAfter = (raw: string): number => {\n  const asNum = Number(raw)\n  if (Number.isFinite(asNum)) return asNum * 1000\n  const asDate = Date.parse(raw)\n  if (Number.isFinite(asDate)) return Math.max(0, asDate - Date.now())\n  return 0\n}\n\n/**\n * Combines several abort signals into one.\n *\n * @remarks\n * Returns the linked signal plus a `dispose` that detaches any listeners the fallback path\n * attached, so repeated links on a long-lived signal (one per retry attempt) do not accumulate\n * listeners. The native `AbortSignal.any` path self-manages its listeners, so `dispose` is a no-op\n * there.\n *\n * @param signals - The signals to combine.\n * @returns The linked signal and a `dispose` to tear down fallback listeners.\n */\nexport const linkAbortSignals = (\n  signals: ReadonlyArray<AbortSignal>\n): { signal: AbortSignal; dispose: () => void } => {\n  const anyFn = (AbortSignal as unknown as { any?: (sigs: AbortSignal[]) => AbortSignal }).any\n  if (typeof anyFn === 'function') {\n    return { signal: anyFn(signals as AbortSignal[]), dispose: () => {} }\n  }\n  // Fallback for older runtimes: hand-link via a fresh controller.\n  const ctrl = new AbortController()\n  const links: Array<{ sig: AbortSignal; handler: () => void }> = []\n  for (const sig of signals) {\n    if (sig.aborted) {\n      ctrl.abort()\n      break\n    }\n    const handler = () => ctrl.abort()\n    sig.addEventListener('abort', handler, { once: true })\n    links.push({ sig, handler })\n  }\n  return {\n    signal: ctrl.signal,\n    dispose: () => {\n      for (const { sig, handler } of links) sig.removeEventListener('abort', handler)\n      links.length = 0\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;AA6BA,IAAa,kBAAkB,SAAiB,QAA+B;CAC7E,MAAM,OAAO,IAAI,eAAe;CAChC,MAAM,MAAM,IAAI,cAAc;CAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,IAAI,GAAG,UAAU,CAAC,GAAG,GAAG;AACtD;;;;;;;;;;;;AAaA,IAAa,mBAAmB,IAAY,WAAwC;CAClF,MAAM,WAAW,MAAM,KAAM,KAAK,OAAO,IAAI;CAC7C,OAAO,IAAI,SAAS,YAAY;EAC9B,IAAI,QAAQ,SAAS;GACnB,QAAQ;GACR;EACF;EACA,IAAI;EACJ,MAAM,QAAQ,iBAAiB;GAC7B,IAAI,WAAW,QAAQ,OAAO,oBAAoB,SAAS,OAAO;GAClE,QAAQ;EACV,GAAG,QAAQ;EACX,IAAI,QAAQ;GACV,gBAAgB;IACd,aAAa,KAAK;IAClB,QAAQ;GACV;GACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EAC1D;CACF,CAAC;AACH;;;;;;;AAQA,IAAa,mBAAmB,QAAwB;CACtD,MAAM,QAAQ,OAAO,GAAG;CACxB,IAAI,OAAO,SAAS,KAAK,GAAG,OAAO,QAAQ;CAC3C,MAAM,SAAS,KAAK,MAAM,GAAG;CAC7B,IAAI,OAAO,SAAS,MAAM,GAAG,OAAO,KAAK,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;CACnE,OAAO;AACT;;;;;;;;;;;;;AAcA,IAAa,oBACX,YACiD;CACjD,MAAM,QAAS,YAA0E;CACzF,IAAI,OAAO,UAAU,YACnB,OAAO;EAAE,QAAQ,MAAM,OAAwB;EAAG,eAAe,CAAC;CAAE;CAGtE,MAAM,OAAO,IAAI,gBAAgB;CACjC,MAAM,QAA0D,CAAC;CACjE,KAAK,MAAM,OAAO,SAAS;EACzB,IAAI,IAAI,SAAS;GACf,KAAK,MAAM;GACX;EACF;EACA,MAAM,gBAAgB,KAAK,MAAM;EACjC,IAAI,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACrD,MAAM,KAAK;GAAE;GAAK;EAAQ,CAAC;CAC7B;CACA,OAAO;EACL,QAAQ,KAAK;EACb,eAAe;GACb,KAAK,MAAM,EAAE,KAAK,aAAa,OAAO,IAAI,oBAAoB,SAAS,OAAO;GAC9E,MAAM,SAAS;EACjB;CACF;AACF"}

package/lib/utils/retry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Environment-neutral retry/backoff/timeout primitives shared across HTTP-backed batteries.
+ *
+ * @module @nhtio/adk/lib/utils/retry
+ *
+ * @remarks
+ * These are pure helpers — no DOM, no Node built-ins, only `setTimeout`, `AbortController`, and
+ * `AbortSignal`, all of which exist in every target runtime (Node, browser, edge, workers). They
+ * are shared (not duplicated) by the OpenAI Chat Completions battery and the OpenAI Embeddings
+ * battery so retry behavior stays identical across the bundled batteries. The bundler inlines this
+ * module into each consumer, so sharing introduces no build coupling.
+ */
+/**
+ * Minimal backoff configuration shape. Any retry config carrying `baseDelayMs`/`maxDelayMs`
+ * satisfies it structurally, so batteries can pass their own richer config objects directly.
+ */
+export interface BackoffConfig {
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+/**
+ * Exponential backoff with a ceiling: `min(baseDelayMs * 2^(attempt-1), maxDelayMs)`.
+ *
+ * @param attempt - 1-based attempt number.
+ * @param cfg - Carries `baseDelayMs` (default 500) and `maxDelayMs` (default 30_000).
+ * @returns The (un-jittered) delay in ms.
+ */
+export declare const computeBackoff: (attempt: number, cfg: BackoffConfig) => number;
+/**
+ * Abort-aware jittered sleep used for retry backoff.
+ *
+ * @remarks
+ * Resolves (never rejects) the instant `signal` aborts, so an aborted caller does not stay parked
+ * in a backoff delay — the caller's retry loop re-checks abort state immediately after and bails.
+ * The timer and the abort listener are both torn down on whichever fires first, so nothing leaks.
+ *
+ * @param ms - Base delay in ms; jittered by ±10%.
+ * @param signal - Optional abort signal that short-circuits the sleep.
+ */
+export declare const sleepWithJitter: (ms: number, signal?: AbortSignal) => Promise<void>;
+/**
+ * Parses an HTTP `Retry-After` header value (delta-seconds or HTTP-date) into milliseconds.
+ *
+ * @param raw - The header value.
+ * @returns Milliseconds to wait, or `0` when the value cannot be parsed or is in the past.
+ */
+export declare const parseRetryAfter: (raw: string) => number;
+/**
+ * Combines several abort signals into one.
+ *
+ * @remarks
+ * Returns the linked signal plus a `dispose` that detaches any listeners the fallback path
+ * attached, so repeated links on a long-lived signal (one per retry attempt) do not accumulate
+ * listeners. The native `AbortSignal.any` path self-manages its listeners, so `dispose` is a no-op
+ * there.
+ *
+ * @param signals - The signals to combine.
+ * @returns The linked signal and a `dispose` to tear down fallback listeners.
+ */
+export declare const linkAbortSignals: (signals: ReadonlyArray<AbortSignal>) => {
+    signal: AbortSignal;
+    dispose: () => void;
+};

package/lib/utils/retry.mjs

@@ -0,0 +1,102 @@
+//#region src/lib/utils/retry.ts
+/**
+* Exponential backoff with a ceiling: `min(baseDelayMs * 2^(attempt-1), maxDelayMs)`.
+*
+* @param attempt - 1-based attempt number.
+* @param cfg - Carries `baseDelayMs` (default 500) and `maxDelayMs` (default 30_000).
+* @returns The (un-jittered) delay in ms.
+*/
+var computeBackoff = (attempt, cfg) => {
+	const base = cfg.baseDelayMs ?? 500;
+	const max = cfg.maxDelayMs ?? 3e4;
+	return Math.min(base * Math.pow(2, attempt - 1), max);
+};
+/**
+* Abort-aware jittered sleep used for retry backoff.
+*
+* @remarks
+* Resolves (never rejects) the instant `signal` aborts, so an aborted caller does not stay parked
+* in a backoff delay — the caller's retry loop re-checks abort state immediately after and bails.
+* The timer and the abort listener are both torn down on whichever fires first, so nothing leaks.
+*
+* @param ms - Base delay in ms; jittered by ±10%.
+* @param signal - Optional abort signal that short-circuits the sleep.
+*/
+var sleepWithJitter = (ms, signal) => {
+	const jittered = ms * (.9 + Math.random() * .2);
+	return new Promise((resolve) => {
+		if (signal?.aborted) {
+			resolve();
+			return;
+		}
+		let onAbort;
+		const timer = setTimeout(() => {
+			if (onAbort && signal) signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, jittered);
+		if (signal) {
+			onAbort = () => {
+				clearTimeout(timer);
+				resolve();
+			};
+			signal.addEventListener("abort", onAbort, { once: true });
+		}
+	});
+};
+/**
+* Parses an HTTP `Retry-After` header value (delta-seconds or HTTP-date) into milliseconds.
+*
+* @param raw - The header value.
+* @returns Milliseconds to wait, or `0` when the value cannot be parsed or is in the past.
+*/
+var parseRetryAfter = (raw) => {
+	const asNum = Number(raw);
+	if (Number.isFinite(asNum)) return asNum * 1e3;
+	const asDate = Date.parse(raw);
+	if (Number.isFinite(asDate)) return Math.max(0, asDate - Date.now());
+	return 0;
+};
+/**
+* Combines several abort signals into one.
+*
+* @remarks
+* Returns the linked signal plus a `dispose` that detaches any listeners the fallback path
+* attached, so repeated links on a long-lived signal (one per retry attempt) do not accumulate
+* listeners. The native `AbortSignal.any` path self-manages its listeners, so `dispose` is a no-op
+* there.
+*
+* @param signals - The signals to combine.
+* @returns The linked signal and a `dispose` to tear down fallback listeners.
+*/
+var linkAbortSignals = (signals) => {
+	const anyFn = AbortSignal.any;
+	if (typeof anyFn === "function") return {
+		signal: anyFn(signals),
+		dispose: () => {}
+	};
+	const ctrl = new AbortController();
+	const links = [];
+	for (const sig of signals) {
+		if (sig.aborted) {
+			ctrl.abort();
+			break;
+		}
+		const handler = () => ctrl.abort();
+		sig.addEventListener("abort", handler, { once: true });
+		links.push({
+			sig,
+			handler
+		});
+	}
+	return {
+		signal: ctrl.signal,
+		dispose: () => {
+			for (const { sig, handler } of links) sig.removeEventListener("abort", handler);
+			links.length = 0;
+		}
+	};
+};
+//#endregion
+export { computeBackoff, linkAbortSignals, parseRetryAfter, sleepWithJitter };
+
+//# sourceMappingURL=retry.mjs.map

package/lib/utils/retry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.mjs","names":[],"sources":["../../../src/lib/utils/retry.ts"],"sourcesContent":["/**\n * Environment-neutral retry/backoff/timeout primitives shared across HTTP-backed batteries.\n *\n * @module @nhtio/adk/lib/utils/retry\n *\n * @remarks\n * These are pure helpers — no DOM, no Node built-ins, only `setTimeout`, `AbortController`, and\n * `AbortSignal`, all of which exist in every target runtime (Node, browser, edge, workers). They\n * are shared (not duplicated) by the OpenAI Chat Completions battery and the OpenAI Embeddings\n * battery so retry behavior stays identical across the bundled batteries. The bundler inlines this\n * module into each consumer, so sharing introduces no build coupling.\n */\n\n/**\n * Minimal backoff configuration shape. Any retry config carrying `baseDelayMs`/`maxDelayMs`\n * satisfies it structurally, so batteries can pass their own richer config objects directly.\n */\nexport interface BackoffConfig {\n  baseDelayMs?: number\n  maxDelayMs?: number\n}\n\n/**\n * Exponential backoff with a ceiling: `min(baseDelayMs * 2^(attempt-1), maxDelayMs)`.\n *\n * @param attempt - 1-based attempt number.\n * @param cfg - Carries `baseDelayMs` (default 500) and `maxDelayMs` (default 30_000).\n * @returns The (un-jittered) delay in ms.\n */\nexport const computeBackoff = (attempt: number, cfg: BackoffConfig): number => {\n  const base = cfg.baseDelayMs ?? 500\n  const max = cfg.maxDelayMs ?? 30_000\n  return Math.min(base * Math.pow(2, attempt - 1), max)\n}\n\n/**\n * Abort-aware jittered sleep used for retry backoff.\n *\n * @remarks\n * Resolves (never rejects) the instant `signal` aborts, so an aborted caller does not stay parked\n * in a backoff delay — the caller's retry loop re-checks abort state immediately after and bails.\n * The timer and the abort listener are both torn down on whichever fires first, so nothing leaks.\n *\n * @param ms - Base delay in ms; jittered by ±10%.\n * @param signal - Optional abort signal that short-circuits the sleep.\n */\nexport const sleepWithJitter = (ms: number, signal?: AbortSignal): Promise<void> => {\n  const jittered = ms * (0.9 + Math.random() * 0.2)\n  return new Promise((resolve) => {\n    if (signal?.aborted) {\n      resolve()\n      return\n    }\n    let onAbort: (() => void) | undefined\n    const timer = setTimeout(() => {\n      if (onAbort && signal) signal.removeEventListener('abort', onAbort)\n      resolve()\n    }, jittered)\n    if (signal) {\n      onAbort = () => {\n        clearTimeout(timer)\n        resolve()\n      }\n      signal.addEventListener('abort', onAbort, { once: true })\n    }\n  })\n}\n\n/**\n * Parses an HTTP `Retry-After` header value (delta-seconds or HTTP-date) into milliseconds.\n *\n * @param raw - The header value.\n * @returns Milliseconds to wait, or `0` when the value cannot be parsed or is in the past.\n */\nexport const parseRetryAfter = (raw: string): number => {\n  const asNum = Number(raw)\n  if (Number.isFinite(asNum)) return asNum * 1000\n  const asDate = Date.parse(raw)\n  if (Number.isFinite(asDate)) return Math.max(0, asDate - Date.now())\n  return 0\n}\n\n/**\n * Combines several abort signals into one.\n *\n * @remarks\n * Returns the linked signal plus a `dispose` that detaches any listeners the fallback path\n * attached, so repeated links on a long-lived signal (one per retry attempt) do not accumulate\n * listeners. The native `AbortSignal.any` path self-manages its listeners, so `dispose` is a no-op\n * there.\n *\n * @param signals - The signals to combine.\n * @returns The linked signal and a `dispose` to tear down fallback listeners.\n */\nexport const linkAbortSignals = (\n  signals: ReadonlyArray<AbortSignal>\n): { signal: AbortSignal; dispose: () => void } => {\n  const anyFn = (AbortSignal as unknown as { any?: (sigs: AbortSignal[]) => AbortSignal }).any\n  if (typeof anyFn === 'function') {\n    return { signal: anyFn(signals as AbortSignal[]), dispose: () => {} }\n  }\n  // Fallback for older runtimes: hand-link via a fresh controller.\n  const ctrl = new AbortController()\n  const links: Array<{ sig: AbortSignal; handler: () => void }> = []\n  for (const sig of signals) {\n    if (sig.aborted) {\n      ctrl.abort()\n      break\n    }\n    const handler = () => ctrl.abort()\n    sig.addEventListener('abort', handler, { once: true })\n    links.push({ sig, handler })\n  }\n  return {\n    signal: ctrl.signal,\n    dispose: () => {\n      for (const { sig, handler } of links) sig.removeEventListener('abort', handler)\n      links.length = 0\n    },\n  }\n}\n"],"mappings":";;;;;;;;AA6BA,IAAa,kBAAkB,SAAiB,QAA+B;CAC7E,MAAM,OAAO,IAAI,eAAe;CAChC,MAAM,MAAM,IAAI,cAAc;CAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,IAAI,GAAG,UAAU,CAAC,GAAG,GAAG;AACtD;;;;;;;;;;;;AAaA,IAAa,mBAAmB,IAAY,WAAwC;CAClF,MAAM,WAAW,MAAM,KAAM,KAAK,OAAO,IAAI;CAC7C,OAAO,IAAI,SAAS,YAAY;EAC9B,IAAI,QAAQ,SAAS;GACnB,QAAQ;GACR;EACF;EACA,IAAI;EACJ,MAAM,QAAQ,iBAAiB;GAC7B,IAAI,WAAW,QAAQ,OAAO,oBAAoB,SAAS,OAAO;GAClE,QAAQ;EACV,GAAG,QAAQ;EACX,IAAI,QAAQ;GACV,gBAAgB;IACd,aAAa,KAAK;IAClB,QAAQ;GACV;GACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EAC1D;CACF,CAAC;AACH;;;;;;;AAQA,IAAa,mBAAmB,QAAwB;CACtD,MAAM,QAAQ,OAAO,GAAG;CACxB,IAAI,OAAO,SAAS,KAAK,GAAG,OAAO,QAAQ;CAC3C,MAAM,SAAS,KAAK,MAAM,GAAG;CAC7B,IAAI,OAAO,SAAS,MAAM,GAAG,OAAO,KAAK,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;CACnE,OAAO;AACT;;;;;;;;;;;;;AAcA,IAAa,oBACX,YACiD;CACjD,MAAM,QAAS,YAA0E;CACzF,IAAI,OAAO,UAAU,YACnB,OAAO;EAAE,QAAQ,MAAM,OAAwB;EAAG,eAAe,CAAC;CAAE;CAGtE,MAAM,OAAO,IAAI,gBAAgB;CACjC,MAAM,QAA0D,CAAC;CACjE,KAAK,MAAM,OAAO,SAAS;EACzB,IAAI,IAAI,SAAS;GACf,KAAK,MAAM;GACX;EACF;EACA,MAAM,gBAAgB,KAAK,MAAM;EACjC,IAAI,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACrD,MAAM,KAAK;GAAE;GAAK;EAAQ,CAAC;CAC7B;CACA,OAAO;EACL,QAAQ,KAAK;EACb,eAAe;GACb,KAAK,MAAM,EAAE,KAAK,aAAa,OAAO,IAAI,oBAAoB,SAAS,OAAO;GAC9E,MAAM,SAAS;EACjB;CACF;AACF"}