@openclaw/feishu 2026.3.12 → 2026.5.1-beta.1

package/src/types.ts

@@ -1,24 +1,17 @@
-import type { BaseProbeResult } from "openclaw/plugin-sdk/feishu";
-import type {
-  FeishuConfigSchema,
-  FeishuGroupSchema,
-  FeishuAccountConfigSchema,
-  z,
-} from "./config-schema.js";
-import type { MentionTarget } from "./mention.js";
+import type { BaseProbeResult } from "openclaw/plugin-sdk/core";
+import type { FeishuConfigSchema, FeishuAccountConfigSchema, z } from "./config-schema.js";
+import type { MentionTarget } from "./mention-target.types.js";
 
 export type FeishuConfig = z.infer<typeof FeishuConfigSchema>;
-export type FeishuGroupConfig = z.infer<typeof FeishuGroupSchema>;
 export type FeishuAccountConfig = z.infer<typeof FeishuAccountConfigSchema>;
 
 export type FeishuDomain = "feishu" | "lark" | (string & {});
-export type FeishuConnectionMode = "websocket" | "webhook";
 
 export type FeishuDefaultAccountSelectionSource =
   | "explicit-default"
   | "mapped-default"
   | "fallback";
-export type FeishuAccountSelectionSource = "explicit" | FeishuDefaultAccountSelectionSource;
+type FeishuAccountSelectionSource = "explicit" | FeishuDefaultAccountSelectionSource;
 
 export type ResolvedFeishuAccount = {
   accountId: string;
@@ -40,10 +33,12 @@ export type FeishuIdType = "open_id" | "user_id" | "union_id" | "chat_id";
 export type FeishuMessageContext = {
   chatId: string;
   messageId: string;
+  replyTargetMessageId?: string;
+  suppressReplyTarget?: boolean;
   senderId: string;
   senderOpenId: string;
   senderName?: string;
-  chatType: "p2p" | "group" | "private";
+  chatType: FeishuChatType;
   mentionedBot: boolean;
   hasAnyMention?: boolean;
   rootId?: string;
@@ -60,7 +55,11 @@ export type FeishuSendResult = {
   chatId: string;
 };
 
-export type FeishuChatType = "p2p" | "group" | "private";
+export type FeishuChatType = "p2p" | "group" | "topic_group" | "private";
+
+export function isFeishuGroupChatType(chatType: FeishuChatType | undefined): boolean {
+  return chatType === "group" || chatType === "topic_group";
+}
 
 export type FeishuMessageInfo = {
   messageId: string;
@@ -72,13 +71,15 @@ export type FeishuMessageInfo = {
   content: string;
   contentType: string;
   createTime?: number;
+  /** Feishu thread ID (omt_xxx) — present when the message belongs to a topic thread. */
+  threadId?: string;
 };
 
-export type FeishuProbeResult = BaseProbeResult<string> & {
+export interface FeishuProbeResult extends BaseProbeResult {
   appId?: string;
   botName?: string;
   botOpenId?: string;
-};
+}
 
 export type FeishuMediaInfo = {
   path: string;

package/src/typing.ts

@@ -1,5 +1,5 @@
-import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk/feishu";
-import { resolveFeishuAccount } from "./accounts.js";
+import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";
+import { resolveFeishuRuntimeAccount } from "./accounts.js";
 import { createFeishuClient } from "./client.js";
 import { getFeishuRuntime } from "./runtime.js";
 
@@ -40,6 +40,10 @@ export type TypingIndicatorState = {
   reactionId: string | null;
 };
 
+type FeishuMessageReactionCreateResponse = Awaited<
+  ReturnType<ReturnType<typeof createFeishuClient>["im"]["messageReaction"]["create"]>
+>;
+
 /**
  * Check whether an error represents a rate-limit or quota-exceeded condition
  * from the Feishu API that should stop the typing keepalive loop.
@@ -107,7 +111,7 @@ export async function addTypingIndicator(params: {
   runtime?: RuntimeEnv;
 }): Promise<TypingIndicatorState> {
   const { cfg, messageId, accountId, runtime } = params;
-  const account = resolveFeishuAccount({ cfg, accountId });
+  const account = resolveFeishuRuntimeAccount({ cfg, accountId });
   if (!account.configured) {
     return { messageId, reactionId: null };
   }
@@ -134,8 +138,8 @@ export async function addTypingIndicator(params: {
       throw new FeishuBackoffError(backoffCode);
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK response type
-    const reactionId = (response as any)?.data?.reaction_id ?? null;
+    const typedResponse: FeishuMessageReactionCreateResponse = response;
+    const reactionId = typedResponse.data?.reaction_id ?? null;
     return { messageId, reactionId };
   } catch (err) {
     if (isFeishuBackoffError(err)) {
@@ -168,7 +172,7 @@ export async function removeTypingIndicator(params: {
     return;
   }
 
-  const account = resolveFeishuAccount({ cfg, accountId });
+  const account = resolveFeishuRuntimeAccount({ cfg, accountId });
   if (!account.configured) {
     return;
   }

package/src/wiki-schema.ts

@@ -1,4 +1,4 @@
-import { Type, type Static } from "@sinclair/typebox";
+import { Type, type Static } from "typebox";
 
 export const FeishuWikiSchema = Type.Union([
   Type.Object({

package/src/wiki.ts

@@ -1,5 +1,5 @@
 import type * as Lark from "@larksuiteoapi/node-sdk";
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk/feishu";
+import type { OpenClawPluginApi } from "../runtime-api.js";
 import { listEnabledFeishuAccounts } from "./accounts.js";
 import { createFeishuToolClient, resolveAnyEnabledFeishuToolsConfig } from "./tool-account.js";
 import {
@@ -153,19 +153,16 @@ async function renameNode(client: Lark.Client, spaceId: string, nodeToken: strin
 
 export function registerFeishuWikiTools(api: OpenClawPluginApi) {
   if (!api.config) {
-    api.logger.debug?.("feishu_wiki: No config available, skipping wiki tools");
     return;
   }
 
   const accounts = listEnabledFeishuAccounts(api.config);
   if (accounts.length === 0) {
-    api.logger.debug?.("feishu_wiki: No Feishu accounts configured, skipping wiki tools");
     return;
   }
 
   const toolsCfg = resolveAnyEnabledFeishuToolsConfig(accounts);
   if (!toolsCfg.wiki) {
-    api.logger.debug?.("feishu_wiki: wiki tool disabled in config");
     return;
   }
 
@@ -217,7 +214,6 @@ export function registerFeishuWikiTools(api: OpenClawPluginApi) {
               case "rename":
                 return jsonToolResult(await renameNode(client, p.space_id, p.node_token, p.title));
               default:
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- exhaustive check fallback
                 return unknownToolActionResult((p as { action?: unknown }).action);
             }
           } catch (err) {
@@ -228,6 +224,4 @@ export function registerFeishuWikiTools(api: OpenClawPluginApi) {
     },
     { name: "feishu_wiki" },
   );
-
-  api.logger.info?.(`feishu_wiki: Registered feishu_wiki tool`);
 }

package/subagent-hooks-api.ts

@@ -0,0 +1,31 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-entry-contract";
+
+type FeishuSubagentHooksModule = typeof import("./src/subagent-hooks.js");
+
+let feishuSubagentHooksPromise: Promise<FeishuSubagentHooksModule> | null = null;
+
+function loadFeishuSubagentHooksModule() {
+  feishuSubagentHooksPromise ??= import("./src/subagent-hooks.js");
+  return feishuSubagentHooksPromise;
+}
+
+export function registerFeishuSubagentHooks(api: OpenClawPluginApi): void {
+  api.on("subagent_spawning", async (event, ctx) => {
+    const { handleFeishuSubagentSpawning } = await loadFeishuSubagentHooksModule();
+    return await handleFeishuSubagentSpawning(event, ctx);
+  });
+  api.on("subagent_delivery_target", async (event) => {
+    const { handleFeishuSubagentDeliveryTarget } = await loadFeishuSubagentHooksModule();
+    return handleFeishuSubagentDeliveryTarget(event);
+  });
+  api.on("subagent_ended", async (event) => {
+    const { handleFeishuSubagentEnded } = await loadFeishuSubagentHooksModule();
+    handleFeishuSubagentEnded(event);
+  });
+}
+
+export {
+  handleFeishuSubagentDeliveryTarget,
+  handleFeishuSubagentEnded,
+  handleFeishuSubagentSpawning,
+} from "./src/subagent-hooks.js";

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../tsconfig.package-boundary.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts", "./src/**/*.ts"],
+  "exclude": [
+    "./**/*.test.ts",
+    "./dist/**",
+    "./node_modules/**",
+    "./src/test-support/**",
+    "./src/**/*test-helpers.ts",
+    "./src/**/*test-harness.ts",
+    "./src/**/*test-support.ts"
+  ]
+}

package/src/feishu-command-handler.ts

@@ -1,59 +0,0 @@
-const DEFAULT_RESET_TRIGGERS = ["/new", "/reset"] as const;
-
-type FeishuBeforeResetContext = {
-  cfg: Record<string, unknown>;
-  sessionEntry: Record<string, unknown>;
-  previousSessionEntry?: Record<string, unknown>;
-  commandSource: string;
-  timestamp: number;
-};
-
-type FeishuBeforeResetEvent = {
-  type: "command";
-  action: "new" | "reset";
-  context: FeishuBeforeResetContext;
-};
-
-type FeishuBeforeResetRunner = {
-  runBeforeReset: (
-    event: FeishuBeforeResetEvent,
-    ctx: { agentId: string; sessionKey: string },
-  ) => Promise<void>;
-};
-
-/**
- * Handle Feishu command messages and trigger reset hooks.
- */
-export async function handleFeishuCommand(
-  messageText: string,
-  sessionKey: string,
-  hookRunner: FeishuBeforeResetRunner,
-  context: FeishuBeforeResetContext,
-): Promise<boolean> {
-  const trimmed = messageText.trim().toLowerCase();
-  const isResetCommand = DEFAULT_RESET_TRIGGERS.some(
-    (trigger) => trimmed === trigger || trimmed.startsWith(`${trigger} `),
-  );
-  if (!isResetCommand) {
-    return false;
-  }
-
-  const command = trimmed.split(" ")[0];
-  const action: "new" | "reset" = command === "/new" ? "new" : "reset";
-  await hookRunner.runBeforeReset(
-    {
-      type: "command",
-      action,
-      context: {
-        ...context,
-        commandSource: "feishu",
-      },
-    },
-    {
-      agentId: "main",
-      sessionKey,
-    },
-  );
-
-  return true;
-}

package/src/onboarding.status.test.ts

@@ -1,25 +0,0 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk/feishu";
-import { describe, expect, it } from "vitest";
-import { feishuOnboardingAdapter } from "./onboarding.js";
-
-describe("feishu onboarding status", () => {
-  it("treats SecretRef appSecret as configured when appId is present", async () => {
-    const status = await feishuOnboardingAdapter.getStatus({
-      cfg: {
-        channels: {
-          feishu: {
-            appId: "cli_a123456",
-            appSecret: {
-              source: "env",
-              provider: "default",
-              id: "FEISHU_APP_SECRET",
-            },
-          },
-        },
-      } as OpenClawConfig,
-      accountOverrides: {},
-    });
-
-    expect(status.configured).toBe(true);
-  });
-});