@faapi/agent 6.31.0 → 6.32.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { LlmConfig, AgentToolDescriptor, FaapiContext, AgentCore, AgentMetadata, ToolMetadata, ToolModule, FaapiPlugin } from '@faapi/faapi';
+import { LlmConfig, LlmComplete, AgentToolDescriptor, FaapiContext, AgentCore, AgentMetadata, ToolMetadata, ToolModule, FaapiPlugin } from '@faapi/faapi';
+export { LlmComplete, LlmCompleteOptions } from '@faapi/faapi';
 
 /**
  * LLM Provider 错误
@@ -11,12 +12,31 @@ declare class LLMProviderError extends Error {
     readonly status?: number;
     /** 响应体摘要（前 500 字符,便于诊断） */
     readonly body?: string;
+    /**
+     * 实际发起的 HTTP 尝试次数（≥1，含失败尝试）
+     *
+     * 重试耗尽抛出时由重试循环回填（构造时未知，故非 readonly）；
+     * 首次尝试即失败的确定性错误（4xx 直抛）为 1，未回填时视为 1。
+     */
+    attempts?: number;
     constructor(message: string, options?: {
         status?: number;
         body?: string;
         cause?: unknown;
     });
 }
+/**
+ * LLM 请求超时
+ *
+ * {@link LLMProviderError} 的超时子类——`instanceof LLMTimeoutError` 可编程区分
+ * 「超时」与「网络错误」（两者 status 均为 undefined，仅靠 message 字符串无法区分）。
+ * 超时计入重试（与 429/5xx/网络错误同策略）。
+ */
+declare class LLMTimeoutError extends LLMProviderError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
 /**
  * 创建 OpenAI 兼容 LLMProvider
  *
@@ -121,11 +141,23 @@ interface LLMCompleteRequest {
     temperature?: number;
     /** 最大生成 token 数 */
     maxTokens?: number;
+    /**
+     * 本次请求的超时（毫秒，调用级覆盖）
+     *
+     * 缺省回落 `LlmConfig.timeoutMs`，两者皆未设置时无超时。
+     * 超时触发抛 `LLMTimeoutError`（计入重试，与 429/5xx/网络错误同策略）。
+     */
+    timeoutMs?: number;
+    /**
+     * 本次请求的重试上限（调用级覆盖）
+     *
+     * 缺省回落 `LlmConfig.maxRetries`（默认 2）。仅 429/5xx/网络错误/超时计入重试。
+     */
+    maxRetries?: number;
     /**
      * 取消信号（透传到底层 HTTP 请求）
      *
-     * abort 时请求中断并抛 `AgentAbortError`；与 `LlmConfig.timeoutMs` 的
-     * 超时信号组合生效（任一触发即中断）。
+     * abort 时请求中断并抛 `AgentAbortError`；与超时信号组合生效（任一触发即中断）。
      */
     signal?: AbortSignal;
 }
@@ -168,6 +200,12 @@ interface LLMResponse {
     stopReason: LLMStopReason;
     /** token 用量（部分 provider 不返回） */
     usage?: LLMUsage;
+    /**
+     * 实际发起的 HTTP 尝试次数（≥1，含失败尝试）
+     *
+     * 供失败钩子/日志观测重试消耗；provider 未提供时视为 1。
+     */
+    attempts?: number;
 }
 /**
  * Token 用量（OpenAI chat completions 规范形）
@@ -228,6 +266,20 @@ interface LLMProvider {
  */
 declare function createProvider(config: LlmConfig): LLMProvider;
 
+/**
+ * 创建轻量补全通道
+ *
+ * @param deps.llms provider 配置映射（来自 `config.agent.llms`，同源零新增配置）
+ * @param deps.providers 已构建的 provider 实例映射（插件传入——与 agent 循环共享
+ *                       同一单例）；缺省时按 `llms` 逐项 `createProvider` 现场构建
+ *                       （隔离 worker 重建 / 测试形态）
+ * @returns 补全通道（`complete` 方法）
+ */
+declare function createLightComplete(deps: {
+    llms: Record<string, LlmConfig>;
+    providers?: Map<string, LLMProvider>;
+}): LlmComplete;
+
 /**
  * 单次 agent.run() / agent.stream() 的结构化调用明细
  *
@@ -1096,19 +1148,8 @@ declare class Agent {
      */
     private resolveExternalProvider;
     /**
-     * 解析 `options.model` 字符串 key → provider + model
-     *
-     * 规则见 [agentHandle.md](./agentHandle.md) 的「`options.model` 字符串 key 解析规则」。
-     * 无默认 provider——`key` 未传时用 agent 元数据 `config.model` 作为缺省 key；
-     * 两者皆无抛 `AgentError`（要求调用方传 `options.model` 或 `options.provider`）。
-     * 1. 精确匹配 `deps.providers` 的 key → 该 provider + 其 `models` 第一个 key
-     *    （该 provider 未声明 `models` 时回落 `meta.model`）
-     * 2. 含 `/` → `provider/model` 形式,`deps.providers.get(provider)` + 该 model
-     *    （要求该 model 在 `deps.llms[provider].models` 里）
-     * 3. 不含 `/` 且非 provider key → 在所有 provider 的 `models` 里按 model 名查找
-     *    - 唯一 → 该 provider + 该 model
-     *    - 多个 → 抛 `AgentError`（要求用 `provider/model` 消歧）
-     *    - 无 → 抛 `AgentError`
+     * 解析 `options.model` 字符串 key → provider + model（模块级 [resolveModelKey] 的
+     * Agent 方法包装——meta.model 作缺省 key，与 [lightComplete](./lightComplete.md) 共用同一解析实现）
      *
      * @throws {AgentError} key 与 `meta.model` 均缺省；key 解析失败（provider/model
      *   不存在或歧义）
@@ -1294,4 +1335,4 @@ declare function createToolSchemaResolver(options?: {
  */
 declare const agentPlugin: FaapiPlugin;
 
-export { Agent, AgentAbortError, type AgentDeps, AgentError, type AgentHandle, AgentRecursionError, type AgentRunOptions, type AgentRuntimeConfig, AgentToolTimeoutError, type AgentTrace, type AgentTraceEvent, type LLMCompleteRequest, type LLMMessage, type LLMProvider, LLMProviderError, type LLMResponse, type LLMStopReason, type LLMStreamChunk, type LLMToolCall, type LLMToolDefinition, type LLMUsage, type LlmCallEvent, type ReactLoopConfig, ReactLoopError, type ReactLoopResult, type ReactLoopStreamChunk, type SchemaSourceRef, type SubAgentCallEvent, type SubAgentDelta, type SubAgentDeltaEmitter, type SubAgentToolResult, type ToolCallEvent, type ToolExecutor, type ToolSchemaResolution, type TracingToolResult, createOpenAIProvider, createProvider, createToolSchemaResolver, agentPlugin as default, isSubAgentToolResult, isTracingToolResult, reactLoop, reactLoopStream };
+export { Agent, AgentAbortError, type AgentDeps, AgentError, type AgentHandle, AgentRecursionError, type AgentRunOptions, type AgentRuntimeConfig, AgentToolTimeoutError, type AgentTrace, type AgentTraceEvent, type LLMCompleteRequest, type LLMMessage, type LLMProvider, LLMProviderError, type LLMResponse, type LLMStopReason, type LLMStreamChunk, LLMTimeoutError, type LLMToolCall, type LLMToolDefinition, type LLMUsage, type LlmCallEvent, type ReactLoopConfig, ReactLoopError, type ReactLoopResult, type ReactLoopStreamChunk, type SchemaSourceRef, type SubAgentCallEvent, type SubAgentDelta, type SubAgentDeltaEmitter, type SubAgentToolResult, type ToolCallEvent, type ToolExecutor, type ToolSchemaResolution, type TracingToolResult, createLightComplete, createOpenAIProvider, createProvider, createToolSchemaResolver, agentPlugin as default, isSubAgentToolResult, isTracingToolResult, reactLoop, reactLoopStream };

package/dist/index.js

@@ -14,6 +14,13 @@ var LLMProviderError = class extends Error {
   status;
   /** 响应体摘要（前 500 字符,便于诊断） */
   body;
+  /**
+   * 实际发起的 HTTP 尝试次数（≥1，含失败尝试）
+   *
+   * 重试耗尽抛出时由重试循环回填（构造时未知，故非 readonly）；
+   * 首次尝试即失败的确定性错误（4xx 直抛）为 1，未回填时视为 1。
+   */
+  attempts;
   constructor(message, options) {
     super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
     this.name = "LLMProviderError";
@@ -21,6 +28,12 @@ var LLMProviderError = class extends Error {
     this.body = options?.body;
   }
 };
+var LLMTimeoutError = class extends LLMProviderError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "LLMTimeoutError";
+  }
+};
 function createOpenAIProvider(config) {
   const baseURL = (config.baseURL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
   const apiKey = config.apiKey;
@@ -69,13 +82,19 @@ function createOpenAIProvider(config) {
     if (apiKey) headers.Authorization = `Bearer ${apiKey}`;
     return headers;
   }
-  function classifyAbortError(err, externalSignal) {
+  function resolveTimeoutMs(request) {
+    if (typeof request.timeoutMs === "number") return request.timeoutMs;
+    return typeof config.timeoutMs === "number" ? config.timeoutMs : void 0;
+  }
+  function classifyAbortError(err, externalSignal, timeoutMs) {
     if (externalSignal?.aborted) {
       return new AgentAbortError();
     }
     const errName = err?.name;
     if (errName === "AbortError" || errName === "TimeoutError") {
-      return new LLMProviderError(`LLM request timed out after ${config.timeoutMs}ms`);
+      return new LLMTimeoutError(
+        timeoutMs !== void 0 ? `LLM request timed out after ${timeoutMs}ms` : "LLM request timed out"
+      );
     }
     const reason = err instanceof Error ? err.message : String(err);
     return new LLMProviderError(`Network error: ${reason}`, { cause: err });
@@ -84,11 +103,11 @@ function createOpenAIProvider(config) {
     const name = err?.name;
     return name === "AbortError" || name === "TimeoutError";
   }
-  async function safeFetch(url, init, externalSignal) {
+  async function safeFetch(url, init, externalSignal, timeoutMs) {
     try {
       return await fetch(url, init);
     } catch (err) {
-      throw classifyAbortError(err, externalSignal);
+      throw classifyAbortError(err, externalSignal, timeoutMs);
     }
   }
   function isRetryable(err) {
@@ -106,17 +125,23 @@ function createOpenAIProvider(config) {
   }
   function effectiveSignal(request) {
     const { signal } = request;
-    const timeoutMs = typeof config.timeoutMs === "number" ? config.timeoutMs : void 0;
+    const timeoutMs = resolveTimeoutMs(request);
     if (!signal && !timeoutMs) return void 0;
     const signals = [];
     if (signal) signals.push(signal);
     if (timeoutMs) signals.push(AbortSignal.timeout(timeoutMs));
     return signals.length === 1 ? signals[0] : AbortSignal.any(signals);
   }
-  async function fetchOkWithRetry(url, baseInit, request, maxRetries2) {
+  function resolveMaxRetries(request) {
+    if (typeof request.maxRetries === "number") return Math.max(0, request.maxRetries);
+    return maxRetries;
+  }
+  async function fetchOkWithRetry(url, baseInit, request) {
+    const maxAttemptsRetries = resolveMaxRetries(request);
+    const timeoutMs = resolveTimeoutMs(request);
     let lastErr;
     let lastResponse;
-    for (let attempt = 0; attempt <= maxRetries2; attempt++) {
+    for (let attempt = 0; attempt <= maxAttemptsRetries; attempt++) {
       if (request.signal?.aborted) {
         throw new AgentAbortError();
       }
@@ -126,13 +151,13 @@ function createOpenAIProvider(config) {
       const init = { ...baseInit, signal: effectiveSignal(request) };
       let response;
       try {
-        response = await safeFetch(url, init, request.signal);
+        response = await safeFetch(url, init, request.signal, timeoutMs);
       } catch (err2) {
         if (!isRetryable(err2)) throw err2;
         lastErr = err2;
         continue;
       }
-      if (response.ok) return response;
+      if (response.ok) return { response, attempts: attempt + 1 };
       let excerpt = "<body unreadable>";
       try {
         excerpt = (await response.text()).slice(0, 500);
@@ -146,6 +171,9 @@ function createOpenAIProvider(config) {
       lastErr = err;
       lastResponse = response;
     }
+    if (lastErr instanceof LLMProviderError) {
+      lastErr.attempts = maxAttemptsRetries + 1;
+    }
     throw lastErr;
   }
   async function complete(request) {
@@ -156,13 +184,14 @@ function createOpenAIProvider(config) {
       headers: buildHeaders(),
       body: JSON.stringify(body)
     };
-    const response = await fetchOkWithRetry(url, baseInit, request, maxRetries);
+    const timeoutMs = resolveTimeoutMs(request);
+    const { response, attempts } = await fetchOkWithRetry(url, baseInit, request);
     let bodyText;
     try {
       bodyText = await response.text();
     } catch (err) {
       if (!isAbortLike(err)) throw err;
-      throw classifyAbortError(err, request.signal);
+      throw classifyAbortError(err, request.signal, timeoutMs);
     }
     let json;
     try {
@@ -192,7 +221,8 @@ function createOpenAIProvider(config) {
     return {
       message,
       stopReason: mapStopReason(choice.finish_reason ?? void 0),
-      usage: mapUsage(json.usage)
+      usage: mapUsage(json.usage),
+      attempts
     };
   }
   async function* stream(request) {
@@ -204,7 +234,8 @@ function createOpenAIProvider(config) {
       headers: buildHeaders(),
       body: JSON.stringify(body)
     };
-    const response = await fetchOkWithRetry(url, baseInit, request, maxRetries);
+    const timeoutMs = resolveTimeoutMs(request);
+    const { response } = await fetchOkWithRetry(url, baseInit, request);
     if (!response.body) {
       throw new LLMProviderError("Response body is null (streaming unsupported)", {
         status: response.status
@@ -281,7 +312,7 @@ function createOpenAIProvider(config) {
       yield finalizeStreamChunk(accumulators, finishReason, usage);
     } catch (err) {
       if (!isAbortLike(err)) throw err;
-      throw classifyAbortError(err, request.signal);
+      throw classifyAbortError(err, request.signal, timeoutMs);
     } finally {
       try {
         await reader.cancel();
@@ -433,6 +464,9 @@ function createProvider(config) {
   }
 }
 
+// src/agent.ts
+import { readResource, subAgentToolName } from "@faapi/faapi";
+
 // src/trace.ts
 function isTracingToolResult(value) {
   return typeof value === "object" && value !== null && value.__trace === true;
@@ -958,7 +992,6 @@ async function* reactLoopStream(input, config) {
 }
 
 // src/agent.ts
-import { readResource, subAgentToolName } from "@faapi/faapi";
 var DEFAULT_MAX_AGENT_DEPTH = 3;
 var DEFAULT_SUBAGENT_INPUT_DESCRIPTION = "\u6D3E\u53D1\u7ED9\u8BE5 agent \u7684\u4EFB\u52A1\u4EA4\u63A5\u5355\uFF08\u81EA\u7136\u8BED\u8A00\uFF09\uFF1A\u5199\u6E05\u4EFB\u52A1\u76EE\u6807\u3001\u5FC5\u8981\u7684\u4E0A\u4E0B\u6587\u4FE1\u606F\u4E0E\u5BF9\u4EA7\u51FA\u7ED3\u679C\u7684\u8981\u6C42";
 function extractSubAgentUserInput(args) {
@@ -984,6 +1017,64 @@ function materializeProvider(external) {
     'options.provider must be an LlmConfig object (with a string "provider" field) or an LLMProvider instance (with complete/stream methods)'
   );
 }
+function resolveModelKey(key, deps, fallbackKey) {
+  const effectiveKey = key ?? fallbackKey;
+  if (effectiveKey === void 0) {
+    throw new AgentError(
+      'No LLM provider resolved: pass options.model (a provider key / "provider/model" / model name from config.agent.llms), options.provider (external provider), or declare model in the agent config'
+    );
+  }
+  const byProviderKey = deps.providers.get(effectiveKey);
+  if (byProviderKey) {
+    const llmConfig = deps.llms[effectiveKey];
+    const firstModel = llmConfig ? Object.keys(llmConfig.models)[0] : void 0;
+    return {
+      provider: byProviderKey,
+      providerName: effectiveKey,
+      model: firstModel ?? fallbackKey
+    };
+  }
+  if (effectiveKey.includes("/")) {
+    const slashIdx = effectiveKey.indexOf("/");
+    const providerName = effectiveKey.slice(0, slashIdx);
+    const modelName = effectiveKey.slice(slashIdx + 1);
+    const provider = deps.providers.get(providerName);
+    if (!provider) {
+      throw new AgentError(
+        `Unknown provider "${providerName}" in model key "${effectiveKey}". Declare it in config.agent.llms, or pass options.provider to use an external provider.`
+      );
+    }
+    const llmConfig = deps.llms[providerName];
+    if (!llmConfig || !llmConfig.models[modelName]) {
+      throw new AgentError(
+        `Model "${modelName}" not found in provider "${providerName}". Declare it in config.agent.llms.${providerName}.models.`
+      );
+    }
+    return { provider, providerName, model: modelName };
+  }
+  const matches = [];
+  for (const [providerName, provider] of deps.providers) {
+    const llmConfig = deps.llms[providerName];
+    if (llmConfig && llmConfig.models[effectiveKey]) {
+      matches.push({ provider, providerName });
+    }
+  }
+  if (matches.length === 1) {
+    return {
+      provider: matches[0].provider,
+      providerName: matches[0].providerName,
+      model: effectiveKey
+    };
+  }
+  if (matches.length > 1) {
+    throw new AgentError(
+      `Model "${effectiveKey}" is ambiguous (found in providers: ${matches.map((m) => m.providerName).join(", ")}). Use "provider/model" to disambiguate.`
+    );
+  }
+  throw new AgentError(
+    `Model "${effectiveKey}" not found in any provider. Declare it in config.agent.llms.*.models, or pass options.provider to use an external provider.`
+  );
+}
 function validateResumeHistory(messages) {
   messages.forEach((message, index) => {
     if (!VALID_MESSAGE_ROLES.has(message.role)) {
@@ -1286,72 +1377,14 @@ var Agent = class _Agent {
     return { provider, model };
   }
   /**
-   * 解析 `options.model` 字符串 key → provider + model
-   *
-   * 规则见 [agentHandle.md](./agentHandle.md) 的「`options.model` 字符串 key 解析规则」。
-   * 无默认 provider——`key` 未传时用 agent 元数据 `config.model` 作为缺省 key；
-   * 两者皆无抛 `AgentError`（要求调用方传 `options.model` 或 `options.provider`）。
-   * 1. 精确匹配 `deps.providers` 的 key → 该 provider + 其 `models` 第一个 key
-   *    （该 provider 未声明 `models` 时回落 `meta.model`）
-   * 2. 含 `/` → `provider/model` 形式,`deps.providers.get(provider)` + 该 model
-   *    （要求该 model 在 `deps.llms[provider].models` 里）
-   * 3. 不含 `/` 且非 provider key → 在所有 provider 的 `models` 里按 model 名查找
-   *    - 唯一 → 该 provider + 该 model
-   *    - 多个 → 抛 `AgentError`（要求用 `provider/model` 消歧）
-   *    - 无 → 抛 `AgentError`
+   * 解析 `options.model` 字符串 key → provider + model（模块级 [resolveModelKey] 的
+   * Agent 方法包装——meta.model 作缺省 key，与 [lightComplete](./lightComplete.md) 共用同一解析实现）
    *
    * @throws {AgentError} key 与 `meta.model` 均缺省；key 解析失败（provider/model
    *   不存在或歧义）
    */
   resolveModelKey(key, meta) {
-    const effectiveKey = key ?? meta.model;
-    if (effectiveKey === void 0) {
-      throw new AgentError(
-        'No LLM provider resolved: pass options.model (a provider key / "provider/model" / model name from config.agent.llms), options.provider (external provider), or declare model in the agent config'
-      );
-    }
-    const byProviderKey = this.deps.providers.get(effectiveKey);
-    if (byProviderKey) {
-      const llmConfig = this.deps.llms[effectiveKey];
-      const firstModel = llmConfig ? Object.keys(llmConfig.models)[0] : void 0;
-      return { provider: byProviderKey, model: firstModel ?? meta.model };
-    }
-    if (effectiveKey.includes("/")) {
-      const slashIdx = effectiveKey.indexOf("/");
-      const providerName = effectiveKey.slice(0, slashIdx);
-      const modelName = effectiveKey.slice(slashIdx + 1);
-      const provider = this.deps.providers.get(providerName);
-      if (!provider) {
-        throw new AgentError(
-          `Unknown provider "${providerName}" in model key "${effectiveKey}". Declare it in config.agent.llms, or pass options.provider to use an external provider.`
-        );
-      }
-      const llmConfig = this.deps.llms[providerName];
-      if (!llmConfig || !llmConfig.models[modelName]) {
-        throw new AgentError(
-          `Model "${modelName}" not found in provider "${providerName}". Declare it in config.agent.llms.${providerName}.models.`
-        );
-      }
-      return { provider, model: modelName };
-    }
-    const matches = [];
-    for (const [providerName, provider] of this.deps.providers) {
-      const llmConfig = this.deps.llms[providerName];
-      if (llmConfig && llmConfig.models[effectiveKey]) {
-        matches.push({ provider, providerName });
-      }
-    }
-    if (matches.length === 1) {
-      return { provider: matches[0].provider, model: effectiveKey };
-    }
-    if (matches.length > 1) {
-      throw new AgentError(
-        `Model "${effectiveKey}" is ambiguous (found in providers: ${matches.map((m) => m.providerName).join(", ")}). Use "provider/model" to disambiguate.`
-      );
-    }
-    throw new AgentError(
-      `Model "${effectiveKey}" not found in any provider. Declare it in config.agent.llms.*.models, or pass options.provider to use an external provider.`
-    );
+    return resolveModelKey(key, this.deps, meta.model);
   }
   /**
    * 组装 LLM 可见 tool 列表（OpenAI chat completions 规范形）
@@ -1623,6 +1656,72 @@ var Agent = class _Agent {
   }
 };
 
+// src/lightComplete.ts
+var DEFAULT_LIGHT_TIMEOUT_MS = 6e4;
+function createLightComplete(deps) {
+  const llms = deps.llms;
+  const providers = deps.providers ?? buildProviders(llms);
+  return {
+    async complete(input, options) {
+      const defaultKey = Object.keys(llms)[0];
+      const { provider, providerName, model } = resolveModelKey(
+        options?.model,
+        { providers, llms },
+        defaultKey
+      );
+      const messages = options?.system ? [
+        { role: "system", content: options.system },
+        { role: "user", content: input }
+      ] : [{ role: "user", content: input }];
+      const llmConfig = llms[providerName];
+      const configTimeout = typeof llmConfig?.timeoutMs === "number" ? llmConfig.timeoutMs : void 0;
+      const timeoutMs = options?.timeoutMs ?? configTimeout ?? DEFAULT_LIGHT_TIMEOUT_MS;
+      try {
+        const response = await provider.complete({
+          messages,
+          model,
+          ...options?.temperature !== void 0 ? { temperature: options.temperature } : {},
+          ...options?.maxTokens !== void 0 ? { maxTokens: options.maxTokens } : {},
+          ...options?.signal !== void 0 ? { signal: options.signal } : {},
+          timeoutMs,
+          ...options?.maxRetries !== void 0 ? { maxRetries: options.maxRetries } : {}
+        });
+        return response.message.content ?? "";
+      } catch (err) {
+        if (err instanceof AgentAbortError) throw err;
+        if (!(err instanceof LLMProviderError)) throw err;
+        return handleFailure(err, options);
+      }
+    }
+  };
+}
+function buildProviders(llms) {
+  const providers = /* @__PURE__ */ new Map();
+  for (const [name, llmConfig] of Object.entries(llms)) {
+    providers.set(name, createProvider(llmConfig));
+  }
+  return providers;
+}
+function handleFailure(err, options) {
+  const { onFailure, fallback } = options ?? {};
+  const attempts = err.attempts ?? 1;
+  if (onFailure) {
+    try {
+      onFailure(err, { attempts });
+    } catch {
+    }
+  }
+  if (fallback !== void 0) {
+    if (!onFailure) {
+      console.warn(
+        `[faapi/agent] llm.complete fallback engaged after ${attempts} attempt(s): ${err.message}`
+      );
+    }
+    return Promise.resolve(fallback);
+  }
+  return Promise.reject(err);
+}
+
 // src/toolSchemaResolver.ts
 import { statSync } from "fs";
 import { z } from "zod";
@@ -1692,6 +1791,7 @@ var agentPlugin = {
       }
       providers.set(name, createProvider(llmConfig));
     }
+    ctx.registries.llm.register(createLightComplete({ llms, providers }));
     const runtimeConfig = {
       maxTurns: agentConfig?.maxTurns,
       maxAgentDepth: agentConfig?.maxAgentDepth,
@@ -1739,7 +1839,9 @@ export {
   AgentRecursionError,
   AgentToolTimeoutError,
   LLMProviderError,
+  LLMTimeoutError,
   ReactLoopError,
+  createLightComplete,
   createOpenAIProvider,
   createProvider,
   createToolSchemaResolver,