botmux 2.47.0 → 2.47.1

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

@@ -0,0 +1,41 @@
+/**
+ * OpenCode hook adapter。
+ *
+ * OpenCode 通过 QuestionAsked 事件发起提问，payload 形状：
+ *   {
+ *     hook_event_name: 'QuestionAsked',
+ *     session_id: 'opencode-<id>',
+ *     question_id: '<id>',      // 同 _opencode_request_id
+ *     question_text: '问题文本（拍平版本）',
+ *     tool_input: {
+ *       questions: [
+ *         {
+ *           question: '问题文本',
+ *           header: '可选标题',
+ *           options: [{ label: '选项文本', description?: '描述' }, ...],
+ *           multiple: boolean,
+ *         }
+ *       ]
+ *     },
+ *     _opencode_request_id: '<id>',
+ *   }
+ *
+ * OpenCode 期望的 answer directive 形状（发往 /question/:id/reply）：
+ *   { type: 'answer', answers: string[][] }
+ *   其中 answers[i] = 第 i 个问题选中的 label 数组；跳过的 question 填 ['']。
+ *
+ * 若没有结构化 questions（旧版兼容路径），改用：
+ *   { type: 'answer', text: '自由文本' }
+ *
+ * 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
+ */
+import type { HookAskAdapter } from './types.js';
+declare const openCodeAdapter: HookAskAdapter;
+export default openCodeAdapter;
+//# sourceMappingURL=opencode.d.ts.map

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

@@ -0,0 +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,cAoFtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

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

@@ -0,0 +1,108 @@
+/**
+ * OpenCode hook adapter。
+ *
+ * OpenCode 通过 QuestionAsked 事件发起提问，payload 形状：
+ *   {
+ *     hook_event_name: 'QuestionAsked',
+ *     session_id: 'opencode-<id>',
+ *     question_id: '<id>',      // 同 _opencode_request_id
+ *     question_text: '问题文本（拍平版本）',
+ *     tool_input: {
+ *       questions: [
+ *         {
+ *           question: '问题文本',
+ *           header: '可选标题',
+ *           options: [{ label: '选项文本', description?: '描述' }, ...],
+ *           multiple: boolean,
+ *         }
+ *       ]
+ *     },
+ *     _opencode_request_id: '<id>',
+ *   }
+ *
+ * OpenCode 期望的 answer directive 形状（发往 /question/:id/reply）：
+ *   { type: 'answer', answers: string[][] }
+ *   其中 answers[i] = 第 i 个问题选中的 label 数组；跳过的 question 填 ['']。
+ *
+ * 若没有结构化 questions（旧版兼容路径），改用：
+ *   { type: 'answer', text: '自由文本' }
+ *
+ * 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
+ */
+const openCodeAdapter = {
+    parseQuestions(payload) {
+        if (!payload || typeof payload !== 'object')
+            return null;
+        const p = payload;
+        // 只处理 QuestionAsked 事件
+        if (p.hook_event_name !== 'QuestionAsked')
+            return null;
+        // 尝试从结构化 tool_input.questions 解析
+        const toolInput = p.tool_input;
+        const rawQuestions = toolInput?.questions;
+        if (rawQuestions && rawQuestions.length > 0) {
+            const questions = rawQuestions.map((q, _qIdx) => {
+                const qText = q.question ?? '';
+                const multiSelect = !!q.multiple;
+                const rawOpts = q.options ?? [];
+                const options = rawOpts.map((opt) => {
+                    const label = opt.label ?? '';
+                    // option 无独立 key 时，用 label 作为 key
+                    return { key: label, label };
+                });
+                return { prompt: qText, options, multiSelect };
+            });
+            return { questions, raw: payload };
+        }
+        // 旧版兼容：只有 question_text（无结构化 options）
+        const questionText = typeof p.question_text === 'string'
+            ? p.question_text
+            : 'OpenCode has a question';
+        const questions = [
+            {
+                prompt: questionText,
+                options: [],
+                multiSelect: false,
+            },
+        ];
+        return { questions, raw: payload };
+    },
+    formatAnswer(answersByQuestion, parsed) {
+        const p = parsed.raw;
+        const toolInput = p?.tool_input;
+        const hasStructured = Array.isArray(toolInput?.questions) && (toolInput.questions.length > 0);
+        if (hasStructured) {
+            // 结构化路径：answers[i] = 第 i 个 question 选中的 label 数组；跳过填 ['']
+            const answers = parsed.questions.map((q, i) => {
+                const selectedKeys = answersByQuestion[i];
+                if (!selectedKeys || selectedKeys.length === 0)
+                    return [''];
+                // OpenCode options 以 label 为 key，直接用 key（= label）
+                return selectedKeys.map((k) => {
+                    const opt = q.options.find((o) => o.key === k);
+                    return opt ? opt.label : k;
+                });
+            });
+            return JSON.stringify({ type: 'answer', answers });
+        }
+        // 旧版：拍平所有答案为 free-text
+        const flat = answersByQuestion
+            .flat()
+            .filter((s) => s.length > 0)
+            .join(', ');
+        return JSON.stringify({ type: 'answer', text: flat });
+    },
+    passthrough(_payload) {
+        // 真放行：空 stdout。插件见 stdout 为空 → 返回 undefined → OpenCode 自行处理
+        // （原生终端提问）。不输出 {type:'answer',...}，避免用空答案顶替这次提问。
+        return '';
+    },
+};
+export default openCodeAdapter;
+//# sourceMappingURL=opencode.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { HookAskAdapter } from './types.js';
+export declare function getHookAdapter(cliId: string): HookAskAdapter | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/ask-hook/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE"}

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

@@ -0,0 +1,12 @@
+import claude from './claude-code.js';
+import codex from './codex.js';
+import opencode from './opencode.js';
+const REGISTRY = {
+    'claude-code': claude,
+    codex,
+    opencode,
+};
+export function getHookAdapter(cliId) {
+    return REGISTRY[cliId];
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/ask-hook/registry.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,MAAM,QAAQ,GAAmC;IAC/C,aAAa,EAAE,MAAM;IACrB,KAAK;IACL,QAAQ;CACT,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { AskQuestion } from '../ask-types.js';
+/** adapter 解析一个 hook payload 后得到的问题列表和原始上下文。 */
+export interface ParsedAsk {
+    questions: AskQuestion[];
+    /** adapter 私有的原始上下文，formatAnswer 用来重建 directive。 */
+    raw: unknown;
+}
+/**
+ * 每家 CLI 的 hook adapter 接口。
+ *
+ * - parseQuestions：非 askUserQuestion 事件返回 null（hook 客户端据此输出"放行"directive）。
+ * - formatAnswer：把用户答案映射回该 CLI 所期望的 directive JSON 字符串。
+ * - passthrough：hook 接管失败时的"放行/无操作" directive，让 CLI 回退原生终端提问。
+ */
+export interface HookAskAdapter {
+    /** 非 askUserQuestion 事件返回 null（hook 客户端据此输出"放行"directive）。 */
+    parseQuestions(payload: unknown): ParsedAsk | null;
+    /**
+     * answersByQuestion[i] = questions[i] 选中的 key 数组。
+     * 返回写回 CLI 的 directive JSON 字符串。
+     */
+    formatAnswer(answersByQuestion: ReadonlyArray<ReadonlyArray<string>>, parsed: ParsedAsk): string;
+    /** hook 接管失败时的"放行/无操作" directive（让 CLI 回退原生终端提问）。 */
+    passthrough(payload: unknown): string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/ask-hook/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,oDAAoD;IACpD,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;IAEnD;;;OAGG;IACH,YAAY,CAAC,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAEjG,qDAAqD;IACrD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/ask-hook/types.ts"],"names":[],"mappings":""}

package/dist/core/ask-types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Public types for `botmux ask` (v0.1.8).
+ *
+ * See `/tmp/botmux-ask.md` for the full design. This module is import-safe for
+ * both the daemon side (broker, card builder, click handler) and the CLI side
+ * (`botmux ask buttons` subcommand) — no runtime cross-imports.
+ */
+/** A single selectable option on an ask card. `key` is the stable identifier
+ *  returned via stdout; `label` is the human-facing button text. When the user
+ *  writes `--options "yes,no"`, `key === label`. With `--options "yes=继续"`,
+ *  `key="yes"` and `label="继续"`. */
+export interface AskOption {
+    key: string;
+    label: string;
+}
+/** 多问多选模型中一个问题的描述。`key` 是问题的稳定标识符（可选，默认用序号），
+ *  `label` 是人类可读的标题（暂保留向后兼容），`prompt` 是问题正文，
+ *  `options` 是该问题的选项列表，`multiSelect` 表示是否允许多选。 */
+export interface AskQuestion {
+    /** 问题正文文本，展示给用户。 */
+    prompt: string;
+    /** 该问题的选项列表，调用方保证 `options.length ≥ 2` 且 `key` 唯一。 */
+    options: ReadonlyArray<AskOption>;
+    /** true = 多选（可选多个 key）；false = 单选（恰好 1 个 key）。 */
+    multiSelect: boolean;
+}
+/** Terminal result of an ask, returned to the CLI caller. Discriminated by
+ *  `kind` so the CLI can map straight to stdout shape + exit code.
+ *
+ *  v0.1.8 变更：`answered` 变体的 `selected: string` 升级为
+ *  `answers: ReadonlyArray<ReadonlyArray<string>>`，其中 `answers[i]`
+ *  对应第 i 个问题（`questions[i]`）选中的 key 数组。
+ *  向后兼容：单问单选场景用 `toLegacySelected` 取回旧的 `string`。 */
+export type AskResult = {
+    kind: 'answered';
+    /** answers[i] = questions[i] 选中的 key 数组。 */
+    answers: ReadonlyArray<ReadonlyArray<string>>;
+    by: string;
+    comment: null;
+    timedOut: false;
+} | {
+    kind: 'timedOut';
+    selected: null;
+    by: null;
+    comment: null;
+    timedOut: true;
+} | {
+    kind: 'invalidated';
+    reason: string;
+    selected: null;
+    by: null;
+    comment: null;
+    timedOut: false;
+};
+/** JSON envelope emitted by `botmux ask buttons --json`. Keeps `comment` as a
+ *  forward-compat `null` slot — v0.1.8 may flip it to `string`.
+ *
+ *  v0.1.8 新增 `answers: string[][] | null`（多问多选完整答案），
+ *  保留 `selected: string | null` 做向后兼容（等价于 `toLegacySelected`）。 */
+export interface AskJsonOutput {
+    /** 向后兼容：单问单选时等于 `answers[0][0]`，否则为 null。 */
+    selected: string | null;
+    /** v0.1.8 新增：按问题分组的完整答案，answered 时非 null。 */
+    answers: string[][] | null;
+    by: string | null;
+    comment: null;
+    timedOut: boolean;
+}
+/** Input accepted by broker.registerAsk. Caller (CLI subcommand → daemon IPC
+ *  handler) is responsible for env validation, parameter parsing, and resolving
+ *  the approver allowlist before reaching the broker.
+ *
+ *  v0.1.8 变更：`options`/`prompt` 字段替换为 `questions: ReadonlyArray<AskQuestion>`。 */
+export interface CreateAskInput {
+    larkAppId: string;
+    chatId: string;
+    /** thread-scope ask → root message_id; chat-scope ask → null. */
+    rootMessageId: string | null;
+    /** Session that issued the ask — used for audit + future replay scoping. */
+    sessionId: string;
+    /** Pre-resolved open_id allowlist. Empty set means no one can answer; the
+     *  caller (not the broker) must enforce the §6 approver fallback chain so the
+     *  broker stays IM-agnostic. */
+    approvers: ReadonlySet<string>;
+    /** 问题列表，调用方保证每问 `options.length ≥ 2` 且 key 唯一。 */
+    questions: ReadonlyArray<AskQuestion>;
+    /** Absolute deadline; computed by caller from `--timeout`. Broker won't
+     *  re-compute. */
+    timeoutMs: number;
+}
+/** Daemon-internal state for a pending ask. Not exported on the IPC boundary —
+ *  the CLI side only sees `AskResult`.
+ *
+ *  v0.1.8 变更：`options`/`prompt` 替换为 `questions`。 */
+export interface PendingAsk {
+    askId: string;
+    /** Anti-replay nonce embedded in each button's action value. Click events
+     *  whose nonce doesn't match → treated as stale (e.g. card from a previous
+     *  daemon process before restart). */
+    nonce: string;
+    larkAppId: string;
+    chatId: string;
+    rootMessageId: string | null;
+    sessionId: string;
+    approvers: ReadonlySet<string>;
+    /** 问题列表，替代旧的 `options` + `prompt`。 */
+    questions: ReadonlyArray<AskQuestion>;
+    /** 当前已勾选答案快照。仅 daemon/card 内部使用；CLI IPC 边界不暴露。 */
+    selections?: ReadonlyArray<ReadonlyArray<string>>;
+    createdAt: number;
+    deadlineAt: number;
+    /** Set after the card dispatch succeeds. Until then, the ask is "registered
+     *  but not visible" — clicks can't physically arrive yet. */
+    cardMessageId?: string;
+    /** Once true, subsequent click attempts return `already_settled`. */
+    settled: boolean;
+}
+/** Outcome of a click-resolution attempt. Card click handler maps these to
+ *  user-visible toasts. */
+export type AskClickOutcome = 
+/** First valid click — caller's Promise resolves with `kind:'answered'`. */
+'accepted'
+/** Clicker's open_id not in approvers — caller shows "你没有权限". */
+ | 'unauthorized'
+/** No such askId, nonce mismatch, or unknown option — caller shows
+ *  "此 ask 已失效（daemon 重启）". Covers the §8 stale-card case. */
+ | 'stale'
+/** Ask already settled (race winner exists or timed out). */
+ | 'already_settled'
+/** 多选累积：用户勾选/取消某项，尚未 submit——不触发 settle。 */
+ | 'toggled';
+/** 旧单选语义兼容：仅当"单问且恰好选 1 个"时返回该 key，否则 null。
+ *  `botmux ask buttons` 子命令与其测试据此保持单选行为不变。 */
+export declare function toLegacySelected(result: AskResult): string | null;
+/** Card dispatcher contract. The im/lark side registers a dispatcher via
+ *  `setCardDispatcher`; the broker is otherwise IM-agnostic. */
+export interface AskCardDispatcher {
+    send(ask: PendingAsk): Promise<{
+        messageId: string;
+    }>;
+    /** Called when an ask settles (answered / timedOut / invalidated). Card
+     *  builder uses this to PATCH the card into a terminal state. Best-effort —
+     *  the broker does not block on it. */
+    onSettle?(ask: PendingAsk, result: AskResult): void | Promise<void>;
+}
+//# sourceMappingURL=ask-types.d.ts.map

package/dist/core/ask-types.d.ts.map

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

package/dist/core/ask-types.js

@@ -0,0 +1,18 @@
+/**
+ * Public types for `botmux ask` (v0.1.8).
+ *
+ * See `/tmp/botmux-ask.md` for the full design. This module is import-safe for
+ * both the daemon side (broker, card builder, click handler) and the CLI side
+ * (`botmux ask buttons` subcommand) — no runtime cross-imports.
+ */
+/** 旧单选语义兼容：仅当"单问且恰好选 1 个"时返回该 key，否则 null。
+ *  `botmux ask buttons` 子命令与其测试据此保持单选行为不变。 */
+export function toLegacySelected(result) {
+    if (result.kind !== 'answered')
+        return null;
+    if (result.answers.length === 1 && result.answers[0].length === 1) {
+        return result.answers[0][0];
+    }
+    return null;
+}
+//# sourceMappingURL=ask-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-types.js","sourceRoot":"","sources":["../../src/core/ask-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwIH;8CAC8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -16,6 +16,26 @@ export interface SlashCommandInvocation {
     content: string;
 }
 export { validateWorkingDir };
+/**
+ * Resolve a non-numeric `/repo <arg>` into a concrete repo path + display name.
+ * `arg` is either a path (absolute or relative) or a first-level project name
+ * under one of the bot's scan dirs — letting the user skip the selection card.
+ *
+ * Resolution:
+ *   1. Build candidate absolute paths — absolute / `~` taken as-is; relative or
+ *      bare names resolved against each scan dir, then the daemon cwd (mirrors
+ *      how the card's project list is rooted).
+ *   2. Prefer a candidate matching a scanned git project (carries a branch label).
+ *   3. For a bare name, also match a scanned project by basename (covers projects
+ *      nested deeper than the scan-dir top level).
+ *   4. Fall back to any existing directory — lenient like `/cd`, whose trust model
+ *      is "owner explicitly chose a dir"; the CLI already runs with full FS access.
+ * Returns null when nothing resolves to an existing directory.
+ */
+export declare function resolveRepoSelection(repoArg: string, scanDirs: string[]): {
+    path: string;
+    displayName: string;
+} | null;
 /**
  * Parse a force-topic invocation: `/t [prompt]` or `/topic [prompt]`.
  *

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":"AAmBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAkD,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/G,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,eAAO,MAAM,eAAe,aAA6J,CAAC;AAE1L;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,aAO/B,CAAC;AAIH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKpF;AAED;;;;mCAImC;AACnC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAqB1F;AA8DD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzG,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,gCAAgC,EAAE,WAAW,EAAE,CAAC,CAAC;CACnF;AA2aD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA2oBf;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/core/command-handler.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAkD,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/G,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,eAAO,MAAM,eAAe,aAAuK,CAAC;AAEpM;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,aAO/B,CAAC;AAIH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0C9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKpF;AAED;;;;mCAImC;AACnC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAqB1F;AA8DD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzG,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,gCAAgC,EAAE,WAAW,EAAE,CAAC,CAAC;CACnF;AAoOD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAorCf;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}