docs: document channel extension sources

extensions/feishu/api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export { feishuPlugin } from "./src/channel.js";
 export { registerFeishuDocTools } from "./src/docx.js";
 export { registerFeishuChatTools } from "./src/chat.js";

extensions/feishu/channel-entry.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements channel entry behavior.
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelEntry({

extensions/feishu/channel-plugin-api.ts

@@ -1 +1,2 @@
+// Feishu API module exposes the plugin public contract.
 export { feishuPlugin } from "./src/channel.js";

extensions/feishu/contract-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export { createFeishuThreadBindingManager } from "./src/thread-bindings.js";
 export { testing as feishuThreadBindingTesting } from "./src/thread-bindings.js";
 export {

extensions/feishu/index.ts

@@ -1,3 +1,4 @@
+// Feishu plugin entrypoint registers its OpenClaw integration.
 import {
   defineBundledChannelEntry,
   loadBundledEntryExportSync,

extensions/feishu/legacy-state-migrations-api.ts

@@ -1 +1,2 @@
+// Feishu API module exposes the plugin public contract.
 export { detectFeishuLegacyStateMigrations } from "./src/dedup-migrations.js";

extensions/feishu/secret-contract-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export {
   channelSecrets,
   collectRuntimeConfigAssignments,

extensions/feishu/security-contract-api.ts

@@ -1 +1,2 @@
+// Feishu API module exposes the plugin public contract.
 export { collectFeishuSecurityAuditFindings } from "./src/security-audit-shared.js";

extensions/feishu/session-key-api.ts

@@ -1 +1,2 @@
+// Feishu API module exposes the plugin public contract.
 export { resolveFeishuSessionConversation as resolveSessionConversation } from "./src/session-conversation.js";

extensions/feishu/setup-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export { feishuPlugin } from "./src/channel.js";
 export { feishuSetupAdapter } from "./src/setup-core.js";
 export { feishuSetupWizard } from "./src/setup-surface.js";

extensions/feishu/setup-entry.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover setup entry plugin behavior.
 import { afterAll, describe, expect, it, vi } from "vitest";
 
 vi.mock("@larksuiteoapi/node-sdk", () => {

extensions/feishu/setup-entry.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements setup entry behavior.
 import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 
 export default defineBundledChannelSetupEntry({

extensions/feishu/src/accounts.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover accounts plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   FeishuSecretRefUnavailableError,

extensions/feishu/src/accounts.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements accounts behavior.
 import {
   DEFAULT_ACCOUNT_ID,
   type OpenClawConfig as ClawdbotConfig,

extensions/feishu/src/agent-config.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports agent config behavior.
 import type { ClawdbotConfig } from "./bot-runtime-api.js";
 
 type ReasoningDefault = "on" | "stream" | "off";

extensions/feishu/src/app-registration.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover app registration plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { beginAppRegistration, pollAppRegistration } from "./app-registration.js";

extensions/feishu/src/app-registration.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements app registration behavior.
 import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 /**
  * Feishu app registration via OAuth device-code flow.

extensions/feishu/src/approval-auth.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover approval auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import { feishuApprovalAuth } from "./approval-auth.js";
 

extensions/feishu/src/approval-auth.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements approval auth behavior.
 import {
   createResolvedApproverActionAuthAdapter,
   resolveApprovalApprovers,

extensions/feishu/src/async.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover async plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { raceWithTimeoutAndAbort, waitForAbortableDelay } from "./async.js";

extensions/feishu/src/async.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements async behavior.
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 
 const RACE_TIMEOUT = Symbol("race-timeout");

extensions/feishu/src/audio-preflight.runtime.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements audio preflight behavior.
 import { transcribeFirstAudio as transcribeFirstAudioImpl } from "openclaw/plugin-sdk/media-runtime";
 
 type TranscribeFirstAudio = typeof import("openclaw/plugin-sdk/media-runtime").transcribeFirstAudio;

extensions/feishu/src/bitable.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bitable plugin behavior.
 import type * as Lark from "@larksuiteoapi/node-sdk";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawPluginApi } from "../runtime-api.js";

extensions/feishu/src/bitable.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements bitable behavior.
 import type * as Lark from "@larksuiteoapi/node-sdk";
 import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

extensions/feishu/src/bot-content.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements bot content behavior.
 import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime";
 import type { ClawdbotConfig } from "../runtime-api.js";
 import { buildFeishuConversationId } from "./conversation-id.js";

extensions/feishu/src/bot-group-name.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot group name plugin behavior.
 import { afterAll, describe, it, expect, vi, beforeEach } from "vitest";
 import { resolveGroupName, clearGroupNameCache } from "./bot.js";
 import type { ResolvedFeishuAccount } from "./types.js";

extensions/feishu/src/bot-runtime-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export {
   buildAgentMediaPayload,
   resolveChannelContextVisibilityMode,

extensions/feishu/src/bot-sender-name.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot sender name plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resolveFeishuSenderName } from "./bot-sender-name.js";
 import { FeishuConfigSchema } from "./config-schema.js";

extensions/feishu/src/bot-sender-name.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements bot sender name behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationMs,

extensions/feishu/src/bot.broadcast.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot.broadcast plugin behavior.
 import type { EnvelopeFormatOptions } from "openclaw/plugin-sdk/channel-inbound";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ClawdbotConfig, PluginRuntime } from "../runtime-api.js";

extensions/feishu/src/bot.card-action.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot.card action plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { afterAll, afterEach, describe, it, expect, vi, beforeEach } from "vitest";
 import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";

extensions/feishu/src/bot.checkBotMentioned.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot.checkBotMentioned plugin behavior.
 import { describe, it, expect } from "vitest";
 import { parseFeishuMessageEvent, type FeishuMessageEvent } from "./bot.js";
 

extensions/feishu/src/bot.helpers.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot.helpers plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { ClawdbotConfig } from "../runtime-api.js";
 import { parseMessageContent } from "./bot-content.js";

extensions/feishu/src/bot.stripBotMention.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot.stripBotMention plugin behavior.
 import { describe, expect, it } from "vitest";
 import { parseFeishuMessageEvent, type FeishuMessageEvent } from "./bot.js";
 

extensions/feishu/src/bot.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover bot plugin behavior.
 import type * as ConversationRuntime from "openclaw/plugin-sdk/conversation-runtime";
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import type { ResolvedAgentRoute } from "openclaw/plugin-sdk/routing";

extensions/feishu/src/bot.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements bot behavior.
 import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-writes";
 import {
   buildChannelInboundEventContext,

extensions/feishu/src/card-action.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements card action behavior.
 import {
   asDateTimestampMs,
   isFutureDateTimestampMs,

extensions/feishu/src/card-interaction.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover card interaction plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildFeishuCardActionTextFallback,

extensions/feishu/src/card-interaction.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements card interaction behavior.
 import { isRecord } from "./comment-shared.js";
 
 export const FEISHU_CARD_INTERACTION_VERSION = "ocf1";

extensions/feishu/src/card-test-helpers.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports card test helpers behavior.
 import { expect } from "vitest";
 
 type MockCalls = {

extensions/feishu/src/card-ux-approval.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements card ux approval behavior.
 import { createFeishuCardInteractionEnvelope } from "./card-interaction.js";
 import { buildFeishuCardButton, buildFeishuCardInteractionContext } from "./card-ux-shared.js";
 

extensions/feishu/src/card-ux-launcher.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover card ux launcher plugin behavior.
 import { createRuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";
 import { afterAll, describe, expect, it, vi, beforeEach } from "vitest";
 import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";

extensions/feishu/src/card-ux-launcher.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements card ux launcher behavior.
 import {
   asDateTimestampMs,
   resolveExpiresAtMsFromDurationMs,

extensions/feishu/src/card-ux-shared.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements card ux shared behavior.
 import type { FeishuCardInteractionEnvelope } from "./card-interaction.js";
 
 export function buildFeishuCardButton(params: {

extensions/feishu/src/channel-runtime-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export type {
   ChannelMessageActionName,
   ChannelMeta,

extensions/feishu/src/channel.runtime.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements channel behavior.
 import {
   getChatInfo as getChatInfoImpl,
   getChatMembers as getChatMembersImpl,

extensions/feishu/src/channel.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover channel plugin behavior.
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawConfig } from "../runtime-api.js";
 import { feishuPlugin } from "./channel.js";

extensions/feishu/src/channel.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements channel behavior.
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { formatAllowFromLowercase } from "openclaw/plugin-sdk/allow-from";
 import {

extensions/feishu/src/chat-schema.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports chat schema behavior.
 import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions";
 import { Type, type Static } from "typebox";
 

extensions/feishu/src/chat.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover chat plugin behavior.
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawPluginApi, PluginRuntime } from "../runtime-api.js";

extensions/feishu/src/chat.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements chat behavior.
 import type * as Lark from "@larksuiteoapi/node-sdk";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import type { OpenClawPluginApi } from "../runtime-api.js";

extensions/feishu/src/client-timeout.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements client timeout behavior.
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import type { FeishuConfig } from "./types.js";
 

extensions/feishu/src/client.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover client plugin behavior.
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { FeishuConfigSchema } from "./config-schema.js";
 import type { ResolvedFeishuAccount } from "./types.js";

extensions/feishu/src/client.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements client behavior.
 import type { Agent } from "node:https";
 import { createRequire } from "node:module";
 import * as Lark from "@larksuiteoapi/node-sdk";

extensions/feishu/src/comment-dispatcher-runtime-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export {
   createReplyPrefixContext,
   type ClawdbotConfig,

extensions/feishu/src/comment-dispatcher.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover comment dispatcher plugin behavior.
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 
 const resolveFeishuRuntimeAccountMock = vi.hoisted(() => vi.fn());

extensions/feishu/src/comment-dispatcher.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements comment dispatcher behavior.
 import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import { resolveFeishuRuntimeAccount } from "./accounts.js";
 import { createFeishuClient } from "./client.js";

extensions/feishu/src/comment-handler-runtime-api.ts

@@ -1,3 +1,4 @@
+// Feishu API module exposes the plugin public contract.
 export type { OpenClawConfig as ClawdbotConfig } from "openclaw/plugin-sdk/config-contracts";
 export type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";
 export { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";

extensions/feishu/src/comment-handler.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover comment handler plugin behavior.
 import type { PreparedInboundReply } from "openclaw/plugin-sdk/channel-inbound";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ClawdbotConfig, PluginRuntime } from "../runtime-api.js";

extensions/feishu/src/comment-handler.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements comment handler behavior.
 import { resolveChannelConfigWrites } from "openclaw/plugin-sdk/channel-config-writes";
 import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime";
 import type { ResolvedAgentRoute } from "openclaw/plugin-sdk/routing";

extensions/feishu/src/comment-reaction.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover comment reaction plugin behavior.
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ClawdbotConfig } from "../runtime-api.js";
 import {

extensions/feishu/src/comment-reaction.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements comment reaction behavior.
 import type { ClawdbotConfig, RuntimeEnv } from "../runtime-api.js";
 import { resolveFeishuRuntimeAccount } from "./accounts.js";
 import { createFeishuClient } from "./client.js";

extensions/feishu/src/comment-shared.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover comment shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   parseCommentContentElements,

extensions/feishu/src/comment-shared.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements comment shared behavior.
 import {
   isRecord as sharedIsRecord,
   normalizeOptionalString,

extensions/feishu/src/comment-target.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements comment target behavior.
 export const FEISHU_COMMENT_FILE_TYPES = ["doc", "docx", "file", "sheet", "slides"] as const;
 
 export type CommentFileType = (typeof FEISHU_COMMENT_FILE_TYPES)[number];

extensions/feishu/src/config-schema.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover config schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { FeishuConfigSchema, FeishuGroupSchema } from "./config-schema.js";
 

extensions/feishu/src/config-schema.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports config schema behavior.
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { z } from "zod";
 export { z };

extensions/feishu/src/conversation-id.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover conversation id plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildFeishuModelOverrideParentCandidates } from "./conversation-id.js";
 

extensions/feishu/src/conversation-id.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements conversation id behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 
 export type FeishuGroupSessionScope =

extensions/feishu/src/dedup-migrations.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover dedup migrations plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/dedup-migrations.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements dedup migrations behavior.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";

extensions/feishu/src/dedup.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover dedup plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/dedup.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements dedup behavior.
 import { createHash } from "node:crypto";
 import type { PluginStateSyncKeyedStore } from "openclaw/plugin-sdk/plugin-state-runtime";
 import {

extensions/feishu/src/dedupe-key.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements dedupe key behavior.
 import { asNullableRecord as readRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { FeishuMessageEvent } from "./event-types.js";
 import { normalizeFeishuExternalKey } from "./external-keys.js";

extensions/feishu/src/directory.static.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements directory.static behavior.
 import {
   listDirectoryGroupEntriesFromMapKeysAndAllowFrom,
   listDirectoryUserEntriesFromAllowFromAndMapKeys,

extensions/feishu/src/directory.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover directory plugin behavior.
 import { importFreshModule } from "openclaw/plugin-sdk/test-fixtures";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { ClawdbotConfig } from "../runtime-api.js";

extensions/feishu/src/directory.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements directory behavior.
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import type { ClawdbotConfig } from "../runtime-api.js";
 import { resolveFeishuAccount } from "./accounts.js";

extensions/feishu/src/doc-schema.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports doc schema behavior.
 import { Type, type Static } from "typebox";
 
 const tableCreationProperties = {

extensions/feishu/src/doctor.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover doctor plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/doctor.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements doctor behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/docx-batch-insert.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover docx batch insert plugin behavior.
 import type * as Lark from "@larksuiteoapi/node-sdk";
 import { describe, expect, it, vi } from "vitest";
 import { BATCH_SIZE, insertBlocksInBatches } from "./docx-batch-insert.js";

extensions/feishu/src/docx-table-ops.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover docx table ops plugin behavior.
 import { describe, expect, it } from "vitest";
 import { cleanBlocksForDescendant } from "./docx-table-ops.js";
 

extensions/feishu/src/docx-types.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements docx types behavior.
 type FeishuBlockText = {
   elements?: Array<{
     text_run?: {

extensions/feishu/src/docx.account-selection.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover docx.account selection plugin behavior.
 import { afterAll, beforeAll, beforeEach, describe, expect, test, vi } from "vitest";
 import type { OpenClawPluginApi } from "../runtime-api.js";
 import { createToolFactoryHarness } from "./tool-factory-test-harness.js";

extensions/feishu/src/docx.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover docx plugin behavior.
 import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";

extensions/feishu/src/docx.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements docx behavior.
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { isAbsolute, resolve } from "node:path";

extensions/feishu/src/drive-schema.ts

@@ -1,3 +1,4 @@
+// Feishu helper module supports drive schema behavior.
 import { Type, type Static } from "typebox";
 
 const FileType = Type.Union([

extensions/feishu/src/drive.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover drive plugin behavior.
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import type { OpenClawPluginApi, PluginRuntime } from "../runtime-api.js";

extensions/feishu/src/drive.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements drive behavior.
 import type * as Lark from "@larksuiteoapi/node-sdk";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { OpenClawPluginApi } from "../runtime-api.js";

extensions/feishu/src/dynamic-agent.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover dynamic agent plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/dynamic-agent.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements dynamic agent behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/feishu/src/event-types.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements event types behavior.
 export type FeishuMessageEvent = {
   sender: {
     sender_id: {

extensions/feishu/src/external-keys.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover external keys plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeFeishuExternalKey } from "./external-keys.js";
 

extensions/feishu/src/external-keys.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements external keys behavior.
 const CONTROL_CHARS_RE = /\p{Cc}/u;
 const MAX_EXTERNAL_KEY_LENGTH = 512;
 

extensions/feishu/src/lifecycle.test-support.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements lifecycle support behavior.
 import { vi, type Mock } from "vitest";
 
 type BoundConversation = {

extensions/feishu/src/media.test.ts

@@ -1,3 +1,4 @@
+// Feishu tests cover media plugin behavior.
 import { realpathSync } from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";

extensions/feishu/src/media.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements media behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { Readable } from "node:stream";

extensions/feishu/src/mention-target.types.ts

@@ -1,3 +1,4 @@
+// Feishu type declarations define plugin contracts.
 export type MentionTarget = {
   openId: string;
   name: string;

extensions/feishu/src/mention.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements mention behavior.
 import type { FeishuMessageEvent } from "./event-types.js";
 import type { MentionTarget } from "./mention-target.types.js";
 import { isFeishuGroupChatType } from "./types.js";

extensions/feishu/src/message-action-contract.ts

@@ -1,3 +1,4 @@
+// Feishu plugin module implements message action contract behavior.
 import type { ChannelMessageActionName } from "openclaw/plugin-sdk/channel-contract";
 
 type MessageActionTargetAliasSpec = {