botmux 2.94.0 → 2.96.0

package/dist/core/ask-hook/opencode.d.ts

@@ -1,39 +1,37 @@
 /**
  * OpenCode hook adapter。
  *
- * OpenCode 通过 QuestionAsked 事件发起提问，payload 形状：
+ * OpenCode 自带原生 `question` 工具（= Claude AskUserQuestion 等价物），模型调用时服务端
+ * 发布 `question.asked` 事件并阻塞，等客户端把答案 POST 回 `/question/{id}/reply` 才解阻塞。
+ * botmux 的 OpenCode 插件（见 hook-installer.ts buildOpenCodePlugin）用 `event` 钩子拦截该
+ * 事件，把 questions 规范成下面这个 payload 喂给 `botmux hook opencode`，拿到 directive 里的
+ * `answers` 后再 POST 回 OpenCode：
  *   {
- *     hook_event_name: 'QuestionAsked',
- *     session_id: 'opencode-<id>',
- *     question_id: '<id>',      // 同 _opencode_request_id
- *     question_text: '问题文本（拍平版本）',
+ *     hook_event_name: 'question.asked',
+ *     question_id: 'que_<id>',
+ *     session_id: 'ses_<id>',
  *     tool_input: {
  *       questions: [
  *         {
  *           question: '问题文本',
  *           header: '可选标题',
  *           options: [{ label: '选项文本', description?: '描述' }, ...],
- *           multiple: boolean,
+ *           multiple?: boolean,
  *         }
  *       ]
  *     },
- *     _opencode_request_id: '<id>',
  *   }
  *
- * OpenCode 期望的 answer directive 形状（发往 /question/:id/reply）：
+ * formatAnswer 返回的 directive 形状（插件取其中的 `answers` 作为 reply body）：
  *   { type: 'answer', answers: string[][] }
  *   其中 answers[i] = 第 i 个问题选中的 label 数组；跳过的 question 填 ['']。
+ *   （自由文本作答即把该文字当作选中的 label —— OpenCode question 默认 custom:true 允许任意串。）
  *
- * 若没有结构化 questions（旧版兼容路径），改用：
- *   { type: 'answer', text: '自由文本' }
+ * passthrough（放行）= 空字符串：插件见 stdout 为空 → 不 reply，把问题留给 OpenCode
+ * 原生 picker（botmux web 终端里仍可人工作答）。绝不用空答案顶替这次提问。
  *
- * passthrough（放行）directive 形状：
- *   { type: 'answer', answers: [['']] }
- *   （每条 question 填空哨兵 ['']，让 OpenCode plugin 视为"未答"并继续）
- *
- * 参考来源：x-desktop-app/src/island/main/bridge/adapters/OpenCodeAdapter.ts
- *           x-desktop-app/src/island/main/bridge/BridgeServer.ts buildOpenCodeAnswerDirective
- *           x-desktop-app/src/island/hooks-install/opencode.ts postQuestionReply
+ * 机制已在 OpenCode 1.17.x 端到端实测确认（事件名 `question.asked`、reply 端点
+ * `POST /question/{id}/reply`、body `{ answers }`）。
  */
 import type { HookAskAdapter } from './types.js';
 declare const openCodeAdapter: HookAskAdapter;

package/dist/core/ask-hook/opencode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/core/ask-hook/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,eAAe,EAAE,cA4FtB,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/core/ask-hook/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,eAAe,EAAE,cA4FtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/core/ask-hook/opencode.js

@@ -1,47 +1,45 @@
 /**
  * OpenCode hook adapter。
  *
- * OpenCode 通过 QuestionAsked 事件发起提问，payload 形状：
+ * OpenCode 自带原生 `question` 工具（= Claude AskUserQuestion 等价物），模型调用时服务端
+ * 发布 `question.asked` 事件并阻塞，等客户端把答案 POST 回 `/question/{id}/reply` 才解阻塞。
+ * botmux 的 OpenCode 插件（见 hook-installer.ts buildOpenCodePlugin）用 `event` 钩子拦截该
+ * 事件，把 questions 规范成下面这个 payload 喂给 `botmux hook opencode`，拿到 directive 里的
+ * `answers` 后再 POST 回 OpenCode：
  *   {
- *     hook_event_name: 'QuestionAsked',
- *     session_id: 'opencode-<id>',
- *     question_id: '<id>',      // 同 _opencode_request_id
- *     question_text: '问题文本（拍平版本）',
+ *     hook_event_name: 'question.asked',
+ *     question_id: 'que_<id>',
+ *     session_id: 'ses_<id>',
  *     tool_input: {
  *       questions: [
  *         {
  *           question: '问题文本',
  *           header: '可选标题',
  *           options: [{ label: '选项文本', description?: '描述' }, ...],
- *           multiple: boolean,
+ *           multiple?: boolean,
  *         }
  *       ]
  *     },
- *     _opencode_request_id: '<id>',
  *   }
  *
- * OpenCode 期望的 answer directive 形状（发往 /question/:id/reply）：
+ * formatAnswer 返回的 directive 形状（插件取其中的 `answers` 作为 reply body）：
  *   { type: 'answer', answers: string[][] }
  *   其中 answers[i] = 第 i 个问题选中的 label 数组；跳过的 question 填 ['']。
+ *   （自由文本作答即把该文字当作选中的 label —— OpenCode question 默认 custom:true 允许任意串。）
  *
- * 若没有结构化 questions（旧版兼容路径），改用：
- *   { type: 'answer', text: '自由文本' }
+ * passthrough（放行）= 空字符串：插件见 stdout 为空 → 不 reply，把问题留给 OpenCode
+ * 原生 picker（botmux web 终端里仍可人工作答）。绝不用空答案顶替这次提问。
  *
- * passthrough（放行）directive 形状：
- *   { type: 'answer', answers: [['']] }
- *   （每条 question 填空哨兵 ['']，让 OpenCode plugin 视为"未答"并继续）
- *
- * 参考来源：x-desktop-app/src/island/main/bridge/adapters/OpenCodeAdapter.ts
- *           x-desktop-app/src/island/main/bridge/BridgeServer.ts buildOpenCodeAnswerDirective
- *           x-desktop-app/src/island/hooks-install/opencode.ts postQuestionReply
+ * 机制已在 OpenCode 1.17.x 端到端实测确认（事件名 `question.asked`、reply 端点
+ * `POST /question/{id}/reply`、body `{ answers }`）。
  */
 const openCodeAdapter = {
     parseQuestions(payload) {
         if (!payload || typeof payload !== 'object')
             return null;
         const p = payload;
-        // 只处理 QuestionAsked 事件
-        if (p.hook_event_name !== 'QuestionAsked')
+        // 只处理 question.asked 事件（OpenCode 原生 question 工具触发，由插件规范后转发）
+        if (p.hook_event_name !== 'question.asked')
             return null;
         // 尝试从结构化 tool_input.questions 解析
         const toolInput = p.tool_input;

package/dist/core/ask-hook/opencode.js.map

@@ -1 +1 @@
-{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/core/ask-hook/opencode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/core/ask-hook/opencode.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/core/command-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/core/command-handler.ts"],"names":[],"mappings":"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"}

package/dist/core/command-handler.js

@@ -2619,12 +2619,15 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                 break;
             }
             case '/help': {
-                const botCfg = ds ? getBot(ds.larkAppId).config : getAllBots()[0]?.config;
+                const helpAppId = ds?.larkAppId ?? larkAppId;
+                const botCfg = ds ? getBot(ds.larkAppId).config : (helpAppId ? getBot(helpAppId).config : getAllBots()[0]?.config);
                 const cliName = getCliDisplayName(botCfg?.cliId ?? 'claude-code');
+                const passthroughCommands = [...resolvePassthroughCommands(helpAppId)];
                 const help = [
                     t('help.heading_session', undefined, loc),
                     t('help.close', { cliName }, loc),
                     t('help.restart', { cliName }, loc),
+                    t('help.topic', undefined, loc),
                     t('help.cd', { cliName }, loc),
                     t('help.repo_list', undefined, loc),
                     t('help.repo_n', undefined, loc),
@@ -2633,11 +2636,15 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     t('help.status', undefined, loc),
                     t('help.card', undefined, loc),
                     t('help.term', undefined, loc),
+                    t('help.dashboard', undefined, loc),
+                    t('help.insight', undefined, loc),
+                    t('help.land', undefined, loc),
                     t('help.subscribe_doc', undefined, loc),
+                    t('help.summary', undefined, loc),
                     '',
                     t('help.heading_passthrough', { cliName }, loc),
-                    // 直接从集合渲染，保证文案与 PASSTHROUGH_COMMANDS 不漂移
-                    [...PASSTHROUGH_COMMANDS].join(' '),
+                    // 展示当前 bot 实际生效的透传集合：固定白名单 + adapter 默认 + 有效自定义项。
+                    passthroughCommands.join(' '),
                     '',
                     t('help.heading_schedule', undefined, loc),
                     t('help.schedule_create', undefined, loc),
@@ -2653,9 +2660,26 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     t('help.adopt_pane', undefined, loc),
                     t('help.detach', undefined, loc),
                     '',
+                    t('help.heading_collab', undefined, loc),
+                    t('help.introduce', undefined, loc),
+                    t('help.relay', undefined, loc),
+                    t('help.relay_create', undefined, loc),
+                    '',
                     t('help.heading_login', undefined, loc),
                     t('help.login', undefined, loc),
                     t('help.login_status', undefined, loc),
+                    t('help.pair', undefined, loc),
+                    '',
+                    t('help.heading_workflow', undefined, loc),
+                    t('help.workflow_run', undefined, loc),
+                    t('help.workflow_cancel', undefined, loc),
+                    '',
+                    t('help.heading_role', undefined, loc),
+                    t('help.role_show', undefined, loc),
+                    t('help.role_set', undefined, loc),
+                    t('help.role_team', undefined, loc),
+                    t('help.role_cap', undefined, loc),
+                    t('help.role_profile', undefined, loc),
                     '',
                     t('help.heading_oncall', undefined, loc),
                     t('help.oncall_bind', undefined, loc),
@@ -2669,6 +2693,8 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     t('help.heading_config', undefined, loc),
                     t('help.config_get', undefined, loc),
                     t('help.config_set', undefined, loc),
+                    t('help.skills', undefined, loc),
+                    t('help.reply_mode', undefined, loc),
                     '',
                     t('help.heading_group', undefined, loc),
                     t('help.group', undefined, loc),