lark-remote 0.1.6 → 0.1.7

package/dist/persistence/atomic-write.js

@@ -1,13 +1,15 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { silentlyUnlink } from '../common/fs.js';
 /**
- * Atomically write string content to a file via tmp + rename.
+ * Atomically write content (string or binary Buffer) to a file via tmp + rename.
  * Falls back to copy+unlink when rename fails with EXDEV (cross-device).
  */
 export function atomicWrite(filePath, content, encoding = 'utf-8') {
     const dir = path.dirname(filePath);
     fs.mkdirSync(dir, { recursive: true });
     const tmpPath = filePath + '.tmp';
+    // Buffer 内容忽略 encoding（writeFileSync 对 Buffer 自动以二进制写出）。
     fs.writeFileSync(tmpPath, content, encoding);
     // fsync the tmp file before rename so its data is durable on disk;
     // rename itself is only a metadata change, so without fsync a crash after
@@ -47,12 +49,7 @@ export function atomicWrite(filePath, content, encoding = 'utf-8') {
         // Best-effort cleanup: on success the tmp was renamed away (ENOENT here,
         // silently ignored); on EXDEV it was copied and now needs removal; on other
         // errors we must not leak the tmp file.
-        try {
-            fs.unlinkSync(tmpPath);
-        }
-        catch {
-            /* already moved or never created */
-        }
+        silentlyUnlink(tmpPath);
     }
 }
 /**
@@ -62,4 +59,23 @@ export function atomicWrite(filePath, content, encoding = 'utf-8') {
 export function atomicWriteJson(filePath, data) {
     atomicWrite(filePath, JSON.stringify(data, null, 2));
 }
+/**
+ * 把已写好的文件原子移动到目标位置（rename 同设备即原子；EXDEV 跨设备
+ * 回退 copy + unlink）。失败时抛出，由调用方负责清理源文件（best-effort）。
+ * 用于入站媒体：下载已流式写入临时文件，落盘只需一次 move，不再复制进内存。
+ */
+export function atomicMoveFile(srcPath, destPath) {
+    try {
+        fs.renameSync(srcPath, destPath);
+    }
+    catch (err) {
+        if (err.code === 'EXDEV') {
+            fs.copyFileSync(srcPath, destPath);
+            silentlyUnlink(srcPath);
+        }
+        else {
+            throw err;
+        }
+    }
+}
 //# sourceMappingURL=atomic-write.js.map

package/dist/restart.js

@@ -2,6 +2,7 @@ import { spawn } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 import { getLogger } from './logger/index.js';
+import { sleep } from './common/sleep.js';
 /**
  * Self-restart without an external watchdog/cron: the only process that can
  * reliably start the successor is the dying bridge itself. The old process
@@ -66,7 +67,7 @@ export async function waitForPreviousInstance() {
             getLogger().info(`[restart] previous instance pid=${pid} exited, continuing startup`);
             return;
         }
-        await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+        await sleep(POLL_MS);
     }
     getLogger().warn(`[restart] previous instance pid=${pid} still alive after ${WAIT_TIMEOUT_MS}ms, proceeding anyway`);
 }

package/dist/router/card-helpers.d.ts

@@ -8,6 +8,8 @@
  */
 import { markdownDiv } from '../card/collapsible.js';
 import type { AgentSessionContentEvent } from '../runner/index.js';
+import { formatUsageStats } from './utils.js';
+type SessionUsageLike = Parameters<typeof formatUsageStats>[0];
 /**
  * Build a collapsible panel for a single session content event.
  *
@@ -26,3 +28,64 @@ import type { AgentSessionContentEvent } from '../runner/index.js';
  */
 export declare function sessionEventPanel(ev: AgentSessionContentEvent, index: number, totalEvents: number, tailExpandedCount?: number, agentKind?: string): object;
 export { markdownDiv };
+/**
+ * Build a CardKit 2.0 pagination bar (prev-button / page-label / next-button
+ * columns). Shared by /ls, /ws, /resume, /active, /order.
+ *
+ * Returns the `column_set` element (plus caller appends an `hr`). Each caller
+ * supplies its own callback cmd + extra value fields and label text (semantic
+ * differences are preserved, not silently unified).
+ *
+ * @param opts.cmd       The pagination callback command (e.g. 'ls.page').
+ * @param opts.offset    Current page offset.
+ * @param opts.pageSize  Items per page.
+ * @param opts.total     Total item count.
+ * @param opts.extra     Extra callback value fields (e.g. path, agent, pageSize).
+ * @param opts.label     Page-label markdown text (e.g. `**第 1/3 页**（共 30 项）`).
+ * @param opts.prevText / opts.nextText  Button labels (default '⬅ 上一页' / '下一页 ➡').
+ */
+export declare function paginationBar(opts: {
+    cmd: string;
+    offset: number;
+    pageSize: number;
+    total: number;
+    extra?: Record<string, unknown>;
+    label: string;
+    prevText?: string;
+    nextText?: string;
+}): object;
+/**
+ * Build a session-history resume card (shared by auto-restore, /resume <id>,
+ * config-switch resume, and run-completion notification).
+ *
+ * Encapsulates the common structure: header (cwd + sessionId + displayTitle/
+ * recap sections) → optional hidden-count indicator → folded event panels (or
+ * empty placeholder) → usage → trailing-hr removal → action column_set → card
+ * shell. Callers pass their specific header text, card title, usage result
+ * label, placeholders, and already-built action buttons via opts.
+ */
+export declare function buildSessionHistoryCard(state: {
+    sessionId: string;
+    cwd: string;
+    displayTitle?: string;
+    aiTitle?: string;
+    recap?: string;
+    events: AgentSessionContentEvent[];
+    usage?: SessionUsageLike;
+}, opts: {
+    agentKind: string;
+    /** Header first line, e.g. `📂 \`${cwd}\`\n已恢复最近会话: **id**`. */
+    headerText: string;
+    /** Card header title content. */
+    title: string;
+    /** Optional result label passed to formatUsageStats (showResult:true). */
+    usageResult?: string;
+    /** Empty-events placeholder (some callers show a hint instead of nothing). */
+    emptyPlaceholder?: string;
+    /** Hidden earlier-events count (auto-restore only). */
+    hiddenCount?: number;
+    /** Action buttons to render (already built, protocol-specific). */
+    actions?: object[];
+    /** Optional card header template (e.g. 'green' for completion cards). */
+    headerTemplate?: string;
+}): object;

package/dist/router/card-helpers.js

@@ -9,6 +9,7 @@
 import { agentDisplayName } from '../card/card-shared.js';
 import { collapsibleMarkdownPanel, markdownDiv } from '../card/collapsible.js';
 import { formatTimestamp } from '../card/time.js';
+import { formatUsageStats } from './utils.js';
 /**
  * Build a collapsible panel for a single session content event.
  *
@@ -62,4 +63,149 @@ function eventLabel(ev, agentKind) {
     }
 }
 export { markdownDiv };
+/**
+ * Build a CardKit 2.0 pagination bar (prev-button / page-label / next-button
+ * columns). Shared by /ls, /ws, /resume, /active, /order.
+ *
+ * Returns the `column_set` element (plus caller appends an `hr`). Each caller
+ * supplies its own callback cmd + extra value fields and label text (semantic
+ * differences are preserved, not silently unified).
+ *
+ * @param opts.cmd       The pagination callback command (e.g. 'ls.page').
+ * @param opts.offset    Current page offset.
+ * @param opts.pageSize  Items per page.
+ * @param opts.total     Total item count.
+ * @param opts.extra     Extra callback value fields (e.g. path, agent, pageSize).
+ * @param opts.label     Page-label markdown text (e.g. `**第 1/3 页**（共 30 项）`).
+ * @param opts.prevText / opts.nextText  Button labels (default '⬅ 上一页' / '下一页 ➡').
+ */
+export function paginationBar(opts) {
+    const hasPrev = opts.offset > 0;
+    const hasNext = opts.offset + opts.pageSize < opts.total;
+    const prevText = opts.prevText ?? '⬅ 上一页';
+    const nextText = opts.nextText ?? '下一页 ➡';
+    const pageColumns = [];
+    if (hasPrev) {
+        pageColumns.push({
+            tag: 'column',
+            width: 'auto',
+            vertical_align: 'center',
+            elements: [
+                {
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: prevText },
+                    type: 'default',
+                    size: 'small',
+                    behaviors: [
+                        {
+                            type: 'callback',
+                            value: { cmd: opts.cmd, offset: opts.offset - opts.pageSize, ...opts.extra },
+                        },
+                    ],
+                },
+            ],
+        });
+    }
+    pageColumns.push({
+        tag: 'column',
+        width: 'weighted',
+        weight: 1,
+        vertical_align: 'center',
+        elements: [{ tag: 'div', text: { tag: 'lark_md', content: opts.label } }],
+    });
+    if (hasNext) {
+        pageColumns.push({
+            tag: 'column',
+            width: 'auto',
+            vertical_align: 'center',
+            elements: [
+                {
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: nextText },
+                    type: 'default',
+                    size: 'small',
+                    behaviors: [
+                        {
+                            type: 'callback',
+                            value: { cmd: opts.cmd, offset: opts.offset + opts.pageSize, ...opts.extra },
+                        },
+                    ],
+                },
+            ],
+        });
+    }
+    return { tag: 'column_set', columns: pageColumns };
+}
+/**
+ * Build a session-history resume card (shared by auto-restore, /resume <id>,
+ * config-switch resume, and run-completion notification).
+ *
+ * Encapsulates the common structure: header (cwd + sessionId + displayTitle/
+ * recap sections) → optional hidden-count indicator → folded event panels (or
+ * empty placeholder) → usage → trailing-hr removal → action column_set → card
+ * shell. Callers pass their specific header text, card title, usage result
+ * label, placeholders, and already-built action buttons via opts.
+ */
+export function buildSessionHistoryCard(state, opts) {
+    const { displayTitle, aiTitle, recap, events, usage } = state;
+    let header = opts.headerText;
+    const sections = [];
+    // Reader 层不再截断 displayTitle/summary；统一在消费侧这里截到 200 字符。
+    if (displayTitle) {
+        const label = aiTitle ? 'AI 标题' : '最近输入';
+        const preview = displayTitle.length > 200 ? displayTitle.slice(0, 197) + '...' : displayTitle;
+        sections.push(`🏷️ **${label}**\n${preview}`);
+    }
+    if (recap) {
+        const recapPreview = recap.length > 200 ? recap.slice(0, 197) + '...' : recap;
+        sections.push(`📝 **Recap**\n${recapPreview}`);
+    }
+    if (sections.length > 0) {
+        header += '\n\n' + sections.join('\n\n──\n\n');
+    }
+    const elements = [markdownDiv(header), { tag: 'hr' }];
+    if (opts.hiddenCount && opts.hiddenCount > 0) {
+        elements.push(markdownDiv(`📜 还有 ${opts.hiddenCount} 个更早的事件未显示`));
+    }
+    if (events.length === 0 && opts.emptyPlaceholder) {
+        elements.push(markdownDiv(opts.emptyPlaceholder));
+    }
+    else {
+        events.forEach((ev, i) => {
+            elements.push(sessionEventPanel(ev, i, events.length, 2, opts.agentKind));
+        });
+    }
+    if (usage) {
+        const usageStr = opts.usageResult
+            ? formatUsageStats(usage, { showResult: true, result: opts.usageResult })
+            : formatUsageStats(usage);
+        elements.push(markdownDiv(usageStr));
+    }
+    // Remove trailing hr
+    if (elements.length > 0 && elements[elements.length - 1].tag === 'hr') {
+        elements.pop();
+    }
+    if (opts.actions && opts.actions.length > 0) {
+        elements.push({
+            tag: 'column_set',
+            columns: opts.actions.map((btn) => ({
+                tag: 'column',
+                width: 'auto',
+                elements: [btn],
+            })),
+        });
+    }
+    return {
+        schema: '2.0',
+        config: { wide_screen_mode: true },
+        header: {
+            ...(opts.headerTemplate ? { template: opts.headerTemplate } : {}),
+            title: {
+                tag: 'plain_text',
+                content: opts.title,
+            },
+        },
+        body: { elements },
+    };
+}
 //# sourceMappingURL=card-helpers.js.map

package/dist/router/config/claude.js

@@ -4,7 +4,21 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { MODEL_ID_TO_ALIAS, MODEL_ALIAS_TO_ID, getModelOptionsFromSettings, CLAUDE_EFFORTS, } from '../../config/index.js';
+import { MODEL_ID_TO_ALIAS, MODEL_ALIAS_TO_ID, getModelOptionsFromSettings, CLAUDE_EFFORTS, CLAUDE_PERMISSION_MODES, } from '../../config/index.js';
+/** Claude 官方 --permission-mode 中文注释（value 走 CLAUDE_PERMISSION_MODES SSOT）。 */
+const PERMISSION_MODE_LABELS = {
+    default: '默认（敏感操作逐项询问）',
+    acceptEdits: '自动接受文件编辑',
+    auto: '自动放行低风险操作',
+    bypassPermissions: '跳过所有权限检查',
+    manual: '手动审批（default 的别名）',
+    dontAsk: '仅预先批准的工具',
+    plan: '计划模式（只读探索）',
+};
+const PERMISSION_MODE_OPTIONS = CLAUDE_PERMISSION_MODES.map((m) => ({
+    text: `${m}（${PERMISSION_MODE_LABELS[m] ?? ''}）`,
+    value: m,
+}));
 export class ClaudeConfigBuilder {
     /** Find Claude settings.json path (for dynamic model reading). */
     findSettingsPath() {
@@ -61,6 +75,16 @@ export class ClaudeConfigBuilder {
             options: CLAUDE_EFFORTS,
             currentValue: currentEffort,
         });
+        // 权限模式（Claude 官方 --permission-mode 枚举；bypassPermissions 为 schema 默认，
+        // 保持旧行为无审批卡，配置为其他值后激活交互式审批）
+        const currentPermissionMode = displayConfig.claude?.permissionMode ?? 'bypassPermissions';
+        fields.push({
+            key: 'claude.permissionMode',
+            label: '权限模式',
+            type: 'select',
+            options: PERMISSION_MODE_OPTIONS,
+            currentValue: currentPermissionMode,
+        });
         return fields;
     }
     handleFieldChange(key, _value, _config) {

package/dist/router/config/codex.js

@@ -3,6 +3,7 @@
  */
 import { loadCodexConfig, getReasoningEffortOptions, getDefaultReasoningEffort, } from '../../config/codex-config.js';
 import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
+import { resetModelPatch } from './common/model-patch.js';
 export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -44,54 +45,33 @@ export class CodexConfigBuilder {
             options: getReasoningEffortOptions(currentCodexModel),
             currentValue: currentReasoningEffort,
         });
-        // Service mode (exec vs app-server)
-        const currentServiceMode = displayConfig.agents?.codex?.serviceMode ?? 'exec';
+        // 审批策略与沙箱模式由 CodexAppServerRunner 读取（Codex 官方枚举标准值）。
+        // Approval policy (Codex 官方 AskForApproval 标准值；on-request 为 codex 默认)
+        const currentApprovalPolicy = displayConfig.agents?.codex?.approvalPolicy ?? 'on-request';
         fields.push({
-            key: 'agents.codex.serviceMode',
-            label: '运行模式',
+            key: 'agents.codex.approvalPolicy',
+            label: '审批策略',
             type: 'select',
-            options: ['exec', 'app-server'],
-            currentValue: currentServiceMode,
+            options: ['untrusted', 'on-request', 'never'],
+            currentValue: currentApprovalPolicy,
+        });
+        // Sandbox mode (Codex 官方 SandboxMode 标准值；默认 workspace-write)
+        const currentSandbox = displayConfig.agents?.codex?.sandbox ?? 'workspace-write';
+        fields.push({
+            key: 'agents.codex.sandbox',
+            label: '沙箱模式',
+            type: 'select',
+            options: ['read-only', 'workspace-write', 'danger-full-access'],
+            currentValue: currentSandbox,
+        });
+        const currentTurnIdleTimeoutMinutes = displayConfig.agents?.codex?.appServer?.turnIdleTimeoutMinutes ??
+            DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
+        fields.push({
+            key: 'agents.codex.appServer.turnIdleTimeoutMinutes',
+            label: 'Turn 空闲超时(分钟, 0关闭)',
+            type: 'input',
+            currentValue: String(currentTurnIdleTimeoutMinutes),
         });
-        // 审批策略与沙箱模式仅 app-server 模式可配置（CodexAppServerRunner 读取）；
-        // exec 模式在 runner 层固定 `--sandbox danger-full-access` +
-        // `approval_policy="never"`（src/runner/codex/argv.ts），卡片不暴露选项，
-        // 只用说明行把默认语义呈现给用户。
-        if (currentServiceMode === 'app-server') {
-            // Approval policy (Codex 官方 AskForApproval 标准值；on-request 为 codex 默认)
-            const currentApprovalPolicy = displayConfig.agents?.codex?.approvalPolicy ?? 'on-request';
-            fields.push({
-                key: 'agents.codex.approvalPolicy',
-                label: '审批策略',
-                type: 'select',
-                options: ['untrusted', 'on-request', 'never'],
-                currentValue: currentApprovalPolicy,
-            });
-            // Sandbox mode (Codex 官方 SandboxMode 标准值)
-            const currentSandbox = displayConfig.agents?.codex?.sandbox ?? 'danger-full-access';
-            fields.push({
-                key: 'agents.codex.sandbox',
-                label: '沙箱模式',
-                type: 'select',
-                options: ['read-only', 'workspace-write', 'danger-full-access'],
-                currentValue: currentSandbox,
-            });
-            const currentTurnIdleTimeoutMinutes = displayConfig.agents?.codex?.appServer?.turnIdleTimeoutMinutes ??
-                DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
-            fields.push({
-                key: 'agents.codex.appServer.turnIdleTimeoutMinutes',
-                label: 'Turn 空闲超时(分钟, 0关闭)',
-                type: 'input',
-                currentValue: String(currentTurnIdleTimeoutMinutes),
-            });
-        }
-        else {
-            fields.push({
-                key: 'agents.codex.modeNote',
-                label: '命令行模式固定为完全访问（danger-full-access）且无需审批（approval never），不提供审批策略/沙箱配置',
-                type: 'note',
-            });
-        }
         return fields;
     }
     handleFieldChange(key, value, config) {
@@ -100,12 +80,11 @@ export class CodexConfigBuilder {
         // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.codex.modelProvider' && typeof value === 'string') {
             const codexCfg = loadCodexConfig();
-            const newModelOptions = codexCfg.modelOptions(value);
             const currentModel = config.agents?.codex?.model;
-            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
-            if (!currentModelIsValid && newModelOptions.length > 0) {
-                const replacedModel = newModelOptions[0];
-                patches.push({ key: 'agents.codex.model', value: replacedModel });
+            const modelPatch = resetModelPatch(key, 'agents.codex.model', currentModel, codexCfg.modelOptions(value));
+            if (modelPatch) {
+                patches.push(modelPatch);
+                const replacedModel = modelPatch.value;
                 // provider 切换自动替换模型后，必须对替换后的模型执行
                 // 同样的档位校验——否则旧模型支持的档位会原样留在卡片/透传给不支持它的模型
                 // （codex 只在会话中 with_model 时钳制，session 创建路径不钳制）。

package/dist/router/config/common/model-patch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared field-change patch helpers for agent config cards.
+ *
+ * `resetModelPatch` captures the "provider changed → reset model to the new
+ * provider's first model" behavior that opencode/pi/codex config builders were
+ * duplicating.
+ */
+/**
+ * Build a model-reset patch when the provider field changes: if the current
+ * model is not offered by the new provider (and the new provider has models),
+ * patch the model to the provider's first option.
+ *
+ * @param providerKey  The field key that changed, e.g. 'agents.codex.modelProvider'.
+ * @param modelKey     The model field to reset, e.g. 'agents.codex.model'.
+ * @param currentModel The currently-configured model value (may be undefined).
+ * @param newModelOptions Models offered by the newly-selected provider.
+ * @returns A `{ key, value }` patch, or null when no reset is needed.
+ */
+export declare function resetModelPatch(providerKey: string, modelKey: string, currentModel: string | undefined, newModelOptions: string[]): {
+    key: string;
+    value: unknown;
+} | null;

package/dist/router/config/common/model-patch.js

@@ -0,0 +1,26 @@
+/**
+ * Shared field-change patch helpers for agent config cards.
+ *
+ * `resetModelPatch` captures the "provider changed → reset model to the new
+ * provider's first model" behavior that opencode/pi/codex config builders were
+ * duplicating.
+ */
+/**
+ * Build a model-reset patch when the provider field changes: if the current
+ * model is not offered by the new provider (and the new provider has models),
+ * patch the model to the provider's first option.
+ *
+ * @param providerKey  The field key that changed, e.g. 'agents.codex.modelProvider'.
+ * @param modelKey     The model field to reset, e.g. 'agents.codex.model'.
+ * @param currentModel The currently-configured model value (may be undefined).
+ * @param newModelOptions Models offered by the newly-selected provider.
+ * @returns A `{ key, value }` patch, or null when no reset is needed.
+ */
+export function resetModelPatch(providerKey, modelKey, currentModel, newModelOptions) {
+    const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
+    if (!currentModelIsValid && newModelOptions.length > 0) {
+        return { key: modelKey, value: newModelOptions[0] };
+    }
+    return null;
+}
+//# sourceMappingURL=model-patch.js.map

package/dist/router/config/common/render.js

@@ -86,10 +86,11 @@ function buildSelectElement(field, currentValue) {
                     {
                         tag: 'select_static',
                         placeholder: { tag: 'plain_text', content: '请选择' },
-                        options: field.options.map((opt) => ({
-                            text: { tag: 'plain_text', content: opt },
-                            value: opt,
-                        })),
+                        options: field.options.map((opt) => {
+                            const text = typeof opt === 'string' ? opt : opt.text;
+                            const value = typeof opt === 'string' ? opt : opt.value;
+                            return { text: { tag: 'plain_text', content: text }, value };
+                        }),
                         initial_option: selectedValue,
                         behaviors: [{ type: 'callback', value: { cmd: 'config.set', key: field.key } }],
                     },

package/dist/router/config/index.d.ts

@@ -6,6 +6,12 @@
  */
 import type { AgentKind } from '../../runner/types.js';
 import type { AgentConfigCardBuilder } from './types.js';
+/**
+ * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi。
+ * 未安装（availability === false）的 agent 在展示时排到后面
+ * （见 sortAgentsForDisplay），同组内保持本顺序。
+ */
+export declare const DEFAULT_AGENT_ORDER: readonly AgentKind[];
 /**
  * Get the config builder for a specific agent.
  *
@@ -16,3 +22,9 @@ import type { AgentConfigCardBuilder } from './types.js';
 export declare function getConfigBuilder(agent: AgentKind): AgentConfigCardBuilder;
 /** List all registered agent kinds. */
 export declare function listRegisteredAgents(): AgentKind[];
+/**
+ * 按展示规则排序 agent 列表：明确未安装（availability === false）的排后，
+ * 已安装/未知的在前；同组内保持传入顺序（canonical order）。
+ * Array.prototype.sort 是稳定排序，因此按可用性分组不会打乱组内顺序。
+ */
+export declare function sortAgentsForDisplay(agents: readonly AgentKind[], availability: (kind: AgentKind) => boolean | undefined): AgentKind[];

package/dist/router/config/index.js

@@ -9,6 +9,18 @@ import { CodexConfigBuilder } from './codex.js';
 import { PiConfigBuilder } from './pi.js';
 import { OpencodeConfigBuilder } from './opencode.js';
 import { KimiConfigBuilder } from './kimi.js';
+/**
+ * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi。
+ * 未安装（availability === false）的 agent 在展示时排到后面
+ * （见 sortAgentsForDisplay），同组内保持本顺序。
+ */
+export const DEFAULT_AGENT_ORDER = [
+    'codex',
+    'claude',
+    'opencode',
+    'pi',
+    'kimi',
+];
 /** Registry of config builders, keyed by agent kind. */
 const builders = {
     claude: new ClaudeConfigBuilder(),
@@ -33,6 +45,18 @@ export function getConfigBuilder(agent) {
 }
 /** List all registered agent kinds. */
 export function listRegisteredAgents() {
-    return Object.keys(builders);
+    return DEFAULT_AGENT_ORDER.filter((kind) => kind in builders);
+}
+/**
+ * 按展示规则排序 agent 列表：明确未安装（availability === false）的排后，
+ * 已安装/未知的在前；同组内保持传入顺序（canonical order）。
+ * Array.prototype.sort 是稳定排序，因此按可用性分组不会打乱组内顺序。
+ */
+export function sortAgentsForDisplay(agents, availability) {
+    return [...agents].sort((a, b) => {
+        const aMissing = availability(a) === false ? 1 : 0;
+        const bMissing = availability(b) === false ? 1 : 0;
+        return aMissing - bMissing;
+    });
 }
 //# sourceMappingURL=index.js.map

package/dist/router/config/kimi.d.ts

@@ -1,8 +1,11 @@
 /**
  * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ *
+ * Kimi is pure ACP mode: permissionMode (manual/auto/yolo) and the ACP
+ * sub-config fields are always shown.
  */
 import type { AgentConfigCardBuilder, ConfigField } from './types.js';
-import type { AppConfig } from '../../config/index.js';
+import { type AppConfig } from '../../config/index.js';
 export declare class KimiConfigBuilder implements AgentConfigCardBuilder {
     buildFields(displayConfig: AppConfig): ConfigField[];
     handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{

package/dist/router/config/kimi.js

@@ -1,7 +1,16 @@
 /**
  * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ *
+ * Kimi is pure ACP mode: permissionMode (manual/auto/yolo) and the ACP
+ * sub-config fields are always shown.
  */
 import { loadKimiConfig, KIMI_THINKING_EFFORTS, FALLBACK_EFFORTS, } from '../../config/kimi-config.js';
+import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
+const PERMISSION_MODE_OPTIONS = [
+    { text: 'manual（逐项审批）', value: 'manual' },
+    { text: 'auto（引擎裁决）', value: 'auto' },
+    { text: 'yolo（全部放行）', value: 'yolo' },
+];
 export class KimiConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -9,6 +18,8 @@ export class KimiConfigBuilder {
         const kimiCfg = loadKimiConfig();
         const currentModel = displayConfig.agents?.kimi?.model ?? kimiCfg.currentModel;
         const currentThinking = displayConfig.agents?.kimi?.thinkingEffort ?? 'max';
+        const currentPermissionMode = displayConfig.agents?.kimi?.permissionMode ?? 'manual';
+        // §7: 现有 model + thinkingEffort select（顺序不变）
         fields.push({
             key: 'agents.kimi.model',
             label: '使用模型',
@@ -25,6 +36,22 @@ export class KimiConfigBuilder {
             options: (kimiCfg.modelEfforts[currentModel] ?? [...FALLBACK_EFFORTS]).filter((e) => KIMI_THINKING_EFFORTS.includes(e)),
             currentValue: currentThinking,
         });
+        // Permission mode + ACP sub-config (pure ACP: always shown)
+        // §7: 文案用官方名 + 中文注释
+        fields.push({
+            key: 'agents.kimi.permissionMode',
+            label: '权限模式',
+            type: 'select',
+            options: PERMISSION_MODE_OPTIONS,
+            currentValue: currentPermissionMode,
+        });
+        const currentTurnIdleTimeoutMinutes = displayConfig.agents?.kimi?.acp?.turnIdleTimeoutMinutes ?? DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
+        fields.push({
+            key: 'agents.kimi.acp.turnIdleTimeoutMinutes',
+            label: 'Turn 空闲超时(分钟, 0关闭)',
+            type: 'input',
+            currentValue: String(currentTurnIdleTimeoutMinutes),
+        });
         return fields;
     }
     handleFieldChange(key, value, config) {