foliko 2.0.9 → 2.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "2.0.9",
+  "version": "2.0.10",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/src/agent/chat.js

@@ -555,6 +555,9 @@ class AgentChatHandler extends EventEmitter {
           }
         }
       }
+      // 写入端 sanitize：AI SDK v6 响应里允许 error-text/error-json（工具失败标记），
+      // 但 ModelMessage 输入 schema 不接受；持久化前必须规范化
+      this._normalizeToolOutputs(finishMessages);
       messages.push(...finishMessages);
 
       // 获取或估算 token 用量
@@ -795,12 +798,56 @@ class AgentChatHandler extends EventEmitter {
     messages.push(userMessage);
     this._validateToolCalls(messages);
 
+    // 读取端 sanitize：修复历史 chat log 中可能存在的 error-text/error-json
+    this._normalizeToolOutputs(messages);
+
     // 最终兜底：暴力清理所有 orphaned tool 消息，确保 AI SDK 不报错
     this._stripOrphanedToolMessages(messages);
 
     return { messageStore, messages };
   }
 
+  /**
+   * 规范化 tool-result 的 output 字段。
+   * AI SDK v6 响应中允许 'error-text' / 'error-json'（表示工具执行失败），
+   * 但 ModelMessage 输入 schema（AI SDK 发送 prompt 时使用）不接受这两类。
+   * 必须在写入磁盘和读取发送前都做转换。
+   * @private
+   */
+  _normalizeToolOutputs(messages) {
+    const VALID_OUTPUT_TYPES = new Set(['text', 'json', 'execution-denied', 'content']);
+    let fixed = 0;
+    for (const msg of messages) {
+      if (msg.role !== 'tool' || !Array.isArray(msg.content)) continue;
+      for (const part of msg.content) {
+        if (!part || part.type !== 'tool-result') continue;
+        const out = part.output;
+        if (out === undefined || out === null || typeof out !== 'object') {
+          const v = out === undefined ? 'undefined' : (typeof out === 'string' ? out : JSON.stringify(out));
+          part.output = { type: 'text', value: String(v) };
+          fixed++;
+          continue;
+        }
+        if (VALID_OUTPUT_TYPES.has(out.type)) continue;
+        if (out.type === 'error-text' || out.type === 'error_text') {
+          part.output = { type: 'text', value: typeof out.value === 'string' ? out.value : String(out.value ?? '') };
+          fixed++;
+          continue;
+        }
+        if (out.type === 'error-json' || out.type === 'error_json') {
+          part.output = { type: 'json', value: out.value ?? null };
+          fixed++;
+          continue;
+        }
+        // 未知 type 降级为 text
+        try { part.output = { type: 'text', value: JSON.stringify(out) }; }
+        catch { part.output = { type: 'text', value: String(out) }; }
+        fixed++;
+      }
+    }
+    return fixed;
+  }
+
   /**
    * 更新消息存储的使用量
    * @private

package/src/agent/main.js

@@ -401,6 +401,8 @@ class MainAgent extends BaseAgent {
     const sessionCtx = this.framework?.getSessionContext(sessionId);
     if (!messages?.length && sessionCtx) {
       messages = sessionCtx.getMessages();
+      // 同样规范化：避免压缩器处理到坏数据
+      require('../utils/message-validator').normalizeToolOutputs(messages);
       messageStore.messages = messages;
     }
     if (!messages?.length) throw new Error('No messages to compress');

package/src/session/chat.js

@@ -10,6 +10,7 @@
 
 const { EventEmitter } = require('../common/events');
 const { logger } = require('../common/logger');
+const { normalizeToolOutputs } = require('../utils/message-validator');
 
 /**
  * Session 作用域的事件监听器
@@ -222,6 +223,13 @@ class ChatSession extends EventEmitter {
           const messages = allMessages.length > MAX_INITIAL_LOAD
             ? allMessages.slice(-MAX_INITIAL_LOAD)
             : allMessages;
+          // 聊天前过滤：AI SDK v6 响应中允许 error-text/error-json（工具失败），
+          // 但 ModelMessage 输入 schema 不接受。加载到内存时立即规范化，
+          // 这样显示/统计/压缩/持久化回写都看到干净数据。
+          const fixed = normalizeToolOutputs(messages);
+          if (fixed > 0) {
+            logger.info(`[loadHistory] 规范化 ${fixed} 条 tool-result（error-text/error-json → text/json）`);
+          }
           messageStore.messages = messages;
           messageStore.historyLoaded = true;
           messageStore._hasMoreHistory = allMessages.length > MAX_INITIAL_LOAD;

package/src/utils/message-validator.js

@@ -175,6 +175,63 @@ function validateAll(messages) {
   return validateMessagesPairing(messages);
 }
 
+// AI SDK v6 ToolResultOutput 允许的类型（用于 ModelMessage[] 输入 schema）
+const VALID_OUTPUT_TYPES = new Set(['text', 'json', 'execution-denied', 'content']);
+
+/**
+ * 规范化 tool-result 的 output 字段。
+ * AI SDK v6 响应中允许 'error-text' / 'error-json'（表示工具执行失败），
+ * 但 ModelMessage 输入 schema 不接受这两类。需要在发送前 / 持久化前转换。
+ *
+ * 转换规则：
+ * - error-text → text
+ * - error-json → json
+ * - 任何未知 type → text（保留 value 字段）
+ * - output 缺失或非对象 → 包装为 text 'null'
+ *
+ * @param {Array} messages - 消息数组（会被修改）
+ * @returns {number} 规范化次数
+ */
+function normalizeToolOutputs(messages) {
+  let fixed = 0;
+  for (const msg of messages) {
+    if (msg.role !== 'tool' || !Array.isArray(msg.content)) continue;
+    for (const part of msg.content) {
+      if (!part || part.type !== 'tool-result') continue;
+      const out = part.output;
+      // 缺 output 或 output 非对象：包装为 text
+      if (out === undefined || out === null || typeof out !== 'object') {
+        const v = out === undefined ? 'undefined' : (typeof out === 'string' ? out : JSON.stringify(out));
+        part.output = { type: 'text', value: String(v) };
+        fixed++;
+        continue;
+      }
+      // 已知合法 type：跳过
+      if (VALID_OUTPUT_TYPES.has(out.type)) continue;
+      // error-text → text（保留原 value 字符串）
+      if (out.type === 'error-text' || out.type === 'error_text') {
+        part.output = { type: 'text', value: typeof out.value === 'string' ? out.value : String(out.value ?? '') };
+        fixed++;
+        continue;
+      }
+      // error-json → json
+      if (out.type === 'error-json' || out.type === 'error_json') {
+        part.output = { type: 'json', value: out.value ?? null };
+        fixed++;
+        continue;
+      }
+      // 其它未知 type：降级为 text（保留 value 字符串或 JSON 序列化）
+      try {
+        part.output = { type: 'text', value: JSON.stringify(out) };
+      } catch {
+        part.output = { type: 'text', value: String(out) };
+      }
+      fixed++;
+    }
+  }
+  return fixed;
+}
+
 /**
  * 过滤消息，保留配对的 tool-call → tool-result 链条
  * 用于上下文压缩后保留完整的工具调用链路
@@ -283,5 +340,6 @@ module.exports = {
   validateMessagesPairing,
   validateToolCalls,
   validateAll,
+  normalizeToolOutputs,
   filterPairedMessages,
 };