@xwang152/claw-lark 0.1.24 → 0.1.26

package/dist/index.d.ts

@@ -19,7 +19,12 @@ export { addTypingIndicator, removeTypingIndicator, createTypingController, } fr
 export type { TypingIndicatorState } from "./src/typing.js";
 export { resolveLarkSenderName, clearSenderNameCache, getSenderNameCacheStats, prefetchLarkSenderNames, } from "./src/sender-name.js";
 export { getLarkMessage, formatQuotedContext, isReplyMessage, buildMessageContextWithQuote, } from "./src/message-context.js";
-export type { LarkDomain, LarkConnectionMode, LarkAccountConfig, ResolvedLarkAccount, LarkChannelConfig, LarkMessageEvent, ParsedMessage, SendResult, } from "./src/types.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

@@ -22,6 +22,9 @@ export { extractMentionTargets, extractMessageBody, isMentionForwardRequest, for
 export { addTypingIndicator, removeTypingIndicator, createTypingController, } from "./src/typing.js";
 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;AAYlC,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,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/policy.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Group-level Policy and Access Control
+ *
+ * Handles per-group configuration for Lark/Feishu integration.
+ * Supports group-specific tool policies, mention requirements, and access control.
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import type { LarkGroupConfig } from "./types.js";
+export type LarkAllowlistMatch = {
+    allowed: boolean;
+    matchKey?: string;
+    matchSource?: "wildcard" | "id" | "name";
+};
+/**
+ * Resolve allowlist match for a sender.
+ *
+ * Checks if a sender is allowed based on allowlist configuration.
+ * Supports wildcards, IDs, and names.
+ */
+export declare function resolveLarkAllowlistMatch(params: {
+    allowFrom: Array<string | number>;
+    senderId: string;
+    senderName?: string | null;
+}): LarkAllowlistMatch;
+/**
+ * Resolve group configuration for a specific group.
+ *
+ * Looks up group-specific settings from the configuration.
+ * Supports case-insensitive group ID matching.
+ */
+export declare function resolveLarkGroupConfig(params: {
+    cfg?: OpenClawConfig;
+    groupId?: string | null;
+    accountId?: string;
+}): LarkGroupConfig | undefined;
+/**
+ * Resolve group tool policy for agent tool access control.
+ *
+ * Returns the tools configuration for a specific group.
+ */
+export declare function resolveLarkGroupToolPolicy(params: {
+    cfg?: OpenClawConfig;
+    groupId?: string | null;
+    accountId?: string;
+}): {
+    allow?: string[];
+    deny?: string[];
+} | undefined;
+/**
+ * Check if a group is allowed based on policy.
+ *
+ * @param groupPolicy - "open" | "allowlist" | "disabled"
+ * @param allowFrom - Allowlist configuration
+ * @param senderId - Sender's ID
+ * @param senderName - Sender's display name (optional)
+ */
+export declare function isLarkGroupAllowed(params: {
+    groupPolicy: "open" | "allowlist" | "disabled";
+    allowFrom: Array<string | number>;
+    senderId: string;
+    senderName?: string | null;
+}): boolean;
+/**
+ * Resolve mention requirement for a group.
+ *
+ * Determines if @mention is required in a group based on
+ * group configuration or global default.
+ */
+export declare function resolveLarkGroupRequireMention(params: {
+    cfg?: OpenClawConfig;
+    groupId?: string | null;
+    accountId?: string;
+    groupConfig?: LarkGroupConfig;
+}): boolean;
+/**
+ * Resolve reply-to mode for a group.
+ *
+ * Determines how replies should be threaded in a group chat.
+ */
+export declare function resolveLarkReplyToMode(params: {
+    cfg?: OpenClawConfig;
+    groupId?: string | null;
+    accountId?: string;
+}): "first" | "last" | "off";

package/dist/src/policy.js

@@ -0,0 +1,137 @@
+/**
+ * Group-level Policy and Access Control
+ *
+ * Handles per-group configuration for Lark/Feishu integration.
+ * Supports group-specific tool policies, mention requirements, and access control.
+ */
+/**
+ * Extract Lark channel config from OpenClaw config
+ */
+function getChannelConfig(cfg) {
+    return cfg.channels?.lark ?? {};
+}
+/**
+ * Resolve allowlist match for a sender.
+ *
+ * Checks if a sender is allowed based on allowlist configuration.
+ * Supports wildcards, IDs, and names.
+ */
+export function resolveLarkAllowlistMatch(params) {
+    const allowFrom = params.allowFrom
+        .map((entry) => String(entry).trim().toLowerCase())
+        .filter(Boolean);
+    if (allowFrom.length === 0)
+        return { allowed: false };
+    if (allowFrom.includes("*")) {
+        return { allowed: true, matchKey: "*", matchSource: "wildcard" };
+    }
+    const senderId = params.senderId.toLowerCase();
+    if (allowFrom.includes(senderId)) {
+        return { allowed: true, matchKey: senderId, matchSource: "id" };
+    }
+    const senderName = params.senderName?.toLowerCase();
+    if (senderName && allowFrom.includes(senderName)) {
+        return { allowed: true, matchKey: senderName, matchSource: "name" };
+    }
+    return { allowed: false };
+}
+/**
+ * Resolve group configuration for a specific group.
+ *
+ * Looks up group-specific settings from the configuration.
+ * Supports case-insensitive group ID matching.
+ */
+export function resolveLarkGroupConfig(params) {
+    const channelConfig = getChannelConfig(params.cfg ?? {});
+    const groupId = params.groupId?.trim();
+    const accountId = params.accountId ?? "default";
+    if (!groupId)
+        return undefined;
+    // First check account-level groups configuration
+    const accountConfig = channelConfig.accounts?.[accountId];
+    if (accountConfig?.groups) {
+        const direct = accountConfig.groups[groupId];
+        if (direct)
+            return direct;
+        // Try case-insensitive match
+        const lowered = groupId.toLowerCase();
+        const matchKey = Object.keys(accountConfig.groups).find((key) => key.toLowerCase() === lowered);
+        if (matchKey) {
+            return accountConfig.groups[matchKey];
+        }
+    }
+    // Then check channel-level groups configuration
+    if (channelConfig.groups) {
+        const direct = channelConfig.groups[groupId];
+        if (direct)
+            return direct;
+        // Try case-insensitive match
+        const lowered = groupId.toLowerCase();
+        const matchKey = Object.keys(channelConfig.groups).find((key) => key.toLowerCase() === lowered);
+        if (matchKey) {
+            return channelConfig.groups[matchKey];
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve group tool policy for agent tool access control.
+ *
+ * Returns the tools configuration for a specific group.
+ */
+export function resolveLarkGroupToolPolicy(params) {
+    const groupConfig = resolveLarkGroupConfig(params);
+    return groupConfig?.tools;
+}
+/**
+ * Check if a group is allowed based on policy.
+ *
+ * @param groupPolicy - "open" | "allowlist" | "disabled"
+ * @param allowFrom - Allowlist configuration
+ * @param senderId - Sender's ID
+ * @param senderName - Sender's display name (optional)
+ */
+export function isLarkGroupAllowed(params) {
+    const { groupPolicy, allowFrom, senderId, senderName } = params;
+    if (groupPolicy === "disabled")
+        return false;
+    if (groupPolicy === "open")
+        return true;
+    return resolveLarkAllowlistMatch({
+        allowFrom,
+        senderId,
+        senderName,
+    }).allowed;
+}
+/**
+ * Resolve mention requirement for a group.
+ *
+ * Determines if @mention is required in a group based on
+ * group configuration or global default.
+ */
+export function resolveLarkGroupRequireMention(params) {
+    // If explicit group config is provided, use it
+    if (params.groupConfig) {
+        return params.groupConfig.requireMention ?? true;
+    }
+    // Otherwise, resolve from config
+    const groupConfig = resolveLarkGroupConfig(params);
+    if (groupConfig) {
+        return groupConfig.requireMention ?? true;
+    }
+    // Fall back to channel/account default
+    const channelConfig = getChannelConfig(params.cfg ?? {});
+    const accountId = params.accountId ?? "default";
+    const accountConfig = channelConfig.accounts?.[accountId];
+    return accountConfig?.requireMention ?? true;
+}
+/**
+ * Resolve reply-to mode for a group.
+ *
+ * Determines how replies should be threaded in a group chat.
+ */
+export function resolveLarkReplyToMode(params) {
+    const groupConfig = resolveLarkGroupConfig(params);
+    return groupConfig?.replyToMode ?? "first";
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/policy.js.map

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

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/types.d.ts

@@ -30,6 +30,7 @@ export interface LarkAccountConfig {
     mediaMaxMb?: number;
     renderMode?: RenderMode;
     historyLimit?: number;
+    groups?: Record<string, LarkGroupConfig>;
 }
 /**
  * Fully resolved account with all defaults applied.
@@ -61,6 +62,20 @@ export interface ResolvedLarkAccount {
 export interface LarkChannelConfig {
     enabled?: boolean;
     accounts?: Record<string, LarkAccountConfig>;
+    groups?: Record<string, LarkGroupConfig>;
+}
+/**
+ * Group-level configuration for specific Lark groups
+ */
+export interface LarkGroupConfig {
+    enabled?: boolean;
+    requireMention?: boolean;
+    replyToMode?: "first" | "last" | "off";
+    tools?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    allowFrom?: string[];
 }
 /**
  * Lark message event payload from im.message.receive_v1

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.24",
+  "version": "0.1.26",
   "type": "module",
   "description": "Lark/Feishu channel plugin for OpenClaw with WebSocket and Webhook support",
   "license": "MIT",