@xwang152/claw-lark 0.1.23 → 0.1.25

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

@@ -0,0 +1,54 @@
+/**
+ * Sender Name Resolution
+ *
+ * Resolves sender display names from open_id using Lark contact API.
+ * Caches results for 10 minutes to avoid excessive API calls.
+ *
+ * This is useful in group chats where the agent needs to distinguish
+ * who is speaking (by name rather than just open_id).
+ */
+import type { ResolvedLarkAccount } from "./types.js";
+/**
+ * Resolve sender display name from open_id.
+ *
+ * Uses the contact.user.get API to fetch the user's display name.
+ * Results are cached for 10 minutes to reduce API calls.
+ *
+ * @param params - Account and sender open_id
+ * @returns Display name or undefined if not found
+ */
+export declare function resolveLarkSenderName(params: {
+    account: ResolvedLarkAccount;
+    senderOpenId: string;
+    log?: (...args: any[]) => void;
+}): Promise<string | undefined>;
+/**
+ * Clear the sender name cache.
+ *
+ * This can be useful for testing or when you need fresh data.
+ */
+export declare function clearSenderNameCache(): void;
+/**
+ * Get cache statistics.
+ *
+ * Useful for monitoring and debugging.
+ */
+export declare function getSenderNameCacheStats(): {
+    size: number;
+    entries: Array<{
+        openId: string;
+        name: string;
+        expireAt: number;
+    }>;
+};
+/**
+ * Prefetch sender names for a list of open_ids.
+ *
+ * This can be useful for warming up the cache before processing
+ * a batch of messages.
+ */
+export declare function prefetchLarkSenderNames(params: {
+    account: ResolvedLarkAccount;
+    senderOpenIds: string[];
+    log?: (...args: any[]) => void;
+}): Promise<void>;

package/dist/src/sender-name.js

@@ -0,0 +1,108 @@
+/**
+ * Sender Name Resolution
+ *
+ * Resolves sender display names from open_id using Lark contact API.
+ * Caches results for 10 minutes to avoid excessive API calls.
+ *
+ * This is useful in group chats where the agent needs to distinguish
+ * who is speaking (by name rather than just open_id).
+ */
+import { createLarkClient } from "./client.js";
+// Cache display names by open_id to avoid an API call on every message
+const SENDER_NAME_TTL_MS = 10 * 60 * 1000; // 10 minutes
+const senderNameCache = new Map();
+/**
+ * Resolve sender display name from open_id.
+ *
+ * Uses the contact.user.get API to fetch the user's display name.
+ * Results are cached for 10 minutes to reduce API calls.
+ *
+ * @param params - Account and sender open_id
+ * @returns Display name or undefined if not found
+ */
+export async function resolveLarkSenderName(params) {
+    const { account, senderOpenId, log = console.log } = params;
+    if (!senderOpenId)
+        return undefined;
+    // Check cache first
+    const cached = senderNameCache.get(senderOpenId);
+    const now = Date.now();
+    if (cached && cached.expireAt > now) {
+        return cached.name;
+    }
+    try {
+        const client = createLarkClient(account);
+        // contact/v3/user/:user_id?user_id_type=open_id
+        const res = await client.contact.user.get({
+            path: { user_id: senderOpenId },
+            params: { user_id_type: "open_id" },
+        });
+        // Try multiple name fields in order of preference
+        const name = res?.data?.user?.name ||
+            res?.data?.user?.display_name ||
+            res?.data?.user?.nickname ||
+            res?.data?.user?.en_name;
+        if (name && typeof name === "string") {
+            // Cache the result
+            senderNameCache.set(senderOpenId, { name, expireAt: now + SENDER_NAME_TTL_MS });
+            return name;
+        }
+        return undefined;
+    }
+    catch (err) {
+        // Best-effort. Don't fail message handling if name lookup fails.
+        log(`[lark] Failed to resolve sender name for ${senderOpenId}: ${String(err)}`);
+        return undefined;
+    }
+}
+/**
+ * Clear the sender name cache.
+ *
+ * This can be useful for testing or when you need fresh data.
+ */
+export function clearSenderNameCache() {
+    senderNameCache.clear();
+}
+/**
+ * Get cache statistics.
+ *
+ * Useful for monitoring and debugging.
+ */
+export function getSenderNameCacheStats() {
+    const now = Date.now();
+    const entries = Array.from(senderNameCache.entries())
+        .filter(([, value]) => value.expireAt > now)
+        .map(([openId, value]) => ({
+        openId,
+        name: value.name,
+        expireAt: value.expireAt,
+    }));
+    return {
+        size: entries.length,
+        entries,
+    };
+}
+/**
+ * Prefetch sender names for a list of open_ids.
+ *
+ * This can be useful for warming up the cache before processing
+ * a batch of messages.
+ */
+export async function prefetchLarkSenderNames(params) {
+    const { account, senderOpenIds, log = console.log } = params;
+    // Only fetch names that aren't already cached
+    const now = Date.now();
+    const uncachedIds = senderOpenIds.filter((id) => {
+        const cached = senderNameCache.get(id);
+        return !cached || cached.expireAt <= now;
+    });
+    // Process in parallel with a limit to avoid overwhelming the API
+    const batchSize = 10;
+    for (let i = 0; i < uncachedIds.length; i += batchSize) {
+        const batch = uncachedIds.slice(i, i + batchSize);
+        await Promise.all(batch.map((id) => resolveLarkSenderName({ account, senderOpenId: id, log }).catch(() => {
+            // Ignore errors - best effort prefetch
+        })));
+    }
+}
+//# sourceMappingURL=sender-name.js.map

package/dist/src/sender-name.js.map

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

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

@@ -0,0 +1,76 @@
+/**
+ * Typing Indicators for Lark/Feishu
+ *
+ * Since Lark/Feishu doesn't have a native typing indicator API,
+ * we use emoji reactions as a substitute.
+ *
+ * When the bot starts processing a message, it adds a "Typing" reaction.
+ * When the reply is sent, it removes the reaction.
+ *
+ * Reference: https://open.feishu.cn/document/server-docs/im-v1/message-reaction/emojis-introduce
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+export type TypingIndicatorState = {
+    messageId: string;
+    reactionId: string | null;
+};
+/**
+ * Add a typing indicator (reaction) to a message.
+ *
+ * This adds a visual indicator that the bot is "typing" or processing the message.
+ * Uses the "Typing" emoji reaction if available, falls back gracefully if not.
+ *
+ * @param params - Configuration and message ID
+ * @returns State object containing message ID and reaction ID (for later removal)
+ */
+export declare function addTypingIndicator(params: {
+    cfg: OpenClawConfig;
+    messageId: string;
+    accountId?: string;
+}): Promise<TypingIndicatorState>;
+/**
+ * Remove a typing indicator (reaction) from a message.
+ *
+ * This should be called after the reply is sent to clean up the typing indicator.
+ *
+ * @param params - Configuration and typing indicator state
+ */
+export declare function removeTypingIndicator(params: {
+    cfg: OpenClawConfig;
+    state: TypingIndicatorState;
+    accountId?: string;
+}): Promise<void>;
+/**
+ * Create a typing indicator controller for managing the lifecycle.
+ *
+ * This is useful for ensuring the typing indicator is removed even if errors occur.
+ *
+ * @example
+ * ```typescript
+ * const typing = createTypingController({ cfg, messageId });
+ * await typing.start();
+ * try {
+ *   // ... process message and send reply ...
+ * } finally {
+ *   await typing.stop();
+ * }
+ * ```
+ */
+export declare function createTypingController(params: {
+    cfg: OpenClawConfig;
+    messageId: string;
+    accountId?: string;
+}): {
+    /**
+     * Start the typing indicator
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the typing indicator
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current state
+     */
+    getState(): TypingIndicatorState | null;
+};

package/dist/src/typing.js

@@ -0,0 +1,165 @@
+/**
+ * Typing Indicators for Lark/Feishu
+ *
+ * Since Lark/Feishu doesn't have a native typing indicator API,
+ * we use emoji reactions as a substitute.
+ *
+ * When the bot starts processing a message, it adds a "Typing" reaction.
+ * When the reply is sent, it removes the reaction.
+ *
+ * Reference: https://open.feishu.cn/document/server-docs/im-v1/message-reaction/emojis-introduce
+ */
+import { createLarkClient } from "./client.js";
+// Lark emoji type for typing indicator
+// Note: "Typing" may not be available in all Lark instances
+// Fallback options: "THUMBSUP", "OK", "SMILE"
+const TYPING_EMOJI = "Typing";
+/**
+ * Extract Lark channel config from OpenClaw config
+ */
+function getChannelConfig(cfg) {
+    return cfg.channels?.lark ?? {};
+}
+/**
+ * Add a typing indicator (reaction) to a message.
+ *
+ * This adds a visual indicator that the bot is "typing" or processing the message.
+ * Uses the "Typing" emoji reaction if available, falls back gracefully if not.
+ *
+ * @param params - Configuration and message ID
+ * @returns State object containing message ID and reaction ID (for later removal)
+ */
+export async function addTypingIndicator(params) {
+    const { cfg, messageId, accountId = "default" } = params;
+    const channelConfig = getChannelConfig(cfg);
+    const accountConfig = channelConfig.accounts?.[accountId];
+    if (!accountConfig?.appId || !accountConfig?.appSecret) {
+        return { messageId, reactionId: null };
+    }
+    const client = createLarkClient({
+        accountId,
+        enabled: true,
+        configured: true,
+        appId: accountConfig.appId,
+        appSecret: accountConfig.appSecret,
+        domain: accountConfig.domain ?? "feishu",
+        connectionMode: "websocket",
+        webhookPort: 3000,
+        dmPolicy: "open",
+        dmAllowlist: [],
+        groupPolicy: "open",
+        groupAllowlist: [],
+        requireMention: true,
+        mediaMaxMb: 30,
+        renderMode: "auto",
+        historyLimit: 10,
+    });
+    try {
+        const response = await client.im.messageReaction.create({
+            path: { message_id: messageId },
+            data: {
+                reaction_type: { emoji_type: TYPING_EMOJI },
+            },
+        });
+        const reactionId = response?.data?.reaction_id ?? null;
+        return { messageId, reactionId };
+    }
+    catch (err) {
+        // Silently fail - typing indicator is not critical
+        console.log(`[lark] Failed to add typing indicator: ${err}`);
+        return { messageId, reactionId: null };
+    }
+}
+/**
+ * Remove a typing indicator (reaction) from a message.
+ *
+ * This should be called after the reply is sent to clean up the typing indicator.
+ *
+ * @param params - Configuration and typing indicator state
+ */
+export async function removeTypingIndicator(params) {
+    const { cfg, state, accountId = "default" } = params;
+    if (!state.reactionId)
+        return;
+    const channelConfig = getChannelConfig(cfg);
+    const accountConfig = channelConfig.accounts?.[accountId];
+    if (!accountConfig?.appId || !accountConfig?.appSecret)
+        return;
+    const client = createLarkClient({
+        accountId,
+        enabled: true,
+        configured: true,
+        appId: accountConfig.appId,
+        appSecret: accountConfig.appSecret,
+        domain: accountConfig.domain ?? "feishu",
+        connectionMode: "websocket",
+        webhookPort: 3000,
+        dmPolicy: "open",
+        dmAllowlist: [],
+        groupPolicy: "open",
+        groupAllowlist: [],
+        requireMention: true,
+        mediaMaxMb: 30,
+        renderMode: "auto",
+        historyLimit: 10,
+    });
+    try {
+        await client.im.messageReaction.delete({
+            path: {
+                message_id: state.messageId,
+                reaction_id: state.reactionId,
+            },
+        });
+    }
+    catch (err) {
+        // Silently fail - cleanup is not critical
+        console.log(`[lark] Failed to remove typing indicator: ${err}`);
+    }
+}
+/**
+ * Create a typing indicator controller for managing the lifecycle.
+ *
+ * This is useful for ensuring the typing indicator is removed even if errors occur.
+ *
+ * @example
+ * ```typescript
+ * const typing = createTypingController({ cfg, messageId });
+ * await typing.start();
+ * try {
+ *   // ... process message and send reply ...
+ * } finally {
+ *   await typing.stop();
+ * }
+ * ```
+ */
+export function createTypingController(params) {
+    let state = null;
+    return {
+        /**
+         * Start the typing indicator
+         */
+        async start() {
+            state = await addTypingIndicator(params);
+        },
+        /**
+         * Stop the typing indicator
+         */
+        async stop() {
+            if (state) {
+                await removeTypingIndicator({
+                    cfg: params.cfg,
+                    state,
+                    accountId: params.accountId,
+                });
+                state = null;
+            }
+        },
+        /**
+         * Get current state
+         */
+        getState() {
+            return state;
+        },
+    };
+}
+//# sourceMappingURL=typing.js.map

package/dist/src/typing.js.map

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

package/package.json

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