foliko 1.1.75 → 1.1.76

package/.claude/settings.local.json

@@ -230,7 +230,11 @@
       "Bash(grep -r \"logger\\\\.\" D:/date/20260516/pi/packages --include=\"*.ts\" ! -path \"*/node_modules/*\" ! -path \"*/test/*\")",
       "Bash(grep *)",
       "Bash(node -e \"require\\('./plugins/audit-plugin.js'\\); console.log\\('audit-plugin loaded'\\)\")",
-      "Bash(node -e \"const { createAI, DEFAULT_PROVIDERS } = require\\('./src/core/provider'\\); console.log\\('Providers:', Object.keys\\(DEFAULT_PROVIDERS\\)\\);\")"
+      "Bash(node -e \"const { createAI, DEFAULT_PROVIDERS } = require\\('./src/core/provider'\\); console.log\\('Providers:', Object.keys\\(DEFAULT_PROVIDERS\\)\\);\")",
+      "Bash(npx designmd-mcp *)",
+      "Bash(node -e \"const { spawn } = require\\('child_process'\\); const p = spawn\\('npx', ['designmd-mcp'], { stdio: 'pipe' }\\); let out = ''; p.stdout.on\\('data', \\(d\\) => { out += d.toString\\(\\); if\\(out.length > 1000\\) { console.log\\('OUTPUT_TOO_LONG:' + out.length\\); process.exit\\(0\\); } }\\); p.stderr.on\\('data', \\(d\\) => console.log\\('STDERR:' + d.toString\\(\\)\\)\\); setTimeout\\(\\(\\) => { console.log\\('FINAL_OUTPUT_LENGTH:' + out.length\\); process.exit\\(0\\); }, 3000\\);\")",
+      "Bash(where npx *)",
+      "Bash(node *)"
     ]
   }
 }

package/.dockerignore

@@ -1,45 +1,45 @@
-# 依赖
-node_modules
-.foliko/node_modules
-
-# 日志
-*.log
-npm-debug.log*
-
-# 环境变量（包含敏感信息）
-.env
-.env.local
-
-# Git
-.git
-.gitignore
-
-# IDE
-.idea
-.vscode
-*.swp
-*.swo
-
-# 文档（可选保留）
-*.md
-!README.md
-
-# 测试
-test
-tests
-coverage
-
-# 临时文件
-tmp
-temp
-*.tmp
-
-# Docker 相关（避免递归）
-Dockerfile*
-docker-compose*
-.dockerignore
-
-# CI/CD
-.github
-.gitlab-ci.yml
-.travis.yml
+# 依赖
+node_modules
+.foliko/node_modules
+
+# 日志
+*.log
+npm-debug.log*
+
+# 环境变量（包含敏感信息）
+.env
+.env.local
+
+# Git
+.git
+.gitignore
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# 文档（可选保留）
+*.md
+!README.md
+
+# 测试
+test
+tests
+coverage
+
+# 临时文件
+tmp
+temp
+*.tmp
+
+# Docker 相关（避免递归）
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# CI/CD
+.github
+.gitlab-ci.yml
+.travis.yml

package/.env.example

@@ -1,56 +1,56 @@
-# ========== AI Configuration ==========
-# 最大输出 tokens（影响 AI 回复长度）
-MAX_OUTPUT_TOKENS=8192
-# AI Provider: minimax, deepseek, openai, anthropic 等
-FOLIKO_PROVIDER=minimax
-
-# AI Model（如果未设置，使用 provider 默认值）
-# MiniMax: MiniMax-M2.7
-# DeepSeek: deepseek-chat, deepseek-coder 等
-FOLIKO_MODEL=MiniMax-M2.7
-
-# API Base URL（如果未设置，使用 provider 默认值）
-# MiniMax: https://api.minimaxi.com/v1
-# DeepSeek: https://api.deepseek.com/v1
-FOLIKO_BASE_URL=https://api.minimaxi.com/v1
-
-# API Key（通用，如果未设置则尝试 provider 专用 key）
-FOLIKO_API_KEY=sk-your-api-key
-
-# Provider 专用 API Key（可选，如果 FOLIKO_API_KEY 未设置则使用这些）
-DEEPSEEK_API_KEY=sk-your-deepseek-api-key
-MINIMAX_API_KEY=sk-your-minimax-api-key
-
-# ========== Email Configuration ==========
-# SMTP Settings (for sending emails)
-SMTP_HOST=smtp.gmail.com
-SMTP_PORT=587
-SMTP_SECURE=false
-SMTP_USER=your-email@gmail.com
-SMTP_PASS=your-app-password
-
-# IMAP Settings (for reading emails)
-IMAP_HOST=imap.gmail.com
-IMAP_PORT=993
-IMAP_USER=your-email@gmail.com
-IMAP_PASS=your-app-password
-
-# Default sender email address
-FROM_EMAIL=your-email@gmail.com
-
-# ========== Telegram Bot (optional) ==========
-TELEGRAM_BOT_TOKEN=your-telegram-bot-token
-
-# ========== Feishu Bot (optional) ==========
-FEISHU_APP_ID=cli_xxxxxxxxxxx
-FEISHU_APP_SECRET=app_secret
-
-# ========== Web Server (optional) ==========
-# Web 服务端口，默认 8088
-WEB_PORT=3000
-
-# Web 服务主机，默认 127.0.0.1
-WEB_HOST=127.0.0.1
-
-# 公网访问的 base URL（用于生成 webhook URL 等），不设置则使用 host:port，最好部署在docker中可以暴露自定义域名
-WEB_BASE_URL=https://your-domain.com
+# ========== AI Configuration ==========
+# 最大输出 tokens（影响 AI 回复长度）
+MAX_OUTPUT_TOKENS=8192
+# AI Provider: minimax, deepseek, openai, anthropic 等
+FOLIKO_PROVIDER=minimax
+
+# AI Model（如果未设置，使用 provider 默认值）
+# MiniMax: MiniMax-M2.7
+# DeepSeek: deepseek-chat, deepseek-coder 等
+FOLIKO_MODEL=MiniMax-M2.7
+
+# API Base URL（如果未设置，使用 provider 默认值）
+# MiniMax: https://api.minimaxi.com/v1
+# DeepSeek: https://api.deepseek.com/v1
+FOLIKO_BASE_URL=https://api.minimaxi.com/v1
+
+# API Key（通用，如果未设置则尝试 provider 专用 key）
+FOLIKO_API_KEY=sk-your-api-key
+
+# Provider 专用 API Key（可选，如果 FOLIKO_API_KEY 未设置则使用这些）
+DEEPSEEK_API_KEY=sk-your-deepseek-api-key
+MINIMAX_API_KEY=sk-your-minimax-api-key
+
+# ========== Email Configuration ==========
+# SMTP Settings (for sending emails)
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=your-email@gmail.com
+SMTP_PASS=your-app-password
+
+# IMAP Settings (for reading emails)
+IMAP_HOST=imap.gmail.com
+IMAP_PORT=993
+IMAP_USER=your-email@gmail.com
+IMAP_PASS=your-app-password
+
+# Default sender email address
+FROM_EMAIL=your-email@gmail.com
+
+# ========== Telegram Bot (optional) ==========
+TELEGRAM_BOT_TOKEN=your-telegram-bot-token
+
+# ========== Feishu Bot (optional) ==========
+FEISHU_APP_ID=cli_xxxxxxxxxxx
+FEISHU_APP_SECRET=app_secret
+
+# ========== Web Server (optional) ==========
+# Web 服务端口，默认 8088
+WEB_PORT=3000
+
+# Web 服务主机，默认 127.0.0.1
+WEB_HOST=127.0.0.1
+
+# 公网访问的 base URL（用于生成 webhook URL 等），不设置则使用 host:port，最好部署在docker中可以暴露自定义域名
+WEB_BASE_URL=https://your-domain.com

package/cli/src/ui/chat-ui.js

@@ -9,12 +9,14 @@ const { TUI, ProcessTerminal, Editor, Text, CombinedAutocompleteProvider, matche
 const { cleanResponse, logger } = require('../../../src/utils');
 const { logEmitter } = require('../../../src/utils/logger');
 const { renderLine } = require('../utils/markdown');
-const { MessageBubble } = require('./message-bubble');
+const { MessageBubble } = require('./components/message-bubble');
 const Queue=require('js-queue');
 const hl = require('cli-highlight');
 const { renderDiffWithHeader } = require('../utils/render-diff');
-const { FooterBar } = require('./footer-bar');
-const { StatusBar } = require('./status-bar');
+const { FooterBar } = require('./components/footer-bar');
+const { StatusBar } = require('./components/status-bar');
+const { AgentMentionProvider } = require('./components/agent-mention-provider');
+const { ChainedAutocompleteProvider } = require('./components/chained-autocomplete-provider');
 const queue=new Queue();
 // Foliko 主色（蓝绿）
 const folikoPrimary = chalk.hex('#2A9D8F');
@@ -103,10 +105,12 @@ class ChatUI {
       { name: "reload", description: "重载技能" },
     ];
 
-    this.autocompleteProvider = new CombinedAutocompleteProvider(
-      [...baseCommands, ...this.skillCommands],
-      process.cwd(),
-    );
+    this.autocompleteProvider = new ChainedAutocompleteProvider([
+        // 优先拦截 @子Agent 补全
+        new AgentMentionProvider(agent.framework),
+        // 文件路径 / slash 命令补全
+        new CombinedAutocompleteProvider([...baseCommands, ...this.skillCommands], process.cwd()),
+    ]);
 
     const editor=this.editor = new Editor(this.tui, editorTheme,{paddingX:1});
     this.editor.setAutocompleteProvider(this.autocompleteProvider);
@@ -192,13 +196,13 @@ class ChatUI {
         ERROR: 'red',
       }
       // 监听错误日志，显示到 tooler
-      // this._logHandler = (data) => {
-      //   if(!Object.keys(level_dict).includes(data.level))return;
-      //   const level=folikoTerracotta(`[${data.level}]`)
-      //   const level_key=level_dict[data.level]||'dim'
-      //   this.statusBar.notifier.show(`${level} ${chalk[level_key](data.message)}`)
-      // };
-      // logger.on('log', this._logHandler);
+      this._logHandler = (data) => {
+        if(!Object.keys(level_dict).includes(data.level))return;
+        const level=folikoTerracotta(`[${data.level}]`)
+        const level_key=level_dict[data.level]||'dim'
+        this.statusBar.notifier.show(`${level} ${chalk[level_key](data.message)}`)
+      };
+      logger.on('log', this._logHandler);
 
       // 监听通知事件，显示到通知区域
       this._notificationHandler = (data) => {
@@ -455,62 +459,20 @@ class ChatUI {
 
 
    _clearContext() {
-    // 隐藏 loader 和 tooler
-    this.statusBar.tooler.hide();
-    this.statusBar.loader.hide();
+    
 
     const { sessionId } = this;
+    this.agent.clearContext(sessionId);
 
-    // Clear ChatSession message store (memory + file)
-    if (this.agent._chatSession) {
-      this.agent._chatSession.clearSessionMessages(sessionId, true);
-    }
-
-    // 1. 清除 AgentChatHandler 的消息存储（需要传 sessionId）
-    if (this.agent._chatHandler) {
-      this.agent._chatHandler.clearHistory(sessionId);
-    }
-
-    // 2. 清除 SessionContext 的消息和压缩计数
-    if (this.agent.framework) {
-      const sessionCtx = this.agent.framework.getSessionContext(sessionId);
-      if (sessionCtx) {
-        sessionCtx.clearMessages();
-        if (sessionCtx.compressionState) {
-          sessionCtx.compressionState.count = 0;
-        }
-        if (sessionCtx.metadata) {
-          sessionCtx.metadata.compressionCount = 0;
-        }
-      }
-      // 同步清除 framework 缓存的 sessionContexts
-      const cachedCtx = this.agent.framework._sessionContexts?.get(sessionId);
-      if (cachedCtx) {
-        cachedCtx.clearMessages();
-        if (cachedCtx.compressionState) {
-          cachedCtx.compressionState.count = 0;
-        }
-        if (cachedCtx.metadata) {
-          cachedCtx.metadata.compressionCount = 0;
-        }
-      }
-      // 清除 SessionPlugin 中的消息
-      if (this.sessionPlugin) {
-        const manager = this.sessionPlugin._getSessionManager(sessionId);
-        if (manager) {
-          manager.clearMessages();
-        }
-      }
+    if (this.sessionPlugin) {
+      const manager = this.sessionPlugin._getSessionManager(sessionId);
+      if (manager) manager.clearMessages();
     }
 
-    // 清空 messageContainer 中的消息，保留 welcome
     const welcomeChild = this.messageContainer.children[0];
     this.messageContainer.clear();
-    if (welcomeChild) {
-      this.messageContainer.addChild(welcomeChild);
-    }
+    if (welcomeChild) this.messageContainer.addChild(welcomeChild);
 
-    // 重置 footer 统计
     if (this.footerBar) {
       this.footerBar.reset();
       const footerLines = this.footerBar.render(this.tui.width || 80);
@@ -518,72 +480,37 @@ class ChatUI {
         this._footerText.setText(footerLines[0]);
       }
     }
+    this.statusBar.tooler.hide();
+    this.statusBar.loader.hide();
     this.tui.requestRender();
   }
 
   _compressContext() {
-    // 隐藏 loader 和 tooler
-    this.statusBar.tooler.hide();
-    this.statusBar.loader.hide();
+    
 
     const { sessionId } = this;
-
-    // 调用 AgentChatHandler 的手动压缩
-    if (this.agent._chatHandler) {
-      const chatHandler = this.agent._chatHandler;
-
-      // 先确保从 SessionContext 加载历史（强制重新加载）
-      const messageStore = chatHandler._chatSession.getSessionMessageStore(sessionId);
-      messageStore.historyLoaded = false;  // 强制重新加载
-      chatHandler._chatSession.loadHistory(sessionId);
-
-      let messages = messageStore.messages;
-
-      // 如果 messageStore.messages 为空，尝试从 SessionContext 获取
-      if (!messages || messages.length === 0) {
-        if (this.agent.framework) {
-          const sessionCtx = this.agent.framework.getSessionContext(sessionId);
-          if (sessionCtx) {
-            messages = sessionCtx.getMessages();
-            // 同步到 messageStore
-            messageStore.messages = messages;
-          }
-        }
-      }
-
-      const beforeCount = messages ? messages.length : 0;
-      this.statusBar.tooler.show(`${colored('[压缩]', YELLOW)} 压缩前: ${beforeCount} 条`);
-
-      if (messages && messages.length > 0) {
-        // 使用 ContextCompressor 压缩
-        if (chatHandler._contextCompressor) {
-          chatHandler._contextCompressor.compress(sessionId, messages, messageStore).then(() => {
-            const afterCount = messages.length;
-            this.statusBar.tooler.setText(`${colored('[压缩]', YELLOW)} 压缩后: ${afterCount} 条 (保留${chatHandler._contextCompressor._keepRecentMessages}条)`);
-            // 同步回 SessionContext
-            if (this.agent.framework) {
-              const sessionCtx = this.agent.framework.getSessionContext(sessionId);
-              if (sessionCtx) {
-                sessionCtx.replaceMessages(messages);
-              }
-            }
-            setTimeout(() => {
-              this.statusBar.tooler.hide();
-              this.create_message(`${colored('[提示]', CYAN)} 上下文已压缩`,chalk.dim('● '))
-              this.tui.requestRender();
-            }, 2000);
-          }).catch(err => {
-            this.statusBar.tooler.setText(`${colored('[错误]', RED)} 压缩失败: ${err.message}`);
-          });
-        } else {
-          this.statusBar.tooler.setText(`${colored('[错误]', RED)} 无 ContextCompressor`);
-        }
-      } else {
+    this.statusBar.tooler.show(`${colored('[压缩]', YELLOW)} 压缩中...`);
+
+    this.agent.compressContext(sessionId).then(({ before, after, keepRecent }) => {
+      this.statusBar.tooler.setText(
+        `${colored('[压缩]', YELLOW)} 压缩后: ${after} 条 (保留${keepRecent}条)`
+      );
+      setTimeout(() => {
+        this.statusBar.tooler.hide();
+        this.statusBar.loader.hide();
+        this.create_message(`${colored('[提示]', CYAN)} 上下文已压缩`, chalk.dim('● '));
+        this.tui.requestRender();
+      }, 2000);
+    }).catch(err => {
+      this.statusBar.tooler.hide();
+      this.statusBar.loader.hide();
+      const msg = err.message || String(err);
+      if (msg.includes('No messages')) {
         this.statusBar.tooler.setText(`${colored('[提示]', CYAN)} 无消息可压缩`);
+      } else {
+        this.statusBar.tooler.setText(`${colored('[错误]', RED)} ${msg}`);
       }
-    } else {
-      this.statusBar.tooler.setText(`${colored('[错误]', RED)} 无 AgentChatHandler`);
-    }
+    });
   }
   /**
    * 刷新 skill 命令列表（用于热重载）
@@ -602,13 +529,16 @@ class ChatUI {
    */
   _refreshAutocomplete() {
     if (!this.editor) return;
-;
-    // 重新构建 CombinedAutocompleteProvider 并更新引用
+
+    // 重新构建 ChainedAutocompleteProvider（含 AgentMentionProvider）
     const { CombinedAutocompleteProvider } = require('@earendil-works/pi-tui');
-    this.autocompleteProvider = new CombinedAutocompleteProvider(
-      [...this.baseCommands, ...this.skillCommands],
-      process.cwd()
-    );
+    const { AgentMentionProvider } = require('./components/agent-mention-provider');
+    const { ChainedAutocompleteProvider } = require('./components/chained-autocomplete-provider');
+
+    this.autocompleteProvider = new ChainedAutocompleteProvider([
+      new AgentMentionProvider(this.agent.framework),
+      new CombinedAutocompleteProvider([...this.baseCommands, ...this.skillCommands], process.cwd()),
+    ]);
     this.editor.setAutocompleteProvider(this.autocompleteProvider);
   }
   /**

package/cli/src/ui/components/agent-mention-provider.js

@@ -0,0 +1,175 @@
+/**
+ * AgentMentionProvider — @子Agent 提及补全提供者
+ *
+ * 处理 @agent_name 语法，在输入 @ 时触发子Agent 列表补全。
+ * 实现 AutocompleteProvider 接口，与 CombinedAutocompleteProvider 协同工作。
+ */
+
+const { fuzzyFilter } = require('@earendil-works/pi-tui/dist/fuzzy.js');
+
+/**
+ * @typedef {Object} AutocompleteItem
+ * @property {string} value
+ * @property {string} label
+ * @property {string} [description]
+ */
+
+/**
+ * @typedef {Object} AutocompleteSuggestions
+ * @property {AutocompleteItem[]} items
+ * @property {string} prefix
+ */
+
+/**
+ * @typedef {Object} AutocompleteProvider
+ * @property {Function} getSuggestions
+ * @property {Function} applyCompletion
+ */
+
+/**
+ * 从文本中提取 @ 前缀（用于检测 @ 子Agent 触发）
+ * @param {string} textBeforeCursor
+ * @returns {string|null} '@prefix' 或 null
+ */
+function extractAtPrefixForAgent(textBeforeCursor) {
+    // 找最后一个有效的 @ 前缀
+    // 有效的 @：前面是行首/空白/非字母数字字符（排除邮箱）
+    // 支持多 @ 行：'@foo @bar' → 光标在末尾空格时返回 '@'
+    const lastAtIndex = textBeforeCursor.lastIndexOf('@');
+    if (lastAtIndex === -1) return null;
+
+    const prevChar = textBeforeCursor[lastAtIndex - 1];
+
+    // 邮箱内嵌 @（前一个字符是字母数字）→ 排除
+    if (prevChar && /[a-zA-Z0-9]/.test(prevChar)) return null;
+
+    const afterAt = textBeforeCursor.slice(lastAtIndex + 1);
+
+    // @ 后紧跟非空白 → 正在输入 agent 名，正常返回前缀
+    if (/\S/.test(afterAt)) {
+        return textBeforeCursor.slice(lastAtIndex);
+    }
+
+    // @ 后是空白或空 → 独立的 @，触发空前缀列表
+    // @ 必须在行首、或前面是空白/非字母数字字符
+    if (lastAtIndex === 0 || !prevChar || /\s/.test(prevChar) || /[^\sa-zA-Z0-9]/.test(prevChar)) {
+        return '@';
+    }
+
+    return null;
+}
+
+class AgentMentionProvider {
+    /**
+     * @param {Object} framework - Foliko Framework 实例
+     * @param {Object} fallbackProvider - 备用的 AutocompleteProvider（如 CombinedAutocompleteProvider）
+     */
+    constructor(framework, fallbackProvider = null) {
+        this.framework = framework;
+        this.fallbackProvider = fallbackProvider;
+    }
+
+    /**
+     * 获取所有子Agent（排除主Agent）
+     * @returns {Array<{name: string, description: string}>}
+     */
+    getSubAgents() {
+        if (!this.framework?._agents) return [];
+
+        const mainAgent = this.framework._mainAgent;
+        return this.framework._agents
+            .filter(agent => agent !== mainAgent && agent.name)
+            .map(agent => ({
+                name: agent.name.replace(/^subagent_/, '').replace(/^session_/, ''),
+                description: agent._role || agent.description || agent.name,
+            }));
+    }
+
+    /**
+     * 判断 @ 前缀是否看起来像子Agent 名称（而非文件路径）
+     * @param {string} atPrefix
+     * @returns {boolean}
+     */
+    _looksLikeAgentName(atPrefix) {
+        // 如果包含路径分隔符或点号扩展名，认为是文件路径
+        if (atPrefix.includes('/') || atPrefix.includes('\\') || atPrefix.includes('.')) {
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * 获取补全建议
+     * @returns {Promise<AutocompleteSuggestions|null>}
+     */
+    async getSuggestions(lines, cursorLine, cursorCol, options) {
+        try {
+            const currentLine = lines[cursorLine] || '';
+            const textBeforeCursor = currentLine.slice(0, cursorCol);
+            const atPrefix = extractAtPrefixForAgent(textBeforeCursor);
+
+            if (!atPrefix || typeof atPrefix !== 'string') {
+                // 没有 @ 前缀，委托给 fallback provider
+                return this.fallbackProvider?.getSuggestions?.(lines, cursorLine, cursorCol, options) ?? null;
+            }
+
+            const rawPrefix = atPrefix.startsWith('@') ? atPrefix.slice(1) : atPrefix;
+
+            // 如果看起来像文件路径（包含 / \ .），委托给 fallback
+            if (!this._looksLikeAgentName(rawPrefix)) {
+                return this.fallbackProvider?.getSuggestions?.(lines, cursorLine, cursorCol, options) ?? null;
+            }
+
+            const subAgents = this.getSubAgents();
+            if (!subAgents || subAgents.length === 0) {
+                return this.fallbackProvider?.getSuggestions?.(lines, cursorLine, cursorCol, options) ?? null;
+            }
+
+            const items = subAgents.map(agent => ({
+                value: agent.name,
+                label: agent.name,
+                description: agent.description || undefined,
+            }));
+
+            const filtered = fuzzyFilter(items, rawPrefix, (item) => item.label).map(item => ({
+                value: item.value,
+                label: item.label,
+                ...(item.description && { description: item.description }),
+            }));
+
+            if (filtered.length === 0) {
+                return null;
+            }
+
+            return {
+                items: filtered,
+                prefix: atPrefix,
+            };
+        } catch (err) {
+            // 出错时委托给 fallback
+            return this.fallbackProvider?.getSuggestions?.(lines, cursorLine, cursorCol, options) ?? null;
+        }
+    }
+
+    /**
+     * 应用补全
+     * @returns {{ lines: string[], cursorLine: number, cursorCol: number }}
+     */
+    applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+        const currentLine = lines[cursorLine] || '';
+        const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
+        const afterCursor = currentLine.slice(cursorCol);
+
+        const newLine = `${beforePrefix}@${item.value} ${afterCursor}`;
+        const newLines = [...lines];
+        newLines[cursorLine] = newLine;
+
+        return {
+            lines: newLines,
+            cursorLine,
+            cursorCol: beforePrefix.length + item.value.length + 2,
+        };
+    }
+}
+
+module.exports = { AgentMentionProvider };