lark-remote 0.4.1 → 0.4.3

package/dist/router/index.d.ts

@@ -8,6 +8,8 @@ interface CommandContext {
     userId: string;
     chatId: string;
     messageId: string;
+    /** 本轮（装配窗口）全部入站 messageId，`messageId` 是最后一条。见 BridgeContext 同名字段（§B8）。 */
+    turnMessageIds?: string[];
 }
 interface CommandResult {
     text?: string;
@@ -61,9 +63,19 @@ export interface CardActionPayload {
     agent?: string;
     /** /resume 列表页大小覆盖。 */
     pageSize?: number;
+    /**
+     * /ws 与 /ls 列表的关键词筛选（空/缺省 = 无筛选）。服务端零状态：只随卡片
+     * callback value 传递，且仅在非空时注入，旧卡片 payload 形态不变。
+     */
+    q?: string;
+    /**
+     * 「清除筛选」按钮标记。按钮 callback 不带 input_value，但显式标记比依赖
+     * 「读不到输入值」更稳（部分客户端可能把输入框残值一并回传）。
+     */
+    clearQuery?: boolean;
     option?: string;
     formValue?: Record<string, unknown>;
-    /** CardKit 2.0 input 组件自带提交图标触发回调时回传的输入值 */
+    /** CardKit 2.0 input 组件提交（键盘回车/完成键）时回传的输入值 */
     inputValue?: string;
     orderId?: string;
     /** Approval request ID for approval card actions. */
@@ -287,6 +299,14 @@ export declare class CommandRouter {
      * Handle ls.page: paginate to a specific offset.
      */
     private handleLsPage;
+    /**
+     * Handle ls.filter: 按搜索框提交的关键词重新渲染当前目录卡。
+     *
+     * offset 恒重置为 0（新筛选从第 1 页开始）。路径校验与 TOCTOU 兜底照
+     * handleLsPage——校验失败只回错误 toast，绝不动卡片（否则用户看到一张空卡）。
+     * ls.browse / ls.switch 的 value 里刻意不带 q，换目录即清除筛选（设计文档 §2.3）。
+     */
+    private handleLsFilter;
     /**
      * Handle resume.page: paginate the /resume session list in place.
      * Mirrors handleLsPage — updates the same card, never sends a new one.
@@ -331,11 +351,12 @@ export declare class CommandRouter {
     } | null;
     /**
      * W2.8 单源：重建 order/ws 列表卡（不投递，card 进 callback 响应体用）。
+     * `q` 只服务 ws 卡的关键词筛选；order 卡无此功能，不透传。
      */
     private rebuildListCard;
     /**
      * W2.8 单源：「重建列表卡 → updateCardInPlace」原地刷新骨架（列表卡删除/
-     * 翻页/移除/排序动作共用）。返回重建后的卡片；无卡时返回 undefined 且跳过更新。
+     * 翻页/移除/排序/筛选动作共用）。返回重建后的卡片；无卡时返回 undefined 且跳过更新。
      */
     private refreshListCard;
     /**
@@ -356,7 +377,7 @@ export declare class CommandRouter {
      */
     private handleOrderPage;
     /**
-     * Handle order.aliasEdit: 展示别名编辑卡（input + ✓ 提交图标）。
+     * Handle order.aliasEdit: 展示别名编辑卡（input，回车/完成键提交）。
      * 有别名时预填；提交 `order.aliasInput` 处理（含校验与唯一性）。
      */
     /**
@@ -373,7 +394,7 @@ export declare class CommandRouter {
     /** Handle order.aliasRemove: 删除某条指令的别名并原地重渲染列表卡。 */
     private handleOrderAliasRemove;
     /**
-     * Handle order.textEdit: 展示指令文本编辑卡（input + ✓ 提交图标）。
+     * Handle order.textEdit: 展示指令文本编辑卡（input，回车/完成键提交）。
      * 预填当前 text（完整内容，不截断——input 组件有自有滚动条）；
      * 提交 `order.textInput` 处理（trim + 长度校验 + OrderStore.updateText）。
      * 完全镜像 handleOrderAliasEdit 的 4 段结构（reload → find → 构造 editCard →
@@ -408,6 +429,11 @@ export declare class CommandRouter {
      * Mirrors handleOrderPage — updates the same card, never sends a new one.
      */
     private handleWsPage;
+    /**
+     * Handle ws.filter: 按搜索框提交的关键词重新渲染列表卡。
+     * offset 恒重置为 0（新筛选从第 1 页开始）；提交空串 = 清除筛选。
+     */
+    private handleWsFilter;
     /**
      * Handle ws.sort: toggle sort preference and refresh the /ws list card.
      * Sort preference is memory-only (not persisted); restart resets to 'recent'.
@@ -531,8 +557,10 @@ export declare class CommandRouter {
      * @param rootDir 浏览起点：卡片「返回」按钮回到这里。省略时默认 = 本次列出的
      *                目录（`/ls <dir>` 的起点即该目录），因此「返回」不会把用户
      *                丢回 workspace cwd（用户明确反馈过）。
+     * @param q       关键词筛选：只匹配**当前层**条目名（不递归），大小写不敏感。
+     *                省略/空 = 无筛选。
      */
-    cmdLs(args: string[], ctx: CommandContext, offset?: number, rootDir?: string): CommandResult;
+    cmdLs(args: string[], ctx: CommandContext, offset?: number, rootDir?: string, q?: string): CommandResult;
     /**
      * `/download <path>`（别名 `/d`）：把本地文件直接发送到飞书。
      *
@@ -547,7 +575,14 @@ export declare class CommandRouter {
      * 此前直接回 `ls: xxx: Not a directory` 把文件路径当成错误处理。
      */
     private buildFileCard;
-    private cmdWs;
+    /**
+     * `/ws` 实现（public：测试直接调用，替代 as unknown as，与 cmdLs 同款）。
+     *
+     * @param offset list 分支的分页起点（条目数）
+     * @param q      list 分支的关键词筛选：name 或完整 path 命中即保留，大小写
+     *               不敏感。省略/空 = 无筛选。
+     */
+    cmdWs(args: string[], ctx: CommandContext, offset?: number, q?: string): CommandResult;
     /**
      * L3: degraded card when a session's export is non-empty but unparseable
      * (truncated by opencode's pipe cap on huge sessions, or otherwise corrupt).