cc-lark 0.1.1

package/dist/tools/oauth.js

@@ -0,0 +1,379 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OAuth tool for Feishu/Lark user authorization.
+ *
+ * Provides MCP tool for OAuth 2.0 Device Authorization Grant flow.
+ * Supports 'authorize' and 'revoke' actions.
+ */
+import { z } from 'zod';
+import { requestDeviceAuthorization, pollDeviceToken, } from '../core/device-flow.js';
+import { getStoredToken, listStoredTokens, tokenStatus, } from '../core/token-store.js';
+import { getUATStatus, saveTokenFromDeviceFlow, revokeUAT } from '../core/uat-client.js';
+import { logger } from '../utils/logger.js';
+const log = logger('tools:oauth');
+// ---------------------------------------------------------------------------
+// Input schema (raw shape for ZodRawShapeCompat)
+// ---------------------------------------------------------------------------
+const OAuthInputSchema = {
+    action: z.enum(['authorize', 'revoke', 'status']).describe('The OAuth action to perform: "authorize" starts device flow, "revoke" removes stored token, "status" checks authorization status'),
+    scope: z.string().optional().describe('Space-separated list of OAuth scopes to request (e.g., "contact:user.base:readonly mail:mail:readonly"). Used with "authorize" action.'),
+    user_open_id: z.string().optional().describe('The user open_id for "revoke" or "status" action. For "authorize", this will be discovered automatically.'),
+};
+/**
+ * Handle 'authorize' action - start OAuth device flow.
+ */
+async function handleAuthorize(scope, appId, appSecret, brand) {
+    log.info('Starting device authorization flow', { scope: scope || 'default' });
+    // Default scope if not provided
+    const requestedScope = scope || 'contact:user.base:readonly';
+    try {
+        // Step 1: Request device authorization
+        let deviceAuth;
+        try {
+            deviceAuth = await requestDeviceAuthorization({
+                appId,
+                appSecret,
+                brand: brand,
+                scope: requestedScope,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.error('Device authorization request failed', { error: message });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to start OAuth flow: ${message}\n\nPlease check:\n1. Your FEISHU_APP_ID and FEISHU_APP_SECRET are correct\n2. The app is properly configured in the Developer Console`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        log.info('Device code obtained', {
+            userCode: deviceAuth.userCode,
+            verificationUri: deviceAuth.verificationUri,
+            expiresIn: deviceAuth.expiresIn,
+        });
+        // Provide instructions to the user
+        const instructions = [
+            '===========================================',
+            'OAuth Authorization Required',
+            '===========================================',
+            '',
+            `Please visit: ${deviceAuth.verificationUri}`,
+            `And enter code: ${deviceAuth.userCode}`,
+            '',
+            `Or visit directly: ${deviceAuth.verificationUriComplete}`,
+            '',
+            `This code expires in ${Math.floor(deviceAuth.expiresIn / 60)} minutes.`,
+            '',
+            'Waiting for authorization...',
+            '===========================================',
+        ].join('\n');
+        // Step 2: Poll for token
+        const result = await pollDeviceToken({
+            appId,
+            appSecret,
+            brand: brand,
+            deviceCode: deviceAuth.deviceCode,
+            interval: deviceAuth.interval,
+            expiresIn: deviceAuth.expiresIn,
+        });
+        if (!result.ok) {
+            log.warn('OAuth flow failed', { error: result.error, message: result.message });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Authorization failed: ${result.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Step 3: Get user info to determine user_open_id
+        // Note: We need to call the API with the new token to get user info
+        // For now, we'll store the token with a placeholder and the user_open_id
+        // will be retrieved from the token introspection or from stored token data
+        const { token } = result;
+        // Store the token - we need user_open_id which we can get from the token response
+        // or by calling the userinfo endpoint. For device flow, the user_open_id is
+        // typically returned in the token response or we need to call /authen/v1/user_info
+        // Save token with a temporary ID - we'll get the real user_open_id from the API
+        // For now, let's try to get user info from the token response
+        // Some OAuth providers include user info in the token response
+        // If not, we need to call a userinfo endpoint
+        // Lark's device flow response doesn't include user_open_id directly
+        // We need to call the userinfo API with the access token
+        // Let's fetch user info using the access token
+        let userOpenId;
+        try {
+            // Use the Lark API to get user info
+            const userinfoUrl = brand === 'lark'
+                ? 'https://open.larksuite.com/open-apis/authen/v1/user_info'
+                : 'https://open.feishu.cn/open-apis/authen/v1/user_info';
+            const userinfoResp = await fetch(userinfoUrl, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${token.accessToken}`,
+                },
+            });
+            const userinfoData = await userinfoResp.json();
+            if (userinfoData.code !== 0 || !userinfoData.data?.user?.open_id) {
+                // Fallback: try to get user info via tenant access token
+                // Use a placeholder for now - user can find their open_id through other means
+                log.warn('Could not fetch user info from API', { code: userinfoData.code, msg: userinfoData.msg });
+                userOpenId = 'unknown';
+            }
+            else {
+                userOpenId = userinfoData.data.user.open_id;
+                log.info('Got user open_id from userinfo API', { userOpenId });
+            }
+        }
+        catch (err) {
+            log.warn('Failed to fetch user info', { error: err instanceof Error ? err.message : String(err) });
+            userOpenId = 'unknown';
+        }
+        // Save the token
+        await saveTokenFromDeviceFlow({ appId, appSecret, userOpenId, domain: brand }, {
+            accessToken: token.accessToken,
+            refreshToken: token.refreshToken,
+            expiresIn: token.expiresIn,
+            refreshExpiresIn: token.refreshExpiresIn,
+            scope: token.scope,
+        });
+        log.info('OAuth authorization successful', { userOpenId, scope: token.scope });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        'Authorization successful!',
+                        '',
+                        `User Open ID: ${userOpenId}`,
+                        `Scope: ${token.scope}`,
+                        `Expires in: ${Math.floor(token.expiresIn / 3600)} hours`,
+                        '',
+                        'You can now use user-authorized APIs.',
+                        'Use the status action to check authorization status.',
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error('OAuth authorization failed', { error: message });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Authorization failed: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Handle 'revoke' action - remove stored token.
+ */
+async function handleRevoke(userOpenId, appId) {
+    if (!userOpenId) {
+        // List all stored tokens for this app
+        const tokens = await listStoredTokens(appId);
+        if (tokens.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No stored authorizations found.',
+                    },
+                ],
+            };
+        }
+        const tokenList = tokens
+            .map((t) => `- ${t.userOpenId} (scope: ${t.scope || 'unknown'})`)
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        'Stored authorizations:',
+                        tokenList,
+                        '',
+                        'To revoke, specify the user_open_id parameter.',
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    log.info('Revoking authorization', { userOpenId });
+    // Check if token exists
+    const token = await getStoredToken(appId, userOpenId);
+    if (!token) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No authorization found for user_open_id: ${userOpenId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Remove the token
+    await revokeUAT(appId, userOpenId);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Authorization revoked for user: ${userOpenId}`,
+            },
+        ],
+    };
+}
+/**
+ * Handle 'status' action - check authorization status.
+ */
+async function handleStatus(userOpenId, appId, appSecret, brand) {
+    if (!userOpenId) {
+        // List all stored tokens for this app
+        const tokens = await listStoredTokens(appId);
+        if (tokens.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No stored authorizations found. Use the "authorize" action to start OAuth.',
+                    },
+                ],
+            };
+        }
+        const tokenList = tokens
+            .map((t) => {
+            const status = tokenStatus(t);
+            const statusEmoji = status === 'valid' ? 'valid' : status === 'needs_refresh' ? 'expiring' : 'expired';
+            const expiresDate = new Date(t.expiresAt).toISOString();
+            return `- ${t.userOpenId}\n  Status: ${statusEmoji}\n  Scope: ${t.scope || 'unknown'}\n  Expires: ${expiresDate}`;
+        })
+            .join('\n\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ['Stored authorizations:', '', tokenList].join('\n'),
+                },
+            ],
+        };
+    }
+    log.info('Checking authorization status', { userOpenId });
+    const status = await getUATStatus({
+        userOpenId,
+        appId,
+        appSecret,
+        domain: brand,
+    });
+    if (!status.authorized) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No valid authorization for user: ${userOpenId}\n\nUse the "authorize" action to start OAuth.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const expiresDate = status.expiresAt ? new Date(status.expiresAt).toISOString() : 'unknown';
+    const refreshExpiresDate = status.refreshExpiresAt ? new Date(status.refreshExpiresAt).toISOString() : 'unknown';
+    const grantedDate = status.grantedAt ? new Date(status.grantedAt).toISOString() : 'unknown';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `Authorization status for user: ${userOpenId}`,
+                    '',
+                    `Status: ${status.tokenStatus}`,
+                    `Scope: ${status.scope || 'unknown'}`,
+                    `Expires: ${expiresDate}`,
+                    `Refresh expires: ${refreshExpiresDate}`,
+                    `Granted: ${grantedDate}`,
+                ].join('\n'),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the OAuth tool with the registry.
+ */
+export function registerOAuthTool(registry) {
+    registry.register({
+        name: 'feishu_oauth',
+        description: [
+            'Manage OAuth authorization for Feishu/Lark user access tokens.',
+            '',
+            'Actions:',
+            '- authorize: Start OAuth device flow to get user authorization. The user must visit the verification URL and enter the code.',
+            '- revoke: Remove stored authorization for a user. If no user_open_id is provided, list all authorizations.',
+            '- status: Check authorization status for a user. If no user_open_id is provided, list all authorizations.',
+            '',
+            'Scopes (for authorize action):',
+            '- contact:user.base:readonly - Basic user info',
+            '- mail:mail:readonly - Read mail',
+            '- mail:mail - Read and send mail',
+            '- docs:doc:readonly - Read documents',
+            '- docs:doc - Read and edit documents',
+            '- sheets:spreadsheet - Access spreadsheets',
+            '- drive:drive - Access drive files',
+            '',
+            'Example scopes: "contact:user.base:readonly mail:mail:readonly"',
+        ].join('\n'),
+        inputSchema: OAuthInputSchema,
+        handler: async (args, context) => {
+            const { action, scope, user_open_id } = args;
+            const { config } = context;
+            const { appId, appSecret, brand } = config;
+            // Validate required config
+            if (!appId || !appSecret) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'OAuth requires FEISHU_APP_ID and FEISHU_APP_SECRET environment variables to be set.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            switch (action) {
+                case 'authorize':
+                    return handleAuthorize(scope, appId, appSecret, brand ?? 'feishu');
+                case 'revoke':
+                    return handleRevoke(user_open_id, appId);
+                case 'status':
+                    return handleStatus(user_open_id, appId, appSecret, brand ?? 'feishu');
+                default:
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown action: ${action}. Supported actions: authorize, revoke, status.`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+        },
+    });
+    log.debug('OAuth tool registered');
+}
+//# sourceMappingURL=oauth.js.map

package/dist/tools/oauth.js.map

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

package/dist/tools/search/doc-search.d.ts

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

package/dist/tools/search/doc-search.d.ts.map

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

package/dist/tools/search/doc-search.js

@@ -0,0 +1,219 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_search_doc_wiki tool - Search Feishu documents and wikis.
+ */
+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:search:doc-wiki');
+/**
+ * Convert Unix timestamp to ISO 8601 in Shanghai timezone.
+ */
+function unixTimestampToISO8601(raw) {
+    if (raw === undefined || raw === null)
+        return null;
+    const text = typeof raw === 'number' ? String(raw) : String(raw).trim();
+    if (!/^-?\d+$/.test(text))
+        return null;
+    const num = Number(text);
+    if (!Number.isFinite(num))
+        return null;
+    const utcMs = Math.abs(num) >= 1e12 ? num : num * 1000;
+    const beijingDate = new Date(utcMs + 8 * 60 * 60 * 1000);
+    if (Number.isNaN(beijingDate.getTime()))
+        return null;
+    const year = beijingDate.getUTCFullYear();
+    const month = String(beijingDate.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(beijingDate.getUTCDate()).padStart(2, '0');
+    const hour = String(beijingDate.getUTCHours()).padStart(2, '0');
+    const minute = String(beijingDate.getUTCMinutes()).padStart(2, '0');
+    const second = String(beijingDate.getUTCSeconds()).padStart(2, '0');
+    return `${year}-${month}-${day}T${hour}:${minute}:${second}+08:00`;
+}
+/**
+ * Parse time string to Unix timestamp (seconds).
+ */
+function parseTimeToTimestamp(input) {
+    try {
+        const trimmed = input.trim();
+        const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
+        if (hasTimezone) {
+            const date = new Date(trimmed);
+            if (isNaN(date.getTime()))
+                return undefined;
+            return Math.floor(date.getTime() / 1000);
+        }
+        const normalized = trimmed.replace('T', ' ');
+        const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
+        if (!match) {
+            const date = new Date(trimmed);
+            if (isNaN(date.getTime()))
+                return undefined;
+            return Math.floor(date.getTime() / 1000);
+        }
+        const [, year, month, day, hour, minute, second] = match;
+        const utcDate = new Date(Date.UTC(parseInt(year), parseInt(month) - 1, parseInt(day), parseInt(hour) - 8, parseInt(minute), parseInt(second ?? '0')));
+        return Math.floor(utcDate.getTime() / 1000);
+    }
+    catch {
+        return undefined;
+    }
+}
+// Schemas
+const docTypeEnum = z.enum(['DOC', 'SHEET', 'BITABLE', 'MINDNOTE', 'FILE', 'WIKI', 'DOCX', 'FOLDER', 'CATALOG', 'SLIDES', 'SHORTCUT']);
+const timeRangeSchema = z.object({
+    start: z.string().optional().describe('Start time (ISO 8601 with timezone)'),
+    end: z.string().optional().describe('End time (ISO 8601 with timezone)'),
+});
+const filterSchema = z.object({
+    creator_ids: z.array(z.string()).max(20).optional().describe('Creator OpenIDs (max 20)'),
+    doc_types: z.array(docTypeEnum).max(10).optional().describe('Document types'),
+    only_title: z.boolean().optional().describe('Search title only (default: false)'),
+    open_time: timeRangeSchema.optional().describe('Open time range'),
+    create_time: timeRangeSchema.optional().describe('Create time range'),
+}).optional();
+const searchActionSchema = {
+    action: z.literal('search').describe('Search documents and wikis'),
+    query: z.string().max(50).optional().describe('Search query (optional, empty string for all)'),
+    filter: filterSchema,
+    page_size: z.number().min(1).max(20).optional().describe('Page size (default 15)'),
+    page_token: z.string().optional().describe('Pagination token'),
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function normalizeSearchResultTimeFields(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeSearchResultTimeFields(item));
+    }
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const source = value;
+    const normalized = {};
+    for (const [key, item] of Object.entries(source)) {
+        if (key.endsWith('_time')) {
+            const iso = unixTimestampToISO8601(item);
+            if (iso) {
+                normalized[key] = iso;
+                continue;
+            }
+        }
+        normalized[key] = normalizeSearchResultTimeFields(item);
+    }
+    return normalized;
+}
+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 registerSearchDocWikiTool(registry) {
+    registry.register({
+        name: 'feishu_search_doc_wiki',
+        description: 'Search Feishu documents and wikis.\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;
+            const query = p.query ?? '';
+            log.info(`search: query="${query}", has_filter=${!!p.filter}, page_size=${p.page_size ?? 15}`);
+            const Lark = await import('@larksuiteoapi/node-sdk');
+            const opts = Lark.withUserAccessToken(accessToken);
+            // Build request body
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const requestData = {
+                query,
+                page_size: p.page_size,
+                page_token: p.page_token,
+            };
+            if (p.filter) {
+                const filter = { ...p.filter };
+                // Convert time ranges
+                if (filter.open_time) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const converted = {};
+                    if (filter.open_time.start) {
+                        const ts = parseTimeToTimestamp(filter.open_time.start);
+                        if (ts !== undefined)
+                            converted.start = ts;
+                    }
+                    if (filter.open_time.end) {
+                        const ts = parseTimeToTimestamp(filter.open_time.end);
+                        if (ts !== undefined)
+                            converted.end = ts;
+                    }
+                    filter.open_time = converted;
+                }
+                if (filter.create_time) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    const converted = {};
+                    if (filter.create_time.start) {
+                        const ts = parseTimeToTimestamp(filter.create_time.start);
+                        if (ts !== undefined)
+                            converted.start = ts;
+                    }
+                    if (filter.create_time.end) {
+                        const ts = parseTimeToTimestamp(filter.create_time.end);
+                        if (ts !== undefined)
+                            converted.end = ts;
+                    }
+                    filter.create_time = converted;
+                }
+                requestData.doc_filter = filter;
+                requestData.wiki_filter = filter;
+            }
+            else {
+                requestData.doc_filter = {};
+                requestData.wiki_filter = {};
+            }
+            // Use direct request since SDK doesn't have search API
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const res = await larkClient.sdk.request({
+                method: 'POST',
+                url: '/open-apis/search/v2/doc_wiki/search',
+                data: requestData,
+                headers: {
+                    Authorization: `Bearer ${accessToken}`,
+                    'Content-Type': 'application/json; charset=utf-8',
+                },
+            }, opts);
+            // Check for API error - response might have code directly or wrapped
+            if (res.code !== undefined && res.code !== 0) {
+                return jsonError(`API Error: code=${res.code}, msg=${res.msg}`);
+            }
+            const data = res.data || {};
+            log.info(`search: found ${data.res_units?.length ?? 0} results`);
+            const normalizedResults = normalizeSearchResultTimeFields(data.res_units);
+            return json({
+                total: data.total,
+                has_more: data.has_more,
+                results: normalizedResults,
+                page_token: data.page_token,
+            });
+        },
+    });
+    log.debug('feishu_search_doc_wiki tools registered');
+}
+//# sourceMappingURL=doc-search.js.map

package/dist/tools/search/doc-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-search.js","sourceRoot":"","sources":["../../../src/tools/search/doc-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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;;GAEG;AACH,SAAS,sBAAsB,CAAC,GAAgC;IAC9D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAErD,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEpE,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,MAAM,QAAQ,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,KAAa;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAE3F,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,IAAI,CACtB,IAAI,CAAC,GAAG,CACN,QAAQ,CAAC,IAAI,CAAC,EACd,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EACnB,QAAQ,CAAC,GAAG,CAAC,EACb,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,EAChB,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,CACxB,CACF,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,UAAU;AACV,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvI,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC5E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACxF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC7E,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACjF,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACjE,WAAW,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACtE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEd,MAAM,kBAAkB,GAAG;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC9F,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC/D,CAAC;AAEF,8DAA8D;AAC9D,SAAS,+BAA+B,CAAI,KAAQ;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAM,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAmC,CAAC,CAAC;YACxE,IAAI,GAAG,EAAE,CAAC;gBACR,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;gBACtB,SAAS;YACX,CAAC;QACH,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,UAAe,CAAC;AACzB,CAAC;AAED,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,yBAAyB,CAAC,QAAsB;IAC9D,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,IAAuE,CAAC;YAClF,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,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,kBAAkB,KAAK,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;YAE/F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAEnD,qBAAqB;YACrB,8DAA8D;YAC9D,MAAM,WAAW,GAAQ;gBACvB,KAAK;gBACL,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC;YAEF,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBAE/B,sBAAsB;gBACtB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACrB,8DAA8D;oBAC9D,MAAM,SAAS,GAAQ,EAAE,CAAC;oBAC1B,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;wBAC3B,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;wBACxD,IAAI,EAAE,KAAK,SAAS;4BAAE,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC7C,CAAC;oBACD,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;wBACzB,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;wBACtD,IAAI,EAAE,KAAK,SAAS;4BAAE,SAAS,CAAC,GAAG,GAAG,EAAE,CAAC;oBAC3C,CAAC;oBACD,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC/B,CAAC;gBACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBACvB,8DAA8D;oBAC9D,MAAM,SAAS,GAAQ,EAAE,CAAC;oBAC1B,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;wBAC7B,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;wBAC1D,IAAI,EAAE,KAAK,SAAS;4BAAE,SAAS,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC7C,CAAC;oBACD,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;wBAC3B,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;wBACxD,IAAI,EAAE,KAAK,SAAS;4BAAE,SAAS,CAAC,GAAG,GAAG,EAAE,CAAC;oBAC3C,CAAC;oBACD,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;gBACjC,CAAC;gBAED,WAAW,CAAC,UAAU,GAAG,MAAM,CAAC;gBAChC,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,UAAU,GAAG,EAAE,CAAC;gBAC5B,WAAW,CAAC,WAAW,GAAG,EAAE,CAAC;YAC/B,CAAC;YAED,uDAAuD;YACvD,8DAA8D;YAC9D,MAAM,GAAG,GAAG,MAAO,UAAW,CAAC,GAAW,CAAC,OAAO,CAAC;gBACjD,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,sCAAsC;gBAC3C,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,WAAW,EAAE;oBACtC,cAAc,EAAE,iCAAiC;iBAClD;aACF,EAAE,IAAI,CAAC,CAAC;YAET,qEAAqE;YACrE,IAAK,GAAW,CAAC,IAAI,KAAK,SAAS,IAAK,GAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC/D,OAAO,SAAS,CAAC,mBAAoB,GAAW,CAAC,IAAI,SAAU,GAAW,CAAC,GAAG,EAAE,CAAC,CAAC;YACpF,CAAC;YAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAE5B,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;YACjE,MAAM,iBAAiB,GAAG,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAE1E,OAAO,IAAI,CAAC;gBACV,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,iBAAiB;gBAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AACvD,CAAC"}

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

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

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

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