@mcp-abap-adt/llm-agent 22.1.0 → 23.0.0

package/dist/llm/throttle.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Shared rate-limit handling for every LLM provider.
+ *
+ * None of the providers handled HTTP 429 (issue #282). Each one let the status
+ * collapse into an error message, so consumers were reduced to matching the
+ * substring "429" in prose to decide whether to retry.
+ *
+ * The policy lives here rather than in a provider because the providers differ
+ * in SDK but not in the shape of the problem: a shared quota, a documented
+ * `Retry-After`, and a herd of concurrent callers that will all rediscover the
+ * same limit unless something holds them back together.
+ *
+ * SAP AI Core states the rules this implements
+ * (help.sap.com, Rate Limit Management):
+ *
+ *   Do not retry immediately after a 429. Use exponential backoff with jitter
+ *   to prevent thundering-herd behavior. If the response includes a
+ *   `Retry-After` header, use its value as the wait interval. Limit retries by
+ *   using a maximum cap (for example, 5 retries or 60 seconds total wait).
+ *
+ * The same rules fit Anthropic and OpenAI, which return 429 with `Retry-After`
+ * as ordinary HTTP. Ollama is local and never rate-limited; it simply never
+ * enters this path.
+ */
+import { type ThrottlePolicy } from '../interfaces/throttle-strategy.js';
+/** An error annotated by this module, so consumers read a fact instead of prose. */
+export interface ThrottledError extends Error {
+    throttled: true;
+    /** What the server asked for, when it asked. */
+    retryAfterSeconds?: number;
+    /** How many attempts were spent before giving up. */
+    attempts: number;
+    /**
+     * Which cap ended it, when it ended here. `attempts` and `budget` are fixed
+     * by opposite settings, so a consumer that cannot tell them apart cannot act
+     * on either. `gate` means the pause was already longer than the budget and no
+     * request was sent at all.
+     */
+    reason?: 'attempts' | 'budget' | 'gate';
+}
+export declare function isThrottledError(e: unknown): e is ThrottledError;
+/**
+ * One shared pause per quota.
+ *
+ * A rate limit belongs to the quota, not to the request that happened to
+ * discover it. When one call is told to wait, every other call against the same
+ * quota is already over the limit too — letting each find that out for itself
+ * means N more rejected requests and N more penalties, which is how a limit
+ * that should last one window lasts several.
+ *
+ * Keyed because limits are per model: one model being throttled says nothing
+ * about another.
+ */
+export declare class QuotaGate {
+    private notBefore;
+    /** Hold every caller until the named time. Never shortens an existing hold. */
+    penalise(ms: number, now?: number): void;
+    /** Milliseconds still to wait, or 0. */
+    remaining(now?: number): number;
+    clear(): void;
+    /**
+     * Wait out any active hold.
+     *
+     * Re-checked after every wake, because the hold is not fixed at the moment
+     * this caller started waiting: another caller's 429 extends it, and a sleeper
+     * timed against the old deadline would wake early and spend a request on a
+     * quota the server has since said is still closed.
+     *
+     * The wait is jittered per caller: without that, everyone released by one
+     * penalty wakes in the same millisecond and rebuilds the herd the penalty was
+     * meant to break up.
+     */
+    waitUntilOpen(signal?: AbortSignal, maxWaitMs?: number): Promise<void>;
+}
+/**
+ * Keys are open-ended — a per-request model override mints a new one — so the
+ * registry is pruned rather than left to grow for the life of the process.
+ * Only entries that are both open and long idle are dropped: a held gate is
+ * doing its job, and a recently used one may still be someone's in-flight call.
+ */
+export declare const GATE_IDLE_TTL_MS: number;
+/**
+ * How many quotas the registry keeps. Enforced by evicting gates that are both
+ * open and unheld, so a process with more than this many pauses or in-flight
+ * calls at once can exceed it — those gates are load-bearing. Evicting an idle
+ * one costs nothing: it carries no deadline, and the next call mints an
+ * equivalent.
+ */
+export declare const GATE_LIMIT = 500;
+/** The gate for one quota. Shared across every provider instance in the process. */
+export declare function gateFor(key: string): QuotaGate;
+/**
+ * Hold a gate for the length of one call, and keep it in the registry meanwhile.
+ *
+ * Being open is not the same as being unused. A request is in flight for as
+ * long as it takes the server to answer, and until that answer arrives the gate
+ * it belongs to has no pause on it. Evicted in that window, the call would go on
+ * to penalise an object the registry no longer knows: the pause would be real
+ * and invisible, and the next caller would be handed a fresh open gate and sent
+ * straight into a quota that had just closed. Worse than no gate at all, since
+ * the penalty is paid and nothing is bought with it.
+ *
+ * Release in a `finally`. Releasing twice is harmless.
+ */
+export declare function leaseQuotaGate(key: string): {
+    gate: QuotaGate;
+    release: () => void;
+};
+/**
+ * Reclaim gates that are open and long idle. Exported so a long-lived host can
+ * run it on a timer, and so the reclaim can be tested at a chosen `now` without
+ * waiting ten minutes. It frees only what is certainly stale; the size bound is
+ * enforced separately, by `reclaimGates`.
+ */
+export declare function pruneQuotaGates(now?: number): void;
+/** How many quotas are currently tracked. Diagnostics and tests. */
+export declare function quotaGateCount(): number;
+/** Test seam — drops every gate. */
+export declare function resetQuotaGates(): void;
+export interface ThrottleRetryOptions {
+    /** Identifies the quota being spent. Limits are per model, so include it. */
+    key: string;
+    policy?: Partial<ThrottlePolicy>;
+    /** Does this error mean "too many requests"? */
+    isThrottled: (error: unknown) => boolean;
+    /** What the server asked us to wait, in seconds, if it said. */
+    retryAfterSeconds?: (error: unknown) => number | undefined;
+    signal?: AbortSignal;
+    onRetry?: (info: {
+        attempt: number;
+        delayMs: number;
+        retryAfterSeconds?: number;
+    }) => void;
+}
+/**
+ * Run `fn`, respecting the shared pause and retrying a rate limit.
+ *
+ * Any error that is not a rate limit is rethrown untouched and immediately —
+ * this is not a general-purpose retry, and turning a genuine failure into four
+ * more of them would be worse than the failure.
+ */
+export declare function runWithThrottleRetry<T>(fn: () => Promise<T>, opts: ThrottleRetryOptions): Promise<T>;
+/**
+ * The rate-limit marker on an error or anywhere in its `cause` chain.
+ *
+ * Layers above the provider rewrap errors — the ILlm adapter turns anything
+ * thrown into an `LlmError` — so the marker is rarely still on the outermost
+ * object by the time a retry decorator inspects it. Bounded by depth and a
+ * visited set, like `extractStatusCode`, so a cyclic chain cannot hang.
+ */
+export declare function findThrottled(err: unknown): ThrottledError | undefined;
+/**
+ * Carry the rate-limit facts onto a provider's own error.
+ *
+ * Every provider catches its transport error and rethrows something friendlier.
+ * That is fine for a message and fatal for a fact: the 429 would be lost at the
+ * exact boundary where the consumer needs it. This moves the facts across.
+ */
+export declare function preserveThrottled<E extends Error>(original: unknown, wrapped: E): E;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/llm/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/llm/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAK5C,oFAAoF;AACpF,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,SAAS,EAAE,IAAI,CAAC;IAChB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;CACzC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAMhE;AA8BD;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAK;IAEtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI;IAIpD,wCAAwC;IACxC,SAAS,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM;IAI3C,KAAK,IAAI,IAAI;IAIb;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,SAA2B,GACnC,OAAO,CAAC,IAAI,CAAC;CAiBjB;AAWD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAc,CAAC;AAC5C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAe9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAgBA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI,CAM9D;AAsCD,oEAAoE;AACpE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,oCAAoC;AACpC,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,gDAAgD;IAChD,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACzC,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,KAAK,IAAI,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,CAAC,CAAC,CAQZ;AA2ED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAWtE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAC/C,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,CAAC,GACT,CAAC,CAaH"}

package/dist/llm/throttle.js

@@ -0,0 +1,385 @@
+/**
+ * Shared rate-limit handling for every LLM provider.
+ *
+ * None of the providers handled HTTP 429 (issue #282). Each one let the status
+ * collapse into an error message, so consumers were reduced to matching the
+ * substring "429" in prose to decide whether to retry.
+ *
+ * The policy lives here rather than in a provider because the providers differ
+ * in SDK but not in the shape of the problem: a shared quota, a documented
+ * `Retry-After`, and a herd of concurrent callers that will all rediscover the
+ * same limit unless something holds them back together.
+ *
+ * SAP AI Core states the rules this implements
+ * (help.sap.com, Rate Limit Management):
+ *
+ *   Do not retry immediately after a 429. Use exponential backoff with jitter
+ *   to prevent thundering-herd behavior. If the response includes a
+ *   `Retry-After` header, use its value as the wait interval. Limit retries by
+ *   using a maximum cap (for example, 5 retries or 60 seconds total wait).
+ *
+ * The same rules fit Anthropic and OpenAI, which return 429 with `Retry-After`
+ * as ordinary HTTP. Ollama is local and never rate-limited; it simply never
+ * enters this path.
+ */
+import { DEFAULT_THROTTLE_POLICY, DefaultThrottleStrategy, } from '../interfaces/throttle-strategy.js';
+import { DefaultWaitStrategy } from '../interfaces/wait-strategy.js';
+const defaultStrategy = new DefaultThrottleStrategy();
+export function isThrottledError(e) {
+    return (typeof e === 'object' &&
+        e !== null &&
+        e.throttled === true);
+}
+const waiter = new DefaultWaitStrategy();
+/**
+ * Sleep, or throw if the signal aborts.
+ *
+ * Delegated to the shared wait strategy rather than hand-rolled: the listener
+ * bookkeeping is where a sleep like this goes wrong. One added per backoff and
+ * never removed accumulates on a request- or session-scoped signal until Node
+ * warns about the leak — a defect this repository has already fixed once, in
+ * the retry decorators. Fixed in one place, it stays fixed for every waiter.
+ */
+const sleep = async (ms, signal) => {
+    const aborted = () => signal?.reason ?? new Error('Aborted');
+    if (signal?.aborted)
+        throw aborted();
+    if ((await waiter.wait(ms, signal)) === 'aborted')
+        throw aborted();
+};
+/**
+ * Per-caller spread on waking, so everyone released by one penalty does not
+ * wake in the same millisecond and rebuild the herd the penalty broke up.
+ *
+ * It is added to a wait, never to a budget: a wait capped at exactly the budget
+ * simply loses the spread, which costs nothing — a caller whose budget ends
+ * with the pause is leaving either way.
+ */
+const WAKE_SPREAD_MS = 250;
+/**
+ * One shared pause per quota.
+ *
+ * A rate limit belongs to the quota, not to the request that happened to
+ * discover it. When one call is told to wait, every other call against the same
+ * quota is already over the limit too — letting each find that out for itself
+ * means N more rejected requests and N more penalties, which is how a limit
+ * that should last one window lasts several.
+ *
+ * Keyed because limits are per model: one model being throttled says nothing
+ * about another.
+ */
+export class QuotaGate {
+    notBefore = 0;
+    /** Hold every caller until the named time. Never shortens an existing hold. */
+    penalise(ms, now = Date.now()) {
+        this.notBefore = Math.max(this.notBefore, now + ms);
+    }
+    /** Milliseconds still to wait, or 0. */
+    remaining(now = Date.now()) {
+        return Math.max(0, this.notBefore - now);
+    }
+    clear() {
+        this.notBefore = 0;
+    }
+    /**
+     * Wait out any active hold.
+     *
+     * Re-checked after every wake, because the hold is not fixed at the moment
+     * this caller started waiting: another caller's 429 extends it, and a sleeper
+     * timed against the old deadline would wake early and spend a request on a
+     * quota the server has since said is still closed.
+     *
+     * The wait is jittered per caller: without that, everyone released by one
+     * penalty wakes in the same millisecond and rebuilds the herd the penalty was
+     * meant to break up.
+     */
+    async waitUntilOpen(signal, maxWaitMs = Number.POSITIVE_INFINITY) {
+        const deadline = Date.now() + maxWaitMs;
+        for (;;) {
+            const left = this.remaining();
+            if (left <= 0)
+                return;
+            const budget = deadline - Date.now();
+            // Out of the caller's budget with the gate still shut. It is told, not
+            // held: `remaining()` still reports the hold, and the caller decides.
+            if (budget <= 0)
+                return;
+            // A timer that lands a hair early is simply waited out again on the next
+            // turn, which is why the cap needs no padding to be safe.
+            await sleep(Math.min(left + Math.random() * WAKE_SPREAD_MS, budget), signal);
+        }
+    }
+}
+const gates = new Map();
+/**
+ * Keys are open-ended — a per-request model override mints a new one — so the
+ * registry is pruned rather than left to grow for the life of the process.
+ * Only entries that are both open and long idle are dropped: a held gate is
+ * doing its job, and a recently used one may still be someone's in-flight call.
+ */
+export const GATE_IDLE_TTL_MS = 10 * 60_000;
+/**
+ * How many quotas the registry keeps. Enforced by evicting gates that are both
+ * open and unheld, so a process with more than this many pauses or in-flight
+ * calls at once can exceed it — those gates are load-bearing. Evicting an idle
+ * one costs nothing: it carries no deadline, and the next call mints an
+ * equivalent.
+ */
+export const GATE_LIMIT = 500;
+/** The gate for one quota. Shared across every provider instance in the process. */
+export function gateFor(key) {
+    const now = Date.now();
+    const existing = gates.get(key);
+    if (existing) {
+        existing.lastUsed = now;
+        return existing.gate;
+    }
+    if (gates.size >= GATE_LIMIT)
+        reclaimGates(now);
+    const entry = {
+        gate: new QuotaGate(),
+        lastUsed: now,
+        leases: 0,
+    };
+    gates.set(key, entry);
+    return entry.gate;
+}
+/**
+ * Hold a gate for the length of one call, and keep it in the registry meanwhile.
+ *
+ * Being open is not the same as being unused. A request is in flight for as
+ * long as it takes the server to answer, and until that answer arrives the gate
+ * it belongs to has no pause on it. Evicted in that window, the call would go on
+ * to penalise an object the registry no longer knows: the pause would be real
+ * and invisible, and the next caller would be handed a fresh open gate and sent
+ * straight into a quota that had just closed. Worse than no gate at all, since
+ * the penalty is paid and nothing is bought with it.
+ *
+ * Release in a `finally`. Releasing twice is harmless.
+ */
+export function leaseQuotaGate(key) {
+    const gate = gateFor(key);
+    // By identity, not by key: `resetQuotaGates` may have replaced the entry
+    // by the time this is released, and that entry's count is not ours to touch.
+    const entry = gates.get(key);
+    if (entry)
+        entry.leases += 1;
+    let released = false;
+    return {
+        gate,
+        release: () => {
+            if (released || !entry)
+                return;
+            released = true;
+            entry.leases -= 1;
+            entry.lastUsed = Date.now();
+        },
+    };
+}
+/**
+ * Reclaim gates that are open and long idle. Exported so a long-lived host can
+ * run it on a timer, and so the reclaim can be tested at a chosen `now` without
+ * waiting ten minutes. It frees only what is certainly stale; the size bound is
+ * enforced separately, by `reclaimGates`.
+ */
+export function pruneQuotaGates(now = Date.now()) {
+    for (const [key, entry] of gates) {
+        if (isEvictable(entry, now) && now - entry.lastUsed > GATE_IDLE_TTL_MS) {
+            gates.delete(key);
+        }
+    }
+}
+/**
+ * Safe to forget: nobody is waiting behind it, and no call is holding it.
+ *
+ * An open, unleased gate carries no state at all — the next call mints an
+ * equivalent one and loses nothing.
+ */
+function isEvictable(entry, now) {
+    return entry.leases === 0 && entry.gate.remaining(now) === 0;
+}
+/**
+ * Hold the registry at `GATE_LIMIT`.
+ *
+ * Age alone is not a bound: a burst of per-request model overrides mints keys
+ * far faster than the ten-minute idle rule retires them, and the map grows for
+ * as long as the burst lasts. So once the stale entries are gone, the least
+ * recently used OPEN gates go too, oldest first, until the registry is back
+ * under the limit.
+ *
+ * Only idle gates are evicted: not one holding a pause, which IS the pause, and
+ * not one a call is still holding, which may be about to become a pause.
+ */
+function reclaimGates(now) {
+    pruneQuotaGates(now);
+    if (gates.size < GATE_LIMIT)
+        return;
+    const evictable = [...gates]
+        .filter(([, entry]) => isEvictable(entry, now))
+        .sort((a, b) => a[1].lastUsed - b[1].lastUsed);
+    for (const [key] of evictable) {
+        if (gates.size < GATE_LIMIT)
+            return;
+        gates.delete(key);
+    }
+}
+/** How many quotas are currently tracked. Diagnostics and tests. */
+export function quotaGateCount() {
+    return gates.size;
+}
+/** Test seam — drops every gate. */
+export function resetQuotaGates() {
+    gates.clear();
+}
+/**
+ * Run `fn`, respecting the shared pause and retrying a rate limit.
+ *
+ * Any error that is not a rate limit is rethrown untouched and immediately —
+ * this is not a general-purpose retry, and turning a genuine failure into four
+ * more of them would be worse than the failure.
+ */
+export async function runWithThrottleRetry(fn, opts) {
+    const policy = { ...DEFAULT_THROTTLE_POLICY, ...opts.policy };
+    const { gate, release } = leaseQuotaGate(opts.key);
+    try {
+        return await attemptWithGate(fn, opts, policy, gate);
+    }
+    finally {
+        release();
+    }
+}
+async function attemptWithGate(fn, opts, policy, gate) {
+    let attempt = 0;
+    let waited = 0;
+    for (;;) {
+        // Waiting at the gate is waiting. Uncounted it was free, so a caller with a
+        // ten-millisecond budget could sit out a minute-long pause another caller
+        // had earned, its declared budget saying nothing about the time it spent.
+        // Decided before the wait, never during it: a hold longer than what is left
+        // of the budget is refused outright rather than half-served.
+        const hold = gate.remaining();
+        if (hold > 0) {
+            const budgetLeft = policy.maxTotalWaitMs - waited;
+            if (hold > budgetLeft)
+                throw outOfBudgetAtGate(hold, attempt);
+            const before = Date.now();
+            // Capped as well as pre-checked: a pause that fits when the wait starts
+            // can be extended past the budget by someone else's 429 while it runs.
+            // The cap is the budget exactly. Padding it to protect the wake spread
+            // would make the budget the one thing it must not be — approximate.
+            await gate.waitUntilOpen(opts.signal, budgetLeft);
+            waited += Date.now() - before;
+            const stillShut = gate.remaining();
+            if (stillShut > 0)
+                throw outOfBudgetAtGate(stillShut, attempt);
+        }
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (!opts.isThrottled(error))
+                throw error;
+            attempt += 1;
+            const retryAfter = opts.retryAfterSeconds?.(error);
+            const decision = (policy.strategy ?? defaultStrategy).decide({
+                attempt,
+                retryAfterSeconds: retryAfter,
+                waitedMs: waited,
+                policy,
+            });
+            // Hold everyone else too, and hold them whether or not THIS caller is
+            // going on. The pause describes the quota, not one request: giving up
+            // with the gate open sends every other caller straight back into a limit
+            // the server just said was closed. That is why the decision carries a
+            // wait in both cases, rather than being retry-or-nothing.
+            //
+            // The gate is given the interval alone. This caller then serves its own
+            // backoff there, on the next turn of the loop, rather than sleeping
+            // beside it: two mechanisms waiting out one pause double-count it, and
+            // the leftover milliseconds between them decide outcomes at the margin.
+            // The per-caller spread that keeps the released callers from waking
+            // together lives in `waitUntilOpen`, where the waiting is done.
+            gate.penalise(decision.waitMs);
+            if (!decision.retry) {
+                throw annotate(error, attempt, retryAfter, decision.reason);
+            }
+            opts.onRetry?.({
+                attempt,
+                delayMs: decision.waitMs,
+                retryAfterSeconds: retryAfter,
+            });
+        }
+    }
+}
+const MAX_CAUSE_DEPTH = 5;
+/**
+ * The rate-limit marker on an error or anywhere in its `cause` chain.
+ *
+ * Layers above the provider rewrap errors — the ILlm adapter turns anything
+ * thrown into an `LlmError` — so the marker is rarely still on the outermost
+ * object by the time a retry decorator inspects it. Bounded by depth and a
+ * visited set, like `extractStatusCode`, so a cyclic chain cannot hang.
+ */
+export function findThrottled(err) {
+    const visited = new Set();
+    let cur = err;
+    for (let depth = 0; depth < MAX_CAUSE_DEPTH; depth++) {
+        if (typeof cur !== 'object' || cur === null || visited.has(cur))
+            return undefined;
+        visited.add(cur);
+        if (isThrottledError(cur))
+            return cur;
+        cur = cur.cause;
+    }
+    return undefined;
+}
+/**
+ * Carry the rate-limit facts onto a provider's own error.
+ *
+ * Every provider catches its transport error and rethrows something friendlier.
+ * That is fine for a message and fatal for a fact: the 429 would be lost at the
+ * exact boundary where the consumer needs it. This moves the facts across.
+ */
+export function preserveThrottled(original, wrapped) {
+    if (!isThrottledError(original))
+        return wrapped;
+    const w = wrapped;
+    w.throttled = true;
+    w.attempts = original.attempts;
+    if (original.retryAfterSeconds !== undefined) {
+        w.retryAfterSeconds = original.retryAfterSeconds;
+    }
+    // Every fact, not a chosen few. Every provider wraps its transport error, so
+    // a fact left behind here is a fact no consumer ever sees — which is how the
+    // reason for giving up was lost the moment it was added.
+    if (original.reason !== undefined)
+        w.reason = original.reason;
+    return w;
+}
+/**
+ * The shared pause outlasts what this caller said it would wait.
+ *
+ * There is no server error to annotate here — the request was never sent,
+ * because sending it into a quota known to be closed is the one thing the gate
+ * exists to prevent. It is still a rate limit, and says so, carrying what is
+ * left of the pause so the consumer can decide.
+ */
+function outOfBudgetAtGate(remainingMs, attempts) {
+    const e = new Error('rate limited: the pause on this quota outlasts the configured wait budget');
+    e.throttled = true;
+    e.attempts = attempts;
+    e.retryAfterSeconds = remainingMs / 1000;
+    e.reason = 'gate';
+    return e;
+}
+function annotate(error, attempts, retryAfterSeconds, reason) {
+    const e = (error instanceof Error ? error : new Error(String(error)));
+    e.throttled = true;
+    e.attempts = attempts;
+    if (retryAfterSeconds !== undefined)
+        e.retryAfterSeconds = retryAfterSeconds;
+    if (reason !== undefined)
+        e.reason = reason;
+    return e;
+}
+//# sourceMappingURL=throttle.js.map

package/dist/llm/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/llm/throttle.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 /**
  * Core types for LLM Proxy
  */
+import type { ThrottlePolicy } from './interfaces/throttle-strategy.js';
 import type { LlmUsage } from './interfaces/types.js';
 export interface Message {
     /**
@@ -77,6 +78,16 @@ export interface LLMProviderConfig {
     model?: string;
     temperature?: number;
     maxTokens?: number;
+    /**
+     * What this provider does when the server throttles it. Omit for the shared
+     * default: back off with jitter, honour `Retry-After`, give up after 5
+     * attempts or 60 seconds of waiting.
+     *
+     * There is no switch for turning it off — sending another request into a
+     * quota the server has just closed is never the better answer. Different
+     * mechanics go through `strategy`.
+     */
+    whenThrottled?: Partial<ThrottlePolicy>;
 }
 export interface LLMCallOptions {
     /** Per-request model override. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/llm-agent",
-  "version": "22.1.0",
+  "version": "23.0.0",
   "description": "Core interfaces, types, and lightweight default implementations for LLM agent orchestration.",
   "type": "module",
   "main": "dist/index.js",