kagent-ts 0.1.3 → 0.1.5

package/dist/llm/model-router.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelRouter = void 0;
+const errors_1 = require("./errors");
+const logger_1 = require("../logging/logger");
+/**
+ * ModelRouter — routes LLM calls to different providers based on task type.
+ *
+ * Implements `LLMProvider` so it drops in anywhere a plain provider is
+ * expected. The default route is `main` — call `.forSubAgent()`,
+ * `.forReflection()`, or `.forLightweight()` to get a task-specific
+ * provider handle.
+ *
+ * Each route automatically wraps its model in a fallback chain when
+ * `fallbacks` are configured.
+ *
+ * Usage:
+ * ```ts
+ * const router = new ModelRouter({
+ *   main: new OpenAIProvider({ model: "gpt-4o" }),
+ *   subAgent: new OpenAIProvider({ model: "gpt-4o-mini" }),
+ *   reflection: new AnthropicProvider({ model: "claude-haiku-4-5-20251001" }),
+ *   fallbacks: [new AnthropicProvider({ model: "claude-sonnet-4-6" })],
+ * });
+ *
+ * const agent = new ReActAgent({ llm: router, subAgentsDir: "./subagents" });
+ * // Main loop uses gpt-4o; sub-agents use gpt-4o-mini.
+ *
+ * // For reflection hook:
+ * const hook = createReflectionHook({
+ *   llm: router.forReflection(),
+ *   notebook: errorNotebook,
+ * });
+ * ```
+ */
+class ModelRouter {
+    config;
+    logger;
+    constructor(config) {
+        if (!config.main) {
+            throw new Error("ModelRouter: `main` provider is required.");
+        }
+        this.config = config;
+        this.logger = config.logger ?? new logger_1.ConsoleLogger();
+    }
+    // ─── LLMProvider Implementation (delegates to main) ──────────────────
+    /** The main model identifier. */
+    get model() {
+        return this.config.main.model;
+    }
+    async chat(messages, tools, signal) {
+        return this.route("main").chat(messages, tools, signal);
+    }
+    async *chatStream(messages, tools, signal) {
+        yield* this.route("main").chatStream(messages, tools, signal);
+    }
+    getTokenCount(text, model) {
+        return this.config.main.getTokenCount(text, model);
+    }
+    // ─── Route Accessors ─────────────────────────────────────────────────
+    /**
+     * Get the LLM provider for sub-agents.
+     *
+     * Delegates to `subAgent` when configured, otherwise falls back to `main`.
+     * Wraps the provider with any shared fallback chain.
+     */
+    forSubAgent() {
+        return this.route("subAgent");
+    }
+    /**
+     * Get the LLM provider for post-execution reflection / QA.
+     *
+     * Delegates to `reflection` when configured, otherwise falls back to `main`.
+     * Wraps the provider with any shared fallback chain.
+     */
+    forReflection() {
+        return this.route("reflection");
+    }
+    /**
+     * Get the LLM provider for lightweight tasks.
+     *
+     * Delegates to `lightweight` when configured, otherwise falls back to `main`.
+     * Wraps the provider with any shared fallback chain.
+     */
+    forLightweight() {
+        return this.route("lightweight");
+    }
+    // ─── Internal ────────────────────────────────────────────────────────
+    /**
+     * Resolve a route to its effective provider.
+     *
+     * Priority: route-specific provider → main.
+     * If fallbacks are configured, the provider is wrapped in a fallback chain.
+     */
+    route(route) {
+        const primary = this.resolveRoute(route);
+        // If no fallbacks configured, return the primary directly (hot path).
+        if (!this.config.fallbacks || this.config.fallbacks.length === 0) {
+            return primary;
+        }
+        // Wrap in a lightweight fallback chain specific to this route.
+        return this.createFallbackWrapper(primary, route);
+    }
+    /**
+     * Resolve the primary provider for a route.
+     */
+    resolveRoute(route) {
+        switch (route) {
+            case "main":
+                return this.config.main;
+            case "subAgent":
+                return this.config.subAgent ?? this.config.main;
+            case "reflection":
+                return this.config.reflection ?? this.config.main;
+            case "lightweight":
+                return this.config.lightweight ?? this.config.main;
+        }
+    }
+    /**
+     * Create a lightweight inline fallback wrapper around a primary provider.
+     *
+     * This avoids importing FallbackProvider to keep the dependency graph
+     * clean. The inline wrapper behaves identically.
+     */
+    createFallbackWrapper(primary, route) {
+        const chain = [primary, ...this.config.fallbacks];
+        const logger = this.logger; // capture for closure
+        return {
+            get model() {
+                return primary.model;
+            },
+            async chat(messages, tools, signal) {
+                let lastError;
+                for (let i = 0; i < chain.length; i++) {
+                    try {
+                        const response = await chain[i].chat(messages, tools, signal);
+                        if (i > 0) {
+                            logger.info("ModelRouter", `Route "${route}" recovered via fallback "${chain[i].model}" (attempt ${i + 1}).`);
+                        }
+                        return response;
+                    }
+                    catch (err) {
+                        if (!(err instanceof errors_1.LLMNetworkError))
+                            throw err;
+                        lastError = err;
+                        logger.warn("ModelRouter", `Route "${route}": "${chain[i].model}" failed — ${err.message}. ` +
+                            (i < chain.length - 1 ? "Trying next..." : "Exhausted."));
+                    }
+                }
+                throw lastError;
+            },
+            async *chatStream(messages, tools, signal) {
+                let lastError;
+                for (let i = 0; i < chain.length; i++) {
+                    try {
+                        const stream = chain[i].chatStream(messages, tools, signal);
+                        if (i > 0) {
+                            logger.info("ModelRouter", `Route "${route}" stream recovered via "${chain[i].model}".`);
+                        }
+                        yield* stream;
+                        return;
+                    }
+                    catch (err) {
+                        if (!(err instanceof errors_1.LLMNetworkError))
+                            throw err;
+                        lastError = err;
+                    }
+                }
+                throw lastError;
+            },
+            getTokenCount(text, model) {
+                return primary.getTokenCount(text, model);
+            },
+        };
+    }
+}
+exports.ModelRouter = ModelRouter;
+//# sourceMappingURL=model-router.js.map

package/dist/llm/model-router.js.map

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

package/dist/llm/openai-provider.d.ts

@@ -1,31 +1,17 @@
 import { LLMProvider, LLMResponse, LLMStreamEvent } from "./interface";
 import { MessageData } from "../messages/types";
 import { Tool } from "../tools/types";
+export { LLMNetworkError, type NetworkErrorCause, type RetryConfig } from "./errors";
 /**
- * Categories of network-related LLM failures.
+ * @deprecated Use `RetryConfig` from `"./errors"` instead.
  */
-export type NetworkErrorCause = "timeout" | "connection_refused" | "connection_reset" | "dns_error" | "rate_limit" | "server_error" | "aborted" | "unknown_network";
-/**
- * Thrown by the LLM provider when all retry attempts for a network-related
- * failure have been exhausted. The agent catches this to save a checkpoint
- * and guide the user to resume their session.
- */
-export declare class LLMNetworkError extends Error {
-    readonly cause: NetworkErrorCause;
-    constructor(message: string, cause: NetworkErrorCause);
-}
+export type { RetryConfig as OpenAIRetryConfig } from "./errors";
 /**
  * Check whether an error is network-related and thus retryable.
+ * OpenAI-provider specific: checks `OpenAI.APIError` status codes.
  */
 export declare function isNetworkError(error: unknown): boolean;
-export interface OpenAIRetryConfig {
-    /** Max retry attempts for network errors (default: 3). */
-    maxRetries?: number;
-    /** Initial backoff delay in ms (default: 1000). */
-    baseDelayMs?: number;
-    /** Maximum backoff delay in ms (default: 30000). */
-    maxDelayMs?: number;
-}
+import { type RetryConfig } from "./errors";
 /**
  * Configuration options for the OpenAI LLM provider.
  */
@@ -36,7 +22,7 @@ export interface OpenAIConfig {
     maxTokens?: number;
     baseURL?: string;
     /** Retry configuration for network resilience. */
-    retry?: OpenAIRetryConfig;
+    retry?: RetryConfig;
     /** Request timeout in ms (default: none — SDK default ~10 min). */
     timeout?: number;
 }
@@ -58,7 +44,7 @@ export declare class OpenAIProvider implements LLMProvider {
     private retryConfig;
     private timeout;
     constructor(config: OpenAIConfig);
-    chat(messages: MessageData[], tools?: Tool[]): Promise<LLMResponse>;
+    chat(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): Promise<LLMResponse>;
     /**
      * Streaming chat completion.
      *
@@ -69,7 +55,7 @@ export declare class OpenAIProvider implements LLMProvider {
      * drops mid-response, the consumer sees an incomplete stream and the
      * agent's outer loop handles the error on the next LLM call.
      */
-    chatStream(messages: MessageData[], tools?: Tool[]): AsyncIterable<LLMStreamEvent>;
+    chatStream(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): AsyncIterable<LLMStreamEvent>;
     /**
      * Count tokens using tiktoken (with model-aware encoding) when available.
      * Falls back to character-based estimation if tiktoken is not installed.
@@ -78,15 +64,5 @@ export declare class OpenAIProvider implements LLMProvider {
      * @param model Optional model override. Defaults to this provider's model.
      */
     getTokenCount(text: string, model?: string): number;
-    /**
-     * Wrap an async operation with network-error retry logic.
-     *
-     * Retry strategy:
-     * - Only network-related errors (timeout, connection reset, 429, 5xx) are retried.
-     * - Uses exponential backoff with full jitter: delay = base * 2^attempt * random(0.5, 1.0).
-     * - Non-retryable errors (401, 400, abort) propagate immediately.
-     * - After all retries are exhausted, throws `LLMNetworkError`.
-     */
-    private withRetry;
 }
 //# sourceMappingURL=openai-provider.d.ts.map

package/dist/llm/openai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/llm/openai-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,oBAAoB,GACpB,kBAAkB,GAClB,WAAW,GACX,YAAY,GACZ,cAAc,GACd,SAAS,GACT,iBAAiB,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,KAAK,EAAE,iBAAiB,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB;CAKtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA0BtD;AAuBD,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,YAAY;IAuB1B,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA+CzE;;;;;;;;;OASG;IACI,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,IAAI,EAAE,GACb,aAAa,CAAC,cAAc,CAAC;IAuEhC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAMnD;;;;;;;;OAQG;YACW,SAAS;CAgCxB"}
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../src/llm/openai-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAwB,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAIrF;;GAEG;AACH,YAAY,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAyBtD;AAwBD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,YAAY;IAuB1B,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA6D/F;;;;;;;;;OASG;IACI,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,cAAc,CAAC;IA0EhC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;CAGpD"}

package/dist/llm/openai-provider.js

@@ -6,26 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIProvider = exports.LLMNetworkError = void 0;
 exports.isNetworkError = isNetworkError;
 const openai_1 = __importDefault(require("openai"));
+const interface_1 = require("./interface");
 const token_counter_1 = require("../utils/token-counter");
-/**
- * Thrown by the LLM provider when all retry attempts for a network-related
- * failure have been exhausted. The agent catches this to save a checkpoint
- * and guide the user to resume their session.
- */
-class LLMNetworkError extends Error {
-    cause;
-    constructor(message, cause) {
-        super(message);
-        this.name = "LLMNetworkError";
-        this.cause = cause;
-    }
-}
-exports.LLMNetworkError = LLMNetworkError;
+// ─── Shared error types (re-exported for backward compatibility) ─────────────
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "LLMNetworkError", { enumerable: true, get: function () { return errors_1.LLMNetworkError; } });
+// ─── OpenAI-specific network error helpers ───────────────────────────────────
 /**
  * Check whether an error is network-related and thus retryable.
+ * OpenAI-provider specific: checks `OpenAI.APIError` status codes.
  */
 function isNetworkError(error) {
-    if (error instanceof LLMNetworkError)
+    if (error instanceof Error && error.name === "LLMNetworkError")
         return true;
     if (error instanceof openai_1.default.APIError) {
         // 429 (rate-limit) and 5xx (server) are retryable
@@ -44,13 +36,13 @@ function isNetworkError(error) {
             msg.includes("fetch failed") ||
             msg.includes("network") ||
             msg.includes("socket hang up") ||
-            msg.includes("econnaborted") ||
-            msg.includes("abort"));
+            msg.includes("econnaborted"));
     }
     return false;
 }
 /**
  * Map a raw error to its NetworkErrorCause category.
+ * OpenAI-provider specific: checks `OpenAI.APIError` status codes.
  */
 function classifyError(error) {
     if (error instanceof openai_1.default.APIError) {
@@ -74,7 +66,8 @@ function classifyError(error) {
     }
     return "unknown_network";
 }
-// ─── OpenAIProvider ────────────────────────────────────────────────────────
+const retry_1 = require("./retry");
+// ─── OpenAIProvider ──────────────────────────────────────────────────────────
 /**
  * OpenAI implementation of the LLMProvider interface.
  * Uses the official `openai` npm package.
@@ -112,7 +105,7 @@ class OpenAIProvider {
             maxDelayMs: config.retry?.maxDelayMs ?? 30000,
         };
     }
-    async chat(messages, tools) {
+    async chat(messages, tools, signal) {
         // Convert internal Tool definitions to OpenAI tool format
         const openaiTools = tools?.map((t) => ({
             type: "function",
@@ -122,16 +115,16 @@ class OpenAIProvider {
                 parameters: t.parameters,
             },
         }));
-        const response = await this.withRetry(() => this.client.chat.completions.create({
+        const response = await (0, retry_1.withRetry)(() => this.client.chat.completions.create({
             model: this.model,
             messages: messages,
             temperature: this.temperature,
             max_tokens: this.maxTokens,
             tools: openaiTools,
-        }, { timeout: this.timeout }));
+        }, { timeout: this.timeout, signal }), this.retryConfig, { isRetryable: isNetworkError, classifyError });
         const choice = response.choices[0];
         const message = choice.message;
-        return {
+        const result = {
             content: message.content ?? "",
             tool_calls: message.tool_calls?.map((tc) => ({
                 id: tc.id,
@@ -148,7 +141,16 @@ class OpenAIProvider {
                     total_tokens: response.usage.total_tokens,
                 }
                 : undefined,
+            stop_reason: choice.finish_reason ?? undefined,
         };
+        // Flag response-level quality issues
+        if (choice.finish_reason === "length") {
+            result.responseError = {
+                code: interface_1.LLMResponseErrorCode.MAX_TOKENS,
+                message: "Response truncated: max_tokens reached. Content or tool call arguments may be incomplete.",
+            };
+        }
+        return result;
     }
     /**
      * Streaming chat completion.
@@ -160,7 +162,7 @@ class OpenAIProvider {
      * drops mid-response, the consumer sees an incomplete stream and the
      * agent's outer loop handles the error on the next LLM call.
      */
-    async *chatStream(messages, tools) {
+    async *chatStream(messages, tools, signal) {
         const openaiTools = tools?.map((t) => ({
             type: "function",
             function: {
@@ -171,7 +173,7 @@ class OpenAIProvider {
         }));
         // Retry only the initial stream creation — not mid-stream drops.
         // Use async wrapper so TypeScript treats APIPromise → Promise correctly.
-        const stream = await this.withRetry(async () => (await this.client.chat.completions.create({
+        const stream = await (0, retry_1.withRetry)(async () => (await this.client.chat.completions.create({
             model: this.model,
             messages: messages,
             temperature: this.temperature,
@@ -179,7 +181,7 @@ class OpenAIProvider {
             tools: openaiTools,
             stream: true,
             stream_options: { include_usage: true },
-        }, { timeout: this.timeout })));
+        }, { timeout: this.timeout, signal })), this.retryConfig, { isRetryable: isNetworkError, classifyError });
         let emittedDone = false;
         for await (const chunk of stream) {
             const delta = chunk.choices?.[0]?.delta;
@@ -227,41 +229,6 @@ class OpenAIProvider {
     getTokenCount(text, model) {
         return (0, token_counter_1.countTokens)(text, model ?? this.model);
     }
-    // ─── Private Helpers ────────────────────────────────────────────────────
-    /**
-     * Wrap an async operation with network-error retry logic.
-     *
-     * Retry strategy:
-     * - Only network-related errors (timeout, connection reset, 429, 5xx) are retried.
-     * - Uses exponential backoff with full jitter: delay = base * 2^attempt * random(0.5, 1.0).
-     * - Non-retryable errors (401, 400, abort) propagate immediately.
-     * - After all retries are exhausted, throws `LLMNetworkError`.
-     */
-    async withRetry(fn) {
-        const { maxRetries, baseDelayMs, maxDelayMs } = this.retryConfig;
-        let lastError;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            try {
-                return await fn();
-            }
-            catch (error) {
-                lastError = error;
-                // Non-network errors propagate immediately (e.g. invalid API key)
-                if (!isNetworkError(error))
-                    throw error;
-                if (attempt >= maxRetries)
-                    break; // all retries exhausted
-                // Exponential backoff with full jitter
-                const delay = Math.min(baseDelayMs * Math.pow(2, attempt) * (0.5 + Math.random() * 0.5), maxDelayMs);
-                // eslint-disable-next-line @typescript-eslint/no-loop-func
-                await new Promise((resolve) => setTimeout(resolve, delay));
-            }
-        }
-        // All retries exhausted — wrap the final error
-        const cause = classifyError(lastError);
-        const message = lastError instanceof Error ? lastError.message : String(lastError);
-        throw new LLMNetworkError(message, cause);
-    }
 }
 exports.OpenAIProvider = OpenAIProvider;
 //# sourceMappingURL=openai-provider.js.map

package/dist/llm/openai-provider.js.map

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

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

@@ -0,0 +1,41 @@
+import { LLMProvider, LLMResponse, LLMStreamEvent } from "./interface";
+import { MessageData } from "../messages/types";
+import { Tool } from "../tools/types";
+/**
+ * Configuration for the RateLimitedProvider.
+ */
+export interface RateLimitedProviderConfig {
+    /** The underlying LLM provider to wrap. */
+    provider: LLMProvider;
+    /** Maximum LLM calls per minute. */
+    maxCallsPerMinute: number;
+}
+/**
+ * LLMProvider wrapper that enforces a maximum call rate.
+ *
+ * Calls that would exceed the limit are delayed until a slot opens in
+ * the 1-minute sliding window. This prevents the agent from hitting
+ * provider rate limits (HTTP 429) during high-throughput scenarios.
+ *
+ * Usage:
+ * ```ts
+ * const provider = new RateLimitedProvider({
+ *   provider: new OpenAIProvider({ ... }),
+ *   maxCallsPerMinute: 500,
+ * });
+ * ```
+ */
+export declare class RateLimitedProvider implements LLMProvider {
+    private provider;
+    private limiter;
+    constructor(config: RateLimitedProviderConfig);
+    get model(): string;
+    chat(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): Promise<LLMResponse>;
+    chatStream(messages: MessageData[], tools?: Tool[], signal?: AbortSignal): AsyncIterable<LLMStreamEvent>;
+    getTokenCount(text: string, model?: string): number;
+    /** Number of calls in the current 1-minute window. */
+    get currentRateCount(): number;
+    /** Reset rate limiter counters. */
+    resetRateLimiter(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/llm/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAsDtC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2CAA2C;IAC3C,QAAQ,EAAE,WAAW,CAAC;IACtB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAuB;gBAE1B,MAAM,EAAE,yBAAyB;IAK7C,IAAI,KAAK,IAAI,MAAM,CAElB;IAEK,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAKxF,UAAU,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,cAAc,CAAC;IAKhC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAInD,sDAAsD;IACtD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,mCAAmC;IACnC,gBAAgB,IAAI,IAAI;CAGzB"}

package/dist/llm/rate-limiter.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitedProvider = void 0;
+/**
+ * Simple sliding-window rate limiter.
+ *
+ * Tracks call timestamps and delays requests when the configured
+ * maximum calls-per-minute would be exceeded.
+ */
+class SlidingWindowLimiter {
+    timestamps = [];
+    maxPerMinute;
+    constructor(maxPerMinute) {
+        this.maxPerMinute = maxPerMinute;
+    }
+    /**
+     * Wait until a slot is available in the current window.
+     * Returns immediately if under the limit.
+     */
+    async acquire() {
+        const now = Date.now();
+        const windowStart = now - 60_000;
+        // Drop timestamps outside the 1-minute window
+        this.timestamps = this.timestamps.filter((t) => t > windowStart);
+        if (this.timestamps.length < this.maxPerMinute) {
+            this.timestamps.push(now);
+            return;
+        }
+        // Wait until the oldest call exits the window
+        const oldest = this.timestamps[0];
+        const waitMs = oldest - windowStart + 10; // small buffer
+        if (waitMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+        }
+        // Re-check after waiting
+        return this.acquire();
+    }
+    /** Number of calls in the current window. */
+    get currentCount() {
+        const windowStart = Date.now() - 60_000;
+        return this.timestamps.filter((t) => t > windowStart).length;
+    }
+    reset() {
+        this.timestamps = [];
+    }
+}
+/**
+ * LLMProvider wrapper that enforces a maximum call rate.
+ *
+ * Calls that would exceed the limit are delayed until a slot opens in
+ * the 1-minute sliding window. This prevents the agent from hitting
+ * provider rate limits (HTTP 429) during high-throughput scenarios.
+ *
+ * Usage:
+ * ```ts
+ * const provider = new RateLimitedProvider({
+ *   provider: new OpenAIProvider({ ... }),
+ *   maxCallsPerMinute: 500,
+ * });
+ * ```
+ */
+class RateLimitedProvider {
+    provider;
+    limiter;
+    constructor(config) {
+        this.provider = config.provider;
+        this.limiter = new SlidingWindowLimiter(config.maxCallsPerMinute);
+    }
+    get model() {
+        return this.provider.model;
+    }
+    async chat(messages, tools, signal) {
+        await this.limiter.acquire();
+        return this.provider.chat(messages, tools, signal);
+    }
+    async *chatStream(messages, tools, signal) {
+        await this.limiter.acquire();
+        yield* this.provider.chatStream(messages, tools, signal);
+    }
+    getTokenCount(text, model) {
+        return this.provider.getTokenCount(text, model);
+    }
+    /** Number of calls in the current 1-minute window. */
+    get currentRateCount() {
+        return this.limiter.currentCount;
+    }
+    /** Reset rate limiter counters. */
+    resetRateLimiter() {
+        this.limiter.reset();
+    }
+}
+exports.RateLimitedProvider = RateLimitedProvider;
+//# sourceMappingURL=rate-limiter.js.map

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

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

package/dist/llm/retry.d.ts

@@ -0,0 +1,26 @@
+import { NetworkErrorCause, RetryConfig } from "./errors";
+/**
+ * Provider-specific callbacks that the generic retry wrapper delegates to
+ * when deciding whether an error is retryable and how to classify it.
+ */
+export interface RetryCallbacks {
+    /** Return true if the error is network-related and thus retryable. */
+    isRetryable: (error: unknown) => boolean;
+    /** Classify a retryable error into a NetworkErrorCause category. */
+    classifyError: (error: unknown) => NetworkErrorCause;
+}
+/**
+ * Wrap an async operation with network-error retry logic.
+ *
+ * Retry strategy:
+ * - The `callbacks.isRetryable` predicate decides which errors are retried.
+ * - Uses exponential backoff with full jitter: delay = base * 2^attempt * random(0.5, 1.0).
+ * - Non-retryable errors propagate immediately.
+ * - After all retries are exhausted, throws an `LLMNetworkError`.
+ *
+ * @param fn        The async operation to retry.
+ * @param config    Retry configuration (maxRetries, baseDelayMs, maxDelayMs).
+ * @param callbacks Provider-specific error classification callbacks.
+ */
+export declare function withRetry<T>(fn: () => Promise<T> | PromiseLike<T>, config: Required<RetryConfig>, callbacks: RetryCallbacks): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map