foliko 2.0.9 → 2.0.11

package/package.json

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

package/plugins/core/workflow/index.js

@@ -999,7 +999,12 @@ class WorkflowPlugin extends Plugin {
         for (const file of files) {
           if (!file.endsWith('.json') && !file.endsWith('.js')) continue;
           const filePath = path.join(dir, file);
-          const workflowName = path.basename(file, path.extname(file));
+          let workflowName = path.basename(file, path.extname(file));
+          // 兼容 .flow.js / .flow.json 命名约定：去掉 .flow 后缀
+          // （如 weather_card.flow.js → workflow_weather_card 而不是 workflow_weather_card.flow）
+          if (workflowName.endsWith('.flow')) {
+            workflowName = workflowName.slice(0, -'.flow'.length);
+          }
           // 跳过已存在的工作流（先加载的优先）
           if (this._workflows.has(workflowName)) continue;
           try {
@@ -1064,7 +1069,10 @@ class WorkflowPlugin extends Plugin {
    */
   _registerWorkflowTools() {
     for (const [name, workflow] of this._workflows) {
-      const toolName = `workflow_${name}`;
+      // 工具名 sanitize：把文件名里的 . - 空格等替换为 _，避免 LLM 把名字当成
+      // "module.method" 调用语法（如 weather_card.flow.js → workflow_weather_card_flow）
+      const safeName = name.replace(/[^a-zA-Z0-9_]/g, '_');
+      const toolName = `workflow_${safeName}`;
       const description = workflow.description || `执行工作流: ${name}`;
       // 注意：framework.registerTool 不做去重，导致 reload 后会有两个同名
       // `workflow_<name>` 工具。getTool 返回第一个（旧的）。每次注册前先清掉。

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, filterOrphanToolCalls, validateMessagesPairing } = require('../utils/message-validator');
 
 /**
  * Session 作用域的事件监听器
@@ -222,7 +223,30 @@ class ChatSession extends EventEmitter {
           const messages = allMessages.length > MAX_INITIAL_LOAD
             ? allMessages.slice(-MAX_INITIAL_LOAD)
             : allMessages;
-          messageStore.messages = messages;
+          // 聊天前过滤：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）`);
+          }
+          // 聊天前过滤：把对"已不可用工具"的 tool-call 转成 text。
+          // 防止 LLM 在新会话里看到历史 tool-call 后继续重试不存在的工具
+          // （典型场景：工作流文件被删除/改名，chat log 保留了对它的引用）。
+          const availableToolNames = this.agent?.framework?.toolRegistry?.getNames?.() || [];
+          if (availableToolNames.length > 0) {
+            const orphans = filterOrphanToolCalls(messages, availableToolNames);
+            if (orphans > 0) {
+              logger.info(`[loadHistory] 转换 ${orphans} 条 orphan tool-call 为 text（工具已不可用）`);
+            }
+          }
+          // 转换 tool-call 后，相应的 tool-result 变成 orphan（没有对应 tool-call），
+          // 这里立即清理掉（和 _prepareSession 中的 _stripOrphanedToolMessages 等价）
+          const cleaned = validateMessagesPairing(messages, { log: false });
+          if (cleaned.length !== messages.length) {
+            logger.info(`[loadHistory] 清理 ${messages.length - cleaned.length} 条 orphan tool-result`);
+          }
+          messageStore.messages = cleaned;
           messageStore.historyLoaded = true;
           messageStore._hasMoreHistory = allMessages.length > MAX_INITIAL_LOAD;
           //logger.debug(`Loaded ${messages.length} msgs for session ${sessionId} (total: ${allMessages.length})`);

package/src/utils/message-validator.js

@@ -175,6 +175,103 @@ function validateAll(messages) {
   return validateMessagesPairing(messages);
 }
 
+// AI SDK v6 ToolResultOutput 允许的类型（用于 ModelMessage[] 输入 schema）
+const VALID_OUTPUT_TYPES = new Set(['text', 'json', 'execution-denied', 'content']);
+
+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;
+}
+
+/**
+ * 把 assistant 消息里"已不可用工具"的 tool-call 转成 text，
+ * 防止 LLM 在新会话里看到历史 tool-call 后重试不存在的工具。
+ *
+ * 典型场景：
+ * - 工作流文件被删除/改名后，chat log 里仍保留对该工作流的 tool-call
+ * - 插件被禁用后，chat log 里保留该插件工具的 tool-call
+ *
+ * 转换后的 text 形如 "（工具 xxx 已不可用，原 tool-call 已跳过）"，
+ * 紧接的 tool-result 如果是正常的成功结果会被保留；如果是失败结果
+ * （error-text 已 normalize 为 text），orphan 的 tool-result 会被
+ * `_stripOrphanedToolMessages` / `validateMessagesPairing` 自然清理。
+ *
+ * @param {Array} messages - 消息数组（会被修改）
+ * @param {Set<string>|Array<string>} availableToolNames - 当前可用的工具名集合
+ * @returns {number} 转换的 tool-call 数量
+ */
+function filterOrphanToolCalls(messages, availableToolNames) {
+  if (!Array.isArray(messages) || !availableToolNames) return 0;
+  const available = availableToolNames instanceof Set
+    ? availableToolNames
+    : new Set(availableToolNames);
+  let converted = 0;
+
+  for (const msg of messages) {
+    if (msg.role !== 'assistant' || !Array.isArray(msg.content)) continue;
+    // 收集本条消息中所有 tool-call ID，便于在转换后保留
+    const newContent = [];
+    for (const part of msg.content) {
+      if (!part || (part.type !== 'tool-call' && part.type !== 'tool-use')) {
+        newContent.push(part);
+        continue;
+      }
+      if (part.toolName && available.has(part.toolName)) {
+        newContent.push(part);
+        continue;
+      }
+      // tool 不可用 → 转成 text 提示
+      converted++;
+      const reason = part.toolName
+        ? `（工具 ${part.toolName} 当前不可用，原 tool-call 已跳过）`
+        : `（工具调用参数不完整，已跳过）`;
+      newContent.push({
+        type: 'text',
+        text: reason,
+      });
+      // 注意：原 part 的 toolCallId 不再出现在新 content 里，
+      // _stripOrphanedToolMessages 会把对应的 tool-result 视为 orphan 并清理
+    }
+    msg.content = newContent;
+  }
+  return converted;
+}
+
 /**
  * 过滤消息，保留配对的 tool-call → tool-result 链条
  * 用于上下文压缩后保留完整的工具调用链路
@@ -283,5 +380,7 @@ module.exports = {
   validateMessagesPairing,
   validateToolCalls,
   validateAll,
+  normalizeToolOutputs,
+  filterOrphanToolCalls,
   filterPairedMessages,
 };