@neomei/opencode-feishu 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -81,9 +81,26 @@ sessions, preflight diagnostics).
 - Image / file message input (download support added).
 - Feishu document reading and editing (full DocService added).
 
+## [0.2.6] — 2026-05-06
+
+### Added
+
+- **OpenCode interactive event support** — Bridges TUI permission/choice prompts to Feishu:
+  - `permission.asked`: Displays a 🔒 permission request card with operation scope; user replies with `确认` (once), `始终` (always), or `拒绝` (reject)
+  - `question.asked`: Displays a ❓ multiple-choice card; user replies with option numbers or labels (e.g. `1` or `1,3` for multi-select)
+  - `permission.replied` / `question.replied` / `question.rejected`: Automatically clear the interaction prompt
+- **Slash command support** — Messages starting with `/` are routed to OpenCode's `session.command` API instead of `sendPrompt`. Supports command arguments (e.g. `/compact all`)
+- `replyPermission()` and `replyQuestion()` methods on `OpenCodeClient`
+- `PendingInteraction` tracking in `SessionManager`
+- Extended `FeishuCard` with inline interaction display and dedicated permission/question cards
+
+### Resolved
+
+- Slash commands (now supported via `session.command` API).
+- Interactive permission/choice prompts from OpenCode tools (now bridged to Feishu cards).
+
 ### Known gaps (planned for subsequent releases)
 
-- Slash commands (`/new`, `/sessions`, `/model`, etc.).
 - `feishu_notify` tool (agent pushing progress mid-task).
 - Multi-agent / multi-channel abstraction.
 

package/dist/core/message-handler.d.ts

@@ -1,8 +1,7 @@
-import type { FeishuConfig, FeishuMessage } from '../core/types.js';
+import type { FeishuConfig, FeishuMessage, FeishuCardAction, CardContent } from '../core/types.js';
 import type { SessionManager } from '../core/session-manager.js';
 import type { FeishuAPI } from '../feishu/api.js';
 import type { OpenCodeClient } from '../opencode/client.js';
-import type { DocService } from '../services/doc-service.js';
 export declare class MessageHandler {
     private config;
     private sessionManager;
@@ -10,19 +9,38 @@ export declare class MessageHandler {
     private opencode;
     private dedup;
     private fileDownloader;
-    private docService?;
     private botName;
-    private thinkingTimers;
-    constructor(config: FeishuConfig, sessionManager: SessionManager, feishuApi: FeishuAPI, opencode: OpenCodeClient, docService?: DocService, botName?: string);
+    constructor(config: FeishuConfig, sessionManager: SessionManager, feishuApi: FeishuAPI, opencode: OpenCodeClient, botName?: string);
     handleMessage(message: FeishuMessage): Promise<void>;
-    private stopThinkingAnimation;
     /**
-     * Detect document creation intent from user message.
-     * Supports patterns like: "创建文档 XXX", "新建一个文档", "写个文档"
+     * Try to parse the user message as a reply to a pending interaction.
+     * Returns true if handled.
      */
-    private detectDocCreationIntent;
+    private handleInteractionReply;
+    /**
+     * Handle a card button click (card.action.trigger event).
+     * Parses the button value and routes to the appropriate OpenCode API.
+     * Returns a card callback response for Feishu (toast / updated card).
+     */
+    handleCardAction(action: FeishuCardAction): Promise<{
+        toast?: {
+            type: string;
+            content: string;
+        };
+        card?: CardContent;
+    } | undefined>;
+    private handlePermissionCardAction;
+    private handleQuestionCardAction;
+    /**
+     * Parse a slash command from text.
+     * Returns { command, args } if text starts with /, otherwise null.
+     * Examples: `/help` → { command: 'help' }, `/compact all` → { command: 'compact', args: 'all' }
+     */
+    private parseSlashCommand;
     /**
      * Unified media download handler for images, files, audio, and video.
+     * Returns a text placeholder for the message and optionally the file info
+     * for forwarding to OpenCode.
      */
     private downloadMedia;
 }

package/dist/core/message-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../../src/core/message-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAQ7D,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAqD;gBAGzE,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,cAAc,EACxB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,SAAO;IAYV,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4Q1D,OAAO,CAAC,qBAAqB;IAQ7B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;YACW,aAAa;CAsB5B"}
+{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../../src/core/message-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,OAAO,CAAS;gBAGtB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,cAAc,EACxB,OAAO,SAAO;IAWV,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAsR1D;;;OAGG;YACW,sBAAsB;IAqFpC;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,SAAS,CAAC;YA8F1H,0BAA0B;YAsE1B,wBAAwB;IAqDtC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;;OAIG;YACW,aAAa;CA6B5B"}

package/dist/core/message-handler.js

@@ -10,15 +10,12 @@ export class MessageHandler {
     opencode;
     dedup;
     fileDownloader;
-    docService;
     botName;
-    thinkingTimers = new Map();
-    constructor(config, sessionManager, feishuApi, opencode, docService, botName = '点点') {
+    constructor(config, sessionManager, feishuApi, opencode, botName = '点点') {
         this.config = config;
         this.sessionManager = sessionManager;
         this.feishuApi = feishuApi;
         this.opencode = opencode;
-        this.docService = docService;
         this.botName = botName;
         this.dedup = new MessageDeduplicator(config.dedupTtl || 600_000);
         this.fileDownloader = new FileDownloader();
@@ -85,6 +82,9 @@ export class MessageHandler {
                 await this.feishuApi.sendText(chatId, '⏳ 正在处理上一条消息，请稍候...');
                 return;
             }
+            // Clear previous turn's card reference so a new card is created for this turn.
+            // (EventHandler no longer clears this on session.idle to avoid race conditions.)
+            this.sessionManager.clearCurrentMessage(chatId);
             // Resolve sender name (with cache)
             const senderUnionId = message.sender.sender_id?.union_id || 'unknown';
             const senderName = await this.feishuApi.getUserName(senderUnionId);
@@ -98,18 +98,34 @@ export class MessageHandler {
                     case 'text':
                         text = content.text || '';
                         break;
-                    case 'image':
-                        text = await this.downloadMedia(message.message_id, content.image_key, 'image', 'image.jpg', 'image/jpeg', '图片');
+                    case 'image': {
+                        const result = await this.downloadMedia(message.message_id, content.image_key, 'image', 'image.jpg', 'image/jpeg', '图片');
+                        text = result.text;
+                        if (result.file)
+                            files.push(result.file);
                         break;
-                    case 'file':
-                        text = await this.downloadMedia(message.message_id, content.file_key, 'file', content.file_name || 'unknown', 'application/octet-stream', '文件');
+                    }
+                    case 'file': {
+                        const result = await this.downloadMedia(message.message_id, content.file_key, 'file', content.file_name || 'unknown', 'application/octet-stream', '文件');
+                        text = result.text;
+                        if (result.file)
+                            files.push(result.file);
                         break;
-                    case 'audio':
-                        text = await this.downloadMedia(message.message_id, content.file_key, 'file', 'audio.opus', 'audio/opus', '语音');
+                    }
+                    case 'audio': {
+                        const result = await this.downloadMedia(message.message_id, content.file_key, 'file', 'audio.opus', 'audio/opus', '语音');
+                        text = result.text;
+                        if (result.file)
+                            files.push(result.file);
                         break;
-                    case 'media':
-                        text = await this.downloadMedia(message.message_id, content.file_key, 'file', content.file_name || 'video.mp4', 'video/mp4', '视频');
+                    }
+                    case 'media': {
+                        const result = await this.downloadMedia(message.message_id, content.file_key, 'file', content.file_name || 'video.mp4', 'video/mp4', '视频');
+                        text = result.text;
+                        if (result.file)
+                            files.push(result.file);
                         break;
+                    }
                     case 'sticker':
                         text = `[表情消息]`;
                         break;
@@ -138,22 +154,26 @@ export class MessageHandler {
                 return;
             }
             log.info({ chatType, chatId, text: text.substring(0, 100) }, 'Message content');
-            // Check for document creation intent
-            if (this.docService) {
-                const docIntent = this.detectDocCreationIntent(text);
-                if (docIntent.intent) {
-                    log.info({ title: docIntent.title }, 'Document creation intent detected');
-                    try {
-                        const doc = await this.docService.createDocumentFromMarkdown(docIntent.title, `# ${docIntent.title}\n\n> 由 OpenCode AI 助手创建\n\n请在此处编辑文档内容...\n`);
-                        await this.feishuApi.sendText(chatId, `✅ 已为您创建文档「${doc.title}」\n🔗 ${doc.url}\n\n您可以点击链接查看和编辑文档。`);
-                        // Continue to OpenCode to let AI generate a friendly response
-                        text = `${text}\n\n[系统提示：已为用户创建飞书文档「${doc.title}」，链接：${doc.url}。请告诉用户文档已创建，并简要说明可以如何使用。]`;
-                    }
-                    catch (err) {
-                        log.error({ err, title: docIntent.title }, 'Failed to create document');
-                        await this.feishuApi.sendText(chatId, '❌ 创建文档失败，请确认已开通文档相关权限（docx:document、docx:document:readonly）');
-                    }
+            // Check for pending interaction reply before proceeding with normal message flow
+            const pendingInteraction = this.sessionManager.getPendingInteraction?.(chatId);
+            if (pendingInteraction) {
+                try {
+                    const handled = await this.handleInteractionReply(chatId, text.trim(), pendingInteraction);
+                    if (handled)
+                        return;
+                    // The user's message does not match an interaction reply pattern.
+                    // Do NOT clear the pending interaction — the user may still click the
+                    // card buttons. Instead, tell them to finish the interaction first.
+                }
+                catch {
+                    // Error handling interaction reply: clear to prevent the user from
+                    // getting permanently stuck.
+                    this.sessionManager.clearPendingInteraction(chatId);
                 }
+                await this.feishuApi.sendText(chatId, pendingInteraction.kind === 'permission'
+                    ? '⏳ 请先处理上方的权限请求（点击卡片按钮），或等待当前任务完成。'
+                    : '⏳ 请先处理上方的选择（点击卡片按钮或回复选项），或等待当前任务完成。');
+                return;
             }
             // Atomically check and set busy status to prevent race conditions
             const currentSession = this.sessionManager.getSession(chatId);
@@ -164,44 +184,43 @@ export class MessageHandler {
             this.sessionManager.updateStatus(chatId, 'busy');
             // Show thinking card immediately before sending prompt
             if (!this.config.showProcess) {
-                const dots = ['.', '..', '...', '....'];
-                let frame = 0;
-                const thinkingCard = FeishuCard.createThinkingCard(this.botName, dots[frame]);
+                const thinkingCard = FeishuCard.createThinkingCard(this.botName);
+                log.info({ chatId }, 'Sending thinking card');
                 const msg = await this.feishuApi.sendCard(chatId, thinkingCard);
+                log.info({ chatId, messageId: msg?.message_id }, 'Thinking card sent result');
                 if (msg?.message_id) {
                     this.sessionManager.setCurrentMessage(chatId, msg.message_id);
-                    // Animate the ellipsis until content arrives
-                    const timer = setInterval(async () => {
-                        const session = this.sessionManager.getSession(chatId);
-                        if (!session?.currentMessageId || !this.thinkingTimers.has(chatId)) {
-                            clearInterval(timer);
-                            return;
-                        }
-                        if (session.currentContent) {
-                            this.stopThinkingAnimation(chatId);
-                            return;
-                        }
-                        frame = (frame + 1) % dots.length;
-                        try {
-                            await this.feishuApi.updateCard(session.currentMessageId, FeishuCard.createThinkingCard(this.botName, dots[frame]));
-                        }
-                        catch { /* best-effort */ }
-                    }, 500);
-                    this.thinkingTimers.set(chatId, timer);
                 }
             }
             // Send message to OpenCode
             try {
-                log.info({ sessionId: session.id, files: files.length }, 'Sending prompt to OpenCode');
-                await this.opencode.sendPrompt(session.id, text, files.length > 0 ? files : undefined);
-                log.info('Prompt sent successfully');
+                const slashCommand = this.parseSlashCommand(text);
+                if (slashCommand) {
+                    log.info({ sessionId: session.id, command: slashCommand.command, args: slashCommand.args }, 'Sending command to OpenCode');
+                    await this.opencode.sendCommand(session.id, slashCommand.command, slashCommand.args);
+                    log.info('Command sent successfully');
+                }
+                else {
+                    log.info({ sessionId: session.id, files: files.length }, 'Sending prompt to OpenCode');
+                    // Inject chat context so the AI knows the current chat_id for Feishu operations
+                    const contextPrefix = `[系统上下文] 当前飞书对话ID: ${chatId}\n\n` +
+                        `你配置了飞书 MCP 工具，可以使用以下工具来操作飞书文档、日历等：\n` +
+                        `- docx.v1.document.create — 创建飞书文档\n` +
+                        `- docx.v1.documentBlockChildren.create — 在文档中插入内容\n` +
+                        `- docx.v1.documentBlock.patch — 更新文档块\n` +
+                        `- drive.v1.file.createFolder — 创建文件夹\n` +
+                        `- drive.v1.media.uploadPrepare/uploadFinish — 上传文件\n` +
+                        `当用户请求创建飞书文档时，请直接调用 MCP 工具创建，不要在回复中询问。\n` +
+                        `重要：飞书文档的访问链接必须使用 https://www.feishu.cn/docx/ 域名，不要使用 https://open.feishu.cn/docx/ 域名。\n\n`;
+                    await this.opencode.sendPrompt(session.id, contextPrefix + text, files.length > 0 ? files : undefined);
+                    log.info('Prompt sent successfully');
+                }
             }
             catch (err) {
                 log.error({ err }, 'Failed to send prompt');
                 await this.feishuApi.sendCard(chatId, FeishuCard.createErrorCard(`发送消息失败: ${err instanceof Error ? err.message : String(err)}`));
                 this.sessionManager.updateStatus(chatId, 'idle');
                 this.sessionManager.clearCurrentMessage(chatId);
-                this.stopThinkingAnimation(chatId);
             }
         }
         catch (err) {
@@ -214,55 +233,319 @@ export class MessageHandler {
             }
         }
     }
-    stopThinkingAnimation(chatId) {
-        const timer = this.thinkingTimers.get(chatId);
-        if (timer) {
-            clearInterval(timer);
-            this.thinkingTimers.delete(chatId);
+    /**
+     * Try to parse the user message as a reply to a pending interaction.
+     * Returns true if handled.
+     */
+    async handleInteractionReply(chatId, text, interaction) {
+        try {
+            if (interaction.kind === 'permission') {
+                const perm = interaction.data;
+                let reply;
+                if (text === '确认' || text === '同意' || text === '允许' || text === 'yes' || text === 'y') {
+                    reply = 'once';
+                }
+                else if (text === '始终' || text === '总是' || text === 'always') {
+                    reply = 'always';
+                }
+                else if (text === '拒绝' || text === '否' || text === '不同意' || text === 'no' || text === 'n') {
+                    reply = 'reject';
+                }
+                if (!reply)
+                    return false;
+                log.info({ chatId, permissionId: perm.id, reply }, 'Replying to permission');
+                await this.opencode.replyPermission(perm.id, reply);
+                this.sessionManager.clearPendingInteraction(chatId);
+                await this.feishuApi.sendCard(chatId, FeishuCard.createInteractionRepliedCard('permission', reply));
+                return true;
+            }
+            if (interaction.kind === 'question') {
+                const q = interaction.data;
+                // Parse answers: comma or space separated indices/labels
+                const selections = text.split(/[,，\s]+/).filter(s => s.length > 0);
+                if (selections.length === 0)
+                    return false;
+                const answers = [];
+                for (const [qIdx, question] of q.questions.entries()) {
+                    const answer = [];
+                    for (const sel of selections) {
+                        // Try numeric index first
+                        const idx = parseInt(sel, 10);
+                        if (!isNaN(idx) && idx >= 1 && idx <= question.options.length) {
+                            answer.push(question.options[idx - 1].label);
+                        }
+                        else {
+                            // Try matching label
+                            const match = question.options.find(o => o.label === sel || o.label.toLowerCase() === sel.toLowerCase());
+                            if (match)
+                                answer.push(match.label);
+                        }
+                    }
+                    // Deduplicate
+                    const unique = [...new Set(answer)];
+                    if (unique.length > 0) {
+                        answers.push(unique);
+                    }
+                    else if (qIdx < q.questions.length - 1) {
+                        // This question has no valid answer but there are more questions
+                        answers.push([]);
+                    }
+                }
+                if (answers.length === 0 || answers.every(a => a.length === 0)) {
+                    // Not a valid question reply, let normal processing handle it
+                    return false;
+                }
+                log.info({ chatId, requestId: q.id, answers }, 'Replying to question');
+                await this.opencode.replyQuestion(q.id, answers);
+                this.sessionManager.clearPendingInteraction(chatId);
+                const label = answers.map(a => a.join(', ')).join('; ');
+                await this.feishuApi.sendCard(chatId, FeishuCard.createInteractionRepliedCard('question', label));
+                return true;
+            }
+            return false;
+        }
+        catch (err) {
+            log.error({ err, chatId, interactionKind: interaction.kind }, 'Failed to handle interaction reply');
+            // Don't return true on error — let the message fall through so user isn't stuck
+            return false;
         }
     }
     /**
-     * Detect document creation intent from user message.
-     * Supports patterns like: "创建文档 XXX", "新建一个文档", "写个文档"
+     * Handle a card button click (card.action.trigger event).
+     * Parses the button value and routes to the appropriate OpenCode API.
+     * Returns a card callback response for Feishu (toast / updated card).
      */
-    detectDocCreationIntent(text) {
-        const patterns = [
-            /(?:创建|新建|写个?)(?:一个|个)?(?:飞书)?(?:云)?文档[，：:]?\s*["「『【]([^"」』】]+)["」』】]/i,
-            /(?:创建|新建|写个?)(?:一个|个)?(?:飞书)?(?:云)?文档[，：:]?\s*(.+?)(?:\n|$)/i,
-            /(?:创建|新建|写个?)(?:一个|个)?(.+?)(?:的|的)?(?:飞书)?(?:云)?文档/i,
-            /(?:帮我|请)?(?:创建|新建|写)(?:一个|个)?(.+)/i,
-        ];
-        for (const pattern of patterns) {
-            const match = text.match(pattern);
-            if (match && match[1]) {
-                const title = match[1].trim().replace(/^(?:一个|个|这份|这个|的)\s*/, '');
-                if (title && title.length > 0 && title.length < 100) {
-                    return { intent: true, title };
+    async handleCardAction(action) {
+        const { chatId, messageId } = action;
+        const value = action.action.value;
+        if (!value || typeof value !== 'object') {
+            log.warn({ chatId, messageId, value }, 'Card action missing value');
+            return { toast: { type: 'error', content: '无效操作' } };
+        }
+        const actionType = value.action || value._oc;
+        log.info({ chatId, messageId, actionType, value }, 'Card action received');
+        if (actionType !== 'perm' && actionType !== 'q') {
+            log.warn({ chatId, actionType, value }, 'Unknown card action type');
+            return { toast: { type: 'error', content: '不支持的操作' } };
+        }
+        // Verify there is a pending interaction for this chat
+        const pending = this.sessionManager.getPendingInteraction(chatId);
+        const session = this.sessionManager.getSession(chatId);
+        log.info({ chatId, messageId, hasPending: !!pending, pendingKind: pending?.kind, currentMessageId: session?.currentMessageId }, 'Checking pending interaction');
+        if (!pending) {
+            log.info({ chatId, messageId, currentMessageId: session?.currentMessageId }, 'No pending interaction for this chat, ignoring card action');
+            const valueId = (value.id || '').toString();
+            // If the button looks like an AI-generated permission card (not from OpenCode's permission.asked event),
+            // simulate a text reply so the AI can continue processing.
+            const isAiGeneratedPerm = actionType === 'perm' && valueId.startsWith('perm-');
+            if (isAiGeneratedPerm) {
+                const replyMap = {
+                    once: '确认',
+                    always: '始终允许',
+                    reject: '拒绝',
+                };
+                const replyText = replyMap[value.reply] || '确认';
+                const confirmMap = {
+                    once: '已授权一次',
+                    always: '已永久授权',
+                    reject: '已拒绝',
+                };
+                const confirmText = confirmMap[value.reply] || '已授权';
+                try {
+                    // Wait for card update to complete before sending prompt,
+                    // so the user sees the confirmation state immediately.
+                    await this.feishuApi.updateCard(messageId, FeishuCard.createInteractionRepliedCard('permission', value.reply));
+                    log.info({ chatId, messageId }, 'Updated AI-generated perm card to confirmed state');
+                }
+                catch (err) {
+                    log.warn({ err, chatId, messageId }, 'Failed to update AI-generated perm card');
+                }
+                // Re-bind currentMessageId to the clicked card so subsequent
+                // flushCard calls update the same card instead of creating a new one.
+                if (session) {
+                    this.sessionManager.setCurrentMessage(chatId, messageId);
+                    log.info({ chatId, messageId }, 'Re-bound currentMessageId to clicked card');
                 }
+                // Simulate user text reply to OpenCode so the AI continues
+                if (session) {
+                    try {
+                        await this.opencode.sendPrompt(session.id, replyText);
+                        log.info({ chatId, replyText }, 'Simulated permission reply sent to OpenCode');
+                    }
+                    catch (err) {
+                        log.error({ err, chatId, replyText }, 'Failed to send simulated permission reply');
+                    }
+                }
+                return { toast: { type: 'success', content: confirmText } };
+            }
+            // Real OpenCode permission IDs are `per_*`. If we see one with no pending,
+            // it's almost always a duplicate event (Feishu re-delivery or quick re-click)
+            // for a request we already handled. The card is already in confirmation state
+            // from the first click — return success silently rather than misleading
+            // "已过期" warning.
+            const isRealOpencodePerm = actionType === 'perm' && valueId.startsWith('per_');
+            if (isRealOpencodePerm) {
+                log.info({ chatId, messageId, valueId }, 'Permission already processed (likely duplicate event), returning success');
+                return { toast: { type: 'success', content: '已处理' } };
+            }
+            // Update the card to remove stale buttons so the user doesn't keep clicking
+            this.feishuApi.updateCard(messageId, FeishuCard.createExpiredCard())
+                .then(() => log.info({ chatId, messageId }, 'Updated stale card to expired state'))
+                .catch((err) => log.warn({ err, chatId, messageId }, 'Failed to update stale card to expired'));
+            return { toast: { type: 'warning', content: '该操作已过期' } };
+        }
+        // Route to the appropriate handler
+        if (actionType === 'perm') {
+            return this.handlePermissionCardAction(chatId, messageId, value, pending);
+        }
+        return this.handleQuestionCardAction(chatId, messageId, value, pending);
+    }
+    async handlePermissionCardAction(chatId, messageId, value, pending) {
+        if (pending.kind !== 'permission') {
+            return { toast: { type: 'error', content: '当前不是权限请求' } };
+        }
+        const reply = value.reply;
+        if (!reply || !['once', 'always', 'reject'].includes(reply)) {
+            return { toast: { type: 'error', content: '无效的权限响应' } };
+        }
+        const perm = pending.data;
+        log.info({ chatId, permissionId: perm.id, reply }, 'Card action: replying to permission');
+        const confirmText = reply === 'reject'
+            ? '已拒绝该权限请求。'
+            : reply === 'always'
+                ? '已永久授权该权限。'
+                : '已授权一次该权限。';
+        const confirmCard = FeishuCard.createInteractionRepliedCard('permission', reply);
+        // Update in-memory state synchronously so concurrent flushCard / re-clicks
+        // see the new state immediately. This must happen BEFORE we return so the
+        // caller doesn't process duplicate events.
+        this.sessionManager.clearPendingInteraction(chatId);
+        const session = this.sessionManager.getSession(chatId);
+        if (session) {
+            // Re-bind currentMessageId to the clicked card so subsequent flushCard
+            // calls update the same card the user sees (AI may have sent cards via
+            // MCP, causing currentMessageId to diverge from the clicked messageId).
+            if (messageId !== session.currentMessageId) {
+                this.sessionManager.setCurrentMessage(chatId, messageId);
+            }
+            // Mark that the interaction was handled via card click so flushCard
+            // won't overwrite the confirmation state with AI streaming output.
+            session.interactionReplied = true;
+        }
+        this.sessionManager.updateStatus(chatId, 'idle');
+        // Fire the network calls in the background and return the toast immediately.
+        // Feishu's UI has a strict callback timeout — awaiting both replyPermission
+        // and updateCard (~500ms total) was overrunning it and causing the client
+        // to display its own error popup despite our handler succeeding.
+        void (async () => {
+            try {
+                await this.opencode.replyPermission(perm.id, reply);
+                log.info({ chatId, permissionId: perm.id }, 'replyPermission relayed to OpenCode');
+            }
+            catch (err) {
+                log.error({ err, chatId, permissionId: perm.id }, 'replyPermission failed (background)');
+            }
+            try {
+                await this.feishuApi.updateCard(messageId, confirmCard);
+                log.info({ chatId, messageId, permissionId: perm.id }, 'Confirmation card updated');
+            }
+            catch (err) {
+                log.error({ err, chatId, messageId }, 'updateCard for confirmation failed (background)');
             }
+        })();
+        // NOTE: do NOT include the `card` field in the response. Feishu requires
+        // it wrapped as `{ type: 'raw'|'template', data: {...} }`; passing the raw
+        // CardContent directly is treated as a malformed response and the client
+        // shows its own error popup. We update the card via API in the background
+        // call above, so the response only needs a toast.
+        return { toast: { type: 'success', content: confirmText } };
+    }
+    async handleQuestionCardAction(chatId, messageId, value, pending) {
+        if (pending.kind !== 'question') {
+            return { toast: { type: 'error', content: '当前不是问题选择' } };
+        }
+        const answers = value.ans;
+        if (!answers || !Array.isArray(answers)) {
+            return { toast: { type: 'error', content: '无效的选择' } };
         }
-        // Simple keyword detection as fallback
-        if (/^(?:创建|新建|写个?)文档/.test(text.trim())) {
-            return { intent: true, title: '未命名文档' };
+        const q = pending.data;
+        log.info({ chatId, requestId: q.id, answers }, 'Card action: replying to question');
+        const label = answers.map(a => a.join(', ')).join('; ');
+        const confirmCard = FeishuCard.createInteractionRepliedCard('question', label);
+        // Update in-memory state synchronously and return immediately, doing the
+        // network calls in the background — see handlePermissionCardAction for the
+        // rationale on returning fast.
+        this.sessionManager.clearPendingInteraction(chatId);
+        const session = this.sessionManager.getSession(chatId);
+        if (session) {
+            if (messageId !== session.currentMessageId) {
+                this.sessionManager.setCurrentMessage(chatId, messageId);
+            }
+            session.interactionReplied = true;
+        }
+        this.sessionManager.updateStatus(chatId, 'idle');
+        void (async () => {
+            try {
+                await this.opencode.replyQuestion(q.id, answers);
+                log.info({ chatId, requestId: q.id }, 'replyQuestion relayed to OpenCode');
+            }
+            catch (err) {
+                log.error({ err, chatId, requestId: q.id }, 'replyQuestion failed (background)');
+            }
+            try {
+                await this.feishuApi.updateCard(messageId, confirmCard);
+                log.info({ chatId, messageId, requestId: q.id }, 'Confirmation card updated');
+            }
+            catch (err) {
+                log.error({ err, chatId, messageId }, 'updateCard for confirmation failed (background)');
+            }
+        })();
+        // See note in handlePermissionCardAction about omitting the `card` field.
+        return { toast: { type: 'success', content: `已提交选择：${label}` } };
+    }
+    /**
+     * Parse a slash command from text.
+     * Returns { command, args } if text starts with /, otherwise null.
+     * Examples: `/help` → { command: 'help' }, `/compact all` → { command: 'compact', args: 'all' }
+     */
+    parseSlashCommand(text) {
+        const trimmed = text.trim();
+        if (!trimmed.startsWith('/'))
+            return null;
+        const withoutPrefix = trimmed.slice(1);
+        const firstSpace = withoutPrefix.search(/\s/);
+        if (firstSpace === -1) {
+            return { command: withoutPrefix };
         }
-        return { intent: false, title: '' };
+        const command = withoutPrefix.slice(0, firstSpace);
+        const args = withoutPrefix.slice(firstSpace + 1).trim();
+        return { command, args: args || undefined };
     }
     /**
      * Unified media download handler for images, files, audio, and video.
+     * Returns a text placeholder for the message and optionally the file info
+     * for forwarding to OpenCode.
      */
     async downloadMedia(messageId, fileKey, resourceType, fileName, mimeType, typeLabel) {
         if (!fileKey) {
-            return `[${typeLabel}消息]`;
+            return { text: `[${typeLabel}消息]` };
         }
         try {
             log.info({ messageId, fileKey, fileName }, `Downloading ${typeLabel}...`);
             const buffer = await this.feishuApi.downloadMedia(messageId, fileKey, resourceType);
             const downloaded = await this.fileDownloader.saveBuffer(buffer, fileName, mimeType);
-            return `[${typeLabel}已上传: ${downloaded.filePath}]`;
+            return {
+                text: `[${typeLabel}已上传: ${downloaded.filePath}]`,
+                file: {
+                    filePath: downloaded.filePath,
+                    fileName: downloaded.fileName,
+                    mimeType,
+                },
+            };
         }
         catch (err) {
             log.error({ err, messageId, fileKey }, `Failed to download ${typeLabel}`);
-            return `[${typeLabel}消息（下载失败）]`;
+            return { text: `[${typeLabel}消息（下载失败）]` };
         }
     }
 }