lark-remote 0.5.12 → 0.5.14

package/dist/router/config/claude.js

@@ -4,7 +4,8 @@
 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, CLAUDE_PERMISSION_MODES, } from '../../config/index.js';
+import { CLAUDE_EFFORTS, CLAUDE_PERMISSION_MODES, getModelOptionsFromSettings, } from '../../config/index.js';
+import { MODEL_ALIAS_TO_ID, MODEL_ID_TO_ALIAS } from '../../model-catalog.js';
 /** Claude 官方 --permission-mode 中文注释（value 走 CLAUDE_PERMISSION_MODES SSOT）。 */
 const PERMISSION_MODE_LABELS = {
     default: '默认（敏感操作逐项询问）',
@@ -81,9 +82,9 @@ export class ClaudeConfigBuilder {
             currentValue: currentEffort,
         });
         // 权限模式（取值见 CLAUDE_PERMISSION_MODES：除自造的 default 外都是 CLI 的
-        // --permission-mode 枚举；bypassPermissions 为 schema 默认，保持旧行为无审批卡，
-        // 配置为其他值后激活交互式审批）
-        const currentPermissionMode = displayConfig.claude?.permissionMode ?? 'bypassPermissions';
+        // --permission-mode 枚举；auto 为 schema 默认，低风险自动放行、高风险走审批，
+        // bypassPermissions 仍可在下拉中显式选择）
+        const currentPermissionMode = displayConfig.claude?.permissionMode ?? 'auto';
         // manual 不在下拉里：旧配置按 default 显示，避免打开卡片时该项空选
         const displayedPermissionMode = currentPermissionMode === 'manual' ? 'default' : currentPermissionMode;
         fields.push({

package/dist/router/config/codex.js

@@ -4,6 +4,7 @@
 import { loadCodexConfig, getReasoningEffortOptions, getDefaultReasoningEffort, } from '../../config/codex-config.js';
 import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
 import { pickMiddleValue, resetModelPatch } from './common/model-patch.js';
+import { turnIdleTimeoutField } from './common/turn-idle.js';
 export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -66,12 +67,7 @@ export class CodexConfigBuilder {
         });
         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),
-        });
+        fields.push(turnIdleTimeoutField('agents.codex.appServer.turnIdleTimeoutMinutes', currentTurnIdleTimeoutMinutes));
         return fields;
     }
     handleFieldChange(key, value, config) {

package/dist/router/config/common/render.d.ts

@@ -1,8 +1,12 @@
 /**
  * Shared config card rendering logic.
  *
- * Builds CardKit 2.0 elements for config fields (boolean toggle, select dropdown, input).
+ * Builds CardKit 2.0 elements for config fields (select dropdown, input, note).
  * Used by all agent config builders and the shared tabs (idle, logging).
+ *
+ * 控件形态只有 `ConfigField.type` 里那三种，且每种在本文件都有对应 builder：
+ * 渲染端与处理端（router 的 `config.set` / `config.input`）必须一一对应，
+ * 「渲染得出按钮、点了没人处理」是禁止状态（守卫见 config-card-controls.test.ts）。
  */
 import { type AppConfig } from '../../../config/index.js';
 import type { ConfigField } from '../types.js';

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

@@ -1,8 +1,12 @@
 /**
  * Shared config card rendering logic.
  *
- * Builds CardKit 2.0 elements for config fields (boolean toggle, select dropdown, input).
+ * Builds CardKit 2.0 elements for config fields (select dropdown, input, note).
  * Used by all agent config builders and the shared tabs (idle, logging).
+ *
+ * 控件形态只有 `ConfigField.type` 里那三种，且每种在本文件都有对应 builder：
+ * 渲染端与处理端（router 的 `config.set` / `config.input`）必须一一对应，
+ * 「渲染得出按钮、点了没人处理」是禁止状态（守卫见 config-card-controls.test.ts）。
  */
 import { getConfigValue } from '../../../config/index.js';
 import { cardButton } from '../../../card/card-shared.js';
@@ -12,12 +16,7 @@ function buildFieldElements(fields, displayConfig) {
     for (const field of fields) {
         // Get current value from displayConfig for dynamic fields
         const currentValue = getConfigValue(displayConfig, field.key);
-        if (field.type === 'boolean') {
-            // For boolean, use field.currentValue if set, otherwise use config value
-            const isOn = field.currentValue !== undefined ? field.currentValue === true : currentValue === true;
-            elements.push(buildBooleanElement(field, isOn));
-        }
-        else if (field.type === 'select' && field.options) {
+        if (field.type === 'select' && field.options) {
             elements.push(buildSelectElement(field, currentValue));
         }
         else if (field.type === 'note') {
@@ -53,12 +52,6 @@ function fieldRow(label, control) {
         ],
     };
 }
-function buildBooleanElement(field, isOn) {
-    const displayVal = isOn ? '✅ 已开启' : '⚪ 已关闭';
-    return fieldRow(field.label, cardButton(displayVal, { cmd: 'config.toggle', key: field.key }, {
-        type: isOn ? 'primary' : 'default',
-    }));
-}
 function buildSelectElement(field, currentValue) {
     // 优先使用 field.currentValue（卡片显示用覆盖值），否则使用 config 中的值
     const selectedValue = field.currentValue != null

package/dist/router/config/common/turn-idle.d.ts

@@ -0,0 +1,2 @@
+import type { ConfigField } from '../types.js';
+export declare function turnIdleTimeoutField(key: string, currentMinutes: number): ConfigField;

package/dist/router/config/common/turn-idle.js

@@ -0,0 +1,9 @@
+export function turnIdleTimeoutField(key, currentMinutes) {
+    return {
+        key,
+        label: 'Turn 空闲超时(分钟, 0关闭)',
+        type: 'input',
+        currentValue: String(currentMinutes),
+    };
+}
+//# sourceMappingURL=turn-idle.js.map

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

@@ -17,7 +17,7 @@
  */
 import type { AgentConfigCardBuilder, ConfigField } from './types.js';
 import { type AppConfig } from '../../config/index.js';
-import type { DshModelCatalogValue, DshPermissionCatalogValue, DshPresetListValue } from '../../runner/dsh/types.js';
+import type { DshModelCatalogValue, DshPermissionCatalogValue, DshPresetListValue } from '../../dsh/types.js';
 /** DshConfigBuilder 预取只依赖的 client 方法子集。 */
 export interface DshCatalogClient {
     listModels(): Promise<DshModelCatalogValue>;

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

@@ -4,7 +4,7 @@
  * Each agent implements AgentConfigCardBuilder in its own file.
  * Adding a new agent = add a file + register here (no upstream changes needed).
  */
-import type { AgentKind } from '../../runner/types.js';
+import type { AgentKind } from '../../agent-kinds.js';
 import type { AgentConfigCardBuilder } from './types.js';
 /**
  * 首次启动默认展示的 Coding Agent 顺序：Codex → Claude → OpenCode → Pi → Kimi → DSH。

package/dist/router/config/kimi.js

@@ -7,6 +7,7 @@
 import { loadKimiConfig, KIMI_THINKING_EFFORTS, FALLBACK_EFFORTS, } from '../../config/kimi-config.js';
 import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
 import { pickMiddleValue } from './common/model-patch.js';
+import { turnIdleTimeoutField } from './common/turn-idle.js';
 const PERMISSION_MODE_OPTIONS = [
     // kimi 0.40.0（2026-09-02）起官方语义：manual=始终询问 / yolo=必要时询问 / auto=完全自动
     { text: 'manual（始终询问）', value: 'manual' },
@@ -48,12 +49,7 @@ export class KimiConfigBuilder {
             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),
-        });
+        fields.push(turnIdleTimeoutField('agents.kimi.acp.turnIdleTimeoutMinutes', currentTurnIdleTimeoutMinutes));
         return fields;
     }
     handleFieldChange(key, value, config) {

package/dist/router/config/opencode.js

@@ -4,6 +4,7 @@
 import { loadOpencodeConfig } from '../../config/opencode-config.js';
 import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
 import { resetModelPatch } from './common/model-patch.js';
+import { turnIdleTimeoutField } from './common/turn-idle.js';
 const MODE_OPTIONS = [
     { text: 'build（默认，按 opencode 权限配置）', value: 'build' },
     { text: 'plan（规划模式）', value: 'plan' },
@@ -52,12 +53,7 @@ export class OpencodeConfigBuilder {
         // binary/requestTimeoutMs/idleTtlMs 为 YAML-only 工程参数）
         const currentTurnIdleTimeoutMinutes = displayConfig.agents?.opencode?.acp?.turnIdleTimeoutMinutes ??
             DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
-        fields.push({
-            key: 'agents.opencode.acp.turnIdleTimeoutMinutes',
-            label: 'Turn 空闲超时(分钟, 0关闭)',
-            type: 'input',
-            currentValue: String(currentTurnIdleTimeoutMinutes),
-        });
+        fields.push(turnIdleTimeoutField('agents.opencode.acp.turnIdleTimeoutMinutes', currentTurnIdleTimeoutMinutes));
         return fields;
     }
     handleFieldChange(key, value, config) {

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

@@ -16,13 +16,21 @@ export interface SelectOption {
 export interface ConfigField {
     key: string;
     label: string;
-    type: 'boolean' | 'select' | 'input' | 'note';
+    /**
+     * 卡片上真实存在的控件形态，每种都在 `common/render.ts` 有对应 builder：
+     * select=下拉、input=文本框、note=纯说明行（无回调）。
+     *
+     * 没有 boolean：卡片曾留着一套「开关」控件（`config.toggle`），但全仓没有
+     * 任何字段声明它，2026-10-27 成套删除。原则是**卡片只放配得了的控件**，
+     * 实现细节与未上卡的键走 YAML（见 `buildConfigCard` 的分 tab 注释）。
+     */
+    type: 'select' | 'input' | 'note';
     /** For select type: the list of options shown in the dropdown.
      *  Accepts plain strings (text=value) or {text, value} objects for
      *  display-value separation (e.g. 'manual（逐项审批）' → value 'manual'). */
     options?: readonly (string | SelectOption)[];
     /** Override the currentValue shown in the card (takes priority over getConfigValue). */
-    currentValue?: string | boolean;
+    currentValue?: string;
 }
 /**
  * Builder that provides config fields and handles field changes for a specific agent.
@@ -40,7 +48,7 @@ export interface AgentConfigCardBuilder {
      * Handle a field change for this agent.
      *
      * @param key   - The field key (e.g. 'agents.codex.modelProvider')
-     * @param value - The new value (string for select/input, already toggled for boolean)
+     * @param value - The new value (string for select/input)
      * @param config - The current pendingConfig (read-only reference for deriving dependent values)
      * @returns An array of {key, value} patches to apply to pendingConfig.
      *          The caller (router) applies these via setNestedValue.

package/dist/router/index.d.ts

@@ -4,6 +4,18 @@ import type { Bridge, CommandContext, CommandResult } from '../bridge/index.js';
 import type { AgentBinding } from '../bridge/queue-manager.js';
 import type { CloneSession } from '../clone.js';
 import { type VersionCheckResult, type InstallResult } from '../update/index.js';
+/** /resume 列表页内全量预取（readSessionContent）的行数上限；其余行用轻量 summary 兜底。 */
+/**
+ * Reader summary 占位符（trim 后匹配）。各 reader 在"无 user 消息"时返回的
+ * 兜底文案不同（claude/pi `(无摘要)`、codex `(no user message)`、kimi
+ * `New Session`、空串），都不是真实输入，不得渲染成行标题。
+ */
+/**
+ * 列表卡单行预览：压平空白、去掉反引号，再按字符截断。
+ *
+ * 为什么去反引号：agent 的输出里 `code` 很常见，截断点落在一对反引号中间时
+ * 后半张卡片的 markdown 会被当成代码块渲染（lark_md 不闭合就不回退）。
+ */
 /**
  * Card-action commands that must run with enqueue({ immediate: true }).
  * These bypass the serial queue and execute immediately.
@@ -125,12 +137,6 @@ export declare const SESSION_MUTATING_ACTION_CMDS: ReadonlySet<string>;
  */
 export declare const COMPACT_ACTION_CMDS: ReadonlySet<string>;
 export declare class CommandRouter {
-    /**
-     * Valid agent kinds — single source of truth for resume.use / resume.page /
-     * cmdResume. 名单本体在 `runner/types.ts` 的 AGENT_KINDS（与 AgentKind 类型
-     * 同源），这里只做别名，避免人手抄第二份。
-     */
-    static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi", "dsh"];
     private sessionStore;
     /** 飞书桥接实例（public：测试直接访问断言，替代 as unknown as）。 */
     bridge: Bridge;
@@ -203,8 +209,8 @@ export declare class CommandRouter {
     /**
      * 串行化 config.* 卡片回调（2026-07-04）。
      * CardKit 2.0 input/button 回调经 `enqueueImmediate` 分发，**不进串行队列**，
-     * 多次快速点击 toggle/input 会并发读写 `pendingConfig` 并同时调
-     * `updateCardInPlace` → Feishu API 乱序到达，导致 toggle 卡死在某个状态。
+     * 多次快速点击下拉/文本框会并发读写 `pendingConfig` 并同时调
+     * `updateCardInPlace` → Feishu API 乱序到达，控件卡死在某个状态。
      * 此 Promise chain 把所有 config.* 动作串成一个执行链，保证后到的动作
      * 等前一个动作的卡片 patch 完成后再读 `pendingConfig`。
      */
@@ -292,7 +298,37 @@ export declare class CommandRouter {
      * Handle queue.immediate: stop current run, clear queue before this message, execute this message immediately.
      * Instead of asking user to resend, we keep the target task in queue and let it execute.
      */
+    /**
+     * 把「执行编辑后的内容」注册成原队列槽位的一次性 replacement（复用入队时
+     * 捕获的 binding + 恢复 lane cwd，否则编辑后重跑的 run 会丢 cwd 与绑定）。
+     *
+     * 重新入队不行：`enqueue` 只能追加到 promise 链尾部，会把编辑任务甩到
+     * 后来者后面，违背「立即执行 = 下一个就跑」。三个调用点都必须在任何 await
+     * 之前注册——begin 路径消费 replacement 的时机不可预测（见
+     * handleQueueImmediate 步骤 1.5 的竞态说明）。
+     */
+    private registerEditedReplacement;
     private handleQueueImmediate;
+    /**
+     * 清掉排在目标之前的所有排队任务，返回实际清除条数。
+     *
+     * 两条红线：
+     * - 目标可能在 interruptCurrentRun 等待期间已经接跑（链并发前进），那时它已不在
+     *   快照里，剩下的全部排在它**后面**——清除必须在目标位置之前停下，不得越界删掉
+     *   用户没要求清除的任务。
+     * - 移除循环必须整体同步：队列链在任何 await 处都会推进（卡片 PATCH 也算），
+     *   一旦让出事件循环，用户要求清除的任务可能趁撤销卡还在路上就跑起来了。
+     *   撤销卡片由 `removeFromQueue` 统一触发（fire-and-forget）。
+     */
+    private clearTasksAheadOfTarget;
+    /**
+     * `queue.immediate` 的终态反馈（唯一出口）。
+     *
+     * 承诺必须与真实调度一致：目标只有确实是停止后的下一个，才可以把它的卡翻成
+     * 「执行中」并说「将立即执行」；在途接跑/被撤销/被抢先/远程停止未确认四种状态
+     * 各给各的文案（把没发生的事说成发生了，比沉默更糟——用户会据文案决定要不要重发）。
+     */
+    private reportImmediateOutcome;
     /**
      * Handle queue.diagnose: show diagnostic info for why message is queuing.
      */
@@ -502,6 +538,12 @@ export declare class CommandRouter {
      * 无 messageId 的调用（测试/文本路径）不登记。
      */
     private rememberConfigCard;
+    /**
+     * 把一次字段变更交给当前 agent 的 config builder（处理 provider→model 这类
+     * 依赖关系），逐条写进草稿，再把草稿刷到所有配置卡。
+     * `config.set`（下拉）与 `config.input`（输入框提交）共用同一套应用逻辑。
+     */
+    private applyConfigFieldChange;
     /**
      * 把当前草稿刷到所有已知 config 卡片上（含本次点击的那张）。
      *
@@ -511,12 +553,12 @@ export declare class CommandRouter {
      */
     private refreshConfigCards;
     /**
-     * 串行化 config.* 卡片回调（2026-07-04 修复 toggle 卡死 bug）。
+     * 串行化 config.* 卡片回调（2026-07-04 修复连击卡死 bug）。
      *
      * CardKit 2.0 input/button 回调经 `enqueueImmediate` 分发，不进 bridge 的
-     * 串行队列；多次快速点击 toggle 会并发读写 `pendingConfig` 并同时调
+     * 串行队列；多次快速点击下拉/文本框会并发读写 `pendingConfig` 并同时调
      * `updateCardInPlace` → 两个 patch 请求乱序到达飞书，后到达的 patch（点击 1
-     * 的旧卡片）覆盖先到达的 patch（点击 2 的新卡片），用户看到 toggle 卡死。
+     * 的旧卡片）覆盖先到达的 patch（点击 2 的新卡片），用户看到控件卡死。
      *
      * 此方法把所有 config.* 动作串成一个 Promise chain：每个动作等前一个动作
      * 的 `updateCardInPlace` 完全 settle 后再读 `pendingConfig`。
@@ -606,7 +648,6 @@ export declare class CommandRouter {
      * - new-session: when requested (always shown on resume cards).
      */
     private buildResumeActionButtons;
-    private static readonly LS_PAGE_SIZE;
     /**
      * `/ls` 实现（public：测试直接调用，替代 as unknown as）。
      *
@@ -626,20 +667,6 @@ export declare class CommandRouter {
      * 必须给绝对路径）。成功时文件本身即回复，返回 null（不额外发文本）。
      */
     cmdDownload(args: string[], ctx: CommandContext): Promise<CommandResult | null>;
-    /**
-     * 单文件 ls 结果卡：路径 / 大小 / 修改时间 + 「下载」+「上级」。
-     *
-     * `/ls <file>` 命中普通文件时使用——用户可能想下载该文件或确认它是否存在，
-     * 此前直接回 `ls: xxx: Not a directory` 把文件路径当成错误处理。
-     */
-    private buildFileCard;
-    /**
-     * `/ws` 实现（public：测试直接调用，替代 as unknown as，与 cmdLs 同款）。
-     *
-     * @param offset list 分支的分页起点（条目数）
-     * @param q      list 分支的关键词筛选：name 或完整 path 命中即保留，大小写
-     *               不敏感。省略/空 = 无筛选。
-     */
     cmdWs(args: string[], ctx: CommandContext, offset?: number, q?: string): CommandResult;
     /**
      * DSH /resume preset 一致性校验：返回 mismatch 详情，或 undefined（一致/不可判定）。
@@ -667,13 +694,8 @@ export declare class CommandRouter {
     private prefetchConfigCardCatalogs;
     /** Build an interactive config card with CardKit 2.0 tabs + batch save */
     buildConfigCard(): CommandResult;
-    /** /order 实现（public：测试直接调用，替代 as unknown as）。 */
-    cmdOrder(args: string[], _ctx: CommandContext, offset?: number): CommandResult;
-    /** /order alias add：按 orderId 或列表序号（1 基）解析目标指令并绑定别名。 */
-    private cmdOrderAliasAdd;
-    /** /order alias rm：按 orderId 或列表序号（1 基）移除指令的别名。 */
-    private cmdOrderAliasRemove;
-    /** 将 `/order alias add|rm` 的目标解析为 order：优先 orderId 精确匹配，回退列表序号（1 基）。 */
+    /** /order 实现（public：测试直接调用）。 */
+    cmdOrder(args: string[], ctx: CommandContext, offset?: number): CommandResult;
     private resolveOrderTarget;
 }
 export {};