lark-remote 0.5.12 → 0.5.14

package/dist/bridge/index.d.ts

@@ -4,7 +4,8 @@ import type { SessionReaderRegistry, SessionStore } from '../session/index.js';
 import type { AppConfig } from '../config/index.js';
 import { type RunCardChannel } from '../card/run-card-session.js';
 import { type RunTerminal } from '../card/run-state.js';
-import { type AgentKind, type StopOutcome } from '../runner/types.js';
+import type { AgentKind } from '../agent-kinds.js';
+import { type StopOutcome } from '../runner/types.js';
 import { QueueManager, type QueuedTask, type EnqueueOptions, type AgentBinding, type ExecutingInfo } from './queue-manager.js';
 import type { InboundMediaPayload } from '../connector/index.js';
 import type { MediaOutcome } from '../inbound/turn.js';
@@ -14,7 +15,7 @@ import type { MediaOutcome } from '../inbound/turn.js';
  * through it. Declared here so tests can satisfy it structurally without
  * `as unknown as` casts.
  */
-interface BridgeChannel extends RunCardChannel {
+export interface BridgeChannel extends RunCardChannel {
     sendWithRetry(chatId: string, input: {
         text: string;
     } | {
@@ -149,6 +150,8 @@ export declare class Bridge {
     private activeRuns;
     /** Approval coordinators keyed by runId. */
     private approvalCoordinators;
+    /** 审批卡动作的实现（只读上面那张表；见 approval-actions.ts）。 */
+    private approvalActions;
     /**
      * 最近若干次已完成的、runner 有 runCompact 的 run（cwd → runId → 记录）。
      * run 结束后 activeRuns 已清空，而终态卡上的 Compact 按钮只带 runId，
@@ -369,10 +372,16 @@ export declare class Bridge {
     private interruptActiveRun;
     /** Send a result message to the user (§7). Returns true on success, false on failure. */
     sendResult(result: CommandResult, ctx: CommandContext): Promise<boolean>;
+    /**
+     * Deliver a final answer that cannot fit in the run card. Plain text avoids
+     * markdown parser limits and preserves every character; sequence labels make
+     * multi-message delivery unambiguous.
+     */
+    private sendFinalAnswerOverflow;
     /**
      * Update an existing card in place (原地更新) instead of sending a new one.
      *
-     * Used by /config cardAction handlers (config.toggle/set/input/save) so the
+     * Used by /config cardAction handlers (config.set/input/save) so the
      * user sees the card refresh on the same message bubble rather than getting
      * a new card per click — same-message-bubble update pattern.
      *
@@ -462,6 +471,38 @@ export declare class Bridge {
      * 队列继续推进（否则一个挂死的 run 永久堵住后续消息）。
      */
     private startIdleWatchdog;
+    /**
+     * result 事件的 pre-init 守卫（§9.22）。
+     *
+     * Claude CLI `--resume` 会在 system.init 之前先吐一条**上一轮**的陈旧 result。
+     * 认了它就会过早置 sawResult / 抓错 usage / 让 run-state reducer 提前进入
+     * finalizing（reducer 用 sessionId===undefined 守卫，同一条红线）。本轮真正的
+     * result 在 system.init 之后才到。
+     *
+     * 例外：app-server runner（usageAuthority==='live'）的 init 是 runner 自己补发
+     * 的 synthetic init（2026-08-13 修复）。此分支保留为防御性兜底：live runner 若
+     * 在无 init 时发出 result（旧构建等），session 写回照常执行，但 sawResult 不置
+     * 真——卡片不会把半初始化的 run 当作已收尾。
+     *
+     * @param dropFromCard 该 result 是陈旧重放，不得进卡片（调用方 continue 跳过 push）
+     */
+    private observeResultEvent;
+    /**
+     * 审批三事件的派发（requested / resolved / view_updated）。
+     *
+     * coordinator 一 run 一个，首次 requested 时惰性建好并登记，`finally` 里统一
+     * onTurnEnded + 摘除。
+     */
+    private dispatchApprovalEvent;
+    /**
+     * 进程退出（for-await 自然结束）后的终态矩阵——它是本轮的唯一终态触发源。
+     *
+     * 1) finalizing（result 已收到）→ 三态映射 + usage meta
+     * 2) running（未收到 result）→ 错误路径；pre-init 终态优先当唯一线索
+     * 3) 已终态 + sawResult → 首终态不动，仅补 usage meta
+     * 4) 已终态且未收到 result（如 spawn 失败后 interrupted）→ 无 usage 可补，跳过
+     */
+    private finishRunAfterStream;
     /**
      * Step 2 of forwardToClaude: Run the agent and consume its event stream.
      * Handles idle watchdog, event processing, session sync, and state transitions.
@@ -488,45 +529,28 @@ export declare class Bridge {
      * find and return to this session without scrolling up.
      */
     private sendCompletionNotificationCard;
-    /**
-     * Resolve the ApprovalCoordinator for a run, or throw the standard
-     * "已结束" error. Shared preamble of all approval card-action handlers.
-     */
-    private withCoordinator;
-    /**
-     * Handle an approval response from a card button click.
-     * Routes to the ApprovalCoordinator for the given run.
-     */
+    /** 审批响应（卡片按钮）→ ApprovalCoordinator.submit。 */
     handleApprovalRespond(opts: {
         runId: string;
         requestId: number | string;
         decision: string;
         nonce: string;
     }): Promise<void>;
-    /**
-     * 计划审批修改意见（ExitPlanMode 输入框）：记录到 coordinator 并回流卡片。
-     * 「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
-     */
+    /** 计划审批修改意见（ExitPlanMode 输入框）→ coordinator.planFeedback。 */
     handleApprovalPlanFeedback(opts: {
         runId: string;
         requestId: number | string;
         text: string;
         nonce: string;
     }): Promise<void>;
-    /**
-     * Handle a permission toggle from a card button click.
-     * Routes to the ApprovalCoordinator for the given run.
-     */
+    /** 权限条目勾选（卡片按钮）→ coordinator.togglePerm。 */
     handleApprovalToggle(opts: {
         runId: string;
         requestId: number | string;
         permId: string;
         selected?: boolean;
     }): Promise<void>;
-    /**
-     * Claude AskUserQuestion 选项点击（单选即时提交 / 多选切换勾选）。
-     * 路由到 ApprovalCoordinator.toggleAnswer。
-     */
+    /** AskUserQuestion 选项点击 → coordinator.toggleAnswer。 */
     handleApprovalAnswer(opts: {
         runId: string;
         requestId: number | string;
@@ -534,20 +558,14 @@ export declare class Bridge {
         option: string;
         nonce: string;
     }): Promise<void>;
-    /**
-     * Claude AskUserQuestion 多选问题的「提交答案」按钮。
-     * 路由到 ApprovalCoordinator.submitAnswers。
-     */
+    /** AskUserQuestion 多选「提交答案」→ coordinator.submitAnswers。 */
     handleApprovalAnswerSubmit(opts: {
         runId: string;
         requestId: number | string;
         questionIndex: number;
         nonce: string;
     }): Promise<void>;
-    /**
-     * Claude AskUserQuestion 自定义答案（Other）：自由文本直接
-     * 作为该单选问题的答案提交。路由到 ApprovalCoordinator.answerCustom。
-     */
+    /** AskUserQuestion 自定义答案（Other）→ coordinator.answerCustom。 */
     handleApprovalAnswerCustom(opts: {
         runId: string;
         requestId: number | string;
@@ -555,11 +573,7 @@ export declare class Bridge {
         text: string;
         nonce: string;
     }): Promise<void>;
-    /**
-     * Codex AskUserQuestion 补充说明（user_note，2026-08-18 live 验证模型理解
-     * "user_note: <text>" 条目）：记录到 coordinator，随答案一起提交。
-     * 路由到 ApprovalCoordinator.answerNote。
-     */
+    /** AskUserQuestion 补充说明（user_note）→ coordinator.answerNote。 */
     handleApprovalAnswerNote(opts: {
         runId: string;
         requestId: number | string;
@@ -609,7 +623,7 @@ export declare class Bridge {
         runId?: string;
     }, ctx: CommandContext): Promise<void>;
     /**
-     * §5.3: kimi 压缩在途检测——reader 鸭子实现 `readCompactionState` 时，若
+     * §5.3: kimi 压缩在途检测——reader 实现契约的 `readCompactionState` 时，若
      * wire 状态机判定当前有未终结的压缩（最后一次 begin 无 terminal 记录），
      * 直接回文本「已有一次 Compact 正在进行」并返回 true（调用方不开卡、不发
      * session/prompt）。codex/claude 等 reader 无此方法 → 返回 false，行为不变。