lark-remote 0.1.7 → 0.1.9

package/dist/runner/dsh/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * DSH wire type shapes (DeepSeek Harness HTTP proxy contract).
+ *
+ * Source of truth: packages/host/apiproxy/src/api/{rpc,sessions,events}.ts and
+ * packages/core/session/src/types.ts in the deepseek-harness repo. Only the
+ * fields DshClient/DshRunner/DshSessionReader consume are declared here.
+ *
+ * Unary: POST /api/<method>, body `{type:'client-request',rpcId,method,payload}`,
+ * response `{type:'server-response',rpcId,result:{ok:true,value}|{ok:false,error}}`.
+ * Stream: SSE GET /api/events.mux, frames `data: {type:'server-request',rpcId,
+ * method:<frame.type>, payload:<MuxFrame>}\n\n`.
+ */
+/** One SessionEvent entry (core SessionEvent<T> — seq/time/data discriminated on type). */
+export interface DshSessionEvent {
+    type: string;
+    seq: number;
+    time: number;
+    data: Record<string, unknown>;
+}
+/** assistant/chunk chunk payload (StreamChunk). */
+export interface DshChunk {
+    type: string;
+    index?: number;
+    text?: string;
+}
+/** TokenUsage from assistant/message.usage (dsh-llm TokenUsage). */
+export interface DshTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    reasoningTokens?: number;
+}
+/** SessionSummary row from session.list items[]. */
+export interface DshSessionSummary {
+    sessionId: string;
+    updatedAt: number;
+    running: boolean;
+    blank: boolean;
+    cwd?: string;
+    /** 创建时固定的 preset（/resume preset 一致性校验用）。 */
+    agentPreset?: string;
+}
+/** session.list → value. */
+export interface DshSessionListValue {
+    items: DshSessionSummary[];
+}
+/** session.history → value.events[].event. */
+export interface DshHistoryEntry {
+    event: DshSessionEvent;
+    view?: unknown;
+}
+/** session.history → value. */
+export interface DshSessionHistoryValue {
+    events: DshHistoryEntry[];
+    hasMore: boolean;
+}
+/** One model entry inside a provider group (llm.models / session.models groups[].models[]). */
+export interface DshCatalogModel {
+    id: string;
+    name: string;
+    description?: string;
+    reasoning?: {
+        efforts: Array<{
+            id: string;
+            name: string;
+        }>;
+        defaultEffort?: string;
+    };
+}
+/** One provider group of the model catalog (llm.models groups[]). */
+export interface DshModelGroup {
+    id: string;
+    name: string;
+    models: DshCatalogModel[];
+}
+/** llm.models → value. */
+export interface DshModelCatalogValue {
+    groups: DshModelGroup[];
+    failures?: Array<{
+        id: string;
+        name: string;
+        message: string;
+    }>;
+}
+/** Current model selection (session.models current / session.selectModel selected). */
+export interface DshModelSelection {
+    provider: string;
+    model: string;
+    reasoningEffort?: string;
+}
+/** session.models → value. */
+export interface DshSessionModelsValue {
+    current: DshModelSelection;
+    routable: boolean;
+    groups: DshModelGroup[];
+    failures?: Array<{
+        id: string;
+        name: string;
+        message: string;
+    }>;
+}
+/** One preset row of agentPreset.list. */
+export interface DshPresetEntry {
+    id: string;
+    trust: 'system' | 'user';
+    isDefault: boolean;
+    name?: string;
+    description?: string;
+    broken?: string;
+}
+/** agentPreset.list → value. */
+export interface DshPresetListValue {
+    presets: DshPresetEntry[];
+    authorable: boolean;
+    hasDocument: boolean;
+}
+/** Mux frame payloads we care about (subset of MuxFrame). */
+export type DshMuxFrame = {
+    type: 'session/event';
+    sessionId: string;
+    event: DshSessionEvent;
+} | {
+    type: 'approval/requested';
+    sessionId: string;
+    approvalId: string;
+    toolName: string;
+    callId?: string;
+    reason?: string;
+} | {
+    type: 'stream/error';
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/** ServerRequest envelope (frame.method === frame.payload.type). */
+export interface DshServerRequest {
+    type: 'server-request';
+    rpcId: string;
+    method: string;
+    payload: unknown;
+}
+/** Unified per-session subscription item: a session event or an approval notice. */
+export type DshStreamItem = {
+    kind: 'event';
+    sessionId: string;
+    event: DshSessionEvent;
+} | {
+    kind: 'approval';
+    sessionId: string;
+    approvalId: string;
+    toolName: string;
+    reason?: string;
+};

package/dist/runner/dsh/types.js

@@ -0,0 +1,14 @@
+/**
+ * DSH wire type shapes (DeepSeek Harness HTTP proxy contract).
+ *
+ * Source of truth: packages/host/apiproxy/src/api/{rpc,sessions,events}.ts and
+ * packages/core/session/src/types.ts in the deepseek-harness repo. Only the
+ * fields DshClient/DshRunner/DshSessionReader consume are declared here.
+ *
+ * Unary: POST /api/<method>, body `{type:'client-request',rpcId,method,payload}`,
+ * response `{type:'server-response',rpcId,result:{ok:true,value}|{ok:false,error}}`.
+ * Stream: SSE GET /api/events.mux, frames `data: {type:'server-request',rpcId,
+ * method:<frame.type>, payload:<MuxFrame>}\n\n`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runner/index.d.ts

@@ -12,6 +12,7 @@ export { CodexAppServerRunner } from './codex/index.js';
 export { OpencodeAcpRunner } from './opencode/index.js';
 export { PiRpcRunner } from './pi/index.js';
 export { KimiAcpRunner } from './kimi/index.js';
+export { DshRunner } from './dsh/index.js';
 export { BashProcessRunner, type BashRunner } from './bash/index.js';
 export { AgentRegistry } from './registry.js';
 export type { ResultEvent, PlanEvent, FileChangeEvent, AgentEvent, Runner, RunnerLifetime, AgentKind, AgentSession, AgentSessionContentEvent, AgentSessionUsage, SessionContent, AgentSessionReader, AgentRunner, TurnStartedEvent, TurnDiffEvent, ApprovalView, ApprovalRequestedEvent, ApprovalResolvedEvent, } from './types.js';

package/dist/runner/index.js

@@ -13,6 +13,7 @@ export { CodexAppServerRunner } from './codex/index.js';
 export { OpencodeAcpRunner } from './opencode/index.js';
 export { PiRpcRunner } from './pi/index.js';
 export { KimiAcpRunner } from './kimi/index.js';
+export { DshRunner } from './dsh/index.js';
 export { BashProcessRunner } from './bash/index.js';
 // Re-export registry
 export { AgentRegistry } from './registry.js';

package/dist/runner/kimi/acp/runner.js

@@ -15,6 +15,7 @@ import { ConnectionManager as KimiAcpConnectionManager, } from '../../common/jso
 import { KimiAcpTranslator } from './translator.js';
 import { RpcErrorCode, ServerRequestMethod, } from '../../common/acp/protocol-types.js';
 import { findOptionIdByKind } from '../../common/acp/protocol-helpers.js';
+import { mapAnswersByIndex } from '../../question-common.js';
 import { getLogger } from '../../../logger/index.js';
 import { ConnectionBasedRunner } from '../../common/connection-based-runner.js';
 /** R2: how long to wait for the background compaction record after the
@@ -92,6 +93,63 @@ function buildApprovalResponse(action, pending) {
     }
     return { outcome: { outcome: 'cancelled' } };
 }
+/**
+ * AskUserQuestion 回编（kind === 'question'）：
+ * - elicitation form：answer → {action:'accept', content:{q0..qn}}（多选数组/
+ *   单选字符串，key 按问题顺序）；decline → {action:'decline'}；cancel →
+ *   {action:'cancel'}。
+ * - request_permission 兜底桥：answer → 按 label 回显 q0_opt_{i} optionId；
+ *   decline → q0_skip optionId（无则 cancelled）；cancel → cancelled。
+ * 答案以 {问题文本: 值} 回传，先按问题顺序展开再协议编码。
+ */
+function buildQuestionResponse(action, pending, response) {
+    if (pending.proto === 'elicitation') {
+        if (action === 'answer') {
+            const answers = response.answers;
+            const questions = pending.view.questions ?? [];
+            const byIndex = mapAnswersByIndex(questions, answers ?? {});
+            const content = {};
+            questions.forEach((q, i) => {
+                const value = byIndex[i];
+                if (value === undefined)
+                    return;
+                if (q.multiSelect) {
+                    const values = Array.isArray(value) ? value : [value];
+                    const cleaned = values.filter((v) => typeof v === 'string' && v.length > 0);
+                    if (cleaned.length > 0)
+                        content[`q${i}`] = cleaned;
+                }
+                else {
+                    const single = Array.isArray(value) ? value[0] : value;
+                    if (typeof single === 'string' && single.length > 0)
+                        content[`q${i}`] = single;
+                }
+            });
+            return { action: 'accept', content };
+        }
+        if (action === 'decline')
+            return { action: 'decline' };
+        return { action: 'cancel' };
+    }
+    // request_permission 兜底桥（单题单选）
+    if (action === 'answer') {
+        const answers = response.answers;
+        const first = pending.view.questions?.[0];
+        const value = first ? answers?.[first.question] : undefined;
+        const label = Array.isArray(value) ? value[0] : value;
+        const option = (pending.options ?? []).find((opt) => /^q\d+_opt_\d+$/.test(opt.optionId) && opt.name === label);
+        if (option)
+            return { outcome: { outcome: 'selected', optionId: option.optionId } };
+        return { outcome: { outcome: 'cancelled' } };
+    }
+    if (action === 'decline') {
+        const skip = (pending.options ?? []).find((opt) => /^q\d+_skip$/.test(opt.optionId));
+        if (skip)
+            return { outcome: { outcome: 'selected', optionId: skip.optionId } };
+        return { outcome: { outcome: 'cancelled' } };
+    }
+    return { outcome: { outcome: 'cancelled' } };
+}
 // =============================================================================
 // Runner
 // =============================================================================
@@ -122,6 +180,13 @@ export class KimiAcpRunner extends ConnectionBasedRunner {
                 clientCapabilities: {
                     fs: { readTextFile: false, writeTextFile: false },
                     terminal: false,
+                    // AskUserQuestion 走 elicitation form（原生多题+多选；form 失败时
+                    // kimi 服务端自动回退 request_permission 桥，客户端两者都处理）。
+                    // 注意：ACP SDK 对 elicitation.form 的 zod schema 是对象
+                    // （z.record(z.string(), z.any())），布尔 true 会被 kimi 服务端静默
+                    // 丢弃 → elicitationForm=false → 多选回退成 request_permission 单选
+                    // 桥（勾一个选项即提交）。必须用空对象 {}。
+                    elicitation: { form: {} },
                 },
             },
         };
@@ -261,7 +326,9 @@ export class KimiAcpRunner extends ConnectionBasedRunner {
         if (!client || !pending)
             return;
         const action = response?.action ?? 'decline';
-        const acpResponse = buildApprovalResponse(action, pending);
+        const acpResponse = pending.kind === 'question'
+            ? buildQuestionResponse(action, pending, response)
+            : buildApprovalResponse(action, pending);
         client.respond(requestId, acpResponse);
         this.pendingApprovals.delete(requestId);
         getLogger().info(`[${this.logTag}] approval responded requestId=${requestId} action=${action}`);
@@ -338,6 +405,21 @@ export class KimiAcpRunner extends ConnectionBasedRunner {
             sessionId = newResult.sessionId;
         }
         this.activeSessionId = sessionId;
+        // CC-07: 下发配置的模型（provider/model）。session/new|resume 只带 cwd/mcpServers，
+        // 不带 model；不主动下发则实际跑 kimi 服务端默认模型（旧 KimiRunner 通过 -m 传模型，
+        // 迁移到纯 ACP 后丢失）。仿 opencode 用 session/set_config_option。失败仅告警不阻断。
+        if (this.model) {
+            try {
+                await client.request('session/set_config_option', {
+                    sessionId,
+                    configId: 'model',
+                    value: this.model,
+                });
+            }
+            catch (err) {
+                getLogger().warn(`[${this.logTag}] set_config_option model failed (non-fatal): ${err.message}`);
+            }
+        }
         // Set permission mode (§5.1): EVERY fresh ACP session starts in
         // 'default' (= manual approvals, acp-server modes.ts DEFAULT_MODE_ID),
         // so the mode must be sent unconditionally — skipping yolo leaves the
@@ -438,6 +520,7 @@ export class KimiAcpRunner extends ConnectionBasedRunner {
                     kind: ev.kind,
                     view: ev.view,
                     options: params.options,
+                    proto: method === ServerRequestMethod.ELICITATION_CREATE ? 'elicitation' : 'permission',
                 });
                 getLogger().info(`[${this.logTag}] approval requested requestId=${ev.requestId} kind=${ev.kind}`);
             }

package/dist/runner/kimi/acp/translator.d.ts

@@ -81,6 +81,14 @@ export declare class KimiAcpTranslator {
      * Handle a server request (reverse RPC from the ACP server).
      */
     handleServerRequest(id: number | string, method: string, params: unknown): AcpTranslatorEvent[];
+    /**
+     * Kimi elicitation form：requestedSchema.properties 按顺序解析为 UserQuestion[]
+     * （type:array → 多选；oneOf/anyOf const → 选项 label；title → header??question）。
+     * 题面完整文本只在 form 级 message 里合并出现（逐字段 title 可能只是短 header），
+     * 因此 message 作为卡片概要行（view.intro）透传。
+     * form 会丢弃非声明选项值 → isOther=false（卡片隐藏自定义答案输入）。
+     */
+    private handleElicitationCreate;
     /**
      * Produce a turn_started event. Called by the runner when session/prompt
      * is sent (no wire notification for this — self-produced).
@@ -108,6 +116,12 @@ export declare class KimiAcpTranslator {
     private handleToolCallUpdate;
     private handleUsageUpdate;
     private handleRequestPermission;
+    /**
+     * request_permission 兜底桥（elicitation/create 失败或旧版 kimi）：
+     * 选项为 q{n}_opt_{i}（allow_once，label 直取 name）+ q{n}_skip（reject_once，
+     * 跳过语义）。单题单选、无 Other（kimi 桥丢弃非声明值）。
+     */
+    private handlePermissionQuestion;
     /**
      * Derive the approval decision list from the server's offered options.
      * accept/decline/cancel are universal; acceptForSession requires an

package/dist/runner/kimi/acp/translator.js

@@ -28,6 +28,7 @@
  *   turn_started (self-produced)   → operationKind 'turn'/'compaction'
  *   session/request_permission     → approval_requested
  */
+import { makeQuestionApprovalEvent } from '../../question-common.js';
 import { NotificationMethod, ServerRequestMethod, SessionEventType, } from '../../common/acp/protocol-types.js';
 import { getLogger } from '../../../logger/index.js';
 /**
@@ -96,8 +97,41 @@ export class KimiAcpTranslator {
         if (method === ServerRequestMethod.REQUEST_PERMISSION) {
             return this.handleRequestPermission(id, params);
         }
+        if (method === ServerRequestMethod.ELICITATION_CREATE) {
+            return this.handleElicitationCreate(id, params);
+        }
         return [];
     }
+    /**
+     * Kimi elicitation form：requestedSchema.properties 按顺序解析为 UserQuestion[]
+     * （type:array → 多选；oneOf/anyOf const → 选项 label；title → header??question）。
+     * 题面完整文本只在 form 级 message 里合并出现（逐字段 title 可能只是短 header），
+     * 因此 message 作为卡片概要行（view.intro）透传。
+     * form 会丢弃非声明选项值 → isOther=false（卡片隐藏自定义答案输入）。
+     */
+    handleElicitationCreate(requestId, params) {
+        const properties = params.requestedSchema?.properties ?? {};
+        const questions = [];
+        for (const [key, prop] of Object.entries(properties)) {
+            const q = elicitationPropertyToQuestion(prop);
+            if (!q) {
+                getLogger().warn(`[kimi-acp-translator] elicitation property skipped: key=${key}`);
+                continue;
+            }
+            questions.push(q);
+        }
+        if (questions.length === 0) {
+            // 无法解析 → 交还 runner 自动响应（不悬挂服务端）。
+            return [];
+        }
+        const message = params.message?.trim();
+        const single = questions.length === 1;
+        const intro = message && (!single || message !== questions[0].question) ? message : undefined;
+        const event = makeQuestionApprovalEvent(requestId, questions, params.sessionId);
+        if (intro)
+            event.view.intro = intro;
+        return [event];
+    }
     /**
      * Produce a turn_started event. Called by the runner when session/prompt
      * is sent (no wire notification for this — self-produced).
@@ -274,9 +308,20 @@ export class KimiAcpTranslator {
     // Private approval handlers
     // =========================================================================
     handleRequestPermission(requestId, params) {
-        // §5.4: Question elicitation auto-respond cancelled
-        if (params.isQuestion || !params.toolCall) {
-            getLogger().info(`[kimi-acp-translator] question elicitation detected, auto-responding cancelled (requestId=${requestId})`);
+        // §5.4 升级：question elicitation 识别（isQuestion 标记 / AskUserQuestion
+        // toolCall 标题 / q{n}_opt_* 选项命名空间）→ 渲染为提问卡；无法解析的
+        // 退化形态（无 toolCall 也无选项）仍返回 [] 由 runner 自动响应 cancelled。
+        const toolCall = params.toolCall;
+        const questionMarker = params.isQuestion === true ||
+            toolCall?.title === 'AskUserQuestion' ||
+            optionIdsMatchQuestionNamespace(params.options);
+        if (questionMarker) {
+            return this.handlePermissionQuestion(requestId, params);
+        }
+        // §5.4：无 toolCall 且无提问标记 → 无法构成审批视图，返回 [] 由 runner
+        // 自动响应 cancelled（服务端不会悬挂）。
+        if (!toolCall) {
+            getLogger().info(`[kimi-acp-translator] permission request without toolCall, auto-responding cancelled (requestId=${requestId})`);
             return [];
         }
         const view = {
@@ -301,6 +346,27 @@ export class KimiAcpTranslator {
             },
         ];
     }
+    /**
+     * request_permission 兜底桥（elicitation/create 失败或旧版 kimi）：
+     * 选项为 q{n}_opt_{i}（allow_once，label 直取 name）+ q{n}_skip（reject_once，
+     * 跳过语义）。单题单选、无 Other（kimi 桥丢弃非声明值）。
+     */
+    handlePermissionQuestion(requestId, params) {
+        const selectable = (params.options ?? []).filter((opt) => /^q\d+_opt_\d+$/.test(opt.optionId));
+        if (selectable.length === 0) {
+            getLogger().info(`[kimi-acp-translator] question elicitation unparseable, auto-responding cancelled (requestId=${requestId})`);
+            return [];
+        }
+        const questionText = extractQuestionText(params.toolCall);
+        const questions = [
+            {
+                question: questionText,
+                isOther: false,
+                options: selectable.map((opt) => ({ label: opt.name })),
+            },
+        ];
+        return [makeQuestionApprovalEvent(requestId, questions, params.sessionId)];
+    }
     /**
      * Derive the approval decision list from the server's offered options.
      * accept/decline/cancel are universal; acceptForSession requires an
@@ -333,4 +399,43 @@ export class KimiAcpTranslator {
 function truncate(text, maxLen) {
     return text.length <= maxLen ? text : text.slice(0, maxLen) + '…';
 }
+/** elicitation schema property → UserQuestion（无法解析返回 null）。 */
+function elicitationPropertyToQuestion(prop) {
+    const title = prop.title?.trim();
+    if (!title)
+        return null;
+    const multiSelect = prop.type === 'array';
+    const rawOptions = multiSelect ? prop.items?.anyOf : prop.oneOf;
+    const options = (rawOptions ?? [])
+        .filter((opt) => typeof opt?.const === 'string')
+        .map((opt) => ({
+        label: opt.const,
+        ...(opt.description ? { description: opt.description } : {}),
+    }));
+    if (options.length === 0)
+        return null;
+    return {
+        question: title,
+        header: title,
+        multiSelect,
+        isOther: false,
+        options,
+    };
+}
+/** 选项命名空间是否匹配 kimi question 桥（q{n}_opt_{i} / q{n}_skip）。 */
+function optionIdsMatchQuestionNamespace(options) {
+    return (options ?? []).some((opt) => /^q\d+_(opt_\d+|skip)$/.test(opt.optionId));
+}
+/** 从 AskUserQuestion toolCall 提取题面（content 文本优先，标题兜底）。 */
+function extractQuestionText(toolCall) {
+    const content = toolCall?.content;
+    if (Array.isArray(content)) {
+        for (const block of content) {
+            const text = block.content?.text;
+            if (typeof text === 'string' && text.trim())
+                return text.trim();
+        }
+    }
+    return toolCall?.title?.trim() || '请选择';
+}
 //# sourceMappingURL=translator.js.map

package/dist/runner/pi/rpc/runner.d.ts

@@ -14,8 +14,7 @@
  * turn idle watchdog, connection-lost retry). Differences:
  *   - pi binds the session at spawn via `--session-id` (no RPC resume-by-id);
  *     the PiRpcConnectionManager respawns when the requested session changes.
- *   - no approval server-requests (pi RPC exposes none in this scope) →
- *     respondApproval is a no-op.
+ *   - pi，极简风格，没有 Ask User question。
  *   - `prompt` ack ≠ turn completion; the turn ends on `agent_settled`.
  */
 import type { AgentSessionReader, AgentEvent, AgentStatusInfo, SpawnOptions } from '../../types.js';
@@ -71,10 +70,5 @@ export declare class PiRpcRunner extends ConnectionBasedRunner<PiRpcClient, PiRp
      * completion (the completion signal); `compaction_*` events stream meanwhile.
      */
     runCompact(_message: string, opts: SpawnOptions): AsyncGenerator<AgentEvent>;
-    /**
-     * Approvals are out of scope for pi RPC (no server requests surface in this
-     * integration); the bridge's duck-typed respondApproval call is a no-op.
-     */
-    respondApproval(_requestId: number | string, _response: unknown): Promise<void>;
     private handleEvent;
 }

package/dist/runner/pi/rpc/runner.js

@@ -14,8 +14,7 @@
  * turn idle watchdog, connection-lost retry). Differences:
  *   - pi binds the session at spawn via `--session-id` (no RPC resume-by-id);
  *     the PiRpcConnectionManager respawns when the requested session changes.
- *   - no approval server-requests (pi RPC exposes none in this scope) →
- *     respondApproval is a no-op.
+ *   - pi，极简风格，没有 Ask User question。
  *   - `prompt` ack ≠ turn completion; the turn ends on `agent_settled`.
  */
 import { ConnectionBasedRunner } from '../../common/connection-based-runner.js';
@@ -135,7 +134,12 @@ export class PiRpcRunner extends ConnectionBasedRunner {
         this.currentTurnId = turnId;
         this.pushEvents([translator.produceTurnStarted(sessionId, turnId)]);
         this.promptSettled = false;
-        await client.request({ type: 'prompt', message });
+        const response = await client.request({ type: 'prompt', message });
+        if (!response.success) {
+            // CC-08: pi 返回 success:false（无效模型/provider 错误/忙）时立即失败，
+            // 不能当成成功 ACK 继续等 agent_settled（否则最长 turn idle timeout）。
+            throw new Error(`pi prompt failed: ${response.error ?? 'unknown error'}`);
+        }
         this.promptSettled = true;
     }
     /**
@@ -172,16 +176,8 @@ export class PiRpcRunner extends ConnectionBasedRunner {
             this.pushEvents([translator.produceCompactResult(opts.sessionId, response)]);
         });
     }
-    /**
-     * Approvals are out of scope for pi RPC (no server requests surface in this
-     * integration); the bridge's duck-typed respondApproval call is a no-op.
-     */
-    async respondApproval(_requestId, _response) {
-        // no-op
-    }
     handleEvent(evt) {
-        const events = this.currentTranslator?.handleEvent(evt) ?? [];
-        this.pushEvents(events);
+        this.pushEvents(this.currentTranslator?.handleEvent(evt) ?? []);
     }
 }
 /** Build pi `--mode rpc` spawn args. `sessionId` is bound at spawn (pi has no

package/dist/runner/probe.js

@@ -28,6 +28,9 @@ const BINARY_MAP = {
     opencode: 'opencode',
     pi: 'pi',
     kimi: 'kimi',
+    // DSH is an HTTP-only agent (no CLI). `which ''` fails → reported unavailable,
+    // which is semantically correct for the /config availability display.
+    dsh: '',
 };
 const CACHE_TTL_MS = 5 * 60_000;
 /** Module-level cache, survives across calls within the process. */
@@ -65,7 +68,9 @@ export async function probeAgentAvailability(kind) {
  * on resource-constrained devices.
  */
 export async function probeAllAgents() {
-    const kinds = Object.keys(BINARY_MAP);
+    // Skip agents with no CLI binary (DSH is HTTP-only, binary === ''): the
+    // probe / availability display only covers spawn-able agents.
+    const kinds = Object.keys(BINARY_MAP).filter((k) => BINARY_MAP[k] !== '');
     const entries = await Promise.all(kinds.map(async (k) => [k, await probeAgentAvailability(k)]));
     return new Map(entries);
 }

package/dist/runner/question-common.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AskUserQuestion 公共工厂与映射（agent 无关）。
+ *
+ * 接入约定（types.ts UserQuestion 注释的落点）：
+ * - 各 runner 用 makeQuestionApprovalEvent 构造标准 question 审批事件，
+ *   避免四处手拼事件形状（claude/codex/kimi/pi 共用）；
+ * - 用户答案经 ApprovalCoordinator 以 {问题文本: 值} 回传 runner 后，
+ *   用 mapAnswersByIndex 按问题顺序展开，再做协议级编码
+ *   （Codex 问题 id、Kimi q{i}、Pi 单题取值）。
+ */
+import type { ApprovalRequestedEvent, UserQuestion } from './types.js';
+export interface QuestionEventOptions {
+    /** Per-request 审批超时覆盖（Codex autoResolutionMs）。 */
+    timeoutMs?: number;
+}
+/**
+ * 构造标准 question approval_requested 事件。
+ * availableDecisions 恒为空数组：提问只能作答或跳过（decline/cancel 是
+ * coordinator 的通用安全兜底），不允许 accept/decline 按钮混入提问卡。
+ */
+export declare function makeQuestionApprovalEvent(requestId: number | string, questions: UserQuestion[], threadId: string, opts?: QuestionEventOptions): ApprovalRequestedEvent;
+/**
+ * 按问题顺序把 coordinator 回传的 {问题文本: 值} 展开成索引对齐数组。
+ * 未作答的问题对应 undefined，由各 runner 决定协议编码（跳过/空 answers）。
+ */
+export declare function mapAnswersByIndex(questions: UserQuestion[], answers: Record<string, string | string[]>): Array<string | string[] | undefined>;

package/dist/runner/question-common.js

@@ -0,0 +1,42 @@
+/**
+ * AskUserQuestion 公共工厂与映射（agent 无关）。
+ *
+ * 接入约定（types.ts UserQuestion 注释的落点）：
+ * - 各 runner 用 makeQuestionApprovalEvent 构造标准 question 审批事件，
+ *   避免四处手拼事件形状（claude/codex/kimi/pi 共用）；
+ * - 用户答案经 ApprovalCoordinator 以 {问题文本: 值} 回传 runner 后，
+ *   用 mapAnswersByIndex 按问题顺序展开，再做协议级编码
+ *   （Codex 问题 id、Kimi q{i}、Pi 单题取值）。
+ */
+/**
+ * 构造标准 question approval_requested 事件。
+ * availableDecisions 恒为空数组：提问只能作答或跳过（decline/cancel 是
+ * coordinator 的通用安全兜底），不允许 accept/decline 按钮混入提问卡。
+ */
+export function makeQuestionApprovalEvent(requestId, questions, threadId, opts) {
+    const view = {
+        requestId,
+        kind: 'question',
+        questions,
+        availableDecisions: [],
+    };
+    return {
+        type: 'approval_requested',
+        requestId,
+        kind: 'question',
+        threadId,
+        turnId: '',
+        itemId: '',
+        view,
+        ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * 按问题顺序把 coordinator 回传的 {问题文本: 值} 展开成索引对齐数组。
+ * 未作答的问题对应 undefined，由各 runner 决定协议编码（跳过/空 answers）。
+ */
+export function mapAnswersByIndex(questions, answers) {
+    return questions.map((q) => answers[q.question]);
+}
+//# sourceMappingURL=question-common.js.map