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

package/dist/reranker/llm-reranker.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-reranker.js","sourceRoot":"","sources":["../../src/reranker/llm-reranker.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,QAAQ,GAGT,MAAM,yBAAyB,CAAC;AAGjC,MAAM,oBAAoB,GAAG;;;;;+BAKE,CAAC;AAEhC,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,GAAS;QAAT,QAAG,GAAH,GAAG,CAAM;IAAG,CAAC;IAE1C,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAoB,EACpB,OAAqB;QAErB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAExE,MAAM,UAAU,GAAG,UAAU,KAAK,kBAAkB,QAAQ,EAAE,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAC7B;gBACE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,oBAAoB,EAAE;gBAC1D,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,UAAU,EAAE;aAC/C,EACD,EAAE,EACF,OAAO,CACR,CAAC;YAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC;iBACvD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAEpE,MAAM,QAAQ,GAAG,OAAO;iBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;iBAChD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAErC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,aAAqB;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAa,CAAC;YAChD,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QACD,uCAAuC;QACvC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF"}
+{"version":3,"file":"llm-reranker.js","sourceRoot":"","sources":["../../src/reranker/llm-reranker.ts"],"names":[],"mappings":"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"}

package/dist/resilience/rate-limiter-llm.d.ts

@@ -1,8 +1,9 @@
 /**
  * RateLimiterLlm — ILlm decorator that throttles outbound requests.
  *
- * Composition order: RateLimiterLlm → RetryLlm → CircuitBreakerLlm → LlmAdapter
- * Rate limiter sits outermost so that retry attempts also respect the limit.
+ * Composition order: RateLimiterLlm → CircuitBreakerLlm → RetryLlm → LlmAdapter
+ * Rate limiter sits outermost: it takes one permit per outer call, so retry
+ * attempts below it are not counted against the window.
  */
 import type { CallOptions, ILlm, ILlmRateLimiter, LlmError, LlmResponse, LlmStreamChunk, LlmTool, Message, Result } from '@mcp-abap-adt/llm-agent';
 export declare class RateLimiterLlm implements ILlm {

package/dist/resilience/rate-limiter-llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter-llm.d.ts","sourceRoot":"","sources":["../../src/resilience/rate-limiter-llm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,WAAW,EACX,cAAc,EACd,OAAO,EACP,OAAO,EACP,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,cAAe,YAAW,IAAI;IAIvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAGf,KAAK,EAAE,IAAI,EACX,OAAO,EAAE,eAAe;IAO3C,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;IAKlC,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;CAInD"}
+{"version":3,"file":"rate-limiter-llm.d.ts","sourceRoot":"","sources":["../../src/resilience/rate-limiter-llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,WAAW,EACX,cAAc,EACd,OAAO,EACP,OAAO,EACP,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,cAAe,YAAW,IAAI;IAIvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAGf,KAAK,EAAE,IAAI,EACX,OAAO,EAAE,eAAe;IAO3C,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;IAKlC,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;CAInD"}

package/dist/resilience/rate-limiter-llm.js

@@ -1,8 +1,9 @@
 /**
  * RateLimiterLlm — ILlm decorator that throttles outbound requests.
  *
- * Composition order: RateLimiterLlm → RetryLlm → CircuitBreakerLlm → LlmAdapter
- * Rate limiter sits outermost so that retry attempts also respect the limit.
+ * Composition order: RateLimiterLlm → CircuitBreakerLlm → RetryLlm → LlmAdapter
+ * Rate limiter sits outermost: it takes one permit per outer call, so retry
+ * attempts below it are not counted against the window.
  */
 export class RateLimiterLlm {
     inner;

package/dist/resilience/rate-limiter-llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter-llm.js","sourceRoot":"","sources":["../../src/resilience/rate-limiter-llm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,OAAO,cAAc;IAIN;IACA;IAJnB,WAAW,CAAuB;IAElC,YACmB,KAAW,EACX,OAAwB;QADxB,UAAK,GAAL,KAAK,CAAM;QACX,YAAO,GAAP,OAAO,CAAiB;QAEzC,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,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"rate-limiter-llm.js","sourceRoot":"","sources":["../../src/resilience/rate-limiter-llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,MAAM,OAAO,cAAc;IAIN;IACA;IAJnB,WAAW,CAAuB;IAElC,YACmB,KAAW,EACX,OAAwB;QADxB,UAAK,GAAL,KAAK,CAAM;QACX,YAAO,GAAP,OAAO,CAAiB;QAEzC,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,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF"}

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":"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"}

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/skills/plugin-host/compatible-skills-rag.d.ts

@@ -1,7 +1,8 @@
-import type { IEmbedder, ISkillsRagBackend, ISkillsRagHandle } from '@mcp-abap-adt/llm-agent';
+import type { IQueryEmbedder, ISkillsRagBackend, ISkillsRagHandle } from '@mcp-abap-adt/llm-agent';
 export interface CompatibleSkillsRagDeps {
     backend: ISkillsRagBackend;
-    embedder: IEmbedder;
+    /** Embeds the recall text (and probes the dimension): the query role. */
+    embedder: IQueryEmbedder;
     embeddingSpaceId: string;
     retrievalSchemaVersion: number;
     dimension?: number;

package/dist/skills/plugin-host/compatible-skills-rag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compatible-skills-rag.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/compatible-skills-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;qFAEiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,uBAAuB,GAC5B,gBAAgB,CA4FlB"}
+{"version":3,"file":"compatible-skills-rag.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/compatible-skills-rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;qFAEiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,uBAAuB,GAC5B,gBAAgB,CA4FlB"}

package/dist/skills/plugin-host/compatible-skills-rag.js

@@ -9,7 +9,7 @@ export function makeCompatibleSkillsRag(deps) {
     });
     async function ensureDimension(options) {
         if (dimension === undefined) {
-            const probe = await deps.embedder.embed('dimension probe', options);
+            const probe = await deps.embedder.embedQuery('dimension probe', options);
             dimension = probe.vector.length;
         }
     }
@@ -54,7 +54,7 @@ export function makeCompatibleSkillsRag(deps) {
             try {
                 if (!compatible(snap))
                     return []; // no embed on incompatible
-                const { vector } = await deps.embedder.embed(text, options); // PAID step, last
+                const { vector } = await deps.embedder.embedQuery(text, options); // PAID step, last
                 // Bound the vector read with a DEADLINE so it cannot outlive a time-grace backend's
                 // retention window (P1.4). For the exact-lease backend recallTimeoutMs is omitted.
                 const sigs = [

package/dist/skills/plugin-host/compatible-skills-rag.js.map

@@ -1 +1 @@
-{"version":3,"file":"compatible-skills-rag.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/compatible-skills-rag.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compatible-skills-rag.js","sourceRoot":"","sources":["../../../src/skills/plugin-host/compatible-skills-rag.ts"],"names":[],"mappings":"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"}

package/dist/skills/plugin-host/skill-plugin-host.d.ts

@@ -1,11 +1,11 @@
-import type { IEmbedder, ISkillPluginHost, ISkillSource, ISkillsRagBackendProvider, ISkillsStoreProvider } from '@mcp-abap-adt/llm-agent';
+import type { IQueryEmbedder, ISkillPluginHost, ISkillSource, ISkillsRagBackendProvider, ISkillsStoreProvider } from '@mcp-abap-adt/llm-agent';
 /** RECALL-ONLY construction: serves an already-materialised catalog through a READ-ONLY
  *  backend provider (least privilege — no source, no store, no write/reconcile API). The
  *  served collections are materialised out-of-band by a SEPARATE ingest job. */
 export interface RecallHostDeps {
     backendProvider: ISkillsRagBackendProvider;
     /** Serving embedder — text query embed + lazy dimension probe. */
-    embedder: IEmbedder;
+    embedder: IQueryEmbedder;
     embeddingSpaceId: string;
     retrievalSchemaVersion: number;
     dimension?: number;
@@ -22,8 +22,9 @@ export interface IngestHostDeps {
         source: ISkillSource;
     }>;
     storeProvider: ISkillsStoreProvider;
-    /** Serving embedder (also used to vectorise upserts via the provider). */
-    embedder: IEmbedder;
+    /** Serving embedder: recall text + dimension probe (the store provider
+     *  writes skills with its own `embed`). */
+    embedder: IQueryEmbedder;
     embeddingSpaceId: string;
     retrievalSchemaVersion: number;
     dimension?: number;

package/dist/skills/plugin-host/skill-plugin-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-plugin-host.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/skill-plugin-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EAEzB,oBAAoB,EAMrB,MAAM,yBAAyB,CAAC;AAIjC;;gFAEgF;AAChF,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,kEAAkE;IAClE,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;iFAC6E;IAC7E,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,cAAc,CAAC;AAMlE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7D,aAAa,EAAE,oBAAoB,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAeD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,mBAAmB,GACxB,gBAAgB,CAGlB"}
+{"version":3,"file":"skill-plugin-host.d.ts","sourceRoot":"","sources":["../../../src/skills/plugin-host/skill-plugin-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EAEzB,oBAAoB,EAMrB,MAAM,yBAAyB,CAAC;AAIjC;;gFAEgF;AAChF,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,kEAAkE;IAClE,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;iFAC6E;IAC7E,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,cAAc,CAAC;AAMlE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7D,aAAa,EAAE,oBAAoB,CAAC;IACpC;+CAC2C;IAC3C,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAeD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,mBAAmB,GACxB,gBAAgB,CAGlB"}

package/dist/skills/plugin-host/skill-plugin-host.js

@@ -116,7 +116,7 @@ function makeIngestHost(deps) {
     let resolvedDimension = deps.dimension;
     async function ensureDimension(options) {
         if (resolvedDimension === undefined) {
-            const probe = await deps.embedder.embed('dimension probe', options);
+            const probe = await deps.embedder.embedQuery('dimension probe', options);
             resolvedDimension = probe.vector.length;
         }
         return resolvedDimension;