@jingyi0605/codingns4dsh 0.2.1-beta.1 → 0.2.1-beta.3

package/data/build/dist/host/cli-adapters/command-code-driver.js

@@ -6,9 +6,11 @@ import readline from 'node:readline';
 import { firstToolText, serializeToolValue } from './tool-observation.js';
 import { usageChunk } from './rpc-driver-utils.js';
 import { commandEnvironment, resolveCommandPath, terminateChildProcess } from './process-utils.js';
-import { promptWithAttachmentPaths } from './attachment-utils.js';
+import { prepareAttachmentPaths, promptWithAttachmentPaths } from './attachment-utils.js';
+import { parseSkillFrontmatter } from './skill-filesystem.js';
 import { commandCodeBridgeArgs, commandCodeBridgeEnvironment } from '../cli-bridge/injections.js';
 import { getSubagentBridge } from '../cli-bridge/bridge-holder.js';
+import { AcpCliDriver } from './acp-cli-driver.js';
 import { CommandCodeHistory, } from './command-code-history.js';
 const WINDOWS = process.platform === 'win32';
 const COMMAND_CODE_BINARIES = WINDOWS
@@ -156,6 +158,14 @@ function readDeclaredEfforts(homeDirectory) {
 const DEFAULT_MAX_TURNS = 500;
 const DEFAULT_AUTO_CONTINUE_ATTEMPTS = 3;
 const AUTO_CONTINUE_PROMPT = '继续';
+/** Command Code ACP 自由文本兼容 loader 的 URL；只注入子进程，不改写安装包。 */
+const COMMAND_CODE_ACP_LOADER_URL = new URL('./command-code-acp-loader.js', import.meta.url).href;
+function commandCodeAcpEnvironment() {
+    // file URL 会把空格编码成 %20，避免 Windows 的 NODE_OPTIONS 按空格拆路径。
+    const loaderOption = `--loader=${COMMAND_CODE_ACP_LOADER_URL}`;
+    const existing = process.env.NODE_OPTIONS?.trim();
+    return { NODE_OPTIONS: existing === undefined || existing === '' ? loaderOption : `${existing} ${loaderOption}` };
+}
 /** CLI 在 -p 模式撞到 --max-turns 时的退出码（MAX_TURNS_REACHED）。 */
 const COMMAND_CODE_MAX_TURNS_EXIT_CODE = 8;
 /** 发送 SIGINT 后等待 CLI 自己收尾的时间；超时再强制清理进程树。 */
@@ -181,12 +191,7 @@ function commandCodePermissionArgs(permission) {
  * usage 和原生组件映射全部交给公共消息投影层。
  */
 export class CommandCodeDriver {
-    descriptor = {
-        id: 'command-code',
-        name: 'Command Code',
-        protocol: 'command',
-        capabilities: ['models', 'stream', 'resume', 'interrupt', 'tool-events', 'reasoning', 'usage', 'history'],
-    };
+    descriptor;
     /** 驱动自己维护 Provider turn 边界，Host 可以把工具边界映射为 DSH step。 */
     supportsSegmentedTurns = true;
     homeDirectory;
@@ -197,6 +202,11 @@ export class CommandCodeDriver {
     autoContinueMaxAttempts;
     autoContinuePrompt;
     history;
+    acpDriver;
+    respondPermission;
+    respondQuestion;
+    /** 按规范化 cwd 缓存 Skill 摘要；forceReload 用于响应目录变更。 */
+    skillCatalogs = new Map();
     cachedBinary = null;
     cachedEnvironment;
     processes = new Set();
@@ -211,6 +221,36 @@ export class CommandCodeDriver {
         this.autoContinuePrompt = options.autoContinuePrompt?.trim() || AUTO_CONTINUE_PROMPT;
         const readStatus = options.readStatus ?? ((workspacePath) => this.readCommandCodeStatus(workspacePath));
         this.history = new CommandCodeHistory(this.homeDirectory, { readStatus });
+        const legacyCapabilities = ['models', 'skills', 'stream', 'resume', 'interrupt', 'tool-events', 'reasoning', 'usage', 'history'];
+        const acpCapabilities = [...legacyCapabilities, 'permission', 'questions'];
+        this.descriptor = { id: 'command-code', name: 'Command Code', protocol: options.enableAcp === true ? 'acp' : 'command', capabilities: options.enableAcp === true ? acpCapabilities : legacyCapabilities };
+        if (options.enableAcp === true) {
+            this.acpDriver = new AcpCliDriver({
+                binaries: this.binaries,
+                spawnSync: this.runSpawnSync,
+                spawn: this.runSpawn,
+                args: ['acp'],
+                buildArgs: (input) => commandCodeAcpArgs(input),
+                runtimeModelSelection: false,
+                configureSession: configureCommandCodeAcpSession,
+                sessionEnvironment: commandCodeAcpEnvironment(),
+                id: 'command-code',
+                name: 'Command Code',
+                capabilities: acpCapabilities,
+                readQuestionRequest: readCommandCodeQuestionRequest,
+                probeReason: 'Command Code ACP 不公开可安全读取的会话索引',
+            });
+            this.respondPermission = (sessionId, response) => this.acpDriver.respondPermission(sessionId, response);
+            this.respondQuestion = (sessionId, response) => this.acpDriver.respondQuestion(sessionId, response);
+        }
+        else {
+            this.acpDriver = undefined;
+            // 保持旧实例的运行时能力声明：未启用 ACP 时不暴露这两个可回写接口。
+            this.respondPermission = () => { throw new Error('Command Code ACP 未启用'); };
+            this.respondQuestion = () => { throw new Error('Command Code ACP 未启用'); };
+            delete this.respondPermission;
+            delete this.respondQuestion;
+        }
     }
     /** 读取 Command Code 原生会话目录，供 Provider History 层使用。 */
     detectSessions(workspacePath) {
@@ -219,6 +259,43 @@ export class CommandCodeDriver {
     detectSessionsDetailed(workspacePath) {
         return this.history.detectSessionsDetailed(workspacePath);
     }
+    /** 读取 Command Code 与 `.agents` 兼容目录中的 Skill 摘要，不返回本地路径。 */
+    async listSkills(input) {
+        if (input.signal?.aborted)
+            throw new Error('Skill 目录读取已取消');
+        const command = this.cachedBinary ?? (await this.detect()).command;
+        if (command === null)
+            return [];
+        const cwd = resolve(input.cwd ?? process.cwd());
+        const entries = this.readSkillCatalog(cwd, input.forceReload === true);
+        return entries.map(({ path: _path, ...descriptor }) => descriptor);
+    }
+    /** 只为显式 `/skill-name` 或 `$skill-name` 下发匹配的 Skill 目录。 */
+    async resolveSkillPaths(input) {
+        const names = commandCodeSkillNames(input.prompt);
+        if (names.length === 0)
+            return [];
+        if (input.signal?.aborted)
+            throw new Error('Skill 目录读取已取消');
+        const entries = this.readSkillCatalog(resolve(input.cwd ?? process.cwd()), false);
+        const byName = new Map(entries.map((entry) => [entry.name, entry]));
+        const paths = [];
+        for (const name of names) {
+            const entry = byName.get(name);
+            if (entry?.enabled !== true || paths.includes(entry.path))
+                continue;
+            paths.push(entry.path);
+        }
+        return paths;
+    }
+    readSkillCatalog(cwd, forceReload) {
+        const cached = this.skillCatalogs.get(cwd);
+        if (!forceReload && cached !== undefined)
+            return cached;
+        const entries = scanCommandCodeSkills(cwd, this.homeDirectory);
+        this.skillCatalogs.set(cwd, entries);
+        return entries;
+    }
     startSession(workspacePath, options = {}) {
         return this.history.startSession(workspacePath, options);
     }
@@ -263,10 +340,8 @@ export class CommandCodeDriver {
             const direct = this.detectCommand(command);
             if (direct !== null)
                 return direct;
-            if (!this.lookupAfterDetectionFailure)
-                continue;
             const resolved = resolveCommandPath(command, this.runSpawnSync);
-            if (resolved === null)
+            if (resolved === null || resolved === command)
                 continue;
             const fallback = this.detectCommand(resolved);
             if (fallback !== null)
@@ -274,9 +349,7 @@ export class CommandCodeDriver {
         }
         return { installed: false, version: null, command: null };
     }
-    lookupAfterDetectionFailure = false;
     detectCommand(command) {
-        this.lookupAfterDetectionFailure = false;
         try {
             const result = this.runSpawnSync(command, ['--version'], { encoding: 'utf8', timeout: 3_000, windowsHide: true, shell: WINDOWS, env: commandEnvironment(command) });
             const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
@@ -286,11 +359,9 @@ export class CommandCodeDriver {
                 this.cachedEnvironment = commandEnvironment(command);
                 return { installed: true, version, command };
             }
-            this.lookupAfterDetectionFailure = result.status === null;
         }
         catch {
             // PATH 中不存在候选命令属于正常的未安装状态。
-            this.lookupAfterDetectionFailure = true;
         }
         return null;
     }
@@ -364,6 +435,8 @@ export class CommandCodeDriver {
         }
     }
     async probeSession(input) {
+        if (this.acpDriver !== undefined)
+            return this.acpDriver.probeSession(input);
         throwIfCommandCodeProbeAborted(input.signal);
         const providerSessionId = input.providerSessionId?.trim();
         if (!providerSessionId)
@@ -420,11 +493,30 @@ export class CommandCodeDriver {
         return lastFailure ?? { state: 'missing', reason: 'Command Code 原生会话文件不存在', ...(safeRawStoreRef ? { rawStoreRef: safeRawStoreRef } : {}) };
     }
     async *executeTurn(input) {
+        const skillPaths = await this.resolveSkillPaths(input);
+        const turnInput = skillPaths.length === 0 ? input : { ...input, skillPaths };
+        if (this.acpDriver !== undefined) {
+            yield* this.acpDriver.executeTurn(turnInput);
+            return;
+        }
         const binary = this.cachedBinary ?? (await this.detect()).command;
         if (binary === null)
             throw new Error('Command Code 未安装');
         const segmented = input.splitToolSteps === true;
-        const turn = segmented ? this.acquireTurn(input, binary) : this.startTurn(input, binary);
+        const existing = this.turns.get(input.sessionId);
+        const resuming = segmented && input.resumeSegmentedTurn === true && existing !== undefined && !existing.disposed && !existing.finished;
+        const prepared = resuming ? undefined : await prepareAttachmentPaths(input);
+        let turn;
+        try {
+            const preparedInput = prepared?.input ?? input;
+            turn = segmented ? this.acquireTurn(preparedInput, binary, skillPaths) : this.startTurn(preparedInput, binary, skillPaths);
+            if (prepared !== undefined)
+                turn.attachmentCleanup = prepared.cleanup;
+        }
+        catch (error) {
+            prepared?.cleanup();
+            throw error;
+        }
         let suspended = false;
         const onAbort = () => { this.requestGracefulStop(turn); };
         input.signal?.addEventListener('abort', onAbort, { once: true });
@@ -442,12 +534,14 @@ export class CommandCodeDriver {
         }
     }
     dispose() {
+        this.acpDriver?.dispose();
         for (const turn of [...this.turns.values()])
             this.disposeTurn(turn);
         this.turns.clear();
         for (const child of this.processes)
             terminateChildProcess(child);
         this.processes.clear();
+        this.skillCatalogs.clear();
         this.cachedBinary = null;
     }
     /** 丢弃等待下一个 DSH step 的 `-p` 运行，避免旧进程继续占用新一轮输出。 */
@@ -457,18 +551,18 @@ export class CommandCodeDriver {
             this.disposeTurn(turn);
     }
     /** 只有 Host 显式声明续段时才复用常驻进程；新的用户回合必须重新启动。 */
-    acquireTurn(input, binary) {
+    acquireTurn(input, binary, skillPaths) {
         const existing = this.turns.get(input.sessionId);
         if (existing !== undefined) {
             if (input.resumeSegmentedTurn === true && !existing.disposed && !existing.finished)
                 return existing;
             this.disposeTurn(existing);
         }
-        const turn = this.startTurn(input, binary);
+        const turn = this.startTurn(input, binary, skillPaths);
         this.turns.set(input.sessionId, turn);
         return turn;
     }
-    startTurn(input, binary) {
+    startTurn(input, binary, skillPaths) {
         const cwd = input.cwd ?? process.cwd();
         const requestedProviderSessionId = input.providerSessionId?.trim() || undefined;
         // 旧 synthetic ID 可能只对应 checkpoint；回退时必须以当前 DSH 会话 ID
@@ -497,6 +591,7 @@ export class CommandCodeDriver {
             transcriptPath,
             providerSessionId,
             rawStoreRef: canResume ? input.rawStoreRef?.trim() || undefined : transcriptPath,
+            skillPaths,
             cwd,
             queue: createEventQueue(),
             currentMessageId: undefined,
@@ -616,6 +711,8 @@ export class CommandCodeDriver {
         if (input.enableAskUserQuestion === true || input.runtimeEnv?.CMD_TOOLS_ASK_USER_QUESTION_ENABLE === 'true') {
             args.push('--tools-enable', 'ask_user_question');
         }
+        for (const path of turn.skillPaths)
+            args.push('--skill', path);
         // 子代理托管开启时加载桥接 mod：内建 agent 调用会被转投成 DSH 原生子会话。
         args.push(...commandCodeBridgeArgs(input.sessionId));
         for (const directory of new Set((input.attachments ?? []).map((attachment) => dirname(attachment.path))))
@@ -629,6 +726,10 @@ export class CommandCodeDriver {
     }
     /** 中断当前会话并清理 CLI 进程；不存在活动运行时视为幂等成功。 */
     async interrupt(sessionId) {
+        if (this.acpDriver !== undefined) {
+            await this.acpDriver.interrupt(sessionId);
+            return;
+        }
         const turn = this.turns.get(sessionId);
         if (turn === undefined)
             return;
@@ -806,6 +907,7 @@ export class CommandCodeDriver {
             this.processes.delete(child);
             terminateChildProcess(child);
         }
+        turn.attachmentCleanup?.();
         // 首轮 transcript 已经是 canonical 文件，必须保留给下一轮 --resume 及冷恢复。
     }
 }
@@ -1024,10 +1126,20 @@ function commandCodeEventChunks(event, state) {
     }
     else if (isToolResult(type)) {
         // 子代理托管命中时，mod 用 block 结束内建 agent 调用，真正的执行已经发生在
-        // DSH 原生子会话里；这里必须投影成完成态，而不是普通 hook 拦截的失败态。
-        const redirected = type.includes('blocked') && consumeBridgeRedirect(state, event);
-        const failed = !redirected && (type.includes('error') || type.includes('fail') || type.includes('denied') || type.includes('blocked'));
-        const tool = readToolChunk(event, failed ? 'failed' : 'completed');
+        // DSH 原生子会话里；这里必须投影为桥接返回的 running/completed/failed 状态，
+        // 而不是把后台创建误报为完成或把普通 hook 拦截误报为托管成功。
+        const redirected = type.includes('blocked') ? consumeBridgeRedirect(state, event) : undefined;
+        const failed = redirected === undefined && (type.includes('error') || type.includes('fail') || type.includes('denied') || type.includes('blocked'));
+        // 后台托管的 hook_blocked 只代表“已创建子会话”。如果这里投影成 completed，
+        // 父 Agent 会跳过 wait/read，子会话随后失败也就没有机会回到父会话。
+        const redirectedStatus = redirected === undefined
+            ? undefined
+            : redirected.completed === false || redirected.status === 'running'
+                ? 'running'
+                : redirected.ok && redirected.status !== 'failed' && redirected.status !== 'interrupted'
+                    ? 'completed'
+                    : 'failed';
+        const tool = readToolChunk(event, redirectedStatus ?? (failed ? 'failed' : 'completed'));
         if (tool !== null) {
             chunks.push(tool);
             // 工具完成后的正文属于下一条 assistant 消息。即使 CLI 没有发送
@@ -1051,15 +1163,15 @@ function readFinalText(event) {
 /** 该 blocked 事件是否来自桥接转投；命中后消费一次记录，避免重复投影。 */
 function consumeBridgeRedirect(state, event) {
     if (state.bridgeSessionId === '')
-        return false;
+        return undefined;
     const callId = firstToolText(event.callId, event.call_id, event.toolCallId, event.tool_call_id, event.toolUseId, event.tool_use_id, event.id);
     if (callId === undefined || callId === '')
-        return false;
+        return undefined;
     try {
-        return getSubagentBridge()?.consumeRedirect(state.bridgeSessionId, callId) !== undefined;
+        return getSubagentBridge()?.consumeRedirect(state.bridgeSessionId, callId);
     }
     catch {
-        return false;
+        return undefined;
     }
 }
 function beginMessage(state) {
@@ -1362,6 +1474,200 @@ function workspaceSlug(workspacePath) {
         .replace(/^-+|-+$/g, '')
         .toLowerCase();
 }
+/** 从用户文本提取显式 Skill mention，和 Codex 的 `/name`、`$name` 语义保持一致。 */
+function commandCodeSkillNames(prompt) {
+    const names = [];
+    const seen = new Set();
+    for (const match of prompt.matchAll(/(?:^|\s)(?:\$|\/)([A-Za-z0-9][A-Za-z0-9._-]*)(?=\s|$)/gu)) {
+        const name = match[1]?.trim();
+        if (name === undefined || name === '' || seen.has(name))
+            continue;
+        seen.add(name);
+        names.push(name);
+    }
+    return names;
+}
+/**
+ * 按 Command Code 的优先级扫描项目级、用户级和额外 Skill 根目录。
+ *
+ * 只把合法的 `SKILL.md` 摘要交给 Client；绝对路径保留在 Host，供显式 mention
+ * 通过 `--skill` 下发。重名时高优先级目录胜出，避免同一 Skill 被重复注入。
+ */
+function scanCommandCodeSkills(cwd, homeDirectory) {
+    const projectRoot = commandCodeProjectRoot(cwd);
+    const userHome = basename(homeDirectory) === '.commandcode' ? dirname(homeDirectory) : homeDirectory;
+    const disabledSkills = readCommandCodeDisabledSkills(projectRoot, homeDirectory);
+    const roots = [
+        join(projectRoot, '.commandcode', 'skills'),
+        ...commandCodeProjectAgentsSkillRoots(cwd, userHome),
+        join(homeDirectory, 'skills'),
+        join(userHome, '.agents', 'skills'),
+        ...readCommandCodeConfiguredSkillRoots(projectRoot, homeDirectory),
+    ];
+    const entries = [];
+    const seenNames = new Set();
+    const visitedDirectories = new Set();
+    for (const root of roots)
+        scanCommandCodeSkillRoot(root, entries, seenNames, visitedDirectories, disabledSkills);
+    return entries;
+}
+/** Command Code 会从当前目录向上查找项目 `.agents/skills`，最多跨十级。 */
+function commandCodeProjectAgentsSkillRoots(cwd, userHome) {
+    const roots = [];
+    let current = resolve(cwd);
+    for (let depth = 0; depth <= 10; depth += 1) {
+        if (current === resolve(userHome))
+            break;
+        roots.push(join(current, '.agents', 'skills'));
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return roots;
+}
+function commandCodeProjectRoot(cwd) {
+    let current = resolve(cwd);
+    const fallback = current;
+    while (true) {
+        if (existsSync(join(current, '.git')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return fallback;
+        current = parent;
+    }
+}
+function readCommandCodeConfiguredSkillRoots(projectRoot, homeDirectory) {
+    const settingsLayers = [
+        { path: join(projectRoot, '.commandcode', 'settings.local.json'), base: projectRoot },
+        { path: join(projectRoot, '.commandcode', 'settings.json'), base: projectRoot },
+        { path: join(homeDirectory, 'settings.json'), base: basename(homeDirectory) === '.commandcode' ? dirname(homeDirectory) : homeDirectory },
+    ];
+    const layer = settingsLayers.find(({ path }) => Array.isArray(readJson(path)?.skills));
+    if (layer === undefined)
+        return [];
+    const settings = readJson(layer.path);
+    if (!Array.isArray(settings?.skills))
+        return [];
+    const roots = [];
+    for (const value of settings.skills) {
+        if (typeof value !== 'string' || value.trim() === '')
+            continue;
+        const configured = value.trim();
+        const userHome = basename(homeDirectory) === '.commandcode' ? dirname(homeDirectory) : homeDirectory;
+        roots.push(configured.startsWith('~/')
+            ? resolve(userHome, configured.slice(2))
+            : resolve(layer.base, configured));
+    }
+    return roots;
+}
+function scanCommandCodeSkillRoot(root, entries, seenNames, visitedDirectories, disabledSkills) {
+    if (!existsSync(root))
+        return;
+    let canonicalRoot;
+    try {
+        if (!statSync(root).isDirectory())
+            return;
+        canonicalRoot = realpathSync(root);
+    }
+    catch {
+        return;
+    }
+    const walk = (directory, depth) => {
+        if (depth > 32)
+            return;
+        let canonicalDirectory;
+        try {
+            canonicalDirectory = realpathSync(directory);
+        }
+        catch {
+            return;
+        }
+        if (visitedDirectories.has(canonicalDirectory))
+            return;
+        visitedDirectories.add(canonicalDirectory);
+        const ownSkillFile = join(canonicalDirectory, 'SKILL.md');
+        try {
+            if (statSync(ownSkillFile).isFile()) {
+                const entry = parseCommandCodeSkillFile(ownSkillFile);
+                if (entry !== null && !seenNames.has(entry.name)) {
+                    seenNames.add(entry.name);
+                    entries.push(disabledSkills.has(entry.name) ? { ...entry, enabled: false } : entry);
+                }
+                return;
+            }
+        }
+        catch {
+            // 当前目录不是 Skill 目录，继续检查可能的分组子目录。
+        }
+        let children;
+        try {
+            children = readdirSync(canonicalDirectory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const child of children) {
+            if (child.name === '.git' || child.name === 'node_modules')
+                continue;
+            const childPath = join(canonicalDirectory, child.name);
+            if (child.isDirectory()) {
+                walk(childPath, depth + 1);
+            }
+        }
+    };
+    // 首次遍历也使用规范路径，确保额外目录的符号链接遵守去重规则。
+    walk(canonicalRoot, 0);
+}
+/** disabledSkills 是用户设置与项目设置的并集，保持 Command Code 的禁用语义。 */
+function readCommandCodeDisabledSkills(projectRoot, homeDirectory) {
+    const disabled = new Set();
+    const paths = [
+        join(homeDirectory, 'settings.json'),
+        join(projectRoot, '.commandcode', 'settings.json'),
+        join(projectRoot, '.commandcode', 'settings.local.json'),
+    ];
+    for (const path of paths) {
+        const settings = readJson(path);
+        if (!Array.isArray(settings?.disabledSkills))
+            continue;
+        for (const value of settings.disabledSkills) {
+            if (typeof value === 'string' && /^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(value.trim()))
+                disabled.add(value.trim());
+        }
+    }
+    return disabled;
+}
+function parseCommandCodeSkillFile(path) {
+    let source;
+    try {
+        source = readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const match = source.match(/^(?:\uFEFF)?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u);
+    if (match === null)
+        return null;
+    const fields = parseSkillFrontmatter(match[1] ?? '');
+    if (fields === null)
+        return null;
+    const name = typeof fields.name === 'string' ? fields.name.trim() : '';
+    const description = typeof fields.description === 'string' ? fields.description.trim() : '';
+    const directoryName = basename(dirname(path));
+    if (name.length > 64 || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(name)
+        || name !== directoryName
+        || description === '')
+        return null;
+    return {
+        id: name,
+        name,
+        description,
+        enabled: fields['user-invocable'] !== false,
+        path: dirname(path),
+    };
+}
 function buildMaxTurnsReachedMessage(autoContinueCount, maxTurns) {
     const autoContinueSuffix = autoContinueCount > 0
         ? `，自动续跑 ${autoContinueCount} 次后仍未完成`
@@ -1519,6 +1825,122 @@ function readJson(path) { if (!existsSync(path))
 catch {
     return null;
 } }
+/** 保留启动选择作为进程复用条件；ACP 的实际会话状态由原生协议显式设置。 */
+function commandCodeAcpArgs(input) {
+    const args = ['acp', ...commandCodePermissionArgs(input.permission)];
+    if (input.plan === true && !args.includes('--plan'))
+        args.push('--plan');
+    if (input.enableAskUserQuestion === true || input.runtimeEnv?.CMD_TOOLS_ASK_USER_QUESTION_ENABLE === 'true') {
+        args.push('--tools-enable', 'ask_user_question');
+    }
+    for (const path of input.skillPaths ?? [])
+        args.push('--skill', path);
+    if (input.modelId !== undefined && input.modelId !== 'provider-default')
+        args.push('--model', input.modelId);
+    const effort = input.effortId?.trim().toLowerCase();
+    if (effort !== undefined && VALID_EFFORTS.has(effort))
+        args.push('--effort', effort);
+    return args;
+}
+/**
+ * Command Code 1.74.3 的 acp 子命令不执行普通 CLI action 的参数初始化。
+ * 仅传 --model/--effort/--permission-mode 会被静默忽略，恢复的会话还会沿用旧模型。
+ * 必须在 prompt 前设置线程状态，且不能吞掉模型或权限设置失败。
+ */
+async function configureCommandCodeAcpSession(rpc, sessionId, input) {
+    const requestOptions = { signal: input.signal, killOnAbort: false };
+    if (input.modelId !== undefined && input.modelId !== 'provider-default') {
+        await rpc.request('session/set_model', { sessionId, modelId: input.modelId }, requestOptions);
+    }
+    await rpc.request('session/set_mode', { sessionId, modeId: commandCodeAcpMode(input) }, requestOptions);
+    const effort = input.effortId?.trim().toLowerCase();
+    if (effort !== undefined && VALID_EFFORTS.has(effort)) {
+        await rpc.request('session/set_config_option', { sessionId, configId: 'effort', value: effort }, requestOptions);
+    }
+}
+/** ACP 使用权限引擎的模式 ID，与普通 CLI 的 accept-edits/yolo 别名不同。 */
+function commandCodeAcpMode(input) {
+    const permission = input.permission;
+    if (input.plan === true || permission?.sandboxMode === 'read-only')
+        return 'plan';
+    if (permission?.approvalPolicy !== 'never')
+        return 'default';
+    if (permission.sandboxMode === 'danger-full-access')
+        return 'bypass';
+    if (permission.sandboxMode === 'workspace-write')
+        return 'auto-accept';
+    return 'default';
+}
+/** Command Code 将 ask_user_question 编译成 `session/request_permission`。 */
+function readCommandCodeQuestionRequest(message) {
+    const method = message.method?.toLowerCase();
+    if (method !== 'session/request_permission' || (typeof message.id !== 'string' && typeof message.id !== 'number'))
+        return null;
+    const params = isRecord(message.params) ? message.params : {};
+    const tool = isRecord(params.toolCall) ? params.toolCall : isRecord(params.tool_call) ? params.tool_call : {};
+    const kind = firstToolText(tool.kind, params.kind)?.toLowerCase();
+    const toolName = firstToolText(tool.name, tool.toolName, tool.tool_name);
+    if (kind !== 'other' && toolName !== 'ask_user_question')
+        return null;
+    const rawInput = isRecord(tool.rawInput) ? tool.rawInput : isRecord(tool.raw_input) ? tool.raw_input : {};
+    const questionText = firstToolText(rawInput.question, rawInput.prompt, params.question, params.prompt);
+    const rawOptions = Array.isArray(rawInput.options)
+        ? rawInput.options
+        : Array.isArray(params.questionOptions)
+            ? params.questionOptions
+            : [];
+    if (questionText === undefined || rawOptions.length === 0)
+        return null;
+    const options = rawOptions.flatMap((rawOption) => {
+        if (typeof rawOption === 'string' && rawOption.trim() !== '')
+            return [{ label: rawOption.trim() }];
+        if (!isRecord(rawOption))
+            return [];
+        const label = firstToolText(rawOption.label, rawOption.name, rawOption.title, rawOption.value);
+        if (label === undefined)
+            return [];
+        const description = firstToolText(rawOption.description, rawOption.detail);
+        return [{ label, ...(description === undefined ? {} : { description }) }];
+    });
+    if (options.length === 0)
+        return null;
+    const protocolOptions = Array.isArray(params.options) ? params.options : [];
+    const optionIds = options.map((_, index) => {
+        const protocolOption = isRecord(protocolOptions[index]) ? protocolOptions[index] : {};
+        return firstToolText(protocolOption.optionId, protocolOption.option_id, protocolOption.id) ?? `option_${index}`;
+    });
+    const requestId = String(message.id);
+    const questionId = `command-code-question-${requestId}`;
+    const header = firstToolText(rawInput.header, params.header);
+    return {
+        requestId,
+        rpcId: message.id,
+        questions: [{
+                id: questionId,
+                question: questionText,
+                ...(header === undefined ? {} : { header }),
+                options,
+            }],
+        respond: (response) => {
+            const answer = response.answers.find((item) => item.id === questionId) ?? response.answers[0];
+            const custom = answer?.custom?.trim() ?? '';
+            const selected = answer?.selected[0]?.trim() ?? '';
+            const selectedIndex = options.findIndex((option) => option.label === selected);
+            if (custom !== '') {
+                // `optionId` 使用保留值，未加载兼容桥时会安全地取消，不会误选第一项。
+                // loader 会从 _meta 读取原文，并把它作为 ask_user_question 的工具答案。
+                return {
+                    outcome: { outcome: 'selected', optionId: '__codingns_custom__' },
+                    answers: [{ questionIndex: 0, selectedOptions: [custom] }],
+                    _meta: { 'codingns/questionAnswer': custom },
+                };
+            }
+            if (selected === '' || selectedIndex < 0)
+                return { outcome: { outcome: 'cancelled' } };
+            return { outcome: { outcome: 'selected', optionId: optionIds[selectedIndex] } };
+        },
+    };
+}
 function isRecord(value) { return typeof value === 'object' && value !== null && !Array.isArray(value); }
 function emptyCatalog() { return { groups: [], currentModel: null, currentEffort: null }; }
 //# sourceMappingURL=command-code-driver.js.map