lark-remote 0.1.12 → 0.2.0

package/dist/router/index.d.ts

@@ -51,6 +51,11 @@ export interface CardActionPayload {
     key?: string;
     /** /ls 与 /resume 列表分页起点（条目数）。 */
     offset?: number;
+    /**
+     * `/ls` 浏览起点（本次 `/ls <dir>` 指定的目录；省略时 = cwd）。
+     * 卡片上的「返回」按钮回到这里，而不是回到 workspace cwd。
+     */
+    root?: string;
     /** /resume 列表的 agent 类型。 */
     agent?: string;
     /** /resume 列表页大小覆盖。 */
@@ -89,6 +94,13 @@ interface CardActionResponse {
     };
     [key: string]: unknown;
 }
+/** 审批命令名清单（APPROVAL_ACTION_SPECS keys，handleCardAction 分发共用）。 */
+export declare const APPROVAL_ACTION_CMDS: readonly string[];
+/**
+ * 直返命令：点击后同步返回 toast 给飞书回调，不经队列。
+ * index.ts 控制层直返清单的唯一来源（勿在别处复制名单）。
+ */
+export declare const DIRECT_RETURN_CMDS: ReadonlySet<string>;
 export declare class CommandRouter {
     /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
     static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi", "dsh"];
@@ -203,6 +215,8 @@ export declare class CommandRouter {
      * Routes to the appropriate bridge method based on value.cmd.
      * Returns a toast response for immediate user feedback.
      */
+    /** queue.* 卡片动作通用守卫：workspace/messageId 缺失时回复错误并返回 null。 */
+    private queuePayloadOrReply;
     /** 答案类操作的统一失败反馈：重复投递（同一 nonce 第二次点击）是已生效的
      *  中性事件，报 error 会误导（首次点击实际已成功）。 */
     private answerFailureToast;
@@ -233,6 +247,12 @@ export declare class CommandRouter {
      * when the callback response has no `card` field).
      */
     private handleQueueInput;
+    /**
+     * 分页卡动作的 offset 解析：优先读取「跳转页码」输入框（paginationBar 内置
+     * 的 CardKit 2.0 input），未输入则回退 `payload.offset`（上一页/下一页按钮）。
+     * 非法页码返回 `{ error }`，调用方应回错误 toast 且不刷新卡片。
+     */
+    private pagingOffset;
     /**
      * Handle ls.switch: switch cwd to target directory after path validation.
      */
@@ -287,6 +307,23 @@ export declare class CommandRouter {
         orderText: string;
         internalKey: string;
     } | null;
+    /**
+     * W2.8 单源：重建 order/ws 列表卡（不投递，card 进 callback 响应体用）。
+     */
+    private rebuildListCard;
+    /**
+     * W2.8 单源：「重建列表卡 → updateCardInPlace」原地刷新骨架（列表卡删除/
+     * 翻页/移除/排序动作共用）。返回重建后的卡片；无卡时返回 undefined 且跳过更新。
+     */
+    private refreshListCard;
+    /**
+     * W2.8 单源：order 三个 input handler（aliasInput/aliasRemove/textInput）
+     * 的公共骨架——校验 orderId → reload+find → mutate → 成功后 toast + raw 卡。
+     * mutate 返回 error 时仅回 error toast，不重渲染。
+     * 注意：本 helper 只服务「toast + card 进响应体」语义（飞书需用响应体原地
+     * 替换 pre-click 编辑卡）；updateCardInPlace 原地刷新走 refreshListCard。
+     */
+    private mutateOrderAndRefreshCard;
     /**
      * Handle order.delete: remove the order and update card in place.
      */
@@ -300,6 +337,11 @@ export declare class CommandRouter {
      * Handle order.aliasEdit: 展示别名编辑卡（input + ✓ 提交图标）。
      * 有别名时预填；提交 `order.aliasInput` 处理（含校验与唯一性）。
      */
+    /**
+     * order 编辑卡公共骨架：payload 校验 → 查指令 → 构造 input 编辑卡 → 原地更新。
+     * handleOrderAliasEdit / handleOrderTextEdit 原先各持一份 ~90% 相同的 4 段结构。
+     */
+    private showOrderEditCard;
     private handleOrderAliasEdit;
     /**
      * Handle order.aliasInput: 提交别名（绑/改/解绑），随后重渲染 /order 列表卡。
@@ -353,6 +395,13 @@ export declare class CommandRouter {
      * `ls.file` card button: send file to Feishu, rejecting if > 30MB.
      */
     private cardLsFile;
+    /**
+     * 校验并发送本地文件到飞书（≤30MB）。成功返回 null（文件已发出），失败返回
+     * 错误 CommandResult 由调用方展示。
+     *
+     * `/download` 与 `ls.file` 卡片按钮共用，避免两处重复 30MB/存在性校验。
+     */
+    private deliverFileToFeishu;
     /** 确保 pendingConfig 已初始化（从当前 config 克隆） */
     ensurePendingConfig(): void;
     /**
@@ -373,11 +422,7 @@ export declare class CommandRouter {
     /** 设置嵌套属性值（仅修改内存对象，不写盘） */
     /** 在 pendingConfig 上按 dot-separated key 设置嵌套值（config 卡片编辑用）。 */
     setNestedValue(target: AppConfig, key: string, value: unknown): void;
-    /** 对比原始 config 与 pendingConfig，返回变化的 key→string 映射 */
-    /** config diff（public：测试直接调用，替代 as unknown as）。 */
     diffConfig(original: AppConfig, pending: AppConfig): Record<string, string | undefined>;
-    /** 递归收集差异 */
-    private collectDiff;
     /**
      * config 写盘后的运行时传播（P1-6：自 config.save 卡片路径抽出，卡片保存与
      * `/config <key> <value>` 文本直写两条路径共用）。
@@ -451,8 +496,30 @@ export declare class CommandRouter {
      */
     private buildResumeActionButtons;
     private static readonly LS_PAGE_SIZE;
-    /** /ls 实现（public：测试直接调用，替代 as unknown as）。 */
-    cmdLs(args: string[], ctx: CommandContext, offset?: number): CommandResult;
+    /**
+     * `/ls` 实现（public：测试直接调用，替代 as unknown as）。
+     *
+     * @param args    [] 列出 cwd；[path] 列出指定目录（或文件）
+     * @param offset  分页起点（条目数）
+     * @param rootDir 浏览起点：卡片「返回」按钮回到这里。省略时默认 = 本次列出的
+     *                目录（`/ls <dir>` 的起点即该目录），因此「返回」不会把用户
+     *                丢回 workspace cwd（用户明确反馈过）。
+     */
+    cmdLs(args: string[], ctx: CommandContext, offset?: number, rootDir?: string): CommandResult;
+    /**
+     * `/download <path>`（别名 `/d`）：把本地文件直接发送到飞书。
+     *
+     * 路径解析与 `/ls` 一致：`~` 展开到 home；相对路径基于当前 cwd（无 cwd 时
+     * 必须给绝对路径）。成功时文件本身即回复，返回 null（不额外发文本）。
+     */
+    cmdDownload(args: string[], ctx: CommandContext): Promise<CommandResult | null>;
+    /**
+     * 单文件 ls 结果卡：路径 / 大小 / 修改时间 + 「下载」+「上级」。
+     *
+     * `/ls <file>` 命中普通文件时使用——用户可能想下载该文件或确认它是否存在，
+     * 此前直接回 `ls: xxx: Not a directory` 把文件路径当成错误处理。
+     */
+    private buildFileCard;
     private cmdWs;
     /**
      * L3: degraded card when a session's export is non-empty but unparseable