agent-muster 0.1.1 → 0.1.3

package/README.md

@@ -1,124 +1,169 @@
 # Agent Muster
 
-在本地浏览器中管理多个 AI 编码 Agent、项目和对话，也可以通过钉钉机器人向 Agent 发送任务并接收回复。
+English | [简体中文](./README.zh-CN.md)
 
-## 功能
+Manage local AI coding agents, projects, and conversations in your browser. Send tasks and receive replies through DingTalk or Feishu bots.
 
-- 自动检测本机已安装的 Codex、Claude Code、Pi 和 Kimi CLI。
-- 按项目管理对话，在多个窗口中查看和继续不同任务。
-- 选择 Agent 和模型，实时查看回复、工具调用、执行状态及可用的 Token 用量。
-- 保存项目和对话记录，支持停止正在运行的任务。
-- 扫码创建钉钉应用，绑定项目和 Agent，将钉钉消息接入本地对话。
+## Features
 
-## 环境要求
+- Detect installed Codex, Claude Code, Pi, and Kimi CLI agents.
+- Organize conversations by project and work across one, two, or four conversation panes.
+- Select agents and models, and view live replies, tool calls, execution status, and available token usage.
+- Save projects and conversation history, resume conversations, and stop running tasks.
+- Connect DingTalk and Feishu applications to local agents through the dedicated IM integration page.
 
-- Node.js **22.19.0 或更高版本**。
-- 要执行任务，需要先安装并配置至少一个支持的 Agent CLI，并确保其命令在 `PATH` 中可用。
-- Agent 的登录、模型权限和费用由对应服务管理。
+## Requirements
 
-| Agent | 检测的命令 |
+- Node.js **22.19.0 or later**.
+- Install and configure at least one supported agent CLI, with its command available in `PATH`.
+- Authentication, model access, and charges are managed by each agent's provider.
+
+| Agent | Detected command |
 | --- | --- |
 | Codex | `codex` |
 | Claude Code | `claude` |
 | Pi | `pi` |
 | Kimi CLI | `kimi` |
 
-## 快速开始
+## Quick Start
 
-无需全局安装，直接启动：
+Run without a global installation:
 
 ```bash
 npx agent-muster
 ```
 
-启动后会自动打开浏览器，默认地址为：
+The browser opens automatically at the default address:
 
 ```text
 http://127.0.0.1:17321
 ```
 
-也可以全局安装：
+Or install globally:
 
 ```bash
 npm install -g agent-muster
 agent-muster
 ```
 
-保持启动终端运行，按 `Ctrl+C` 停止服务。
+Keep the terminal running. Press `Ctrl+C` to stop the service. The current web interface uses Chinese labels; their names are included below so you can find the relevant controls.
 
-## 命令
+## Commands
 
-| 命令 | 说明 |
+| Command | Description |
 | --- | --- |
-| `agent-muster` | 启动 Web 界面并打开浏览器 |
-| `agent-muster web` | 显式启动 Web 界面 |
-| `agent-muster web --no-open` | 启动服务，不自动打开浏览器 |
-| `agent-muster web --port 18000` | 指定监听端口 |
-| `agent-muster agents` | 列出 Agent 及安装状态 |
-| `agent-muster sessions` | 列出已保存的对话 |
+| `agent-muster` | Start the web interface and open the browser |
+| `agent-muster web` | Explicitly start the web interface |
+| `agent-muster web --no-open` | Start without opening the browser |
+| `agent-muster web --port 18000` | Use a custom listening port |
+| `agent-muster agents` | List agents and their installation status |
+| `agent-muster sessions` | List saved conversations |
+| `agent-muster update` | Check for updates and update the global installation |
 
-端口和浏览器选项可以组合使用：
+Combine port and browser options:
 
 ```bash
 npx agent-muster web --port 18000 --no-open
 ```
 
-服务仅监听本机地址 `127.0.0.1`，使用自定义端口时，请访问 `http://127.0.0.1:18000`。
+The service listens only on `127.0.0.1`. With the custom port above, visit `http://127.0.0.1:18000`.
+
+## Create Your First Task
+
+1. Start Agent Muster and add a local project directory using **添加项目** (Add project).
+2. Create a conversation in that project using **创建对话** (Create conversation), then select an installed agent and a model.
+3. Enter a task, such as: `Inspect this project's startup flow and explain how to run it.`
+4. Follow replies, tool calls, and execution status in the conversation pane. Send further messages to continue the task.
+
+The agent runs in the selected project directory. Model availability depends on the corresponding CLI configuration and access permissions. Continuing a conversation requires a resumable session created by the agent.
+
+## IM Integration
+
+Open **IM 集成** (IM integration) in the sidebar and choose **钉钉** (DingTalk) or **飞书** (Feishu). Each application has its own project and agent binding.
+
+| Capability | DingTalk | Feishu |
+| --- | --- | --- |
+| Application creation | Scan a QR code with DingTalk | Scan a QR code with Feishu |
+| Message listener | DingTalk Stream SDK | Feishu SDK WebSocket connection |
+| Incoming messages | Text, images, and rich text with images | Text |
+| Conversations | Direct messages and group mentions of the bot | Direct messages and group mentions of the bot |
+| Replies | Automatic agent replies and messages sent from the web interface | Automatic agent replies and messages sent from the web interface |
+| Application management | Project/agent binding, name/icon sync, and local removal | Project/agent binding, name/icon sync, connection status, and local removal |
+
+### Create and Connect an Application
+
+1. Add a project in Agent Muster and confirm the target agent is installed and configured.
+2. Open **IM 集成**, choose a platform, and click **扫码创建应用** (Create application by scanning).
+3. Scan the QR code with the selected platform's mobile app. Follow the authorization page to create and authorize the application. If the QR code expires, request a new one.
+4. Select a project and an agent for the new application. Click **一键同步** (Sync) to refresh its name and icon from the platform.
+5. Send the bot a direct message, or add it to a group and mention it with a task. For Feishu, check that the application shows **消息监听已连接** (Message listener connected).
+
+Keep Agent Muster running and connected to the selected platform. Messages are received through SDK connections established by the local service, so a public webhook address is not required.
 
-## 创建第一个任务
+### Receive Tasks and Reply
 
-1. 启动 Agent Muster，在 Web 界面添加一个本地项目目录。
-2. 在该项目下新建对话，选择已安装的 Agent 和模型。
-3. 输入任务并发送，例如：`检查这个项目的启动流程，说明如何运行。`
-4. 在对话窗口查看回复、工具调用和执行状态，继续发送消息完成任务。
+An incoming message starts a task using the bound agent in the bound project. When execution finishes, Agent Muster sends the result back to the original IM conversation.
 
-Agent 在选中的项目目录中执行任务。模型列表取决于对应 CLI 的配置与可用权限。
+Messages in the same IM conversation reuse its local agent session and are processed in order. Changing an application's project or agent binding clears its IM conversation mappings; the next incoming message starts a new local conversation.
 
-## 钉钉接入
+DingTalk image input is supported by the Codex, Claude Code, and Pi integrations. The Kimi CLI integration does not support image input. The Feishu integration currently processes text messages only.
 
-1. 先在 Agent Muster 中添加项目，确认目标 Agent 可用。
-2. 打开「钉钉接入」，点击「扫码创建应用」。
-3. 使用钉钉扫描二维码，按授权页面提示完成应用创建和授权。
-4. 为创建的应用选择项目和 Agent，可点击「一键同步」更新名称和图标。
-5. 在钉钉中向该机器人发送消息，群聊中可通过提及机器人发送任务。
+### Send Messages from the Web Interface
 
-收到消息后，Agent Muster 会在绑定项目中调用选定的 Agent，任务结束后将回复发送回钉钉。同一钉钉会话会继续使用已有的本地对话；同一会话中的任务按顺序处理。
+Open a conversation created through IM, then use the send-mode selector beside the message input:
 
-接入期间需要保持 Agent Muster 运行，并能连接钉钉服务。支持文本、图片和图文消息；当前 Kimi CLI 接入不支持图片输入。
+- **发送到钉钉** / **发送到飞书** (Send to DingTalk / Feishu): send the entered text directly to the linked IM conversation as the application, without running the agent. The sent message is recorded in the local conversation.
+- **交给 Agent** (Send to agent): continue the local agent task. This mode does not automatically send the resulting reply to IM.
 
-删除 Web 界面中的 IM 接入会停止接收该应用的消息，已有对话记录会保留，钉钉中的应用不会被删除。
+Direct sending requires an existing IM conversation mapping. The Feishu sender splits long replies into multiple text messages.
 
-## 本地数据
+### Remove an Integration
 
-项目、对话和钉钉接入配置保存在用户主目录下的 `.agent-muster` 中，重新启动后会读取已有记录。钉钉接入配置包含应用凭证。
+Click **删除** (Delete) on the application entry to remove its local integration and stop receiving its messages. Existing conversation history is retained. The application on DingTalk or Feishu is not deleted.
 
-## 常见问题
+## Local Data
 
-### Agent 显示未安装
+Projects, conversations, and IM configuration are stored in `.agent-muster` under your home directory and loaded again on startup. DingTalk and Feishu application credentials are stored in `dingtalk-apps.json` and `feishu-apps.json`, respectively. Keep these files private.
 
-在启动 Agent Muster 的终端中运行对应命令，确认 CLI 已安装且可以正常执行。安装或调整 `PATH` 后重新启动 Agent Muster。
+## FAQ
 
-### 默认端口被占用
+### An Agent Appears Uninstalled
 
-通过 `--port` 指定其他端口：
+Run its command in the terminal used to start Agent Muster. Confirm that the CLI is installed and works. Restart Agent Muster after installation or changes to `PATH`.
+
+### The Default Port Is in Use
+
+Choose another port:
 
 ```bash
 npx agent-muster web --port 18000
 ```
 
-### 钉钉机器人没有回复
+### An IM Bot Does Not Reply
+
+Confirm that Agent Muster is running, platform authorization is complete, and the application is bound to a project and an available agent. In groups, mention the bot. For Feishu, check its connection status and use a text message. Inspect the web conversation log and startup terminal for task status and errors.
+
+### A Message Cannot Be Sent from the Web Interface
+
+Send a message to the bot from IM first, then open the resulting local conversation. Confirm that the integration still exists and its project/agent binding has not changed. Select **发送到钉钉** or **发送到飞书** before sending.
 
-确认本地服务仍在运行，应用已绑定项目和可用的 Agent，并已完成钉钉授权。可以在 Web 对话记录和启动终端中查看任务状态与错误信息。
+## Updates
 
-## 更新
+On web startup, Agent Muster checks for a newer version in the background and prints an update notice in the terminal.
+
+For a global installation:
+
+```bash
+agent-muster update
+```
 
-全局安装的用户可以运行：
+This command checks the latest version and uses npm to update the global installation when an update is available. Restart the service afterward. You can also update manually:
 
 ```bash
 npm install -g agent-muster@latest
 ```
 
-使用 `npx` 时，可以明确指定最新版本：
+When using `npx`, explicitly select the latest published version:
 
 ```bash
 npx agent-muster@latest

package/README.zh-CN.md

@@ -0,0 +1,170 @@
+# Agent Muster
+
+[English](./README.md) | 简体中文
+
+在本地浏览器中管理多个 AI 编码 Agent、项目和对话，也可以通过钉钉或飞书机器人向 Agent 发送任务并接收回复。
+
+## 功能
+
+- 自动检测本机已安装的 Codex、Claude Code、Pi 和 Kimi CLI。
+- 按项目管理对话，支持单窗、双窗和四窗布局，同时查看和继续不同任务。
+- 选择 Agent 和模型，实时查看回复、工具调用、执行状态及可用的 Token 用量。
+- 保存项目和对话记录，支持继续对话和停止正在运行的任务。
+- 通过独立的 IM 集成页面，将钉钉和飞书应用接入本地 Agent。
+
+## 环境要求
+
+- Node.js **22.19.0 或更高版本**。
+- 要执行任务，需要先安装并配置至少一个支持的 Agent CLI，并确保其命令在 `PATH` 中可用。
+- Agent 的登录、模型权限和费用由对应服务管理。
+
+| Agent | 检测的命令 |
+| --- | --- |
+| Codex | `codex` |
+| Claude Code | `claude` |
+| Pi | `pi` |
+| Kimi CLI | `kimi` |
+
+## 快速开始
+
+无需全局安装，直接启动：
+
+```bash
+npx agent-muster
+```
+
+启动后会自动打开浏览器，默认地址为：
+
+```text
+http://127.0.0.1:17321
+```
+
+也可以全局安装：
+
+```bash
+npm install -g agent-muster
+agent-muster
+```
+
+保持启动终端运行，按 `Ctrl+C` 停止服务。当前 Web 界面使用中文标签。
+
+## 命令
+
+| 命令 | 说明 |
+| --- | --- |
+| `agent-muster` | 启动 Web 界面并打开浏览器 |
+| `agent-muster web` | 显式启动 Web 界面 |
+| `agent-muster web --no-open` | 启动服务，不自动打开浏览器 |
+| `agent-muster web --port 18000` | 指定监听端口 |
+| `agent-muster agents` | 列出 Agent 及安装状态 |
+| `agent-muster sessions` | 列出已保存的对话 |
+| `agent-muster update` | 检查并更新全局安装到最新版本 |
+
+端口和浏览器选项可以组合使用：
+
+```bash
+npx agent-muster web --port 18000 --no-open
+```
+
+服务仅监听本机地址 `127.0.0.1`，使用上述自定义端口时，请访问 `http://127.0.0.1:18000`。
+
+## 创建第一个任务
+
+1. 启动 Agent Muster，在 Web 界面点击「添加项目」，选择一个本地项目目录。
+2. 在该项目下点击「创建对话」，选择已安装的 Agent 和模型。
+3. 输入任务并发送，例如：`检查这个项目的启动流程，说明如何运行。`
+4. 在对话窗口查看回复、工具调用和执行状态，继续发送消息完成任务。
+
+Agent 在选中的项目目录中执行任务。模型列表取决于对应 CLI 的配置与可用权限。继续对话需要 Agent 已创建可恢复的会话。
+
+## IM 集成
+
+在侧边栏打开「IM 集成」，选择「钉钉」或「飞书」。每个应用分别绑定项目和 Agent。
+
+| 能力 | 钉钉 | 飞书 |
+| --- | --- | --- |
+| 创建应用 | 使用钉钉扫码创建 | 使用飞书扫码创建 |
+| 消息监听 | 钉钉 Stream SDK | 飞书 SDK WebSocket 长连接 |
+| 接收消息 | 文本、图片和图文消息 | 文本消息 |
+| 对话场景 | 单聊、群聊中提及机器人 | 单聊、群聊中提及机器人 |
+| 消息回复 | Agent 自动回复、Web 界面主动发送 | Agent 自动回复、Web 界面主动发送 |
+| 应用管理 | 绑定项目和 Agent、同步名称和图标、删除本地接入 | 绑定项目和 Agent、同步名称和图标、查看连接状态、删除本地接入 |
+
+### 扫码创建与绑定应用
+
+1. 先在 Agent Muster 中添加项目，确认目标 Agent 已安装并配置完成。
+2. 打开「IM 集成」，选择平台，点击「扫码创建应用」。
+3. 使用对应平台的手机应用扫描二维码，按授权页面提示完成应用创建和授权。二维码过期后可重新获取。
+4. 为创建的应用选择项目和 Agent，点击「一键同步」可更新平台上的名称和图标。
+5. 向机器人发送单聊消息，或将机器人加入群聊并提及它发送任务。使用飞书时，确认应用状态显示「消息监听已连接」。
+
+接入期间需要保持 Agent Muster 运行，并能连接对应平台。本地服务通过 SDK 建立连接接收消息，无需提供公网 Webhook 地址。
+
+### 接收任务与自动回复
+
+收到消息后，Agent Muster 会在绑定项目中调用选定的 Agent，任务结束后将结果发送回原 IM 对话。
+
+同一 IM 对话会继续使用已有的本地 Agent 会话，消息按顺序处理。修改应用绑定的项目或 Agent 会清空 IM 对话映射，下一条消息将创建新的本地对话。
+
+钉钉图片输入支持 Codex、Claude Code 和 Pi，当前 Kimi CLI 接入不支持图片输入。飞书接入目前只处理文本消息。
+
+### 在 Web 界面主动发送消息
+
+打开由 IM 创建的本地对话，在输入框旁选择发送方式：
+
+- 「发送到钉钉」或「发送到飞书」：以应用身份将输入的文本直接发送到关联的 IM 对话，不运行 Agent；发送记录保存在本地对话中。
+- 「交给 Agent」：继续本地 Agent 任务，此模式不会将执行结果自动发送到 IM。
+
+主动发送需要已有的 IM 对话映射。飞书发送较长的回复时会分成多条文本消息。
+
+### 删除接入
+
+点击应用条目中的「删除」，可移除本地接入并停止接收该应用的消息。已有对话记录会保留，钉钉或飞书平台中的应用不会被删除。
+
+## 本地数据
+
+项目、对话和 IM 接入配置保存在用户主目录下的 `.agent-muster` 中，重新启动后会读取已有记录。钉钉和飞书应用凭证分别保存在 `dingtalk-apps.json` 和 `feishu-apps.json` 中，请妥善保管这些文件。
+
+## 常见问题
+
+### Agent 显示未安装
+
+在启动 Agent Muster 的终端中运行对应命令，确认 CLI 已安装且可以正常执行。安装或调整 `PATH` 后重新启动 Agent Muster。
+
+### 默认端口被占用
+
+通过 `--port` 指定其他端口：
+
+```bash
+npx agent-muster web --port 18000
+```
+
+### IM 机器人没有回复
+
+确认本地服务仍在运行，已完成平台授权，应用已绑定项目和可用的 Agent。群聊中需要提及机器人；使用飞书时，检查连接状态并发送文本消息。可以在 Web 对话日志和启动终端中查看任务状态与错误信息。
+
+### Web 界面无法主动发送消息
+
+先从 IM 向机器人发送一条消息，再打开由此创建的本地对话。确认应用接入仍存在，项目和 Agent 绑定未被修改，并选择「发送到钉钉」或「发送到飞书」后发送。
+
+## 更新
+
+启动 Web 服务时会在后台检查新版本，并在终端显示更新提示。
+
+全局安装的用户可以运行：
+
+```bash
+agent-muster update
+```
+
+命令会检查最新版本，已有新版本时通过 npm 更新全局安装。更新完成后重新启动服务即可生效，也可以手动更新：
+
+```bash
+npm install -g agent-muster@latest
+```
+
+使用 `npx` 时，可以明确指定最新发布版本：
+
+```bash
+npx agent-muster@latest
+```

package/dist/cli.js

@@ -2,9 +2,12 @@ import { spawn } from 'node:child_process';
 import { AgentRegistry } from './agents.js';
 import { DingTalkBridge } from './dingtalk-bridge.js';
 import { DingTalkRegistry } from './dingtalk.js';
+import { FeishuRegistry } from './feishu.js';
+import { FeishuBridge } from './feishu-bridge.js';
 import { ProjectRegistry } from './projects.js';
 import { SessionManager } from './sessions.js';
 import { startServer } from './server.js';
+import { checkForUpdates, updatePackage } from './updates.js';
 function openBrowser(url) {
     const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
     const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
@@ -12,6 +15,10 @@ function openBrowser(url) {
 }
 async function main() {
     const [command = 'web', ...options] = process.argv.slice(2);
+    if (command === 'update') {
+        await updatePackage();
+        return;
+    }
     const registry = new AgentRegistry();
     await registry.scan();
     const sessions = new SessionManager();
@@ -20,6 +27,8 @@ async function main() {
     await projects.load();
     const dingtalk = new DingTalkRegistry();
     await dingtalk.load();
+    const feishu = new FeishuRegistry();
+    await feishu.load();
     if (command === 'agents') {
         console.log('Installed Agents\n');
         for (const agent of registry.list())
@@ -38,12 +47,16 @@ async function main() {
     for (const { sessionId, appId } of dingtalk.sessionBindings())
         sessions.linkDingTalkSession(sessionId, appId);
     new DingTalkBridge(dingtalk, registry, sessions);
+    for (const { sessionId, appId } of feishu.sessionBindings())
+        sessions.linkFeishuSession(sessionId, appId);
+    new FeishuBridge(feishu, registry, sessions);
     const portIndex = options.indexOf('--port');
     const port = portIndex >= 0 ? Number(options[portIndex + 1]) : 17321;
     if (!Number.isInteger(port) || port < 1 || port > 65535)
         throw new Error('Port must be 1–65535');
-    const server = await startServer(port, registry, projects, sessions, dingtalk);
+    const server = await startServer(port, registry, projects, sessions, dingtalk, feishu, options.includes('--dev'));
     dingtalk.startSubscriptions();
+    feishu.startSubscriptions();
     const url = `http://127.0.0.1:${port}`;
     console.log(`Agent Muster started\n\nWeb: ${url}\n\nDetected Agents:`);
     for (const agent of registry.list())
@@ -51,8 +64,9 @@ async function main() {
     console.log('\nPress Ctrl+C to stop');
     if (!options.includes('--no-open'))
         openBrowser(url);
-    const shutdown = () => { dingtalk.shutdown(); sessions.shutdown(); server.close(); server.closeAllConnections(); };
+    const shutdown = () => { dingtalk.shutdown(); feishu.shutdown(); sessions.shutdown(); server.close(); server.closeAllConnections(); };
     process.once('SIGINT', shutdown);
     process.once('SIGTERM', shutdown);
+    void checkForUpdates().catch(() => console.warn('无法检查更新，请稍后运行 agent-muster update 重试。'));
 }
 main().catch(error => { console.error(error.message); process.exitCode = 1; });

package/dist/feishu-bridge.js

@@ -0,0 +1,96 @@
+const terminalStatuses = new Set(['completed', 'failed', 'stopped']);
+function waitForCompletion(sessions, session) {
+    if (terminalStatuses.has(session.status) && !sessions.isRunning(session.id))
+        return Promise.resolve();
+    return new Promise(resolve => {
+        const check = () => {
+            if (!terminalStatuses.has(session.status) || sessions.isRunning(session.id))
+                return;
+            sessions.off(session.id, onEvent);
+            sessions.off(`${session.id}:idle`, check);
+            resolve();
+        };
+        const onEvent = (event) => { if (event.type === 'status')
+            check(); };
+        sessions.on(session.id, onEvent);
+        sessions.on(`${session.id}:idle`, check);
+        check();
+    });
+}
+export class FeishuBridge {
+    feishu;
+    agents;
+    sessions;
+    queues = new Map();
+    seen = new Set();
+    constructor(feishu, agents, sessions) {
+        this.feishu = feishu;
+        this.agents = agents;
+        this.sessions = sessions;
+        feishu.on('message', event => this.enqueue(event));
+    }
+    enqueue({ appId, message: event }) {
+        const { message, sender } = event;
+        if (sender.sender_type !== 'user' || message.message_type !== 'text')
+            return;
+        const key = `${appId}:${message.chat_id}`;
+        const messageKey = `${appId}:${message.message_id}`;
+        if (this.seen.has(messageKey))
+            return;
+        this.seen.add(messageKey);
+        if (this.seen.size > 1000)
+            this.seen.delete(this.seen.values().next().value);
+        const task = (this.queues.get(key) || Promise.resolve()).then(() => this.process(appId, event)).catch(async (error) => {
+            console.error(`飞书消息 ${message.message_id} 处理失败：`, error);
+            try {
+                await this.feishu.send(appId, message.chat_id, 'Agent 执行失败，请在 Agent Muster 中查看会话日志。');
+            }
+            catch (replyError) {
+                console.error('飞书错误消息发送失败：', replyError);
+            }
+        });
+        this.queues.set(key, task);
+        void task.finally(() => { if (this.queues.get(key) === task)
+            this.queues.delete(key); });
+    }
+    async process(appId, { message, sender }) {
+        const body = JSON.parse(message.content);
+        let content = body.text;
+        for (const mention of message.mentions || [])
+            content = content.replaceAll(mention.key, mention.mentioned_type === 'app' ? '' : `@${mention.name}`);
+        content = content.trim();
+        if (!content)
+            return;
+        const binding = this.feishu.getBinding(appId);
+        if (!binding?.project || !binding.agent) {
+            await this.feishu.send(appId, message.chat_id, '请先在 Agent Muster 中为此应用绑定项目和 Agent。');
+            return;
+        }
+        if (!this.agents.get(binding.agent)?.installed) {
+            await this.feishu.send(appId, message.chat_id, '绑定的 Agent 当前不可用。');
+            return;
+        }
+        const senderId = sender.sender_id?.open_id;
+        if (!senderId)
+            throw new Error('飞书消息缺少发送人标识');
+        const conversation = { type: message.chat_type === 'group' ? 'group' : 'single', senderId };
+        const prompt = message.chat_type === 'group' ? `${senderId} 在群聊中说：\n${content}` : content;
+        const previousId = this.feishu.getSession(appId, message.chat_id);
+        let session = previousId ? this.sessions.get(previousId) : undefined;
+        if (session && (this.sessions.isRunning(session.id) || !terminalStatuses.has(session.status)))
+            await waitForCompletion(this.sessions, session);
+        const lastEventId = session?.events.at(-1)?.id || 0;
+        if (session) {
+            this.sessions.linkFeishuSession(session.id, appId);
+            this.sessions.send(session.id, prompt, undefined, undefined, undefined, conversation);
+        }
+        else {
+            session = await this.sessions.create(binding.agent, binding.project, prompt, undefined, undefined, undefined, undefined, { appId, conversation });
+            await this.feishu.setSession(appId, message.chat_id, session.id);
+        }
+        await waitForCompletion(this.sessions, session);
+        const output = session.events.filter(event => event.id > lastEventId && event.type === 'output').at(-1)?.text.trim();
+        const reply = session.status === 'completed' ? output || 'Agent 已执行完成。' : 'Agent 执行失败，请在 Agent Muster 中查看会话日志。';
+        await this.feishu.send(appId, message.chat_id, reply);
+    }
+}