foliko 2.0.10 → 2.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "2.0.10",
+  "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/session/chat.js

@@ -10,7 +10,7 @@
 
 const { EventEmitter } = require('../common/events');
 const { logger } = require('../common/logger');
-const { normalizeToolOutputs } = require('../utils/message-validator');
+const { normalizeToolOutputs, filterOrphanToolCalls, validateMessagesPairing } = require('../utils/message-validator');
 
 /**
  * Session 作用域的事件监听器
@@ -230,7 +230,23 @@ class ChatSession extends EventEmitter {
           if (fixed > 0) {
             logger.info(`[loadHistory] 规范化 ${fixed} 条 tool-result（error-text/error-json → text/json）`);
           }
-          messageStore.messages = messages;
+          // 聊天前过滤：把对"已不可用工具"的 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

@@ -178,20 +178,6 @@ function validateAll(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) {
@@ -232,6 +218,60 @@ function normalizeToolOutputs(messages) {
   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 链条
  * 用于上下文压缩后保留完整的工具调用链路
@@ -341,5 +381,6 @@ module.exports = {
   validateToolCalls,
   validateAll,
   normalizeToolOutputs,
+  filterOrphanToolCalls,
   filterPairedMessages,
 };