@xwang152/claw-lark 0.1.25 → 0.1.27

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export { createLarkClient, createLarkWSClient } from "./src/client.js";
 export { monitorLarkProvider, stopMonitor } from "./src/monitor.js";
 export { startWebhookServer } from "./src/webhook.js";
 export { listLarkDirectoryPeers, listLarkDirectoryGroups } from "./src/directory.js";
+export { sendMessageLark, sendCardLark, updateCardLark, buildMarkdownCard, sendMarkdownCardLark, editMessageLark, } from "./src/send.js";
+export type { LarkSendResult, SendLarkMessageParams, SendLarkCardParams, SendLarkMarkdownCardParams } from "./src/send.js";
 export { downloadImageLark, downloadFileLark, uploadImageLark, uploadFileLark, sendImageLark, sendFileLark, sendMediaLark, detectFileType, } from "./src/media.js";
 export { addReactionLark, removeReactionLark, listReactionsLark } from "./src/reactions.js";
 export { extractMentionTargets, extractMessageBody, isMentionForwardRequest, formatMentionForText, formatMentionForCard, formatMentionAllForText, formatMentionAllForCard, buildMentionedMessage, buildMentionedCardContent, } from "./src/mention.js";
@@ -21,6 +23,10 @@ export { resolveLarkSenderName, clearSenderNameCache, getSenderNameCacheStats, p
 export { getLarkMessage, formatQuotedContext, isReplyMessage, buildMessageContextWithQuote, } from "./src/message-context.js";
 export type { LarkDomain, LarkConnectionMode, DmPolicy, GroupPolicy, RenderMode, LarkAccountConfig, ResolvedLarkAccount, LarkChannelConfig, LarkGroupConfig, LarkMessageEvent, LarkMention, ParsedMessage, SendResult, } from "./src/types.js";
 export { resolveLarkAllowlistMatch, resolveLarkGroupConfig, resolveLarkGroupToolPolicy, isLarkGroupAllowed, resolveLarkGroupRequireMention, resolveLarkReplyToMode, } from "./src/policy.js";
+export { detectLarkIdType, normalizeLarkTarget, formatLarkTarget, inferReceiveIdType, looksLikeLarkId, } from "./src/utils.js";
+export type { LarkIdType } from "./src/utils.js";
+export { probeLark } from "./src/probe.js";
+export type { LarkProbeResult } from "./src/probe.js";
 declare const plugin: {
     id: string;
     name: string;

package/dist/index.js

@@ -16,6 +16,7 @@ export { createLarkClient, createLarkWSClient } from "./src/client.js";
 export { monitorLarkProvider, stopMonitor } from "./src/monitor.js";
 export { startWebhookServer } from "./src/webhook.js";
 export { listLarkDirectoryPeers, listLarkDirectoryGroups } from "./src/directory.js";
+export { sendMessageLark, sendCardLark, updateCardLark, buildMarkdownCard, sendMarkdownCardLark, editMessageLark, } from "./src/send.js";
 export { downloadImageLark, downloadFileLark, uploadImageLark, uploadFileLark, sendImageLark, sendFileLark, sendMediaLark, detectFileType, } from "./src/media.js";
 export { addReactionLark, removeReactionLark, listReactionsLark } from "./src/reactions.js";
 export { extractMentionTargets, extractMessageBody, isMentionForwardRequest, formatMentionForText, formatMentionForCard, formatMentionAllForText, formatMentionAllForCard, buildMentionedMessage, buildMentionedCardContent, } from "./src/mention.js";
@@ -23,6 +24,8 @@ export { addTypingIndicator, removeTypingIndicator, createTypingController, } fr
 export { resolveLarkSenderName, clearSenderNameCache, getSenderNameCacheStats, prefetchLarkSenderNames, } from "./src/sender-name.js";
 export { getLarkMessage, formatQuotedContext, isReplyMessage, buildMessageContextWithQuote, } from "./src/message-context.js";
 export { resolveLarkAllowlistMatch, resolveLarkGroupConfig, resolveLarkGroupToolPolicy, isLarkGroupAllowed, resolveLarkGroupRequireMention, resolveLarkReplyToMode, } from "./src/policy.js";
+export { detectLarkIdType, normalizeLarkTarget, formatLarkTarget, inferReceiveIdType, looksLikeLarkId, } from "./src/utils.js";
+export { probeLark } from "./src/probe.js";
 const plugin = {
     id: "claw-lark",
     name: "Lark",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,mCAAmC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAgBlC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,4CAA4C;IACzD,YAAY,EAAE,uBAAuB,EAAE;IACvC,QAAQ,CAAC,GAAsB;QAC7B,cAAc,CAAC,GAAG,CAAC,CAAC;QACpB,wCAAwC;QACxC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5C,GAAG,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,mCAAmC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAgBlC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,4CAA4C;IACzD,YAAY,EAAE,uBAAuB,EAAE;IACvC,QAAQ,CAAC,GAAsB;QAC7B,cAAc,CAAC,GAAG,CAAC,CAAC;QACpB,wCAAwC;QACxC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5C,GAAG,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/src/probe.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lark/Feishu Connection Probe
+ *
+ * Tests connectivity and retrieves bot information.
+ * Useful for configuration verification and debugging.
+ */
+import type { ResolvedLarkAccount } from "./types.js";
+export type LarkProbeResult = {
+    ok: true;
+    appId: string;
+    botName?: string;
+    botOpenId?: string;
+} | {
+    ok: false;
+    appId?: string;
+    error: string;
+};
+/**
+ * Probe Lark/Feishu API to verify credentials and get bot info.
+ *
+ * @param account - The Lark account to test
+ * @returns Probe result with bot info if successful
+ */
+export declare function probeLark(account: ResolvedLarkAccount): Promise<LarkProbeResult>;

package/dist/src/probe.js

@@ -0,0 +1,52 @@
+/**
+ * Lark/Feishu Connection Probe
+ *
+ * Tests connectivity and retrieves bot information.
+ * Useful for configuration verification and debugging.
+ */
+import { createLarkClient } from "./client.js";
+/**
+ * Probe Lark/Feishu API to verify credentials and get bot info.
+ *
+ * @param account - The Lark account to test
+ * @returns Probe result with bot info if successful
+ */
+export async function probeLark(account) {
+    if (!account.appId || !account.appSecret) {
+        return {
+            ok: false,
+            error: "missing credentials (appId, appSecret)",
+        };
+    }
+    try {
+        const client = createLarkClient(account);
+        // Use bot info API to test connectivity
+        const response = await client.request({
+            method: "GET",
+            url: "/open-apis/bot/v3/info",
+            data: {},
+        });
+        if (response.code !== 0) {
+            return {
+                ok: false,
+                appId: account.appId,
+                error: `API error: ${response.msg || `code ${response.code}`}`,
+            };
+        }
+        const bot = response.bot || response.data?.bot;
+        return {
+            ok: true,
+            appId: account.appId,
+            botName: bot?.bot_name,
+            botOpenId: bot?.open_id,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            appId: account.appId,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/src/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/probe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAe/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA4B;IAC1D,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,wCAAwC;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEzC,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAO,MAAc,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,wBAAwB;YAC7B,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,cAAc,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE;aAC/D,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;QAC/C,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,GAAG,EAAE,QAAQ;YACtB,SAAS,EAAE,GAAG,EAAE,OAAO;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/send.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Lark/Feishu Message Sending Utilities
+ *
+ * Functions for sending text, cards, and editing messages.
+ * Includes markdown card support for rich content rendering.
+ */
+import type { ResolvedLarkAccount } from "./types.js";
+import type { MentionTarget } from "./mention.js";
+export type LarkSendResult = {
+    messageId: string;
+    chatId: string;
+};
+export type SendLarkMessageParams = {
+    account: ResolvedLarkAccount;
+    to: string;
+    text: string;
+    replyToMessageId?: string;
+    /** Mention target users */
+    mentions?: MentionTarget[];
+};
+/**
+ * Send a text message to Lark/Feishu.
+ *
+ * @param params - Account, recipient, message content, and optional reply/mentions
+ * @returns Send result with messageId and chatId
+ */
+export declare function sendMessageLark(params: SendLarkMessageParams): Promise<LarkSendResult>;
+export type SendLarkCardParams = {
+    account: ResolvedLarkAccount;
+    to: string;
+    card: Record<string, unknown>;
+    replyToMessageId?: string;
+};
+/**
+ * Send an interactive card message to Lark/Feishu.
+ *
+ * @param params - Account, recipient, card content, and optional reply
+ * @returns Send result with messageId and chatId
+ */
+export declare function sendCardLark(params: SendLarkCardParams): Promise<LarkSendResult>;
+/**
+ * Update an existing card message.
+ *
+ * @param params - Account, messageId, and new card content
+ */
+export declare function updateCardLark(params: {
+    account: ResolvedLarkAccount;
+    messageId: string;
+    card: Record<string, unknown>;
+}): Promise<void>;
+/**
+ * Build a Lark/Feishu interactive card with markdown content.
+ *
+ * Cards render markdown properly (code blocks, tables, links, etc.)
+ *
+ * @param text - Markdown content to display in the card
+ * @returns Card object for Lark API
+ */
+export declare function buildMarkdownCard(text: string): Record<string, unknown>;
+export type SendLarkMarkdownCardParams = {
+    account: ResolvedLarkAccount;
+    to: string;
+    text: string;
+    replyToMessageId?: string;
+    /** Mention target users */
+    mentions?: MentionTarget[];
+};
+/**
+ * Send a message as a markdown card (interactive message).
+ *
+ * This renders markdown properly in Lark/Feishu (code blocks, tables, bold/italic, etc.)
+ *
+ * @param params - Account, recipient, markdown text, and optional reply/mentions
+ * @returns Send result with messageId and chatId
+ */
+export declare function sendMarkdownCardLark(params: SendLarkMarkdownCardParams): Promise<LarkSendResult>;
+/**
+ * Edit an existing text message.
+ *
+ * Note: Lark/Feishu only allows editing messages within a certain time window.
+ *
+ * @param params - Account, messageId, and new text content
+ */
+export declare function editMessageLark(params: {
+    account: ResolvedLarkAccount;
+    messageId: string;
+    text: string;
+}): Promise<void>;

package/dist/src/send.js

@@ -0,0 +1,190 @@
+/**
+ * Lark/Feishu Message Sending Utilities
+ *
+ * Functions for sending text, cards, and editing messages.
+ * Includes markdown card support for rich content rendering.
+ */
+import { createLarkClient } from "./client.js";
+import { inferReceiveIdType, normalizeLarkTarget } from "./utils.js";
+import { buildMentionedCardContent } from "./mention.js";
+/**
+ * Send a text message to Lark/Feishu.
+ *
+ * @param params - Account, recipient, message content, and optional reply/mentions
+ * @returns Send result with messageId and chatId
+ */
+export async function sendMessageLark(params) {
+    const { account, to, text, replyToMessageId, mentions } = params;
+    const client = createLarkClient(account);
+    const receiveId = normalizeLarkTarget(to);
+    if (!receiveId) {
+        throw new Error(`Invalid Lark target: ${to}`);
+    }
+    const receiveIdType = inferReceiveIdType(receiveId);
+    // Build message content (with @mention support)
+    let messageText = text ?? "";
+    if (mentions && mentions.length > 0) {
+        // For text messages, mentions use a special format
+        // This is a simplified version - full mention support requires more complex formatting
+        messageText = text; // TODO: Implement proper mention formatting for text messages
+    }
+    const content = JSON.stringify({ text: messageText });
+    if (replyToMessageId) {
+        const response = await client.im.message.reply({
+            path: { message_id: replyToMessageId },
+            data: {
+                content,
+                msg_type: "text",
+            },
+        });
+        if (response.code !== 0) {
+            throw new Error(`Lark reply failed: ${response.msg || `code ${response.code}`}`);
+        }
+        return {
+            messageId: response.data?.message_id ?? "unknown",
+            chatId: receiveId,
+        };
+    }
+    const response = await client.im.message.create({
+        params: { receive_id_type: receiveIdType },
+        data: {
+            receive_id: receiveId,
+            content,
+            msg_type: "text",
+        },
+    });
+    if (response.code !== 0) {
+        throw new Error(`Lark send failed: ${response.msg || `code ${response.code}`}`);
+    }
+    return {
+        messageId: response.data?.message_id ?? "unknown",
+        chatId: receiveId,
+    };
+}
+/**
+ * Send an interactive card message to Lark/Feishu.
+ *
+ * @param params - Account, recipient, card content, and optional reply
+ * @returns Send result with messageId and chatId
+ */
+export async function sendCardLark(params) {
+    const { account, to, card, replyToMessageId } = params;
+    const client = createLarkClient(account);
+    const receiveId = normalizeLarkTarget(to);
+    if (!receiveId) {
+        throw new Error(`Invalid Lark target: ${to}`);
+    }
+    const receiveIdType = inferReceiveIdType(receiveId);
+    const content = JSON.stringify(card);
+    if (replyToMessageId) {
+        const response = await client.im.message.reply({
+            path: { message_id: replyToMessageId },
+            data: {
+                content,
+                msg_type: "interactive",
+            },
+        });
+        if (response.code !== 0) {
+            throw new Error(`Lark card reply failed: ${response.msg || `code ${response.code}`}`);
+        }
+        return {
+            messageId: response.data?.message_id ?? "unknown",
+            chatId: receiveId,
+        };
+    }
+    const response = await client.im.message.create({
+        params: { receive_id_type: receiveIdType },
+        data: {
+            receive_id: receiveId,
+            content,
+            msg_type: "interactive",
+        },
+    });
+    if (response.code !== 0) {
+        throw new Error(`Lark card send failed: ${response.msg || `code ${response.code}`}`);
+    }
+    return {
+        messageId: response.data?.message_id ?? "unknown",
+        chatId: receiveId,
+    };
+}
+/**
+ * Update an existing card message.
+ *
+ * @param params - Account, messageId, and new card content
+ */
+export async function updateCardLark(params) {
+    const { account, messageId, card } = params;
+    const client = createLarkClient(account);
+    const content = JSON.stringify(card);
+    const response = await client.im.message.patch({
+        path: { message_id: messageId },
+        data: { content },
+    });
+    if (response.code !== 0) {
+        throw new Error(`Lark card update failed: ${response.msg || `code ${response.code}`}`);
+    }
+}
+/**
+ * Build a Lark/Feishu interactive card with markdown content.
+ *
+ * Cards render markdown properly (code blocks, tables, links, etc.)
+ *
+ * @param text - Markdown content to display in the card
+ * @returns Card object for Lark API
+ */
+export function buildMarkdownCard(text) {
+    return {
+        config: {
+            wide_screen_mode: true,
+        },
+        elements: [
+            {
+                tag: "markdown",
+                content: text,
+            },
+        ],
+    };
+}
+/**
+ * Send a message as a markdown card (interactive message).
+ *
+ * This renders markdown properly in Lark/Feishu (code blocks, tables, bold/italic, etc.)
+ *
+ * @param params - Account, recipient, markdown text, and optional reply/mentions
+ * @returns Send result with messageId and chatId
+ */
+export async function sendMarkdownCardLark(params) {
+    const { account, to, text, replyToMessageId, mentions } = params;
+    // Build message content (with @mention support)
+    let cardText = text;
+    if (mentions && mentions.length > 0) {
+        cardText = buildMentionedCardContent(mentions, text);
+    }
+    const card = buildMarkdownCard(cardText);
+    return sendCardLark({ account, to, card, replyToMessageId });
+}
+/**
+ * Edit an existing text message.
+ *
+ * Note: Lark/Feishu only allows editing messages within a certain time window.
+ *
+ * @param params - Account, messageId, and new text content
+ */
+export async function editMessageLark(params) {
+    const { account, messageId, text } = params;
+    const client = createLarkClient(account);
+    const messageText = text ?? "";
+    const content = JSON.stringify({ text: messageText });
+    const response = await client.im.message.update({
+        path: { message_id: messageId },
+        data: {
+            msg_type: "text",
+            content,
+        },
+    });
+    if (response.code !== 0) {
+        throw new Error(`Lark message edit failed: ${response.msg || `code ${response.code}`}`);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/src/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/send.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAgBzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA6B;IACjE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEjE,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAEpD,gDAAgD;IAChD,IAAI,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,mDAAmD;QACnD,uFAAuF;QACvF,WAAW,GAAG,IAAI,CAAC,CAAC,8DAA8D;IACpF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAEtD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7C,IAAI,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;YACtC,IAAI,EAAE;gBACJ,OAAO;gBACP,QAAQ,EAAE,MAAM;aACjB;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,SAAS;YACjD,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,MAAM,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE;QAC1C,IAAI,EAAE;YACJ,UAAU,EAAE,SAAS;YACrB,OAAO;YACP,QAAQ,EAAE,MAAM;SACjB;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,SAAS;QACjD,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AASD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IAC3D,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC;IAEvD,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YAC7C,IAAI,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;YACtC,IAAI,EAAE;gBACJ,OAAO;gBACP,QAAQ,EAAE,aAAa;aACxB;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,OAAO;YACL,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,SAAS;YACjD,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,MAAM,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE;QAC1C,IAAI,EAAE;YACJ,UAAU,EAAE,SAAS;YACrB,OAAO;YACP,QAAQ,EAAE,aAAa;SACxB;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,SAAS;QACjD,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAIpC;IACC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAE5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7C,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;QAC/B,IAAI,EAAE,EAAE,OAAO,EAAE;KAClB,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO;QACL,MAAM,EAAE;YACN,gBAAgB,EAAE,IAAI;SACvB;QACD,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,UAAU;gBACf,OAAO,EAAE,IAAI;aACd;SACF;KACF,CAAC;AACJ,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAkC;IAC3E,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEjE,gDAAgD;IAChD,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,QAAQ,GAAG,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAIrC;IACC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAE5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;QAC/B,IAAI,EAAE;YACJ,QAAQ,EAAE,MAAM;YAChB,OAAO;SACR;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC"}

package/dist/src/utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Lark/Feishu Target Utilities
+ *
+ * Helper functions for ID detection, normalization, and type inference.
+ * Used across the plugin for consistent ID handling.
+ */
+export type LarkIdType = "chat_id" | "open_id" | "union_id" | "user_id";
+/**
+ * Detect the type of a Lark ID from its format.
+ */
+export declare function detectLarkIdType(id: string): LarkIdType | null;
+/**
+ * Normalize a Lark target ID by removing prefixes.
+ *
+ * Handles "chat:", "user:", "open_id:" prefixes.
+ */
+export declare function normalizeLarkTarget(raw: string): string | null;
+/**
+ * Format a Lark ID with its type prefix for display.
+ */
+export declare function formatLarkTarget(id: string, type?: LarkIdType): string;
+/**
+ * Infer the receive_id_type parameter for Lark API calls.
+ *
+ * Lark API requires receive_id_type to specify how to interpret the receive_id.
+ * This function detects the type based on the ID prefix.
+ */
+export declare function inferReceiveIdType(recipientId: string): "chat_id" | "open_id" | "union_id";
+/**
+ * Check if a string looks like a Lark ID.
+ */
+export declare function looksLikeLarkId(raw: string): boolean;

package/dist/src/utils.js

@@ -0,0 +1,96 @@
+/**
+ * Lark/Feishu Target Utilities
+ *
+ * Helper functions for ID detection, normalization, and type inference.
+ * Used across the plugin for consistent ID handling.
+ */
+const CHAT_ID_PREFIX = "oc_";
+const OPEN_ID_PREFIX = "ou_";
+const UNION_ID_PREFIX = "on_";
+const USER_ID_REGEX = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Detect the type of a Lark ID from its format.
+ */
+export function detectLarkIdType(id) {
+    const trimmed = id.trim();
+    if (trimmed.startsWith(CHAT_ID_PREFIX))
+        return "chat_id";
+    if (trimmed.startsWith(OPEN_ID_PREFIX))
+        return "open_id";
+    if (trimmed.startsWith(UNION_ID_PREFIX))
+        return "union_id";
+    if (USER_ID_REGEX.test(trimmed))
+        return "user_id";
+    return null;
+}
+/**
+ * Normalize a Lark target ID by removing prefixes.
+ *
+ * Handles "chat:", "user:", "open_id:" prefixes.
+ */
+export function normalizeLarkTarget(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;
+}
+/**
+ * Format a Lark ID with its type prefix for display.
+ */
+export function formatLarkTarget(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;
+}
+/**
+ * Infer the receive_id_type parameter for Lark API calls.
+ *
+ * Lark API requires receive_id_type to specify how to interpret the receive_id.
+ * This function detects the type based on the ID prefix.
+ */
+export function inferReceiveIdType(recipientId) {
+    if (recipientId.startsWith("oc_")) {
+        return "chat_id";
+    }
+    if (recipientId.startsWith("ou_")) {
+        return "open_id";
+    }
+    if (recipientId.startsWith("on_")) {
+        return "union_id";
+    }
+    // Default to open_id for other formats
+    return "open_id";
+}
+/**
+ * Check if a string looks like a Lark ID.
+ */
+export function looksLikeLarkId(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;
+    if (trimmed.startsWith(UNION_ID_PREFIX))
+        return true;
+    return false;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xwang152/claw-lark",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "type": "module",
   "description": "Lark/Feishu channel plugin for OpenClaw with WebSocket and Webhook support",
   "license": "MIT",