@openclaw-cn/feishu 0.1.8

package/dist/src/sheets-schema.js

@@ -0,0 +1,35 @@
+import { Type } from "@sinclair/typebox";
+import { stringEnum } from "openclaw/plugin-sdk";
+// ============ Sheets Tool Schema ============
+const SHEETS_ACTIONS = [
+    "get_meta",
+    "read_range",
+    "write_range",
+    "append",
+    "insert_rows",
+    "add_sheet",
+    "list_sheets",
+];
+export const FeishuSheetsSchema = Type.Object({
+    action: stringEnum(SHEETS_ACTIONS, { description: "操作类型" }),
+    // --- 共用 ---
+    spreadsheet_token: Type.String({
+        description: "电子表格 token (从 URL 或 Drive 获取)",
+    }),
+    // --- read_range / write_range / append ---
+    range: Type.Optional(Type.String({
+        description: "[read_range/write_range/append] 范围。格式: SheetId!A1:C10 或 SheetId!A:C。SheetId 可通过 list_sheets 获取",
+    })),
+    // --- write_range / append ---
+    values: Type.Optional(Type.Array(Type.Array(Type.Any(), { description: "行数据" }), {
+        description: "[write_range/append] 二维数组，每个子数组是一行",
+    })),
+    // --- insert_rows ---
+    sheet_id: Type.Optional(Type.String({ description: "[insert_rows/add_sheet] Sheet ID" })),
+    start_index: Type.Optional(Type.Number({ description: "[insert_rows] 插入位置（行索引，从 0 开始）" })),
+    count: Type.Optional(Type.Number({ description: "[insert_rows] 插入行数" })),
+    // --- add_sheet ---
+    title: Type.Optional(Type.String({ description: "[add_sheet] 新 Sheet 的标题" })),
+    index: Type.Optional(Type.Number({ description: "[add_sheet] 新 Sheet 的位置索引" })),
+});
+//# sourceMappingURL=sheets-schema.js.map

package/dist/src/sheets-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets-schema.js","sourceRoot":"","sources":["../../src/sheets-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,+CAA+C;AAE/C,MAAM,cAAc,GAAG;IACrB,UAAU;IACV,YAAY;IACZ,aAAa;IACb,QAAQ;IACR,aAAa;IACb,WAAW;IACX,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,UAAU,CAAC,cAAc,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC3D,aAAa;IACb,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC;QAC7B,WAAW,EAAE,+BAA+B;KAC7C,CAAC;IACF,4CAA4C;IAC5C,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,gGAAgG;KACnG,CAAC,CACH;IACD,+BAA+B;IAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE;QACzD,WAAW,EAAE,oCAAoC;KAClD,CAAC,CACH;IACD,sBAAsB;IACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACzF,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC,CAC/D;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACxE,oBAAoB;IACpB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;CAChF,CAAC,CAAC"}

package/dist/src/sheets.d.ts

@@ -0,0 +1,45 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { createFeishuClient } from "./client.js";
+/** Get spreadsheet metadata */
+export declare function getSpreadsheetMeta(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string): Promise<{
+    spreadsheet: {
+        title?: string | undefined;
+        owner_id?: string | undefined;
+        token?: string | undefined;
+        url?: string | undefined;
+    };
+}>;
+/** List all sheets in a spreadsheet */
+export declare function listSheets(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string): Promise<{
+    sheets: any;
+}>;
+/** Read a range from a sheet */
+export declare function readRange(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string, range: string): Promise<{
+    values: any;
+    range: any;
+}>;
+/** Write values to a range */
+export declare function writeRange(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string, range: string, values: unknown[][]): Promise<{
+    updated_range: any;
+    updated_rows: any;
+    updated_columns: any;
+    updated_cells: any;
+}>;
+/** Append rows to a sheet */
+export declare function appendData(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string, range: string, values: unknown[][]): Promise<{
+    appended_rows: number;
+    range: string;
+}>;
+/** Insert empty rows */
+export declare function insertRows(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string, sheetId: string, startIndex: number, count: number): Promise<{
+    inserted: number;
+    start_index: number;
+}>;
+/** Add a new sheet to the spreadsheet */
+export declare function addSheet(client: ReturnType<typeof createFeishuClient>, spreadsheetToken: string, title: string, index?: number): Promise<{
+    sheet_id: any;
+    title: any;
+    index: any;
+}>;
+export declare function registerFeishuSheetsTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=sheets.d.ts.map

package/dist/src/sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../src/sheets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAejD,+BAA+B;AAC/B,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM;;;;;;;GAazB;AAED,uCAAuC;AACvC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM;;GAmBzB;AAED,gCAAgC;AAChC,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM;;;GAgBd;AAED,8BAA8B;AAC9B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EAAE,EAAE;;;;;GAiBpB;AAED,6BAA6B;AAC7B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EAAE,EAAE;;;GAepB;AAED,wBAAwB;AACxB,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM;;;GAwBd;AAED,yCAAyC;AACzC,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM;;;;GAmBf;AAID,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,iBAAiB,QAmF/D"}

package/dist/src/sheets.js

@@ -0,0 +1,197 @@
+import { listEnabledFeishuAccounts } from "./accounts.js";
+import { createFeishuClient } from "./client.js";
+import { resolveToolsConfig } from "./tools-config.js";
+import { FeishuSheetsSchema } from "./sheets-schema.js";
+// ============ Helpers ============
+function json(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        details: data,
+    };
+}
+// ============ Core Functions ============
+/** Get spreadsheet metadata */
+export async function getSpreadsheetMeta(client, spreadsheetToken) {
+    const res = await client.sheets.v3.spreadsheet.get({
+        path: { spreadsheet_token: spreadsheetToken },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        spreadsheet: res.data?.spreadsheet,
+    };
+}
+/** List all sheets in a spreadsheet */
+export async function listSheets(client, spreadsheetToken) {
+    const res = await client.sheets.v3.spreadsheetSheet.list({
+        path: { spreadsheet_token: spreadsheetToken },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        sheets: (res.data?.items ?? []).map((s) => ({
+            sheet_id: s.sheet_id,
+            title: s.title,
+            index: s.index,
+            row_count: s.grid_properties?.row_count,
+            column_count: s.grid_properties?.column_count,
+        })),
+    };
+}
+/** Read a range from a sheet */
+export async function readRange(client, spreadsheetToken, range) {
+    const res = await client.sheets.v3.spreadsheetSheetRange.read({
+        path: { spreadsheet_token: spreadsheetToken, range },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    // Fallback: try v2 API if v3 fails
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        values: res.data?.valueRange?.values ?? res.data?.values ?? [],
+        range: res.data?.valueRange?.range ?? range,
+    };
+}
+/** Write values to a range */
+export async function writeRange(client, spreadsheetToken, range, values) {
+    const res = await client.sheets.v3.spreadsheetSheetRange.write({
+        path: { spreadsheet_token: spreadsheetToken, range },
+        data: { values },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        updated_range: res.data?.updatedRange ?? range,
+        updated_rows: res.data?.updatedRows ?? values.length,
+        updated_columns: res.data?.updatedColumns,
+        updated_cells: res.data?.updatedCells,
+    };
+}
+/** Append rows to a sheet */
+export async function appendData(client, spreadsheetToken, range, values) {
+    const res = await client.sheets.v3.spreadsheetSheetRange.write({
+        path: { spreadsheet_token: spreadsheetToken, range },
+        data: { values },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        appended_rows: values.length,
+        range,
+    };
+}
+/** Insert empty rows */
+export async function insertRows(client, spreadsheetToken, sheetId, startIndex, count) {
+    const res = await client.sheets.v3.spreadsheetSheet.patch({
+        path: { spreadsheet_token: spreadsheetToken, sheet_id: sheetId },
+        data: {
+            insert_range: {
+                dimension: {
+                    sheet_id: sheetId,
+                    major_dimension: "ROWS",
+                    start_index: startIndex,
+                    end_index: startIndex + count,
+                },
+            },
+        },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        inserted: count,
+        start_index: startIndex,
+    };
+}
+/** Add a new sheet to the spreadsheet */
+export async function addSheet(client, spreadsheetToken, title, index) {
+    const res = await client.sheets.v3.spreadsheetSheet.create({
+        path: { spreadsheet_token: spreadsheetToken },
+        data: {
+            title,
+            ...(index !== undefined && { index }),
+        },
+        // oxlint-disable-next-line typescript/no-explicit-any
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        sheet_id: res.data?.sheet?.sheet_id,
+        title: res.data?.sheet?.title,
+        index: res.data?.sheet?.index,
+    };
+}
+// ============ Tool Registration ============
+export function registerFeishuSheetsTools(api) {
+    if (!api.config) {
+        api.logger.debug?.("feishu_sheets: No config available, skipping");
+        return;
+    }
+    const accounts = listEnabledFeishuAccounts(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.("feishu_sheets: No Feishu accounts configured, skipping");
+        return;
+    }
+    const firstAccount = accounts[0];
+    const toolsCfg = resolveToolsConfig(firstAccount.config.tools);
+    if (!toolsCfg.sheets) {
+        api.logger.debug?.("feishu_sheets: Sheets tools disabled in config");
+        return;
+    }
+    const getClient = () => createFeishuClient(firstAccount);
+    api.registerTool({
+        name: "feishu_sheets",
+        label: "飞书 - 电子表格",
+        description: `飞书电子表格操作工具。支持以下操作:
+- get_meta: 获取电子表格元信息
+- list_sheets: 列出所有 Sheet 页
+- read_range: 读取指定范围 (格式: SheetId!A1:C10)
+- write_range: 写入指定范围
+- append: 在指定范围追加数据
+- insert_rows: 插入空行
+- add_sheet: 新增 Sheet 页`,
+        parameters: FeishuSheetsSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            const action = p.action;
+            const client = getClient();
+            const token = p.spreadsheet_token;
+            try {
+                switch (action) {
+                    case "get_meta":
+                        return json(await getSpreadsheetMeta(client, token));
+                    case "list_sheets":
+                        return json(await listSheets(client, token));
+                    case "read_range":
+                        return json(await readRange(client, token, p.range));
+                    case "write_range":
+                        return json(await writeRange(client, token, p.range, p.values));
+                    case "append":
+                        return json(await appendData(client, token, p.range, p.values));
+                    case "insert_rows":
+                        return json(await insertRows(client, token, p.sheet_id, p.start_index, p.count));
+                    case "add_sheet":
+                        return json(await addSheet(client, token, p.title, p.index));
+                    default:
+                        return json({ error: `Unknown action: ${action}` });
+                }
+            }
+            catch (err) {
+                return json({ error: err instanceof Error ? err.message : String(err) });
+            }
+        },
+    }, { name: "feishu_sheets" });
+    api.logger.info?.("feishu_sheets: Registered feishu_sheets tool (7 actions)");
+}
+//# sourceMappingURL=sheets.js.map

package/dist/src/sheets.js.map

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

package/dist/src/streaming-card.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Feishu Streaming Card - Card Kit streaming API for real-time text output
+ */
+import type { Client } from "@larksuiteoapi/node-sdk";
+import type { FeishuDomain } from "./types.js";
+type Credentials = {
+    appId: string;
+    appSecret: string;
+    domain?: FeishuDomain;
+};
+/** Streaming card session manager */
+export declare class FeishuStreamingSession {
+    private client;
+    private creds;
+    private state;
+    private queue;
+    private closed;
+    private log?;
+    private lastUpdateTime;
+    private pendingText;
+    private updateThrottleMs;
+    constructor(client: Client, creds: Credentials, log?: (msg: string) => void);
+    start(receiveId: string, receiveIdType?: "open_id" | "user_id" | "union_id" | "email" | "chat_id"): Promise<void>;
+    update(text: string): Promise<void>;
+    close(finalText?: string): Promise<void>;
+    isActive(): boolean;
+}
+export {};
+//# sourceMappingURL=streaming-card.d.ts.map

package/dist/src/streaming-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-card.d.ts","sourceRoot":"","sources":["../../src/streaming-card.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAoD/E,qCAAqC;AACrC,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAC,CAAwB;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,gBAAgB,CAAO;gBAEnB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAMrE,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAqB,GAClF,OAAO,CAAC,IAAI,CAAC;IAsDV,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCnC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD9C,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/src/streaming-card.js

@@ -0,0 +1,192 @@
+/**
+ * Feishu Streaming Card - Card Kit streaming API for real-time text output
+ */
+// Token cache (keyed by domain + appId)
+const tokenCache = new Map();
+function resolveApiBase(domain) {
+    if (domain === "lark") {
+        return "https://open.larksuite.com/open-apis";
+    }
+    if (domain && domain !== "feishu" && domain.startsWith("http")) {
+        return `${domain.replace(/\/+$/, "")}/open-apis`;
+    }
+    return "https://open.feishu.cn/open-apis";
+}
+async function getToken(creds) {
+    const key = `${creds.domain ?? "feishu"}|${creds.appId}`;
+    const cached = tokenCache.get(key);
+    if (cached && cached.expiresAt > Date.now() + 60000) {
+        return cached.token;
+    }
+    const res = await fetch(`${resolveApiBase(creds.domain)}/auth/v3/tenant_access_token/internal`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ app_id: creds.appId, app_secret: creds.appSecret }),
+    });
+    const data = (await res.json());
+    if (data.code !== 0 || !data.tenant_access_token) {
+        throw new Error(`Token error: ${data.msg}`);
+    }
+    tokenCache.set(key, {
+        token: data.tenant_access_token,
+        expiresAt: Date.now() + (data.expire ?? 7200) * 1000,
+    });
+    return data.tenant_access_token;
+}
+function truncateSummary(text, max = 50) {
+    if (!text) {
+        return "";
+    }
+    const clean = text.replace(/\n/g, " ").trim();
+    return clean.length <= max ? clean : clean.slice(0, max - 3) + "...";
+}
+/** Streaming card session manager */
+export class FeishuStreamingSession {
+    client;
+    creds;
+    state = null;
+    queue = Promise.resolve();
+    closed = false;
+    log;
+    lastUpdateTime = 0;
+    pendingText = null;
+    updateThrottleMs = 100; // Throttle updates to max 10/sec
+    constructor(client, creds, log) {
+        this.client = client;
+        this.creds = creds;
+        this.log = log;
+    }
+    async start(receiveId, receiveIdType = "chat_id") {
+        if (this.state) {
+            return;
+        }
+        const apiBase = resolveApiBase(this.creds.domain);
+        const cardJson = {
+            schema: "2.0",
+            config: {
+                streaming_mode: true,
+                summary: { content: "[Generating...]" },
+                streaming_config: { print_frequency_ms: { default: 50 }, print_step: { default: 2 } },
+            },
+            body: {
+                elements: [{ tag: "markdown", content: "⏳ Thinking...", element_id: "content" }],
+            },
+        };
+        // Create card entity
+        const createRes = await fetch(`${apiBase}/cardkit/v1/cards`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${await getToken(this.creds)}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ type: "card_json", data: JSON.stringify(cardJson) }),
+        });
+        const createData = (await createRes.json());
+        if (createData.code !== 0 || !createData.data?.card_id) {
+            throw new Error(`Create card failed: ${createData.msg}`);
+        }
+        const cardId = createData.data.card_id;
+        // Send card message
+        const sendRes = await this.client.im.message.create({
+            params: { receive_id_type: receiveIdType },
+            data: {
+                receive_id: receiveId,
+                msg_type: "interactive",
+                content: JSON.stringify({ type: "card", data: { card_id: cardId } }),
+            },
+        });
+        if (sendRes.code !== 0 || !sendRes.data?.message_id) {
+            throw new Error(`Send card failed: ${sendRes.msg}`);
+        }
+        this.state = { cardId, messageId: sendRes.data.message_id, sequence: 1, currentText: "" };
+        this.log?.(`Started streaming: cardId=${cardId}, messageId=${sendRes.data.message_id}`);
+    }
+    async update(text) {
+        // Critical: Check closed state immediately, before queue operations.
+        // This prevents updates queued before close() from executing after streaming is closed.
+        if (this.closed || !this.state) {
+            return;
+        }
+        // Throttle: skip if updated recently, but remember pending text
+        const now = Date.now();
+        if (now - this.lastUpdateTime < this.updateThrottleMs) {
+            this.pendingText = text;
+            // CRITICAL FIX: Don't return early - continue to queue to ensure all updates are sent
+            // The old early return caused partial updates to be lost when throttle was active
+        }
+        this.pendingText = null;
+        this.lastUpdateTime = now;
+        this.queue = this.queue.then(async () => {
+            if (!this.state || this.closed) {
+                return;
+            }
+            this.state.currentText = text;
+            this.state.sequence += 1;
+            const apiBase = resolveApiBase(this.creds.domain);
+            await fetch(`${apiBase}/cardkit/v1/cards/${this.state.cardId}/elements/content/content`, {
+                method: "PUT",
+                headers: {
+                    Authorization: `Bearer ${await getToken(this.creds)}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    content: text,
+                    sequence: this.state.sequence,
+                    uuid: `s_${this.state.cardId}_${this.state.sequence}`,
+                }),
+            }).catch((e) => this.log?.(`Update failed: ${String(e)}`));
+        });
+        await this.queue;
+    }
+    async close(finalText) {
+        if (!this.state || this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.queue;
+        // Use finalText if explicitly provided (even empty string to suppress pendingText fallback),
+        // otherwise fall back to pending throttled text or current text.
+        const text = finalText !== undefined ? finalText : (this.pendingText ?? this.state.currentText);
+        const apiBase = resolveApiBase(this.creds.domain);
+        // Send final content update if:
+        // - text differs from what's already displayed, AND
+        // - either text has content, OR text is "" (explicitly clearing the card for silent replies)
+        if (text !== this.state.currentText && (text || this.state.currentText)) {
+            this.state.sequence += 1;
+            await fetch(`${apiBase}/cardkit/v1/cards/${this.state.cardId}/elements/content/content`, {
+                method: "PUT",
+                headers: {
+                    Authorization: `Bearer ${await getToken(this.creds)}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    content: text,
+                    sequence: this.state.sequence,
+                    uuid: `s_${this.state.cardId}_${this.state.sequence}`,
+                }),
+            }).catch(() => { });
+            this.state.currentText = text;
+        }
+        // Close streaming mode
+        this.state.sequence += 1;
+        await fetch(`${apiBase}/cardkit/v1/cards/${this.state.cardId}/settings`, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${await getToken(this.creds)}`,
+                "Content-Type": "application/json; charset=utf-8",
+            },
+            body: JSON.stringify({
+                settings: JSON.stringify({
+                    config: { streaming_mode: false, summary: { content: truncateSummary(text) } },
+                }),
+                sequence: this.state.sequence,
+                uuid: `c_${this.state.cardId}_${this.state.sequence}`,
+            }),
+        }).catch((e) => this.log?.(`Close failed: ${String(e)}`));
+        this.log?.(`Closed streaming: cardId=${this.state.cardId}`);
+    }
+    isActive() {
+        return this.state !== null && !this.closed;
+    }
+}
+//# sourceMappingURL=streaming-card.js.map

package/dist/src/streaming-card.js.map

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

package/dist/src/targets.d.ts

@@ -0,0 +1,7 @@
+import type { FeishuIdType } from "./types.js";
+export declare function detectIdType(id: string): FeishuIdType | null;
+export declare function normalizeFeishuTarget(raw: string): string | null;
+export declare function formatFeishuTarget(id: string, type?: FeishuIdType): string;
+export declare function resolveReceiveIdType(id: string): "chat_id" | "open_id" | "user_id";
+export declare function looksLikeFeishuId(raw: string): boolean;
+//# sourceMappingURL=targets.d.ts.map

package/dist/src/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAY5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAS1E;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CASlF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAetD"}

package/dist/src/targets.js

@@ -0,0 +1,70 @@
+const CHAT_ID_PREFIX = "oc_";
+const OPEN_ID_PREFIX = "ou_";
+const USER_ID_REGEX = /^[a-zA-Z0-9_-]+$/;
+export function detectIdType(id) {
+    const trimmed = id.trim();
+    if (trimmed.startsWith(CHAT_ID_PREFIX)) {
+        return "chat_id";
+    }
+    if (trimmed.startsWith(OPEN_ID_PREFIX)) {
+        return "open_id";
+    }
+    if (USER_ID_REGEX.test(trimmed)) {
+        return "user_id";
+    }
+    return null;
+}
+export function normalizeFeishuTarget(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const lowered = trimmed.toLowerCase();
+    if (lowered.startsWith("chat:")) {
+        return trimmed.slice("chat:".length).trim() || null;
+    }
+    if (lowered.startsWith("user:")) {
+        return trimmed.slice("user:".length).trim() || null;
+    }
+    if (lowered.startsWith("open_id:")) {
+        return trimmed.slice("open_id:".length).trim() || null;
+    }
+    return trimmed;
+}
+export function formatFeishuTarget(id, type) {
+    const trimmed = id.trim();
+    if (type === "chat_id" || trimmed.startsWith(CHAT_ID_PREFIX)) {
+        return `chat:${trimmed}`;
+    }
+    if (type === "open_id" || trimmed.startsWith(OPEN_ID_PREFIX)) {
+        return `user:${trimmed}`;
+    }
+    return trimmed;
+}
+export function resolveReceiveIdType(id) {
+    const trimmed = id.trim();
+    if (trimmed.startsWith(CHAT_ID_PREFIX)) {
+        return "chat_id";
+    }
+    if (trimmed.startsWith(OPEN_ID_PREFIX)) {
+        return "open_id";
+    }
+    return "user_id";
+}
+export function looksLikeFeishuId(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return false;
+    }
+    if (/^(chat|user|open_id):/i.test(trimmed)) {
+        return true;
+    }
+    if (trimmed.startsWith(CHAT_ID_PREFIX)) {
+        return true;
+    }
+    if (trimmed.startsWith(OPEN_ID_PREFIX)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=targets.js.map

package/dist/src/targets.js.map

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

package/dist/src/task-schema.d.ts

@@ -0,0 +1,19 @@
+export declare const FeishuTaskSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnsafe<"update" | "get" | "create" | "list" | "complete" | "add_members" | "add_reminder" | "add_comment">;
+    summary: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    due: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    members: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TString;
+        role: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"assignee" | "follower">>;
+    }>>>;
+    task_guid: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    member_ids: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    role: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"assignee" | "follower">>;
+    relative_fire_minutes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sender_open_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    content: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+//# sourceMappingURL=task-schema.d.ts.map