@larksuite/openclaw-lark 2026.3.26 → 2026.3.29-beta.0

package/bin/openclaw-lark.js

@@ -1,47 +1,35 @@
 #!/usr/bin/env node
-
-import { execFileSync } from "node:child_process";
-import { dirname, join } from "node:path";
+import { execFileSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
 
 // --tools-version <ver> lets the user pin a specific version
 const args = process.argv.slice(2);
-let version = "latest";
+let version = 'latest';
 
-const vIdx = args.indexOf("--tools-version");
+const vIdx = args.indexOf('--tools-version');
 if (vIdx !== -1) {
   version = args[vIdx + 1];
   // Remove --tools-version <ver> from forwarded args
   args.splice(vIdx, 2);
 }
 
-const allArgs = ["--yes", "--prefer-online", `@larksuite/openclaw-lark-tools@${version}`, ...args];
+const allArgs = ['--yes', '--prefer-online', `@larksuite/openclaw-lark-tools@${version}`, ...args];
 
 try {
-  if (process.platform === "win32") {
+  if (process.platform === 'win32') {
     // On Windows, npx is a .cmd shim that can be broken or trigger
     // DEP0190. Bypass it entirely: run node with the npx-cli.js
     // script located next to the running node binary.
-    const npxCli = join(
-      dirname(process.execPath),
-      "node_modules",
-      "npm",
-      "bin",
-      "npx-cli.js",
-    );
+    const npxCli = join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npx-cli.js');
     execFileSync(process.execPath, [npxCli, ...allArgs], {
-      stdio: "inherit",
+      stdio: 'inherit',
       env: {
         ...process.env,
-        NODE_OPTIONS: [
-          process.env.NODE_OPTIONS,
-          "--disable-warning=DEP0190",
-        ]
-          .filter(Boolean)
-          .join(" "),
+        NODE_OPTIONS: [process.env.NODE_OPTIONS, '--disable-warning=DEP0190'].filter(Boolean).join(' '),
       },
     });
   } else {
-    execFileSync("npx", allArgs, { stdio: "inherit" });
+    execFileSync('npx', allArgs, { stdio: 'inherit' });
   }
 } catch (error) {
   process.exit(error.status ?? 1);

package/openclaw.plugin.json

@@ -6,5 +6,12 @@
     "type": "object",
     "additionalProperties": false,
     "properties": {}
+  },
+  "channelConfigs": {
+    "feishu": {
+      "schema": {
+        "type": "object"
+      }
+    }
   }
-}
+}

package/package.json

@@ -1,16 +1,29 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.3.26",
+  "version": "2026.3.29-beta.0",
   "description": "OpenClaw Lark/Feishu channel plugin",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
     "openclaw-lark": "bin/openclaw-lark.js"
   },
-  "main": "index.js",
   "files": [
     "**/*"
   ],
+  "packageManager": "pnpm@10.32.1",
+  "engines": {
+    "node": ">=22"
+  },
   "dependencies": {
-    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@larksuiteoapi/node-sdk": "^1.60.0",
     "@sinclair/typebox": "0.34.48",
     "image-size": "^2.0.2",
     "zod": "^4.3.6"
@@ -40,13 +53,5 @@
       "localPath": "extensions/feishu",
       "defaultChoice": "npm"
     }
-  },
-  "types": "index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js",
-      "default": "./index.js"
-    }
   }
 }

package/src/card/builder.js

@@ -138,12 +138,14 @@ function formatElapsed(ms) {
 function buildFooter(zhText, enText, isError) {
     const zhContent = isError ? `<font color='red'>${zhText}</font>` : zhText;
     const enContent = isError ? `<font color='red'>${enText}</font>` : enText;
-    return [{
+    return [
+        {
             tag: 'markdown',
             content: enContent,
             i18n_content: { zh_cn: zhContent, en_us: enContent },
             text_size: 'notation',
-        }];
+        },
+    ];
 }
 function compactNumber(value) {
     const abs = Math.abs(value);
@@ -381,7 +383,7 @@ function buildCompleteCard(params) {
     }
     // Use the answer text (not reasoning) as the feed preview summary.
     // Strip markdown syntax so the preview reads as plain text.
-    const summaryText = text.replace(/[*_`#>\[\]()~]/g, '').trim();
+    const summaryText = text.replace(/[*_`#>[\]()~]/g, '').trim();
     const summary = summaryText ? { content: summaryText.slice(0, 120) } : undefined;
     return {
         config: { wide_screen_mode: true, update_multi: true, locales: ['zh_cn', 'en_us'], summary },

package/src/card/card-error.js

@@ -140,7 +140,7 @@ function findMarkdownTablesOutsideCodeBlocks(text) {
     const codeBlockRanges = [];
     const codeBlockRegex = /```[\s\S]*?```/g;
     let codeBlockMatch = codeBlockRegex.exec(text);
-    while (codeBlockMatch !== null) {
+    while (codeBlockMatch != null) {
         codeBlockRanges.push({
             start: codeBlockMatch.index,
             end: codeBlockMatch.index + codeBlockMatch[0].length,
@@ -151,7 +151,7 @@ function findMarkdownTablesOutsideCodeBlocks(text) {
     const tableRegex = /\|.+\|[\r\n]+\|[-:| ]+\|[\s\S]*?(?=\n\n|\n(?!\|)|$)/g;
     const matches = [];
     let tableMatch = tableRegex.exec(text);
-    while (tableMatch !== null) {
+    while (tableMatch != null) {
         if (!isInsideCodeBlock(tableMatch.index)) {
             matches.push({
                 index: tableMatch.index,

package/src/card/reply-dispatcher.js

@@ -15,7 +15,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFeishuReplyDispatcher = createFeishuReplyDispatcher;
 const channel_runtime_1 = require("openclaw/plugin-sdk/channel-runtime");
 const channel_feedback_1 = require("openclaw/plugin-sdk/channel-feedback");
-const channel_runtime_2 = require("openclaw/plugin-sdk/channel-runtime");
 const accounts_1 = require("../core/accounts.js");
 const footer_config_1 = require("../core/footer-config.js");
 const lark_client_1 = require("../core/lark-client.js");
@@ -111,7 +110,7 @@ function createFeishuReplyDispatcher(params) {
     // ---- Typing indicator (reaction-based) ----
     let typingState = null;
     let typingStopped = false;
-    const typingCallbacks = (0, channel_runtime_2.createTypingCallbacks)({
+    const typingCallbacks = (0, channel_runtime_1.createTypingCallbacks)({
         keepaliveIntervalMs: 0,
         start: async () => {
             if (shouldSkip('typing.start.precheck'))

package/src/channel/directory.d.ts

@@ -8,7 +8,7 @@
  * lookups so the outbound subsystem and UI can resolve targets.
  */
 import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
-import type { FeishuDirectoryPeer, FeishuDirectoryGroup } from './types';
+import type { FeishuDirectoryGroup, FeishuDirectoryPeer } from './types';
 export type { FeishuDirectoryPeer, FeishuDirectoryGroup } from './types';
 /**
  * List users known from the channel config (allowFrom + dms fields).

package/src/channel/plugin.js

@@ -47,7 +47,6 @@ exports.feishuPlugin = void 0;
 const account_id_1 = require("openclaw/plugin-sdk/account-id");
 const channel_status_1 = require("openclaw/plugin-sdk/channel-status");
 const accounts_1 = require("../core/accounts.js");
-const directory_1 = require("./directory.js");
 const outbound_1 = require("../messaging/outbound/outbound.js");
 const actions_1 = require("../messaging/outbound/actions.js");
 const policy_1 = require("../messaging/inbound/policy.js");
@@ -55,9 +54,10 @@ const lark_client_1 = require("../core/lark-client.js");
 const send_1 = require("../messaging/outbound/send.js");
 const targets_1 = require("../core/targets.js");
 const onboarding_auth_1 = require("../tools/onboarding-auth.js");
-const config_adapter_1 = require("./config-adapter.js");
 const lark_logger_1 = require("../core/lark-logger.js");
 const config_schema_1 = require("../core/config-schema.js");
+const config_adapter_1 = require("./config-adapter.js");
+const directory_1 = require("./directory.js");
 const pluginLog = (0, lark_logger_1.larkLogger)('channel/plugin');
 /** 状态轮询的探针结果缓存时长（10 分钟）。 */
 const PROBE_CACHE_TTL_MS = 10 * 60 * 1000;

package/src/channel/probe.d.ts

@@ -2,8 +2,8 @@
  * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
  * SPDX-License-Identifier: MIT
  */
-import type { FeishuProbeResult } from './types';
 import { type LarkClientCredentials } from '../core/lark-client';
+import type { FeishuProbeResult } from './types';
 /**
  * Probe the Feishu bot connection by calling the bot/v3/info API.
  *

package/src/commands/doctor.d.ts

@@ -9,8 +9,9 @@
  */
 import type { OpenClawConfig } from 'openclaw/plugin-sdk';
 export type { FeishuLocale } from './locale';
+import type { FeishuLocale } from './locale';
 /** @deprecated Use FeishuLocale instead */
-export type DoctorLocale = import('./locale').FeishuLocale;
+export type DoctorLocale = FeishuLocale;
 /**
  * 运行飞书插件诊断，生成 Markdown 格式报告。
  *

package/src/commands/index.d.ts

@@ -4,7 +4,7 @@
  *
  * Register all chat commands (/feishu_diagnose, /feishu_doctor, /feishu_auth, /feishu).
  */
-import type { OpenClawPluginApi, OpenClawConfig } from 'openclaw/plugin-sdk';
+import type { OpenClawConfig, OpenClawPluginApi } from 'openclaw/plugin-sdk';
 import type { FeishuLocale } from './locale';
 /**
  * 运行 /feishu start 校验，返回 Markdown 格式结果。

package/src/commands/index.js

@@ -11,10 +11,10 @@ exports.runFeishuStartI18n = runFeishuStartI18n;
 exports.getFeishuHelp = getFeishuHelp;
 exports.getFeishuHelpI18n = getFeishuHelpI18n;
 exports.registerCommands = registerCommands;
+const version_1 = require("../core/version.js");
 const diagnose_1 = require("./diagnose.js");
 const doctor_1 = require("./doctor.js");
 const auth_1 = require("./auth.js");
-const version_1 = require("../core/version.js");
 // ---------------------------------------------------------------------------
 // I18n text map for /feishu start, help, and error messages
 // ---------------------------------------------------------------------------

package/src/core/accounts.d.ts

@@ -9,7 +9,7 @@
  * unset fields fall back to the top-level defaults.
  */
 import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
-import type { FeishuConfig, LarkAccount, LarkCredentials, ConfiguredLarkAccount } from './types';
+import type { ConfiguredLarkAccount, FeishuConfig, LarkAccount, LarkCredentials } from './types';
 /**
  * List all account IDs defined in the Lark config.
  *

package/src/core/accounts.js

@@ -18,9 +18,8 @@ exports.getEnabledLarkAccounts = getEnabledLarkAccounts;
 exports.getLarkCredentials = getLarkCredentials;
 exports.isConfigured = isConfigured;
 const account_id_1 = require("openclaw/plugin-sdk/account-id");
-const account_id_2 = require("openclaw/plugin-sdk/account-id");
-const normalizeAccountId = typeof account_id_2.normalizeAccountId === 'function'
-    ? account_id_2.normalizeAccountId
+const normalizeAccountId = typeof account_id_1.normalizeAccountId === 'function'
+    ? account_id_1.normalizeAccountId
     : (id) => id?.trim().toLowerCase() || undefined;
 // ---------------------------------------------------------------------------
 // Internal helpers

package/src/core/app-owner-fallback.d.ts

@@ -7,6 +7,7 @@
  * 所有 owner 判定统一使用 {@link getAppInfo} 返回的 `effectiveOwnerOpenId`。
  * 不维护独立缓存，完全依赖 app-scope-checker 的 30s 缓存。
  */
+import type * as Lark from '@larksuiteoapi/node-sdk';
 import type { ConfiguredLarkAccount } from './types';
 /**
  * 获取应用的 effectiveOwnerOpenId。
@@ -18,4 +19,4 @@ import type { ConfiguredLarkAccount } from './types';
  * @param sdk - 飞书 SDK 实例（必须已初始化 TAT）
  * @returns 应用所有者的 open_id，如果查询失败则返回 undefined
  */
-export declare function getAppOwnerFallback(account: ConfiguredLarkAccount, sdk: any): Promise<string | undefined>;
+export declare function getAppOwnerFallback(account: ConfiguredLarkAccount, sdk: Lark.Client): Promise<string | undefined>;

package/src/core/app-owner-fallback.js

@@ -26,9 +26,7 @@ const log = (0, lark_logger_1.larkLogger)('core/app-owner-fallback');
  * @param sdk - 飞书 SDK 实例（必须已初始化 TAT）
  * @returns 应用所有者的 open_id，如果查询失败则返回 undefined
  */
-async function getAppOwnerFallback(account, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-sdk) {
+async function getAppOwnerFallback(account, sdk) {
     const { appId } = account;
     try {
         const appInfo = await (0, app_scope_checker_1.getAppInfo)(sdk, appId);

package/src/core/auth-errors.js

@@ -41,9 +41,7 @@ exports.LARK_ERROR = {
     MESSAGE_DELETED: 231003,
 };
 /** refresh token 端点可重试的错误码集合（服务端瞬时故障）。遇到后重试一次，仍失败则清 token。 */
-exports.REFRESH_TOKEN_RETRYABLE = new Set([
-    exports.LARK_ERROR.REFRESH_SERVER_ERROR,
-]);
+exports.REFRESH_TOKEN_RETRYABLE = new Set([exports.LARK_ERROR.REFRESH_SERVER_ERROR]);
 /** 消息终止错误码集合（撤回/删除），遇到后应停止对该消息的后续操作。 */
 exports.MESSAGE_TERMINAL_CODES = new Set([
     exports.LARK_ERROR.MESSAGE_RECALLED,

package/src/core/chat-info-cache.d.ts

@@ -11,9 +11,16 @@
  * - `chat_mode`: "group" | "topic" | "p2p"
  * - `group_message_type`: "chat" | "thread" (only for chat_mode=group)
  */
+import type * as Lark from '@larksuiteoapi/node-sdk';
 import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+/** Minimal structural type for LarkClient class (avoids circular import). */
+interface LarkClientStatic {
+    fromCfg(cfg: ClawdbotConfig, accountId?: string): {
+        sdk: Lark.Client;
+    };
+}
 /** @internal Called by lark-client.ts at module init time. */
-export declare function injectLarkClient(cls: any): void;
+export declare function injectLarkClient(cls: LarkClientStatic): void;
 export interface ChatInfo {
     chatMode: 'group' | 'topic' | 'p2p';
     groupMessageType?: 'chat' | 'thread';
@@ -57,3 +64,4 @@ export declare function getChatTypeFeishu(params: {
     chatId: string;
     accountId?: string;
 }): Promise<'p2p' | 'group'>;
+export {};

package/src/core/chat-info-cache.js

@@ -19,15 +19,8 @@ exports.isThreadCapableGroup = isThreadCapableGroup;
 exports.getChatInfo = getChatInfo;
 exports.getChatTypeFeishu = getChatTypeFeishu;
 const lark_logger_1 = require("./lark-logger.js");
-// ---------------------------------------------------------------------------
-// LarkClient injection — breaks circular dependency with lark-client.ts.
-// lark-client.ts calls injectLarkClient() at module init time, so the
-// reference is available before any message processing begins.
-// ---------------------------------------------------------------------------
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 let _LarkClient = null;
 /** @internal Called by lark-client.ts at module init time. */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function injectLarkClient(cls) {
     _LarkClient = cls;
 }

package/src/core/config-schema.d.ts

@@ -21,6 +21,7 @@ export declare const FeishuGroupSchema: z.ZodObject<{
         disabled: "disabled";
     }>>;
     requireMention: z.ZodOptional<z.ZodBoolean>;
+    respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
     tools: z.ZodOptional<z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
         deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -58,6 +59,7 @@ export declare const FeishuAccountConfigSchema: z.ZodObject<{
     }>>;
     groupAllowFrom: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string[] | undefined, string | string[] | undefined>>;
     requireMention: z.ZodOptional<z.ZodBoolean>;
+    respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
     groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         groupPolicy: z.ZodOptional<z.ZodEnum<{
             open: "open";
@@ -65,6 +67,7 @@ export declare const FeishuAccountConfigSchema: z.ZodObject<{
             disabled: "disabled";
         }>>;
         requireMention: z.ZodOptional<z.ZodBoolean>;
+        respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
         tools: z.ZodOptional<z.ZodObject<{
             allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
             deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -198,6 +201,7 @@ export declare const FeishuConfigSchema: z.ZodObject<{
     }>>;
     groupAllowFrom: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string[] | undefined, string | string[] | undefined>>;
     requireMention: z.ZodOptional<z.ZodBoolean>;
+    respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
     groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         groupPolicy: z.ZodOptional<z.ZodEnum<{
             open: "open";
@@ -205,6 +209,7 @@ export declare const FeishuConfigSchema: z.ZodObject<{
             disabled: "disabled";
         }>>;
         requireMention: z.ZodOptional<z.ZodBoolean>;
+        respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
         tools: z.ZodOptional<z.ZodObject<{
             allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
             deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -337,6 +342,7 @@ export declare const FeishuConfigSchema: z.ZodObject<{
         }>>;
         groupAllowFrom: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string[] | undefined, string | string[] | undefined>>;
         requireMention: z.ZodOptional<z.ZodBoolean>;
+        respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
         groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             groupPolicy: z.ZodOptional<z.ZodEnum<{
                 open: "open";
@@ -344,6 +350,7 @@ export declare const FeishuConfigSchema: z.ZodObject<{
                 disabled: "disabled";
             }>>;
             requireMention: z.ZodOptional<z.ZodBoolean>;
+            respondToMentionAll: z.ZodOptional<z.ZodBoolean>;
             tools: z.ZodOptional<z.ZodObject<{
                 allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 deny: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/src/core/config-schema.js

@@ -35,7 +35,7 @@ const AllowFromSchema = zod_1.z
     .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
     .optional()
     .transform((v) => {
-    if (v === undefined || v === null)
+    if (v === undefined || v == null)
         return undefined;
     return Array.isArray(v) ? v : [v];
 });
@@ -124,6 +124,7 @@ const DmConfigSchema = zod_1.z
 exports.FeishuGroupSchema = zod_1.z.object({
     groupPolicy: GroupPolicyEnum.optional(),
     requireMention: zod_1.z.boolean().optional(),
+    respondToMentionAll: zod_1.z.boolean().optional(),
     tools: ToolPolicySchema,
     skills: zod_1.z.array(zod_1.z.string()).optional(),
     enabled: zod_1.z.boolean().optional(),
@@ -149,6 +150,7 @@ exports.FeishuAccountConfigSchema = zod_1.z.object({
     groupPolicy: GroupPolicyEnum.optional(),
     groupAllowFrom: AllowFromSchema,
     requireMention: zod_1.z.boolean().optional(),
+    respondToMentionAll: zod_1.z.boolean().optional(),
     groups: zod_1.z.record(zod_1.z.string(), exports.FeishuGroupSchema).optional(),
     historyLimit: zod_1.z.number().optional(),
     dmHistoryLimit: zod_1.z.number().optional(),

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

@@ -14,8 +14,8 @@
  */
 import * as Lark from '@larksuiteoapi/node-sdk';
 import type { ClawdbotConfig, PluginRuntime } from 'openclaw/plugin-sdk';
-import type { LarkBrand, LarkAccount, FeishuProbeResult } from './types';
 import type { MessageDedup } from '../messaging/inbound/dedup';
+import type { FeishuProbeResult, LarkAccount, LarkBrand } from './types';
 /** Credential set accepted by the ephemeral `fromCredentials` factory. */
 export interface LarkClientCredentials {
     accountId?: string;
@@ -33,7 +33,6 @@ export declare class LarkClient {
     private _lastProbeAt;
     /** Attached message deduplicator — disposed together with the client. */
     messageDedup: MessageDedup | null;
-    private static _runtime;
     /** Persist the runtime instance for later retrieval (activate 阶段调用一次). */
     static setRuntime(runtime: PluginRuntime): void;
     /** Retrieve the stored runtime instance. Throws if not yet initialised. */

package/src/core/lark-client.js

@@ -51,12 +51,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LarkClient = void 0;
 exports.getResolvedConfig = getResolvedConfig;
 const Lark = __importStar(require("@larksuiteoapi/node-sdk"));
+const user_name_cache_store_1 = require("../messaging/inbound/user-name-cache-store.js");
 const accounts_1 = require("./accounts.js");
-// NOTE: clearUserNameCache is lazy-imported in clearCache() to break a
-// circular dependency with user-name-cache.ts (which imports LarkClient).
 const chat_info_cache_1 = require("./chat-info-cache.js");
-const version_1 = require("./version.js");
 const lark_logger_1 = require("./lark-logger.js");
+const runtime_store_1 = require("./runtime-store.js");
+const version_1 = require("./version.js");
 const log = (0, lark_logger_1.larkLogger)('core/lark-client');
 // ---------------------------------------------------------------------------
 // 注入 User-Agent 到所有飞书 SDK 请求
@@ -134,18 +134,13 @@ class LarkClient {
     /** Attached message deduplicator — disposed together with the client. */
     messageDedup = null;
     // ---- Plugin runtime (singleton) ------------------------------------------
-    static _runtime = null;
     /** Persist the runtime instance for later retrieval (activate 阶段调用一次). */
     static setRuntime(runtime) {
-        LarkClient._runtime = runtime;
+        (0, runtime_store_1.setLarkRuntime)(runtime);
     }
     /** Retrieve the stored runtime instance. Throws if not yet initialised. */
     static get runtime() {
-        if (!LarkClient._runtime) {
-            throw new Error('Feishu plugin runtime has not been initialised. ' +
-                'Ensure LarkClient.setRuntime() is called during plugin activation.');
-        }
-        return LarkClient._runtime;
+        return (0, runtime_store_1.getLarkRuntime)();
     }
     // ---- Global config (singleton) -------------------------------------------
     //
@@ -181,7 +176,9 @@ class LarkClient {
      */
     static fromAccount(account) {
         const existing = cache.get(account.accountId);
-        if (existing && existing.account.appId === account.appId && credentialsEqual(existing.account.appSecret, account.appSecret)) {
+        if (existing &&
+            existing.account.appId === account.appId &&
+            credentialsEqual(existing.account.appSecret, account.appSecret)) {
             return existing;
         }
         // Credentials changed — tear down the stale instance before replacing it.
@@ -220,16 +217,15 @@ class LarkClient {
      * Without — dispose every cached instance and clear the cache.
      */
     static async clearCache(accountId) {
-        const { clearUserNameCache } = await Promise.resolve().then(() => __importStar(require('../messaging/inbound/user-name-cache.js')));
         if (accountId !== undefined) {
             cache.get(accountId)?.dispose();
-            clearUserNameCache(accountId);
+            (0, user_name_cache_store_1.clearUserNameCache)(accountId);
             (0, chat_info_cache_1.clearChatInfoCache)(accountId);
         }
         else {
             for (const inst of cache.values())
                 inst.dispose();
-            clearUserNameCache();
+            (0, user_name_cache_store_1.clearUserNameCache)();
             (0, chat_info_cache_1.clearChatInfoCache)();
         }
     }
@@ -363,7 +359,7 @@ class LarkClient {
     }
     /** Whether a WebSocket client is currently active. */
     get wsConnected() {
-        return this._wsClient !== null;
+        return this._wsClient != null;
     }
     /** Disconnect WebSocket but keep instance in cache. */
     disconnect() {

package/src/core/lark-logger.js

@@ -15,8 +15,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.larkLogger = larkLogger;
-const lark_client_1 = require("./lark-client.js");
 const lark_ticket_1 = require("./lark-ticket.js");
+const runtime_store_1 = require("./runtime-store.js");
 // ---------------------------------------------------------------------------
 // Console fallback (with ANSI colors)
 // ---------------------------------------------------------------------------
@@ -42,7 +42,10 @@ function consoleFallback(subsystem) {
 // ---------------------------------------------------------------------------
 function resolveRuntimeLogger(subsystem) {
     try {
-        return lark_client_1.LarkClient.runtime.logging.getChildLogger({
+        const runtime = (0, runtime_store_1.tryGetLarkRuntime)();
+        if (!runtime)
+            return null;
+        return runtime.logging.getChildLogger({
             subsystem: `feishu/${subsystem}`,
         });
     }
@@ -105,7 +108,7 @@ function formatMessage(message, meta) {
         return `${prefix} ${message}`;
     const parts = Object.entries(meta)
         .map(([k, v]) => {
-        if (v === undefined || v === null)
+        if (v === undefined || v == null)
             return null;
         if (typeof v === 'object')
             return `${k}=${JSON.stringify(v)}`;

package/src/core/message-unavailable.d.ts

@@ -8,7 +8,7 @@
  * 1) 当命中飞书终止错误码（230011/231003）时，按 message_id 标记不可用；
  * 2) 后续针对该 message_id 的 API 调用直接短路，避免持续报错刷屏。
  */
-import { LARK_ERROR } from './auth-errors';
+import type { LARK_ERROR } from './auth-errors';
 export type TerminalMessageApiCode = typeof LARK_ERROR.MESSAGE_RECALLED | typeof LARK_ERROR.MESSAGE_DELETED;
 export interface MessageUnavailableState {
     apiCode: TerminalMessageApiCode;

package/src/core/message-unavailable.js

@@ -94,7 +94,7 @@ class MessageUnavailableError extends Error {
 exports.MessageUnavailableError = MessageUnavailableError;
 function isMessageUnavailableError(error) {
     return (error instanceof MessageUnavailableError ||
-        (typeof error === 'object' && error !== null && error.name === 'MessageUnavailableError'));
+        (typeof error === 'object' && error != null && error.name === 'MessageUnavailableError'));
 }
 function assertMessageAvailable(messageId, operation) {
     const normalizedId = (0, targets_1.normalizeMessageId)(messageId);

package/src/core/owner-policy.d.ts

@@ -7,6 +7,7 @@
  * 从 uat-client.ts 迁移 owner 检查逻辑到独立 policy 层。
  * 提供 fail-close 策略（安全优先：授权发起路径）。
  */
+import type * as Lark from '@larksuiteoapi/node-sdk';
 import type { ConfiguredLarkAccount } from './types';
 /**
  * 非应用 owner 尝试执行 owner-only 操作时抛出。
@@ -28,4 +29,4 @@ export declare class OwnerAccessDeniedError extends Error {
  * 适用于：`executeAuthorize`（OAuth 授权发起）、`commands/auth.ts`（批量授权）等
  * 赋予实质性权限的入口。
  */
-export declare function assertOwnerAccessStrict(account: ConfiguredLarkAccount, sdk: any, userOpenId: string): Promise<void>;
+export declare function assertOwnerAccessStrict(account: ConfiguredLarkAccount, sdk: Lark.Client, userOpenId: string): Promise<void>;

package/src/core/owner-policy.js

@@ -44,9 +44,7 @@ exports.OwnerAccessDeniedError = OwnerAccessDeniedError;
  * 适用于：`executeAuthorize`（OAuth 授权发起）、`commands/auth.ts`（批量授权）等
  * 赋予实质性权限的入口。
  */
-async function assertOwnerAccessStrict(account, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-sdk, userOpenId) {
+async function assertOwnerAccessStrict(account, sdk, userOpenId) {
     const ownerOpenId = await (0, app_owner_fallback_1.getAppOwnerFallback)(account, sdk);
     if (!ownerOpenId) {
         throw new OwnerAccessDeniedError(userOpenId, 'unknown');

package/src/core/runtime-store.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Shared runtime store for the Feishu plugin.
+ *
+ * Allows modules such as the logger to access the plugin runtime without
+ * importing LarkClient directly, which would otherwise create static cycles.
+ */
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+export declare function setLarkRuntime(nextRuntime: PluginRuntime): void;
+export declare function tryGetLarkRuntime(): PluginRuntime | null;
+export declare function getLarkRuntime(): PluginRuntime;