@zqagent/core 0.3.12 → 0.3.13

package/dist/{TurnEngine-BU4R7q_0.d.ts → TurnEngine-BZjUGic_.d.ts}

@@ -353,6 +353,17 @@ declare class OpenAIProvider implements ProviderClient {
      */
     private _apiMode;
     constructor(opts: {
+        /**
+         * API Key。
+         *
+         * - 显式 `""`（含纯空白）：**明确表示该端点不需要鉴权**（本地 Ollama /
+         *   llama.cpp、内网网关），不会回落到环境变量，SDK 收到占位 Key。
+         * - `undefined`：回落到 `OPENAI_API_KEY`；两者都没有时抛错（多数情况是
+         *   真的没配，早点给出可读提示好过让用户对着 401 猜）。
+         *
+         * 调用方不要用「配置里 Key 为空」来推断无需鉴权：那也可能只是还没填，
+         * 见 `LlmProviderEntry.noApiKey`。
+         */
         apiKey?: string;
         baseURL?: string;
         /** LLM 请求日志根目录，按日期分目录，不传则不记录 */

package/dist/{TurnEngine-BSciNywD.d.cts → TurnEngine-CMGdcSdp.d.cts}

@@ -353,6 +353,17 @@ declare class OpenAIProvider implements ProviderClient {
      */
     private _apiMode;
     constructor(opts: {
+        /**
+         * API Key。
+         *
+         * - 显式 `""`（含纯空白）：**明确表示该端点不需要鉴权**（本地 Ollama /
+         *   llama.cpp、内网网关），不会回落到环境变量，SDK 收到占位 Key。
+         * - `undefined`：回落到 `OPENAI_API_KEY`；两者都没有时抛错（多数情况是
+         *   真的没配，早点给出可读提示好过让用户对着 401 猜）。
+         *
+         * 调用方不要用「配置里 Key 为空」来推断无需鉴权：那也可能只是还没填，
+         * 见 `LlmProviderEntry.noApiKey`。
+         */
         apiKey?: string;
         baseURL?: string;
         /** LLM 请求日志根目录，按日期分目录，不传则不记录 */

package/dist/index.cjs

@@ -4631,9 +4631,30 @@ var ResponsesApiError = class extends Error {
 };
 var NO_AUTH_KEY = "not-needed";
 var degradedModes = /* @__PURE__ */ new Map();
+var DEGRADED_TTL_MS = 30 * 6e4;
+var DEGRADED_MAX = 500;
 function modeKey(baseURL, model) {
   return `${baseURL}::${model}`;
 }
+function isDegraded(baseURL, model) {
+  const k = modeKey(baseURL, model);
+  const hit = degradedModes.get(k);
+  if (!hit) return false;
+  if (Date.now() - hit.at > DEGRADED_TTL_MS) {
+    degradedModes.delete(k);
+    return false;
+  }
+  return true;
+}
+function markDegraded(baseURL, model) {
+  degradedModes.delete(modeKey(baseURL, model));
+  degradedModes.set(modeKey(baseURL, model), { at: Date.now() });
+  while (degradedModes.size > DEGRADED_MAX) {
+    const oldest = degradedModes.keys().next();
+    if (oldest.done) break;
+    degradedModes.delete(oldest.value);
+  }
+}
 var OpenAIProvider = class {
   /** OpenAI SDK 客户端 */
   client;
@@ -4688,11 +4709,11 @@ var OpenAIProvider = class {
    */
   _resolveMode(model) {
     if (this._apiMode !== "auto") return this._apiMode;
-    return degradedModes.get(modeKey(this._baseURL, model)) ?? "responses";
+    return isDegraded(this._baseURL, model) ? "chat" : "responses";
   }
   /** 记录「该端点+模型不支持 Responses」，后续同进程内的请求直走 Chat */
   _markChatMode(model) {
-    degradedModes.set(modeKey(this._baseURL, model), "chat");
+    markDegraded(this._baseURL, model);
   }
   /**
    * Responses 失败的分类（决定「能不能改走 Chat Completions」以及要不要缓存降级）。