@mcp-abap-adt/llm-agent-libs 12.0.2 → 12.0.4

package/dist/providers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Provider resolution — the composition root for concrete LLM implementations.
+ *
+ * This module is the ONLY place that knows about concrete LLM providers.
+ * Embedder and RAG factories live in @mcp-abap-adt/llm-agent-rag.
+ *
+ * LLM provider packages are optional peers loaded via dynamic import().
+ * MissingProviderError is thrown when a required peer is not installed.
+ */
+import type { ILlm, IModelResolver } from '@mcp-abap-adt/llm-agent';
+import type { SapAICoreCredentials } from '@mcp-abap-adt/sap-aicore-llm';
+export interface MakeLlmConfig {
+    provider: 'deepseek' | 'openai' | 'anthropic' | 'sap-ai-sdk';
+    apiKey?: string;
+    /** Custom base URL for OpenAI-compatible endpoints (Azure OpenAI, Ollama, vLLM, etc.). */
+    baseURL?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    resourceGroup?: string;
+    credentials?: SapAICoreCredentials;
+    /** When false, streamChat() is replaced with chat() yielding a single chunk. Default: true. */
+    streaming?: boolean;
+}
+/**
+ * Create an ILlm from a declarative provider config.
+ * This is the only function that knows about concrete LLM implementations.
+ * Provider packages are loaded via dynamic import (optional peers).
+ */
+export declare function makeLlm(cfg: MakeLlmConfig, temperature: number): Promise<ILlm>;
+/**
+ * Create a default DeepSeek-based ILlm from simple config (apiKey + model).
+ * Used by the flat YAML / CLI path.
+ */
+export declare function makeDefaultLlm(apiKey: string, model: string, temperature: number): Promise<ILlm>;
+/**
+ * Default IModelResolver — delegates to makeLlm() with the given provider settings.
+ * Returns fully constructed ILlm instances ready for use with SmartAgent.reconfigure().
+ */
+export declare class DefaultModelResolver implements IModelResolver {
+    private readonly providerConfig;
+    private readonly defaults;
+    constructor(providerConfig: Omit<MakeLlmConfig, 'model'>, defaults?: {
+        temperature?: number;
+    });
+    resolve(modelName: string, role: 'main' | 'classifier' | 'helper'): Promise<ILlm>;
+}
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AASzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAmHD;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAkGf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAEvD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,EAC5C,QAAQ,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAGpD,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GACrC,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/providers.js

@@ -0,0 +1,192 @@
+/**
+ * Provider resolution — the composition root for concrete LLM implementations.
+ *
+ * This module is the ONLY place that knows about concrete LLM providers.
+ * Embedder and RAG factories live in @mcp-abap-adt/llm-agent-rag.
+ *
+ * LLM provider packages are optional peers loaded via dynamic import().
+ * MissingProviderError is thrown when a required peer is not installed.
+ */
+import { MissingProviderError } from '@mcp-abap-adt/llm-agent';
+import { LlmAdapter } from './adapters/llm-adapter.js';
+import { LlmProviderBridge } from './adapters/llm-provider-bridge.js';
+import { NonStreamingLlm } from './adapters/non-streaming-llm.js';
+// ---------------------------------------------------------------------------
+// Per-provider dynamic loaders
+// ---------------------------------------------------------------------------
+function isMissingOptionalPeer(err, pkg) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.code;
+    if (code === 'ERR_MODULE_NOT_FOUND')
+        return true;
+    if (err.message.includes(pkg) &&
+        err.message.toLowerCase().includes('cannot find'))
+        return true;
+    return false;
+}
+async function loadOpenAI() {
+    const pkg = '@mcp-abap-adt/openai-llm';
+    try {
+        const mod = await import(pkg);
+        return mod.OpenAIProvider;
+    }
+    catch (err) {
+        if (isMissingOptionalPeer(err, pkg))
+            throw new MissingProviderError(pkg, 'openai');
+        throw err;
+    }
+}
+async function loadDeepSeek() {
+    const pkg = '@mcp-abap-adt/deepseek-llm';
+    try {
+        const mod = await import(pkg);
+        return mod.DeepSeekProvider;
+    }
+    catch (err) {
+        if (isMissingOptionalPeer(err, pkg))
+            throw new MissingProviderError(pkg, 'deepseek');
+        throw err;
+    }
+}
+async function loadAnthropic() {
+    const pkg = '@mcp-abap-adt/anthropic-llm';
+    try {
+        const mod = await import(pkg);
+        return mod.AnthropicProvider;
+    }
+    catch (err) {
+        if (isMissingOptionalPeer(err, pkg))
+            throw new MissingProviderError(pkg, 'anthropic');
+        throw err;
+    }
+}
+async function loadSapAiCore() {
+    const pkg = '@mcp-abap-adt/sap-aicore-llm';
+    try {
+        const mod = await import(pkg);
+        return mod.SapCoreAIProvider;
+    }
+    catch (err) {
+        if (isMissingOptionalPeer(err, pkg))
+            throw new MissingProviderError(pkg, 'sap-ai-sdk');
+        throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// makeLlm — async, dynamic-import based
+// ---------------------------------------------------------------------------
+/**
+ * Create an ILlm from a declarative provider config.
+ * This is the only function that knows about concrete LLM implementations.
+ * Provider packages are loaded via dynamic import (optional peers).
+ */
+export async function makeLlm(cfg, temperature) {
+    // Coerce numeric fields that may arrive as strings from ${ENV_VAR} substitution
+    const maxTokens = cfg.maxTokens != null ? Number(cfg.maxTokens) : undefined;
+    let llm;
+    switch (cfg.provider) {
+        case 'deepseek': {
+            const DeepSeekProvider = await loadDeepSeek();
+            const provider = new DeepSeekProvider({
+                apiKey: cfg.apiKey,
+                baseURL: cfg.baseURL,
+                model: cfg.model,
+                temperature,
+                maxTokens,
+            });
+            llm = new LlmAdapter(new LlmProviderBridge(provider), {
+                model: provider.model,
+                getModels: () => provider.getModels?.() ?? Promise.resolve([]),
+                getEmbeddingModels: () => provider.getEmbeddingModels?.() ?? Promise.resolve([]),
+            });
+            break;
+        }
+        case 'openai': {
+            const OpenAIProvider = await loadOpenAI();
+            const provider = new OpenAIProvider({
+                apiKey: cfg.apiKey,
+                baseURL: cfg.baseURL,
+                model: cfg.model,
+                temperature,
+                maxTokens,
+            });
+            llm = new LlmAdapter(new LlmProviderBridge(provider), {
+                model: provider.model,
+                getModels: () => provider.getModels?.() ?? Promise.resolve([]),
+                getEmbeddingModels: () => provider.getEmbeddingModels?.() ?? Promise.resolve([]),
+            });
+            break;
+        }
+        case 'anthropic': {
+            const AnthropicProvider = await loadAnthropic();
+            const provider = new AnthropicProvider({
+                apiKey: cfg.apiKey,
+                baseURL: cfg.baseURL,
+                model: cfg.model,
+                temperature,
+                maxTokens,
+            });
+            llm = new LlmAdapter(new LlmProviderBridge(provider), {
+                model: provider.model,
+                getModels: () => provider.getModels?.() ?? Promise.resolve([]),
+                getEmbeddingModels: () => provider.getEmbeddingModels?.() ?? Promise.resolve([]),
+            });
+            break;
+        }
+        case 'sap-ai-sdk': {
+            const SapCoreAIProvider = await loadSapAiCore();
+            const provider = new SapCoreAIProvider({
+                apiKey: cfg.apiKey,
+                model: cfg.model,
+                temperature,
+                maxTokens,
+                resourceGroup: cfg.resourceGroup,
+                credentials: cfg.credentials,
+                log: {
+                    debug: (msg, meta) => process.stderr.write(`[sap-ai-sdk:debug] ${msg} ${meta ? JSON.stringify(meta) : ''}\n`),
+                    error: (msg, meta) => process.stderr.write(`[sap-ai-sdk:error] ${msg} ${meta ? JSON.stringify(meta) : ''}\n`),
+                },
+            });
+            llm = new LlmAdapter(new LlmProviderBridge(provider), {
+                model: provider.model,
+                getModels: () => provider.getModels?.() ?? Promise.resolve([]),
+                getEmbeddingModels: () => provider.getEmbeddingModels?.() ?? Promise.resolve([]),
+            });
+            break;
+        }
+        default: {
+            const _exhaustive = cfg.provider;
+            throw new Error(`Unknown LLM provider: ${_exhaustive}`);
+        }
+    }
+    // Wrap with non-streaming adapter when streaming is disabled for this provider
+    if (cfg.streaming === false) {
+        llm = new NonStreamingLlm(llm);
+    }
+    return llm;
+}
+/**
+ * Create a default DeepSeek-based ILlm from simple config (apiKey + model).
+ * Used by the flat YAML / CLI path.
+ */
+export async function makeDefaultLlm(apiKey, model, temperature) {
+    return makeLlm({ provider: 'deepseek', apiKey, model }, temperature);
+}
+/**
+ * Default IModelResolver — delegates to makeLlm() with the given provider settings.
+ * Returns fully constructed ILlm instances ready for use with SmartAgent.reconfigure().
+ */
+export class DefaultModelResolver {
+    providerConfig;
+    defaults;
+    constructor(providerConfig, defaults = {}) {
+        this.providerConfig = providerConfig;
+        this.defaults = defaults;
+    }
+    async resolve(modelName, role) {
+        const temperature = this.defaults.temperature ?? (role === 'main' ? 0.7 : 0.1);
+        return makeLlm({ ...this.providerConfig, model: modelName }, temperature);
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAoBlE,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,SAAS,qBAAqB,CAAC,GAAY,EAAE,GAAW;IACtD,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;IACjD,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,IAAI,CAAC;IACjD,IACE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAEjD,OAAO,IAAI,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,MAAM,GAAG,GAAG,0BAA0B,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC,cAUsC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,MAAM,GAAG,GAAG,4BAA4B,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC,gBAUsC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAClD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,GAAG,GAAG,6BAA6B,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC,iBAUsC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,GAAG,GAAG,8BAA8B,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC,iBAesC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;YACjC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACpD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAkB,EAClB,WAAmB;IAEnB,gFAAgF;IAChF,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,IAAI,GAAS,CAAC;IAEd,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,gBAAgB,GAAG,MAAM,YAAY,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC;gBACpC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;YACH,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACpD,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,kBAAkB,EAAE,GAAG,EAAE,CACvB,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,cAAc,GAAG,MAAM,UAAU,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;gBAClC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;YACH,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACpD,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,kBAAkB,EAAE,GAAG,EAAE,CACvB,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,iBAAiB,GAAG,MAAM,aAAa,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;gBACrC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;YACH,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACpD,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,kBAAkB,EAAE,GAAG,EAAE,CACvB,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,iBAAiB,GAAG,MAAM,aAAa,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;gBACrC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW;gBACX,SAAS;gBACT,aAAa,EAAE,GAAG,CAAC,aAAa;gBAChC,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,GAAG,EAAE;oBACH,KAAK,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAClE;oBACH,KAAK,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAClE;iBACJ;aACF,CAAC,CAAC;YACH,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACpD,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,kBAAkB,EAAE,GAAG,EAAE,CACvB,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,GAAG,CAAC,QAAQ,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,IAAI,GAAG,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAC5B,GAAG,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAa,EACb,WAAmB;IAEnB,OAAO,OAAO,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,cAA4C,EAC5C,WAAqC,EAAE;QADvC,mBAAc,GAAd,cAAc,CAA8B;QAC5C,aAAQ,GAAR,QAAQ,CAA+B;IACvD,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,IAAsC;QAEtC,MAAM,WAAW,GACf,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/reranker/index.d.ts

@@ -0,0 +1,4 @@
+export { LlmReranker } from './llm-reranker.js';
+export { NoopReranker } from './noop-reranker.js';
+export type { IReranker } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reranker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/reranker/index.js

@@ -0,0 +1,3 @@
+export { LlmReranker } from './llm-reranker.js';
+export { NoopReranker } from './noop-reranker.js';
+//# sourceMappingURL=index.js.map

package/dist/reranker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reranker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/reranker/llm-reranker.d.ts

@@ -0,0 +1,10 @@
+import type { ILlm } from '@mcp-abap-adt/llm-agent';
+import { type CallOptions, RagError, type RagResult, type Result } from '@mcp-abap-adt/llm-agent';
+import type { IReranker } from './types.js';
+export declare class LlmReranker implements IReranker {
+    private readonly llm;
+    constructor(llm: ILlm);
+    rerank(query: string, results: RagResult[], options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+    private _parseScores;
+}
+//# sourceMappingURL=llm-reranker.d.ts.map

package/dist/reranker/llm-reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-reranker.d.ts","sourceRoot":"","sources":["../../src/reranker/llm-reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EACL,KAAK,WAAW,EAChB,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C,qBAAa,WAAY,YAAW,SAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,IAAI;IAEhC,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;IAyCzC,OAAO,CAAC,YAAY;CAWrB"}

package/dist/reranker/llm-reranker.js

@@ -0,0 +1,55 @@
+import { RagError, } from '@mcp-abap-adt/llm-agent';
+const RERANK_SYSTEM_PROMPT = `You are a relevance scoring engine. Given a query and a list of text passages, rate the relevance of each passage to the query on a scale of 0 to 10.
+
+Respond with ONLY a JSON array of numbers representing the scores, one per passage, in the same order.
+Example: [8, 3, 10, 1]
+
+Do not include any other text.`;
+export class LlmReranker {
+    llm;
+    constructor(llm) {
+        this.llm = llm;
+    }
+    async rerank(query, results, options) {
+        if (results.length === 0) {
+            return { ok: true, value: results };
+        }
+        const passages = results.map((r, i) => `[${i}] ${r.text}`).join('\n\n');
+        const userPrompt = `Query: ${query}\n\nPassages:\n${passages}`;
+        try {
+            const res = await this.llm.chat([
+                { role: 'system', content: RERANK_SYSTEM_PROMPT },
+                { role: 'user', content: userPrompt },
+            ], [], options);
+            if (!res.ok) {
+                return {
+                    ok: false,
+                    error: new RagError(res.error.message, 'RERANK_ERROR'),
+                };
+            }
+            const scores = this._parseScores(res.value.content, results.length);
+            const reranked = results
+                .map((r, i) => ({ ...r, score: scores[i] / 10 }))
+                .sort((a, b) => b.score - a.score);
+            return { ok: true, value: reranked };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: new RagError(`Reranking failed: ${String(err)}`, 'RERANK_ERROR'),
+            };
+        }
+    }
+    _parseScores(content, expectedCount) {
+        const match = content.match(/\[[\d\s,.-]+\]/);
+        if (match) {
+            const parsed = JSON.parse(match[0]);
+            if (parsed.length === expectedCount) {
+                return parsed.map((s) => Math.max(0, Math.min(10, Number(s) || 0)));
+            }
+        }
+        // Fallback: preserve original ordering
+        return Array.from({ length: expectedCount }, (_, i) => expectedCount - i);
+    }
+}
+//# sourceMappingURL=llm-reranker.js.map

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

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

package/dist/reranker/noop-reranker.d.ts

@@ -0,0 +1,6 @@
+import type { CallOptions, RagError, RagResult, Result } from '@mcp-abap-adt/llm-agent';
+import type { IReranker } from './types.js';
+export declare class NoopReranker implements IReranker {
+    rerank(_query: string, results: RagResult[], _options?: CallOptions): Promise<Result<RagResult[], RagError>>;
+}
+//# sourceMappingURL=noop-reranker.d.ts.map

package/dist/reranker/noop-reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-reranker.d.ts","sourceRoot":"","sources":["../../src/reranker/noop-reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,MAAM,EACP,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,YAAa,YAAW,SAAS;IACtC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC;CAG1C"}

package/dist/reranker/noop-reranker.js

@@ -0,0 +1,6 @@
+export class NoopReranker {
+    async rerank(_query, results, _options) {
+        return { ok: true, value: results };
+    }
+}
+//# sourceMappingURL=noop-reranker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noop-reranker.js","sourceRoot":"","sources":["../../src/reranker/noop-reranker.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,MAAM,CACV,MAAc,EACd,OAAoB,EACpB,QAAsB;QAEtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;CACF"}

package/dist/reranker/types.d.ts

@@ -0,0 +1,2 @@
+export type { IReranker } from '@mcp-abap-adt/llm-agent';
+//# sourceMappingURL=types.d.ts.map

package/dist/reranker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reranker/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/reranker/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reranker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reranker/types.ts"],"names":[],"mappings":""}

package/dist/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/resilience/rate-limiter-llm.d.ts.map

@@ -0,0 +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"}

package/dist/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/resilience/rate-limiter-llm.js.map

@@ -0,0 +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"}

package/dist/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/resilience/retry-llm.d.ts.map

@@ -0,0 +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,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/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/resilience/retry-llm.js.map

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

package/dist/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/resilience/token-bucket-rate-limiter.d.ts.map

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