@mcp-abap-adt/llm-agent-server 10.0.0

package/dist/smart-agent/resilience/circuit-breaker-llm.js

@@ -0,0 +1,72 @@
+/**
+ * CircuitBreakerLlm — ILlm decorator that wraps calls with a CircuitBreaker.
+ *
+ * When the circuit is open, calls return `Result { ok: false, error: LlmError('CIRCUIT_OPEN') }`
+ * without hitting the underlying LLM.
+ */
+import { LlmError, } from '@mcp-abap-adt/llm-agent';
+export class CircuitBreakerLlm {
+    inner;
+    breaker;
+    healthCheck;
+    constructor(inner, breaker) {
+        this.inner = inner;
+        this.breaker = breaker;
+        if (inner.healthCheck) {
+            this.healthCheck = inner.healthCheck.bind(inner);
+        }
+    }
+    get model() {
+        return this.inner.model;
+    }
+    async chat(messages, tools, options) {
+        if (!this.breaker.isCallPermitted) {
+            return {
+                ok: false,
+                error: new LlmError('Circuit breaker is open', 'CIRCUIT_OPEN'),
+            };
+        }
+        const result = await this.inner.chat(messages, tools, options);
+        if (result.ok) {
+            this.breaker.recordSuccess();
+        }
+        else {
+            this.breaker.recordFailure();
+        }
+        return result;
+    }
+    async *streamChat(messages, tools, options) {
+        if (!this.breaker.isCallPermitted) {
+            yield {
+                ok: false,
+                error: new LlmError('Circuit breaker is open', 'CIRCUIT_OPEN'),
+            };
+            return;
+        }
+        let hadError = false;
+        try {
+            for await (const chunk of this.inner.streamChat(messages, tools, options)) {
+                if (!chunk.ok) {
+                    hadError = true;
+                    this.breaker.recordFailure();
+                    yield chunk;
+                    return;
+                }
+                yield chunk;
+            }
+        }
+        catch (err) {
+            hadError = true;
+            this.breaker.recordFailure();
+            yield {
+                ok: false,
+                error: new LlmError(String(err), 'LLM_ERROR'),
+            };
+            return;
+        }
+        if (!hadError) {
+            this.breaker.recordSuccess();
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker-llm.js.map

package/dist/smart-agent/resilience/circuit-breaker-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker-llm.js","sourceRoot":"","sources":["../../../src/smart-agent/resilience/circuit-breaker-llm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,QAAQ,GAKT,MAAM,yBAAyB,CAAC;AAGjC,MAAM,OAAO,iBAAiB;IAIT;IACR;IAJX,WAAW,CAAuB;IAElC,YACmB,KAAW,EACnB,OAAuB;QADf,UAAK,GAAL,KAAK,CAAM;QACnB,YAAO,GAAP,OAAO,CAAgB;QAEhC,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,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAClC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,yBAAyB,EAAE,cAAc,CAAC;aAC/D,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,QAAmB,EACnB,KAAiB,EACjB,OAAqB;QAErB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAClC,MAAM;gBACJ,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,yBAAyB,EAAE,cAAc,CAAC;aAC/D,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAC7C,QAAQ,EACR,KAAK,EACL,OAAO,CACR,EAAE,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;oBACd,QAAQ,GAAG,IAAI,CAAC;oBAChB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;oBAC7B,MAAM,KAAK,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC7B,MAAM;gBACJ,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;aAC9C,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/dist/smart-agent/resilience/circuit-breaker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generic Circuit Breaker — three-state pattern (closed → open → half-open).
+ *
+ * - **Closed**: requests pass through; failures are counted.
+ * - **Open**: requests are rejected immediately; after `recoveryWindowMs` the
+ *   breaker transitions to half-open.
+ * - **Half-Open**: a single probe request is allowed. If it succeeds the
+ *   breaker closes; if it fails it re-opens.
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    /** Number of consecutive failures before opening. Default: 5 */
+    failureThreshold?: number;
+    /** Time (ms) to wait before probing again. Default: 30 000 */
+    recoveryWindowMs?: number;
+    /** Optional callback on state changes. */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+export declare class CircuitBreaker {
+    private _state;
+    private failureCount;
+    private openedAt;
+    readonly failureThreshold: number;
+    readonly recoveryWindowMs: number;
+    private readonly onStateChange?;
+    constructor(config?: CircuitBreakerConfig);
+    get state(): CircuitState;
+    /** Record a successful call — resets the breaker to closed. */
+    recordSuccess(): void;
+    /** Record a failed call — may trip the breaker open. */
+    recordFailure(): void;
+    /** Whether the circuit allows requests through. */
+    get isCallPermitted(): boolean;
+    private _transition;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/smart-agent/resilience/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;CAChE;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAK;IAErB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAGrB;gBAEE,MAAM,GAAE,oBAAyB;IAM7C,IAAI,KAAK,IAAI,YAAY,CAQxB;IAED,+DAA+D;IAC/D,aAAa,IAAI,IAAI;IAOrB,wDAAwD;IACxD,aAAa,IAAI,IAAI;IAWrB,mDAAmD;IACnD,IAAI,eAAe,IAAI,OAAO,CAG7B;IAED,OAAO,CAAC,WAAW;CAOpB"}

package/dist/smart-agent/resilience/circuit-breaker.js

@@ -0,0 +1,60 @@
+/**
+ * Generic Circuit Breaker — three-state pattern (closed → open → half-open).
+ *
+ * - **Closed**: requests pass through; failures are counted.
+ * - **Open**: requests are rejected immediately; after `recoveryWindowMs` the
+ *   breaker transitions to half-open.
+ * - **Half-Open**: a single probe request is allowed. If it succeeds the
+ *   breaker closes; if it fails it re-opens.
+ */
+export class CircuitBreaker {
+    _state = 'closed';
+    failureCount = 0;
+    openedAt = 0;
+    failureThreshold;
+    recoveryWindowMs;
+    onStateChange;
+    constructor(config = {}) {
+        this.failureThreshold = config.failureThreshold ?? 5;
+        this.recoveryWindowMs = config.recoveryWindowMs ?? 30_000;
+        this.onStateChange = config.onStateChange;
+    }
+    get state() {
+        if (this._state === 'open' &&
+            Date.now() - this.openedAt >= this.recoveryWindowMs) {
+            this._transition('half-open');
+        }
+        return this._state;
+    }
+    /** Record a successful call — resets the breaker to closed. */
+    recordSuccess() {
+        if (this._state !== 'closed') {
+            this._transition('closed');
+        }
+        this.failureCount = 0;
+    }
+    /** Record a failed call — may trip the breaker open. */
+    recordFailure() {
+        this.failureCount++;
+        if (this._state === 'half-open' ||
+            this.failureCount >= this.failureThreshold) {
+            this._transition('open');
+            this.openedAt = Date.now();
+        }
+    }
+    /** Whether the circuit allows requests through. */
+    get isCallPermitted() {
+        const s = this.state; // triggers half-open check
+        return s === 'closed' || s === 'half-open';
+    }
+    _transition(to) {
+        if (this._state === to)
+            return;
+        const from = this._state;
+        this._state = to;
+        if (to === 'closed')
+            this.failureCount = 0;
+        this.onStateChange?.(from, to);
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/smart-agent/resilience/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/smart-agent/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,OAAO,cAAc;IACjB,MAAM,GAAiB,QAAQ,CAAC;IAChC,YAAY,GAAG,CAAC,CAAC;IACjB,QAAQ,GAAG,CAAC,CAAC;IAEZ,gBAAgB,CAAS;IACzB,gBAAgB,CAAS;IACjB,aAAa,CAGpB;IAEV,YAAY,SAA+B,EAAE;QAC3C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC;QAC1D,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK;QACP,IACE,IAAI,CAAC,MAAM,KAAK,MAAM;YACtB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EACnD,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,+DAA+D;IAC/D,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,wDAAwD;IACxD,aAAa;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IACE,IAAI,CAAC,MAAM,KAAK,WAAW;YAC3B,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,gBAAgB,EAC1C,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,eAAe;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,2BAA2B;QACjD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,WAAW,CAAC;IAC7C,CAAC;IAEO,WAAW,CAAC,EAAgB;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE;YAAE,OAAO;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,EAAE,KAAK,QAAQ;YAAE,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/smart-agent/resilience/fallback-rag.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FallbackRag — IRag decorator wrapping a primary and fallback store.
+ *
+ * - **write** — writes go through writer(); fans out to both stores (best-effort for fallback).
+ * - **query** — uses primary when the embedder breaker is closed/half-open;
+ *   routes to fallback when the breaker is open.
+ * - **healthCheck** — delegates to primary.
+ */
+import type { CallOptions, IQueryEmbedding, IRag, IRagBackendWriter, RagError, RagResult, Result } from '@mcp-abap-adt/llm-agent';
+import type { CircuitBreaker } from './circuit-breaker.js';
+export declare class FallbackRag implements IRag {
+    private readonly primary;
+    private readonly fallback;
+    private readonly embedderBreaker;
+    constructor(primary: IRag, fallback: IRag, embedderBreaker: CircuitBreaker);
+    getById(id: string, options?: CallOptions): Promise<Result<RagResult | null, RagError>>;
+    query(embedding: IQueryEmbedding, k: number, options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+    healthCheck(options?: CallOptions): Promise<Result<void, RagError>>;
+    writer(): IRagBackendWriter | undefined;
+}
+//# sourceMappingURL=fallback-rag.d.ts.map

package/dist/smart-agent/resilience/fallback-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-rag.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/resilience/fallback-rag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,IAAI,EACJ,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,MAAM,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,WAAY,YAAW,IAAI;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFf,OAAO,EAAE,IAAI,EACb,QAAQ,EAAE,IAAI,EACd,eAAe,EAAE,cAAc;IAG5C,OAAO,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC;IAMxC,KAAK,CACT,SAAS,EAAE,eAAe,EAC1B,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IAOnC,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAIzE,MAAM,IAAI,iBAAiB,GAAG,SAAS;CA2CxC"}

package/dist/smart-agent/resilience/fallback-rag.js

@@ -0,0 +1,80 @@
+/**
+ * FallbackRag — IRag decorator wrapping a primary and fallback store.
+ *
+ * - **write** — writes go through writer(); fans out to both stores (best-effort for fallback).
+ * - **query** — uses primary when the embedder breaker is closed/half-open;
+ *   routes to fallback when the breaker is open.
+ * - **healthCheck** — delegates to primary.
+ */
+export class FallbackRag {
+    primary;
+    fallback;
+    embedderBreaker;
+    constructor(primary, fallback, embedderBreaker) {
+        this.primary = primary;
+        this.fallback = fallback;
+        this.embedderBreaker = embedderBreaker;
+    }
+    async getById(id, options) {
+        const res = await this.primary.getById(id, options);
+        if (res.ok && res.value !== null)
+            return res;
+        return this.fallback.getById(id, options);
+    }
+    async query(embedding, k, options) {
+        if (this.embedderBreaker.state === 'open') {
+            return this.fallback.query(embedding, k, options);
+        }
+        return this.primary.query(embedding, k, options);
+    }
+    async healthCheck(options) {
+        return this.primary.healthCheck(options);
+    }
+    writer() {
+        const pw = this.primary.writer?.();
+        const fw = this.fallback.writer?.();
+        if (!pw && !fw)
+            return undefined;
+        return {
+            upsertRaw: async (id, text, metadata, options) => {
+                const pres = pw
+                    ? await pw.upsertRaw(id, text, metadata, options)
+                    : { ok: true, value: undefined };
+                if (fw)
+                    fw.upsertRaw(id, text, metadata, options).catch(() => { });
+                return pres;
+            },
+            deleteByIdRaw: async (id, options) => {
+                const pres = pw
+                    ? await pw.deleteByIdRaw(id, options)
+                    : { ok: true, value: false };
+                if (fw)
+                    fw.deleteByIdRaw(id, options).catch(() => { });
+                return pres;
+            },
+            clearAll: async () => {
+                const pres = pw?.clearAll
+                    ? await pw.clearAll()
+                    : { ok: true, value: undefined };
+                if (fw?.clearAll)
+                    fw.clearAll().catch(() => { });
+                return pres;
+            },
+            upsertPrecomputedRaw: async (id, text, vector, metadata, options) => {
+                const pres = pw?.upsertPrecomputedRaw
+                    ? await pw.upsertPrecomputedRaw(id, text, vector, metadata, options)
+                    : pw
+                        ? await pw.upsertRaw(id, text, metadata, options)
+                        : { ok: true, value: undefined };
+                if (fw?.upsertPrecomputedRaw) {
+                    fw.upsertPrecomputedRaw(id, text, vector, metadata, options).catch(() => { });
+                }
+                else if (fw) {
+                    fw.upsertRaw(id, text, metadata, options).catch(() => { });
+                }
+                return pres;
+            },
+        };
+    }
+}
+//# sourceMappingURL=fallback-rag.js.map

package/dist/smart-agent/resilience/fallback-rag.js.map

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

package/dist/smart-agent/resilience/index.d.ts

@@ -0,0 +1,5 @@
+export { CircuitBreaker, type CircuitBreakerConfig, type CircuitState, } from './circuit-breaker.js';
+export { CircuitBreakerEmbedder } from './circuit-breaker-embedder.js';
+export { CircuitBreakerLlm } from './circuit-breaker-llm.js';
+export { FallbackRag } from './fallback-rag.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/smart-agent/resilience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/resilience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/smart-agent/resilience/index.js

@@ -0,0 +1,5 @@
+export { CircuitBreaker, } from './circuit-breaker.js';
+export { CircuitBreakerEmbedder } from './circuit-breaker-embedder.js';
+export { CircuitBreakerLlm } from './circuit-breaker-llm.js';
+export { FallbackRag } from './fallback-rag.js';
+//# sourceMappingURL=index.js.map

package/dist/smart-agent/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/smart-agent/resilience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+import type { CallOptions, ILlm, ILlmRateLimiter, LlmError, LlmResponse, LlmStreamChunk, LlmTool, Message, Result } from '@mcp-abap-adt/llm-agent';
+export declare class RateLimiterLlm implements ILlm {
+    private readonly inner;
+    private readonly limiter;
+    healthCheck?: ILlm['healthCheck'];
+    constructor(inner: ILlm, limiter: ILlmRateLimiter);
+    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>>;
+}
+//# sourceMappingURL=rate-limiter-llm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter-llm.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/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"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+export class RateLimiterLlm {
+    inner;
+    limiter;
+    healthCheck;
+    constructor(inner, limiter) {
+        this.inner = inner;
+        this.limiter = limiter;
+        if (inner.healthCheck) {
+            this.healthCheck = inner.healthCheck.bind(inner);
+        }
+    }
+    get model() {
+        return this.inner.model;
+    }
+    async chat(messages, tools, options) {
+        await this.limiter.acquire();
+        return this.inner.chat(messages, tools, options);
+    }
+    async *streamChat(messages, tools, options) {
+        await this.limiter.acquire();
+        yield* this.inner.streamChat(messages, tools, options);
+    }
+}
+//# sourceMappingURL=rate-limiter-llm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter-llm.js","sourceRoot":"","sources":["../../../src/smart-agent/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"}

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

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+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';
+export interface RetryOptions {
+    /** Maximum number of retry attempts (total calls = maxAttempts + 1). Default: 3. */
+    maxAttempts: number;
+    /** Initial backoff delay in ms. Doubles each attempt. Default: 2000. */
+    backoffMs: number;
+    /** HTTP status codes that trigger retry. Default: [429, 500, 502, 503]. */
+    retryOn: number[];
+    /** Substrings in error message that trigger mid-stream retry (replays entire stream). Default: []. */
+    retryOnMidStream: string[];
+}
+export declare class RetryLlm implements ILlm {
+    private readonly inner;
+    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>>;
+    private isRetryable;
+    private isMidStreamRetryable;
+    private backoff;
+}
+//# sourceMappingURL=retry-llm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry-llm.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/resilience/retry-llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,KAAK,WAAW,EAChB,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;IAKnB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,OAAO;CAchB"}

package/dist/smart-agent/resilience/retry-llm.js

@@ -0,0 +1,103 @@
+/**
+ * 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.
+ */
+import { LlmError, } from '@mcp-abap-adt/llm-agent';
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    backoffMs: 2000,
+    retryOn: [429, 500, 502, 503],
+    retryOnMidStream: [],
+};
+export class RetryLlm {
+    inner;
+    opts;
+    healthCheck;
+    constructor(inner, options) {
+        this.inner = inner;
+        this.opts = { ...DEFAULT_OPTIONS, ...options };
+        if (inner.healthCheck) {
+            this.healthCheck = inner.healthCheck.bind(inner);
+        }
+    }
+    get model() {
+        return this.inner.model;
+    }
+    async chat(messages, tools, options) {
+        for (let attempt = 0;; attempt++) {
+            if (options?.signal?.aborted) {
+                return { ok: false, error: new LlmError('Aborted', 'ABORTED') };
+            }
+            const result = await this.inner.chat(messages, tools, options);
+            if (result.ok ||
+                attempt >= this.opts.maxAttempts ||
+                !this.isRetryable(result.error)) {
+                return result;
+            }
+            await this.backoff(attempt, options?.signal);
+        }
+    }
+    async *streamChat(messages, tools, options) {
+        for (let attempt = 0;; attempt++) {
+            if (options?.signal?.aborted) {
+                yield { ok: false, error: new LlmError('Aborted', 'ABORTED') };
+                return;
+            }
+            let chunksYielded = 0;
+            let shouldRetry = false;
+            for await (const chunk of this.inner.streamChat(messages, tools, options)) {
+                if (chunk.ok) {
+                    chunksYielded++;
+                    yield chunk;
+                }
+                else {
+                    const canRetry = attempt < this.opts.maxAttempts;
+                    // Pre-stream failure: retry on HTTP status codes (existing behavior)
+                    if (chunksYielded === 0 &&
+                        canRetry &&
+                        this.isRetryable(chunk.error)) {
+                        shouldRetry = true;
+                        break;
+                    }
+                    // Mid-stream failure: retry on configured substrings
+                    if (chunksYielded > 0 &&
+                        canRetry &&
+                        this.isMidStreamRetryable(chunk.error)) {
+                        yield { ok: true, value: { content: '', reset: true } };
+                        shouldRetry = true;
+                        break;
+                    }
+                    yield chunk;
+                    return;
+                }
+            }
+            if (!shouldRetry)
+                return;
+            await this.backoff(attempt, options?.signal);
+        }
+    }
+    isRetryable(error) {
+        const msg = error.message;
+        return this.opts.retryOn.some((code) => msg.includes(String(code)));
+    }
+    isMidStreamRetryable(error) {
+        if (this.opts.retryOnMidStream.length === 0)
+            return false;
+        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 });
+        });
+    }
+}
+//# sourceMappingURL=retry-llm.js.map

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

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

package/dist/smart-agent/resilience/token-bucket-rate-limiter.d.ts

@@ -0,0 +1,21 @@
+import type { ILlmRateLimiter } from '@mcp-abap-adt/llm-agent';
+export interface TokenBucketConfig {
+    /** Maximum requests allowed per window. */
+    maxRequests: number;
+    /** Window duration in milliseconds. Default: 60_000 (1 minute). */
+    windowMs?: number;
+}
+/**
+ * Token-bucket rate limiter.
+ *
+ * Allows up to `maxRequests` in a rolling `windowMs` window.
+ * When the bucket is empty, `acquire()` blocks until a slot frees up.
+ */
+export declare class TokenBucketRateLimiter implements ILlmRateLimiter {
+    private readonly maxRequests;
+    private readonly windowMs;
+    private timestamps;
+    constructor(config: TokenBucketConfig);
+    acquire(): Promise<void>;
+}
+//# sourceMappingURL=token-bucket-rate-limiter.d.ts.map

package/dist/smart-agent/resilience/token-bucket-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket-rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/resilience/token-bucket-rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAgB;gBAEtB,MAAM,EAAE,iBAAiB;IAK/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}

package/dist/smart-agent/resilience/token-bucket-rate-limiter.js

@@ -0,0 +1,32 @@
+/**
+ * Token-bucket rate limiter.
+ *
+ * Allows up to `maxRequests` in a rolling `windowMs` window.
+ * When the bucket is empty, `acquire()` blocks until a slot frees up.
+ */
+export class TokenBucketRateLimiter {
+    maxRequests;
+    windowMs;
+    timestamps = [];
+    constructor(config) {
+        this.maxRequests = config.maxRequests;
+        this.windowMs = config.windowMs ?? 60_000;
+    }
+    async acquire() {
+        const now = Date.now();
+        this.timestamps = this.timestamps.filter((t) => now - t < this.windowMs);
+        if (this.timestamps.length < this.maxRequests) {
+            this.timestamps.push(now);
+            return;
+        }
+        // Wait until the oldest request expires from the window
+        const oldest = this.timestamps[0];
+        const waitMs = oldest + this.windowMs - now + 1;
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        // Clean up and record
+        const after = Date.now();
+        this.timestamps = this.timestamps.filter((t) => after - t < this.windowMs);
+        this.timestamps.push(after);
+    }
+}
+//# sourceMappingURL=token-bucket-rate-limiter.js.map

package/dist/smart-agent/resilience/token-bucket-rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket-rate-limiter.js","sourceRoot":"","sources":["../../../src/smart-agent/resilience/token-bucket-rate-limiter.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAChB,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,UAAU,GAAa,EAAE,CAAC;IAElC,YAAY,MAAyB;QACnC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,CAAC;QAChD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAElE,sBAAsB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/smart-agent/server.d.ts

@@ -0,0 +1,19 @@
+import type { SmartAgent } from './agent.js';
+export interface SmartAgentServerConfig {
+    port?: number;
+    host?: string;
+    requestTimeoutMs?: number;
+}
+export interface SmartAgentServerHandle {
+    port: number;
+    close(): Promise<void>;
+}
+export declare class SmartAgentServer {
+    private readonly agent;
+    private readonly config;
+    constructor(agent: SmartAgent, config?: SmartAgentServerConfig);
+    start(): Promise<SmartAgentServerHandle>;
+    private _handleRequest;
+    private _readBody;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/smart-agent/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/smart-agent/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAOzD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiCD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,sBAA2B;IAGtD,KAAK,IAAI,OAAO,CAAC,sBAAsB,CAAC;YAkC1B,cAAc;IAqW5B,OAAO,CAAC,SAAS;CAQlB"}