cc-lark 0.1.1

package/dist/tools/chat/chat.js

@@ -0,0 +1,106 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_chat tool - Manage Feishu chats/groups.
+ *
+ * Actions: search, get
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { assertLarkOk } from '../../core/api-error.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:chat:chat');
+// Schemas
+const searchActionSchema = {
+    action: z.literal('search').describe('Search for chats'),
+    query: z.string().describe('Search query (matches group name or member name)'),
+    page_size: z.number().min(1).optional().describe('Page size (default 20)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+const getActionSchema = {
+    action: z.literal('get').describe('Get chat info'),
+    chat_id: z.string().describe('Chat ID (format: oc_xxx)'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerChatTool(registry) {
+    // Search chats
+    registry.register({
+        name: 'feishu_chat_search',
+        description: 'Search for Feishu chats by name or member.\n\nRequires OAuth authorization.',
+        inputSchema: searchActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`search: query="${p.query}", page_size=${p.page_size ?? 20}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.im.v1.chat.search({
+                params: {
+                    user_id_type: 'open_id',
+                    query: p.query,
+                    page_size: p.page_size,
+                    page_token: p.page_token,
+                },
+            }, opts);
+            assertLarkOk(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = res.data;
+            return json({
+                items: data?.items,
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token,
+            });
+        },
+    });
+    // Get chat info
+    registry.register({
+        name: 'feishu_chat_get',
+        description: 'Get Feishu chat info by ID.\n\nRequires OAuth authorization.',
+        inputSchema: getActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`get: chat_id=${p.chat_id}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.im.v1.chat.get({
+                path: { chat_id: p.chat_id },
+                params: { user_id_type: 'open_id' },
+            }, opts);
+            assertLarkOk(res);
+            return json({ chat: res.data });
+        },
+    });
+    log.debug('feishu_chat tools registered');
+}
+//# sourceMappingURL=chat.js.map

package/dist/tools/chat/chat.js.map

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

package/dist/tools/chat/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Chat Tools Index
+ *
+ * Chat/group management tools for Feishu/Lark.
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerChatTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAO9D"}

package/dist/tools/chat/index.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Chat Tools Index
+ *
+ * Chat/group management tools for Feishu/Lark.
+ */
+import { registerChatTool } from './chat.js';
+import { registerChatMembersTool } from './members.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:chat');
+export function registerChatTools(registry) {
+    registerChatTool(registry);
+    registerChatMembersTool(registry);
+    log.info('Chat tools registered', {
+        tools: ['feishu_chat_search', 'feishu_chat_get', 'feishu_chat_members'].join(', '),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/chat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAEjC,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;QAChC,KAAK,EAAE,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACnF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/chat/members.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_chat_members tool - Get chat members.
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerChatMembersTool(registry: ToolRegistry): void;
+//# sourceMappingURL=members.d.ts.map

package/dist/tools/chat/members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/tools/chat/members.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoChD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgDpE"}

package/dist/tools/chat/members.js

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_chat_members tool - Get chat members.
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { assertLarkOk } from '../../core/api-error.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:chat:members');
+// Schemas
+const membersActionSchema = {
+    chat_id: z.string().describe('Chat ID (format: oc_xxx)'),
+    member_id_type: z.enum(['open_id', 'union_id', 'user_id']).optional().describe('Member ID type (default: open_id)'),
+    page_size: z.number().min(1).optional().describe('Page size (default 20)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerChatMembersTool(registry) {
+    registry.register({
+        name: 'feishu_chat_members',
+        description: 'Get members of a Feishu chat.\n\nRequires OAuth authorization.',
+        inputSchema: membersActionSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`members: chat_id="${p.chat_id}", page_size=${p.page_size ?? 20}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            const res = await larkClient.sdk.im.v1.chatMembers.get({
+                path: { chat_id: p.chat_id },
+                params: {
+                    member_id_type: p.member_id_type || 'open_id',
+                    page_size: p.page_size,
+                    page_token: p.page_token,
+                },
+            }, opts);
+            assertLarkOk(res);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = res.data;
+            const memberCount = data?.items?.length ?? 0;
+            const memberTotal = data?.member_total ?? 0;
+            log.info(`members: found ${memberCount} members (total: ${memberTotal})`);
+            return json({
+                items: data?.items,
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token,
+                member_total: memberTotal,
+            });
+        },
+    });
+    log.debug('feishu_chat_members tool registered');
+}
+//# sourceMappingURL=members.js.map

package/dist/tools/chat/members.js.map

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

package/dist/tools/common/get-user.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_get_user tool - Get user information.
+ *
+ * Actions: get current user or get user by ID
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerGetUserTool(registry: ToolRegistry): void;
+//# sourceMappingURL=get-user.d.ts.map

package/dist/tools/common/get-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user.d.ts","sourceRoot":"","sources":["../../../src/tools/common/get-user.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiChD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAmFhE"}

package/dist/tools/common/get-user.js

@@ -0,0 +1,112 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_get_user tool - Get user information.
+ *
+ * Actions: get current user or get user by ID
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:common:get-user');
+// Schemas
+const getUserSchema = {
+    user_id: z.string().optional().describe('User ID (format: ou_xxx). If not provided, returns current user info'),
+    user_id_type: z.enum(['open_id', 'union_id', 'user_id']).optional().describe('User ID type (default: open_id)'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerGetUserTool(registry) {
+    registry.register({
+        name: 'feishu_get_user',
+        description: 'Get Feishu user information. Returns current user if user_id not provided.\n\nRequires OAuth authorization.',
+        inputSchema: getUserSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            // If no user_id provided, get current user info
+            if (!p.user_id) {
+                log.info('get_user: fetching current user info');
+                try {
+                    const res = await larkClient.sdk.authen.userInfo.get({}, opts);
+                    // Check for API error
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    if (res.code !== undefined && res.code !== 0) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const e = res;
+                        if (e.code === 41050) {
+                            return jsonError('Permission denied. User visibility scope limits access to this user.');
+                        }
+                        return jsonError(`API Error: code=${e.code}, msg=${e.msg}`);
+                    }
+                    log.info('get_user: current user fetched successfully');
+                    return json({ user: res.data });
+                }
+                catch (invokeErr) {
+                    // Handle 41050 error
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    if (invokeErr && typeof invokeErr === 'object' && invokeErr.response?.data?.code === 41050) {
+                        return jsonError('Permission denied. User visibility scope limits access to this user.');
+                    }
+                    throw invokeErr;
+                }
+            }
+            // Get specific user info
+            log.info(`get_user: fetching user ${p.user_id}`);
+            const userIdType = p.user_id_type || 'open_id';
+            try {
+                const res = await larkClient.sdk.contact.v3.user.get({
+                    path: { user_id: p.user_id },
+                    params: { user_id_type: userIdType },
+                }, opts);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                if (res.code !== undefined && res.code !== 0) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const e = res;
+                    if (e.code === 41050) {
+                        return jsonError('Permission denied. User visibility scope limits access to this user.');
+                    }
+                    return jsonError(`API Error: code=${e.code}, msg=${e.msg}`);
+                }
+                log.info(`get_user: user ${p.user_id} fetched successfully`);
+                return json({ user: res.data?.user });
+            }
+            catch (invokeErr) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                if (invokeErr && typeof invokeErr === 'object' && invokeErr.response?.data?.code === 41050) {
+                    return jsonError('Permission denied. User visibility scope limits access to this user.');
+                }
+                throw invokeErr;
+            }
+        },
+    });
+    log.debug('feishu_get_user tool registered');
+}
+//# sourceMappingURL=get-user.js.map

package/dist/tools/common/get-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user.js","sourceRoot":"","sources":["../../../src/tools/common/get-user.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,GAAG,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAE5C,UAAU;AACV,MAAM,aAAa,GAAG;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC/G,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAChH,CAAC;AAEF,KAAK,UAAU,cAAc,CAAC,OAA8F;IAC1H,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACjE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC3C,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC,6CAA6C,CAAC,CAAC;IAE1F,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAExC,IAAI,CAAC;QACH,OAAO,MAAM,mBAAmB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,sBAAsB;YAAE,OAAO,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC3F,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAsB;IACxD,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6GAA6G;QAC1H,WAAW,EAAE,aAAa;QAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,IAAkE,CAAC;YAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;YAE/B,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,SAAS,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC;YACpF,MAAM,WAAW,GAAG,WAAW,CAAC;YAEhC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAEnD,gDAAgD;YAChD,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;gBAEjD,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,UAAW,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;oBAEhE,sBAAsB;oBACtB,8DAA8D;oBAC9D,IAAK,GAAW,CAAC,IAAI,KAAK,SAAS,IAAK,GAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;wBAC/D,8DAA8D;wBAC9D,MAAM,CAAC,GAAG,GAAU,CAAC;wBACrB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;4BACrB,OAAO,SAAS,CAAC,sEAAsE,CAAC,CAAC;wBAC3F,CAAC;wBACD,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;oBAC9D,CAAC;oBAED,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;oBACxD,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC;gBAAC,OAAO,SAAS,EAAE,CAAC;oBACnB,qBAAqB;oBACrB,8DAA8D;oBAC9D,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAK,SAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC;wBACpG,OAAO,SAAS,CAAC,sEAAsE,CAAC,CAAC;oBAC3F,CAAC;oBACD,MAAM,SAAS,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAEjD,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,IAAI,SAAS,CAAC;YAE/C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,UAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CACnD;oBACE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;oBAC5B,MAAM,EAAE,EAAE,YAAY,EAAE,UAAgD,EAAE;iBAC3E,EACD,IAAI,CACL,CAAC;gBAEF,8DAA8D;gBAC9D,IAAK,GAAW,CAAC,IAAI,KAAK,SAAS,IAAK,GAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBAC/D,8DAA8D;oBAC9D,MAAM,CAAC,GAAG,GAAU,CAAC;oBACrB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;wBACrB,OAAO,SAAS,CAAC,sEAAsE,CAAC,CAAC;oBAC3F,CAAC;oBACD,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBAED,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,uBAAuB,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,SAAS,EAAE,CAAC;gBACnB,8DAA8D;gBAC9D,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAK,SAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC;oBACpG,OAAO,SAAS,CAAC,sEAAsE,CAAC,CAAC;gBAC3F,CAAC;gBACD,MAAM,SAAS,CAAC;YAClB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/tools/common/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Common Tools Index
+ *
+ * User-related tools for Feishu/Lark.
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerCommonTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAOhE"}

package/dist/tools/common/index.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Common Tools Index
+ *
+ * User-related tools for Feishu/Lark.
+ */
+import { registerGetUserTool } from './get-user.js';
+import { registerSearchUserTool } from './search-user.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:common');
+export function registerCommonTools(registry) {
+    registerGetUserTool(registry);
+    registerSearchUserTool(registry);
+    log.info('Common tools registered', {
+        tools: ['feishu_get_user', 'feishu_search_user'].join(', '),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAEnC,MAAM,UAAU,mBAAmB,CAAC,QAAsB;IACxD,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9B,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAEjC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;QAClC,KAAK,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/common/search-user.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_search_user tool - Search for users.
+ */
+import type { ToolRegistry } from '../index.js';
+export declare function registerSearchUserTool(registry: ToolRegistry): void;
+//# sourceMappingURL=search-user.d.ts.map

package/dist/tools/common/search-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-user.d.ts","sourceRoot":"","sources":["../../../src/tools/common/search-user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkChD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwDnE"}

package/dist/tools/common/search-user.js

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_search_user tool - Search for users.
+ */
+import { z } from 'zod';
+import { getValidAccessToken, NeedAuthorizationError } from '../../core/uat-client.js';
+import { json, jsonError } from '../im/helpers.js';
+import { logger } from '../../utils/logger.js';
+const log = logger('tools:common:search-user');
+// Schemas
+const searchUserSchema = {
+    query: z.string().describe('Search query (matches user name, phone, email)'),
+    page_size: z.number().min(1).max(200).optional().describe('Page size (default 20)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+async function getAccessToken(context) {
+    const { larkClient, config } = context;
+    if (!larkClient)
+        return jsonError('LarkClient not initialized.');
+    const { appId, appSecret, brand } = config;
+    if (!appId || !appSecret)
+        return jsonError('Missing FEISHU_APP_ID or FEISHU_APP_SECRET.');
+    const { listStoredTokens } = await import('../../core/token-store.js');
+    const tokens = await listStoredTokens(appId);
+    if (tokens.length === 0)
+        return jsonError('No user authorization found.');
+    const userOpenId = tokens[0].userOpenId;
+    try {
+        return await getValidAccessToken({ userOpenId, appId, appSecret, domain: brand ?? 'feishu' });
+    }
+    catch (err) {
+        if (err instanceof NeedAuthorizationError)
+            return jsonError('User authorization expired.');
+        throw err;
+    }
+}
+export function registerSearchUserTool(registry) {
+    registry.register({
+        name: 'feishu_search_user',
+        description: 'Search for Feishu users by name, phone, or email.\n\nRequires OAuth authorization.',
+        inputSchema: searchUserSchema,
+        handler: async (args, context) => {
+            const p = args;
+            const { larkClient } = context;
+            const tokenResult = await getAccessToken(context);
+            if (typeof tokenResult === 'object' && 'content' in tokenResult)
+                return tokenResult;
+            const accessToken = tokenResult;
+            log.info(`search_user: query="${p.query}", page_size=${p.page_size ?? 20}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            // Build query parameters
+            const queryParams = {
+                query: p.query,
+                page_size: String(p.page_size ?? 20),
+            };
+            if (p.page_token)
+                queryParams.page_token = p.page_token;
+            // Use direct request since SDK search API may not be fully typed
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const res = await larkClient.sdk.request({
+                method: 'GET',
+                url: '/open-apis/search/v1/user',
+                params: queryParams,
+                headers: { Authorization: `Bearer ${accessToken}` },
+            }, opts);
+            // Check for API error
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            if (res.code !== undefined && res.code !== 0) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return jsonError(`API Error: code=${res.code}, msg=${res.msg}`);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = res.data;
+            const users = data?.users ?? [];
+            log.info(`search_user: found ${users.length} users`);
+            return json({
+                users,
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token,
+            });
+        },
+    });
+    log.debug('feishu_search_user tool registered');
+}
+//# sourceMappingURL=search-user.js.map

package/dist/tools/common/search-user.js.map

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

package/dist/tools/doc/create.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_create_doc tool - Create a new docx document from Markdown.
+ *
+ * Creates a new Feishu document from Markdown content.
+ * Supports async task status checking via task_id.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import type { ToolRegistry } from '../index.js';
+/**
+ * Register the feishu_create_doc tool.
+ */
+export declare function registerCreateDocTool(registry: ToolRegistry): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/tools/doc/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/doc/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmDhD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgClE"}