lark-remote 0.5.13 → 0.5.15

package/dist/router/index.d.ts

@@ -137,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;
@@ -215,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`。
      */
@@ -304,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.
      */
@@ -514,6 +538,12 @@ export declare class CommandRouter {
      * 无 messageId 的调用（测试/文本路径）不登记。
      */
     private rememberConfigCard;
+    /**
+     * 把一次字段变更交给当前 agent 的 config builder（处理 provider→model 这类
+     * 依赖关系），逐条写进草稿，再把草稿刷到所有配置卡。
+     * `config.set`（下拉）与 `config.input`（输入框提交）共用同一套应用逻辑。
+     */
+    private applyConfigFieldChange;
     /**
      * 把当前草稿刷到所有已知 config 卡片上（含本次点击的那张）。
      *
@@ -523,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`。