@mcp-abap-adt/llm-agent 24.1.0 → 25.0.0

package/dist/interfaces/agent-contracts.d.ts

@@ -44,6 +44,12 @@ export interface BaseAgentLlmBridge {
         maxTokens?: number;
         topP?: number;
         stop?: string[];
+        /**
+         * The caller's deadline. Carried all the way to the provider's SDK call,
+         * which is the only place it can actually stop anything: an adapter that
+         * merely stops waiting leaves the request running with nobody holding it.
+         */
+        signal?: AbortSignal;
     }): Promise<{
         content: string;
         raw?: unknown;
@@ -53,6 +59,12 @@ export interface BaseAgentLlmBridge {
         maxTokens?: number;
         topP?: number;
         stop?: string[];
+        /**
+         * The caller's deadline. Carried all the way to the provider's SDK call,
+         * which is the only place it can actually stop anything: an adapter that
+         * merely stops waiting leaves the request running with nobody holding it.
+         */
+        signal?: AbortSignal;
     }): AsyncGenerator<{
         content: string;
         raw?: unknown;

package/dist/interfaces/agent-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-contracts.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CAIzD;AAED,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,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;IACH,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B;;;qEAGiE;IACjE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,CACb,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,GACA,cAAc,CACf;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB,EACrD,IAAI,EACJ,OAAO,CACR,CAAC;CACH"}
+{"version":3,"file":"agent-contracts.d.ts","sourceRoot":"","sources":["../../src/interfaces/agent-contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CAIzD;AAED,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,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;IACH,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B;;;qEAGiE;IACjE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAMD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB;;;;WAIG;QACH,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/C,eAAe,CACb,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB;;;;WAIG;QACH,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CACf;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB,EACrD,IAAI,EACJ,OAAO,CACR,CAAC;CACH"}

package/dist/interfaces/failure-strategy.d.ts

@@ -0,0 +1,95 @@
+/**
+ * What a provider does when a call fails for a reason nobody named an interval
+ * for: a `500`, a `502`, a dropped connection, a socket that answers nothing.
+ *
+ * The sibling of `IThrottleStrategy`, and deliberately not the same seam.
+ * Throttling is the SERVER governing the pace: it returns `429`, it names a
+ * delay in `Retry-After`, and the only honest thing to do is observe that
+ * delay or report it. Here nobody names anything. A `502` says the request
+ * failed; it says nothing at all about when the next one might work.
+ *
+ * So any waiting here rests on a number, and this library has none to give.
+ * How long to wait, and how many times, depends on who is waiting at the other
+ * end — a batch job and a caller on a sixty-second connection want opposite
+ * things, and the difference is invisible from in here. The consumer decides,
+ * the same way it decides about throttling.
+ *
+ * Two ship:
+ *
+ * - `ReportFailure` — never waits. The failure goes up as it arrived, and the
+ *   caller decides. This is what happens when nothing is configured.
+ * - `RetryWithBackoff` — the classic policy, with its numbers named by whoever
+ *   constructs it rather than defaulted in here.
+ */
+/** What the transport said, for a strategy to decide on. */
+export interface FailureContext {
+    /** HTTP status, when the failure carried one. */
+    status?: number;
+    /** Which attempt just failed. 1-based. */
+    attempt: number;
+    /** How long this call has already spent waiting between attempts. */
+    waitedMs: number;
+    /** Whether anything was already streamed to the caller before the failure. */
+    midStream: boolean;
+    /** The failure itself, for a strategy that needs to look closer. */
+    error: unknown;
+}
+/** Wait this long, then either try again or give up. */
+export interface FailureDecision {
+    waitMs: number;
+    retry: boolean;
+    /** Why, for the log and for the error the caller finally sees. */
+    reason?: string;
+}
+export interface IFailureStrategy {
+    readonly name: string;
+    decide(ctx: FailureContext): FailureDecision;
+}
+/**
+ * Never retry. What happens when nothing is configured.
+ *
+ * The failure goes up untouched, and the caller — who knows whether anyone is
+ * waiting on the other end, and whether the work is worth repeating — decides
+ * whether to ask again.
+ */
+export declare class ReportFailure implements IFailureStrategy {
+    readonly name = "report-failure";
+    decide(): FailureDecision;
+}
+/**
+ * Try again a fixed number of times, doubling the wait each time.
+ *
+ * The policy this library used to install on everyone by default. It still
+ * ships, because it is a reasonable thing to want; what changed is that its
+ * numbers now belong to whoever writes them down. There are no defaults here
+ * on purpose — a default would be this library guessing again, one layer in.
+ *
+ * `statuses` is the set worth repeating. A `500` or `502` is usually the
+ * provider having a bad second; a `400` is the request itself, and repeating
+ * it just fails again more slowly. A failure carrying no status is not
+ * retried: without one there is nothing to tell a blip from a bug.
+ *
+ * `midStreamHints` opts into the harder case — a stream that failed after it
+ * had already yielded. Retrying that replays the whole stream, so it happens
+ * only for failures whose message matches one of these, and never by default.
+ */
+export declare class RetryWithBackoff implements IFailureStrategy {
+    readonly name = "retry-with-backoff";
+    private readonly attempts;
+    private readonly firstWaitMs;
+    private readonly statuses;
+    private readonly midStreamHints;
+    constructor(options: {
+        /** How many times to try again after the first failure. */
+        attempts: number;
+        /** The first wait. Each subsequent one doubles it. */
+        firstWaitMs: number;
+        /** Statuses worth repeating. */
+        statuses: readonly number[];
+        /** Message fragments that make a mid-stream failure worth replaying. */
+        midStreamHints?: readonly string[];
+    });
+    decide({ status, attempt, midStream, error, }: FailureContext): FailureDecision;
+    private matchesHint;
+}
+//# sourceMappingURL=failure-strategy.d.ts.map

package/dist/interfaces/failure-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-strategy.d.ts","sourceRoot":"","sources":["../../src/interfaces/failure-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,MAAM,IAAI,eAAe;CAG1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;gBAEvC,OAAO,EAAE;QACnB,2DAA2D;QAC3D,QAAQ,EAAE,MAAM,CAAC;QACjB,sDAAsD;QACtD,WAAW,EAAE,MAAM,CAAC;QACpB,gCAAgC;QAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,wEAAwE;QACxE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC;IAOD,MAAM,CAAC,EACL,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACN,EAAE,cAAc,GAAG,eAAe;IAuBnC,OAAO,CAAC,WAAW;CAKpB"}

package/dist/interfaces/failure-strategy.js

@@ -0,0 +1,96 @@
+/**
+ * What a provider does when a call fails for a reason nobody named an interval
+ * for: a `500`, a `502`, a dropped connection, a socket that answers nothing.
+ *
+ * The sibling of `IThrottleStrategy`, and deliberately not the same seam.
+ * Throttling is the SERVER governing the pace: it returns `429`, it names a
+ * delay in `Retry-After`, and the only honest thing to do is observe that
+ * delay or report it. Here nobody names anything. A `502` says the request
+ * failed; it says nothing at all about when the next one might work.
+ *
+ * So any waiting here rests on a number, and this library has none to give.
+ * How long to wait, and how many times, depends on who is waiting at the other
+ * end — a batch job and a caller on a sixty-second connection want opposite
+ * things, and the difference is invisible from in here. The consumer decides,
+ * the same way it decides about throttling.
+ *
+ * Two ship:
+ *
+ * - `ReportFailure` — never waits. The failure goes up as it arrived, and the
+ *   caller decides. This is what happens when nothing is configured.
+ * - `RetryWithBackoff` — the classic policy, with its numbers named by whoever
+ *   constructs it rather than defaulted in here.
+ */
+import { isRetryableStatus } from '../resilience/status.js';
+/**
+ * Never retry. What happens when nothing is configured.
+ *
+ * The failure goes up untouched, and the caller — who knows whether anyone is
+ * waiting on the other end, and whether the work is worth repeating — decides
+ * whether to ask again.
+ */
+export class ReportFailure {
+    name = 'report-failure';
+    decide() {
+        return { waitMs: 0, retry: false, reason: 'reported' };
+    }
+}
+/**
+ * Try again a fixed number of times, doubling the wait each time.
+ *
+ * The policy this library used to install on everyone by default. It still
+ * ships, because it is a reasonable thing to want; what changed is that its
+ * numbers now belong to whoever writes them down. There are no defaults here
+ * on purpose — a default would be this library guessing again, one layer in.
+ *
+ * `statuses` is the set worth repeating. A `500` or `502` is usually the
+ * provider having a bad second; a `400` is the request itself, and repeating
+ * it just fails again more slowly. A failure carrying no status is not
+ * retried: without one there is nothing to tell a blip from a bug.
+ *
+ * `midStreamHints` opts into the harder case — a stream that failed after it
+ * had already yielded. Retrying that replays the whole stream, so it happens
+ * only for failures whose message matches one of these, and never by default.
+ */
+export class RetryWithBackoff {
+    name = 'retry-with-backoff';
+    attempts;
+    firstWaitMs;
+    statuses;
+    midStreamHints;
+    constructor(options) {
+        this.attempts = options.attempts;
+        this.firstWaitMs = options.firstWaitMs;
+        this.statuses = new Set(options.statuses);
+        this.midStreamHints = options.midStreamHints ?? [];
+    }
+    decide({ status, attempt, midStream, error, }) {
+        if (attempt > this.attempts) {
+            return { waitMs: 0, retry: false, reason: 'attempts' };
+        }
+        const worthRepeating = midStream
+            ? this.matchesHint(error)
+            : status !== undefined
+                ? this.statuses.has(status)
+                : // No structured status: fall back to the shared word-boundary match on
+                    // the message, because every provider rewraps its transport error and
+                    // the status is often only in the prose by the time it reaches here.
+                    isRetryableStatus(error, [...this.statuses]);
+        if (!worthRepeating) {
+            return {
+                waitMs: 0,
+                retry: false,
+                reason: midStream ? 'mid-stream' : 'not-transient',
+            };
+        }
+        // attempt is 1-based, so the first retry waits exactly firstWaitMs.
+        return { waitMs: this.firstWaitMs * 2 ** (attempt - 1), retry: true };
+    }
+    matchesHint(error) {
+        if (this.midStreamHints.length === 0)
+            return false;
+        const message = error instanceof Error ? error.message : String(error);
+        return this.midStreamHints.some((hint) => message.includes(hint));
+    }
+}
+//# sourceMappingURL=failure-strategy.js.map

package/dist/interfaces/failure-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-strategy.js","sourceRoot":"","sources":["../../src/interfaces/failure-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA6B5D;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,gBAAgB,CAAC;IAEjC,MAAM;QACJ,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACzD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,oBAAoB,CAAC;IACpB,QAAQ,CAAS;IACjB,WAAW,CAAS;IACpB,QAAQ,CAAsB;IAC9B,cAAc,CAAoB;IAEnD,YAAY,OASX;QACC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,EACL,MAAM,EACN,OAAO,EACP,SAAS,EACT,KAAK,GACU;QACf,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,cAAc,GAAG,SAAS;YAC9B,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC3B,CAAC,CAAC,uEAAuE;oBACvE,sEAAsE;oBACtE,qEAAqE;oBACrE,iBAAiB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;gBACL,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe;aACnD,CAAC;QACJ,CAAC;QACD,oEAAoE;QACpE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/interfaces/mcp-connection-strategy.d.ts

@@ -34,8 +34,9 @@ export interface McpConnectionConfig {
      *  Default = no-op (contributes nothing). A consumer may use this to convey a
      *  "willing to wait longer" hint or other per-request metadata. */
     requestHeadersStrategy?: IMcpRequestHeadersStrategy;
-    /** Default per-call MCP request timeout in ms (default 120000 = 2 min).
-     *  Per-tool overrides via toolTimeouts. */
+    /** Per-call MCP request timeout in ms (default 3600000 = 1 h — a ceiling meant
+     *  not to be reached, since the SDK applies its own 60s when none is given).
+     *  A real limit belongs in toolTimeouts, per tool. */
     timeout?: number;
     /** Per-tool MCP request-timeout overrides in ms, keyed by tool name.
      *  Takes precedence over timeout. */

package/dist/interfaces/mcp-connection-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-connection-strategy.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp-connection-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB;mFAC+E;IAC/E,iBAAiB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD;kFAC8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CACL,cAAc,EAAE,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;qFACiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;uEAEmE;IACnE,sBAAsB,CAAC,EAAE,0BAA0B,CAAC;IACpD;+CAC2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;yCACqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,mBAAmB,KACxB,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"mcp-connection-strategy.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp-connection-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB;mFAC+E;IAC/E,iBAAiB,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD;kFAC8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CACL,cAAc,EAAE,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;qFACiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;uEAEmE;IACnE,sBAAsB,CAAC,EAAE,0BAA0B,CAAC;IACpD;;0DAEsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;yCACqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,mBAAmB,KACxB,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/resilience/status.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resolving an HTTP status from a thrown value.
+ *
+ * A leaf module on purpose: it imports nothing, so both the retry decorators
+ * and the strategies in `interfaces/` can share one classification without a
+ * cycle between the two layers. Which statuses are worth repeating is a
+ * decision and lives in a strategy; what status this error carries is a fact
+ * and lives here.
+ */
+/**
+ * Resolve an HTTP status from an unknown thrown value: own status/statusCode,
+ * then the same walking `cause`, bounded by depth and a visited set so a cyclic
+ * chain cannot hang. Returns undefined when no numeric status is present.
+ */
+export declare function extractStatusCode(err: unknown): number | undefined;
+/**
+ * Whether a thrown value matches one of a set of HTTP status codes.
+ *
+ * A structured status (own `status`/`statusCode`, or the same on `cause`) is
+ * authoritative. Only when none is present does it fall back to the message,
+ * and there it matches on **word boundaries** — a bare `includes('429')` also
+ * fires on `4290`, an id, or a byte count, turning a hard error into a
+ * multi-second backoff stall.
+ *
+ * Shared by the embedder decorator and the LLM failure strategy so the
+ * classification cannot drift between them.
+ */
+export declare function isRetryableStatus(err: unknown, retryOn: readonly number[]): boolean;
+//# sourceMappingURL=status.d.ts.map

package/dist/resilience/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/resilience/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAKT"}

package/dist/resilience/status.js

@@ -0,0 +1,51 @@
+/**
+ * Resolving an HTTP status from a thrown value.
+ *
+ * A leaf module on purpose: it imports nothing, so both the retry decorators
+ * and the strategies in `interfaces/` can share one classification without a
+ * cycle between the two layers. Which statuses are worth repeating is a
+ * decision and lives in a strategy; what status this error carries is a fact
+ * and lives here.
+ */
+const MAX_CAUSE_DEPTH = 5;
+/**
+ * Resolve an HTTP status from an unknown thrown value: own status/statusCode,
+ * then the same walking `cause`, bounded by depth and a visited set so a cyclic
+ * chain cannot hang. Returns undefined when no numeric status is present.
+ */
+export function extractStatusCode(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;
+        visited.add(cur);
+        const rec = cur;
+        if (typeof rec.status === 'number')
+            return rec.status;
+        if (typeof rec.statusCode === 'number')
+            return rec.statusCode;
+        cur = rec.cause;
+    }
+    return undefined;
+}
+/**
+ * Whether a thrown value matches one of a set of HTTP status codes.
+ *
+ * A structured status (own `status`/`statusCode`, or the same on `cause`) is
+ * authoritative. Only when none is present does it fall back to the message,
+ * and there it matches on **word boundaries** — a bare `includes('429')` also
+ * fires on `4290`, an id, or a byte count, turning a hard error into a
+ * multi-second backoff stall.
+ *
+ * Shared by the embedder decorator and the LLM failure strategy so the
+ * classification cannot drift between them.
+ */
+export function isRetryableStatus(err, retryOn) {
+    const status = extractStatusCode(err);
+    if (status !== undefined)
+        return retryOn.includes(status);
+    const msg = err instanceof Error ? err.message : String(err);
+    return retryOn.some((code) => new RegExp(`\\b${code}\\b`).test(msg));
+}
+//# sourceMappingURL=status.js.map

package/dist/resilience/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/resilience/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAW,CAAC;IACnC,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QACxE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,GAAG,GAAG,GAIX,CAAC;QACF,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,MAAM,CAAC;QACtD,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QAC9D,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,OAA0B;IAE1B,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/package.json

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