@gakr-gakr/feishu 0.1.0

package/api.ts

@@ -0,0 +1,32 @@
+export { feishuPlugin } from "./src/channel.js";
+export { registerFeishuDocTools } from "./src/docx.js";
+export { registerFeishuChatTools } from "./src/chat.js";
+export { registerFeishuWikiTools } from "./src/wiki.js";
+export { registerFeishuDriveTools } from "./src/drive.js";
+export { registerFeishuPermTools } from "./src/perm.js";
+export { registerFeishuBitableTools } from "./src/bitable.js";
+export {
+  handleFeishuSubagentDeliveryTarget,
+  handleFeishuSubagentEnded,
+  handleFeishuSubagentSpawning,
+} from "./src/subagent-hooks.js";
+export {
+  buildFeishuConversationId,
+  buildFeishuModelOverrideParentCandidates,
+  type FeishuGroupSessionScope,
+  parseFeishuConversationId,
+  parseFeishuDirectConversationId,
+  parseFeishuTargetId,
+} from "./src/conversation-id.js";
+export { feishuSetupAdapter, setFeishuNamedAccountEnabled } from "./src/setup-core.js";
+export { feishuSetupWizard, runFeishuLogin } from "./src/setup-surface.js";
+export {
+  testing as __testing,
+  testing,
+  createFeishuThreadBindingManager,
+  getFeishuThreadBindingManager,
+} from "./src/thread-bindings.js";
+export { testing as feishuThreadBindingTesting } from "./src/thread-bindings.js";
+export { createClackPrompter } from "autobot/plugin-sdk/setup-runtime";
+
+export const feishuSessionBindingAdapterChannels = ["feishu"] as const;

package/autobot.plugin.json

@@ -0,0 +1,180 @@
+{
+  "id": "feishu",
+  "activation": {
+    "onStartup": false
+  },
+  "channels": ["feishu"],
+  "contracts": {
+    "tools": [
+      "feishu_app_scopes",
+      "feishu_bitable_create_app",
+      "feishu_bitable_create_field",
+      "feishu_bitable_create_record",
+      "feishu_bitable_get_meta",
+      "feishu_bitable_get_record",
+      "feishu_bitable_list_fields",
+      "feishu_bitable_list_records",
+      "feishu_bitable_update_record",
+      "feishu_chat",
+      "feishu_doc",
+      "feishu_drive",
+      "feishu_perm",
+      "feishu_wiki"
+    ]
+  },
+  "toolMetadata": {
+    "feishu_app_scopes": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_create_app": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_create_field": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_create_record": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_get_meta": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_get_record": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_list_fields": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_list_records": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_bitable_update_record": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_chat": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_doc": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_drive": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_perm": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    },
+    "feishu_wiki": {
+      "configSignals": [{ "rootPath": "channels.feishu", "required": ["appId", "appSecret"] }]
+    }
+  },
+  "channelEnvVars": {
+    "feishu": [
+      "FEISHU_APP_ID",
+      "FEISHU_APP_SECRET",
+      "FEISHU_VERIFICATION_TOKEN",
+      "FEISHU_ENCRYPT_KEY"
+    ]
+  },
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "$defs": {
+      "secretRef": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "source": {
+            "type": "string",
+            "enum": ["env", "file", "exec"]
+          },
+          "provider": { "type": "string" },
+          "id": { "type": "string" }
+        },
+        "required": ["source", "provider", "id"]
+      },
+      "secretInput": {
+        "anyOf": [{ "type": "string", "minLength": 1 }, { "$ref": "#/$defs/secretRef" }]
+      },
+      "account": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "enabled": { "type": "boolean" },
+          "name": { "type": "string" },
+          "appId": { "type": "string" },
+          "appSecret": { "$ref": "#/$defs/secretInput" },
+          "encryptKey": { "$ref": "#/$defs/secretInput" },
+          "verificationToken": { "$ref": "#/$defs/secretInput" },
+          "domain": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": ["feishu", "lark"]
+              },
+              {
+                "type": "string",
+                "format": "uri"
+              }
+            ]
+          },
+          "connectionMode": {
+            "type": "string",
+            "enum": ["websocket", "webhook"]
+          },
+          "renderMode": {
+            "type": "string",
+            "enum": ["auto", "raw", "card"]
+          },
+          "streaming": { "type": "boolean" },
+          "blockStreaming": { "type": "boolean" },
+          "replyInThread": {
+            "type": "string",
+            "enum": ["disabled", "enabled"]
+          },
+          "typingIndicator": { "type": "boolean" }
+        }
+      }
+    },
+    "properties": {
+      "enabled": { "type": "boolean" },
+      "defaultAccount": { "type": "string" },
+      "appId": { "type": "string" },
+      "appSecret": { "$ref": "#/$defs/secretInput" },
+      "encryptKey": { "$ref": "#/$defs/secretInput" },
+      "verificationToken": { "$ref": "#/$defs/secretInput" },
+      "domain": {
+        "anyOf": [
+          {
+            "type": "string",
+            "enum": ["feishu", "lark"]
+          },
+          {
+            "type": "string",
+            "format": "uri"
+          }
+        ]
+      },
+      "connectionMode": {
+        "type": "string",
+        "enum": ["websocket", "webhook"]
+      },
+      "renderMode": {
+        "type": "string",
+        "enum": ["auto", "raw", "card"]
+      },
+      "streaming": { "type": "boolean" },
+      "blockStreaming": { "type": "boolean" },
+      "replyInThread": {
+        "type": "string",
+        "enum": ["disabled", "enabled"]
+      },
+      "typingIndicator": { "type": "boolean" },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "$ref": "#/$defs/account"
+        }
+      }
+    }
+  }
+}

package/channel-entry.ts

@@ -0,0 +1,20 @@
+import { defineBundledChannelEntry } from "autobot/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelEntry({
+  id: "feishu",
+  name: "Feishu",
+  description: "Feishu/Lark channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./api.js",
+    exportName: "feishuPlugin",
+  },
+  secrets: {
+    specifier: "./secret-contract-api.js",
+    exportName: "channelSecrets",
+  },
+  runtime: {
+    specifier: "./runtime-api.js",
+    exportName: "setFeishuRuntime",
+  },
+});

package/channel-plugin-api.ts

@@ -0,0 +1 @@
+export { feishuPlugin } from "./src/channel.js";

package/contract-api.ts

@@ -0,0 +1,16 @@
+export { createFeishuThreadBindingManager } from "./src/thread-bindings.js";
+export { testing as feishuThreadBindingTesting } from "./src/thread-bindings.js";
+export {
+  collectRuntimeConfigAssignments,
+  secretTargetRegistryEntries,
+} from "./src/secret-contract.js";
+export { collectFeishuSecurityAuditFindings } from "./src/security-audit.js";
+export { messageActionTargetAliases } from "./src/message-action-contract.js";
+export {
+  buildFeishuConversationId,
+  parseFeishuConversationId,
+  parseFeishuDirectConversationId,
+  parseFeishuTargetId,
+} from "./src/conversation-id.js";
+
+export const feishuSessionBindingAdapterChannels = ["feishu"] as const;

package/index.ts

@@ -0,0 +1,82 @@
+import {
+  defineBundledChannelEntry,
+  loadBundledEntryExportSync,
+} from "autobot/plugin-sdk/channel-entry-contract";
+import type { AutoBotPluginApi } from "autobot/plugin-sdk/channel-entry-contract";
+import { registerFeishuSubagentHooks } from "./subagent-hooks-api.js";
+
+function registerFeishuDocTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuDocTools",
+  });
+  register(api);
+}
+
+function registerFeishuChatTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuChatTools",
+  });
+  register(api);
+}
+
+function registerFeishuWikiTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuWikiTools",
+  });
+  register(api);
+}
+
+function registerFeishuDriveTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuDriveTools",
+  });
+  register(api);
+}
+
+function registerFeishuPermTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuPermTools",
+  });
+  register(api);
+}
+
+function registerFeishuBitableTools(api: AutoBotPluginApi) {
+  const register = loadBundledEntryExportSync<(api: AutoBotPluginApi) => void>(import.meta.url, {
+    specifier: "./api.js",
+    exportName: "registerFeishuBitableTools",
+  });
+  register(api);
+}
+
+export default defineBundledChannelEntry({
+  id: "feishu",
+  name: "Feishu",
+  description: "Feishu/Lark channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "feishuPlugin",
+  },
+  secrets: {
+    specifier: "./secret-contract-api.js",
+    exportName: "channelSecrets",
+  },
+  runtime: {
+    specifier: "./runtime-api.js",
+    exportName: "setFeishuRuntime",
+  },
+  registerFull(api) {
+    registerFeishuSubagentHooks(api);
+    registerFeishuDocTools(api);
+    registerFeishuChatTools(api);
+    registerFeishuWikiTools(api);
+    registerFeishuDriveTools(api);
+    registerFeishuPermTools(api);
+    registerFeishuBitableTools(api);
+  },
+});

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@gakr-gakr/feishu",
+  "version": "0.1.0",
+  "description": "AutoBot Feishu/Lark channel plugin (community maintained by @m1heng)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/autobot/autobot"
+  },
+  "type": "module",
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "1.64.0",
+    "typebox": "1.1.38",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@gakr-gakr/plugin-sdk": "workspace:*",
+    "@gakr-gakr/autobot": "workspace:*",
+    "autobot": "workspace:@gakr-gakr/autobot@*"
+  },
+  "peerDependencies": {
+    "@gakr-gakr/autobot": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@gakr-gakr/autobot": {
+      "optional": true
+    }
+  },
+  "autobot": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "channel": {
+      "id": "feishu",
+      "label": "Feishu",
+      "selectionLabel": "Feishu/Lark (飞书)",
+      "docsPath": "/channels/feishu",
+      "docsLabel": "feishu",
+      "blurb": "飞书/Lark enterprise messaging with doc/wiki/drive tools.",
+      "aliases": [
+        "lark"
+      ],
+      "order": 35,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@gakr-gakr/feishu",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.25"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.19"
+    },
+    "build": {
+      "autobotVersion": "2026.5.19"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}

package/runtime-api.ts

@@ -0,0 +1,55 @@
+// Private runtime barrel for the bundled Feishu extension.
+// Keep this barrel thin and generic-only.
+
+export type {
+  AllowlistMatch,
+  AnyAgentTool,
+  BaseProbeResult,
+  ChannelGroupContext,
+  ChannelMessageActionName,
+  ChannelMeta,
+  ChannelOutboundAdapter,
+  ChannelPlugin,
+  HistoryEntry,
+  AutoBotConfig,
+  AutoBotPluginApi,
+  OutboundIdentity,
+  PluginRuntime,
+  ReplyPayload,
+} from "autobot/plugin-sdk/core";
+export type { AutoBotConfig as ClawdbotConfig } from "autobot/plugin-sdk/core";
+export type { RuntimeEnv } from "autobot/plugin-sdk/runtime";
+export type { GroupToolPolicyConfig } from "autobot/plugin-sdk/config-contracts";
+export {
+  DEFAULT_ACCOUNT_ID,
+  buildChannelConfigSchema,
+  createActionGate,
+  createDedupeCache,
+} from "autobot/plugin-sdk/core";
+export {
+  PAIRING_APPROVED_MESSAGE,
+  buildProbeChannelStatusSummary,
+  createDefaultChannelRuntimeState,
+} from "autobot/plugin-sdk/channel-status";
+export { buildAgentMediaPayload } from "autobot/plugin-sdk/agent-media-payload";
+export { createChannelPairingController } from "autobot/plugin-sdk/channel-pairing";
+export { createReplyPrefixContext } from "autobot/plugin-sdk/channel-message";
+export {
+  evaluateSupplementalContextVisibility,
+  filterSupplementalContextItems,
+  resolveChannelContextVisibilityMode,
+} from "autobot/plugin-sdk/context-visibility-runtime";
+export {
+  loadSessionStore,
+  resolveSessionStoreEntry,
+} from "autobot/plugin-sdk/session-store-runtime";
+export { readJsonFileWithFallback } from "autobot/plugin-sdk/json-store";
+export { createPersistentDedupe } from "autobot/plugin-sdk/persistent-dedupe";
+export { normalizeAgentId } from "autobot/plugin-sdk/routing";
+export { chunkTextForOutbound } from "autobot/plugin-sdk/text-chunking";
+export {
+  isRequestBodyLimitError,
+  readRequestBodyWithLimit,
+  requestBodyErrorToText,
+} from "autobot/plugin-sdk/webhook-ingress";
+export { setFeishuRuntime } from "./src/runtime.js";

package/secret-contract-api.ts

@@ -0,0 +1,5 @@
+export {
+  channelSecrets,
+  collectRuntimeConfigAssignments,
+  secretTargetRegistryEntries,
+} from "./src/secret-contract.js";

package/security-contract-api.ts

@@ -0,0 +1 @@
+export { collectFeishuSecurityAuditFindings } from "./src/security-audit-shared.js";

package/session-key-api.ts

@@ -0,0 +1 @@
+export { resolveFeishuSessionConversation as resolveSessionConversation } from "./src/session-conversation.js";

package/setup-api.ts

@@ -0,0 +1,3 @@
+export { feishuPlugin } from "./src/channel.js";
+export { feishuSetupAdapter } from "./src/setup-core.js";
+export { feishuSetupWizard } from "./src/setup-surface.js";

package/setup-entry.ts

@@ -0,0 +1,13 @@
+import { defineBundledChannelSetupEntry } from "autobot/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelSetupEntry({
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./setup-api.js",
+    exportName: "feishuPlugin",
+  },
+  secrets: {
+    specifier: "./secret-contract-api.js",
+    exportName: "channelSecrets",
+  },
+});