@zqagent/core 0.2.15 → 0.2.20

package/dist/{explore-COqHKDoK.d.cts → explore-BgRhj6SP.d.cts}

@@ -609,6 +609,16 @@ declare class TurnEngine {
     setSystemPrompt(prompt: string): void;
     /** 排队 steering 消息（下一迭代间隙注入为 user 消息） */
     queueSteering(text: string): void;
+    /**
+     * 撤销一条尚未注入的 steering。
+     *
+     * 按文本删第一条匹配项：调用方（SessionManager）已按索引删掉了自己那份队列，
+     * 这里只需保证引擎不再注入同样的内容。用文本而非索引，是因为引擎会在迭代
+     * 间隙批量清空 `_steering`，索引可能已经漂移；文本相同则删哪条都等价。
+     *
+     * @returns 是否真的删掉了（已注入的项返回 false，调用方据此提示用户）
+     */
+    removeSteering(text: string): boolean;
     /**
      * 运行一轮 Turn
      *

package/dist/{explore-B_bIPzmB.d.ts → explore-RtZtb-V6.d.ts}

@@ -609,6 +609,16 @@ declare class TurnEngine {
     setSystemPrompt(prompt: string): void;
     /** 排队 steering 消息（下一迭代间隙注入为 user 消息） */
     queueSteering(text: string): void;
+    /**
+     * 撤销一条尚未注入的 steering。
+     *
+     * 按文本删第一条匹配项：调用方（SessionManager）已按索引删掉了自己那份队列，
+     * 这里只需保证引擎不再注入同样的内容。用文本而非索引，是因为引擎会在迭代
+     * 间隙批量清空 `_steering`，索引可能已经漂移；文本相同则删哪条都等价。
+     *
+     * @returns 是否真的删掉了（已注入的项返回 false，调用方据此提示用户）
+     */
+    removeSteering(text: string): boolean;
     /**
      * 运行一轮 Turn
      *

package/dist/index.cjs

@@ -266,15 +266,27 @@ function networkErrorHints(message, errorType = "") {
   hints.push("\u2464 IPv6 \u6296\u52A8\u53EF\u8BD5\uFF1ANODE_OPTIONS=--dns-result-order=ipv4first");
   return hints;
 }
+function authErrorHints(message, code = "") {
+  const text = `${message} ${code}`;
+  if (!/401|403|unauthorized|forbidden|invalid[_\s]*api[_\s]*key|api[\s_-]*key\s*(?:无效|invalid)|管理令牌无效/i.test(text)) {
+    return [];
+  }
+  return [
+    "\u51ED\u636E\u65E0\u6548\uFF1A\u82E5\u7528\u7684\u662F\u300C\u5FD7\u524D\u5927\u6A21\u578B\uFF08\u5185\u7F6E\uFF09\u300D\uFF0C\u5728\u8282\u70B9\u8BBE\u7F6E\u7684\u6A21\u578B\u9875\u70B9\u300C\u5237\u65B0\u5185\u7F6E\u6A21\u578B\u300D\u91CD\u65B0\u9886\u53D6 Key\uFF08\u5728\u63A7\u5236\u53F0\u91CD\u7F6E\u8FC7 Key \u540E\u9700\u8981\u8FD9\u4E00\u6B65\uFF09\uFF1B\u82E5\u662F\u81EA\u586B\u7684\u4F9B\u5E94\u5546\uFF0C\u8BF7\u68C0\u67E5 Key \u662F\u5426\u6B63\u786E\u6216\u5DF2\u8FC7\u671F"
+  ];
+}
 function paramErrorHints(message, code = "") {
   const text = `${message} ${code}`;
   const hints = [];
-  if (/not[_\s]*(activated|enabled|purchased)|arrearage|quota|subscription|insufficient|未开通|欠费|额度/i.test(
+  if (/not[_\s]*(activated|enabled|purchased)|arrearage|quota|subscription|insufficient|未开通|欠费|额度|余额不足/i.test(
     text
   )) {
     hints.push(
       "\u8BE5\u6A21\u578B\u5728\u6B64 **API Key/\u8D26\u53F7** \u4E0B\u672A\u5F00\u901A\uFF08\u6216\u8D26\u53F7\u6B20\u8D39\u3001\u989D\u5EA6\u7528\u5C3D\uFF09\uFF1A\u5230\u7F51\u5173\u63A7\u5236\u53F0\u5F00\u901A\u8BE5\u6A21\u578B\uFF0C\u6216\u6362\u4E00\u4E2A\u5DF2\u5F00\u901A\u7684\u6A21\u578B"
     );
+    hints.push(
+      "\u5982\u679C\u4F60\u7528\u7684\u662F\u300C\u5FD7\u524D\u5927\u6A21\u578B\uFF08\u5185\u7F6E\uFF09\u300D\uFF1A\u5230 https://hub.cd-zq.com \u67E5\u770B\u4F59\u989D\u5E76\u5145\u503C\uFF1B\u4E5F\u53EF\u4EE5\u5148\u5207\u6362\u5230\u4F60\u81EA\u5DF1\u914D\u7F6E\u7684\u5176\u5B83\u6A21\u578B\u7EE7\u7EED\uFF08\u8282\u70B9\u8BBE\u7F6E \u2192 \u6A21\u578B \u2192 \u8BBE\u4E3A\u9ED8\u8BA4\uFF09"
+    );
   }
   if (/invalid[_\s]*parameter|invalidparameter|required[_\s]+parameter|missing[_\s]+parameter|invalid[_\s]*model|model[_\s]*not[_\s]*found|not[_\s]*support|unsupported/i.test(
     text
@@ -1464,6 +1476,21 @@ var TurnEngine = class _TurnEngine {
   queueSteering(text) {
     this._steering.push(text);
   }
+  /**
+   * 撤销一条尚未注入的 steering。
+   *
+   * 按文本删第一条匹配项：调用方（SessionManager）已按索引删掉了自己那份队列，
+   * 这里只需保证引擎不再注入同样的内容。用文本而非索引，是因为引擎会在迭代
+   * 间隙批量清空 `_steering`，索引可能已经漂移；文本相同则删哪条都等价。
+   *
+   * @returns 是否真的删掉了（已注入的项返回 false，调用方据此提示用户）
+   */
+  removeSteering(text) {
+    const i = this._steering.indexOf(text);
+    if (i < 0) return false;
+    this._steering.splice(i, 1);
+    return true;
+  }
   // ===================== 主入口 =====================
   /**
    * 运行一轮 Turn
@@ -4490,6 +4517,9 @@ var ConsoleHook = class {
     for (const hint of networkErrorHints(error, errorType)) {
       cliLog(`   \u{1F4A1} ${hint}`);
     }
+    for (const hint of authErrorHints(error, errorType)) {
+      cliLog(`   \u{1F4A1} ${hint}`);
+    }
     for (const hint of paramErrorHints(error)) {
       cliLog(`   \u{1F4A1} ${hint}`);
     }