@nuvin/nuvin-core 1.6.0 → 1.6.1

package/dist/VERSION

@@ -1,4 +1,4 @@
 {
-  "version": "1.6.0",
-  "commit": "ec1e31a"
+  "version": "1.6.1",
+  "commit": "3d1a9e0"
 }

package/dist/index.d.ts

@@ -540,7 +540,6 @@ type SendMessageOptions = {
     conversationId?: string;
     stream?: boolean;
     signal?: AbortSignal;
-    retry?: boolean;
 };
 type UserAttachment = ImageContentPart & {
     token?: string;
@@ -1994,6 +1993,38 @@ declare class GithubAuthTransport implements HttpTransport {
     get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
 }
 
+interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    jitterFactor: number;
+    retryableStatusCodes: number[];
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+    onExhausted?: (error: Error, attempts: number) => void;
+}
+declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+declare class AbortError extends Error {
+    constructor(message?: string);
+}
+declare class RetryTransport implements HttpTransport {
+    private inner;
+    private config;
+    constructor(inner: HttpTransport, config?: Partial<RetryConfig>);
+    get(url: string, headers?: HttpHeaders, signal?: AbortSignal): Promise<TransportResponse>;
+    post(url: string, body: unknown, headers?: HttpHeaders, signal?: AbortSignal): Promise<Response>;
+    private executeWithRetry;
+    private isRetryableResponse;
+    private getDelayForResponse;
+}
+
+declare function isRetryableStatusCode(status: number, retryableStatusCodes?: number[]): boolean;
+declare function isRetryableError(error: unknown, retryableStatusCodes?: number[]): boolean;
+
+interface BaseLLMOptions {
+    enablePromptCaching?: boolean;
+    retry?: Partial<RetryConfig>;
+}
 declare class LLMError extends Error {
     readonly statusCode?: number | undefined;
     readonly isRetryable: boolean;
@@ -2003,9 +2034,8 @@ declare abstract class BaseLLM implements LLMPort {
     protected transport: HttpTransport | null;
     protected apiUrl: string;
     protected enablePromptCaching: boolean;
-    constructor(apiUrl: string, options?: {
-        enablePromptCaching?: boolean;
-    });
+    protected retryConfig?: Partial<RetryConfig>;
+    constructor(apiUrl: string, options?: BaseLLMOptions);
     protected abstract createTransport(): HttpTransport;
     protected transformUsage(rawUsage: unknown): UsageData | undefined;
     protected getTransport(): HttpTransport;
@@ -2038,11 +2068,12 @@ type GithubOptions = {
     accessToken?: string;
     apiUrl?: string;
     httpLogFile?: string;
+    retry?: Partial<RetryConfig>;
 };
 declare class GithubLLM extends BaseLLM implements LLMPort {
     private readonly opts;
     constructor(opts?: GithubOptions);
-    protected createTransport(): GithubAuthTransport;
+    protected createTransport(): GithubAuthTransport | RetryTransport;
     protected transformUsage(rawUsage: unknown): UsageData | undefined;
     getModels(signal?: AbortSignal): Promise<ModelInfo[]>;
     private handleError;
@@ -2109,6 +2140,7 @@ interface LLMOptions {
     includeUsage?: boolean;
     version?: string;
     providerName?: string;
+    retry?: Partial<RetryConfig>;
 }
 interface CustomProviderDefinition {
     type?: 'openai-compat' | 'anthropic';
@@ -2211,4 +2243,4 @@ declare function resolveBackspaces(s: string): string;
 declare function stripAnsiAndControls(s: string): string;
 declare function canonicalizeTerminalPaste(raw: string): string;
 
-export { AGENT_CREATOR_SYSTEM_PROMPT, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentTemplate, AnthropicAISDKLLM, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, type CommandMetadata, type CompleteAgent, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationMetadata, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, type DirEntry, type DirLsArgs, type DirLsMetadata, type DirLsParams, type DirLsResult, type DirLsSuccessResult$1 as DirLsSuccessResult, type ErrorMetadata, ErrorReason, type ExecResult, type ExecResultError, type ExecResultSuccess, type FileEditArgs, type FileEditMetadata, type FileEditResult, type FileEditSuccessResult$1 as FileEditSuccessResult, type FileMetadata, type FileNewArgs, type FileNewMetadata, type FileNewParams, type FileNewResult, type FileNewSuccessResult$1 as FileNewSuccessResult, type FileReadArgs, type FileReadErrorResult, type FileReadMetadata, type FileReadParams, type FileReadResult, type FileReadSuccessResult$1 as FileReadSuccessResult, type FolderTreeOptions, type FunctionTool, GithubLLM, InMemoryMemory, InMemoryMetadata, InMemoryMetricsPort, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type LineRangeMetadata, type MCPConfig, type MCPServerConfig, MCPToolPort, type MemoryPort, MemoryPortMetadataAdapter, type Message, type MessageContent, type MessageContentPart, type MetadataPort, type MetricsChangeHandler, type MetricsPort, type MetricsSnapshot, type ModelInfo, type ModelLimits, NoopMetricsPort, NoopReminders, type OrchestratorAwareToolPort, type ParseResult, PersistedMemory, PersistingConsoleEventPort, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, type SubAgentState, type SubAgentToolCall, SystemClock, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type ToolApprovalDecision, type ToolArguments, type ToolCall, type ToolCallValidation, type ToolErrorMetadata, type ToolExecutionContext, type ToolExecutionResult, type ToolMetadataMap, type ToolName, type ToolParameterMap, type ToolPort, ToolRegistry, type ToolValidator, type TypedToolInvocation, type UsageData, type UserAttachment, type UserMessagePayload, type ValidationResult, type WebFetchArgs, type WebFetchMetadata, type WebFetchParams, type WebFetchResult, type WebFetchSuccessResult$1 as WebFetchSuccessResult, type WebSearchArgs, type WebSearchMetadata, type WebSearchParams, type WebSearchResult, type WebSearchSuccessResult$1 as WebSearchSuccessResult, type WebSearchToolResult, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, createEmptySnapshot, createLLM, err, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderLabel, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isDirLsArgs, isDirLsResult, isDirLsSuccess, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isJsonResult, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadMCPConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls, supportsGetModels, toolValidators };
+export { AGENT_CREATOR_SYSTEM_PROMPT, AbortError, type AgentAwareToolPort, type AgentCatalog, type AgentConfig, type AgentEvent, AgentEventTypes, AgentFilePersistence, AgentManager, AgentManagerCommandRunner, AgentOrchestrator, AgentRegistry, type AgentTemplate, AnthropicAISDKLLM, type AssignErrorResult, type AssignParams, type AssignResult, type AssignSuccessResult$1 as AssignSuccessResult, type AssignTaskArgs, type AssignTaskMetadata, type BaseLLMOptions, type BashErrorResult, type BashParams, type BashResult, type BashSuccessResult$1 as BashSuccessResult, BashTool, type BashToolArgs, type BashToolMetadata, type CommandMetadata, type CompleteAgent, CompositeToolPort, type Conversation, ConversationContext, type ConversationMetadata, type ConversationSnapshot, ConversationStore, CoreMCPClient, DEFAULT_RETRY_CONFIG, DefaultDelegationPolicy, DefaultDelegationResultFormatter, DefaultDelegationService, DefaultSpecialistAgentFactory, type DelegationMetadata, type DelegationService, type DelegationServiceConfig, DelegationServiceFactory, type DirEntry, type DirLsArgs, type DirLsMetadata, type DirLsParams, type DirLsResult, type DirLsSuccessResult$1 as DirLsSuccessResult, type ErrorMetadata, ErrorReason, type ExecResult, type ExecResultError, type ExecResultSuccess, type FileEditArgs, type FileEditMetadata, type FileEditResult, type FileEditSuccessResult$1 as FileEditSuccessResult, type FileMetadata, type FileNewArgs, type FileNewMetadata, type FileNewParams, type FileNewResult, type FileNewSuccessResult$1 as FileNewSuccessResult, type FileReadArgs, type FileReadErrorResult, type FileReadMetadata, type FileReadParams, type FileReadResult, type FileReadSuccessResult$1 as FileReadSuccessResult, type FolderTreeOptions, type FunctionTool, GithubLLM, InMemoryMemory, InMemoryMetadata, InMemoryMetricsPort, JsonFileMemoryPersistence, type LLMConfig, LLMError, type LLMFactory, type LLMOptions, type LLMPort, LLMResolver, type LineRangeMetadata, type MCPConfig, type MCPServerConfig, MCPToolPort, type MemoryPort, MemoryPortMetadataAdapter, type Message, type MessageContent, type MessageContentPart, type MetadataPort, type MetricsChangeHandler, type MetricsPort, type MetricsSnapshot, type ModelInfo, type ModelLimits, NoopMetricsPort, NoopReminders, type OrchestratorAwareToolPort, type ParseResult, PersistedMemory, PersistingConsoleEventPort, type RetryConfig, RetryTransport, RuntimeEnv, type SendMessageOptions, SimpleContextBuilder, SimpleCost, SimpleId, type SpecialistAgentConfig, type SpecialistAgentResult, type SubAgentState, type SubAgentToolCall, SystemClock, type TodoWriteArgs, type TodoWriteMetadata, type TodoWriteResult, type TodoWriteSuccessResult$1 as TodoWriteSuccessResult, type ToolApprovalDecision, type ToolArguments, type ToolCall, type ToolCallValidation, type ToolErrorMetadata, type ToolExecutionContext, type ToolExecutionResult, type ToolMetadataMap, type ToolName, type ToolParameterMap, type ToolPort, ToolRegistry, type ToolValidator, type TypedToolInvocation, type UsageData, type UserAttachment, type UserMessagePayload, type ValidationResult, type WebFetchArgs, type WebFetchMetadata, type WebFetchParams, type WebFetchResult, type WebFetchSuccessResult$1 as WebFetchSuccessResult, type WebSearchArgs, type WebSearchMetadata, type WebSearchParams, type WebSearchResult, type WebSearchSuccessResult$1 as WebSearchSuccessResult, type WebSearchToolResult, buildAgentCreationPrompt, buildInjectedSystem, canonicalizeTerminalPaste, convertToolCall, convertToolCalls, createEmptySnapshot, createLLM, err, generateFolderTree, getAvailableProviders, getFallbackLimits, getProviderLabel, isAssignResult, isAssignSuccess, isAssignTaskArgs, isBashResult, isBashSuccess, isBashToolArgs, isDirLsArgs, isDirLsResult, isDirLsSuccess, isError, isFileEditArgs, isFileEditResult, isFileEditSuccess, isFileNewArgs, isFileNewResult, isFileNewSuccess, isFileReadArgs, isFileReadResult, isFileReadSuccess, isJsonResult, isRetryableError, isRetryableStatusCode, isSuccess, isSuccessJson, isSuccessText, isTextResult, isTodoWriteArgs, isTodoWriteResult, isTodoWriteSuccess, isWebFetchArgs, isWebFetchResult, isWebFetchSuccess, isWebSearchArgs, isWebSearchResult, isWebSearchSuccess, loadMCPConfig, normalizeModelInfo, normalizeModelLimits, normalizeNewlines, okJson, okText, parseJSON, parseSubAgentToolCallArguments, parseToolArguments, renderTemplate, resolveBackspaces, resolveCarriageReturns, stripAnsiAndControls, supportsGetModels, toolValidators };

package/dist/index.js

@@ -1015,37 +1015,30 @@ var AgentOrchestrator = class {
     if (!_llm) {
       throw new Error("LLM provider not set");
     }
-    if (opts.retry) {
-      providerMsgs = this.context.toProviderMessages(history, this.cfg.systemPrompt, []);
-      userMessages = [];
-      userDisplay = "[Retry]";
-      enhanced = [];
+    const normalized = typeof content === "string" ? { text: content, displayText: content, attachments: [] } : {
+      text: content.text ?? "",
+      displayText: content.displayText,
+      attachments: Array.isArray(content.attachments) ? content.attachments : []
+    };
+    const attachments = normalized.attachments;
+    enhanced = this.reminders.enhance(normalized.text, { conversationId: convo });
+    const enhancedCombined = enhanced.join("\n");
+    const messageParts = buildMessageParts(enhancedCombined, attachments);
+    let userContent;
+    if (attachments.length > 0 || messageParts.some((part) => part.type === "image")) {
+      userContent = { type: "parts", parts: messageParts };
+    } else if (messageParts.length === 1 && messageParts[0]?.type === "text") {
+      userContent = messageParts[0].text;
+    } else if (messageParts.length > 0) {
+      userContent = { type: "parts", parts: messageParts };
     } else {
-      const normalized = typeof content === "string" ? { text: content, displayText: content, attachments: [] } : {
-        text: content.text ?? "",
-        displayText: content.displayText,
-        attachments: Array.isArray(content.attachments) ? content.attachments : []
-      };
-      const attachments = normalized.attachments;
-      enhanced = this.reminders.enhance(normalized.text, { conversationId: convo });
-      const enhancedCombined = enhanced.join("\n");
-      const messageParts = buildMessageParts(enhancedCombined, attachments);
-      let userContent;
-      if (attachments.length > 0 || messageParts.some((part) => part.type === "image")) {
-        userContent = { type: "parts", parts: messageParts };
-      } else if (messageParts.length === 1 && messageParts[0]?.type === "text") {
-        userContent = messageParts[0].text;
-      } else if (messageParts.length > 0) {
-        userContent = { type: "parts", parts: messageParts };
-      } else {
-        userContent = enhancedCombined;
-      }
-      providerMsgs = this.context.toProviderMessages(history, this.cfg.systemPrompt, [userContent]);
-      userDisplay = resolveDisplayText(normalized.text, attachments, normalized.displayText);
-      const userTimestamp = this.clock.iso();
-      userMessages = [{ id: this.ids.uuid(), role: "user", content: userContent, timestamp: userTimestamp }];
-      await this.memory.append(convo, userMessages);
+      userContent = enhancedCombined;
     }
+    providerMsgs = this.context.toProviderMessages(history, this.cfg.systemPrompt, [userContent]);
+    userDisplay = resolveDisplayText(normalized.text, attachments, normalized.displayText);
+    const userTimestamp = this.clock.iso();
+    userMessages = [{ id: this.ids.uuid(), role: "user", content: userContent, timestamp: userTimestamp }];
+    await this.memory.append(convo, userMessages);
     if (opts.signal?.aborted) throw new Error("Aborted");
     const toolDefs = this.tools.getToolDefinitions(this.cfg.enabledTools ?? []);
     const toolNames = toolDefs.map((t) => t.function.name);
@@ -3751,7 +3744,7 @@ var AgentManager = class {
         }
       };
     }
-    this.eventCallback?.({
+    await this.eventCallback?.({
       type: AgentEventTypes.SubAgentStarted,
       conversationId: config.conversationId ?? "default",
       messageId: config.messageId ?? "",
@@ -3770,7 +3763,7 @@ var AgentManager = class {
         events.push(event);
         if (event.type === AgentEventTypes.ToolCalls) {
           for (const toolCall of event.toolCalls) {
-            this.eventCallback?.({
+            await this.eventCallback?.({
               type: AgentEventTypes.SubAgentToolCall,
               conversationId: config.conversationId ?? "default",
               messageId: config.messageId ?? "",
@@ -3781,7 +3774,7 @@ var AgentManager = class {
             });
           }
         } else if (event.type === AgentEventTypes.ToolResult) {
-          this.eventCallback?.({
+          await this.eventCallback?.({
             type: AgentEventTypes.SubAgentToolResult,
             conversationId: config.conversationId ?? "default",
             messageId: config.messageId ?? "",
@@ -3845,7 +3838,7 @@ var AgentManager = class {
         }
       }
       const snapshot = metricsPort.getSnapshot();
-      this.eventCallback?.({
+      await this.eventCallback?.({
         type: AgentEventTypes.SubAgentCompleted,
         conversationId: config.conversationId ?? "default",
         messageId: config.messageId ?? "",
@@ -3875,7 +3868,7 @@ var AgentManager = class {
       const isTimeout = error instanceof Error && error.message.includes("timeout");
       const isAborted = error instanceof Error && (error.message.includes("aborted") || error.name === "AbortError");
       const status = isTimeout ? "timeout" : isAborted ? "error" : "error";
-      this.eventCallback?.({
+      await this.eventCallback?.({
         type: AgentEventTypes.SubAgentCompleted,
         conversationId: config.conversationId ?? "default",
         messageId: config.messageId ?? "",
@@ -4634,9 +4627,11 @@ var BaseLLM = class {
   transport = null;
   apiUrl;
   enablePromptCaching = false;
+  retryConfig;
   constructor(apiUrl, options) {
     this.apiUrl = apiUrl;
     this.enablePromptCaching = options?.enablePromptCaching ?? false;
+    this.retryConfig = options?.retry;
   }
   transformUsage(rawUsage) {
     if (!rawUsage) return void 0;
@@ -5299,6 +5294,206 @@ function createTransport(inner, defaultBaseUrl, apiKey, baseUrl, version, custom
   return new SimpleBearerAuthTransport(inner, defaultBaseUrl, apiKey, baseUrl, version, customHeaders);
 }
 
+// src/transports/backoff.ts
+function calculateBackoff(attempt, baseDelayMs, maxDelayMs, multiplier, jitterFactor) {
+  const exponentialDelay = baseDelayMs * multiplier ** attempt;
+  const cappedDelay = Math.min(exponentialDelay, maxDelayMs);
+  const jitterRange = cappedDelay * jitterFactor;
+  const jitter = jitterRange * (Math.random() * 2 - 1);
+  return Math.max(0, Math.round(cappedDelay + jitter));
+}
+function parseRetryAfterHeader(header) {
+  if (!header) return null;
+  const seconds = parseInt(header, 10);
+  if (!Number.isNaN(seconds) && seconds >= 0) {
+    return seconds * 1e3;
+  }
+  const date = Date.parse(header);
+  if (!Number.isNaN(date)) {
+    const delayMs = date - Date.now();
+    return delayMs > 0 ? delayMs : null;
+  }
+  return null;
+}
+
+// src/transports/error-classification.ts
+var DEFAULT_RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 504];
+var RETRYABLE_NETWORK_ERRORS = [
+  "econnrefused",
+  "enotfound",
+  "etimedout",
+  "econnreset",
+  "epipe",
+  "network",
+  "fetch failed",
+  "socket hang up"
+];
+var NON_RETRYABLE_PATTERNS = [
+  "invalid",
+  "unauthorized",
+  "forbidden",
+  "not found",
+  "bad request",
+  "api key",
+  "authentication",
+  "permission",
+  "invalid_api_key",
+  "insufficient_quota"
+];
+function isRetryableStatusCode(status, retryableStatusCodes = DEFAULT_RETRYABLE_STATUS_CODES) {
+  return retryableStatusCodes.includes(status);
+}
+function isRetryableError(error, retryableStatusCodes = DEFAULT_RETRYABLE_STATUS_CODES) {
+  if (!error) return false;
+  if (error instanceof Error && error.name === "AbortError") {
+    return false;
+  }
+  if (error instanceof LLMError) {
+    if (error.statusCode) {
+      return isRetryableStatusCode(error.statusCode, retryableStatusCodes);
+    }
+    return error.isRetryable;
+  }
+  const err2 = error;
+  const statusCode = err2.statusCode ?? err2.status;
+  if (statusCode) {
+    return isRetryableStatusCode(statusCode, retryableStatusCodes);
+  }
+  const message = err2.message?.toLowerCase() || "";
+  const code = err2.code?.toLowerCase() || "";
+  for (const pattern of NON_RETRYABLE_PATTERNS) {
+    if (message.includes(pattern) || code.includes(pattern)) {
+      return false;
+    }
+  }
+  for (const networkError of RETRYABLE_NETWORK_ERRORS) {
+    if (message.includes(networkError) || code.includes(networkError)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// src/transports/retry-transport.ts
+var DEFAULT_RETRY_CONFIG = {
+  maxRetries: 3,
+  baseDelayMs: 1e3,
+  maxDelayMs: 6e4,
+  backoffMultiplier: 2,
+  jitterFactor: 0.2,
+  retryableStatusCodes: [429, 500, 502, 503, 504]
+};
+var AbortError = class _AbortError extends Error {
+  constructor(message = "Operation aborted") {
+    super(message);
+    this.name = "AbortError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _AbortError);
+    }
+  }
+};
+var sleep = (ms, signal) => {
+  return new Promise((resolve6, reject) => {
+    if (signal?.aborted) {
+      reject(new AbortError("Operation aborted"));
+      return;
+    }
+    const timeout = setTimeout(resolve6, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timeout);
+        reject(new AbortError("Operation aborted during retry delay"));
+      },
+      { once: true }
+    );
+  });
+};
+var RetryTransport = class {
+  constructor(inner, config = {}) {
+    this.inner = inner;
+    this.config = { ...DEFAULT_RETRY_CONFIG, ...config };
+  }
+  config;
+  async get(url, headers, signal) {
+    return this.executeWithRetry(() => this.inner.get(url, headers, signal), signal);
+  }
+  async post(url, body, headers, signal) {
+    return this.executeWithRetry(() => this.inner.post(url, body, headers, signal), signal);
+  }
+  async executeWithRetry(fn, signal) {
+    let lastError;
+    let attempt = 0;
+    while (attempt <= this.config.maxRetries) {
+      if (signal?.aborted) {
+        throw new AbortError("Operation aborted before execution");
+      }
+      try {
+        const response = await fn();
+        if (this.isRetryableResponse(response)) {
+          const error = new Error(`HTTP ${response.status}`);
+          error.status = response.status;
+          if (attempt < this.config.maxRetries) {
+            const delayMs = this.getDelayForResponse(response, attempt);
+            this.config.onRetry?.(attempt + 1, error, delayMs);
+            await sleep(delayMs, signal);
+            attempt++;
+            continue;
+          }
+          lastError = error;
+          break;
+        }
+        return response;
+      } catch (error) {
+        if (error instanceof AbortError || error instanceof Error && error.name === "AbortError") {
+          throw error;
+        }
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (!isRetryableError(lastError, this.config.retryableStatusCodes)) {
+          throw lastError;
+        }
+        if (attempt < this.config.maxRetries) {
+          const delayMs = calculateBackoff(
+            attempt,
+            this.config.baseDelayMs,
+            this.config.maxDelayMs,
+            this.config.backoffMultiplier,
+            this.config.jitterFactor
+          );
+          this.config.onRetry?.(attempt + 1, lastError, delayMs);
+          await sleep(delayMs, signal);
+          attempt++;
+        } else {
+          break;
+        }
+      }
+    }
+    if (lastError) {
+      this.config.onExhausted?.(lastError, attempt + 1);
+      throw lastError;
+    }
+    throw new Error("Retry exhausted without error");
+  }
+  isRetryableResponse(response) {
+    return isRetryableStatusCode(response.status, this.config.retryableStatusCodes);
+  }
+  getDelayForResponse(response, attempt) {
+    const headers = "headers" in response && response.headers instanceof Headers ? response.headers : null;
+    const retryAfter = headers?.get("retry-after") ?? null;
+    const retryAfterMs = parseRetryAfterHeader(retryAfter);
+    if (retryAfterMs !== null) {
+      return Math.min(retryAfterMs, this.config.maxDelayMs);
+    }
+    return calculateBackoff(
+      attempt,
+      this.config.baseDelayMs,
+      this.config.maxDelayMs,
+      this.config.backoffMultiplier,
+      this.config.jitterFactor
+    );
+  }
+};
+
 // src/llm-providers/model-limits.ts
 function normalizeModelLimits(provider, model) {
   switch (provider.toLowerCase()) {
@@ -5416,7 +5611,7 @@ function normalizeModelInfo(provider, model) {
 var GithubLLM = class extends BaseLLM {
   opts;
   constructor(opts = {}) {
-    super(opts.apiUrl ?? "https://api.individual.githubcopilot.com");
+    super(opts.apiUrl ?? "https://api.individual.githubcopilot.com", { retry: opts.retry });
     this.opts = opts;
   }
   createTransport() {
@@ -5427,11 +5622,15 @@ var GithubLLM = class extends BaseLLM {
       maxFileSize: 5 * 1024 * 1024,
       captureResponseBody: true
     });
-    return new GithubAuthTransport(base, {
+    const authTransport = new GithubAuthTransport(base, {
       baseUrl: this.opts.apiUrl,
       apiKey: this.opts.apiKey,
       accessToken: this.opts.accessToken
     });
+    if (this.retryConfig) {
+      return new RetryTransport(authTransport, this.retryConfig);
+    }
+    return authTransport;
   }
   transformUsage(rawUsage) {
     if (!rawUsage) return void 0;
@@ -6050,8 +6249,8 @@ var GenericLLM = class extends BaseLLM {
   providerName;
   customHeaders;
   constructor(baseUrl, modelConfig, opts = {}, customHeaders) {
-    const { enablePromptCaching = false, includeUsage = false, providerName = "unknown", ...restOpts } = opts;
-    super(opts.apiUrl || baseUrl, { enablePromptCaching });
+    const { enablePromptCaching = false, includeUsage = false, providerName = "unknown", retry, ...restOpts } = opts;
+    super(opts.apiUrl || baseUrl, { enablePromptCaching, retry });
     this.includeUsage = includeUsage;
     this.modelConfig = modelConfig;
     this.providerName = providerName;
@@ -6066,7 +6265,7 @@ var GenericLLM = class extends BaseLLM {
       maxFileSize: 5 * 1024 * 1024,
       captureResponseBody: true
     });
-    return createTransport(
+    const authTransport = createTransport(
       base,
       this.apiUrl,
       this.opts.apiKey,
@@ -6074,6 +6273,10 @@ var GenericLLM = class extends BaseLLM {
       this.opts.version,
       this.customHeaders
     );
+    if (this.retryConfig) {
+      return new RetryTransport(authTransport, this.retryConfig);
+    }
+    return authTransport;
   }
   async getModels(signal) {
     if (this.modelConfig === false) {
@@ -6464,6 +6667,7 @@ function isValidConfig(value) {
 }
 export {
   AGENT_CREATOR_SYSTEM_PROMPT,
+  AbortError,
   AgentEventTypes,
   AgentFilePersistence,
   AgentManager,
@@ -6476,6 +6680,7 @@ export {
   ConversationContext,
   ConversationStore,
   CoreMCPClient,
+  DEFAULT_RETRY_CONFIG,
   DefaultDelegationPolicy,
   DefaultDelegationResultFormatter,
   DefaultDelegationService,
@@ -6495,6 +6700,7 @@ export {
   NoopReminders,
   PersistedMemory,
   PersistingConsoleEventPort,
+  RetryTransport,
   RuntimeEnv,
   SimpleContextBuilder,
   SimpleCost,
@@ -6533,6 +6739,8 @@ export {
   isFileReadResult,
   isFileReadSuccess,
   isJsonResult,
+  isRetryableError,
+  isRetryableStatusCode,
   isSuccess,
   isSuccessJson,
   isSuccessText,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuvin/nuvin-core",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "",
   "private": false,
   "main": "dist/index.js",