botmux 2.47.0 → 2.47.1

package/dist/core/ask-broker.js

@@ -0,0 +1,329 @@
+/**
+ * In-memory broker for `botmux ask` (v0.1.8).
+ *
+ * Holds the pending-ask registry, runs the deadline timers, and arbitrates
+ * click resolution. IM-agnostic: the im/lark side wires a dispatcher via
+ * `setCardDispatcher` so the broker doesn't import Lark types.
+ *
+ * §3 / §6 / §7 / §8 of /tmp/botmux-ask.md.
+ */
+import { randomUUID } from 'node:crypto';
+import { logger } from '../utils/logger.js';
+const pending = new Map();
+let dispatcher = null;
+/** Window during which a settled ask is still queryable so race-losers get a
+ *  precise `already_settled` outcome (and the card click handler can show
+ *  "已被 X 答了" instead of a generic "已失效"). After this window expires,
+ *  late clicks fall through to `stale` like any forgotten id. */
+const SETTLED_RETENTION_MS = 60_000;
+/** Wire the IM-side dispatcher. Called once during daemon bootstrap from
+ *  daemon.ts after im/lark/ask-card.ts is constructed. */
+export function setCardDispatcher(d) {
+    dispatcher = d;
+}
+/** Register a new pending ask. Returns a Promise that settles when:
+ *   - a valid click arrives (`kind:'answered'`)
+ *   - the deadline elapses (`kind:'timedOut'`)
+ *   - the broker invalidates the ask (`kind:'invalidated'`)
+ *
+ *  Side effects:
+ *   - generates askId + nonce
+ *   - starts the deadline timer
+ *   - dispatches the card; if the card send fails, the ask is immediately
+ *     invalidated and the Promise settles with `kind:'invalidated'`.
+ *
+ *  Throws synchronously only if no dispatcher has been wired — that's a
+ *  daemon-misconfiguration bug, not a runtime ask failure.
+ */
+export function registerAsk(input) {
+    if (!dispatcher) {
+        throw new Error('ask-broker: cardDispatcher not wired — daemon bootstrap bug');
+    }
+    const askId = randomUUID();
+    const nonce = randomUUID().slice(0, 8);
+    const createdAt = Date.now();
+    const deadlineAt = createdAt + input.timeoutMs;
+    return new Promise((resolve) => {
+        const timeoutHandle = setTimeout(() => {
+            settle(askId, {
+                kind: 'timedOut',
+                selected: null,
+                by: null,
+                comment: null,
+                timedOut: true,
+            });
+        }, input.timeoutMs);
+        // Don't keep the event loop alive just because an ask is pending.
+        timeoutHandle.unref?.();
+        // 为每个问题初始化空的勾选集合
+        const selections = new Map();
+        for (let i = 0; i < input.questions.length; i++) {
+            selections.set(i, new Set());
+        }
+        const ask = {
+            askId,
+            nonce,
+            larkAppId: input.larkAppId,
+            chatId: input.chatId,
+            rootMessageId: input.rootMessageId,
+            sessionId: input.sessionId,
+            approvers: input.approvers,
+            questions: input.questions,
+            createdAt,
+            deadlineAt,
+            settled: false,
+            resolve,
+            timeoutHandle,
+            selections,
+        };
+        pending.set(askId, ask);
+        // Card dispatch is async — store the messageId once it lands.
+        void dispatcher
+            .send(snapshot(ask))
+            .then(({ messageId }) => {
+            const cur = pending.get(askId);
+            if (cur && !cur.settled)
+                cur.cardMessageId = messageId;
+        })
+            .catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn?.(`ask-broker: ${askId} card dispatch failed: ${msg}`);
+            settle(askId, {
+                kind: 'invalidated',
+                reason: `card dispatch failed: ${msg}`,
+                selected: null,
+                by: null,
+                comment: null,
+                timedOut: false,
+            });
+        });
+    });
+}
+/**
+ * 勾选/取消勾选某问题的某个选项（累积模式，不 settle）。
+ *
+ * 校验同 `tryResolveAsk`：askId 存在 / nonce 匹配 / 未 settle / 已授权 /
+ * questionIndex 合法 / key 在该问题的 options 中。
+ *
+ * 对于单选问题（multiSelect:false），翻转时 Set 内只保留该 key（相当于"换选"）。
+ * 对于多选问题（multiSelect:true），翻转规则：已在 Set 中则移除，否则添加。
+ *
+ * 成功返回 `'toggled'`；非法返回对应 AskClickOutcome。
+ */
+export function toggleAsk(args) {
+    gcSettled();
+    const ask = pending.get(args.askId);
+    if (!ask)
+        return 'stale';
+    if (ask.nonce !== args.nonce)
+        return 'stale';
+    if (ask.settled)
+        return 'already_settled';
+    if (!ask.approvers.has(args.by))
+        return 'unauthorized';
+    const question = ask.questions[args.questionIndex];
+    if (!question)
+        return 'stale';
+    if (!question.options.some((o) => o.key === args.key))
+        return 'stale';
+    const sel = ask.selections.get(args.questionIndex);
+    if (question.multiSelect) {
+        // 多选：有则删、无则加
+        if (sel.has(args.key)) {
+            sel.delete(args.key);
+        }
+        else {
+            sel.add(args.key);
+        }
+    }
+    else {
+        // 单选：清空后只保留该 key（等价于"换选"，再次 toggle 同一 key 也保留）
+        sel.clear();
+        sel.add(args.key);
+    }
+    return 'toggled';
+}
+/**
+ * 提交答案并 settle。
+ *
+ * `selections` 显式传入时直接使用（按钮单选 / 一次性表单提交场景）；
+ * 否则使用 `toggleAsk` 累积的勾选状态。
+ *
+ * 对于 `multiSelect:false` 的问题，要求恰好 1 个选中，否则返回 `'stale'`。
+ * 校验通过则 settle 并返回 `'accepted'`；非法返回对应 AskClickOutcome。
+ */
+export function submitAsk(args) {
+    gcSettled();
+    const ask = pending.get(args.askId);
+    if (!ask)
+        return 'stale';
+    if (ask.nonce !== args.nonce)
+        return 'stale';
+    if (ask.settled)
+        return 'already_settled';
+    if (!ask.approvers.has(args.by))
+        return 'unauthorized';
+    // 构建最终答案数组（按问题顺序）
+    let answers;
+    if (args.selections !== undefined) {
+        // 显式传入：逐问校验单选约束 + key 合法性
+        answers = args.selections;
+        for (let i = 0; i < ask.questions.length; i++) {
+            const q = ask.questions[i];
+            const sel = answers[i] ?? [];
+            if (!q.multiSelect && sel.length !== 1)
+                return 'stale';
+            // 校验每个选中的 key 必须在该问题的 options 中
+            for (const key of sel) {
+                if (!q.options.some((o) => o.key === key))
+                    return 'stale';
+            }
+        }
+    }
+    else {
+        // 使用累积的勾选状态
+        const built = [];
+        for (let i = 0; i < ask.questions.length; i++) {
+            const q = ask.questions[i];
+            const sel = ask.selections.get(i);
+            if (!q.multiSelect && sel.size !== 1)
+                return 'stale';
+            built.push([...sel]);
+        }
+        answers = built;
+    }
+    settle(args.askId, {
+        kind: 'answered',
+        answers,
+        by: args.by,
+        comment: null,
+        timedOut: false,
+    });
+    return 'accepted';
+}
+/** Resolve attempt from a card-button click. Returns one of the §10 outcomes;
+ *  caller (card click handler) maps to user-facing toast.
+ *
+ *  v0.1.8 起退化为单问单选的便捷封装：等价于
+ *  `submitAsk({..., selections:[[selected]]})`.
+ *  使 `botmux ask buttons` 与其已有测试零回归。
+ *
+ *  All four "no-op" outcomes (`unauthorized`/`stale`/`already_settled`) leave
+ *  the broker state unchanged so the original CLI Promise keeps waiting for
+ *  the real winner or the deadline. */
+export function tryResolveAsk(args) {
+    return submitAsk({
+        askId: args.askId,
+        nonce: args.nonce,
+        by: args.by,
+        selections: [[args.selected]],
+    });
+}
+/** Invalidate every pending ask. Intended for daemon shutdown / restart paths
+ *  so CLI subprocesses unblock with `kind:'invalidated'` instead of waiting
+ *  forever on a dead daemon. Returns the number of asks actually settled
+ *  (settled-but-retained entries from the race window are skipped). */
+export function invalidateAll(reason) {
+    const ids = [...pending.entries()]
+        .filter(([, ask]) => !ask.settled)
+        .map(([id]) => id);
+    for (const id of ids) {
+        settle(id, {
+            kind: 'invalidated',
+            reason,
+            selected: null,
+            by: null,
+            comment: null,
+            timedOut: false,
+        });
+    }
+    if (ids.length > 0) {
+        logger.info?.(`ask-broker: invalidated ${ids.length} pending ask(s): ${reason}`);
+    }
+    return ids.length;
+}
+/** Internal — settle an ask exactly once and notify the dispatcher's onSettle
+ *  hook (best-effort, never blocks broker state transitions). The settled
+ *  entry stays in the map for `SETTLED_RETENTION_MS` so late race-losers get
+ *  a precise `already_settled` outcome; `gcSettled` reaps it afterward. */
+function settle(askId, result) {
+    const ask = pending.get(askId);
+    if (!ask || ask.settled)
+        return;
+    ask.settled = true;
+    ask.settledAt = Date.now();
+    clearTimeout(ask.timeoutHandle);
+    // Reap older settled entries opportunistically — keeps the map bounded
+    // without paying for a dedicated GC timer.
+    gcSettled();
+    try {
+        ask.resolve(result);
+    }
+    catch (err) {
+        logger.warn?.(`ask-broker: ${askId} resolve threw: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (dispatcher?.onSettle) {
+        try {
+            void Promise.resolve(dispatcher.onSettle(snapshot(ask), result)).catch((err) => {
+                logger.warn?.(`ask-broker: ${askId} onSettle failed: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        }
+        catch (err) {
+            logger.warn?.(`ask-broker: ${askId} onSettle threw: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+/** Strip broker-internal fields before handing a snapshot to the IM-side
+ *  dispatcher. Keeps the dispatcher contract narrow. */
+function snapshot(ask) {
+    const { resolve: _r, timeoutHandle: _t, settledAt: _sat, selections: _sel, ...rest } = ask;
+    return {
+        ...rest,
+        selections: ask.questions.map((_, i) => [...(ask.selections.get(i) ?? new Set())]),
+    };
+}
+/** Drop settled entries that have aged past the retention window. Cheap O(n)
+ *  walk — n is tiny in practice (≤ a few dozen pending+recent asks). */
+function gcSettled() {
+    const cutoff = Date.now() - SETTLED_RETENTION_MS;
+    for (const [id, ask] of pending) {
+        if (ask.settled && ask.settledAt !== undefined && ask.settledAt < cutoff) {
+            pending.delete(id);
+        }
+    }
+}
+// ---- diagnostics for tests ---------------------------------------------------
+/** Count of asks still awaiting a click / timeout — excludes settled entries
+ *  retained within the race-loser feedback window. For tests and metrics only. */
+export function _pendingCount() {
+    let n = 0;
+    for (const ask of pending.values())
+        if (!ask.settled)
+            n++;
+    return n;
+}
+/** Read a pending ask by id. Returns a snapshot; mutating it has no effect on
+ *  broker state. Used by the card handler to PATCH toggle state. */
+export function getAskSnapshot(askId) {
+    const a = pending.get(askId);
+    return a ? snapshot(a) : undefined;
+}
+/** Read a pending ask by id — for tests only. Returns a snapshot; mutating it
+ *  has no effect on broker state. */
+export function _getPending(askId) {
+    return getAskSnapshot(askId);
+}
+/** 返回当前 pending map 中所有 askId 列表（含 settled 但仍在 retention 内的条目）。
+ *  仅供测试使用。 */
+export function _allAskIds() {
+    return [...pending.keys()];
+}
+/** Reset broker state — for tests only. Does NOT resolve outstanding promises,
+ *  so tests must not call this while real CLI processes might be waiting. */
+export function _resetForTest() {
+    for (const ask of pending.values())
+        clearTimeout(ask.timeoutHandle);
+    pending.clear();
+    dispatcher = null;
+}
+//# sourceMappingURL=ask-broker.js.map

package/dist/core/ask-broker.js.map

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

package/dist/core/ask-hook/claude-code.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Claude Code hook adapter。
+ *
+ * Claude Code 通过 PreToolUse hook 发起 AskUserQuestion，
+ * payload 形状：
+ *   {
+ *     hook_event_name: 'PreToolUse',
+ *     tool_name: 'AskUserQuestion',
+ *     tool_input: {
+ *       questions: [
+ *         {
+ *           question: '问题文本',
+ *           multiSelect: boolean,
+ *           options: [{ label: '选项文本' }, ...]
+ *         }
+ *       ]
+ *     }
+ *   }
+ *
+ * Claude Code 期望的 answer directive（hookSpecificOutput）形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PreToolUse',
+ *       permissionDecision: 'allow',
+ *       updatedInput: {
+ *         questions: <原始 questions 数组>,
+ *         answers: {
+ *           '问题文本': '选项label1, 选项label2',
+ *           ...
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * passthrough（放行）directive 形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PreToolUse',
+ *       permissionDecision: 'allow',
+ *       updatedInput: { questions: [...], answers: {} }
+ *     }
+ *   }
+ *
+ * 参考来源：x-desktop-app/src/island/main/bridge/adapters/ClaudeAdapter.ts
+ *           x-desktop-app/src/island/main/bridge/BridgeServer.ts buildClaudeAnswerDirective
+ */
+import type { HookAskAdapter } from './types.js';
+declare const claudeCodeAdapter: HookAskAdapter;
+export default claudeCodeAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/core/ask-hook/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/ask-hook/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAc5D,QAAA,MAAM,iBAAiB,EAAE,cA2DxB,CAAC;AAmCF,eAAe,iBAAiB,CAAC"}

package/dist/core/ask-hook/claude-code.js

@@ -0,0 +1,145 @@
+/**
+ * Claude Code hook adapter。
+ *
+ * Claude Code 通过 PreToolUse hook 发起 AskUserQuestion，
+ * payload 形状：
+ *   {
+ *     hook_event_name: 'PreToolUse',
+ *     tool_name: 'AskUserQuestion',
+ *     tool_input: {
+ *       questions: [
+ *         {
+ *           question: '问题文本',
+ *           multiSelect: boolean,
+ *           options: [{ label: '选项文本' }, ...]
+ *         }
+ *       ]
+ *     }
+ *   }
+ *
+ * Claude Code 期望的 answer directive（hookSpecificOutput）形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PreToolUse',
+ *       permissionDecision: 'allow',
+ *       updatedInput: {
+ *         questions: <原始 questions 数组>,
+ *         answers: {
+ *           '问题文本': '选项label1, 选项label2',
+ *           ...
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * passthrough（放行）directive 形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PreToolUse',
+ *       permissionDecision: 'allow',
+ *       updatedInput: { questions: [...], answers: {} }
+ *     }
+ *   }
+ *
+ * 参考来源：x-desktop-app/src/island/main/bridge/adapters/ClaudeAdapter.ts
+ *           x-desktop-app/src/island/main/bridge/BridgeServer.ts buildClaudeAnswerDirective
+ */
+/** 从 payload 中提取原始 questions 数组（用于写回 updatedInput.questions）。 */
+function extractRawQuestions(payload) {
+    if (!payload || typeof payload !== 'object')
+        return [];
+    const p = payload;
+    const toolInput = p.tool_input;
+    if (!toolInput || typeof toolInput !== 'object')
+        return [];
+    const ti = toolInput;
+    const qs = ti.questions;
+    if (!Array.isArray(qs))
+        return [];
+    return qs;
+}
+const claudeCodeAdapter = {
+    parseQuestions(payload) {
+        if (!payload || typeof payload !== 'object')
+            return null;
+        const p = payload;
+        // 处理 PreToolUse + AskUserQuestion。PermissionRequest 保留为迁移期兼容。
+        if (p.hook_event_name !== 'PreToolUse' && p.hook_event_name !== 'PermissionRequest')
+            return null;
+        if (p.tool_name !== 'AskUserQuestion')
+            return null;
+        const rawQuestions = extractRawQuestions(payload);
+        if (rawQuestions.length === 0)
+            return null;
+        const questions = rawQuestions.map((q) => {
+            const qText = typeof q.question === 'string' ? q.question : String(q.question ?? '');
+            const multiSelect = !!q.multiSelect;
+            const rawOpts = Array.isArray(q.options) ? q.options : [];
+            const options = rawOpts.map((opt) => {
+                const label = typeof opt.label === 'string' ? opt.label : String(opt.label ?? '');
+                // option 无独立 key 时，用 label 作为 key
+                const key = typeof opt.key === 'string' && opt.key.length > 0 ? opt.key : label;
+                return { key, label };
+            });
+            return { prompt: qText, options, multiSelect };
+        });
+        return { questions, raw: payload };
+    },
+    formatAnswer(answersByQuestion, parsed) {
+        const rawPayload = parsed.raw;
+        const rawQuestions = extractRawQuestions(rawPayload);
+        const eventName = hookEventName(rawPayload);
+        // Claude updatedInput.answers: { 问题文本: 'label1, label2' }；缺席的 question 不写 key。
+        const answers = {};
+        parsed.questions.forEach((q, i) => {
+            const selectedKeys = answersByQuestion[i];
+            if (!selectedKeys || selectedKeys.length === 0)
+                return;
+            // 把 key 映射回 label（用于人类可读的 answers 值）
+            const labels = selectedKeys.map((k) => {
+                const opt = q.options.find((o) => o.key === k);
+                return opt ? opt.label : k;
+            });
+            answers[q.prompt] = labels.join(', ');
+        });
+        const directive = buildAllowDirective(eventName, rawQuestions, answers);
+        return JSON.stringify(directive);
+    },
+    passthrough(_payload) {
+        // 真放行：空 stdout（+ exit 0）。Claude Code 无 hook decision 时工具照常执行，
+        // AskUserQuestion 在终端原生提问。
+        // 绝不能输出 allow + updatedInput：那会用空 answers 顶替 tool input，把这次提问
+        // 错误地"答空"掉（非 botmux 会话 / daemon 不可达时尤其有害）。
+        return '';
+    },
+};
+function hookEventName(payload) {
+    if (payload && typeof payload === 'object') {
+        const eventName = payload.hook_event_name;
+        if (eventName === 'PermissionRequest')
+            return 'PermissionRequest';
+    }
+    return 'PreToolUse';
+}
+function buildAllowDirective(eventName, questions, answers) {
+    if (eventName === 'PermissionRequest') {
+        return {
+            hookSpecificOutput: {
+                hookEventName: 'PermissionRequest',
+                decision: {
+                    behavior: 'allow',
+                    updatedInput: { questions, answers },
+                },
+            },
+        };
+    }
+    return {
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            permissionDecision: 'allow',
+            updatedInput: { questions, answers },
+        },
+    };
+}
+export default claudeCodeAdapter;
+//# sourceMappingURL=claude-code.js.map

package/dist/core/ask-hook/claude-code.js.map

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

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

@@ -0,0 +1,43 @@
+/**
+ * Codex hook adapter。
+ *
+ * Codex 通过 PermissionRequest hook 发起权限请求，payload 形状：
+ *   {
+ *     hook_event_name: 'PermissionRequest',
+ *     tool_name: '<工具名>',
+ *     tool_input: { description?: string, command?: string, ... },
+ *     session_id: '<id>',
+ *     ...
+ *   }
+ *
+ * 与 Claude Code 不同，Codex **没有**结构化的 AskUserQuestion hook 事件——
+ * Codex 把问题藏在 Stop 事件的 last_assistant_message 文本里，
+ * 而非通过 PermissionRequest 以结构化方式发起。
+ * 因此 parseQuestions 对任意 Codex hook payload 均返回 null。
+ *
+ * Codex 期望的 permission directive（hookSpecificOutput）形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PermissionRequest',
+ *       decision: { behavior: 'allow' | 'deny', message?: string }
+ *     }
+ *   }
+ *
+ * passthrough（放行）directive 形状（behavior='allow'）：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PermissionRequest',
+ *       decision: { behavior: 'allow' }
+ *     }
+ *   }
+ *
+ * // TODO(dogfood): 验证 codex directive 形状（parseQuestions 总返回 null，
+ * //   formatAnswer 在当前版本不会被调用，但 passthrough 在 PermissionRequest 场景会被用到）
+ *
+ * 参考来源：x-desktop-app/src/island/main/bridge/adapters/CodexAdapter.ts
+ *           x-desktop-app/src/island/main/bridge/BridgeServer.ts codex 分支
+ */
+import type { HookAskAdapter } from './types.js';
+declare const codexAdapter: HookAskAdapter;
+export default codexAdapter;
+//# sourceMappingURL=codex.d.ts.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * Codex hook adapter。
+ *
+ * Codex 通过 PermissionRequest hook 发起权限请求，payload 形状：
+ *   {
+ *     hook_event_name: 'PermissionRequest',
+ *     tool_name: '<工具名>',
+ *     tool_input: { description?: string, command?: string, ... },
+ *     session_id: '<id>',
+ *     ...
+ *   }
+ *
+ * 与 Claude Code 不同，Codex **没有**结构化的 AskUserQuestion hook 事件——
+ * Codex 把问题藏在 Stop 事件的 last_assistant_message 文本里，
+ * 而非通过 PermissionRequest 以结构化方式发起。
+ * 因此 parseQuestions 对任意 Codex hook payload 均返回 null。
+ *
+ * Codex 期望的 permission directive（hookSpecificOutput）形状：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PermissionRequest',
+ *       decision: { behavior: 'allow' | 'deny', message?: string }
+ *     }
+ *   }
+ *
+ * passthrough（放行）directive 形状（behavior='allow'）：
+ *   {
+ *     hookSpecificOutput: {
+ *       hookEventName: 'PermissionRequest',
+ *       decision: { behavior: 'allow' }
+ *     }
+ *   }
+ *
+ * // TODO(dogfood): 验证 codex directive 形状（parseQuestions 总返回 null，
+ * //   formatAnswer 在当前版本不会被调用，但 passthrough 在 PermissionRequest 场景会被用到）
+ *
+ * 参考来源：x-desktop-app/src/island/main/bridge/adapters/CodexAdapter.ts
+ *           x-desktop-app/src/island/main/bridge/BridgeServer.ts codex 分支
+ */
+const codexAdapter = {
+    parseQuestions(_payload) {
+        // Codex 没有结构化 AskUserQuestion hook 事件，始终返回 null。
+        // Codex 的"提问"藏在 Stop 事件的 last_assistant_message 纯文本里，
+        // 不通过 PermissionRequest hook 以结构化方式触达 hooks-cli。
+        return null;
+    },
+    formatAnswer(answersByQuestion, parsed) {
+        // 由于 parseQuestions 总返回 null，此方法在正常流程中不会被调用。
+        // 保留实现以满足接口约定：使用 allow + 空 decision 形状。
+        // TODO(dogfood): 验证 codex directive 形状
+        void answersByQuestion;
+        void parsed;
+        const directive = {
+            hookSpecificOutput: {
+                hookEventName: 'PermissionRequest',
+                decision: { behavior: 'allow' },
+            },
+        };
+        return JSON.stringify(directive);
+    },
+    passthrough(_payload) {
+        // 真放行：空 stdout（+ exit 0），不做任何 decision，让 Codex 走默认行为。
+        // 不输出 allow——那是替用户自动批准，并非"放行不干预"。
+        // （Codex 当前未接 hook，此分支仅为将来接入时的安全默认。）
+        return '';
+    },
+};
+export default codexAdapter;
+//# sourceMappingURL=codex.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/core/ask-hook/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,MAAM,YAAY,GAAmB;IACnC,cAAc,CAAC,QAAiB;QAC9B,iDAAiD;QACjD,sDAAsD;QACtD,iDAAiD;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,iBAAuD,EAAE,MAAiB;QACrF,6CAA6C;QAC7C,wCAAwC;QACxC,uCAAuC;QACvC,KAAK,iBAAiB,CAAC;QACvB,KAAK,MAAM,CAAC;QACZ,MAAM,SAAS,GAAG;YAChB,kBAAkB,EAAE;gBAClB,aAAa,EAAE,mBAAmB;gBAClC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAChC;SACF,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,WAAW,CAAC,QAAiB;QAC3B,sDAAsD;QACtD,kCAAkC;QAClC,qCAAqC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAEF,eAAe,YAAY,CAAC"}