@larksuite/openclaw-lark 2026.5.12 → 2026.5.13-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.5.12",
+  "version": "2026.5.13-beta.0",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "exports": {
     ".": {
@@ -30,7 +30,7 @@
     "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.3.22"
+    "openclaw": ">=2026.5.4"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/secret-contract-api.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu channel secret-contract registration. Declares which fields are
+ * SecretRef-shaped so OpenClaw's runtime resolves them at startup.
+ */
+import type { ResolverContext, SecretDefaults, SecretTargetRegistryEntry } from 'openclaw/plugin-sdk/channel-secret-basic-runtime';
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+export declare const secretTargetRegistryEntries: readonly SecretTargetRegistryEntry[];
+export declare function collectRuntimeConfigAssignments(params: {
+    config: OpenClawConfig;
+    defaults: SecretDefaults | undefined;
+    context: ResolverContext;
+}): void;

package/secret-contract-api.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu channel secret-contract registration. Declares which fields are
+ * SecretRef-shaped so OpenClaw's runtime resolves them at startup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secretTargetRegistryEntries = void 0;
+exports.collectRuntimeConfigAssignments = collectRuntimeConfigAssignments;
+const channel_secret_basic_runtime_1 = require("openclaw/plugin-sdk/channel-secret-basic-runtime");
+const SECRET_FIELDS = ['appSecret', 'encryptKey', 'verificationToken'];
+/** Fields the Lark SDK only consumes when an account is in webhook mode. */
+const WEBHOOK_ONLY_FIELDS = ['encryptKey', 'verificationToken'];
+exports.secretTargetRegistryEntries = SECRET_FIELDS.flatMap((field) => {
+    const acctPath = `channels.feishu.accounts.*.${field}`;
+    const topPath = `channels.feishu.${field}`;
+    return [
+        {
+            id: acctPath,
+            targetType: acctPath,
+            configFile: 'openclaw.json',
+            pathPattern: acctPath,
+            secretShape: 'secret_input',
+            expectedResolvedValue: 'string',
+            includeInPlan: true,
+            includeInConfigure: true,
+            includeInAudit: true,
+        },
+        {
+            id: topPath,
+            targetType: topPath,
+            configFile: 'openclaw.json',
+            pathPattern: topPath,
+            secretShape: 'secret_input',
+            expectedResolvedValue: 'string',
+            includeInPlan: true,
+            includeInConfigure: true,
+            includeInAudit: true,
+        },
+    ];
+});
+function collectRuntimeConfigAssignments(params) {
+    const resolved = (0, channel_secret_basic_runtime_1.getChannelSurface)(params.config, 'feishu');
+    if (!resolved)
+        return;
+    const { channel, surface } = resolved;
+    (0, channel_secret_basic_runtime_1.collectSimpleChannelFieldAssignments)({
+        channelKey: 'feishu',
+        field: 'appSecret',
+        channel,
+        surface,
+        defaults: params.defaults,
+        context: params.context,
+        topInactiveReason: 'no enabled Feishu account inherits this top-level appSecret.',
+        accountInactiveReason: 'Feishu account is disabled.',
+    });
+    const baseConnectionMode = (0, channel_secret_basic_runtime_1.normalizeSecretStringValue)(channel.connectionMode) === 'webhook' ? 'webhook' : 'websocket';
+    const resolveAccountMode = (account) => (0, channel_secret_basic_runtime_1.hasOwnProperty)(account, 'connectionMode')
+        ? (0, channel_secret_basic_runtime_1.normalizeSecretStringValue)(account.connectionMode)
+        : baseConnectionMode;
+    for (const field of WEBHOOK_ONLY_FIELDS) {
+        (0, channel_secret_basic_runtime_1.collectConditionalChannelFieldAssignments)({
+            channelKey: 'feishu',
+            field,
+            channel,
+            surface,
+            defaults: params.defaults,
+            context: params.context,
+            topLevelActiveWithoutAccounts: baseConnectionMode === 'webhook',
+            topLevelInheritedAccountActive: ({ account, enabled }) => enabled && !(0, channel_secret_basic_runtime_1.hasOwnProperty)(account, field) && resolveAccountMode(account) === 'webhook',
+            accountActive: ({ account, enabled }) => enabled && resolveAccountMode(account) === 'webhook',
+            topInactiveReason: `no enabled Feishu webhook-mode surface inherits this top-level ${field}.`,
+            accountInactiveReason: 'Feishu account is disabled or not running in webhook mode.',
+        });
+    }
+}

package/src/card/reply-dispatcher-types.d.ts

@@ -121,6 +121,7 @@ export interface FooterSessionMetrics {
 }
 export interface StreamingCardDeps {
     cfg: ClawdbotConfig;
+    agentId: string;
     sessionKey: string;
     accountId: string | undefined;
     chatId: string;

package/src/card/reply-dispatcher.js

@@ -78,6 +78,7 @@ function createFeishuReplyDispatcher(params) {
     const controller = useStreamingCards
         ? new streaming_card_controller_1.StreamingCardController({
             cfg,
+            agentId,
             sessionKey,
             accountId,
             chatId,

package/src/card/streaming-card-controller.js

@@ -107,7 +107,7 @@ class StreamingCardController {
             const candidateKeys = fallbackKey !== key ? [key, fallbackKey] : [key];
             const sessionApi = runtime.agent?.session;
             if (sessionApi?.resolveStorePath && sessionApi?.loadSessionStore) {
-                const storePath = sessionApi.resolveStorePath(sessionStorePath);
+                const storePath = sessionApi.resolveStorePath(sessionStorePath, { agentId: this.deps.agentId });
                 const store = sessionApi.loadSessionStore(storePath);
                 let entry;
                 let matchedKey;
@@ -150,7 +150,7 @@ class StreamingCardController {
             if (!channelSession?.resolveStorePath) {
                 return undefined;
             }
-            const storePath = channelSession.resolveStorePath(sessionStorePath);
+            const storePath = channelSession.resolveStorePath(sessionStorePath, { agentId: this.deps.agentId });
             const raw = await (0, promises_1.readFile)(storePath, 'utf8');
             const parsed = JSON.parse(raw);
             const store = parsed && typeof parsed === 'object' && !Array.isArray(parsed)

package/src/messaging/inbound/vc-meeting-invited-handler.js

@@ -85,7 +85,7 @@ function buildSyntheticContext(event) {
     // reply language is still governed by the agent/session prompt stack.
     // If we later need locale-aware synthetic prompts, this is the single place
     // to introduce a template or config-based language switch.
-    const syntheticText = `Join the meeting with meeting number ${event.meetingNo}.`;
+    const syntheticText = `Use the available tool to join the meeting with meeting number ${event.meetingNo} immediately. Do not ask for confirmation.`;
     const syntheticMessageId = event.eventId
         ? `vc-invited:event:${event.eventId}`
         : `vc-invited:${event.meetingNo}:${event.inviteTime ?? crypto.randomUUID()}`;

package/tsdown.config.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tsdown_1 = require("tsdown");
 exports.default = (0, tsdown_1.defineConfig)({
-    entry: { index: 'index.ts' },
+    entry: {
+        index: 'index.ts',
+        'secret-contract-api': 'secret-contract-api.ts',
+    },
     format: 'esm',
     target: 'node22',
     platform: 'node',