botmux 2.47.0 → 2.47.2

package/dist/im/lark/ask-card.d.ts

@@ -0,0 +1,55 @@
+import type { AskCardDispatcher, AskResult, PendingAsk } from '../../core/ask-types.js';
+import { replyMessage, sendMessage, updateMessage } from './client.js';
+/** 旧单选即答动作（保留兼容旧卡片回调；Task 5 新增 ask_submit 路径）。 */
+export declare const ASK_SELECT_ACTION = "ask_select";
+/** 新多问 Submit 动作（form 内提交按钮携带此 action）。 */
+export declare const ASK_SUBMIT_ACTION = "ask_submit";
+/** 累积勾选动作。飞书会 silent-drop form + select_static，所以 v0.1.8 用按钮态。 */
+export declare const ASK_TOGGLE_ACTION = "ask_toggle";
+export interface AskCardActionData {
+    operator?: {
+        open_id?: string;
+    };
+    action?: {
+        value?: Record<string, unknown>;
+        form_value?: Record<string, unknown>;
+    };
+}
+export interface AskCardDispatcherDeps {
+    sendMessage?: typeof sendMessage;
+    replyMessage?: typeof replyMessage;
+    updateMessage?: typeof updateMessage;
+}
+export declare function createLarkAskCardDispatcher(deps?: AskCardDispatcherDeps): AskCardDispatcher;
+export declare function isAskCardAction(action?: string): boolean;
+export declare function handleAskCardAction(data: AskCardActionData): Promise<{
+    toast: {
+        type: string;
+        content: string;
+    };
+} | Record<string, unknown> | undefined>;
+/**
+ * 构建 ask 卡片 JSON 字符串。
+ *
+ * 未 settle 时：
+ *   - 单问单选：每个选项一个按钮，点击即 settle（旧 ask_select 语义）
+ *   - 多问或多选：每个选项一个按钮用于累积勾选，最后用 Submit settle
+ *
+ * 注意：飞书服务端会 silent-drop `form` 内的 select_static / multi_select_static，
+ * 所以这里只使用稳定的 `action` + `button` 结构。
+ *
+ * 已 settle 时：渲染状态摘要，展示每问的选中标签（answered），或超时/失效信息。
+ */
+export declare function buildAskCard(ask: PendingAsk, result?: AskResult): string;
+/**
+ * 防御式解析 Lark form_value，将每个 q<i> 字段的编码选项解析为选中 key 数组。
+ *
+ * 字段值可能为：
+ *  - string[]（multi_select_static 多选）
+ *  - string（select_static 单选，或 comma/semicolon 分隔的字符串）
+ *
+ * 每个编码值格式为 `<questionIndex>::<key>`，只收集 prefix 匹配的条目并剥去前缀。
+ * 导出供单元测试直接调用。
+ */
+export declare function parseFormSelections(formValue: Record<string, unknown>, questionCount: number): string[][];
+//# sourceMappingURL=ask-card.d.ts.map

package/dist/im/lark/ask-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-card.d.ts","sourceRoot":"","sources":["../../../src/im/lark/ask-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,SAAS,EACT,UAAU,EACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvE,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IACnC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;CACtC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,GAAE,qBAA0B,GAC/B,iBAAiB,CAgCnB;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CA2C7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CA+FxE;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,EAAE,CAsBZ"}

package/dist/im/lark/ask-card.js

@@ -0,0 +1,328 @@
+import { getAskSnapshot, submitAsk, toggleAsk, tryResolveAsk } from '../../core/ask-broker.js';
+import { logger } from '../../utils/logger.js';
+import { replyMessage, sendMessage, updateMessage } from './client.js';
+/** 旧单选即答动作（保留兼容旧卡片回调；Task 5 新增 ask_submit 路径）。 */
+export const ASK_SELECT_ACTION = 'ask_select';
+/** 新多问 Submit 动作（form 内提交按钮携带此 action）。 */
+export const ASK_SUBMIT_ACTION = 'ask_submit';
+/** 累积勾选动作。飞书会 silent-drop form + select_static，所以 v0.1.8 用按钮态。 */
+export const ASK_TOGGLE_ACTION = 'ask_toggle';
+const MAX_BUTTONS_PER_ACTION_ROW = 4;
+export function createLarkAskCardDispatcher(deps = {}) {
+    const send = deps.sendMessage ?? sendMessage;
+    const reply = deps.replyMessage ?? replyMessage;
+    const update = deps.updateMessage ?? updateMessage;
+    return {
+        async send(ask) {
+            const cardJson = buildAskCard(ask);
+            // botmux 把 chat-scope session 的 routing anchor 也叫 rootMessageId,
+            // 但在 chat-scope 下它实际是 chat_id (oc_...) 而非 message_id (om_...).
+            // 飞书 /messages/{id}/reply 只接受 om_ — 用 oc_ 会 400 invalid message_id.
+            // 所以这里要按前缀判断是否真的能 reply.
+            const canReplyToRoot = typeof ask.rootMessageId === 'string' && ask.rootMessageId.startsWith('om_');
+            const messageId = canReplyToRoot
+                ? await reply(ask.larkAppId, ask.rootMessageId, cardJson, 'interactive', true)
+                : await send(ask.larkAppId, ask.chatId, cardJson, 'interactive');
+            return { messageId };
+        },
+        async onSettle(ask, result) {
+            if (!ask.cardMessageId)
+                return;
+            try {
+                await update(ask.larkAppId, ask.cardMessageId, buildAskCard(ask, result));
+            }
+            catch (err) {
+                logger.warn(`[ask:${ask.askId}] failed to patch settled card: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        },
+    };
+}
+export function isAskCardAction(action) {
+    return action === ASK_SELECT_ACTION || action === ASK_SUBMIT_ACTION || action === ASK_TOGGLE_ACTION;
+}
+export async function handleAskCardAction(data) {
+    const value = data.action?.value;
+    const action = asString(value?.action);
+    if (!isAskCardAction(action))
+        return undefined;
+    const askId = asString(value?.ask_id);
+    const nonce = asString(value?.nonce);
+    const by = data.operator?.open_id;
+    if (!askId || !nonce || !by) {
+        return staleToast();
+    }
+    // 旧单选即答路径：按钮直接携带 key，调用 tryResolveAsk（单问单选便捷封装）
+    if (action === ASK_SELECT_ACTION) {
+        const selected = asString(value?.key);
+        if (!selected)
+            return staleToast();
+        return toastForOutcome(tryResolveAsk({ askId, nonce, selected, by }));
+    }
+    if (action === ASK_TOGGLE_ACTION) {
+        const questionIndex = asNumber(value?.question_index);
+        const key = asString(value?.key);
+        if (!Number.isInteger(questionIndex) || !key)
+            return staleToast();
+        const outcome = toggleAsk({ askId, nonce, questionIndex, key, by });
+        if (outcome !== 'toggled')
+            return toastForOutcome(outcome);
+        const updated = getAskSnapshot(askId);
+        if (!updated)
+            return staleToast();
+        return JSON.parse(buildAskCard(updated));
+    }
+    // 新 Submit 路径：优先从按钮累积态提交；兼容旧 form_value 回调。
+    if (action === ASK_SUBMIT_ACTION) {
+        const formValue = data.action?.form_value ?? {};
+        if (Object.keys(formValue).length > 0) {
+            // 推断问题数量：找最大 qN 的 N+1
+            const questionCount = guessQuestionCount(formValue);
+            const selections = parseFormSelections(formValue, questionCount);
+            return toastForOutcome(submitAsk({ askId, nonce, by, selections }));
+        }
+        return toastForOutcome(submitAsk({ askId, nonce, by }));
+    }
+    return staleToast();
+}
+/**
+ * 构建 ask 卡片 JSON 字符串。
+ *
+ * 未 settle 时：
+ *   - 单问单选：每个选项一个按钮，点击即 settle（旧 ask_select 语义）
+ *   - 多问或多选：每个选项一个按钮用于累积勾选，最后用 Submit settle
+ *
+ * 注意：飞书服务端会 silent-drop `form` 内的 select_static / multi_select_static，
+ * 所以这里只使用稳定的 `action` + `button` 结构。
+ *
+ * 已 settle 时：渲染状态摘要，展示每问的选中标签（answered），或超时/失效信息。
+ */
+export function buildAskCard(ask, result) {
+    const deadline = new Date(ask.deadlineAt).toLocaleString('zh-CN');
+    const status = result ? settleStatus(result, ask) : undefined;
+    // 截止时间 + 可答复人 字段行（settled 与 unsettled 均展示）
+    const metaDiv = {
+        tag: 'div',
+        fields: [
+            { is_short: true, text: { tag: 'lark_md', content: `**截止**\n${escapeMd(deadline)}` } },
+            { is_short: true, text: { tag: 'lark_md', content: `**可答复**\n${escapeMd(approverSummary(ask))}` } },
+        ],
+    };
+    const elements = [metaDiv];
+    if (status) {
+        // 已 settle：展示状态摘要，无可交互组件
+        elements.push({ tag: 'hr' });
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: status },
+        });
+    }
+    else {
+        // 未 settle：只用 action/buttons，避免 form+select 被飞书服务端静默丢弃。
+        elements.push({ tag: 'hr' });
+        const requiresSubmit = ask.questions.length > 1 || ask.questions.some((q) => q.multiSelect);
+        const selections = ask.selections ?? ask.questions.map(() => []);
+        for (let i = 0; i < ask.questions.length; i++) {
+            const q = ask.questions[i];
+            // 问题标题
+            elements.push({
+                tag: 'div',
+                text: {
+                    tag: 'lark_md',
+                    content: `**问题 ${i + 1}**\n${escapeMd(truncate(q.prompt, 512))}`,
+                },
+            });
+            const selected = new Set(selections[i] ?? []);
+            const optionButtons = q.options.map((opt) => ({
+                tag: 'button',
+                text: {
+                    tag: 'plain_text',
+                    content: requiresSubmit ? optionLabel(q.multiSelect, selected.has(opt.key), opt.label) : opt.label,
+                },
+                type: selected.has(opt.key) ? 'primary' : 'default',
+                value: requiresSubmit
+                    ? {
+                        action: ASK_TOGGLE_ACTION,
+                        ask_id: ask.askId,
+                        nonce: ask.nonce,
+                        question_index: String(i),
+                        key: opt.key,
+                    }
+                    : {
+                        action: ASK_SELECT_ACTION,
+                        ask_id: ask.askId,
+                        nonce: ask.nonce,
+                        key: opt.key,
+                    },
+            }));
+            appendActionRows(elements, optionButtons);
+        }
+        if (requiresSubmit) {
+            elements.push({ tag: 'hr' });
+            elements.push({
+                tag: 'action',
+                actions: [
+                    {
+                        tag: 'button',
+                        text: { tag: 'plain_text', content: '提交' },
+                        type: 'primary',
+                        value: {
+                            action: ASK_SUBMIT_ACTION,
+                            ask_id: ask.askId,
+                            nonce: ask.nonce,
+                        },
+                    },
+                ],
+            });
+        }
+    }
+    return JSON.stringify({
+        config: { wide_screen_mode: true },
+        header: {
+            template: result ? templateForResult(result) : 'blue',
+            title: { tag: 'plain_text', content: result ? 'botmux ask 已结束' : 'botmux ask' },
+        },
+        elements,
+    });
+}
+/**
+ * 从 form_value 中推断问题数量（取最大 qN 索引 + 1，最少 1）。
+ */
+function guessQuestionCount(formValue) {
+    let max = -1;
+    for (const key of Object.keys(formValue)) {
+        const m = key.match(/^q(\d+)$/);
+        if (m) {
+            const idx = parseInt(m[1], 10);
+            if (idx > max)
+                max = idx;
+        }
+    }
+    return max >= 0 ? max + 1 : 1;
+}
+/**
+ * 防御式解析 Lark form_value，将每个 q<i> 字段的编码选项解析为选中 key 数组。
+ *
+ * 字段值可能为：
+ *  - string[]（multi_select_static 多选）
+ *  - string（select_static 单选，或 comma/semicolon 分隔的字符串）
+ *
+ * 每个编码值格式为 `<questionIndex>::<key>`，只收集 prefix 匹配的条目并剥去前缀。
+ * 导出供单元测试直接调用。
+ */
+export function parseFormSelections(formValue, questionCount) {
+    const result = [];
+    for (let i = 0; i < questionCount; i++) {
+        const raw = formValue[`q${i}`];
+        // 规范化为字符串数组
+        let tokens;
+        if (Array.isArray(raw)) {
+            tokens = raw.filter((v) => typeof v === 'string');
+        }
+        else if (typeof raw === 'string') {
+            // 逗号或分号分隔的备用格式
+            tokens = raw.split(/[,;]/).map((s) => s.trim()).filter(Boolean);
+        }
+        else {
+            tokens = [];
+        }
+        // 筛选出 prefix 匹配 `i::` 的 token，剥去前缀取 key
+        const prefix = `${i}::`;
+        const keys = tokens
+            .filter((t) => t.startsWith(prefix))
+            .map((t) => t.slice(prefix.length));
+        result.push(keys);
+    }
+    return result;
+}
+function toastForOutcome(outcome) {
+    switch (outcome) {
+        case 'accepted':
+            return undefined;
+        case 'unauthorized':
+            return { toast: { type: 'warning', content: '你没有权限回答这个 ask' } };
+        case 'already_settled':
+            return { toast: { type: 'info', content: '这个 ask 已经被回答或结束' } };
+        case 'stale':
+            return staleToast();
+        case 'toggled':
+            // 累积勾选，不弹 toast
+            return undefined;
+    }
+}
+function staleToast() {
+    return { toast: { type: 'warning', content: '⚠️ 此 ask 已失效' } };
+}
+/**
+ * 生成已结束状态的摘要文本。
+ *
+ * answered：遍历每个问题，把选中的 key 映射为 label 并渲染。
+ * timedOut / invalidated：展示对应说明。
+ */
+function settleStatus(result, ask) {
+    if (result.kind === 'answered') {
+        // 每问一行：问题N：<选中标签>
+        const lines = result.answers.map((keys, i) => {
+            const q = ask.questions[i];
+            if (!q)
+                return `问题${i + 1}：（无法解析）`;
+            const labels = keys.map((key) => q.options.find((o) => o.key === key)?.label ?? key);
+            return `问题${i + 1}：${labels.join(', ')}`;
+        });
+        const summary = lines.join('\n');
+        return `**已选择**\n${escapeMd(summary)}\n操作人：${escapeMd(short(result.by, 28))}`;
+    }
+    if (result.kind === 'timedOut') {
+        return '**超时未答**';
+    }
+    return `**已失效**\n${escapeMd(result.reason)}`;
+}
+function templateForResult(result) {
+    switch (result.kind) {
+        case 'answered': return 'green';
+        case 'timedOut': return 'orange';
+        case 'invalidated': return 'grey';
+    }
+}
+function approverSummary(ask) {
+    if (ask.approvers.size === 0)
+        return '无可用答复人';
+    const values = [...ask.approvers].map((id) => short(id, 18));
+    if (values.length <= 3)
+        return values.join(', ');
+    return `${values.slice(0, 3).join(', ')} +${values.length - 3}`;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function asNumber(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string' && value.trim() !== '')
+        return Number(value);
+    return Number.NaN;
+}
+function optionLabel(multiSelect, selected, label) {
+    if (multiSelect)
+        return `${selected ? '☑' : '☐'} ${label}`;
+    return `${selected ? '◉' : '○'} ${label}`;
+}
+function appendActionRows(elements, actions) {
+    for (let i = 0; i < actions.length; i += MAX_BUTTONS_PER_ACTION_ROW) {
+        elements.push({
+            tag: 'action',
+            actions: actions.slice(i, i + MAX_BUTTONS_PER_ACTION_ROW),
+        });
+    }
+}
+function truncate(s, maxChars) {
+    if (s.length <= maxChars)
+        return s || '（空）';
+    return `${s.slice(0, maxChars)}\n\n…（已截断）`;
+}
+function escapeMd(s) {
+    return s.replace(/[*_~`\[\]\\]/g, (c) => `\\${c}`);
+}
+function short(s, n) {
+    return s.length > n ? `${s.slice(0, n)}…` : s;
+}
+//# sourceMappingURL=ask-card.js.map

package/dist/im/lark/ask-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-card.js","sourceRoot":"","sources":["../../../src/im/lark/ask-card.ts"],"names":[],"mappings":"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"}

package/dist/im/lark/card-builder.d.ts

@@ -27,8 +27,39 @@ export declare function buildSessionCard(sessionId: string, rootId: string, term
  * Lark bridge so future replies route back into this topic.
  */
 export declare function buildSessionClosedCard(sessionId: string, rootId: string, title: string, cliId?: CliId, workingDir?: string, cliResumeCommand?: string | null, locale?: Locale): string;
-/** Truncate content to fit within MAX_CONTENT_BYTES, keeping the tail (most recent output). */
-export declare function truncateContent(content: string, locale?: Locale): string;
+/**
+ * Build a frozen-snapshot card to PATCH onto the source-chat streaming card
+ * after `/relay` moves the session elsewhere.
+ *
+ * Why this exists: a live streaming card carries action buttons (close /
+ * toggle display / get write link). Those buttons identify their session by
+ * `session_id` in the value payload, so clicking them after relay still
+ * reaches the now-relocated session — closing it, toggling its display
+ * mode, etc. — but the visible feedback all lands on the NEW card in the
+ * target chat, not this one. The source-chat card then looks like a "live
+ * console" while actually being a footgun. PATCH it to an inert snapshot
+ * so the user sees clearly it's historical.
+ *
+ * Last-frame rendering:
+ *   - imageKey present (session was in 'screenshot' / expanded mode at
+ *     relay time) → embed the same img element the live card had.
+ *     img_key is a Lark server resource independent of the card it lived
+ *     on, so the PATCHed card can still reference it.
+ *   - imageKey absent (hidden / collapsed mode) → render nothing extra.
+ *     The header + body notice already convey the state; raw tmux pane
+ *     text as a code-block is too long and noisy (王皓 caught this in
+ *     testing).
+ *
+ * No action buttons are rendered in either case.
+ */
+export declare function buildRelayedFrozenCard(title: string, cliId?: CliId, imageKey?: string, locale?: Locale): string;
+/**
+ * Truncate content to fit within `maxBytes`, keeping the tail (most recent
+ * output). Defaults to {@link MAX_CONTENT_BYTES}; callers that wrap the content
+ * in additional card JSON (e.g. the private snapshot's code fence) pass a
+ * tighter budget so the whole card stays under Feishu's ~109 KB hard limit.
+ */
+export declare function truncateContent(content: string, locale?: Locale, maxBytes?: number): string;
 /**
  * Build a Feishu streaming card that shows live terminal output + controls.
  * This card is PATCHed in-place as the CLI works.
@@ -40,7 +71,25 @@ export declare function truncateContent(content: string, locale?: Locale): strin
  * Quick-action buttons (Esc, ^C, Tab, Space, Enter, ←↑↓→, ½屏 ↑/↓) appear
  * whenever displayMode !== 'hidden'.
  */
-export declare function buildStreamingCard(sessionId: string, rootId: string, terminalUrl: string, title: string, screenContent: string, status: StreamStatus, cliId?: CliId, displayMode?: DisplayMode, cardNonce?: string, imageKey?: string, adoptMode?: boolean, showTakeover?: boolean, locale?: Locale, usageLimit?: CliUsageLimitState): string;
+export declare function buildStreamingCard(sessionId: string, rootId: string, terminalUrl: string, title: string, screenContent: string, status: StreamStatus, cliId?: CliId, displayMode?: DisplayMode, cardNonce?: string, imageKey?: string, adoptMode?: boolean, showTakeover?: boolean, locale?: Locale, usageLimit?: CliUsageLimitState, writableTerminalUrl?: string): string;
+/**
+ * Build a static "private snapshot" card for `/card` in private mode — sent via
+ * the ephemeral API to one user at a time. Unlike {@link buildStreamingCard} it
+ * is **never PATCH-updated** (ephemeral cards can't be), so it carries only a
+ * one-shot snapshot of the terminal screenshot plus three buttons:
+ *   • read-only "open terminal" link (a plain URL button — no callback);
+ *   • "get write link", whose callback DMs the writable link to the clicker;
+ *   • "close session", whose callback kills the session and (in private mode)
+ *     sends the "closed" card ephemeral to the owner audience too — so the
+ *     session title / CLI name / workingDir on it don't leak to the group.
+ * The last two have callbacks but neither patches THIS card (one DMs, the other
+ * sends a fresh card), so both work fine on an ephemeral card. Both are
+ * `canOperate`-gated in the handler — talk-only viewers who tap them are denied.
+ * The patch-driven controls (toggle/refresh/export/term keys) and the inline
+ * writable link are still omitted: those need to update this card, which
+ * ephemeral cards can't do.
+ */
+export declare function buildPrivateSnapshotCard(terminalUrl: string, title: string, status: StreamStatus, cliId: CliId | undefined, imageKey: string | undefined, screenContent: string, sessionId: string, rootId: string, locale?: Locale, usageLimit?: CliUsageLimitState): string;
 /**
  * Build a Feishu interactive card with a dropdown selector for projects.
  * Returns a JSON string suitable for msg_type: 'interactive'.
@@ -80,5 +129,61 @@ export declare function buildTuiPromptProcessingCard(selectedText: string, local
  * Build a resolved TUI prompt card — shows which option was selected.
  */
 export declare function buildTuiPromptResolvedCard(selectedText: string, locale?: Locale): string;
+export interface RelayPickerEntry {
+    sessionId: string;
+    /** Short human label for the source chat — chat name if resolvable, else chatId. */
+    chatLabel: string;
+    /** First-turn title or current-turn topic — already truncated by the caller. */
+    title: string;
+    /** Absolute working dir, displayed verbatim. */
+    workingDir?: string;
+    /** CLI identifier, used to render a friendly name. */
+    cliId?: CliId;
+    /** Last activity timestamp, used to render a relative duration. */
+    lastMessageAt?: number;
+    /** Source chat's conversational topology. Drives the type tag in the
+     *  picker. Caller supplies based on getChatNameAndMode lookup + the
+     *  session's own chatType for the p2p case. */
+    chatMode?: 'group' | 'topic' | 'p2p';
+}
+export interface RelayPickerState {
+    /** Currently selected sessionId, if any (drives the highlight + confirm button). */
+    selectedSessionId?: string;
+    /** Case-insensitive substring filter applied to title / chatLabel / workingDir. */
+    searchQuery?: string;
+    /** 0-indexed page within the filtered list. Clamped to valid range at render time. */
+    page?: number;
+}
+/**
+ * Card listing the operator's relayable sessions, paginated 5 per page with
+ * a search box at the top and a confirm button at the bottom. Layout:
+ *
+ *   ┌──────────────────────────────────────┐
+ *   │ 📋 选择要接力的会话                   │  header
+ *   ├──────────────────────────────────────┤
+ *   │ 🔍 [______________] [搜索]            │  form: input + submit button
+ *   ├──────────────────────────────────────┤
+ *   │  [interactive_container 1]            │  current page (≤5 cards),
+ *   │  [interactive_container 2]            │  each clickable for selection
+ *   │   ...                                 │
+ *   ├──────────────────────────────────────┤
+ *   │  [← 上一页]  1 / 4  [下一页 →]        │  paginator row
+ *   ├──────────────────────────────────────┤
+ *   │   [确认接力到本群]                    │  primary button (only when
+ *   │                                       │   a selected session is on
+ *   │                                       │   the current filtered set)
+ *   └──────────────────────────────────────┘
+ *
+ * State (search / page / selected) is propagated entirely via the value
+ * objects on each button and container — Lark cards are stateless, so any
+ * server-side re-render must reconstruct from what the click sent us.
+ * That's why every interactive value here carries `search`, `page`,
+ * `target_chat_id`, `root_id`.
+ *
+ * Note: typing into the search box without clicking 搜索 does NOT update
+ * the in-callback state — container/paginator clicks use whatever search
+ * was applied at card-render time. To apply a new filter, click 搜索.
+ */
+export declare function buildRelayPickerCard(entries: RelayPickerEntry[], targetChatId: string, targetRootMessageId: string, invokerOpenId: string, locale?: Locale, state?: RelayPickerState): string;
 export declare function buildAdoptSelectCard(sessions: AdoptableSession[], rootMessageId?: string, locale?: Locale): string;
 //# sourceMappingURL=card-builder.d.ts.map

package/dist/im/lark/card-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-builder.d.ts","sourceRoot":"","sources":["../../../src/im/lark/card-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"card-builder.d.ts","sourceRoot":"","sources":["../../../src/im/lark/card-builder.ts"],"names":[],"mappings":"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"}