@nhtio/adk/lib/utils/retry

Environment-neutral retry/backoff/timeout primitives shared across HTTP-backed batteries.

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.

Interfaces

Interface	Description
BackoffConfig	Minimal backoff configuration shape. Any retry config carrying baseDelayMs/maxDelayMs satisfies it structurally, so batteries can pass their own richer config objects directly.

Functions

Function	Description
computeBackoff	Exponential backoff with a ceiling: min(baseDelayMs * 2^(attempt-1), maxDelayMs).
linkAbortSignals	Combines several abort signals into one.
parseRetryAfter	Parses an HTTP Retry-After header value (delta-seconds or HTTP-date) into milliseconds.
sleepWithJitter	Abort-aware jittered sleep used for retry backoff.