pi-remote-feishu 0.1.0

package/dist/extensions/lark-cli-guard.js

@@ -0,0 +1,75 @@
+import { spawnSync } from "node:child_process";
+/**
+ * ============================================================
+ * lark-cli 护栏
+ * ------------------------------------------------------------
+ * 防止模型通过 bash 使用 lark-cli 的 IM 写/收命令
+ * （发送、回复、转发、删除、更新、接收、监听等），
+ * 确保飞书会话内的消息回发走 pi-remote-feishu 自己的传输通道。
+ *
+ * 允许保留的能力：
+ * - lark-doc-cli：飞书文档读写
+ * - lark-im-readonly：只读的 IM 查询（查聊天、列成员、搜消息、下资源）
+ * ============================================================
+ */
+/** 被拦截的 lark-cli im 动作（+xxx 子命令名） */
+const BLOCKED_LARK_IM_ACTIONS = [
+    "messages-send",
+    "messages-reply",
+    "messages-forward",
+    "messages-delete",
+    "messages-update",
+    "messages-receive",
+    "messages-listen",
+    "events-receive",
+    "events-listen",
+];
+/** 检测本机是否安装了 lark-cli（运行 `lark-cli --version`） */
+export function isLarkCliInstalled() {
+    const result = spawnSync("lark-cli", ["--version"], {
+        stdio: "ignore",
+        shell: process.platform === "win32",
+    });
+    return result.status === 0;
+}
+/** 命令里是否包含 lark-cli im（含 npx 前缀的写法） */
+function hasLarkImCommand(command) {
+    return /\blark-cli\s+im\b/.test(command) || /\bnpx\s+lark-cli\s+im\b/.test(command);
+}
+/**
+ * 判断一条 bash 命令是否需要被拦截：
+ * 仅当它调用 lark-cli im 且包含被禁动作时才拦截。
+ * 动作匹配使用 +action 或 action 两种写法均可（正则做了转义）。
+ */
+export function isBlockedLarkImCommand(command) {
+    if (!hasLarkImCommand(command))
+        return false;
+    return BLOCKED_LARK_IM_ACTIONS.some((action) => {
+        const escaped = action.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
+        return new RegExp(`(?:\\+|\\b)${escaped}\\b`).test(command);
+    });
+}
+/** 系统提示词护栏：检测到 lark-cli 时注入（允许文档/只读 IM，禁止 IM 写/收） */
+export const FEISHU_CLI_PROMPT_GUARD = `
+## Feishu CLI Boundary
+
+This session may expose Lark CLI skills for Feishu documents and read-only IM inspection.
+
+- Use lark-doc-cli for Feishu document tasks such as fetching, creating, updating, and inserting media into docs.
+- Use lark-im-readonly only for read-only IM tasks such as looking up chats, listing members, searching existing messages, or downloading message resources.
+- Do not use lark-cli IM commands to send, reply, forward, delete, update, receive, or listen for messages.
+- In a Feishu-triggered run, the pi-remote-feishu transport is the only normal reply channel back to the current chat.
+- To return generated local files to the current Feishu chat, use send_file_to_chat instead of manually sending IM messages with lark-cli.
+`;
+/** 系统提示词护栏：未检测到 lark-cli 时注入 */
+export const FEISHU_NO_CLI_PROMPT_GUARD = `
+## Feishu CLI Boundary
+
+The lark-cli executable was not detected when pi-remote-feishu loaded.
+
+- Do not attempt to use lark-cli commands unless the user installs and authenticates lark-cli, then reloads Pi.
+- Use pi-remote-feishu transport features for the current Feishu chat.
+- To return generated local files to the current Feishu chat, use send_file_to_chat.
+- If the user asks to read or edit a Feishu document and no SDK document tool is available yet, ask for the document link or token and explain that SDK document tooling is not implemented in this extension version.
+`;
+//# sourceMappingURL=lark-cli-guard.js.map

package/dist/extensions/lark-cli-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lark-cli-guard.js","sourceRoot":"","sources":["../../src/extensions/lark-cli-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AAEH,qCAAqC;AACrC,MAAM,uBAAuB,GAAG;IAC9B,eAAe;IACf,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;CACP,CAAC;AAEX,kDAAkD;AAClD,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE;QAClD,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;KACpC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,uCAAuC;AACvC,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;QAChE,OAAO,IAAI,MAAM,CAAC,cAAc,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;CAUtC,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;CASzC,CAAC"}

package/dist/feishu/channel.d.ts

@@ -0,0 +1,28 @@
+import type { FeishuChannel } from "../types.js";
+/**
+ * ============================================================
+ * 飞书通道实现
+ * ------------------------------------------------------------
+ * 封装 @larksuiteoapi/node-sdk 的 WebSocket 通道，向业务层暴露
+ * 统一、友好的 FeishuChannel 接口：
+ *
+ * - SDK 事件 -> 归一化后的 FeishuMessage / FeishuCardAction
+ * - 各种 send/stream/update/download 方法 -> Promise 化
+ *
+ * 注意：这里用 as unknown as RawLarkChannel 做窄接口化，
+ * 只声明我们实际用到的 SDK 能力，方便替换实现。
+ * ============================================================
+ */
+/** 创建飞书通道的选项 */
+export interface CreateFeishuChannelOptions {
+    appId: string;
+    appSecret: string;
+    logLevel?: string;
+    /** 群聊是否要求 @机器人（由 SDK 侧 policy 处理） */
+    requireMention: boolean;
+}
+/**
+ * 创建飞书通道（FeishuChannel 的唯一实现）。
+ * 通过 createLarkChannel 建立 WebSocket 长连接，并包一层统一接口。
+ */
+export declare function createFeishuChannel(options: CreateFeishuChannelOptions): FeishuChannel;

package/dist/feishu/channel.js

@@ -0,0 +1,191 @@
+import { stat } from "node:fs/promises";
+import { basename } from "node:path";
+import { createLarkChannel, LoggerLevel } from "@larksuiteoapi/node-sdk";
+/** 日志级别映射：字符串 -> SDK LoggerLevel */
+const LOG_LEVELS = {
+    fatal: LoggerLevel.fatal,
+    error: LoggerLevel.error,
+    warn: LoggerLevel.warn,
+    info: LoggerLevel.info,
+    debug: LoggerLevel.debug,
+    trace: LoggerLevel.trace,
+};
+/* ---------- 字段读取辅助（兼容多种命名风格） ---------- */
+function asRecord(value) {
+    return typeof value === "object" && value !== null ? value : {};
+}
+function readString(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+}
+function readBoolean(record, key) {
+    const value = record[key];
+    return typeof value === "boolean" ? value : undefined;
+}
+/* ---------- 事件归一化 ---------- */
+/** 归一化消息资源列表：只保留有 fileKey 的资源 */
+function normalizeResources(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((entry) => {
+        const record = asRecord(entry);
+        const fileName = readString(record, "fileName") ?? readString(record, "file_name");
+        return {
+            type: readString(record, "type") ?? "file",
+            fileKey: readString(record, "fileKey") ?? readString(record, "file_key") ?? "",
+            ...(fileName ? { fileName } : {}),
+        };
+    }).filter((resource) => resource.fileKey.length > 0);
+}
+/** 把 SDK 原始消息事件归一化成 FeishuMessage */
+function normalizeMessage(value) {
+    const record = asRecord(value);
+    const rawContentType = readString(record, "rawContentType") ?? readString(record, "messageType");
+    const chatTypeText = readString(record, "chatType") ?? readString(record, "chat_type") ?? rawContentType;
+    // p2p / private 视为私聊，其余（p2p_group 等）视为群聊
+    const chatType = chatTypeText === "p2p" || chatTypeText === "private" ? "private" : "group";
+    const sender = asRecord(record.sender);
+    const senderId = asRecord(sender.sender_id);
+    const mentions = Array.isArray(record.mentions) ? record.mentions : [];
+    const mentionedBot = readBoolean(record, "mentionedBot") ?? mentions.length > 0;
+    const senderName = readString(record, "senderName") ?? readString(sender, "sender_name");
+    const tenantKey = readString(record, "tenantKey") ?? readString(record, "tenant_key");
+    return {
+        messageId: readString(record, "messageId") ?? readString(record, "message_id") ?? "",
+        chatId: readString(record, "chatId") ?? readString(record, "chat_id") ?? "",
+        chatType,
+        userOpenId: readString(record, "userOpenId") ??
+            readString(record, "openId") ??
+            readString(senderId, "open_id") ??
+            readString(senderId, "user_id") ??
+            "unknown",
+        ...(senderName ? { senderName } : {}),
+        ...(tenantKey ? { tenantKey } : {}),
+        text: readString(record, "content") ?? readString(record, "text") ?? "",
+        mentionedBot,
+        resources: normalizeResources(record.resources),
+        raw: value,
+    };
+}
+/** 把 SDK 原始卡片事件归一化成 FeishuCardAction */
+function normalizeCardAction(value) {
+    const record = asRecord(value);
+    const event = asRecord(record.event);
+    const action = asRecord(record.action);
+    const operator = asRecord(record.operator);
+    const operatorId = asRecord(operator.operator_id);
+    const actionValue = asRecord(action.value ?? record.value);
+    const messageId = readString(record, "messageId") ?? readString(event, "message_id");
+    const userOpenId = readString(record, "userOpenId") ?? readString(operatorId, "open_id");
+    const token = readString(record, "token") ?? readString(event, "token");
+    return {
+        ...(messageId ? { messageId } : {}),
+        chatId: readString(record, "chatId") ?? readString(event, "chat_id") ?? "",
+        ...(userOpenId ? { userOpenId } : {}),
+        actionValue,
+        ...(token ? { token } : {}),
+        raw: value,
+    };
+}
+/** 归一化发送结果 */
+function normalizeSendResult(result) {
+    return { messageId: result.messageId ?? result.message_id ?? "" };
+}
+/**
+ * 创建飞书通道（FeishuChannel 的唯一实现）。
+ * 通过 createLarkChannel 建立 WebSocket 长连接，并包一层统一接口。
+ */
+export function createFeishuChannel(options) {
+    const loggerLevel = LOG_LEVELS[options.logLevel?.toLowerCase() ?? ""] ?? LoggerLevel.warn;
+    const raw = createLarkChannel({
+        appId: options.appId,
+        appSecret: options.appSecret,
+        loggerLevel,
+        policy: { requireMention: options.requireMention, dmMode: "open" },
+        includeRawEvent: true,
+        safety: { chatQueue: { enabled: false } },
+    });
+    let connected = false;
+    return {
+        async connect() {
+            await raw.connect();
+            connected = true;
+        },
+        async disconnect() {
+            await raw.disconnect();
+            connected = false;
+        },
+        /** 注册消息回调（自动归一化） */
+        onMessage(handler) {
+            raw.on("message", (message) => handler(normalizeMessage(message)));
+        },
+        /** 注册卡片事件回调（自动归一化） */
+        onCardAction(handler) {
+            raw.on("cardAction", (event) => handler(normalizeCardAction(event)));
+        },
+        onError(handler) {
+            raw.on("error", (error) => handler(error instanceof Error ? error : new Error(String(error))));
+        },
+        async sendText(chatId, text, replyOptions) {
+            return normalizeSendResult(await raw.send(chatId, { text }, replyOptions));
+        },
+        async sendMarkdown(chatId, markdown, replyOptions) {
+            return normalizeSendResult(await raw.send(chatId, { markdown }, replyOptions));
+        },
+        async sendCard(chatId, card, replyOptions) {
+            return normalizeSendResult(await raw.send(chatId, { card }, replyOptions));
+        },
+        /** 流式发送 Markdown：producer 里不断 append 增量 */
+        async streamMarkdown(chatId, producer, replyOptions) {
+            await raw.stream(chatId, { markdown: producer }, replyOptions);
+        },
+        async updateCard(messageId, card) {
+            await raw.updateCard(messageId, card);
+        },
+        /** 用 token 更新卡片（token 来自卡片事件，无需 messageId） */
+        async updateCardByToken(token, card) {
+            await raw.rawClient.request({
+                url: "/open-apis/interactive/v1/card/update",
+                method: "POST",
+                data: { token, card },
+            });
+        },
+        /** 发送本地文件（发送前校验路径确实是文件） */
+        async sendFile(chatId, filePath, fileName) {
+            const statResult = await stat(filePath);
+            if (!statResult.isFile()) {
+                throw new Error("Path is not a file");
+            }
+            await raw.send(chatId, {
+                file: { source: filePath, fileName: fileName ?? basename(filePath) },
+            });
+        },
+        /** 发送本地图片 */
+        async sendImage(chatId, imagePath) {
+            const statResult = await stat(imagePath);
+            if (!statResult.isFile()) {
+                throw new Error("Path is not a file");
+            }
+            await raw.send(chatId, { image: { source: imagePath } });
+        },
+        /** 下载消息资源：分块读取可读流并拼成完整 Buffer */
+        async downloadResource(messageId, fileKey, type) {
+            const response = await raw.rawClient.im.v1.messageResource.get({
+                path: { message_id: messageId, file_key: fileKey },
+                params: { type },
+            });
+            const chunks = [];
+            for await (const chunk of response.getReadableStream()) {
+                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+            }
+            return Buffer.concat(chunks);
+        },
+        get connected() {
+            return connected;
+        },
+        get botName() {
+            return raw.botIdentity?.name;
+        },
+    };
+}
+//# sourceMappingURL=channel.js.map

package/dist/feishu/channel.js.map

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

package/dist/feishu/context.d.ts

@@ -0,0 +1,5 @@
+import type { FeishuRunContext } from "../types.js";
+/** 读取当前调用链中的飞书上下文；不在飞书请求中则返回 undefined */
+export declare function getFeishuContext(): FeishuRunContext | undefined;
+/** 在指定上下文里执行 run()，整个 run 及其子异步调用都能读到该上下文 */
+export declare function runWithFeishuContext<T>(context: FeishuRunContext, run: () => Promise<T>): Promise<T>;

package/dist/feishu/context.js

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * 飞书运行上下文存储：
+ * 使用 AsyncLocalStorage 在"一次飞书请求 -> Pi 生成"的整个异步调用链中
+ * 传递 FeishuRunContext（channel、chatId、sessionKey、config 等）。
+ *
+ * 这样 send_file_to_chat、ui.select 等能力可以在任意深度拿到
+ * 当前请求对应的飞书通道，而不必手动层层传参。
+ */
+const storage = new AsyncLocalStorage();
+/** 读取当前调用链中的飞书上下文；不在飞书请求中则返回 undefined */
+export function getFeishuContext() {
+    return storage.getStore();
+}
+/** 在指定上下文里执行 run()，整个 run 及其子异步调用都能读到该上下文 */
+export async function runWithFeishuContext(context, run) {
+    return await storage.run(context, run);
+}
+//# sourceMappingURL=context.js.map

package/dist/feishu/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/feishu/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;GAOG;AACH,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAE1D,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,OAAyB,EAAE,GAAqB;IAC5F,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/feishu/webhook.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Webhook 传输模式在 v1 版本尚未实现。
+ * 统一从这里抛出错误，避免各处硬编码相同的报错信息。
+ */
+export declare function createWebhookNotImplementedError(): Error;

package/dist/feishu/webhook.js

@@ -0,0 +1,8 @@
+/**
+ * Webhook 传输模式在 v1 版本尚未实现。
+ * 统一从这里抛出错误，避免各处硬编码相同的报错信息。
+ */
+export function createWebhookNotImplementedError() {
+    return new Error("Feishu webhook transport is not implemented yet; use websocket transport.");
+}
+//# sourceMappingURL=webhook.js.map

package/dist/feishu/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/feishu/webhook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AAChG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 公共入口：对外导出所有可供外部复用的 API。
+ * 当其他项目以 npm 包方式引入 pi-remote-feishu 时，从这里 import。
+ */
+/** 卡片事件处理（stop 停止、model 切换模型、session 会话管理等） */
+export { handleCardAction } from "./bridge/card-actions.js";
+/** 会话路由：判断消息是否被接受，并计算 sessionKey */
+export { routeConversation, buildSessionKey } from "./bridge/conversation-router.js";
+/** 飞书消息总入口：路由 -> 附件处理 -> 归一化 -> 命令/生成 */
+export { handleFeishuMessage } from "./bridge/message-handler.js";
+/** 把飞书消息归一化成给 Pi 的输入（含群聊上下文、附件说明） */
+export { normalizeMessage } from "./bridge/message-normalizer.js";
+/** 提示词队列：保证同一会话的消息串行处理 */
+export { PromptQueue } from "./bridge/prompt-queue.js";
+/** 会话宿主管理器：按 sessionKey 管理 Pi 运行时实例 */
+export { SessionHostManager } from "./bridge/session-host-manager.js";
+/** 飞书 UI 桥接：把 Pi 的 ui.select/confirm 转成飞书权限卡片 */
+export { createFeishuUIContext, resolvePermissionCardAction } from "./bridge/ui-context.js";
+/** 配置加载：合并 环境变量 + 配置文件 + CLI 参数 */
+export { loadConfig } from "./config/load-config.js";
+/** 创建飞书通道（封装飞书 WebSocket SDK） */
+export { createFeishuChannel } from "./feishu/channel.js";
+/** 飞书运行上下文（AsyncLocalStorage 存取） */
+export { getFeishuContext, runWithFeishuContext } from "./feishu/context.js";
+/** JSON 文件存储：会话映射持久化 */
+export { JsonFeishuStore } from "./store/json-store.js";
+/** 生成 send_file_to_chat 工具，让 Pi 可以把本地文件回传到当前飞书聊天 */
+export { createSendFileToChatTool } from "./tools/send-file-to-chat.js";
+/** 导出全部公共类型 */
+export type * from "./types.js";

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * 公共入口：对外导出所有可供外部复用的 API。
+ * 当其他项目以 npm 包方式引入 pi-remote-feishu 时，从这里 import。
+ */
+/** 卡片事件处理（stop 停止、model 切换模型、session 会话管理等） */
+export { handleCardAction } from "./bridge/card-actions.js";
+/** 会话路由：判断消息是否被接受，并计算 sessionKey */
+export { routeConversation, buildSessionKey } from "./bridge/conversation-router.js";
+/** 飞书消息总入口：路由 -> 附件处理 -> 归一化 -> 命令/生成 */
+export { handleFeishuMessage } from "./bridge/message-handler.js";
+/** 把飞书消息归一化成给 Pi 的输入（含群聊上下文、附件说明） */
+export { normalizeMessage } from "./bridge/message-normalizer.js";
+/** 提示词队列：保证同一会话的消息串行处理 */
+export { PromptQueue } from "./bridge/prompt-queue.js";
+/** 会话宿主管理器：按 sessionKey 管理 Pi 运行时实例 */
+export { SessionHostManager } from "./bridge/session-host-manager.js";
+/** 飞书 UI 桥接：把 Pi 的 ui.select/confirm 转成飞书权限卡片 */
+export { createFeishuUIContext, resolvePermissionCardAction } from "./bridge/ui-context.js";
+/** 配置加载：合并 环境变量 + 配置文件 + CLI 参数 */
+export { loadConfig } from "./config/load-config.js";
+/** 创建飞书通道（封装飞书 WebSocket SDK） */
+export { createFeishuChannel } from "./feishu/channel.js";
+/** 飞书运行上下文（AsyncLocalStorage 存取） */
+export { getFeishuContext, runWithFeishuContext } from "./feishu/context.js";
+/** JSON 文件存储：会话映射持久化 */
+export { JsonFeishuStore } from "./store/json-store.js";
+/** 生成 send_file_to_chat 工具，让 Pi 可以把本地文件回传到当前飞书聊天 */
+export { createSendFileToChatTool } from "./tools/send-file-to-chat.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACrF,yCAAyC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,qCAAqC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,uCAAuC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,iDAAiD;AACjD,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC5F,mCAAmC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,iCAAiC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,oCAAoC;AACpC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,oDAAoD;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/store/json-store.d.ts

@@ -0,0 +1,25 @@
+import type { FeishuStore, SessionFilter, SessionMapping } from "../types.js";
+export declare class JsonFeishuStore implements FeishuStore {
+    private readonly filePath;
+    /** 写操作队列尾：保证 set/delete 串行执行 */
+    private writeTail;
+    constructor(filePath: string);
+    /** 按 sessionKey 查询映射 */
+    getSessionMapping(sessionKey: string): Promise<SessionMapping | undefined>;
+    /** 写入（或覆盖）一条映射：已存在则替换，否则追加 */
+    setSessionMapping(mapping: SessionMapping): Promise<void>;
+    /** 删除一条映射 */
+    deleteSessionMapping(sessionKey: string): Promise<void>;
+    /** 列出全部映射（支持按 chatId / userId / chatType 过滤） */
+    listSessionMappings(filter?: SessionFilter): Promise<SessionMapping[]>;
+    /**
+     * 写操作互斥锁：
+     * 把本次操作挂到 writeTail 链尾，前一个写完成后再执行，
+     * 防止并发 set/delete 造成文件内容丢失。
+     */
+    private withWriteLock;
+    /** 读取存储文件；文件不存在或结构非法时按空映射处理 */
+    private readStore;
+    /** 写存储文件（自动创建目录，美化 JSON 格式） */
+    private writeStore;
+}

package/dist/store/json-store.js

@@ -0,0 +1,105 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/** 判断映射是否满足过滤条件（未指定字段视为不限制） */
+function matchesFilter(mapping, filter) {
+    if (!filter)
+        return true;
+    if (filter.chatId !== undefined && mapping.chatId !== filter.chatId)
+        return false;
+    if (filter.userId !== undefined && mapping.userId !== filter.userId)
+        return false;
+    if (filter.chatType !== undefined && mapping.chatType !== filter.chatType)
+        return false;
+    return true;
+}
+/** 校验读到的数据是否为合法 StoreFile 结构 */
+function isStoreFile(value) {
+    if (typeof value !== "object" || value === null || !("mappings" in value))
+        return false;
+    const mappings = value.mappings;
+    return Array.isArray(mappings);
+}
+export class JsonFeishuStore {
+    filePath;
+    /** 写操作队列尾：保证 set/delete 串行执行 */
+    writeTail = Promise.resolve();
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /** 按 sessionKey 查询映射 */
+    async getSessionMapping(sessionKey) {
+        const file = await this.readStore();
+        return file.mappings.find((mapping) => mapping.sessionKey === sessionKey);
+    }
+    /** 写入（或覆盖）一条映射：已存在则替换，否则追加 */
+    async setSessionMapping(mapping) {
+        await this.withWriteLock(async () => {
+            const file = await this.readStore();
+            const index = file.mappings.findIndex((entry) => entry.sessionKey === mapping.sessionKey);
+            if (index === -1) {
+                file.mappings.push(mapping);
+            }
+            else {
+                file.mappings[index] = mapping;
+            }
+            await this.writeStore(file);
+        });
+    }
+    /** 删除一条映射 */
+    async deleteSessionMapping(sessionKey) {
+        await this.withWriteLock(async () => {
+            const file = await this.readStore();
+            await this.writeStore({
+                mappings: file.mappings.filter((mapping) => mapping.sessionKey !== sessionKey),
+            });
+        });
+    }
+    /** 列出全部映射（支持按 chatId / userId / chatType 过滤） */
+    async listSessionMappings(filter) {
+        const file = await this.readStore();
+        return file.mappings.filter((mapping) => matchesFilter(mapping, filter));
+    }
+    /**
+     * 写操作互斥锁：
+     * 把本次操作挂到 writeTail 链尾，前一个写完成后再执行，
+     * 防止并发 set/delete 造成文件内容丢失。
+     */
+    async withWriteLock(run) {
+        const previous = this.writeTail;
+        let release = () => { };
+        this.writeTail = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            await run();
+        }
+        finally {
+            release();
+        }
+    }
+    /** 读取存储文件；文件不存在或结构非法时按空映射处理 */
+    async readStore() {
+        try {
+            const raw = await readFile(this.filePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (isStoreFile(parsed)) {
+                return { mappings: parsed.mappings };
+            }
+        }
+        catch (error) {
+            // 文件不存在：返回空（首次运行时）
+            if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+                return { mappings: [] };
+            }
+            throw error;
+        }
+        return { mappings: [] };
+    }
+    /** 写存储文件（自动创建目录，美化 JSON 格式） */
+    async writeStore(file) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        await writeFile(this.filePath, `${JSON.stringify(file, null, 2)}\n`, "utf-8");
+    }
+}
+//# sourceMappingURL=json-store.js.map

package/dist/store/json-store.js.map

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

package/dist/store/store.d.ts

@@ -0,0 +1,7 @@
+import type { FeishuConfig, FeishuStore } from "../types.js";
+/**
+ * 存储工厂：根据配置创建对应的 FeishuStore 实现。
+ * 目前只支持 json（sqlite 预留但未实现）。
+ * 会话映射文件放在 files.tempDir 下的 sessions.json。
+ */
+export declare function createStore(config: FeishuConfig): FeishuStore;

package/dist/store/store.js

@@ -0,0 +1,15 @@
+import { join } from "node:path";
+import { JsonFeishuStore } from "./json-store.js";
+/**
+ * 存储工厂：根据配置创建对应的 FeishuStore 实现。
+ * 目前只支持 json（sqlite 预留但未实现）。
+ * 会话映射文件放在 files.tempDir 下的 sessions.json。
+ */
+export function createStore(config) {
+    if (config.sessions.store === "sqlite") {
+        throw new Error('SQLite store is not implemented yet; use sessions.store = "json"');
+    }
+    const baseDir = config.files.tempDir ?? ".";
+    return new JsonFeishuStore(join(baseDir, "sessions.json"));
+}
+//# sourceMappingURL=store.js.map

package/dist/store/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC;IAC5C,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/tools/send-file-to-chat.d.ts

@@ -0,0 +1,26 @@
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import type { FeishuConfig } from "../types.js";
+/**
+ * ============================================================
+ * send_file_to_chat 工具
+ * ------------------------------------------------------------
+ * 供 Pi 在生成过程中调用：把本地生成的文件回传到当前飞书聊天。
+ *
+ * 安全校验：
+ * - 必须在飞书请求上下文内（getFeishuContext）才可用
+ * - 文件路径必须在 allowedOutputDirs 白名单内
+ * - 必须是文件且大小不超过 maxUploadBytes
+ * ============================================================
+ */
+/** 工具参数 schema（typebox 描述，Pi 会据此生成函数签名给模型看） */
+declare const sendFileSchema: Type.TObject<{
+    filePath: Type.TString;
+    fileName: Type.TOptional<Type.TString>;
+}>;
+/**
+ * 创建 send_file_to_chat 工具。
+ * 在 Pi 的运行时中注册后，模型生成完文件即可调用它把文件发回飞书。
+ */
+export declare function createSendFileToChatTool(config: FeishuConfig): ToolDefinition<typeof sendFileSchema, undefined>;
+export {};