@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/core/device-flow.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/device-flow.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * OAuth 2.0 Device Authorization Grant (RFC 8628) for Lark/Feishu.\n *\n * Two-step flow:\n *   1. `requestDeviceAuthorization` \u2013 obtains device_code + user_code.\n *   2. `pollDeviceToken` \u2013 polls the token endpoint until the user authorises,\n *      rejects, or the code expires.\n *\n * All HTTP calls use the built-in `fetch` (Node 18+). The Lark SDK is not\n * used here because these OAuth endpoints are outside the SDK's scope.\n */\n\nimport type { LarkBrand } from './types';\nimport { larkLogger } from './lark-logger';\n\nconst log = larkLogger('core/device-flow');\nimport { feishuFetch } from './feishu-fetch';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface DeviceAuthResponse {\n  deviceCode: string;\n  userCode: string;\n  verificationUri: string;\n  verificationUriComplete: string;\n  expiresIn: number; // seconds\n  interval: number; // recommended polling interval (seconds)\n}\n\nexport interface DeviceFlowTokenData {\n  accessToken: string;\n  refreshToken: string;\n  expiresIn: number; // seconds\n  refreshExpiresIn: number; // seconds\n  scope: string;\n}\n\nexport type DeviceFlowResult =\n  | { ok: true; token: DeviceFlowTokenData }\n  | { ok: false; error: DeviceFlowError; message: string };\n\nexport type DeviceFlowError = 'authorization_pending' | 'slow_down' | 'access_denied' | 'expired_token';\n\n// ---------------------------------------------------------------------------\n// Endpoint resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the two OAuth endpoint URLs based on the configured brand.\n */\nexport function resolveOAuthEndpoints(brand: LarkBrand): {\n  deviceAuthorization: string;\n  token: string;\n} {\n  if (!brand || brand === 'feishu') {\n    return {\n      deviceAuthorization: 'https://accounts.feishu.cn/oauth/v1/device_authorization',\n      token: 'https://open.feishu.cn/open-apis/authen/v2/oauth/token',\n    };\n  }\n  if (brand === 'lark') {\n    return {\n      deviceAuthorization: 'https://accounts.larksuite.com/oauth/v1/device_authorization',\n      token: 'https://open.larksuite.com/open-apis/authen/v2/oauth/token',\n    };\n  }\n  // Custom domain \u2013 derive paths by convention.\n  // Smart derivation: open.X \u2192 accounts.X for the device authorization endpoint.\n  const base = brand.replace(/\\/+$/, '');\n  let accountsBase = base;\n  try {\n    const parsed = new URL(base);\n    if (parsed.hostname.startsWith('open.')) {\n      accountsBase = `${parsed.protocol}//${parsed.hostname.replace(/^open\\./, 'accounts.')}`;\n    }\n  } catch {\n    /* fallback to base */\n  }\n\n  return {\n    deviceAuthorization: `${accountsBase}/oauth/v1/device_authorization`,\n    token: `${base}/open-apis/authen/v2/oauth/token`,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Step 1 \u2013 Device Authorization Request\n// ---------------------------------------------------------------------------\n\n/**\n * Request a device authorisation code from the Feishu OAuth server.\n *\n * Uses Confidential Client authentication (HTTP Basic with appId:appSecret).\n * The `offline_access` scope is automatically appended so that the token\n * response includes a refresh_token.\n */\nexport async function requestDeviceAuthorization(params: {\n  appId: string;\n  appSecret: string;\n  brand: LarkBrand;\n  scope?: string;\n  endpoints?: { deviceAuthorization: string; token: string };\n}): Promise<DeviceAuthResponse> {\n  const { appId, appSecret, brand } = params;\n  const endpoints = params.endpoints || resolveOAuthEndpoints(brand);\n\n  // Ensure offline_access is always requested.\n  let scope = params.scope ?? '';\n  if (!scope.includes('offline_access')) {\n    scope = scope ? `${scope} offline_access` : 'offline_access';\n  }\n\n  const basicAuth = Buffer.from(`${appId}:${appSecret}`).toString('base64');\n\n  const body = new URLSearchParams();\n  body.set('client_id', appId);\n  body.set('scope', scope);\n\n  log.info(\n    `requesting device authorization (scope=\"${scope}\") url=${endpoints.deviceAuthorization} token_url=${endpoints.token}`,\n  );\n\n  const resp = await feishuFetch(endpoints.deviceAuthorization, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/x-www-form-urlencoded',\n      Authorization: `Basic ${basicAuth}`,\n    },\n    body: body.toString(),\n  });\n\n  const text = await resp.text();\n  log.info(`response status=${resp.status} body=${text.slice(0, 500)}`);\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(text) as Record<string, unknown>;\n  } catch {\n    throw new Error(`Device authorization failed: HTTP ${resp.status} \u2013 ${text.slice(0, 200)}`);\n  }\n\n  if (!resp.ok || data.error) {\n    const msg = (data.error_description as string) ?? (data.error as string) ?? 'Unknown error';\n    throw new Error(`Device authorization failed: ${msg}`);\n  }\n\n  const expiresIn = (data.expires_in as number) ?? 240;\n  const interval = (data.interval as number) ?? 5;\n  log.info(`device_code obtained, expires_in=${expiresIn}s (${Math.round(expiresIn / 60)}min), interval=${interval}s`);\n\n  return {\n    deviceCode: data.device_code as string,\n    userCode: data.user_code as string,\n    verificationUri: data.verification_uri as string,\n    verificationUriComplete: (data.verification_uri_complete as string) ?? (data.verification_uri as string),\n    expiresIn,\n    interval,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Step 2 \u2013 Poll Token Endpoint\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        reject(new DOMException('Aborted', 'AbortError'));\n      },\n      { once: true },\n    );\n  });\n}\n\n/**\n * Poll the token endpoint until the user authorises, rejects, or the code\n * expires.\n *\n * Handles `authorization_pending` (keep polling), `slow_down` (back off by\n * +5 s), `access_denied` and `expired_token` (terminal errors).\n *\n * Pass an `AbortSignal` to cancel polling from the outside.\n */\nexport async function pollDeviceToken(params: {\n  appId: string;\n  appSecret: string;\n  brand: LarkBrand;\n  deviceCode: string;\n  interval: number;\n  expiresIn: number;\n  signal?: AbortSignal;\n  endpoints?: { deviceAuthorization: string; token: string };\n}): Promise<DeviceFlowResult> {\n  const MAX_POLL_INTERVAL = 60; // slow_down \u6700\u5927\u95F4\u9694 60 \u79D2\n  const MAX_POLL_ATTEMPTS = 200; // \u5B89\u5168\u4E0A\u9650\uFF08\u8FDC\u8D85\u8BBE\u5907\u7801\u6709\u6548\u671F\uFF09\n\n  const { appId, appSecret, brand, deviceCode, expiresIn, signal } = params;\n  let interval = params.interval;\n  const endpoints = params.endpoints || resolveOAuthEndpoints(brand);\n  const deadline = Date.now() + expiresIn * 1000;\n  let attempts = 0;\n\n  while (Date.now() < deadline && attempts < MAX_POLL_ATTEMPTS) {\n    attempts++;\n    if (signal?.aborted) {\n      return { ok: false, error: 'expired_token', message: 'Polling was cancelled' };\n    }\n\n    await sleep(interval * 1000, signal);\n\n    let data: Record<string, unknown>;\n    try {\n      const resp = await feishuFetch(endpoints.token, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n        body: new URLSearchParams({\n          grant_type: 'urn:ietf:params:oauth:grant-type:device_code',\n          device_code: deviceCode,\n          client_id: appId,\n          client_secret: appSecret,\n        }).toString(),\n      });\n      data = (await resp.json()) as Record<string, unknown>;\n    } catch (err) {\n      log.warn(`poll network error: ${err}`);\n      interval = Math.min(interval + 1, MAX_POLL_INTERVAL);\n      continue;\n    }\n\n    const error = data.error as string | undefined;\n\n    if (!error && data.access_token) {\n      log.info('token obtained successfully');\n      const refreshToken = (data.refresh_token as string) ?? '';\n      const expiresIn = (data.expires_in as number) ?? 7200;\n      let refreshExpiresIn = (data.refresh_token_expires_in as number) ?? 604800;\n      if (!refreshToken) {\n        log.warn('no refresh_token in response, token will not be refreshable');\n        refreshExpiresIn = expiresIn;\n      }\n      return {\n        ok: true,\n        token: {\n          accessToken: data.access_token as string,\n          refreshToken,\n          expiresIn,\n          refreshExpiresIn,\n          scope: (data.scope as string) ?? '',\n        },\n      };\n    }\n\n    if (error === 'authorization_pending') {\n      log.debug('authorization_pending, retrying...');\n      continue;\n    }\n\n    if (error === 'slow_down') {\n      interval = Math.min(interval + 5, MAX_POLL_INTERVAL);\n      log.info(`slow_down, interval increased to ${interval}s`);\n      continue;\n    }\n\n    if (error === 'access_denied') {\n      log.info('user denied authorization');\n      return { ok: false, error: 'access_denied', message: '\u7528\u6237\u62D2\u7EDD\u4E86\u6388\u6743' };\n    }\n\n    if (error === 'expired_token' || error === 'invalid_grant') {\n      log.info(`device code expired/invalid (error=${error})`);\n      return { ok: false, error: 'expired_token', message: '\u6388\u6743\u7801\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77' };\n    }\n\n    // Unknown error \u2013 treat as terminal.\n    const desc = (data.error_description as string) ?? error ?? 'Unknown error';\n    log.warn(`unexpected error: error=${error}, desc=${desc}`);\n    return { ok: false, error: 'expired_token', message: desc };\n  }\n\n  if (attempts >= MAX_POLL_ATTEMPTS) {\n    log.warn(`max poll attempts (${MAX_POLL_ATTEMPTS}) reached`);\n  }\n  return { ok: false, error: 'expired_token', message: '\u6388\u6743\u8D85\u65F6\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77' };\n}\n"],
+  "mappings": "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",
+  "names": ["expiresIn"]
+}

package/dist/src/core/feishu-fetch.js

@@ -0,0 +1,12 @@
+import { getUserAgent } from "./version";
+function feishuFetch(url, init) {
+  const headers = {
+    ...init?.headers,
+    "User-Agent": getUserAgent()
+  };
+  return fetch(url, { ...init, headers });
+}
+export {
+  feishuFetch
+};
+//# sourceMappingURL=feishu-fetch.js.map

package/dist/src/core/feishu-fetch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/feishu-fetch.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Header-aware fetch for Feishu API calls.\n *\n * Drop-in replacement for `fetch()` that automatically injects\n * the User-Agent header.\n */\n\nimport { getUserAgent } from './version';\n\n/**\n * Drop-in replacement for `fetch()` that automatically injects\n * the User-Agent header.\n *\n * Used by `device-flow.ts` and `uat-client.ts` so that the custom\n * User-Agent is transparently applied without changing every\n * call-site's signature.\n */\nexport function feishuFetch(url: string | URL | Request, init?: RequestInit): Promise<Response> {\n  const headers = {\n    ...init?.headers,\n    'User-Agent': getUserAgent(),\n  };\n\n  return fetch(url, { ...init, headers });\n}\n"],
+  "mappings": "AAUA,SAAS,oBAAoB;AAUtB,SAAS,YAAY,KAA6B,MAAuC;AAC9F,QAAM,UAAU;AAAA,IACd,GAAG,MAAM;AAAA,IACT,cAAc,aAAa;AAAA,EAC7B;AAEA,SAAO,MAAM,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC;AACxC;",
+  "names": []
+}

package/dist/src/core/footer-config.js

@@ -0,0 +1,16 @@
+const DEFAULT_FOOTER_CONFIG = {
+  status: false,
+  elapsed: false
+};
+function resolveFooterConfig(cfg) {
+  if (!cfg) return { ...DEFAULT_FOOTER_CONFIG };
+  return {
+    status: cfg.status ?? DEFAULT_FOOTER_CONFIG.status,
+    elapsed: cfg.elapsed ?? DEFAULT_FOOTER_CONFIG.elapsed
+  };
+}
+export {
+  DEFAULT_FOOTER_CONFIG,
+  resolveFooterConfig
+};
+//# sourceMappingURL=footer-config.js.map

package/dist/src/core/footer-config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/footer-config.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Default values and resolution logic for the Feishu card footer configuration.\n *\n * Each boolean flag controls whether a particular metadata item is displayed\n * in the card footer (e.g. elapsed time, model name).\n */\n\nimport type { FeishuFooterConfig } from './types';\n\n// ---------------------------------------------------------------------------\n// Defaults\n// ---------------------------------------------------------------------------\n\n/**\n * The default footer configuration.\n *\n * By default all metadata items are hidden \u2014 neither status text\n * (\"\u5DF2\u5B8C\u6210\" / \"\u51FA\u9519\" / \"\u5DF2\u505C\u6B62\") nor elapsed time are shown.\n */\nexport const DEFAULT_FOOTER_CONFIG: Required<FeishuFooterConfig> = {\n  status: false,\n  elapsed: false,\n};\n\n// ---------------------------------------------------------------------------\n// Resolver\n// ---------------------------------------------------------------------------\n\n/**\n * Merge a partial footer configuration with `DEFAULT_FOOTER_CONFIG`.\n *\n * Fields present in the input take precedence; anything absent falls back\n * to the default value.\n */\nexport function resolveFooterConfig(cfg?: FeishuFooterConfig): Required<FeishuFooterConfig> {\n  if (!cfg) return { ...DEFAULT_FOOTER_CONFIG };\n  return {\n    status: cfg.status ?? DEFAULT_FOOTER_CONFIG.status,\n    elapsed: cfg.elapsed ?? DEFAULT_FOOTER_CONFIG.elapsed,\n  };\n}\n"],
+  "mappings": "AAsBO,MAAM,wBAAsD;AAAA,EACjE,QAAQ;AAAA,EACR,SAAS;AACX;AAYO,SAAS,oBAAoB,KAAwD;AAC1F,MAAI,CAAC,IAAK,QAAO,EAAE,GAAG,sBAAsB;AAC5C,SAAO;AAAA,IACL,QAAQ,IAAI,UAAU,sBAAsB;AAAA,IAC5C,SAAS,IAAI,WAAW,sBAAsB;AAAA,EAChD;AACF;",
+  "names": []
+}

package/dist/src/core/lark-client.js

@@ -0,0 +1,322 @@
+import * as Lark from "@larksuiteoapi/node-sdk";
+import { getLarkAccount } from "./accounts";
+import { clearUserNameCache } from "../messaging/inbound/user-name-cache";
+import { clearChatInfoCache } from "./chat-info-cache";
+import { getUserAgent } from "./version";
+import { larkLogger } from "./lark-logger";
+const log = larkLogger("core/lark-client");
+const GLOBAL_LARK_USER_AGENT_KEY = "LARK_USER_AGENT";
+function installGlobalUserAgent() {
+  globalThis[GLOBAL_LARK_USER_AGENT_KEY] = getUserAgent();
+}
+installGlobalUserAgent();
+Lark.defaultHttpInstance.interceptors.request.handlers = [];
+Lark.defaultHttpInstance.interceptors.request.use(
+  (req) => {
+    if (req.headers) {
+      req.headers["User-Agent"] = getUserAgent();
+    }
+    return req;
+  },
+  void 0,
+  { synchronous: true }
+);
+const BRAND_TO_DOMAIN = {
+  feishu: Lark.Domain.Feishu,
+  lark: Lark.Domain.Lark
+};
+function resolveBrand(brand) {
+  return BRAND_TO_DOMAIN[brand ?? "feishu"] ?? brand.replace(/\/+$/, "");
+}
+const cache = /* @__PURE__ */ new Map();
+class LarkClient {
+  account;
+  _sdk = null;
+  _wsClient = null;
+  _botOpenId;
+  _botName;
+  _lastProbeResult = null;
+  _lastProbeAt = 0;
+  /** 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;
+  }
+  /** 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;
+  }
+  // ---- Global config (singleton) -------------------------------------------
+  //
+  // Plugin commands receive an account-scoped config (channels.feishu replaced
+  // with the merged per-account config, `accounts` map stripped).  Commands
+  // that need cross-account visibility (e.g. doctor, diagnose) read the
+  // original global config from here.
+  static _globalConfig = null;
+  /** Store the original global config (called during monitor startup). */
+  static setGlobalConfig(cfg) {
+    LarkClient._globalConfig = cfg;
+  }
+  /** Retrieve the stored global config, or `null` if not yet set. */
+  static get globalConfig() {
+    return LarkClient._globalConfig;
+  }
+  // --------------------------------------------------------------------------
+  constructor(account) {
+    this.account = account;
+  }
+  /** Shorthand for `this.account.accountId`. */
+  get accountId() {
+    return this.account.accountId;
+  }
+  // ---- Static factory / cache ------------------------------------------------
+  /** Resolve account from config and return a cached `LarkClient`. */
+  static fromCfg(cfg, accountId) {
+    return LarkClient.fromAccount(getLarkAccount(cfg, accountId));
+  }
+  /**
+   * Get (or create) a cached `LarkClient` for the given account.
+   * If the cached instance has stale credentials it is replaced.
+   */
+  static fromAccount(account) {
+    const existing = cache.get(account.accountId);
+    if (existing && existing.account.appId === account.appId && existing.account.appSecret === account.appSecret) {
+      return existing;
+    }
+    if (existing) {
+      log.info(`credentials changed, disposing stale instance`, { accountId: account.accountId });
+      existing.dispose();
+    }
+    const instance = new LarkClient(account);
+    cache.set(account.accountId, instance);
+    return instance;
+  }
+  /**
+   * Create an ephemeral `LarkClient` from bare credentials.
+   * The instance is **not** added to the global cache — suitable for
+   * one-off probe / diagnose calls that should not pollute account state.
+   */
+  static fromCredentials(credentials) {
+    const base = {
+      accountId: credentials.accountId ?? "default",
+      enabled: true,
+      brand: credentials.brand ?? "feishu",
+      config: {}
+    };
+    const account = credentials.appId && credentials.appSecret ? { ...base, configured: true, appId: credentials.appId, appSecret: credentials.appSecret } : { ...base, configured: false, appId: credentials.appId, appSecret: credentials.appSecret };
+    return new LarkClient(account);
+  }
+  /** Look up a cached instance by accountId. */
+  static get(accountId) {
+    return cache.get(accountId) ?? null;
+  }
+  /**
+   * Dispose one or all cached instances.
+   * With `accountId` — dispose that single instance.
+   * Without — dispose every cached instance and clear the cache.
+   */
+  static clearCache(accountId) {
+    if (accountId !== void 0) {
+      cache.get(accountId)?.dispose();
+      clearUserNameCache(accountId);
+      clearChatInfoCache(accountId);
+    } else {
+      for (const inst of cache.values()) inst.dispose();
+      clearUserNameCache();
+      clearChatInfoCache();
+    }
+  }
+  // ---- SDK client (lazy) -----------------------------------------------------
+  /** Lazily-created Lark SDK client. */
+  get sdk() {
+    if (!this._sdk) {
+      const { appId, appSecret } = this.requireCredentials();
+      this._sdk = new Lark.Client({
+        appId,
+        appSecret,
+        appType: Lark.AppType.SelfBuild,
+        domain: resolveBrand(this.account.brand)
+      });
+    }
+    return this._sdk;
+  }
+  // ---- Bot identity ----------------------------------------------------------
+  /**
+   * Probe bot identity via the `bot/v3/info` API.
+   * Results are cached on the instance for subsequent access via
+   * `botOpenId` / `botName`.
+   */
+  async probe(opts) {
+    const maxAge = opts?.maxAgeMs ?? 0;
+    if (maxAge > 0 && this._lastProbeResult && Date.now() - this._lastProbeAt < maxAge) {
+      return this._lastProbeResult;
+    }
+    if (!this.account.appId || !this.account.appSecret) {
+      return { ok: false, error: "missing credentials (appId, appSecret)" };
+    }
+    try {
+      const res = await this.sdk.request({
+        method: "GET",
+        url: "/open-apis/bot/v3/info",
+        data: {}
+      });
+      if (res.code !== 0) {
+        const result2 = {
+          ok: false,
+          appId: this.account.appId,
+          error: `API error: ${res.msg || `code ${res.code}`}`
+        };
+        this._lastProbeResult = result2;
+        this._lastProbeAt = Date.now();
+        return result2;
+      }
+      const bot = res.bot || res.data?.bot;
+      this._botOpenId = bot?.open_id;
+      this._botName = bot?.bot_name;
+      const result = {
+        ok: true,
+        appId: this.account.appId,
+        botName: this._botName,
+        botOpenId: this._botOpenId
+      };
+      this._lastProbeResult = result;
+      this._lastProbeAt = Date.now();
+      return result;
+    } catch (err) {
+      const result = {
+        ok: false,
+        appId: this.account.appId,
+        error: err instanceof Error ? err.message : String(err)
+      };
+      this._lastProbeResult = result;
+      this._lastProbeAt = Date.now();
+      return result;
+    }
+  }
+  /** Cached bot open_id (available after `probe()` or `startWS()`). */
+  get botOpenId() {
+    return this._botOpenId;
+  }
+  /** Cached bot name (available after `probe()` or `startWS()`). */
+  get botName() {
+    return this._botName;
+  }
+  // ---- WebSocket lifecycle ---------------------------------------------------
+  /**
+   * Start WebSocket event monitoring.
+   *
+   * Flow: probe bot identity → EventDispatcher → WSClient → start.
+   * The returned Promise resolves when `abortSignal` fires.
+   */
+  async startWS(opts) {
+    const { handlers, abortSignal, autoProbe = true } = opts;
+    if (autoProbe) await this.probe();
+    const dispatcher = new Lark.EventDispatcher({
+      encryptKey: this.account.encryptKey ?? "",
+      verificationToken: this.account.verificationToken ?? ""
+    });
+    dispatcher.register(handlers);
+    const { appId, appSecret } = this.requireCredentials();
+    if (this._wsClient) {
+      log.warn(`closing previous WSClient before reconnect`, { accountId: this.accountId });
+      try {
+        this._wsClient.close({ force: true });
+      } catch {
+      }
+      this._wsClient = null;
+    }
+    this._wsClient = new Lark.WSClient({
+      appId,
+      appSecret,
+      domain: resolveBrand(this.account.brand),
+      loggerLevel: Lark.LoggerLevel.info
+    });
+    const wsClientAny = this._wsClient;
+    const origHandleEventData = wsClientAny.handleEventData.bind(wsClientAny);
+    wsClientAny.handleEventData = (data) => {
+      const msgType = data.headers?.find?.((h) => h.key === "type")?.value;
+      if (msgType === "card") {
+        const patchedData = {
+          ...data,
+          headers: data.headers.map((h) => h.key === "type" ? { ...h, value: "event" } : h)
+        };
+        return origHandleEventData(patchedData);
+      }
+      return origHandleEventData(data);
+    };
+    await this.waitForAbort(dispatcher, abortSignal);
+  }
+  /** Whether a WebSocket client is currently active. */
+  get wsConnected() {
+    return this._wsClient !== null;
+  }
+  /** Disconnect WebSocket but keep instance in cache. */
+  disconnect() {
+    if (this._wsClient) {
+      log.info(`disconnecting WebSocket`, { accountId: this.accountId });
+      try {
+        this._wsClient.close({ force: true });
+      } catch {
+      }
+    }
+    this._wsClient = null;
+    if (this.messageDedup) {
+      log.info(`disposing message dedup`, { accountId: this.accountId, size: this.messageDedup.size });
+      this.messageDedup.dispose();
+      this.messageDedup = null;
+    }
+  }
+  /** Disconnect + remove from cache. */
+  dispose() {
+    this.disconnect();
+    cache.delete(this.accountId);
+  }
+  // ---- Private helpers -------------------------------------------------------
+  /** Assert credentials exist or throw. */
+  requireCredentials() {
+    const appId = this.account.appId;
+    const appSecret = this.account.appSecret;
+    if (!appId || !appSecret) {
+      throw new Error(`LarkClient[${this.accountId}]: appId and appSecret are required`);
+    }
+    return { appId, appSecret };
+  }
+  /**
+   * Start the WSClient and return a promise that resolves when the
+   * abort signal fires (or immediately if already aborted).
+   */
+  waitForAbort(dispatcher, signal) {
+    return new Promise((resolve, reject) => {
+      if (signal?.aborted) {
+        this.disconnect();
+        return resolve();
+      }
+      signal?.addEventListener(
+        "abort",
+        () => {
+          this.disconnect();
+          resolve();
+        },
+        { once: true }
+      );
+      try {
+        void this._wsClient.start({ eventDispatcher: dispatcher });
+      } catch (err) {
+        this.disconnect();
+        reject(err);
+      }
+    });
+  }
+}
+export {
+  LarkClient
+};
+//# sourceMappingURL=lark-client.js.map

package/dist/src/core/lark-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/lark-client.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Feishu / Lark SDK client management.\n *\n * Provides `LarkClient` \u2014 a unified manager for Lark SDK client instances,\n * WebSocket connections, EventDispatcher lifecycle, and bot identity.\n *\n * Consumers obtain instances via factory methods:\n *   - `LarkClient.fromCfg(cfg, accountId)` \u2014 resolve account from config\n *   - `LarkClient.fromAccount(account)` \u2014 from a pre-resolved account\n *   - `LarkClient.fromCredentials(credentials)` \u2014 ephemeral instance (not cached)\n */\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport * as Lark from '@larksuiteoapi/node-sdk';\n\nimport type { ClawdbotConfig, PluginRuntime } from 'openclaw/plugin-sdk';\nimport type { LarkBrand, LarkAccount, FeishuProbeResult } from './types';\nimport { getLarkAccount } from './accounts';\nimport { clearUserNameCache } from '../messaging/inbound/user-name-cache';\nimport { clearChatInfoCache } from './chat-info-cache';\nimport { getUserAgent } from './version';\nimport { larkLogger } from './lark-logger';\n\nconst log = larkLogger('core/lark-client');\nimport type { MessageDedup } from '../messaging/inbound/dedup';\n\n// ---------------------------------------------------------------------------\n// \u6CE8\u5165 User-Agent \u5230\u6240\u6709\u98DE\u4E66 SDK \u8BF7\u6C42\n// ---------------------------------------------------------------------------\n\nconst GLOBAL_LARK_USER_AGENT_KEY = 'LARK_USER_AGENT';\n\nfunction installGlobalUserAgent(): void {\n  // node-sdk \u5185\u7F6E\u62E6\u622A\u5668\u6700\u7EC8\u4F1A\u8BFB\u53D6 global.LARK_USER_AGENT \u5E76\u8986\u76D6 User-Agent\n  (globalThis as Record<string, unknown>)[GLOBAL_LARK_USER_AGENT_KEY] = getUserAgent();\n}\n\ninstallGlobalUserAgent();\nLark.defaultHttpInstance.interceptors.request.handlers = [];\n// \u4F7F\u7528 interceptors \u5728\u6240\u6709 HTTP \u8BF7\u6C42\u4E2D\u6CE8\u5165 User-Agent header\nLark.defaultHttpInstance.interceptors.request.use(\n  (req) => {\n    if (req.headers) {\n      req.headers['User-Agent'] = getUserAgent();\n    }\n    return req;\n  },\n  undefined,\n  { synchronous: true },\n);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n/** Credential set accepted by the ephemeral `fromCredentials` factory. */\nexport interface LarkClientCredentials {\n  accountId?: string;\n  appId?: string;\n  appSecret?: string;\n  brand?: LarkBrand;\n}\n\n// ---------------------------------------------------------------------------\n// Brand \u2192 SDK domain\n// ---------------------------------------------------------------------------\n\nconst BRAND_TO_DOMAIN: Record<string, Lark.Domain> = {\n  feishu: Lark.Domain.Feishu,\n  lark: Lark.Domain.Lark,\n};\n\n/** Map a `LarkBrand` to the SDK `domain` parameter. */\nfunction resolveBrand(brand: LarkBrand | undefined): Lark.Domain | string {\n  return BRAND_TO_DOMAIN[brand ?? 'feishu'] ?? brand!.replace(/\\/+$/, '');\n}\n\n// ---------------------------------------------------------------------------\n// LarkClient\n// ---------------------------------------------------------------------------\n\n/** Instance cache keyed by accountId. */\nconst cache = new Map<string, LarkClient>();\n\nexport class LarkClient {\n  readonly account: LarkAccount;\n\n  private _sdk: Lark.Client | null = null;\n  private _wsClient: Lark.WSClient | null = null;\n  private _botOpenId: string | undefined;\n  private _botName: string | undefined;\n  private _lastProbeResult: FeishuProbeResult | null = null;\n  private _lastProbeAt = 0;\n\n  /** Attached message deduplicator \u2014 disposed together with the client. */\n  messageDedup: MessageDedup | null = null;\n\n  // ---- Plugin runtime (singleton) ------------------------------------------\n\n  private static _runtime: PluginRuntime | null = null;\n\n  /** Persist the runtime instance for later retrieval (activate \u9636\u6BB5\u8C03\u7528\u4E00\u6B21). */\n  static setRuntime(runtime: PluginRuntime): void {\n    LarkClient._runtime = runtime;\n  }\n\n  /** Retrieve the stored runtime instance. Throws if not yet initialised. */\n  static get runtime(): PluginRuntime {\n    if (!LarkClient._runtime) {\n      throw new Error(\n        'Feishu plugin runtime has not been initialised. ' +\n          'Ensure LarkClient.setRuntime() is called during plugin activation.',\n      );\n    }\n    return LarkClient._runtime;\n  }\n\n  // ---- Global config (singleton) -------------------------------------------\n  //\n  // Plugin commands receive an account-scoped config (channels.feishu replaced\n  // with the merged per-account config, `accounts` map stripped).  Commands\n  // that need cross-account visibility (e.g. doctor, diagnose) read the\n  // original global config from here.\n\n  private static _globalConfig: ClawdbotConfig | null = null;\n\n  /** Store the original global config (called during monitor startup). */\n  static setGlobalConfig(cfg: ClawdbotConfig): void {\n    LarkClient._globalConfig = cfg;\n  }\n\n  /** Retrieve the stored global config, or `null` if not yet set. */\n  static get globalConfig(): ClawdbotConfig | null {\n    return LarkClient._globalConfig;\n  }\n\n  // --------------------------------------------------------------------------\n\n  private constructor(account: LarkAccount) {\n    this.account = account;\n  }\n\n  /** Shorthand for `this.account.accountId`. */\n  get accountId(): string {\n    return this.account.accountId;\n  }\n\n  // ---- Static factory / cache ------------------------------------------------\n\n  /** Resolve account from config and return a cached `LarkClient`. */\n  static fromCfg(cfg: ClawdbotConfig, accountId?: string): LarkClient {\n    return LarkClient.fromAccount(getLarkAccount(cfg, accountId));\n  }\n\n  /**\n   * Get (or create) a cached `LarkClient` for the given account.\n   * If the cached instance has stale credentials it is replaced.\n   */\n  static fromAccount(account: LarkAccount): LarkClient {\n    const existing = cache.get(account.accountId);\n    if (existing && existing.account.appId === account.appId && existing.account.appSecret === account.appSecret) {\n      return existing;\n    }\n    // Credentials changed \u2014 tear down the stale instance before replacing it.\n    if (existing) {\n      log.info(`credentials changed, disposing stale instance`, { accountId: account.accountId });\n      existing.dispose();\n    }\n    const instance = new LarkClient(account);\n    cache.set(account.accountId, instance);\n    return instance;\n  }\n\n  /**\n   * Create an ephemeral `LarkClient` from bare credentials.\n   * The instance is **not** added to the global cache \u2014 suitable for\n   * one-off probe / diagnose calls that should not pollute account state.\n   */\n  static fromCredentials(credentials: LarkClientCredentials): LarkClient {\n    const base = {\n      accountId: credentials.accountId ?? 'default',\n      enabled: true as const,\n      brand: credentials.brand ?? ('feishu' as const),\n      config: {} as any,\n    };\n\n    const account: LarkAccount =\n      credentials.appId && credentials.appSecret\n        ? { ...base, configured: true as const, appId: credentials.appId, appSecret: credentials.appSecret }\n        : { ...base, configured: false as const, appId: credentials.appId, appSecret: credentials.appSecret };\n\n    return new LarkClient(account);\n  }\n\n  /** Look up a cached instance by accountId. */\n  static get(accountId: string): LarkClient | null {\n    return cache.get(accountId) ?? null;\n  }\n\n  /**\n   * Dispose one or all cached instances.\n   * With `accountId` \u2014 dispose that single instance.\n   * Without \u2014 dispose every cached instance and clear the cache.\n   */\n  static clearCache(accountId?: string): void {\n    if (accountId !== undefined) {\n      cache.get(accountId)?.dispose();\n      clearUserNameCache(accountId);\n      clearChatInfoCache(accountId);\n    } else {\n      for (const inst of cache.values()) inst.dispose();\n      clearUserNameCache();\n      clearChatInfoCache();\n    }\n  }\n\n  // ---- SDK client (lazy) -----------------------------------------------------\n\n  /** Lazily-created Lark SDK client. */\n  get sdk(): Lark.Client {\n    if (!this._sdk) {\n      const { appId, appSecret } = this.requireCredentials();\n      this._sdk = new Lark.Client({\n        appId,\n        appSecret,\n        appType: Lark.AppType.SelfBuild,\n        domain: resolveBrand(this.account.brand),\n      });\n    }\n    return this._sdk;\n  }\n\n  // ---- Bot identity ----------------------------------------------------------\n\n  /**\n   * Probe bot identity via the `bot/v3/info` API.\n   * Results are cached on the instance for subsequent access via\n   * `botOpenId` / `botName`.\n   */\n  async probe(opts?: { maxAgeMs?: number }): Promise<FeishuProbeResult> {\n    const maxAge = opts?.maxAgeMs ?? 0;\n\n    if (maxAge > 0 && this._lastProbeResult && Date.now() - this._lastProbeAt < maxAge) {\n      return this._lastProbeResult;\n    }\n\n    if (!this.account.appId || !this.account.appSecret) {\n      return { ok: false, error: 'missing credentials (appId, appSecret)' };\n    }\n\n    try {\n      const res = await (this.sdk as any).request({\n        method: 'GET',\n        url: '/open-apis/bot/v3/info',\n        data: {},\n      });\n\n      if (res.code !== 0) {\n        const result: FeishuProbeResult = {\n          ok: false,\n          appId: this.account.appId,\n          error: `API error: ${res.msg || `code ${res.code}`}`,\n        };\n        this._lastProbeResult = result;\n        this._lastProbeAt = Date.now();\n        return result;\n      }\n\n      const bot = res.bot || res.data?.bot;\n      this._botOpenId = bot?.open_id;\n      this._botName = bot?.bot_name;\n\n      const result: FeishuProbeResult = {\n        ok: true,\n        appId: this.account.appId,\n        botName: this._botName,\n        botOpenId: this._botOpenId,\n      };\n      this._lastProbeResult = result;\n      this._lastProbeAt = Date.now();\n      return result;\n    } catch (err) {\n      const result: FeishuProbeResult = {\n        ok: false,\n        appId: this.account.appId,\n        error: err instanceof Error ? err.message : String(err),\n      };\n      this._lastProbeResult = result;\n      this._lastProbeAt = Date.now();\n      return result;\n    }\n  }\n\n  /** Cached bot open_id (available after `probe()` or `startWS()`). */\n  get botOpenId(): string | undefined {\n    return this._botOpenId;\n  }\n\n  /** Cached bot name (available after `probe()` or `startWS()`). */\n  get botName(): string | undefined {\n    return this._botName;\n  }\n\n  // ---- WebSocket lifecycle ---------------------------------------------------\n\n  /**\n   * Start WebSocket event monitoring.\n   *\n   * Flow: probe bot identity \u2192 EventDispatcher \u2192 WSClient \u2192 start.\n   * The returned Promise resolves when `abortSignal` fires.\n   */\n  async startWS(opts: {\n    handlers: Record<string, (data: unknown) => Promise<void>>;\n    abortSignal?: AbortSignal;\n    autoProbe?: boolean;\n  }): Promise<void> {\n    const { handlers, abortSignal, autoProbe = true } = opts;\n\n    if (autoProbe) await this.probe();\n\n    const dispatcher = new Lark.EventDispatcher({\n      encryptKey: this.account.encryptKey ?? '',\n      verificationToken: this.account.verificationToken ?? '',\n    });\n    dispatcher.register(handlers as any);\n\n    const { appId, appSecret } = this.requireCredentials();\n    // Close any existing WSClient before creating a new one to prevent\n    // orphaned connections when startWS is called multiple times.\n    if (this._wsClient) {\n      log.warn(`closing previous WSClient before reconnect`, { accountId: this.accountId });\n      try {\n        this._wsClient.close({ force: true });\n      } catch {\n        // Ignore \u2014 the old client may already be torn down.\n      }\n      this._wsClient = null;\n    }\n\n    this._wsClient = new Lark.WSClient({\n      appId,\n      appSecret,\n      domain: resolveBrand(this.account.brand),\n      loggerLevel: Lark.LoggerLevel.info,\n    });\n\n    // SDK \u7684 handleEventData \u53EA\u5904\u7406 type=\"event\"\uFF0Ccard action \u56DE\u8C03\u662F type=\"card\" \u4F1A\u88AB\u4E22\u5F03\u3002\n    // \u6253 patch \u5C06 \"card\" \u7C7B\u578B\u6D88\u606F\u6539\u6210 \"event\" \u540E\u4EA4\u7ED9\u539F handler\uFF0C\u8BA9 EventDispatcher \u6B63\u5E38\u8DEF\u7531\u3002\n    const wsClientAny = this._wsClient as any;\n    const origHandleEventData = wsClientAny.handleEventData.bind(wsClientAny);\n    wsClientAny.handleEventData = (data: any) => {\n      const msgType = data.headers?.find?.((h: any) => h.key === 'type')?.value;\n      if (msgType === 'card') {\n        const patchedData = {\n          ...data,\n          headers: data.headers.map((h: any) => (h.key === 'type' ? { ...h, value: 'event' } : h)),\n        };\n        return origHandleEventData(patchedData);\n      }\n      return origHandleEventData(data);\n    };\n\n    await this.waitForAbort(dispatcher, abortSignal);\n  }\n\n  /** Whether a WebSocket client is currently active. */\n  get wsConnected(): boolean {\n    return this._wsClient !== null;\n  }\n\n  /** Disconnect WebSocket but keep instance in cache. */\n  disconnect(): void {\n    if (this._wsClient) {\n      log.info(`disconnecting WebSocket`, { accountId: this.accountId });\n      try {\n        this._wsClient.close({ force: true });\n      } catch {\n        // Ignore errors during close \u2014 the client may already be torn down.\n      }\n    }\n    this._wsClient = null;\n    if (this.messageDedup) {\n      log.info(`disposing message dedup`, { accountId: this.accountId, size: this.messageDedup.size });\n      this.messageDedup.dispose();\n      this.messageDedup = null;\n    }\n  }\n\n  /** Disconnect + remove from cache. */\n  dispose(): void {\n    this.disconnect();\n    cache.delete(this.accountId);\n  }\n\n  // ---- Private helpers -------------------------------------------------------\n\n  /** Assert credentials exist or throw. */\n  private requireCredentials(): { appId: string; appSecret: string } {\n    const appId = this.account.appId;\n    const appSecret = this.account.appSecret;\n    if (!appId || !appSecret) {\n      throw new Error(`LarkClient[${this.accountId}]: appId and appSecret are required`);\n    }\n    return { appId, appSecret };\n  }\n\n  /**\n   * Start the WSClient and return a promise that resolves when the\n   * abort signal fires (or immediately if already aborted).\n   */\n  private waitForAbort(dispatcher: Lark.EventDispatcher, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      if (signal?.aborted) {\n        this.disconnect();\n        return resolve();\n      }\n\n      signal?.addEventListener(\n        'abort',\n        () => {\n          this.disconnect();\n          resolve();\n        },\n        { once: true },\n      );\n\n      try {\n        void this._wsClient!.start({ eventDispatcher: dispatcher });\n      } catch (err) {\n        this.disconnect();\n        reject(err);\n      }\n    });\n  }\n}\n"],
+  "mappings": "AAgBA,YAAY,UAAU;AAItB,SAAS,sBAAsB;AAC/B,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AAC7B,SAAS,kBAAkB;AAE3B,MAAM,MAAM,WAAW,kBAAkB;AAOzC,MAAM,6BAA6B;AAEnC,SAAS,yBAA+B;AAEtC,EAAC,WAAuC,0BAA0B,IAAI,aAAa;AACrF;AAEA,uBAAuB;AACvB,KAAK,oBAAoB,aAAa,QAAQ,WAAW,CAAC;AAE1D,KAAK,oBAAoB,aAAa,QAAQ;AAAA,EAC5C,CAAC,QAAQ;AACP,QAAI,IAAI,SAAS;AACf,UAAI,QAAQ,YAAY,IAAI,aAAa;AAAA,IAC3C;AACA,WAAO;AAAA,EACT;AAAA,EACA;AAAA,EACA,EAAE,aAAa,KAAK;AACtB;AAiBA,MAAM,kBAA+C;AAAA,EACnD,QAAQ,KAAK,OAAO;AAAA,EACpB,MAAM,KAAK,OAAO;AACpB;AAGA,SAAS,aAAa,OAAoD;AACxE,SAAO,gBAAgB,SAAS,QAAQ,KAAK,MAAO,QAAQ,QAAQ,EAAE;AACxE;AAOA,MAAM,QAAQ,oBAAI,IAAwB;AAEnC,MAAM,WAAW;AAAA,EACb;AAAA,EAED,OAA2B;AAAA,EAC3B,YAAkC;AAAA,EAClC;AAAA,EACA;AAAA,EACA,mBAA6C;AAAA,EAC7C,eAAe;AAAA;AAAA,EAGvB,eAAoC;AAAA;AAAA,EAIpC,OAAe,WAAiC;AAAA;AAAA,EAGhD,OAAO,WAAW,SAA8B;AAC9C,eAAW,WAAW;AAAA,EACxB;AAAA;AAAA,EAGA,WAAW,UAAyB;AAClC,QAAI,CAAC,WAAW,UAAU;AACxB,YAAM,IAAI;AAAA,QACR;AAAA,MAEF;AAAA,IACF;AACA,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAe,gBAAuC;AAAA;AAAA,EAGtD,OAAO,gBAAgB,KAA2B;AAChD,eAAW,gBAAgB;AAAA,EAC7B;AAAA;AAAA,EAGA,WAAW,eAAsC;AAC/C,WAAO,WAAW;AAAA,EACpB;AAAA;AAAA,EAIQ,YAAY,SAAsB;AACxC,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA,EAGA,IAAI,YAAoB;AACtB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA,EAKA,OAAO,QAAQ,KAAqB,WAAgC;AAClE,WAAO,WAAW,YAAY,eAAe,KAAK,SAAS,CAAC;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,YAAY,SAAkC;AACnD,UAAM,WAAW,MAAM,IAAI,QAAQ,SAAS;AAC5C,QAAI,YAAY,SAAS,QAAQ,UAAU,QAAQ,SAAS,SAAS,QAAQ,cAAc,QAAQ,WAAW;AAC5G,aAAO;AAAA,IACT;AAEA,QAAI,UAAU;AACZ,UAAI,KAAK,iDAAiD,EAAE,WAAW,QAAQ,UAAU,CAAC;AAC1F,eAAS,QAAQ;AAAA,IACnB;AACA,UAAM,WAAW,IAAI,WAAW,OAAO;AACvC,UAAM,IAAI,QAAQ,WAAW,QAAQ;AACrC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,gBAAgB,aAAgD;AACrE,UAAM,OAAO;AAAA,MACX,WAAW,YAAY,aAAa;AAAA,MACpC,SAAS;AAAA,MACT,OAAO,YAAY,SAAU;AAAA,MAC7B,QAAQ,CAAC;AAAA,IACX;AAEA,UAAM,UACJ,YAAY,SAAS,YAAY,YAC7B,EAAE,GAAG,MAAM,YAAY,MAAe,OAAO,YAAY,OAAO,WAAW,YAAY,UAAU,IACjG,EAAE,GAAG,MAAM,YAAY,OAAgB,OAAO,YAAY,OAAO,WAAW,YAAY,UAAU;AAExG,WAAO,IAAI,WAAW,OAAO;AAAA,EAC/B;AAAA;AAAA,EAGA,OAAO,IAAI,WAAsC;AAC/C,WAAO,MAAM,IAAI,SAAS,KAAK;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,WAAW,WAA0B;AAC1C,QAAI,cAAc,QAAW;AAC3B,YAAM,IAAI,SAAS,GAAG,QAAQ;AAC9B,yBAAmB,SAAS;AAC5B,yBAAmB,SAAS;AAAA,IAC9B,OAAO;AACL,iBAAW,QAAQ,MAAM,OAAO,EAAG,MAAK,QAAQ;AAChD,yBAAmB;AACnB,yBAAmB;AAAA,IACrB;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,IAAI,MAAmB;AACrB,QAAI,CAAC,KAAK,MAAM;AACd,YAAM,EAAE,OAAO,UAAU,IAAI,KAAK,mBAAmB;AACrD,WAAK,OAAO,IAAI,KAAK,OAAO;AAAA,QAC1B;AAAA,QACA;AAAA,QACA,SAAS,KAAK,QAAQ;AAAA,QACtB,QAAQ,aAAa,KAAK,QAAQ,KAAK;AAAA,MACzC,CAAC;AAAA,IACH;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MAAM,MAA0D;AACpE,UAAM,SAAS,MAAM,YAAY;AAEjC,QAAI,SAAS,KAAK,KAAK,oBAAoB,KAAK,IAAI,IAAI,KAAK,eAAe,QAAQ;AAClF,aAAO,KAAK;AAAA,IACd;AAEA,QAAI,CAAC,KAAK,QAAQ,SAAS,CAAC,KAAK,QAAQ,WAAW;AAClD,aAAO,EAAE,IAAI,OAAO,OAAO,yCAAyC;AAAA,IACtE;AAEA,QAAI;AACF,YAAM,MAAM,MAAO,KAAK,IAAY,QAAQ;AAAA,QAC1C,QAAQ;AAAA,QACR,KAAK;AAAA,QACL,MAAM,CAAC;AAAA,MACT,CAAC;AAED,UAAI,IAAI,SAAS,GAAG;AAClB,cAAMA,UAA4B;AAAA,UAChC,IAAI;AAAA,UACJ,OAAO,KAAK,QAAQ;AAAA,UACpB,OAAO,cAAc,IAAI,OAAO,QAAQ,IAAI,IAAI,EAAE;AAAA,QACpD;AACA,aAAK,mBAAmBA;AACxB,aAAK,eAAe,KAAK,IAAI;AAC7B,eAAOA;AAAA,MACT;AAEA,YAAM,MAAM,IAAI,OAAO,IAAI,MAAM;AACjC,WAAK,aAAa,KAAK;AACvB,WAAK,WAAW,KAAK;AAErB,YAAM,SAA4B;AAAA,QAChC,IAAI;AAAA,QACJ,OAAO,KAAK,QAAQ;AAAA,QACpB,SAAS,KAAK;AAAA,QACd,WAAW,KAAK;AAAA,MAClB;AACA,WAAK,mBAAmB;AACxB,WAAK,eAAe,KAAK,IAAI;AAC7B,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,YAAM,SAA4B;AAAA,QAChC,IAAI;AAAA,QACJ,OAAO,KAAK,QAAQ;AAAA,QACpB,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,MACxD;AACA,WAAK,mBAAmB;AACxB,WAAK,eAAe,KAAK,IAAI;AAC7B,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,YAAgC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,UAA8B;AAChC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,QAAQ,MAII;AAChB,UAAM,EAAE,UAAU,aAAa,YAAY,KAAK,IAAI;AAEpD,QAAI,UAAW,OAAM,KAAK,MAAM;AAEhC,UAAM,aAAa,IAAI,KAAK,gBAAgB;AAAA,MAC1C,YAAY,KAAK,QAAQ,cAAc;AAAA,MACvC,mBAAmB,KAAK,QAAQ,qBAAqB;AAAA,IACvD,CAAC;AACD,eAAW,SAAS,QAAe;AAEnC,UAAM,EAAE,OAAO,UAAU,IAAI,KAAK,mBAAmB;AAGrD,QAAI,KAAK,WAAW;AAClB,UAAI,KAAK,8CAA8C,EAAE,WAAW,KAAK,UAAU,CAAC;AACpF,UAAI;AACF,aAAK,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;AAAA,MACtC,QAAQ;AAAA,MAER;AACA,WAAK,YAAY;AAAA,IACnB;AAEA,SAAK,YAAY,IAAI,KAAK,SAAS;AAAA,MACjC;AAAA,MACA;AAAA,MACA,QAAQ,aAAa,KAAK,QAAQ,KAAK;AAAA,MACvC,aAAa,KAAK,YAAY;AAAA,IAChC,CAAC;AAID,UAAM,cAAc,KAAK;AACzB,UAAM,sBAAsB,YAAY,gBAAgB,KAAK,WAAW;AACxE,gBAAY,kBAAkB,CAAC,SAAc;AAC3C,YAAM,UAAU,KAAK,SAAS,OAAO,CAAC,MAAW,EAAE,QAAQ,MAAM,GAAG;AACpE,UAAI,YAAY,QAAQ;AACtB,cAAM,cAAc;AAAA,UAClB,GAAG;AAAA,UACH,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAY,EAAE,QAAQ,SAAS,EAAE,GAAG,GAAG,OAAO,QAAQ,IAAI,CAAE;AAAA,QACzF;AACA,eAAO,oBAAoB,WAAW;AAAA,MACxC;AACA,aAAO,oBAAoB,IAAI;AAAA,IACjC;AAEA,UAAM,KAAK,aAAa,YAAY,WAAW;AAAA,EACjD;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA;AAAA,EAGA,aAAmB;AACjB,QAAI,KAAK,WAAW;AAClB,UAAI,KAAK,2BAA2B,EAAE,WAAW,KAAK,UAAU,CAAC;AACjE,UAAI;AACF,aAAK,UAAU,MAAM,EAAE,OAAO,KAAK,CAAC;AAAA,MACtC,QAAQ;AAAA,MAER;AAAA,IACF;AACA,SAAK,YAAY;AACjB,QAAI,KAAK,cAAc;AACrB,UAAI,KAAK,2BAA2B,EAAE,WAAW,KAAK,WAAW,MAAM,KAAK,aAAa,KAAK,CAAC;AAC/F,WAAK,aAAa,QAAQ;AAC1B,WAAK,eAAe;AAAA,IACtB;AAAA,EACF;AAAA;AAAA,EAGA,UAAgB;AACd,SAAK,WAAW;AAChB,UAAM,OAAO,KAAK,SAAS;AAAA,EAC7B;AAAA;AAAA;AAAA,EAKQ,qBAA2D;AACjE,UAAM,QAAQ,KAAK,QAAQ;AAC3B,UAAM,YAAY,KAAK,QAAQ;AAC/B,QAAI,CAAC,SAAS,CAAC,WAAW;AACxB,YAAM,IAAI,MAAM,cAAc,KAAK,SAAS,qCAAqC;AAAA,IACnF;AACA,WAAO,EAAE,OAAO,UAAU;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,aAAa,YAAkC,QAAqC;AAC1F,WAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,UAAI,QAAQ,SAAS;AACnB,aAAK,WAAW;AAChB,eAAO,QAAQ;AAAA,MACjB;AAEA,cAAQ;AAAA,QACN;AAAA,QACA,MAAM;AACJ,eAAK,WAAW;AAChB,kBAAQ;AAAA,QACV;AAAA,QACA,EAAE,MAAM,KAAK;AAAA,MACf;AAEA,UAAI;AACF,aAAK,KAAK,UAAW,MAAM,EAAE,iBAAiB,WAAW,CAAC;AAAA,MAC5D,SAAS,KAAK;AACZ,aAAK,WAAW;AAChB,eAAO,GAAG;AAAA,MACZ;AAAA,IACF,CAAC;AAAA,EACH;AACF;",
+  "names": ["result"]
+}

package/dist/src/core/lark-logger.js

@@ -0,0 +1,92 @@
+import { LarkClient } from "./lark-client";
+import { getTicket } from "./lark-ticket";
+const CYAN = "\x1B[36m";
+const YELLOW = "\x1B[33m";
+const RED = "\x1B[31m";
+const GRAY = "\x1B[90m";
+const RESET = "\x1B[0m";
+function consoleFallback(subsystem) {
+  const tag = `feishu/${subsystem}`;
+  return {
+    debug: (msg, meta) => console.debug(`${GRAY}[${tag}]${RESET}`, msg, ...meta ? [meta] : []),
+    info: (msg, meta) => console.log(`${CYAN}[${tag}]${RESET}`, msg, ...meta ? [meta] : []),
+    warn: (msg, meta) => console.warn(`${YELLOW}[${tag}]${RESET}`, msg, ...meta ? [meta] : []),
+    error: (msg, meta) => console.error(`${RED}[${tag}]${RESET}`, msg, ...meta ? [meta] : [])
+  };
+}
+function resolveRuntimeLogger(subsystem) {
+  try {
+    return LarkClient.runtime.logging.getChildLogger({
+      subsystem: `feishu/${subsystem}`
+    });
+  } catch {
+    return null;
+  }
+}
+function getTraceMeta() {
+  const ctx = getTicket();
+  if (!ctx) return null;
+  const trace = {
+    accountId: ctx.accountId,
+    messageId: ctx.messageId,
+    chatId: ctx.chatId
+  };
+  if (ctx.senderOpenId) trace.senderOpenId = ctx.senderOpenId;
+  return trace;
+}
+function enrichMeta(meta) {
+  const trace = getTraceMeta();
+  if (!trace) return meta ?? {};
+  return meta ? { ...trace, ...meta } : trace;
+}
+function buildTracePrefix() {
+  const ctx = getTicket();
+  if (!ctx) return "feishu:";
+  return `feishu[${ctx.accountId}][msg:${ctx.messageId}]:`;
+}
+function formatMessage(message, meta) {
+  const prefix = buildTracePrefix();
+  if (!meta || Object.keys(meta).length === 0) return `${prefix} ${message}`;
+  const parts = Object.entries(meta).map(([k, v]) => {
+    if (v === void 0 || v === null) return null;
+    if (typeof v === "object") return `${k}=${JSON.stringify(v)}`;
+    return `${k}=${v}`;
+  }).filter(Boolean);
+  return parts.length > 0 ? `${prefix} ${message} (${parts.join(", ")})` : `${prefix} ${message}`;
+}
+function createLarkLogger(subsystem) {
+  let cachedLogger = null;
+  let resolved = false;
+  function getLogger() {
+    if (!resolved) {
+      cachedLogger = resolveRuntimeLogger(subsystem);
+      if (cachedLogger) resolved = true;
+    }
+    return cachedLogger ?? consoleFallback(subsystem);
+  }
+  return {
+    subsystem,
+    debug(message, meta) {
+      getLogger().debug?.(formatMessage(message, meta), enrichMeta(meta));
+    },
+    info(message, meta) {
+      getLogger().info(formatMessage(message, meta), enrichMeta(meta));
+    },
+    warn(message, meta) {
+      getLogger().warn(formatMessage(message, meta), enrichMeta(meta));
+    },
+    error(message, meta) {
+      getLogger().error(formatMessage(message, meta), enrichMeta(meta));
+    },
+    child(name) {
+      return createLarkLogger(`${subsystem}/${name}`);
+    }
+  };
+}
+function larkLogger(subsystem) {
+  return createLarkLogger(subsystem);
+}
+export {
+  larkLogger
+};
+//# sourceMappingURL=lark-logger.js.map

package/dist/src/core/lark-logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/lark-logger.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Structured logger factory for the Feishu plugin.\n *\n * Wraps `PluginRuntime.logging.getChildLogger()` with automatic\n * LarkTicket injection from AsyncLocalStorage and a console fallback\n * when the runtime is not yet initialised.\n *\n * Usage:\n *   const log = larkLogger(\"card/streaming\");\n *   log.info(\"created entity\", { cardId, sequence });\n */\n\nimport type { RuntimeLogger } from 'openclaw/plugin-sdk';\nimport { LarkClient } from './lark-client';\nimport { getTicket } from './lark-ticket';\n\n// ---------------------------------------------------------------------------\n// Public interface\n// ---------------------------------------------------------------------------\n\nexport interface LarkLogger {\n  readonly subsystem: string;\n  debug(message: string, meta?: Record<string, unknown>): void;\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n  child(name: string): LarkLogger;\n}\n\n// ---------------------------------------------------------------------------\n// Console fallback (with ANSI colors)\n// ---------------------------------------------------------------------------\n\n// ANSI escape codes for colored console output\nconst CYAN = '\\x1b[36m';\nconst YELLOW = '\\x1b[33m';\nconst RED = '\\x1b[31m';\nconst GRAY = '\\x1b[90m';\nconst RESET = '\\x1b[0m';\n\nfunction consoleFallback(subsystem: string): RuntimeLogger {\n  const tag = `feishu/${subsystem}`;\n  /* eslint-disable no-console -- logger\u5E95\u5C42\u5B9E\u73B0\uFF0Cconsole \u662F\u6700\u7EC8\u8F93\u51FA\u76EE\u6807 */\n  return {\n    debug: (msg, meta) => console.debug(`${GRAY}[${tag}]${RESET}`, msg, ...(meta ? [meta] : [])),\n    info: (msg, meta) => console.log(`${CYAN}[${tag}]${RESET}`, msg, ...(meta ? [meta] : [])),\n    warn: (msg, meta) => console.warn(`${YELLOW}[${tag}]${RESET}`, msg, ...(meta ? [meta] : [])),\n    error: (msg, meta) => console.error(`${RED}[${tag}]${RESET}`, msg, ...(meta ? [meta] : [])),\n  };\n  /* eslint-enable no-console */\n}\n\n// ---------------------------------------------------------------------------\n// Lazy runtime resolution\n// ---------------------------------------------------------------------------\n\nfunction resolveRuntimeLogger(subsystem: string): RuntimeLogger | null {\n  try {\n    return LarkClient.runtime.logging.getChildLogger({\n      subsystem: `feishu/${subsystem}`,\n    });\n  } catch {\n    return null;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// LarkTicket enrichment\n// ---------------------------------------------------------------------------\n\nfunction getTraceMeta(): Record<string, unknown> | null {\n  const ctx = getTicket();\n  if (!ctx) return null;\n  const trace: Record<string, unknown> = {\n    accountId: ctx.accountId,\n    messageId: ctx.messageId,\n    chatId: ctx.chatId,\n  };\n  if (ctx.senderOpenId) trace.senderOpenId = ctx.senderOpenId;\n  return trace;\n}\n\nfunction enrichMeta(meta: Record<string, unknown> | undefined): Record<string, unknown> {\n  const trace = getTraceMeta();\n  if (!trace) return meta ?? {};\n  return meta ? { ...trace, ...meta } : trace;\n}\n\n// ---------------------------------------------------------------------------\n// Message formatting\n// ---------------------------------------------------------------------------\n\n/**\n * Build a trace-aware prefix like `feishu[default][msg:om_xxx]:`.\n *\n * Mirrors the format used by `trace.ts` so log lines are consistent\n * across the old and new logging systems.\n */\nfunction buildTracePrefix(): string {\n  const ctx = getTicket();\n  if (!ctx) return 'feishu:';\n  return `feishu[${ctx.accountId}][msg:${ctx.messageId}]:`;\n}\n\n/**\n * Format message with inline meta for text-based log output.\n *\n * RuntimeLogger implementations typically ignore the `meta` parameter in\n * their text output (gateway.log / console).  To ensure meta is always\n * visible, we serialize user-supplied meta into the message string and\n * prepend the trace context prefix (accountId + messageId).\n *\n * Example:\n *   formatMessage(\"card.create response\", { code: 0, cardId: \"c_xxx\" })\n *   \u2192 \"feishu[default][msg:om_xxx]: card.create response (code=0, cardId=c_xxx)\"\n */\nfunction formatMessage(message: string, meta: Record<string, unknown> | undefined): string {\n  const prefix = buildTracePrefix();\n  if (!meta || Object.keys(meta).length === 0) return `${prefix} ${message}`;\n  const parts = Object.entries(meta)\n    .map(([k, v]) => {\n      if (v === undefined || v === null) return null;\n      if (typeof v === 'object') return `${k}=${JSON.stringify(v)}`;\n      return `${k}=${v}`;\n    })\n    .filter(Boolean);\n  return parts.length > 0 ? `${prefix} ${message} (${parts.join(', ')})` : `${prefix} ${message}`;\n}\n\n// ---------------------------------------------------------------------------\n// LarkLogger implementation\n// ---------------------------------------------------------------------------\n\nfunction createLarkLogger(subsystem: string): LarkLogger {\n  // RuntimeLogger is resolved lazily on first log call so that module-level\n  // `larkLogger()` calls work even before `LarkClient.setRuntime()`.\n  let cachedLogger: RuntimeLogger | null = null;\n  let resolved = false;\n\n  function getLogger(): RuntimeLogger {\n    if (!resolved) {\n      cachedLogger = resolveRuntimeLogger(subsystem);\n      if (cachedLogger) resolved = true;\n    }\n    return cachedLogger ?? consoleFallback(subsystem);\n  }\n\n  return {\n    subsystem,\n    debug(message: string, meta?: Record<string, unknown>): void {\n      getLogger().debug?.(formatMessage(message, meta), enrichMeta(meta));\n    },\n    info(message: string, meta?: Record<string, unknown>): void {\n      getLogger().info(formatMessage(message, meta), enrichMeta(meta));\n    },\n    warn(message: string, meta?: Record<string, unknown>): void {\n      getLogger().warn(formatMessage(message, meta), enrichMeta(meta));\n    },\n    error(message: string, meta?: Record<string, unknown>): void {\n      getLogger().error(formatMessage(message, meta), enrichMeta(meta));\n    },\n    child(name: string): LarkLogger {\n      return createLarkLogger(`${subsystem}/${name}`);\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Public factory\n// ---------------------------------------------------------------------------\n\nexport function larkLogger(subsystem: string): LarkLogger {\n  return createLarkLogger(subsystem);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/lark-ticket.js

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const store = new AsyncLocalStorage();
+function withTicket(ticket, fn) {
+  return store.run(ticket, fn);
+}
+function getTicket() {
+  return store.getStore();
+}
+function ticketElapsed() {
+  const t = store.getStore();
+  return t ? Date.now() - t.startTime : 0;
+}
+export {
+  getTicket,
+  ticketElapsed,
+  withTicket
+};
+//# sourceMappingURL=lark-ticket.js.map

package/dist/src/core/lark-ticket.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/lark-ticket.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Request-level ticket for the Feishu plugin.\n *\n * Uses Node.js AsyncLocalStorage to propagate a ticket (message_id,\n * chat_id, account_id) through the entire async call chain without passing\n * parameters explicitly.  Call {@link withTicket} at the event entry point\n * (monitor.ts) and use {@link getTicket} anywhere downstream.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface LarkTicket {\n  messageId: string;\n  chatId: string;\n  accountId: string;\n  startTime: number;\n  senderOpenId?: string;\n  chatType?: 'p2p' | 'group';\n  threadId?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Storage\n// ---------------------------------------------------------------------------\n\nconst store = new AsyncLocalStorage<LarkTicket>();\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Run `fn` within a ticket context.  All async operations spawned inside\n * `fn` will inherit the context and can access it via {@link getTicket}.\n */\nexport function withTicket<T>(ticket: LarkTicket, fn: () => T | Promise<T>): T | Promise<T> {\n  return store.run(ticket, fn);\n}\n\n/** Return the current ticket, or `undefined` if not inside withTicket. */\nexport function getTicket(): LarkTicket | undefined {\n  return store.getStore();\n}\n\n/** Milliseconds elapsed since the current ticket was created, or 0. */\nexport function ticketElapsed(): number {\n  const t = store.getStore();\n  return t ? Date.now() - t.startTime : 0;\n}\n"],
+  "mappings": "AAYA,SAAS,yBAAyB;AAoBlC,MAAM,QAAQ,IAAI,kBAA8B;AAUzC,SAAS,WAAc,QAAoB,IAA0C;AAC1F,SAAO,MAAM,IAAI,QAAQ,EAAE;AAC7B;AAGO,SAAS,YAAoC;AAClD,SAAO,MAAM,SAAS;AACxB;AAGO,SAAS,gBAAwB;AACtC,QAAM,IAAI,MAAM,SAAS;AACzB,SAAO,IAAI,KAAK,IAAI,IAAI,EAAE,YAAY;AACxC;",
+  "names": []
+}