@larksuite/openclaw-lark 2026.3.9

package/src/core/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Core type definitions for the OpenClaw Feishu/Lark channel plugin.
+ *
+ * Contains inferred Zod config types, domain/connection enums, identifier types,
+ * tools configuration, and account types. Messaging, outbound, and channel types
+ * live in their respective module type files.
+ */
+import type { FeishuConfigSchema, FeishuGroupSchema, FeishuAccountConfigSchema, UATConfigSchema, z } from './config-schema';
+/** Fully resolved top-level Feishu channel configuration. */
+export type FeishuConfig = z.infer<typeof FeishuConfigSchema>;
+/** Per-group configuration overrides. */
+export type FeishuGroupConfig = z.infer<typeof FeishuGroupSchema>;
+/** Per-account configuration overrides (mirrors top-level minus `accounts`). */
+export type FeishuAccountConfig = z.infer<typeof FeishuAccountConfigSchema>;
+/**
+ * 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 & {});
+/** How the plugin connects to Feishu to receive events. */
+export type FeishuConnectionMode = 'websocket' | 'webhook';
+/** The four ID types recognised by the Feishu API. */
+export type FeishuIdType = 'open_id' | 'user_id' | 'union_id' | 'chat_id';
+/** Per-feature toggles for the Feishu-specific tool capabilities. */
+export interface FeishuToolsConfig {
+    doc?: boolean;
+    wiki?: boolean;
+    drive?: boolean;
+    perm?: boolean;
+    scopes?: boolean;
+    mail?: boolean;
+    sheets?: boolean;
+    okr?: boolean;
+}
+/** Per-feature toggles for card footer metadata visibility. */
+export interface FeishuFooterConfig {
+    status?: boolean;
+    elapsed?: boolean;
+}
+/** Common fields shared by all resolved account states. */
+interface LarkAccountBase {
+    accountId: string;
+    enabled: boolean;
+    name?: string;
+    encryptKey?: string;
+    verificationToken?: string;
+    brand: LarkBrand;
+    config: FeishuConfig;
+}
+/** An account with both `appId` and `appSecret` present. */
+export type ConfiguredLarkAccount = LarkAccountBase & {
+    configured: true;
+    appId: string;
+    appSecret: string;
+};
+/** An account that is missing `appId` and/or `appSecret`. */
+export type UnconfiguredLarkAccount = LarkAccountBase & {
+    configured: false;
+    appId?: string;
+    appSecret?: string;
+};
+/** A resolved Lark account — either fully configured or not. */
+export type LarkAccount = ConfiguredLarkAccount | UnconfiguredLarkAccount;
+/** UAT (User Access Token) configuration. */
+export type FeishuUATConfig = z.infer<typeof UATConfigSchema>;
+/** The minimum credential set needed to interact with the Lark API. */
+export interface LarkCredentials {
+    appId: string;
+    appSecret: string;
+    encryptKey?: string;
+    verificationToken?: string;
+    brand: LarkBrand;
+}
+/** Result of probing an app's connectivity / permissions. */
+export interface FeishuProbeResult {
+    ok: boolean;
+    error?: string;
+    appId?: string;
+    botName?: string;
+    botOpenId?: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/src/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/src/core/types.js

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Core type definitions for the OpenClaw Feishu/Lark channel plugin.
+ *
+ * Contains inferred Zod config types, domain/connection enums, identifier types,
+ * tools configuration, and account types. Messaging, outbound, and channel types
+ * live in their respective module type files.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/src/core/types.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT (User Access Token) API call wrapper.
+ *
+ * Provides a safe, auto-refreshing interface for making Feishu API calls on
+ * behalf of a user.  Tokens are read from the OS Keychain, refreshed
+ * transparently, and **never** exposed to the AI layer.
+ */
+import type { LarkBrand } from './types';
+import { NeedAuthorizationError } from './auth-errors';
+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 Keychain.
+ * - 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>;
+/**
+ * Revoke a user's UAT by removing it from the Keychain.
+ */
+export declare function revokeUAT(appId: string, userOpenId: string): Promise<void>;
+//# sourceMappingURL=uat-client.d.ts.map

package/src/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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAczC,OAAO,EAAkD,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvG,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+GD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB/E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBnH;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF"}

package/src/core/uat-client.js

@@ -0,0 +1,173 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * UAT (User Access Token) API call wrapper.
+ *
+ * Provides a safe, auto-refreshing interface for making Feishu API calls on
+ * behalf of a user.  Tokens are read from the OS Keychain, refreshed
+ * transparently, and **never** exposed to the AI layer.
+ */
+import { getStoredToken, setStoredToken, removeStoredToken, tokenStatus, maskToken, } from './token-store';
+import { resolveOAuthEndpoints } from './device-flow';
+import { larkLogger } from './lark-logger';
+const log = larkLogger('core/uat-client');
+import { feishuFetch } from './feishu-fetch';
+import { REFRESH_TOKEN_IRRECOVERABLE, TOKEN_RETRY_CODES, NeedAuthorizationError } from './auth-errors';
+// Re-export for backward compatibility
+export { NeedAuthorizationError };
+// ---------------------------------------------------------------------------
+// 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 feishuFetch(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());
+    // Feishu 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 Keychain.
+ * - 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) {
+    // Owner 检查已迁移到 owner-policy.ts（由 tool-client.ts 的 invokeAsUser 调用）
+    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;
+    }
+}
+/**
+ * Revoke a user's UAT by removing it from the Keychain.
+ */
+export async function revokeUAT(appId, userOpenId) {
+    await removeStoredToken(appId, userOpenId);
+    log.info(`revoked UAT for ${userOpenId}`);
+}
+//# sourceMappingURL=uat-client.js.map

package/src/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/src/core/version.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * 插件版本号管理
+ *
+ * 从 package.json 读取版本号并生成 User-Agent 字符串。
+ */
+/**
+ * 获取插件版本号（从 package.json 读取）
+ *
+ * @returns 版本号字符串，如 "2026.2.28.5"；读取失败返回 "unknown"
+ */
+export declare function getPluginVersion(): string;
+/**
+ * 生成 User-Agent 字符串
+ *
+ * @returns User-Agent 字符串，格式：`feishu-openclaw-plugin/{version}`
+ *
+ * @example
+ * ```typescript
+ * getUserAgent() // => "feishu-openclaw-plugin/2026.2.28.5"
+ * ```
+ */
+export declare function getUserAgent(): string;
+//# sourceMappingURL=version.d.ts.map

package/src/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,gBAAgB,IAAI,MAAM,CAiBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/src/core/version.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * 插件版本号管理
+ *
+ * 从 package.json 读取版本号并生成 User-Agent 字符串。
+ */
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+/** 缓存的版本号 */
+let cachedVersion;
+/**
+ * 获取插件版本号（从 package.json 读取）
+ *
+ * @returns 版本号字符串，如 "2026.2.28.5"；读取失败返回 "unknown"
+ */
+export function getPluginVersion() {
+    if (cachedVersion)
+        return cachedVersion;
+    try {
+        // 当前文件: src/core/version.ts → 向上两级到达项目根目录
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packageJsonPath = join(__dirname, '..', '..', 'package.json');
+        const raw = readFileSync(packageJsonPath, 'utf8');
+        const pkg = JSON.parse(raw);
+        cachedVersion = pkg.version ?? 'unknown';
+        return cachedVersion;
+    }
+    catch {
+        cachedVersion = 'unknown';
+        return cachedVersion;
+    }
+}
+/**
+ * 生成 User-Agent 字符串
+ *
+ * @returns User-Agent 字符串，格式：`feishu-openclaw-plugin/{version}`
+ *
+ * @example
+ * ```typescript
+ * getUserAgent() // => "feishu-openclaw-plugin/2026.2.28.5"
+ * ```
+ */
+export function getUserAgent() {
+    return `feishu-openclaw-plugin/${getPluginVersion()}`;
+}
+//# sourceMappingURL=version.js.map

package/src/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,aAAa;AACb,IAAI,aAAiC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAEpE,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACpD,aAAa,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;QACzC,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,SAAS,CAAC;QAC1B,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,0BAA0B,gBAAgB,EAAE,EAAE,CAAC;AACxD,CAAC"}

package/src/messaging/converters/audio.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "audio" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertAudio: ContentConverterFn;
+//# sourceMappingURL=audio.d.ts.map

package/src/messaging/converters/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/audio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,eAAO,MAAM,YAAY,EAAE,kBAoB1B,CAAC"}

package/src/messaging/converters/audio.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "audio" message type.
+ */
+import { safeParse } from './utils';
+import { formatDuration } from './utils';
+export const convertAudio = (raw) => {
+    const parsed = safeParse(raw);
+    const fileKey = parsed?.file_key;
+    if (!fileKey) {
+        return { content: '[audio]', resources: [] };
+    }
+    const duration = parsed?.duration;
+    const durationAttr = duration != null ? ` duration="${formatDuration(duration)}"` : '';
+    return {
+        content: `<audio key="${fileKey}"${durationAttr}/>`,
+        resources: [{ type: 'audio', fileKey, duration: duration ?? undefined }],
+    };
+};
+//# sourceMappingURL=audio.js.map

package/src/messaging/converters/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../../../src/messaging/converters/audio.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAuB,CAAC,GAAG,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAKf,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,EAAE,QAAQ,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;IAClC,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvF,OAAO;QACL,OAAO,EAAE,eAAe,OAAO,IAAI,YAAY,IAAI;QACnD,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/calendar.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converters for calendar-related message types:
+ * - share_calendar_event
+ * - calendar
+ * - general_calendar
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertShareCalendarEvent: ContentConverterFn;
+export declare const convertCalendar: ContentConverterFn;
+export declare const convertGeneralCalendar: ContentConverterFn;
+//# sourceMappingURL=calendar.d.ts.map

package/src/messaging/converters/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA4BlD,eAAO,MAAM,yBAAyB,EAAE,kBAQvC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,kBAQ7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,kBAQpC,CAAC"}

package/src/messaging/converters/calendar.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converters for calendar-related message types:
+ * - share_calendar_event
+ * - calendar
+ * - general_calendar
+ */
+import { safeParse, millisToDatetime } from './utils';
+function formatCalendarContent(parsed) {
+    const summary = parsed?.summary ?? '';
+    const parts = [];
+    if (summary) {
+        parts.push(`📅 ${summary}`);
+    }
+    const start = parsed?.start_time ? millisToDatetime(parsed.start_time) : '';
+    const end = parsed?.end_time ? millisToDatetime(parsed.end_time) : '';
+    if (start && end) {
+        parts.push(`🕙 ${start} ~ ${end}`);
+    }
+    else if (start) {
+        parts.push(`🕙 ${start}`);
+    }
+    return parts.join('\n') || '[calendar event]';
+}
+export const convertShareCalendarEvent = (raw) => {
+    const parsed = safeParse(raw);
+    const inner = formatCalendarContent(parsed);
+    return {
+        content: `<calendar_share>${inner}</calendar_share>`,
+        resources: [],
+    };
+};
+export const convertCalendar = (raw) => {
+    const parsed = safeParse(raw);
+    const inner = formatCalendarContent(parsed);
+    return {
+        content: `<calendar_invite>${inner}</calendar_invite>`,
+        resources: [],
+    };
+};
+export const convertGeneralCalendar = (raw) => {
+    const parsed = safeParse(raw);
+    const inner = formatCalendarContent(parsed);
+    return {
+        content: `<calendar>${inner}</calendar>`,
+        resources: [],
+    };
+};
+//# sourceMappingURL=calendar.js.map

package/src/messaging/converters/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../../src/messaging/converters/calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQtD,SAAS,qBAAqB,CAAC,MAAgC;IAC7D,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAuB,CAAC,GAAG,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA6B,CAAC;IAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,OAAO,EAAE,mBAAmB,KAAK,mBAAmB;QACpD,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAuB,CAAC,GAAG,EAAE,EAAE;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA6B,CAAC;IAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,OAAO,EAAE,oBAAoB,KAAK,oBAAoB;QACtD,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAuB,CAAC,GAAG,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA6B,CAAC;IAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,OAAO,EAAE,aAAa,KAAK,aAAa;QACxC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/content-converter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Content converter for Feishu messages.
+ *
+ * Each message type (text, post, image, etc.) has a dedicated converter
+ * function that parses raw JSON content into an AI-friendly text
+ * representation plus a list of resource descriptors.
+ *
+ * This module is a general-purpose message parsing utility — usable
+ * from inbound handling, outbound formatting, and skills.
+ */
+import type { ApiMessageItem, ConvertContext, ConvertResult } from './types';
+export type { ApiMessageItem, ConvertContext, ConvertResult, ContentConverterFn } from './types';
+/** 从 mention 的 id 字段提取 open_id（兼容事件推送的对象格式和 API 响应的字符串格式） */
+export declare function extractMentionOpenId(id: unknown): string;
+/**
+ * Convert raw message content using the converter for the given message
+ * type. Falls back to the "unknown" converter for unrecognised types.
+ *
+ * Returns a Promise because some converters (e.g. merge_forward) perform
+ * async operations. Synchronous converters are awaited transparently.
+ */
+export declare function convertMessageContent(raw: string, messageType: string, ctx: ConvertContext): Promise<ConvertResult>;
+/**
+ * Build a {@link ConvertContext} from a raw Feishu API message item.
+ *
+ * Extracts the `mentions` array that the IM API returns on each message
+ * item and maps it into the key→MentionInfo / openId→MentionInfo
+ * structures the converter system expects.
+ */
+export declare function buildConvertContextFromItem(item: ApiMessageItem, fallbackMessageId: string, accountId?: string): ConvertContext;
+/**
+ * Resolve mention placeholders in text.
+ *
+ * - Bot mentions: remove the placeholder key and any preceding `@botName`
+ *   entirely (with trailing whitespace).
+ * - Non-bot mentions: replace the placeholder key with readable `@name`.
+ */
+export declare function resolveMentions(text: string, ctx: ConvertContext): string;
+//# sourceMappingURL=content-converter.d.ts.map

package/src/messaging/converters/content-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-converter.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/content-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAMjG,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAOxD;AAMD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CAMxB;AAMD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,EACpB,iBAAiB,EAAE,MAAM,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAyBhB;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAczE"}