cc-lark 0.1.1

package/dist/core/types.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Core type definitions for the cc-lark MCP Server.
+ *
+ * Contains Feishu/Lark API types, configuration interfaces, and MCP-specific types.
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+/**
+ * The Lark platform brand.
+ * - `"feishu"` targets the China-mainland Feishu service.
+ * - `"lark"` targets the international Lark service.
+ * - Any other string is treated as a custom base URL.
+ */
+export type LarkBrand = 'feishu' | 'lark' | (string & {});
+/** The four ID types recognised by the Feishu API. */
+export type FeishuIdType = 'open_id' | 'user_id' | 'union_id' | 'chat_id';
+/** Standard MCP tool result structure. */
+export interface ToolResult {
+    content: Array<{
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+        resource?: {
+            uri: string;
+            name: string;
+            mimeType?: string;
+            text?: string;
+            blob?: string;
+        };
+    }>;
+    isError?: boolean;
+}
+/** Tool definition for MCP server. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/** Feishu configuration loaded from environment variables. */
+export interface FeishuConfig {
+    /** Feishu App ID */
+    appId: string;
+    /** Feishu App Secret */
+    appSecret: string;
+    /** User Access Token (optional, for user-authorized operations) */
+    userAccessToken?: string;
+    /** The Lark platform brand (feishu, lark, or custom URL) */
+    brand?: LarkBrand;
+    /** Encrypt key for webhook event decryption */
+    encryptKey?: string;
+    /** Verification token for webhook validation */
+    verificationToken?: string;
+}
+/** Validation result for configuration. */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    config?: FeishuConfig;
+}
+/** The minimum credential set needed to interact with the Lark API. */
+export interface LarkCredentials {
+    appId: string;
+    appSecret: string;
+    encryptKey?: string;
+    verificationToken?: string;
+    brand: LarkBrand;
+}
+/** Base response from Lark API. */
+export interface LarkApiResponse<T = unknown> {
+    code: number;
+    msg: string;
+    data?: T;
+}
+/** Token response from Lark API. */
+export interface LarkTokenResponse {
+    tenant_access_token: string;
+    expire: number;
+}
+/** User info from Lark API. */
+export interface LarkUserInfo {
+    open_id: string;
+    user_id?: string;
+    union_id?: string;
+    name?: string;
+    en_name?: string;
+    nickname?: string;
+    email?: string;
+    mobile?: string;
+    gender?: number;
+    avatar_url?: string;
+    status?: {
+        is_frozen?: boolean;
+        is_resigned?: boolean;
+        is_activated?: boolean;
+    };
+    department_ids?: string[];
+    leader_user_id?: string;
+    city?: string;
+    country?: string;
+    work_station?: string;
+    join_time?: number;
+    employee_no?: string;
+    employee_type?: number;
+    positions?: string[];
+    orders?: number;
+}
+/** Message content types. */
+export type LarkMessageContent = {
+    text: string;
+} | {
+    image_key: string;
+} | {
+    file_key: string;
+} | {
+    audio_key: string;
+} | {
+    media_key: string;
+} | {
+    sticker_key: string;
+} | {
+    rich_text: LarkRichTextContent;
+};
+/** Rich text content structure. */
+export interface LarkRichTextContent {
+    zh_cn?: LarkRichTextSection[];
+    en_us?: LarkRichTextSection[];
+}
+/** Rich text section. */
+export interface LarkRichTextSection {
+    title?: string;
+    lines?: LarkRichTextLine[];
+}
+/** Rich text line. */
+export interface LarkRichTextLine {
+    text_run?: {
+        text: string;
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+        strikethrough?: boolean;
+        inline_code?: boolean;
+        color?: string;
+        link?: string;
+    };
+    mention_run?: {
+        text: string;
+        user_id: string;
+    };
+    equation_run?: {
+        text: string;
+    };
+}
+/** Docx document metadata. */
+export interface LarkDocxDocument {
+    document_id: string;
+    revision_id: number;
+    title: string;
+    create_time: number;
+    update_time: number;
+}
+/** Docx block content. */
+export interface LarkDocxBlock {
+    block_type: number;
+    block_id: string;
+    parent_id?: string;
+    children?: string[];
+    text?: {
+        initial_style: Record<string, unknown>;
+        elements: Array<{
+            text_run?: {
+                content: string;
+            };
+            mention_run?: {
+                user_id: string;
+                text: string;
+            };
+            equation_run?: {
+                content: string;
+            };
+        }>;
+    };
+    heading1?: {
+        elements: unknown[];
+    };
+    heading2?: {
+        elements: unknown[];
+    };
+    heading3?: {
+        elements: unknown[];
+    };
+    heading4?: {
+        elements: unknown[];
+    };
+    heading5?: {
+        elements: unknown[];
+    };
+    heading6?: {
+        elements: unknown[];
+    };
+    heading7?: {
+        elements: unknown[];
+    };
+    heading8?: {
+        elements: unknown[];
+    };
+    heading9?: {
+        elements: unknown[];
+    };
+    bullet?: {
+        elements: unknown[];
+    };
+    ordered?: {
+        elements: unknown[];
+    };
+    code?: {
+        elements: unknown[];
+    };
+    quote?: {
+        elements: unknown[];
+    };
+    table?: {
+        rows: number;
+        columns: number;
+        property: {
+            row_size: number[];
+            column_size: number[];
+        };
+        cells: string[];
+    };
+    table_cell?: {
+        property: Record<string, unknown>;
+    };
+}
+/** Spreadsheet metadata. */
+export interface LarkSpreadsheet {
+    spreadsheet_token: string;
+    name: string;
+    revision: number;
+    owner_id: string;
+    create_time: number;
+    update_time: number;
+}
+/** Sheet (worksheet) metadata. */
+export interface LarkSheet {
+    sheet_id: string;
+    title: string;
+    index: number;
+    row_count: number;
+    column_count: number;
+    frozen_row_count?: number;
+    frozen_column_count?: number;
+}
+/** Sheet cell value. */
+export interface LarkCellValue {
+    value: string;
+    type: number;
+}
+/** Drive file metadata. */
+export interface LarkDriveFile {
+    token: string;
+    name: string;
+    type: string;
+    parent_token: string;
+    create_time: number;
+    update_time: number;
+    size: number;
+    creator_id?: string;
+    modifier_id?: string;
+}
+/** Drive folder metadata. */
+export interface LarkDriveFolder {
+    token: string;
+    name: string;
+    parent_token: string;
+    create_time: number;
+    update_time: number;
+    creator_id?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Core type definitions for the cc-lark MCP Server.
+ *
+ * Contains Feishu/Lark API types, configuration interfaces, and MCP-specific types.
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/core/uat-client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT (User Access Token) API call wrapper for cc-lark MCP Server.
+ *
+ * Provides a safe, auto-refreshing interface for making Lark API calls on
+ * behalf of a user. Tokens are read from file-based storage, refreshed
+ * transparently, and never exposed to the AI layer.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import type { LarkBrand } from './types.js';
+import { type StoredUAToken } from './token-store.js';
+import { NeedAuthorizationError } from './api-error.js';
+export { NeedAuthorizationError };
+export interface UATCallOptions {
+    userOpenId: string;
+    appId: string;
+    appSecret: string;
+    domain: LarkBrand;
+}
+export interface UATStatus {
+    authorized: boolean;
+    userOpenId: string;
+    scope?: string;
+    expiresAt?: number;
+    refreshExpiresAt?: number;
+    grantedAt?: number;
+    tokenStatus?: 'valid' | 'needs_refresh' | 'expired';
+}
+/**
+ * Obtain a valid access_token for the given user.
+ *
+ * - Reads from storage.
+ * - Refreshes proactively if the token is about to expire.
+ * - Throws when no token exists or refresh fails irrecoverably.
+ *
+ * The returned token must never be exposed to the AI layer.
+ */
+export declare function getValidAccessToken(opts: UATCallOptions): Promise<string>;
+/**
+ * Execute an API call with a valid UAT, retrying once on token-expiry errors.
+ */
+export declare function callWithUAT<T>(opts: UATCallOptions, apiCall: (accessToken: string) => Promise<T>): Promise<T>;
+/**
+ * Get the current UAT status for a user.
+ */
+export declare function getUATStatus(opts: UATCallOptions): Promise<UATStatus>;
+/**
+ * Save a new token from OAuth device flow.
+ */
+export declare function saveTokenFromDeviceFlow(opts: UATCallOptions, tokenData: {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+    refreshExpiresIn: number;
+    scope: string;
+}): Promise<StoredUAToken>;
+/**
+ * Revoke a user's UAT by removing it from storage.
+ */
+export declare function revokeUAT(appId: string, userOpenId: string): Promise<void>;
+//# sourceMappingURL=uat-client.d.ts.map

package/dist/core/uat-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uat-client.d.ts","sourceRoot":"","sources":["../../src/core/uat-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAkD,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAKxG,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAMlC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;CACrD;AA+HD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB/E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC,CAkBZ;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB3E;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,aAAa,CAAC,CAexB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF"}

package/dist/core/uat-client.js

@@ -0,0 +1,227 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT (User Access Token) API call wrapper for cc-lark MCP Server.
+ *
+ * Provides a safe, auto-refreshing interface for making Lark API calls on
+ * behalf of a user. Tokens are read from file-based storage, refreshed
+ * transparently, and never exposed to the AI layer.
+ *
+ * Adapted from openclaw-lark for MCP Server architecture.
+ */
+import { getStoredToken, setStoredToken, removeStoredToken, tokenStatus, maskToken, } from './token-store.js';
+import { resolveOAuthEndpoints } from './device-flow.js';
+import { logger } from '../utils/logger.js';
+import { getUserAgent } from './version.js';
+import { REFRESH_TOKEN_IRRECOVERABLE, TOKEN_RETRY_CODES, NeedAuthorizationError } from './api-error.js';
+const log = logger('uat-client');
+// Re-export for backward compatibility
+export { NeedAuthorizationError };
+// ---------------------------------------------------------------------------
+// HTTP helper
+// ---------------------------------------------------------------------------
+/**
+ * Header-aware fetch for Lark API calls.
+ */
+function larkFetch(url, init) {
+    const headers = {
+        ...init?.headers,
+        'User-Agent': getUserAgent(),
+    };
+    return fetch(url, { ...init, headers });
+}
+// ---------------------------------------------------------------------------
+// Per-user refresh lock
+// ---------------------------------------------------------------------------
+/**
+ * Guards against concurrent refresh operations for the same user.
+ *
+ * refresh_token is single-use: if two requests trigger a refresh
+ * simultaneously, the second one would use an already-consumed token and
+ * fail. The lock ensures only one refresh runs at a time per user.
+ */
+const refreshLocks = new Map();
+// ---------------------------------------------------------------------------
+// Refresh implementation
+// ---------------------------------------------------------------------------
+async function doRefreshToken(opts, stored) {
+    // refresh_token already expired → can't refresh, need re-auth.
+    if (Date.now() >= stored.refreshExpiresAt) {
+        log.info(`refresh_token expired for ${opts.userOpenId}, clearing`);
+        await removeStoredToken(opts.appId, opts.userOpenId);
+        return null;
+    }
+    const endpoints = resolveOAuthEndpoints(opts.domain);
+    const resp = await larkFetch(endpoints.token, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+            grant_type: 'refresh_token',
+            refresh_token: stored.refreshToken,
+            client_id: opts.appId,
+            client_secret: opts.appSecret,
+        }).toString(),
+    });
+    const data = (await resp.json());
+    // Lark v2 token endpoint returns `code: 0` on success.
+    // Some responses use `error` field instead (standard OAuth).
+    const code = data.code;
+    const error = data.error;
+    if ((code !== undefined && code !== 0) || error) {
+        const errCode = code ?? error;
+        const errMsg = data.error_description ?? data.msg ?? 'unknown';
+        // Known irrecoverable codes: invalid/expired/missing refresh_token
+        if (REFRESH_TOKEN_IRRECOVERABLE.has(code)) {
+            log.warn(`refresh failed (code=${errCode}), clearing token for ${opts.userOpenId}`);
+            await removeStoredToken(opts.appId, opts.userOpenId);
+            return null;
+        }
+        throw new Error(`Token refresh failed (code=${errCode}): ${errMsg}`);
+    }
+    if (!data.access_token) {
+        throw new Error('Token refresh returned no access_token');
+    }
+    const now = Date.now();
+    const updated = {
+        userOpenId: stored.userOpenId,
+        appId: opts.appId,
+        accessToken: data.access_token,
+        // refresh_token is rotated – always use the new one.
+        refreshToken: data.refresh_token ?? stored.refreshToken,
+        expiresAt: now + (data.expires_in ?? 7200) * 1000,
+        refreshExpiresAt: data.refresh_token_expires_in
+            ? now + data.refresh_token_expires_in * 1000
+            : stored.refreshExpiresAt,
+        scope: data.scope ?? stored.scope,
+        grantedAt: stored.grantedAt,
+    };
+    await setStoredToken(updated);
+    log.info(`refreshed UAT for ${opts.userOpenId} (at:${maskToken(updated.accessToken)})`);
+    return updated;
+}
+/**
+ * Refresh with per-user locking.
+ */
+async function refreshWithLock(opts, stored) {
+    const key = `${opts.appId}:${opts.userOpenId}`;
+    // Another refresh is already in-flight – wait for it and re-read.
+    const existing = refreshLocks.get(key);
+    if (existing) {
+        await existing;
+        return getStoredToken(opts.appId, opts.userOpenId);
+    }
+    const promise = doRefreshToken(opts, stored);
+    refreshLocks.set(key, promise);
+    try {
+        return await promise;
+    }
+    finally {
+        refreshLocks.delete(key);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Obtain a valid access_token for the given user.
+ *
+ * - Reads from storage.
+ * - Refreshes proactively if the token is about to expire.
+ * - Throws when no token exists or refresh fails irrecoverably.
+ *
+ * The returned token must never be exposed to the AI layer.
+ */
+export async function getValidAccessToken(opts) {
+    const stored = await getStoredToken(opts.appId, opts.userOpenId);
+    if (!stored) {
+        throw new NeedAuthorizationError(opts.userOpenId);
+    }
+    const status = tokenStatus(stored);
+    if (status === 'valid') {
+        return stored.accessToken;
+    }
+    if (status === 'needs_refresh') {
+        const refreshed = await refreshWithLock(opts, stored);
+        if (!refreshed) {
+            throw new NeedAuthorizationError(opts.userOpenId);
+        }
+        return refreshed.accessToken;
+    }
+    // expired
+    await removeStoredToken(opts.appId, opts.userOpenId);
+    throw new NeedAuthorizationError(opts.userOpenId);
+}
+/**
+ * Execute an API call with a valid UAT, retrying once on token-expiry errors.
+ */
+export async function callWithUAT(opts, apiCall) {
+    const accessToken = await getValidAccessToken(opts);
+    try {
+        return await apiCall(accessToken);
+    }
+    catch (err) {
+        // Retry once if the server reports token invalid/expired.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const code = err?.code ?? err?.response?.data?.code;
+        if (TOKEN_RETRY_CODES.has(code)) {
+            log.warn(`API call failed (code=${code}), refreshing and retrying`);
+            const stored = await getStoredToken(opts.appId, opts.userOpenId);
+            if (!stored)
+                throw new NeedAuthorizationError(opts.userOpenId);
+            const refreshed = await refreshWithLock(opts, stored);
+            if (!refreshed)
+                throw new NeedAuthorizationError(opts.userOpenId);
+            return await apiCall(refreshed.accessToken);
+        }
+        throw err;
+    }
+}
+/**
+ * Get the current UAT status for a user.
+ */
+export async function getUATStatus(opts) {
+    const stored = await getStoredToken(opts.appId, opts.userOpenId);
+    if (!stored) {
+        return {
+            authorized: false,
+            userOpenId: opts.userOpenId,
+        };
+    }
+    const status = tokenStatus(stored);
+    return {
+        authorized: status !== 'expired',
+        userOpenId: opts.userOpenId,
+        scope: stored.scope,
+        expiresAt: stored.expiresAt,
+        refreshExpiresAt: stored.refreshExpiresAt,
+        grantedAt: stored.grantedAt,
+        tokenStatus: status,
+    };
+}
+/**
+ * Save a new token from OAuth device flow.
+ */
+export async function saveTokenFromDeviceFlow(opts, tokenData) {
+    const now = Date.now();
+    const stored = {
+        userOpenId: opts.userOpenId,
+        appId: opts.appId,
+        accessToken: tokenData.accessToken,
+        refreshToken: tokenData.refreshToken,
+        expiresAt: now + tokenData.expiresIn * 1000,
+        refreshExpiresAt: now + tokenData.refreshExpiresIn * 1000,
+        scope: tokenData.scope,
+        grantedAt: now,
+    };
+    await setStoredToken(stored);
+    return stored;
+}
+/**
+ * Revoke a user's UAT by removing it from storage.
+ */
+export async function revokeUAT(appId, userOpenId) {
+    await removeStoredToken(appId, userOpenId);
+    log.info(`revoked UAT for ${userOpenId}`);
+}
+//# sourceMappingURL=uat-client.js.map

package/dist/core/uat-client.js.map

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

package/dist/core/version.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Version management for cc-lark MCP Server.
+ *
+ * Reads version from package.json and generates User-Agent string.
+ */
+/**
+ * Get the package version from package.json.
+ *
+ * @returns Version string (e.g., "0.1.0") or "unknown" if read fails
+ */
+export declare function getPackageVersion(): string;
+/**
+ * Generate User-Agent string for HTTP requests.
+ *
+ * @returns User-Agent string (e.g., "cc-lark/0.1.0")
+ *
+ * @example
+ * ```typescript
+ * getUserAgent() // => "cc-lark/0.1.0"
+ * ```
+ */
+export declare function getUserAgent(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/core/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAiB1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}