pi-remote-feishu 0.1.0

package/dist/bridge/stream-renderer.js

@@ -0,0 +1,108 @@
+/**
+ * 订阅会话事件并把它们翻译成流式文本。
+ * 返回取消订阅函数。
+ *
+ * 细节：
+ * - 文本增量（text_delta）直接追加
+ * - 思考增量（thinking_delta）按 showThinking 配置处理：
+ *   hide 丢弃 / plain 原文输出 / quote 逐字符加 "> " 前缀（形成引用块）
+ * - 工具调用、压缩、重试等事件在 showToolEvents 开启时输出提示文字
+ */
+function createSessionEventForwarder(session, writer, config) {
+    /** 是否正处于思考块内（用于在切回正文时补换行） */
+    let inThinking = false;
+    /** 下一行是否需要在行首加 "> " 前缀 */
+    let needsQuotePrefix = true;
+    /** 结束思考块：返回补上的分隔空行 */
+    function closeThinking() {
+        if (!inThinking)
+            return "";
+        inThinking = false;
+        needsQuotePrefix = true;
+        return "\n\n";
+    }
+    return session.subscribe((event) => {
+        // ---- 助手消息相关事件 ----
+        if (event.type === "message_update") {
+            const messageEvent = event.assistantMessageEvent;
+            if (!messageEvent)
+                return;
+            if (messageEvent.type === "text_delta") {
+                // 正文增量：先关闭思考块再追加
+                void writer.append(closeThinking() + (messageEvent.delta ?? ""));
+            }
+            else if (messageEvent.type === "thinking_delta" && config.rendering.showThinking !== "hide") {
+                const delta = messageEvent.delta ?? "";
+                if (config.rendering.showThinking === "plain") {
+                    // 原文模式：直接输出思考内容
+                    void writer.append(delta);
+                    return;
+                }
+                // quote 模式：逐字符处理换行，保证每行都有 "> " 前缀（Markdown 引用块）
+                let output = "";
+                for (const character of delta) {
+                    if (needsQuotePrefix) {
+                        output += "> ";
+                        needsQuotePrefix = false;
+                    }
+                    output += character;
+                    if (character === "\n") {
+                        needsQuotePrefix = true;
+                    }
+                }
+                inThinking = true;
+                void writer.append(output);
+            }
+            else if (messageEvent.type === "error") {
+                void writer.append(`${closeThinking()}Model returned an error.`);
+            }
+            return;
+        }
+        // ---- 工具/系统事件：仅在 showToolEvents 开启时输出 ----
+        if (!config.rendering.showToolEvents)
+            return;
+        if (event.type === "tool_execution_start") {
+            void writer.append(`${closeThinking()}\nRunning tool: ${event.toolName ?? "unknown"}\n`);
+        }
+        else if (event.type === "tool_execution_update") {
+            void writer.append(`${closeThinking()}${String(event.partialResult ?? "")}`);
+        }
+        else if (event.type === "tool_execution_end") {
+            void writer.append(`${closeThinking()}${event.isError ? "Tool failed" : "Tool completed"}\n`);
+        }
+        else if (event.type === "compaction_start") {
+            void writer.append(`${closeThinking()}Compacting context...\n`);
+        }
+        else if (event.type === "compaction_end") {
+            void writer.append(`${closeThinking()}Compaction complete.\n`);
+        }
+        else if (event.type === "auto_retry_start") {
+            void writer.append(`${closeThinking()}Retrying (${event.attempt ?? "?"}/${event.maxAttempts ?? "?"})...\n`);
+        }
+        else if (event.type === "auto_retry_end") {
+            void writer.append(`${closeThinking()}${event.success ? "Retry succeeded" : "Retry failed"}\n`);
+        }
+    });
+}
+/**
+ * 运行一次 prompt 并渲染输出：
+ * - mode 为 text 时静默执行，不渲染
+ * - 其他模式通过 channel.streamMarkdown 创建流式消息，期间把会话事件
+ *   转发给 writer，消息发送完成后 Pi 侧会自动结束流
+ */
+export async function renderPromptStream(options) {
+    if (options.config.rendering.mode === "text") {
+        await options.runPrompt();
+        return;
+    }
+    await options.channel.streamMarkdown(options.chatId, async (writer) => {
+        const unsubscribe = createSessionEventForwarder(options.session, writer, options.config);
+        try {
+            await options.runPrompt();
+        }
+        finally {
+            unsubscribe();
+        }
+    }, options.replyTo ? { replyTo: options.replyTo } : undefined);
+}
+//# sourceMappingURL=stream-renderer.js.map

package/dist/bridge/stream-renderer.js.map

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

package/dist/bridge/ui-context.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
+/**
+ * 兑现一张待确认的权限卡片：
+ * 根据卡片按钮携带的 dialogId 找到等待中的 Promise，把用户选择传回去。
+ * 返回用户的选择（undefined 表示找不到对应弹窗）。
+ */
+export declare function resolvePermissionCardAction(value: Record<string, unknown>): string | undefined;
+/**
+ * 创建"飞书版"的 ExtensionUIContext：
+ * 把 Pi 的 ui.select / ui.confirm / notify 等 UI 能力桥接到飞书聊天。
+ *
+ * - select：发送一张"权限确认"卡片到当前聊天，等待用户在卡片上选择（可中止/超时）
+ * - confirm：复用 select，选项固定为 Yes/No
+ * - notify：往聊天发送一条普通文本消息
+ * - 其余编辑器/TUI 相关方法在飞书模式下为空实现或抛错
+ */
+export declare function createFeishuUIContext(): ExtensionUIContext;
+/** 根据卡片事件携带的 value，构建"权限已确认"的结果卡片 */
+export declare function buildResolvedPermissionCard(value: Record<string, unknown>): import("../types.js").JsonObject;

package/dist/bridge/ui-context.js

@@ -0,0 +1,150 @@
+import { randomUUID } from "node:crypto";
+import { buildPermissionCard, buildPermissionResultCard } from "../cards/permission.js";
+import { getFeishuContext } from "../feishu/context.js";
+/**
+ * 全局待确认弹窗表：dialogId -> 等待中的回调。
+ * Pi 侧 ui.select 发起一张权限卡片后，这里登记回调；
+ * 用户在飞书卡片上点击按钮触发 cardAction 时，由 resolvePermissionCardAction 兑现。
+ */
+const pendingDialogs = new Map();
+/**
+ * 兑现一张待确认的权限卡片：
+ * 根据卡片按钮携带的 dialogId 找到等待中的 Promise，把用户选择传回去。
+ * 返回用户的选择（undefined 表示找不到对应弹窗）。
+ */
+export function resolvePermissionCardAction(value) {
+    const dialogId = typeof value.dialogId === "string" ? value.dialogId : undefined;
+    if (!dialogId)
+        return undefined;
+    const pending = pendingDialogs.get(dialogId);
+    if (!pending)
+        return undefined;
+    pendingDialogs.delete(dialogId);
+    clearTimeout(pending.timer);
+    const choice = typeof value.choice === "string" ? value.choice : undefined;
+    pending.resolve(choice);
+    return choice;
+}
+/**
+ * 创建"飞书版"的 ExtensionUIContext：
+ * 把 Pi 的 ui.select / ui.confirm / notify 等 UI 能力桥接到飞书聊天。
+ *
+ * - select：发送一张"权限确认"卡片到当前聊天，等待用户在卡片上选择（可中止/超时）
+ * - confirm：复用 select，选项固定为 Yes/No
+ * - notify：往聊天发送一条普通文本消息
+ * - 其余编辑器/TUI 相关方法在飞书模式下为空实现或抛错
+ */
+export function createFeishuUIContext() {
+    return {
+        /**
+         * 在飞书聊天里发起一个选择：
+         * 发送权限卡片，等待卡片事件 -> 用户点击 -> resolvePermissionCardAction 兑现。
+         * 支持 opts.signal 中止和 opts.timeout 超时。
+         */
+        async select(title, options, opts) {
+            const context = getFeishuContext();
+            // 不在飞书请求上下文中（比如 TUI 环境），直接选第一个选项兜底
+            if (!context)
+                return options[0];
+            const dialogId = randomUUID();
+            const timeout = opts?.timeout ?? 60_000;
+            return await new Promise((resolve) => {
+                // 超时兜底：到时间还没人点就放弃
+                const timer = setTimeout(() => {
+                    pendingDialogs.delete(dialogId);
+                    resolve(undefined);
+                }, timeout);
+                pendingDialogs.set(dialogId, { resolve, timer });
+                // 支持外部中止信号
+                if (opts?.signal) {
+                    if (opts.signal.aborted) {
+                        pendingDialogs.delete(dialogId);
+                        clearTimeout(timer);
+                        resolve(undefined);
+                        return;
+                    }
+                    opts.signal.addEventListener("abort", () => {
+                        pendingDialogs.delete(dialogId);
+                        clearTimeout(timer);
+                        resolve(undefined);
+                    }, { once: true });
+                }
+                // 发送权限卡片到当前聊天；发送失败则直接放弃
+                context.channel.sendCard(context.chatId, buildPermissionCard(title, options, dialogId)).catch(() => {
+                    pendingDialogs.delete(dialogId);
+                    clearTimeout(timer);
+                    resolve(undefined);
+                });
+            });
+        },
+        /** 确认弹窗：复用 select，选项固定为 Yes / No */
+        async confirm(title, message, opts) {
+            const text = message ? `${title}\n\n${message}` : title;
+            const choice = await this.select(text, ["Yes", "No"], opts);
+            return choice === "Yes";
+        },
+        /** 飞书模式无法做交互式输入，返回 undefined */
+        async input() {
+            return undefined;
+        },
+        /** 往当前聊天发送一条通知文本（error/warning 会带前缀） */
+        notify(message, type) {
+            const context = getFeishuContext();
+            if (!context)
+                return;
+            const prefix = type === "error" ? "Error: " : type === "warning" ? "Warning: " : "";
+            context.channel.sendText(context.chatId, `${prefix}${message}`).catch(() => { });
+        },
+        /* ---------- 以下为编辑器/TUI 相关方法，飞书模式下不可用 ---------- */
+        onTerminalInput() {
+            return () => { };
+        },
+        setStatus() { },
+        setWorkingMessage() { },
+        setWorkingVisible() { },
+        setWorkingIndicator() { },
+        setHiddenThinkingLabel() { },
+        setWidget() { },
+        setFooter() { },
+        setHeader() { },
+        setTitle() { },
+        async custom() {
+            throw new Error("Custom UI is not available in Feishu mode");
+        },
+        pasteToEditor() { },
+        setEditorText() { },
+        getEditorText() {
+            return "";
+        },
+        async editor() {
+            return undefined;
+        },
+        addAutocompleteProvider() { },
+        setEditorComponent() { },
+        getEditorComponent() {
+            return undefined;
+        },
+        get theme() {
+            return {};
+        },
+        getAllThemes() {
+            return [];
+        },
+        getTheme() {
+            return undefined;
+        },
+        setTheme() {
+            return { success: false, error: "Themes are not available in Feishu mode" };
+        },
+        getToolsExpanded() {
+            return false;
+        },
+        setToolsExpanded() { },
+    };
+}
+/** 根据卡片事件携带的 value，构建"权限已确认"的结果卡片 */
+export function buildResolvedPermissionCard(value) {
+    const choice = resolvePermissionCardAction(value);
+    return buildPermissionResultCard(choice);
+}
+//# sourceMappingURL=ui-context.js.map

package/dist/bridge/ui-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-context.js","sourceRoot":"","sources":["../../src/bridge/ui-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQxD;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAA8B;IACxE,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL;;;;WAIG;QACH,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI;YAC/B,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACnC,mCAAmC;YACnC,IAAI,CAAC,OAAO;gBAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,MAAM,CAAC;YAExC,OAAO,MAAM,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;gBACvD,kBAAkB;gBAClB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAChC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC,EAAE,OAAO,CAAC,CAAC;gBAEZ,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAEjD,WAAW;gBACX,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;oBACjB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACxB,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;wBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,OAAO,CAAC,SAAS,CAAC,CAAC;wBACnB,OAAO;oBACT,CAAC;oBACD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAC1B,OAAO,EACP,GAAG,EAAE;wBACH,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;wBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,OAAO,CAAC,SAAS,CAAC,CAAC;oBACrB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;gBACJ,CAAC;gBAED,wBAAwB;gBACxB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACjG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAChC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,MAAM,KAAK,KAAK,CAAC;QAC1B,CAAC;QAED,gCAAgC;QAChC,KAAK,CAAC,KAAK;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,wCAAwC;QACxC,MAAM,CAAC,OAAO,EAAE,IAAI;YAClB,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,oDAAoD;QACpD,eAAe;YACb,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QACD,SAAS,KAAI,CAAC;QACd,iBAAiB,KAAI,CAAC;QACtB,iBAAiB,KAAI,CAAC;QACtB,mBAAmB,KAAI,CAAC;QACxB,sBAAsB,KAAI,CAAC;QAC3B,SAAS,KAAI,CAAC;QACd,SAAS,KAAI,CAAC;QACd,SAAS,KAAI,CAAC;QACd,QAAQ,KAAI,CAAC;QACb,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,aAAa,KAAI,CAAC;QAClB,aAAa,KAAI,CAAC;QAClB,aAAa;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,MAAM;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,uBAAuB,KAAI,CAAC;QAC5B,kBAAkB,KAAI,CAAC;QACvB,kBAAkB;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,EAAiC,CAAC;QAC3C,CAAC;QACD,YAAY;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,QAAQ;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,QAAQ;YACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;QAC9E,CAAC;QACD,gBAAgB;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QACD,gBAAgB,KAAI,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,2BAA2B,CAAC,KAA8B;IACxE,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/cards/common.d.ts

@@ -0,0 +1,33 @@
+import type { JsonObject } from "../types.js";
+/**
+ * ============================================================
+ * 飞书卡片构建公共组件
+ * ------------------------------------------------------------
+ * 提供一组小函数，用于按飞书卡片 JSON 结构组装：
+ * 文本块、注释块、按钮、按钮组、下拉菜单、整张卡片。
+ * 各 cards/*.ts 都基于这些函数构建具体卡片。
+ * ============================================================
+ */
+/** 卡片模板（决定头部颜色）：蓝 / 绿 / 红 / 黄 / 灰 */
+export type CardTemplate = "blue" | "green" | "red" | "yellow" | "grey";
+/** 普通文本块（支持 Markdown，tag: lark_md） */
+export declare function textBlock(content: string): JsonObject;
+/** 灰色注释文本块（通常用于辅助信息） */
+export declare function noteBlock(content: string): JsonObject;
+/**
+ * 按钮：点击后飞书会触发 cardAction 事件，value 字段原样带到事件里。
+ * value 里通常放 cmd（命令名）+ 相关参数（sessionKey、dialogId 等）。
+ */
+export declare function button(text: string, value: JsonObject, type?: "primary" | "default" | "danger"): JsonObject;
+/** 按钮组：把多个按钮排成一行 */
+export declare function actions(elements: JsonObject[]): JsonObject;
+/**
+ * 静态下拉菜单：value 同样会随 cardAction 事件带回。
+ * 第一个选项会设为 initial_option（默认选中）。
+ */
+export declare function selectMenu(placeholder: string, value: JsonObject, options: Array<{
+    text: string;
+    value: string;
+}>): JsonObject;
+/** 组装一张完整的飞书卡片：头部（标题+颜色模板）+ 元素列表 */
+export declare function card(title: string, template: CardTemplate, elements: JsonObject[]): JsonObject;

package/dist/cards/common.js

@@ -0,0 +1,84 @@
+/** 普通文本块（支持 Markdown，tag: lark_md） */
+export function textBlock(content) {
+    return {
+        tag: "div",
+        text: {
+            tag: "lark_md",
+            content,
+        },
+    };
+}
+/** 灰色注释文本块（通常用于辅助信息） */
+export function noteBlock(content) {
+    return textBlock(`<font color="grey">${content}</font>`);
+}
+/**
+ * 按钮：点击后飞书会触发 cardAction 事件，value 字段原样带到事件里。
+ * value 里通常放 cmd（命令名）+ 相关参数（sessionKey、dialogId 等）。
+ */
+export function button(text, value, type = "default") {
+    return {
+        tag: "button",
+        text: {
+            tag: "plain_text",
+            content: text,
+        },
+        type,
+        value,
+    };
+}
+/** 按钮组：把多个按钮排成一行 */
+export function actions(elements) {
+    return {
+        tag: "action",
+        actions: elements,
+    };
+}
+/**
+ * 静态下拉菜单：value 同样会随 cardAction 事件带回。
+ * 第一个选项会设为 initial_option（默认选中）。
+ */
+export function selectMenu(placeholder, value, options) {
+    const initialOption = options[0]
+        ? {
+            text: {
+                tag: "plain_text",
+                content: options[0].text,
+            },
+            value: options[0].value,
+        }
+        : undefined;
+    return {
+        tag: "select_static",
+        placeholder: {
+            tag: "plain_text",
+            content: placeholder,
+        },
+        ...(initialOption ? { initial_option: initialOption } : {}),
+        options: options.map((option) => ({
+            text: {
+                tag: "plain_text",
+                content: option.text,
+            },
+            value: option.value,
+        })),
+        value,
+    };
+}
+/** 组装一张完整的飞书卡片：头部（标题+颜色模板）+ 元素列表 */
+export function card(title, template, elements) {
+    return {
+        config: {
+            wide_screen_mode: true,
+        },
+        header: {
+            title: {
+                tag: "plain_text",
+                content: title,
+            },
+            template,
+        },
+        elements: elements,
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/cards/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/cards/common.ts"],"names":[],"mappings":"AAeA,sCAAsC;AACtC,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO;QACL,GAAG,EAAE,KAAK;QACV,IAAI,EAAE;YACJ,GAAG,EAAE,SAAS;YACd,OAAO;SACR;KACF,CAAC;AACJ,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,SAAS,CAAC,sBAAsB,OAAO,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAiB,EAAE,OAAyC,SAAS;IACxG,OAAO;QACL,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE;YACJ,GAAG,EAAE,YAAY;YACjB,OAAO,EAAE,IAAI;SACd;QACD,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,OAAO,CAAC,QAAsB;IAC5C,OAAO;QACL,GAAG,EAAE,QAAQ;QACb,OAAO,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,KAAiB,EAAE,OAA+C;IAChH,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC;YACE,IAAI,EAAE;gBACJ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;aACzB;YACD,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;SACxB;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,GAAG,EAAE,eAAe;QACpB,WAAW,EAAE;YACX,GAAG,EAAE,YAAY;YACjB,OAAO,EAAE,WAAW;SACrB;QACD,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE;gBACJ,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,MAAM,CAAC,IAAI;aACrB;YACD,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,KAAK;KACN,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,QAAsB,EAAE,QAAsB;IAChF,OAAO;QACL,MAAM,EAAE;YACN,gBAAgB,EAAE,IAAI;SACvB;QACD,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,KAAK;aACf;YACD,QAAQ;SACT;QACD,QAAQ,EAAE,QAAuB;KAClC,CAAC;AACJ,CAAC"}

package/dist/cards/help.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObject } from "../types.js";
+/**
+ * 帮助卡片（/help 命令触发）：
+ * 列出常用命令、文件能力，以及当前聊天类型/会话模式的说明。
+ */
+export declare function buildHelpCard(options: {
+    botName: string;
+    chatType: "private" | "group";
+    sessionMode: string;
+    requireMention: boolean;
+}): JsonObject;

package/dist/cards/help.js

@@ -0,0 +1,31 @@
+import { card, noteBlock, textBlock } from "./common.js";
+/**
+ * 帮助卡片（/help 命令触发）：
+ * 列出常用命令、文件能力，以及当前聊天类型/会话模式的说明。
+ */
+export function buildHelpCard(options) {
+    return card(`${options.botName} 使用帮助`, "blue", [
+        textBlock([
+            "**常用命令**",
+            "`/help` 查看帮助",
+            "`/sessions` 管理当前会话",
+            "`/models` 选择模型和思考等级",
+            "`/new` 新建 Pi 会话",
+            "`/stop` 停止当前生成",
+            "`/reset` 重置当前映射",
+            "`/status` 查看运行状态",
+        ].join("\n")),
+        textBlock([
+            "**文件能力**",
+            "你让我生成文件时，Pi 可以通过 `send_file_to_chat` 把本地结果发回当前飞书聊天。",
+        ].join("\n")),
+        noteBlock([
+            `聊天类型：${options.chatType === "group" ? "群聊" : "私聊"}`,
+            `会话模式：${options.sessionMode}`,
+            options.chatType === "group" && options.requireMention ? "群聊默认需要 @机器人 才会响应。" : "",
+        ]
+            .filter((line) => line.length > 0)
+            .join("\n")),
+    ]);
+}
+//# sourceMappingURL=help.js.map

package/dist/cards/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cards/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAK7B;IACC,OAAO,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,OAAO,EAAE,MAAM,EAAE;QAC7C,SAAS,CACP;YACE,UAAU;YACV,cAAc;YACd,oBAAoB;YACpB,qBAAqB;YACrB,iBAAiB;YACjB,gBAAgB;YAChB,iBAAiB;YACjB,kBAAkB;SACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;QACD,SAAS,CACP;YACE,UAAU;YACV,qDAAqD;SACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;QACD,SAAS,CACP;YACE,QAAQ,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YACpD,QAAQ,OAAO,CAAC,WAAW,EAAE;YAC7B,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;SAClF;aACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aACjC,IAAI,CAAC,IAAI,CAAC,CACd;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/cards/models.d.ts

@@ -0,0 +1,24 @@
+import type { JsonObject } from "../types.js";
+/** 模型卡片的单条模型信息（展示 + 切换用） */
+export interface ModelCardEntry {
+    provider: string;
+    id: string;
+    name?: string;
+    /** 是否支持 thinking */
+    thinking?: boolean;
+}
+/**
+ * 模型选择卡片（/models 命令触发）：
+ * 展示当前模型，并列出可用模型，每个模型配"使用"（普通）和"高思考"（high thinking）两个按钮。
+ * 按钮点击后由 card-actions 的 cmd: "model" 分支处理。
+ */
+export declare function buildModelsCard(options: {
+    sessionKey: string;
+    current?: {
+        provider: string;
+        id: string;
+        thinkingLevel?: string;
+    };
+    models: ModelCardEntry[];
+    sessionMode: string;
+}): JsonObject;

package/dist/cards/models.js

@@ -0,0 +1,46 @@
+import { actions, button, card, noteBlock, textBlock } from "./common.js";
+/**
+ * 模型选择卡片（/models 命令触发）：
+ * 展示当前模型，并列出可用模型，每个模型配"使用"（普通）和"高思考"（high thinking）两个按钮。
+ * 按钮点击后由 card-actions 的 cmd: "model" 分支处理。
+ */
+export function buildModelsCard(options) {
+    const current = options.current
+        ? `${options.current.provider}/${options.current.id} (${options.current.thinkingLevel ?? "default"})`
+        : "未选择";
+    const elements = [
+        textBlock([`**当前模型**`, `\`${current}\``, `会话：\`${options.sessionKey}\``, `模式：${options.sessionMode}`].join("\n")),
+    ];
+    // 没有可用模型时的提示
+    if (options.models.length === 0) {
+        elements.push(noteBlock("当前没有可用模型。请先检查 Pi 的模型配置。"));
+    }
+    // 最多展示 20 个模型
+    for (const model of options.models.slice(0, 20)) {
+        const label = model.name ?? model.id;
+        elements.push(textBlock([`**${label}**`, `\`${model.provider}/${model.id}\``, model.thinking ? "支持 thinking" : ""].filter(Boolean).join("\n")));
+        elements.push(actions([
+            button("使用", {
+                cmd: "model",
+                action: "select",
+                sessionKey: options.sessionKey,
+                provider: model.provider,
+                modelId: model.id,
+                thinkingLevel: "off",
+            }, "primary"),
+            button("高思考", {
+                cmd: "model",
+                action: "select",
+                sessionKey: options.sessionKey,
+                provider: model.provider,
+                modelId: model.id,
+                thinkingLevel: "high",
+            }),
+        ]));
+    }
+    if (options.models.length > 20) {
+        elements.push(noteBlock(`只展示前 20 个模型，共 ${options.models.length} 个。`));
+    }
+    return card("Pi 模型选择", "blue", elements);
+}
+//# sourceMappingURL=models.js.map

package/dist/cards/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/cards/models.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW1E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAK/B;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;QAC7B,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS,GAAG;QACrG,CAAC,CAAC,KAAK,CAAC;IACV,MAAM,QAAQ,GAAiB;QAC7B,SAAS,CAAC,CAAC,UAAU,EAAE,KAAK,OAAO,IAAI,EAAE,QAAQ,OAAO,CAAC,UAAU,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClH,CAAC;IAEF,aAAa;IACb,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,cAAc;IACd,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChJ,QAAQ,CAAC,IAAI,CACX,OAAO,CAAC;YACN,MAAM,CACJ,IAAI,EACJ;gBACE,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,aAAa,EAAE,KAAK;aACrB,EACD,SAAS,CACV;YACD,MAAM,CACJ,KAAK,EACL;gBACE,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,aAAa,EAAE,MAAM;aACtB,CACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/cards/permission.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject } from "../types.js";
+/**
+ * 权限确认卡片：Pi 的 ui.select 在飞书上的呈现。
+ * 每个选项生成一个按钮，按钮 value 携带 dialogId 和该选项，
+ * 用户点击后由 card-actions 的 cmd: "permission" 分支兑现等待中的 Promise。
+ */
+export declare function buildPermissionCard(title: string, options: string[], dialogId: string): JsonObject;
+/** 权限确认完成后的结果卡片（展示用户选择了什么） */
+export declare function buildPermissionResultCard(choice: string | undefined): JsonObject;

package/dist/cards/permission.js

@@ -0,0 +1,17 @@
+import { actions, button, card, textBlock } from "./common.js";
+/**
+ * 权限确认卡片：Pi 的 ui.select 在飞书上的呈现。
+ * 每个选项生成一个按钮，按钮 value 携带 dialogId 和该选项，
+ * 用户点击后由 card-actions 的 cmd: "permission" 分支兑现等待中的 Promise。
+ */
+export function buildPermissionCard(title, options, dialogId) {
+    return card("Permission required", "red", [
+        textBlock(title),
+        actions(options.map((option, index) => button(option, { cmd: "permission", dialogId, choice: option }, index === 0 ? "primary" : "default"))),
+    ]);
+}
+/** 权限确认完成后的结果卡片（展示用户选择了什么） */
+export function buildPermissionResultCard(choice) {
+    return card("Permission resolved", "grey", [textBlock(choice ? `Selected: **${choice}**` : "No selection.")]);
+}
+//# sourceMappingURL=permission.js.map

package/dist/cards/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../../src/cards/permission.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,OAAiB,EAAE,QAAgB;IACpF,OAAO,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE;QACxC,SAAS,CAAC,KAAK,CAAC;QAChB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAC5B,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CACrG,CACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,yBAAyB,CAAC,MAA0B;IAClE,OAAO,IAAI,CAAC,qBAAqB,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AAChH,CAAC"}

package/dist/cards/sessions.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObject, SessionMapping } from "../types.js";
+/**
+ * 会话管理卡片（/sessions 命令触发）：
+ * 展示"新建会话"按钮，以及最多 10 条持久化的历史会话；
+ * 每个历史会话有"切换"和"删除"按钮，点击后由 card-actions 的 cmd: "session" 分支处理。
+ */
+export declare function buildSessionsCard(options: {
+    currentSessionKey: string;
+    mappings: SessionMapping[];
+    sessionMode: string;
+}): JsonObject;

package/dist/cards/sessions.js

@@ -0,0 +1,54 @@
+import { actions, button, card, noteBlock, textBlock } from "./common.js";
+/** 聊天类型中文标签 */
+function chatTypeLabel(chatType) {
+    return chatType === "group" ? "群聊" : "私聊";
+}
+/** 截断过长的会话文件路径，避免卡片内容溢出 */
+function compactPath(path) {
+    return path.length > 72 ? `...${path.slice(-69)}` : path;
+}
+/**
+ * 会话管理卡片（/sessions 命令触发）：
+ * 展示"新建会话"按钮，以及最多 10 条持久化的历史会话；
+ * 每个历史会话有"切换"和"删除"按钮，点击后由 card-actions 的 cmd: "session" 分支处理。
+ */
+export function buildSessionsCard(options) {
+    const elements = [
+        textBlock([`**当前会话**`, `\`${options.currentSessionKey}\``, `模式：${options.sessionMode}`].join("\n")),
+        actions([button("新建会话", { cmd: "session", action: "new", sessionKey: options.currentSessionKey }, "primary")]),
+    ];
+    const visibleMappings = options.mappings.slice(0, 10);
+    if (visibleMappings.length === 0) {
+        elements.push(noteBlock("当前还没有持久化的历史会话。"));
+    }
+    for (const mapping of visibleMappings) {
+        const currentMark = mapping.sessionKey === options.currentSessionKey ? "当前" : "可切换";
+        elements.push(textBlock([
+            `**${chatTypeLabel(mapping.chatType)} · ${currentMark}**`,
+            `\`${mapping.sessionKey}\``,
+            `更新时间：${mapping.updatedAt}`,
+            `文件：${compactPath(mapping.sessionFile)}`,
+        ].join("\n")));
+        elements.push(actions([
+            // 切换：把"当前会话 key"的运行时切换到目标会话文件
+            button("切换", {
+                cmd: "session",
+                action: "switch",
+                sessionKey: options.currentSessionKey,
+                targetSessionKey: mapping.sessionKey,
+            }),
+            // 删除：删除目标会话映射（并释放运行时）
+            button("删除", {
+                cmd: "session",
+                action: "delete",
+                sessionKey: options.currentSessionKey,
+                targetSessionKey: mapping.sessionKey,
+            }, "danger"),
+        ]));
+    }
+    if (options.mappings.length > visibleMappings.length) {
+        elements.push(noteBlock(`还有 ${options.mappings.length - visibleMappings.length} 个会话未展示。`));
+    }
+    return card("Pi 会话管理", "blue", elements);
+}
+//# sourceMappingURL=sessions.js.map