@mcp-abap-adt/llm-agent-libs 30.0.0 → 30.1.0

package/dist/resilience/retry-llm.d.ts

@@ -1,9 +1,10 @@
 /**
  * RetryLlm — ILlm decorator that retries transient failures with exponential backoff.
  *
- * Composition order: RetryLlm → CircuitBreakerLlm → LlmAdapter
- * Retry sits outside the circuit breaker so that retry attempts are not
- * counted as separate failures.
+ * Composition order: CircuitBreakerLlm → RetryLlm → LlmAdapter
+ * Retry sits INSIDE the circuit breaker, so the breaker records one result per
+ * logical call (after the retries), not one per attempt. A rate limiter, when
+ * used, sits outermost.
  */
 import type { ILlm, Message } from '@mcp-abap-adt/llm-agent';
 import { type CallOptions, LlmError, type LlmResponse, type LlmStreamChunk, type LlmTool, type Result } from '@mcp-abap-adt/llm-agent';
@@ -19,14 +20,28 @@ export interface RetryOptions {
 }
 export declare class RetryLlm implements ILlm {
     private readonly inner;
+    private readonly wait;
     private readonly opts;
     healthCheck?: ILlm['healthCheck'];
     constructor(inner: ILlm, options?: Partial<RetryOptions>);
     get model(): string | undefined;
     chat(messages: Message[], tools?: LlmTool[], options?: CallOptions): Promise<Result<LlmResponse, LlmError>>;
     streamChat(messages: Message[], tools?: LlmTool[], options?: CallOptions): AsyncIterable<Result<LlmStreamChunk, LlmError>>;
+    /**
+     * One attempt's stream, with a thrown exception (before or during iteration)
+     * turned into an error chunk — the same shape CircuitBreakerLlm gives it — so
+     * a throwing provider goes through the same retry rules as an error chunk.
+     */
+    private attemptStream;
     private isRetryable;
     private isMidStreamRetryable;
     private backoff;
 }
+/**
+ * Wraps `llm` in a RetryLlm placed UNDER any CircuitBreakerLlm layers it
+ * already has: each breaker wrapper is rebuilt on its own (possibly shared)
+ * breaker around the retry, so every breaker counts one result per logical
+ * call. Without a breaker this is plain `new RetryLlm(llm, options)`.
+ */
+export declare function retryInsideBreakers(llm: ILlm, options?: Partial<RetryOptions>): ILlm;
 //# sourceMappingURL=retry-llm.d.ts.map

package/dist/resilience/retry-llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-llm.d.ts","sourceRoot":"","sources":["../../src/resilience/retry-llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,KAAK,WAAW,EAGhB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD,qBAAa,QAAS,YAAW,IAAI;IAKjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAGf,KAAK,EAAE,IAAI,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAQjC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAEK,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAoBlC,UAAU,CACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAqDlD,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,OAAO;CAchB"}
+{"version":3,"file":"retry-llm.d.ts","sourceRoot":"","sources":["../../src/resilience/retry-llm.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,KAAK,WAAW,EAMhB,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sGAAsG;IACtG,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD,qBAAa,QAAS,YAAW,IAAI;IAMjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAGf,KAAK,EAAE,IAAI,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAQjC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAEK,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAoBlC,UAAU,CACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAoDlD;;;;OAIG;YACY,aAAa;IAY5B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,oBAAoB;YAMd,OAAO;CAGtB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,IAAI,EACT,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,IAAI,CAQN"}

package/dist/resilience/retry-llm.js

@@ -1,11 +1,12 @@
 /**
  * RetryLlm — ILlm decorator that retries transient failures with exponential backoff.
  *
- * Composition order: RetryLlm → CircuitBreakerLlm → LlmAdapter
- * Retry sits outside the circuit breaker so that retry attempts are not
- * counted as separate failures.
+ * Composition order: CircuitBreakerLlm → RetryLlm → LlmAdapter
+ * Retry sits INSIDE the circuit breaker, so the breaker records one result per
+ * logical call (after the retries), not one per attempt. A rate limiter, when
+ * used, sits outermost.
  */
-import { findThrottled, isRetryableStatus, LlmError, } from '@mcp-abap-adt/llm-agent';
+import { CircuitBreakerLlm, DefaultWaitStrategy, findThrottled, isCallerCancellation, isRetryableStatus, LlmError, } from '@mcp-abap-adt/llm-agent';
 const DEFAULT_OPTIONS = {
     maxAttempts: 3,
     backoffMs: 2000,
@@ -14,6 +15,7 @@ const DEFAULT_OPTIONS = {
 };
 export class RetryLlm {
     inner;
+    wait = new DefaultWaitStrategy();
     opts;
     healthCheck;
     constructor(inner, options) {
@@ -48,13 +50,15 @@ export class RetryLlm {
             }
             let chunksYielded = 0;
             let shouldRetry = false;
-            for await (const chunk of this.inner.streamChat(messages, tools, options)) {
+            for await (const chunk of this.attemptStream(messages, tools, options)) {
                 if (chunk.ok) {
                     chunksYielded++;
                     yield chunk;
                 }
                 else {
-                    const canRetry = attempt < this.opts.maxAttempts;
+                    // A caller's cancellation is never retried.
+                    const canRetry = attempt < this.opts.maxAttempts &&
+                        !isCallerCancellation(options?.signal);
                     // Pre-stream failure: retry on HTTP status codes (existing behavior)
                     if (chunksYielded === 0 &&
                         canRetry &&
@@ -79,6 +83,19 @@ export class RetryLlm {
             await this.backoff(attempt, options?.signal);
         }
     }
+    /**
+     * One attempt's stream, with a thrown exception (before or during iteration)
+     * turned into an error chunk — the same shape CircuitBreakerLlm gives it — so
+     * a throwing provider goes through the same retry rules as an error chunk.
+     */
+    async *attemptStream(messages, tools, options) {
+        try {
+            yield* this.inner.streamChat(messages, tools, options);
+        }
+        catch (err) {
+            yield { ok: false, error: new LlmError(String(err), 'LLM_ERROR') };
+        }
+    }
     isRetryable(error) {
         // A provider that runs its own rate-limit policy marks the error when that
         // policy is spent — it has already backed off, honoured Retry-After and
@@ -97,15 +114,20 @@ export class RetryLlm {
         const msg = error.message;
         return this.opts.retryOnMidStream.some((sub) => msg.includes(sub));
     }
-    backoff(attempt, signal) {
-        const delay = this.opts.backoffMs * 2 ** attempt;
-        return new Promise((resolve) => {
-            const timer = setTimeout(resolve, delay);
-            signal?.addEventListener('abort', () => {
-                clearTimeout(timer);
-                resolve();
-            }, { once: true });
-        });
+    async backoff(attempt, signal) {
+        await this.wait.wait(this.opts.backoffMs * 2 ** attempt, signal);
+    }
+}
+/**
+ * Wraps `llm` in a RetryLlm placed UNDER any CircuitBreakerLlm layers it
+ * already has: each breaker wrapper is rebuilt on its own (possibly shared)
+ * breaker around the retry, so every breaker counts one result per logical
+ * call. Without a breaker this is plain `new RetryLlm(llm, options)`.
+ */
+export function retryInsideBreakers(llm, options) {
+    if (llm instanceof CircuitBreakerLlm) {
+        return new CircuitBreakerLlm(retryInsideBreakers(llm.inner, options), llm.breaker);
     }
+    return new RetryLlm(llm, options);
 }
 //# sourceMappingURL=retry-llm.js.map

package/dist/resilience/retry-llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry-llm.js","sourceRoot":"","sources":["../../src/resilience/retry-llm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retry-llm.js","sourceRoot":"","sources":["../../src/resilience/retry-llm.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,QAAQ,GAKT,MAAM,yBAAyB,CAAC;AAajC,MAAM,eAAe,GAAiB;IACpC,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC7B,gBAAgB,EAAE,EAAE;CACrB,CAAC;AAEF,MAAM,OAAO,QAAQ;IAMA;IALF,IAAI,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACjC,IAAI,CAAe;IACpC,WAAW,CAAuB;IAElC,YACmB,KAAW,EAC5B,OAA+B;QADd,UAAK,GAAL,KAAK,CAAM;QAG5B,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YAClE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/D,IACE,MAAM,CAAC,EAAE;gBACT,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;gBAChC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAC/B,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;YAClC,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7B,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;gBAC/D,OAAO;YACT,CAAC;YAED,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,IAAI,WAAW,GAAG,KAAK,CAAC;YAExB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBACvE,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;oBACb,aAAa,EAAE,CAAC;oBAChB,MAAM,KAAK,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,4CAA4C;oBAC5C,MAAM,QAAQ,GACZ,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW;wBAC/B,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAEzC,qEAAqE;oBACrE,IACE,aAAa,KAAK,CAAC;wBACnB,QAAQ;wBACR,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAC7B,CAAC;wBACD,WAAW,GAAG,IAAI,CAAC;wBACnB,MAAM;oBACR,CAAC;oBAED,qDAAqD;oBACrD,IACE,aAAa,GAAG,CAAC;wBACjB,QAAQ;wBACR,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,EACtC,CAAC;wBACD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;wBACxD,WAAW,GAAG,IAAI,CAAC;wBACnB,MAAM;oBACR,CAAC;oBAED,MAAM,KAAK,CAAC;oBACZ,OAAO;gBACT,CAAC;YACH,CAAC;YAED,IAAI,CAAC,WAAW;gBAAE,OAAO;YAEzB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,CAAC,aAAa,CAC1B,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,IAAI,CAAC;YACH,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAe;QACjC,2EAA2E;QAC3E,wEAAwE;QACxE,yEAAyE;QACzE,8DAA8D;QAC9D,IAAI,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,wEAAwE;QACxE,0EAA0E;QAC1E,sDAAsD;QACtD,OAAO,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAEO,oBAAoB,CAAC,KAAe;QAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,MAAoB;QACzD,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAS,EACT,OAA+B;IAE/B,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;QACrC,OAAO,IAAI,iBAAiB,CAC1B,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,EACvC,GAAG,CAAC,OAAO,CACZ,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/retrieval/embedding-retrieval.d.ts

@@ -0,0 +1,7 @@
+import type { CallOptions, IQueryEmbedding, IRag, IRetrievalStrategy, RagError, RagResult, Result } from '@mcp-abap-adt/llm-agent';
+/** Today's behaviour: the store's own (embedding) ranking. */
+export declare class EmbeddingRetrieval implements IRetrievalStrategy {
+    readonly name = "embedding";
+    retrieve(store: IRag, query: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+}
+//# sourceMappingURL=embedding-retrieval.d.ts.map

package/dist/retrieval/embedding-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-retrieval.d.ts","sourceRoot":"","sources":["../../src/retrieval/embedding-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,IAAI,EACJ,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,8DAA8D;AAC9D,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CACN,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,eAAe,EACtB,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;CAG1C"}

package/dist/retrieval/embedding-retrieval.js

@@ -0,0 +1,8 @@
+/** Today's behaviour: the store's own (embedding) ranking. */
+export class EmbeddingRetrieval {
+    name = 'embedding';
+    retrieve(store, query, k, options) {
+        return store.query(query, k, options);
+    }
+}
+//# sourceMappingURL=embedding-retrieval.js.map

package/dist/retrieval/embedding-retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-retrieval.js","sourceRoot":"","sources":["../../src/retrieval/embedding-retrieval.ts"],"names":[],"mappings":"AAUA,8DAA8D;AAC9D,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,WAAW,CAAC;IAC5B,QAAQ,CACN,KAAW,EACX,KAAsB,EACtB,CAAS,EACT,OAAqB;QAErB,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/retrieval/index.d.ts

@@ -0,0 +1,4 @@
+export { EmbeddingRetrieval } from './embedding-retrieval.js';
+export { RerankAllRetrieval, RerankedRetrieval, } from './reranked-retrieval.js';
+export { applyRetrievalStrategy, hasRetrievalStrategy, StrategyRag, } from './strategy-rag.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/dist/retrieval/index.js

@@ -0,0 +1,4 @@
+export { EmbeddingRetrieval } from './embedding-retrieval.js';
+export { RerankAllRetrieval, RerankedRetrieval, } from './reranked-retrieval.js';
+export { applyRetrievalStrategy, hasRetrievalStrategy, StrategyRag, } from './strategy-rag.js';
+//# sourceMappingURL=index.js.map

package/dist/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/dist/retrieval/reranked-retrieval.d.ts

@@ -0,0 +1,28 @@
+import type { CallOptions, IQueryEmbedding, IRag, IReranker, IRetrievalStrategy, RagError, RagResult, Result } from '@mcp-abap-adt/llm-agent';
+/** Embedding top (k × overfetch) → rerank → top-k. */
+export declare class RerankedRetrieval implements IRetrievalStrategy {
+    private readonly reranker;
+    private readonly opts;
+    readonly name = "rerank";
+    private readonly overfetch;
+    constructor(reranker: IReranker, opts?: {
+        overfetch?: number;
+        storeName?: string;
+    });
+    retrieve(store: IRag, query: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+}
+/**
+ * The store's first `maxCandidates` (configured, never assumed) → rerank all → top-k.
+ * Fetches at least `k`, so a `maxCandidates` below `k` never shrinks the result.
+ */
+export declare class RerankAllRetrieval implements IRetrievalStrategy {
+    private readonly reranker;
+    private readonly opts;
+    readonly name = "rerank-all";
+    constructor(reranker: IReranker, opts: {
+        maxCandidates: number;
+        storeName?: string;
+    });
+    retrieve(store: IRag, query: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+}
+//# sourceMappingURL=reranked-retrieval.d.ts.map

package/dist/retrieval/reranked-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranked-retrieval.d.ts","sourceRoot":"","sources":["../../src/retrieval/reranked-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,IAAI,EACJ,SAAS,EACT,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,MAAM,EACP,MAAM,yBAAyB,CAAC;AAmCjC,sDAAsD;AACtD,qBAAa,iBAAkB,YAAW,kBAAkB;IAKxD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,QAAQ,EAAE,SAAS,EACnB,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAMlE,QAAQ,CACZ,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,eAAe,EACtB,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;CAa1C;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB;IAIzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,QAAQ,CAAC,IAAI,gBAAgB;gBAGV,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAShE,QAAQ,CACZ,KAAK,EAAE,IAAI,EACX,KAAK,EAAE,eAAe,EACtB,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;CAiB1C"}

package/dist/retrieval/reranked-retrieval.js

@@ -0,0 +1,65 @@
+import { assertPositiveInteger } from '../util/assert-positive-integer.js';
+/** Cap on a thrown error's text in the step: enough for a reason, never a dump. */
+const MAX_THROWN_MESSAGE = 500;
+async function rerankOrFallback(name, storeName, reranker, query, candidates, k, options) {
+    let code;
+    let message;
+    try {
+        const r = await reranker.rerank(query.text, candidates, options);
+        if (r.ok)
+            return { ok: true, value: r.value.slice(0, k) };
+        code = r.error.code;
+        message = r.error.message;
+    }
+    catch (err) {
+        code = 'RERANK_THROWN';
+        message = String(err).slice(0, MAX_THROWN_MESSAGE);
+    }
+    options?.sessionLogger?.logStep('retrieval_rerank_error', {
+        store: storeName,
+        strategy: name,
+        code,
+        message,
+    });
+    return { ok: true, value: candidates.slice(0, k) };
+}
+/** Embedding top (k × overfetch) → rerank → top-k. */
+export class RerankedRetrieval {
+    reranker;
+    opts;
+    name = 'rerank';
+    overfetch;
+    constructor(reranker, opts = {}) {
+        this.reranker = reranker;
+        this.opts = opts;
+        this.overfetch = opts.overfetch ?? 2;
+        assertPositiveInteger('RerankedRetrieval', 'overfetch', this.overfetch);
+    }
+    async retrieve(store, query, k, options) {
+        const cand = await store.query(query, k * this.overfetch, options);
+        if (!cand.ok)
+            return cand;
+        return rerankOrFallback(this.name, this.opts.storeName, this.reranker, query, cand.value, k, options);
+    }
+}
+/**
+ * The store's first `maxCandidates` (configured, never assumed) → rerank all → top-k.
+ * Fetches at least `k`, so a `maxCandidates` below `k` never shrinks the result.
+ */
+export class RerankAllRetrieval {
+    reranker;
+    opts;
+    name = 'rerank-all';
+    constructor(reranker, opts) {
+        this.reranker = reranker;
+        this.opts = opts;
+        assertPositiveInteger('RerankAllRetrieval', 'maxCandidates', opts.maxCandidates);
+    }
+    async retrieve(store, query, k, options) {
+        const cand = await store.query(query, Math.max(k, this.opts.maxCandidates), options);
+        if (!cand.ok)
+            return cand;
+        return rerankOrFallback(this.name, this.opts.storeName, this.reranker, query, cand.value, k, options);
+    }
+}
+//# sourceMappingURL=reranked-retrieval.js.map

package/dist/retrieval/reranked-retrieval.js.map

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

package/dist/retrieval/strategy-rag.d.ts

@@ -0,0 +1,29 @@
+import { type CallOptions, type IQueryEmbedding, type IRag, type IRagBackendWriter, type IRagDecorator, type IRetrievalStrategy, type RagError, type RagResult, type Result } from '@mcp-abap-adt/llm-agent';
+declare const BRAND: unique symbol;
+/** IRag decorator: `query` goes through the strategy, everything else to `inner` (spec §13.3). */
+export declare class StrategyRag implements IRag, IRagDecorator {
+    readonly inner: IRag;
+    readonly strategy: IRetrievalStrategy;
+    readonly [BRAND] = true;
+    constructor(inner: IRag, strategy: IRetrievalStrategy);
+    query(embedding: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+    healthCheck(options?: CallOptions): Promise<Result<void, RagError>>;
+    getById(id: string, options?: CallOptions): Promise<Result<RagResult | null, RagError>>;
+    writer(): IRagBackendWriter | undefined;
+}
+/** True when `rag`, or any store it decorates, carries a retrieval strategy. */
+export declare function hasRetrievalStrategy(rag: IRag): boolean;
+/** Wrap an explicitly configured store (embedding included); idempotent through decorators. */
+export declare function applyRetrievalStrategy(rag: IRag, strategy: IRetrievalStrategy): IRag;
+/**
+ * The store an agent queries for one of its built-in slots (`tools`, `history`).
+ * The agent's OWN store always has priority: the projected entry is used only
+ * when it carries a retrieval strategy and decorates `own` (so layers such as
+ * the circuit-breaker fallback are kept); otherwise `ownWithStrategy` — `own`
+ * with the explicit strategy applied once by the caller, or `own` itself. A
+ * projected entry over another agent's store (a worker sharing its parent's
+ * registry) never wins. Internal; not re-exported.
+ */
+export declare function ownBuiltInStore(own: IRag, ownWithStrategy: IRag, projected: IRag | undefined): IRag;
+export {};
+//# sourceMappingURL=strategy-rag.d.ts.map

package/dist/retrieval/strategy-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-rag.d.ts","sourceRoot":"","sources":["../../src/retrieval/strategy-rag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAEvB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AAEjC,QAAA,MAAM,KAAK,eAA2C,CAAC;AAEvD,kGAAkG;AAClG,qBAAa,WAAY,YAAW,IAAI,EAAE,aAAa;IAGnD,QAAQ,CAAC,KAAK,EAAE,IAAI;IACpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB;IAHvC,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAEb,KAAK,EAAE,IAAI,EACX,QAAQ,EAAE,kBAAkB;IAEvC,KAAK,CACH,SAAS,EAAE,eAAe,EAC1B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IAGzC,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAGnE,OAAO,CACL,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IAG9C,MAAM,IAAI,iBAAiB,GAAG,SAAS;CAGxC;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAOvD;AAED,+FAA+F;AAC/F,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,EACT,QAAQ,EAAE,kBAAkB,GAC3B,IAAI,CAEN;AAYD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,IAAI,EACT,eAAe,EAAE,IAAI,EACrB,SAAS,EAAE,IAAI,GAAG,SAAS,GAC1B,IAAI,CAMN"}

package/dist/retrieval/strategy-rag.js

@@ -0,0 +1,65 @@
+import { isRagDecorator, } from '@mcp-abap-adt/llm-agent';
+const BRAND = Symbol.for('@mcp-abap-adt/strategy-rag');
+/** IRag decorator: `query` goes through the strategy, everything else to `inner` (spec §13.3). */
+export class StrategyRag {
+    inner;
+    strategy;
+    [BRAND] = true;
+    constructor(inner, strategy) {
+        this.inner = inner;
+        this.strategy = strategy;
+    }
+    query(embedding, k, options) {
+        return this.strategy.retrieve(this.inner, embedding, k, options);
+    }
+    healthCheck(options) {
+        return this.inner.healthCheck(options);
+    }
+    getById(id, options) {
+        return this.inner.getById(id, options);
+    }
+    writer() {
+        return this.inner.writer?.();
+    }
+}
+/** True when `rag`, or any store it decorates, carries a retrieval strategy. */
+export function hasRetrievalStrategy(rag) {
+    let cur = rag;
+    for (let depth = 0; cur && depth < 16; depth++) {
+        if (cur[BRAND])
+            return true;
+        cur = isRagDecorator(cur) ? cur.inner : undefined;
+    }
+    return false;
+}
+/** Wrap an explicitly configured store (embedding included); idempotent through decorators. */
+export function applyRetrievalStrategy(rag, strategy) {
+    return hasRetrievalStrategy(rag) ? rag : new StrategyRag(rag, strategy);
+}
+/** True when `rag` is `target` or decorates it (through `IRagDecorator.inner`). */
+function decorates(rag, target) {
+    let cur = rag;
+    for (let depth = 0; cur && depth < 16; depth++) {
+        if (cur === target)
+            return true;
+        cur = isRagDecorator(cur) ? cur.inner : undefined;
+    }
+    return false;
+}
+/**
+ * The store an agent queries for one of its built-in slots (`tools`, `history`).
+ * The agent's OWN store always has priority: the projected entry is used only
+ * when it carries a retrieval strategy and decorates `own` (so layers such as
+ * the circuit-breaker fallback are kept); otherwise `ownWithStrategy` — `own`
+ * with the explicit strategy applied once by the caller, or `own` itself. A
+ * projected entry over another agent's store (a worker sharing its parent's
+ * registry) never wins. Internal; not re-exported.
+ */
+export function ownBuiltInStore(own, ownWithStrategy, projected) {
+    return projected &&
+        hasRetrievalStrategy(projected) &&
+        decorates(projected, own)
+        ? projected
+        : ownWithStrategy;
+}
+//# sourceMappingURL=strategy-rag.js.map

package/dist/retrieval/strategy-rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-rag.js","sourceRoot":"","sources":["../../src/retrieval/strategy-rag.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,cAAc,GAIf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAEvD,kGAAkG;AAClG,MAAM,OAAO,WAAW;IAGX;IACA;IAHF,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACxB,YACW,KAAW,EACX,QAA4B;QAD5B,UAAK,GAAL,KAAK,CAAM;QACX,aAAQ,GAAR,QAAQ,CAAoB;IACpC,CAAC;IACJ,KAAK,CACH,SAA0B,EAC1B,CAAS,EACT,OAAqB;QAErB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,WAAW,CAAC,OAAqB;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CACL,EAAU,EACV,OAAqB;QAErB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;IAC/B,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,GAAS;IAC5C,IAAI,GAAG,GAAqB,GAAG,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,IAAK,GAA6B,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACvD,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,sBAAsB,CACpC,GAAS,EACT,QAA4B;IAE5B,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,mFAAmF;AACnF,SAAS,SAAS,CAAC,GAAS,EAAE,MAAY;IACxC,IAAI,GAAG,GAAqB,GAAG,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAS,EACT,eAAqB,EACrB,SAA2B;IAE3B,OAAO,SAAS;QACd,oBAAoB,CAAC,SAAS,CAAC;QAC/B,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC;AACtB,CAAC"}

package/dist/util/assert-positive-integer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Throw unless `v` is a finite positive integer (NaN, Infinity, 0, negatives
+ * and fractions are refused). Used by constructors whose numeric options size
+ * loops: `Math.max(1, NaN)` is NaN, and a NaN loop bound runs nothing.
+ */
+export declare function assertPositiveInteger(cls: string, field: string, v: number): void;
+//# sourceMappingURL=assert-positive-integer.d.ts.map

package/dist/util/assert-positive-integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-positive-integer.d.ts","sourceRoot":"","sources":["../../src/util/assert-positive-integer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,MAAM,GACR,IAAI,CAIN"}

package/dist/util/assert-positive-integer.js

@@ -0,0 +1,11 @@
+/**
+ * Throw unless `v` is a finite positive integer (NaN, Infinity, 0, negatives
+ * and fractions are refused). Used by constructors whose numeric options size
+ * loops: `Math.max(1, NaN)` is NaN, and a NaN loop bound runs nothing.
+ */
+export function assertPositiveInteger(cls, field, v) {
+    if (!Number.isInteger(v) || v < 1) {
+        throw new Error(`${cls}: ${field} must be a positive integer (got ${v})`);
+    }
+}
+//# sourceMappingURL=assert-positive-integer.js.map

package/dist/util/assert-positive-integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-positive-integer.js","sourceRoot":"","sources":["../../src/util/assert-positive-integer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAW,EACX,KAAa,EACb,CAAS;IAET,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,KAAK,KAAK,oCAAoC,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/utils/with-abort.d.ts

@@ -0,0 +1,8 @@
+import type { SmartAgentError } from '@mcp-abap-adt/llm-agent';
+/**
+ * Race `promise` against the caller's abort signal. The `abort` listener is
+ * removed from the signal once the race settles (resolve, reject or abort), so
+ * a long-lived signal does not accumulate one listener per call.
+ */
+export declare function withAbort<T>(promise: Promise<T>, signal: AbortSignal | undefined, makeError: () => SmartAgentError): Promise<T>;
+//# sourceMappingURL=with-abort.d.ts.map

package/dist/utils/with-abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-abort.d.ts","sourceRoot":"","sources":["../../src/utils/with-abort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,eAAe,GAC/B,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/utils/with-abort.js

@@ -0,0 +1,21 @@
+/**
+ * Race `promise` against the caller's abort signal. The `abort` listener is
+ * removed from the signal once the race settles (resolve, reject or abort), so
+ * a long-lived signal does not accumulate one listener per call.
+ */
+export function withAbort(promise, signal, makeError) {
+    if (!signal)
+        return promise;
+    if (signal.aborted)
+        return Promise.reject(makeError());
+    let onAbort;
+    const aborted = new Promise((_, reject) => {
+        onAbort = () => reject(makeError());
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+    return Promise.race([promise, aborted]).finally(() => {
+        if (onAbort)
+            signal.removeEventListener('abort', onAbort);
+    });
+}
+//# sourceMappingURL=with-abort.js.map

package/dist/utils/with-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-abort.js","sourceRoot":"","sources":["../../src/utils/with-abort.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,OAAmB,EACnB,MAA+B,EAC/B,SAAgC;IAEhC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,IAAI,OAAiC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACnD,IAAI,OAAO;YAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/llm-agent-libs",
-  "version": "30.0.0",
+  "version": "30.1.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -44,8 +44,8 @@
   "license": "LGPL-3.0-only",
   "peerDependencies": {
     "@mcp-abap-adt/interfaces-auth": "^2.1.0",
-    "@mcp-abap-adt/llm-agent": "^30.0.0",
-    "@mcp-abap-adt/llm-agent-mcp": "^30.0.0",
-    "@mcp-abap-adt/llm-agent-rag": "^30.0.0"
+    "@mcp-abap-adt/llm-agent": "^30.1.0",
+    "@mcp-abap-adt/llm-agent-mcp": "^30.1.0",
+    "@mcp-abap-adt/llm-agent-rag": "^30.1.0"
   }
 }